() function invalidates all current open
file descriptors in the system for the tty device named by
. Subsequent operations on any such
descriptors fail, with the exceptions that a
() from a tty which has been revoked returns
a count of zero (end of file), and a close
will succeed. If the file is a special file for a device which is open, the
device close function is called as if all open references to the file had been
Access to a file may be revoked only by its owner or the superuser. The
() function is used to prepare a terminal
device for a new login session, preventing any access by a previous user of
the terminal. The pty(4)
has this as an implicit operation, but hardwired
require the operation.
Upon successful completion, the value 0 is returned; otherwise the
value -1 is returned and the global variable
is set to indicate the error.
Access to the named file is revoked unless one of the following:
- A component of the path prefix is not a directory.
- A component of a pathname exceeded
NAME_MAX characters, or an entire
pathname (including the terminating NUL) exceeded
- The named file or a component of the path name does not
- path is not associated
with a tty special device.
- Search permission is denied for a component of the path
- Too many symbolic links were encountered in translating the
- path points outside the
process's allocated address space.
- The caller is neither the owner of the file nor the
() function was introduced in