CTERMID(3S-SysV)    RISC/os Reference Manual     CTERMID(3S-SysV)



NAME
     ctermid - generate file name for terminal

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

DESCRIPTION
     ctermid generates the path name 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, the contents of which are overwritten at the
     next call to ctermid, and the address of which is returned.
     Otherwise, s is assumed to point to a character array of at
     least Lctermid elements; the path name 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 must be handed a file descriptor 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 used as a file name.  Thus
     ttyname is useful only if the process already has at least
     one file open to a terminal.

SEE ALSO
     ttyname(3C).
























                         Printed 1/15/91                   Page 1