Print this page
14249 pseudo-terminal nomenclature should reflect POSIX
Change-Id: Ib4a3cef899ff4c71b09cb0dc6878863c5e8357bc

*** 1,57 **** 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 ! ! August 14, 2002 UNLOCKPT(3C) --- 1,49 ---- UNLOCKPT(3C) Standard C Library Functions UNLOCKPT(3C) NAME ! unlockpt - unlock a pseudo-terminal device pair SYNOPSIS #include <stdlib.h> ! int ! unlockpt(int fildes); DESCRIPTION ! When a pseudo-terminal manager device is opened, whether through ! posix_openpt(3C) or open(2) on a ptm(7D) device, the subsidiary device ! begins operation in a locked state. The unlockpt() function unlocks the ! pseudo-terminal subsidiary device associated with the manager device to ! which fildes refers. + Portable applications must call unlockpt() before opening the pseudo- + terminal subsidiary device. RETURN VALUES ! The unlockpt() function returns the value 0 if successful; otherwise the ! value -1 is returned and the global variable errno is set to indicate the ! error. + EXAMPLES + See posix_openpt(3C) for an example that includes a call to unlockpt(). + ERRORS The unlockpt() function may fail if: ! EBADF The fildes argument is not a file descriptor open for writing. + EINVAL EINVAL The fildes argument is not associated with a + pseudo-terminal manager device. ! INTERFACE STABILITY ! Committed + MT LEVEL + Safe SEE ALSO ! open(2), grantpt(3C), posix_openpt(3C), ptsname(3C), attributes(5), ! standards(5), ptm(7D) ! illumos February 5, 2022 illumos