NAME

unlockpt — unlock the slave pseudo-terminal device

LIBRARY

Standard C Library (libc, -lc)

SYNOPSIS

#include <stdlib.h>

int
unlockpt(int fildes);

DESCRIPTION

The unlockpt() unlocks access to the pseudo-terminal device corresponding to the master pseudo-terminal device associated with fildes. Conforming applications must call this function before opening the slave pseudo-terminal device.

RETURN VALUES

If successful, unlockpt() returns 0; otherwise a value of -1 is returned and errno is set to indicate the error.

ERRORS

The unlockpt() function will fail if:

[EACCESS]

the corresponding pseudo-terminal device could not be accessed.

[EBADF]

fildes is not a valid descriptor.

[EINVAL]

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

NOTES

In NetBSD unlockpt() does nothing.

SEE ALSO

ioctl(2), grantpt(3), posix_openpt(3), ptsname(3)

STANDARDS

The unlockpt() function conforms to IEEE Std 1003.1-2001 (“POSIX.1”). Its first release was in X/Open Portability Guide Issue 4, Version 2 (“XPG4.2”).