opensolaris man page for grantpt

grantpt(3C)						   Standard C Library Functions 					       grantpt(3C)

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

SYNOPSIS
       #include <stdlib.h>

       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 coun-
       terpart. 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 master pseudo-terminal device.

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

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

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO
       open(2), ptsname(3C), unlockpt(3C), attributes(5), standards(5)

       STREAMS Programming Guide

SunOS 5.11							    14 Aug 2006 						       grantpt(3C)