ctermid - get controlling terminal name
Contents
Attributes
For an explanation of the terms used in this section, see attributes(7).
┌─────────────────────────────────────────────────────────────────────────────┬───────────────┬─────────┐
│ Interface │ Attribute │ Value │
├─────────────────────────────────────────────────────────────────────────────┼───────────────┼─────────┤
│ ctermid() │ Thread safety │ MT-Safe │
└─────────────────────────────────────────────────────────────────────────────┴───────────────┴─────────┘
Bugs
The returned pathname may not uniquely identify the controlling terminal; it may, for example, be
/dev/tty.
It is not assured that the program can open the terminal.
Description
ctermid() returns a string which is the pathname for the current controlling terminal for this process.
If s is NULL, a static buffer is used, otherwise s points to a buffer used to hold the terminal pathname.
The symbolic constant L_ctermid is the maximum number of characters in the returned pathname.
History
POSIX.1-2001, Svr4.
Library
Standard C library (libc, -lc)
Name
ctermid - get controlling terminal name
Return Value
The pointer to the pathname.
See Also
ttyname(3) Linux man-pages 6.9.1 2024-05-02 ctermid(3)
Standards
POSIX.1-2008.
Synopsis
#include<stdio.h>char*ctermid(char*s); Feature Test Macro Requirements for glibc (see feature_test_macros(7)): ctermid(): _POSIX_C_SOURCE
