Manpages - getpt.3

Table of Contents

NAME

getpt - open a new pseudoterminal master

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 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.

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 in glibc since version 2.1.

ATTRIBUTES

For an explanation of the terms used in this section, see *attributes*(7).

Interface Attribute Value
*getpt*() Thread safety MT-Safe

CONFORMING TO

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

SEE ALSO

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

COLOPHON

This page is part of release 5.13 of the Linux man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at https://www.kernel.org/doc/man-pages/.

Author: dt

Created: 2022-02-20 Sun 15:40