NAME    [Toc]    [Back]

     ctermid - generate terminal pathname

LIBRARY    [Toc]    [Back]

     Standard C Library (libc, -lc)

SYNOPSIS    [Toc]    [Back]

     #include <stdio.h>

     char *
     ctermid(char *buf);

DESCRIPTION    [Toc]    [Back]

     The ctermid() function generates a string, that, when used as a pathname,
     refers to the current controlling terminal of the calling process.

     If buf is the NULL pointer, a pointer to a static area is returned.  Otherwise,
 the pathname is copied into the memory referenced by buf.  The
     argument buf is assumed to point to an array at least L_ctermid bytes
     long (as defined in the include file <stdio.h>).

     The current implementation simply returns `/dev/tty'.

RETURN VALUES    [Toc]    [Back]

     Upon successful completion, a non-NULL pointer is returned.  Otherwise, a
     NULL pointer is returned and the global variable errno is set to indicate
     the error.

ERRORS    [Toc]    [Back]

     The current implementation detects no error conditions.

SEE ALSO    [Toc]    [Back]

     ttyname(3)

STANDARDS    [Toc]    [Back]

     The ctermid() function conforms to ISO/IEC 9945-1:1990 (``POSIX.1'').

BUGS    [Toc]    [Back]

     By default the ctermid() function writes all information to an internal
     static object.  Subsequent calls to ctermid() will modify the same
     object.

BSD                              June 4, 1993                              BSD