unlockpt(3c) [opensolaris man page]

unlockpt(3C)						   Standard C Library Functions 					      unlockpt(3C)

NAME

       unlockpt - unlock a pseudo-terminal master/slave pair

SYNOPSIS

       #include <stdlib.h>

       int unlockpt(int fildes);

DESCRIPTION

       The unlockpt() function unlocks the slave pseudo-terminal device associated with the master to which fildes refers.

       Portable applications must call unlockpt() before opening the slave side of a pseudo-terminal device.

RETURN VALUES

       Upon successful completion, unlockpt() returns 0. Otherwise, it returns -1 and sets errno to indicate the error.

ERRORS

       The unlockpt() function may fail if:

       EBADF	 The fildes argument is not a file descriptor open for writing.

       EINVAL	 The fildes argument is not associated with a master pseudo-terminal device.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       open(2), grantpt(3C), ptsname(3C), attributes(5), standards(5)

       STREAMS Programming Guide

SunOS 5.11							    14 Aug 2002 						      unlockpt(3C)

Check Out this Related Man Page

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)

Linux and UNIX Man Pages

unlockpt(3c) [opensolaris man page]

Check Out this Related Man Page