CTERMID(3) BSD Programmer's Manual CTERMID(3)NAMEctermid - generate terminal pathname
SYNOPSIS
#include <stdio.h>
char *
ctermid(char *buf);
DESCRIPTION
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 a null pointer, a pointer to a static area is returned. Other-
wise, the pathname is copied into the memory referenced by buf. The argu-
ment buf is assumed to point to an array at least L_ctermid (as defined
in the include file <stdio.h>) bytes long.
The current implementation simply generates "/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.
ERRORS
The current implementation detects no error conditions.
SEE ALSOttyname(3)STANDARDS
The ctermid() function conforms to IEEE Std 1003.1-1988 ("POSIX").
BUGS
By default the ctermid() function writes all information to an internal
static object. Subsequent calls to ctermid() will modify the same object.
MirOS BSD #10-current June 4, 1993 1