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 at-
       tributes(7).

       ┌────────────────────────────────────────────┬───────────────┬─────────┐
       │InterfaceAttributeValue   │
       ├────────────────────────────────────────────┼───────────────┼─────────┤
       │ctermid()                                   │ Thread safety │ MT-Safe │
       └────────────────────────────────────────────┴───────────────┴─────────┘

STANDARDS
       POSIX.1-2001, POSIX.1-2008, 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.03              2022-12-15                        ctermid(3)

Generated by dwww version 1.15 on Wed Jun 26 05:56:27 CEST 2024.