unlockpt(3) - NetBSD Manual Pages

Command:
Section:
Arch:
Collection:
>>>
UNLOCKPT(3)             NetBSD Library Functions Manual            UNLOCKPT(3)


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-ter-
     minal 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'').

NetBSD 5.1                       May 25, 2004                       NetBSD 5.1