man pages section 3: Basic Library Functions

Exit Print View

Updated: July 2014
 
 

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 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 Also

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

STREAMS Programming Guide