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)