GRANTPT(3C-SVR4)    RISC/os Reference Manual     GRANTPT(3C-SVR4)



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)
     STREAMS Programmer's Guide.


























                        Printed 11/19/92                   Page 1