unlockpt(3C)unlockpt(3C)NAMEunlockpt - unlock a STREAMS pty master and slave pair
SYNOPSISDESCRIPTION
The passed parameter, fildes, is a file descriptor that is returned
from a successful open of a master pty (pseudo-terminal) device. The
function unlocks a slave pty from its associated master counterpart.
It does this by clearing a lock flag so that the slave pty can be
opened. For security reason, grantpt(3C) must be executed before
unlockpt(3C).
RETURN VALUE
Upon successful completion, the function returns a value of 0 (zero).
Otherwise, it returns a value of -1.
Failure may result under the following conditions:
· The file descriptor specified by the fildes parameter is not
an open file descriptor.
· The file descriptor specified by the fildes parameter is not
associated with a STREAMS pty master device.
EXAMPLES
The following example shows how is typically used.
...
AUTHOR
was developed by HP and OSF.
SEE ALSOopen(2), grantpt(3C), ptsname(3C), ptm(7), pts(7), ptem(7).
unlockpt(3C)