CTERMID(3) BSD Library Functions Manual CTERMID(3)

NAME
     cctteerrmmiidd - generate terminal pathname

LLIIBBRRAARRYY
     Standard C Library (libc, -lc)

SYNOPSIS
     ##iinncclluuddee <>

     char *
     cctteerrmmiidd(char *buf);

     char *
     cctteerrmmiiddrr(char *buf);

DESCRIPTION
     The cctteerrmmiidd() 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.  Oth-
     erwise, the pathname is copied into the memory referenced by buf.  The
     argument buf is assumed to be at least Lctermid (as defined in the
     include file ) bytes long.

     The cctteerrmmiiddrr() function provides the same functionality as cctteerrmmiidd()
     except that if buf is a NULL pointer, NULL is returned.

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

RETURN VALUES
     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.

EERRRROORRSS
     The current implementation detects no error conditions.

SEE ALSO
     ttyname(3)

STANDARDS
     The cctteerrmmiidd() function conforms to IEEE Std 1003.1-1988 (``POSIX.1'').

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

BSD                              June 4, 1993                              BSD