grantpt(3C) Standard C Library Functions grantpt(3C)NAMEgrantpt - 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
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 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 │Committed │
├─────────────────────────────┼─────────────────────────────┤
│MT-Level │Safe │
├─────────────────────────────┼─────────────────────────────┤
│Standard │See standards(5). │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOopen(2), ptsname(3C), unlockpt(3C), attributes(5), standards(5)
STREAMS Programming Guide
SunOS 5.11 14 Aug 2006 grantpt(3C)