grantpt(3C)                    DG/UX 5.4R3.00                    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, writable by the
       owner and writable by the group.


   Considerations for Threads Programming
                     +---------+-----------------------------+
                     |         |                      async- |
                     |function | reentrant   cancel   cancel |
                     |         |              point    safe  |
                     +---------+-----------------------------+
                     |grantpt  |     N          -        -   |
                     +---------+-----------------------------+

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), reentrant(3).
       ptsname(3C), unlockpt(3C)
       in the Programmer's Guide: STREAMS.




















Licensed material--property of copyright holder(s)                         1