grantpt(3C)             LIBRARY FUNCTIONS             grantpt(3C)



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 correspond-
     ing slave device could not be accessed.

SEE ALSO
     open(2), setuid(2).
     ptsname(3C), unlockpt(3C)
     in the Programmer's Guide: STREAMS.


























                                                                1