|CTERMID(3)||FreeBSD Library Functions Manual||CTERMID(3)|
NAMEctermid — generate terminal pathname
LIBRARYStandard C Library (libc, -lc)
SYNOPSIS#include < stdio.h>
ctermid( char *buf);
ctermid_r( char *buf);
DESCRIPTIONThe 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 be at least L_ctermid (as defined in the include file < stdio.h>) bytes long.
The ctermid_r() function provides the same functionality as ctermid() except that if buf is a NULL pointer, NULL is returned.
If no suitable lookup of the controlling terminal name can be performed, this implementation returns ‘
RETURN VALUESUpon 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.
ERRORSThe current implementation detects no error conditions.
STANDARDSThe ctermid() function conforms to IEEE Std 1003.1-1988 (“POSIX.1”).
BUGSBy default the ctermid() function writes all information to an internal static object. Subsequent calls to ctermid() will modify the same object.
|October 1, 2011||FreeBSD|