dwww Home | Manual pages | Find package

getpt(3)                   Library Functions Manual                   getpt(3)

NAME
       getpt - open a new pseudoterminal master

LIBRARY
       Standard C library (libc, -lc)

SYNOPSIS
       #define _GNU_SOURCE             /* See feature_test_macros(7) */
       #include <stdlib.h>

       int getpt(void);

DESCRIPTION
       getpt() opens a new pseudoterminal device and returns a file descriptor
       that refers to that device.  It is equivalent to opening the pseudoter-
       minal multiplexor device

           open("/dev/ptmx", O_RDWR);

       on  Linux  systems, though the pseudoterminal multiplexor device is lo-
       cated elsewhere on some systems that use the GNU C library.

RETURN VALUE
       getpt() returns an open file  descriptor  upon  successful  completion.
       Otherwise, it returns -1 and sets errno to indicate the error.

ERRORS
       getpt() can fail with various errors described in open(2).

VERSIONS
       getpt() is provided since glibc 2.1.

ATTRIBUTES
       For  an  explanation  of  the  terms  used  in  this  section,  see at-
       tributes(7).

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

STANDARDS
       getpt() is glibc-specific; use posix_openpt(3) instead.

SEE ALSO
       grantpt(3), posix_openpt(3), ptsname(3), unlockpt(3), ptmx(4), pty(7)

Linux man-pages 6.03              2022-12-15                          getpt(3)

Generated by dwww version 1.15 on Wed Jun 26 04:58:15 CEST 2024.