grantpt(3C)                                              grantpt(3C)


       NAME
             grantpt - grant access to the slave pseudo-terminal device

       SYNOPSIS
             #include <sys/ptms.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 real 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, writable by the owner and
             writable by the group.

          Return Values
             Upon successful completion, the function grantpt returns 0;
             otherwise it returns -1.

          Errors
             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.

       REFERENCES
             open(2), ptsname(3C), pty(7), setuid(2), unlockpt(3C)

















                           Copyright 1994 Novell, Inc.               Page 1