posix_openpt

posix_openpt - open a pseudo-terminal device

#define _XOPEN_SOURCE 600

#include <stdlib.h>
#include <fcntl.h>
 I int posix_openpt(int  flags );

The R posix_openpt () function opens an unused pseudo-terminal master device, returning a file descriptor that can be used to refer to that device. The flags argument is a bit mask that ORs together zero or more of the following flags:

O_RDWR

O_NOCTTY

On success, R posix_openpt () returns a non-negative file descriptor which is the lowest numbered unused descriptor. On failure, -1 is returned, and errno is set to indicate the error.

See open(2).

Glibc support for R posix_openpt () has been provided since version 2.2.1.

R posix_openpt () is part of the Unix98 pseudo-terminal support (see pts(4)). This function is specified in POSIX.1-2001.

This function is a recent invention in POSIX. Some Unix implementations that support System V (aka Unix 98) pseudo-terminals don't have this function, but it is easy to implement:

int
posix_openpt(int flags)
{
    return open("/dev/ptmx", flags);
}

open(2), getpt(3), grantpt(3), ptsname(3), unlockpt(3), pts(4), feature_test_macros(7), pty(7)