int
grantpt(
int fildes
)
)
function changes the mode and ownership of the slave pseudo-terminal device
that corresponds to the master pseudo-terminal device associated with
fildes
to be owned by the real user id of the calling process, group id of
tty
.
The permissions are set to readable and writable by owner, and writable by
group.
If the slave pseudo-terminal device was being accessed by other file
descriptors at the time, all such access will be revoked.
)
returns 0; otherwise a value of -1 is returned and
errno
is set to indicate the error.
)
function will fail if:
EACCESS
]
EBADF
]
fildes
is not a valid descriptor.
EINVAL
]
fildes
is not associated with a master pseudo-terminal device.
tty
and revoking accesses by other file descriptors are
NetBSD
extensions.
Calling
grantpt(
)
is equivalent to:
ioctl(fildes, TIOCGRANTPT, 0);
)
function conforms to
IEEE Std 1003.1-2001 (``POSIX.1'') .
Its first release was in
X/Open Portability Guide Issue 4, Version 2 (``XPG4.2'') .