NAME    [Toc]    [Back]

       grantpt - Permit access to the slave pseudoterminal device

SYNOPSIS    [Toc]    [Back]

       #include <stdlib.h>

       int grantpt(
               int fildes );

LIBRARY    [Toc]    [Back]

       Standard C Library (libc)

STANDARDS    [Toc]    [Back]

       Interfaces documented on this reference  page  conform  to
       industry standards as follows:

       grantpt():  XPG4-UNIX

       Refer to the standards(5) reference page for more information
 about industry standards and associated tags.

PARAMETERS    [Toc]    [Back]

       Specifies a file descriptor that is returned from  a  successful
 open of a master pseudoterminal device.

DESCRIPTION    [Toc]    [Back]

       The  grantpt() function modifies the ownership and mode of
       the slave pseudoterminal device associated with its master
       pseudoterminal counterpart.

       The  modifications  of mode and ownership are performed as
       follows: The group ID is set to  a  reserved  group.   The
       slave  user  ID is set to the real UID of the calling process.
  The permissions of the slave device are set so that
       the  owner  is allowed read and write access and the group
       is allowed write access.

RETURN VALUES    [Toc]    [Back]

       Upon successful completion, the grantpt() function returns
       a  value  of 0 (zero). Otherwise, it returns a value of -1
       and sets errno to indicate the error.

ERRORS    [Toc]    [Back]

       The grantpt() function sets errno to the specified  values
       for the following conditions:

       The  corresponding  slave  device cannot be accessed.  The
       file descriptor specified by the fildes parameter is not a
       valid open file descriptor.  The file descriptor specified
       by the fildes parameter is not associated  with  a  master
       device.

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

       Applications  calling  grantpt()  may get a SIGCHLD signal
       from processes that they did not explicitly create.

SEE ALSO    [Toc]    [Back]

       Functions: open(2), ptsname(3), setuid(2), unlockpt(3)


       Standards: standards(5)



                                                       grantpt(3)