.\" The Regents of the University of California. All rights reserved.
.\" This code is derived from software contributed to Berkeley by
.\" Berkeley Software Design, Inc.
.\" %sccs.include.redist.man%
.\" @(#)revoke.2 8.1 (Berkeley) %G%
function invalidates all current open file descriptors in the system
Subsequent operations on any such descriptors
fail, with the exceptions that a
from a character device file which has been revoked
returns a count of zero (end of file),
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 closed.
Access to a file may be revoked only by its owner or the super user.
function is currently supported only for block and character special
It is normally used to prepare a terminal device for a new login session,
preventing any access by a previous user of the terminal.
A 0 value indicated that the call succeeded. A \-1 return value
indicates an error occurred and
is set to indicated the reason.
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 255 characters,
or an entire path name exceeded 1024 characters.
The named file or a component of the path name does not exist.
Search permission is denied for a component of the path prefix.
Too many symbolic links were encountered in translating the pathname.
points outside the process's allocated address space.
The named file is neither a character special or block
The caller is neither the owner of the file nor the super user.
function was introduced in