NAME

grantpt - grant access to the slave pseudo-terminal device

SYNOPSIS

int grantpt(int fildes);

DESCRIPTION

The function grantpt changes the mode and ownership of the slave pseudo-terminal device associated with its master pseudo-terminal counter part. fildes is the file descriptor returned from a successful open of the master pseudo-terminal device. A setuid root program [see setuid(2)] is invoked to change the permissions. The user ID of the slave is set to the effective owner 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, writeable by the owner and writeable by the group.

RETURN VALUE

Upon successful completion, the function grantpt returns 0; otherwise it returns -1. Failure could occur if fildes is not an open file descriptor, if fildes is not associated with a master pseudo-terminal device, or if the corresponding slave device could not be accessed.

SEE ALSO

open(2), setuid(2).

ptsname(3C), unlockpt(3C)
in the Programmer's Guide: STREAMS.