grantpt(3C)                                                     grantpt(3C)

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

SYNOPSIS
     #include <stdlib.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 VALUE
     Upon successful completion, the function grantpt() returns 0; other-
     wise 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.

ERRORS
     The following error code descriptions are function-specific. You will
     find a general description in introprm2(2) or in errno(5).

     The grantpt() function may fail if:

     EBADF     The fildes argument is not a valid open file descriptor.

     EINVAL    The fildes argument is not associated with a master pseudo-
               terminal device.

     EACCES    The corresponding slave pseudo-terminal device could not be
               accessed.

APPLICATION USAGE
     The grantpt() function may also fail if the application has installed
     a signal handler to catch SIGCHLD signals.

SEE ALSO
     open(2), setuid(2), ptsname(3C), unlockpt(3C), stdlib(5).










Page 1                       Reliant UNIX 5.44                Printed 11/98