grantpt(3C)grantpt(3C)NAMEgrantpt - grant access to the slave pseudo-terminal device
SYNOPSIS
#include <stdlib.h>
int grantpt(int fildes);
DESCRIPTION
The function grantpt changes the mode and ownership of the slave pseudo-
terminal 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
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 ALSOopen(2), setuid(2), ptsname(3C), unlockpt(3C)
Page 1