[Go to CFHT Home Page] Man Pages
Back to Software Index  BORDER=0Manpage Top Level
    GETPT(3) manual page Table of Contents

Name

getpt - open the pseudoterminal master (PTM)

Synopsis


#define _GNU_SOURCE             /* See feature_test_macros(7) */#include
<stdlib.h>
int getpt(void);

Description

getpt() opens a pseudoterminal master and returns its file descriptor. It is equivalent to 
    open(/dev/ptmx, O_RDWR | O_NOCTTY);
on Linux systems, though the pseudoterminal master is located elsewhere on some systems that use GNU Libc.

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

Multithreading (see pthreads(7) )

The getpt() function is thread-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 3.78 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 http://www.kernel.org/doc/man-pages/.

Table of Contents