Manual Pages for UNIX Operating System command usage for man grantpt

Standard C Library Functions                          grantpt(3C)



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

SYNOPSIS
     #include 

     int grantpt(int fildes);


DESCRIPTION
     The grantpt() function changes the mode and ownership of the
     slave  pseudo-terminal  device  associated  with  its master
     pseudo-terminal counterpart. fildes is the  file  descriptor
     returned  from  a  successful  open  of  the  master pseudo-
     terminal device. The user ID of the slave is set to the real
     UID  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 and writable by the owner and
     writable by the group.

RETURN VALUES
     Upon successful completion, grantpt() returns 0.  Otherwise,
     it returns -1 and sets errno to indicate the error.

ERRORS
     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  mas-
               ter pseudo-terminal device.


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


ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:













SunOS 5.11          Last change: 14 Aug 2006                    1






Standard C Library Functions                          grantpt(3C)



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | Safe                        |
    |_____________________________|_____________________________|
    | Standard                    | See standards(5).           |
    |_____________________________|_____________________________|


SEE ALSO
     open(2),  ptsname(3C),  unlockpt(3C),  attributes(5),  stan-
     dards(5)


     STREAMS Programming Guide






































SunOS 5.11          Last change: 14 Aug 2006                    2