home *** CD-ROM | disk | FTP | other *** search
/ NetNews Usenet Archive 1992 #31 / NN_1992_31.iso / spool / comp / unix / osf / osf1 / 43 < prev    next >
Encoding:
Text File  |  1992-12-30  |  4.6 KB  |  120 lines
  1. Newsgroups: comp.unix.osf.osf1
  2. Path: sparky!uunet!gatech!rpi!think.com!paperboy.osf.org!meissner
  3. From: meissner@osf.org (Michael Meissner)
  4. Subject: Re: /dev/ptm
  5. In-Reply-To: rince@dcs.warwick.ac.uk's message of 22 Dec 92 09:14:37 GMT
  6. Message-ID: <MEISSNER.92Dec30222841@curley.osf.org>
  7. Lines: 106
  8. Sender: news@osf.org (USENET News System)
  9. Organization: Open Software Foundation
  10. References: <1992Dec22.091437.11429@dcs.warwick.ac.uk>
  11. Date: Thu, 31 Dec 1992 03:28:44 GMT
  12. Lines: 106
  13.  
  14. In article <1992Dec22.091437.11429@dcs.warwick.ac.uk> rince@dcs.warwick.ac.uk (James Bonfield) writes:
  15.  
  16. | Hello,
  17. |     Why does the 'script' command allocate itself a new controlling tty
  18. | and yet no other 'standard' (eg emacs, fep) program seem able to? I've read
  19. | the manuals for other machines and written programs to grab themselves a new
  20. | tty by dissociating, becoming a session leader, and opening a terminal that
  21. | current has no controlling process.
  22. | 
  23. |     This works on all machines I've tried except an Alpha running OSF1. By
  24. | debugging script a bit I figured out it opens (read-write) /dev/ptm. This is
  25. | not in any of the online manuals as far as I can see, and neither is how to
  26. | become the controlling process. Can anyone offer assistance here?
  27.  
  28. While I can only speak for the OSF/1 that we ship to the licensees,
  29. and not what gets shiped ultimately to customers, the openpty and
  30. forkpty functions will open pty's for you.  Revision 1.0.x of OSF/1
  31. from us had the functions in libutil.a.  Revision 1.[12].x of OSF/1
  32. moved the functions to libc.a.  In revision 1.0 the manual did not
  33. cover these functions, an oversight which was fixed in 1.1.
  34.  
  35. The file /dev/ptm that you mention is a streams clone device that when
  36. opened gives you the file descriptor to the master end.  You get the
  37. slave file descriptor by taking the minor device number of the master
  38. fd, converting it to ascii, and prepending '/dev/pts/' to it, and
  39. opening that filename.
  40.  
  41. NAME
  42.      openpty, forkpty - Opens a pseudoterminal master and slave
  43.      device-pair
  44.  
  45. LIBRARY
  46.      Standard C Library (libc.a)
  47.  
  48. SYNOPSIS
  49.      int openpty(
  50.          int *amaster,
  51.          int *aslave,
  52.          char *name,
  53.          struct termios *termp,
  54.          struct winsize *winp);
  55.      int  forkpty(
  56.          int *amaster,
  57.          char *name,
  58.          struct termios *termp,
  59.          struct winsize *winp);
  60.  
  61. PARAMETERS
  62.      amaster   Points to the file descriptor of the master pty,
  63.            typically /dev/ptmx_bsd.
  64.  
  65.      aslave    Points to the file descriptor of a slave pty,
  66.            /dev/pty/N.
  67.  
  68.      name      Contains the name returned name of the slave pty
  69.            that was opened, or a null pointer if the open was
  70.            not successful.
  71.  
  72.      termp     Points to the termios structure containing the
  73.            terminal attributes for the opened slave pty.
  74.  
  75.      winp      Points to the winsize structure containing the
  76.            window attributes for the opened slave pty.
  77.  
  78. DESCRIPTION
  79.      The openpty() function opens a master and slave device-pair
  80.      for a pseudoterminal, and sets the terminal attributes for
  81.      the slave device according to the specifications in the term
  82.      and winp parameters.  This function invokes the pty_master()
  83.      and pty_slave() functions to perform the opening of the mas-
  84.      ter and slave devices.  If either of these functions return
  85.      [ENOENT] indicating failure due to a lack of available ptys,
  86.      the sysconfig command should be used to increase the limit
  87.      on these type devices in the system.
  88.  
  89.      The forkpty() function allocates and invokes a child process
  90.      for a pseudoterminal.  It sets the child process's pty ter-
  91.      minal attributes according to the specifications in the term
  92.      and winp parameters.
  93.  
  94. RETURN VALUES
  95.      Upon successful completion, the openpty() function returns a
  96.      value of 0 (zero).  Otherwise, it returns a value of -1. The
  97.      forkpty() function returns a value of 0 (zero) to the child
  98.      process, and returns the process ID of the child process to
  99.      the parent process on success.  However, on error, this
  100.      function returns a value of -1 to the parent process, and
  101.      does not create a child process.
  102.  
  103. ERRORS
  104.      If any of the following conditions occurs, the openpty()
  105.      function sets errno to the corresponding value:
  106.  
  107.      [ENXIO]   Unable to locate the specified pty.
  108.  
  109.      [ENOENT]  There are no more ptys that can be opened.
  110.  
  111. RELATED INFORMATION
  112.      Commands: sysconfig(8).
  113.  
  114.      Functions: pty_master, pty_slave.
  115. --
  116. Michael Meissner    email: meissner@osf.org        phone: 617-621-8861
  117. Open Software Foundation, 11 Cambridge Center, Cambridge, MA, 02142
  118.  
  119. You are in a twisty little passage of standards, all conflicting.
  120.