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)