grantpt(3C)

NAME
     grantpt - 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 ALSO
     open(2), setuid(2), ptsname(3C), unlockpt(3C)