getpt - open a new pseudoterminal master
Contents
Attributes
For an explanation of the terms used in this section, see attributes(7).
┌─────────────────────────────────────────────────────────────────────────────┬───────────────┬─────────┐
│ Interface │ Attribute │ Value │
├─────────────────────────────────────────────────────────────────────────────┼───────────────┼─────────┤
│ getpt() │ Thread safety │ MT-Safe │
└─────────────────────────────────────────────────────────────────────────────┴───────────────┴─────────┘
Description
getpt() opens a new pseudoterminal device and returns a file descriptor that refers to that device. It
is equivalent to opening the pseudoterminal multiplexor device
open("/dev/ptmx", O_RDWR);
on Linux systems, though the pseudoterminal multiplexor device is located elsewhere on some systems that
use the GNU C library.
Errors
getpt() can fail with various errors described in open(2).
History
glibc 2.1.
Library
Standard C library (libc, -lc)
Name
getpt - open a new pseudoterminal master
Return Value
getpt() returns an open file descriptor upon successful completion. Otherwise, it returns -1 and sets
errno to indicate the error.
See Also
grantpt(3), posix_openpt(3), ptsname(3), unlockpt(3), ptmx(4), pty(7) Linux man-pages 6.9.1 2024-05-02 getpt(3)
Standards
GNU.
Synopsis
#define_GNU_SOURCE /* See feature_test_macros(7) */ #include<stdlib.h>intgetpt(void);
Versions
Use posix_openpt(3) instead.
