Visit Our UNIX and Linux User Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

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)

Featured Tech Videos