hpux man page for unlockpt

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)