unlockpt(3C) unlockpt(3C)
NAME
unlockpt - unlock a STREAMS pty master and slave pair
SYNOPSIS
DESCRIPTION
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:
o The file descriptor specified by the fildes parameter is not an open file descriptor.
o 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 ALSO
open(2), grantpt(3C), ptsname(3C), ptm(7), pts(7), ptem(7).
unlockpt(3C)
