unlockpt(3) [netbsd man page]

UNLOCKPT(3)						   BSD 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.  Con-
     forming 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'').

BSD
								   May 25, 2004 							       BSD

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

SunOS 5.11							    14 Aug 2002 						      unlockpt(3C)