dwww Home | Manual pages | Find package

ctermid(3)                 Library Functions Manual                 ctermid(3)

NAME
       ctermid - get controlling terminal name

LIBRARY
       Standard C library (libc, -lc)

SYNOPSIS
       #include <stdio.h>

       char *ctermid(char *s);

   Feature Test Macro Requirements for glibc (see feature_test_macros(7)):

       ctermid():
           _POSIX_C_SOURCE

DESCRIPTION
       ctermid()  returns  a string which is the pathname for the current con-
       trolling terminal for this process.  If s is NULL, a static  buffer  is
       used,  otherwise  s  points to a buffer used to hold the terminal path-
       name.  The symbolic constant L_ctermid is the maximum number of charac-
       ters in the returned pathname.

RETURN VALUE
       The pointer to the pathname.

ATTRIBUTES
       For an explanation of the terms  used  in  this  section,  see  attrib-
       utes(7).
       ┌───────────────────────────────────────────┬───────────────┬─────────┐
       │ Interface                                 Attribute     Value   │
       ├───────────────────────────────────────────┼───────────────┼─────────┤
       │ ctermid()                                 │ Thread safety │ MT-Safe │
       └───────────────────────────────────────────┴───────────────┴─────────┘

STANDARDS
       POSIX.1-2008.

HISTORY
       POSIX.1-2001, Svr4.

BUGS
       The  returned pathname may not uniquely identify the controlling termi-
       nal; it may, for example, be /dev/tty.

       It is not assured that the program can open the terminal.

SEE ALSO
       ttyname(3)

Linux man-pages 6.7               2023-10-31                        ctermid(3)

Generated by dwww version 1.16 on Mon Jul 13 11:45:41 CEST 2026.