Go to main content

man pages section 3: Basic Library Functions

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

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(7) for descriptions of the following attributes:

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Interface Stability
Committed
MT-Level
Safe
Standard

See Also

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

STREAMS Programming Guide