posix_openpt(3c) [hpux man page]

posix_openpt(3C)														  posix_openpt(3C)

NAME

       posix_openpt() - open a pseudo-terminal master device

SYNOPSIS

   Parameters
       oflag	 indicates  the  file  status flags and file access modes of the open file description. Values for oflag are constructed by a bit-
		 wise-inclusive OR of flags from the following list, defined in

		 Open for reading and writing.

		 If set    will not cause the terminal device to become the controlling terminal for the process.

DESCRIPTION

       The function establishes a connection between a master device for a pseudo-terminal and a file descriptor. This file descriptor can be used
       to  refer  that	device.   The  file status flags and file access modes of the opened file descriptor will be set according to the value of
       oflag.

RETURN VALUE

       Upon successful completion opens a master pseudo-terminal device and returns a non-negative integer representing the lowest numbered unused
       file descriptor. Otherwise, returns -1 and is set to indicate the error.

ERRORS

       On failure sets one of the following values for

       OPEN_MAX       file descriptors are currently open in the calling process.

       The maximum allowable number of files are currently open on the system.

       The value of   oflag is not valid.

       Out of pseudo-terminal resources.

       Out of STREAMS resources.

AUTHOR

       was developed by HP.

SEE ALSO

       open(2), grantpt(3C), ptsname(3C), unlockpt(3C), ptm(7), pts(7).

																  posix_openpt(3C)

POSIX_OPENPT(2) 					      BSD System Calls Manual						   POSIX_OPENPT(2)

NAME

     posix_openpt -- open a pseudo-terminal device

LIBRARY

     Standard C Library (libc, -lc)

SYNOPSIS

     #include <stdlib.h>
     #include <fcntl.h>

     int
     posix_openpt(int oflag);

DESCRIPTION

     The posix_openpt() function allocates a new pseudo-terminal and establishes a connection with its master device.  A slave device shall be
     created in /dev/pts.  After the pseudo-terminal has been allocated, the slave device should have the proper permissions before it can be used
     (see grantpt(3)).	The name of the slave device can be determined by calling ptsname(3).

     The file status flags and file access modes of the open file description shall be set according to the value of oflag.  Values for oflag are
     constructed by a bitwise-inclusive OR of flags from the following list, defined in <fcntl.h>:

     O_RDWR    Open for reading and writing.

     O_NOCTTY  If set posix_openpt() shall not cause the terminal device to become the controlling terminal for the process.

     The posix_openpt() function shall fail when oflag contains other values.

RETURN VALUES

     Upon successful completion, the posix_openpt() function shall allocate a new pseudo-terminal device and return a non-negative integer repre-
     senting a file descriptor, which is connected to its master device.  Otherwise, -1 shall be returned and errno set to indicate the error.

ERRORS

     The posix_openpt() function shall fail if:

     [ENFILE]		The system file table is full.

     [EINVAL]		The value of oflag is not valid.

     [EAGAIN]		Out of pseudo-terminal resources.

SEE ALSO

     pts(4), ptsname(3), tty(4)

STANDARDS

     The posix_openpt() function conforms to IEEE Std 1003.1-2001 (``POSIX.1'').

HISTORY

     The posix_openpt() function appeared in FreeBSD 5.0.  In FreeBSD 8.0, this function was changed to a system call.

NOTES

     The flag O_NOCTTY is included for compatibility; in FreeBSD, opening a terminal does not cause it to become a process's controlling terminal.

AUTHORS

     Ed Schouten <ed@FreeBSD.org>

BSD
								  August 20, 2008							       BSD