grantpt(3C)							   grantpt(3C)

NAME    [Toc]    [Back]

     grantpt - grant access to the slave pseudo-terminal device

SYNOPSIS    [Toc]    [Back]

     #include <stdlib.h>

     int grantpt(int fildes);

DESCRIPTION    [Toc]    [Back]

     The function grantpt changes the mode and ownership of the	slave pseudoterminal
 device associated	with its master	pseudo-terminal	counter	part.
     fildes is the file	descriptor returned from a successful open of the
     master pseudo-terminal device.  A setuid root program [see	setuid(2)] is
     invoked to	change the permissions.	 The user ID of	the slave is set to
     the effective owner 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, writeable by the owner and writeable by the group.

RETURN VALUE    [Toc]    [Back]

     Upon successful completion, the function grantpt returns 0; otherwise it
     returns -1.  Failure could	occur if fildes	is not an open file
     descriptor, if fildes is not associated with a master pseudo-terminal
     device, or	if the corresponding slave device could	not be accessed.

SEE ALSO    [Toc]    [Back]

     open(2), setuid(2), ptsname(3C), unlockpt(3C)


									PPPPaaaaggggeeee 1111