grantpt(3C)                      UNIX System V                      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




























10/89                                                                    Page 1