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.

ERORS
     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.


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


ATRIBUTES
     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)



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Standard                    
    
     MT-Level                     Safe                        
    


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