NAME

grantpt − grant access to the slave pseudo-terminal device

SYNOPSIS

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 ALSO

open(2), setuid(2)
ptsname(3C), unlockpt(3C) in the Programmer’s Guide: STREAMS