Visit Our UNIX and Linux User Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

unlockpt(3) [osf1 man page]

unlockpt(3)						     Library Functions Manual						       unlockpt(3)

unlockpt - Unlocks a pseudoterminal master and slave pair LIBRARY
Standard C Library (libc) SYNOPSIS
#include <stdlib.h> int unlockpt( int mastfd); STANDARDS
Interfaces documented on this reference page conform to industry standards as follows: unlockpt(): XSH5.0 Refer to the standards(5) reference page for more information about industry standards and associated tags. PARAMETERS
Specifies a file descriptor that is returned from a successful open of the master pseudoterminal device. DESCRIPTION
The unlockpt() function unlocks a slave pseudoterminal from its associated master counterpart. It does this by clearing a lock flag so that the slave device can be opened. RETURN VALUE
Upon successful completion, the unlockpt() function returns a value of 0. Otherwise, it returns a value of -1 and sets errno to indicate the error. ERRORS
The unlockpt() function sets errno to the specified values for the following conditions: The file descriptor specified by the mastfd parameter is not an open file descriptor. The file descriptor specified by the mastfd parame- ter is not associated with a master pseudoterminal device. RELATED INFORMATION
Functions: openpty(3) Standards: standards(5) delim off unlockpt(3)

Check Out this Related Man Page

UNLOCKPT(3)						     Linux Programmer's Manual						       UNLOCKPT(3)

unlockpt - unlock a pseudoterminal master/slave pair SYNOPSIS
#define _XOPEN_SOURCE #include <stdlib.h> int unlockpt(int fd); Feature Test Macro Requirements for glibc (see feature_test_macros(7)): unlockpt(): Since glibc 2.24: _XOPEN_SOURCE >= 500 || (_XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED) Glibc 2.23 and earlier: _XOPEN_SOURCE DESCRIPTION
The unlockpt() function unlocks the slave pseudoterminal device corresponding to the master pseudoterminal referred to by fd. unlockpt() should be called before opening the slave side of a pseudoterminal. RETURN VALUE
When successful, unlockpt() returns 0. Otherwise, it returns -1 and sets errno appropriately. ERRORS
EBADF The fd argument is not a file descriptor open for writing. EINVAL The fd argument is not associated with a master pseudoterminal. VERSIONS
unlockpt() is provided in glibc since version 2.1. ATTRIBUTES
For an explanation of the terms used in this section, see attributes(7). +-----------+---------------+---------+ |Interface | Attribute | Value | +-----------+---------------+---------+ |unlockpt() | Thread safety | MT-Safe | +-----------+---------------+---------+ CONFORMING TO
POSIX.1-2001, POSIX.1-2008. SEE ALSO
grantpt(3), posix_openpt(3), ptsname(3), pts(4), pty(7) COLOPHON
This page is part of release 4.15 of the Linux man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at 2017-07-13 UNLOCKPT(3)

Featured Tech Videos