grantpt(3C)                                                     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 corresponding slave device could not be accessed.

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


























   7/91                                                                 Page 1