Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

OpenSolaris 2009.06 - man page for grantpt (opensolaris section 3c)

grantpt(3C)						   Standard C Library Functions 					       grantpt(3C)

NAME
grantpt - grant access to the slave pseudo-terminal device
SYNOPSIS
#include <stdlib.h> int grantpt(int fildes);
DESCRIPTION
The grantpt() function changes the mode and ownership of the slave pseudo-terminal device associated with its master pseudo-terminal coun- terpart. fildes is the file descriptor returned from a successful open of the master pseudo-terminal device. The user ID of the slave is set to the real UID of the calling process and the group ID is set to a reserved group. The permission mode of the slave pseudo-terminal is set to readable and writable by the owner and writable by the group.
RETURN VALUES
Upon successful completion, grantpt() returns 0. Otherwise, it returns -1 and sets errno to indicate the error.
ERRORS
The grantpt() function may fail if: EBADF The fildes argument is not a valid open file descriptor. EINVAL The fildes argument is not associated with a master pseudo-terminal device. EACCES The corresponding slave pseudo-terminal device could not be accessed.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Interface Stability |Standard | +-----------------------------+-----------------------------+ |MT-Level |Safe | +-----------------------------+-----------------------------+
SEE ALSO
open(2), ptsname(3C), unlockpt(3C), attributes(5), standards(5) STREAMS Programming Guide SunOS 5.11 14 Aug 2006 grantpt(3C)