ctermid(3S) — sys5



CTERMID(3S)     DOMAIN/IX Reference Manual (SYS5)     CTERMID(3S)



NAME
     ctermid - generate filename for terminal

USAGE
     #include <stdio.h>
     char *ctermid (s)
     char *s;

DESCRIPTION
     Ctermid generates the pathname of the controlling terminal
     for the current process, and stores it in a string.

     If s is a NULL pointer, the string is stored in an internal
     static area, which is overwritten at the next call to cter-
     mid.  The address of the area is returned to the process.
     Otherwise, s points to a character array of at least
     Lctermid elements; the pathname is placed in this array and
     the value of s is returned.  The constant Lctermid is
     defined in the <stdio.h> header file.

NOTES
     The difference between ctermid and ttyname(3C) is that
     ttyname takes a file descriptor argument and returns the
     actual name of the terminal associated with that file
     descriptor, while ctermid returns a string (/dev/tty) that
     will refer to the terminal if it is used as a filename.
     Thus, ttyname is useful only if the process already has at
     least one file open to a terminal.

RELATED INFORMATION
     ttyname(3C)
























Printed 5/10/85                                         CTERMID-1
Museum
