revoke - Voids all references to a file
path Points to a null-terminated string containing the appropriate
The call invalidates all file descriptors associated with the pathname
specified in path, which must be a block or character special file. Any
open file system object on the device on which the revoked file system
object resides subsequently holds an invalid file descriptor, and will
receive errors if it attempts to access the file with any read, write,
ioctl, or select system call. The only call that will succeed under these
conditions is close(). A subsequent call to open() will result in a valid
file descriptor and thereby reenable access to the file.
The behavior of the revoke() system call depends on the setting of a sys-
configtab variable, revoke-tty-only. By default, the revoke-tty-only
parameter is set on. In this case, the system call conforms to the
behavior of earlier versions of the call, but only for tty devices. For
all other devices, the call returns an error, ENOTTY.
You can set off the revoke-tty-only parameter to make the system call con-
form to its behavior in earlier versions of Tru64 UNIX .
The effective user ID of the process must be the same as the owner of the
file, or must have superuser privilege in order to use the call in this
Upon successful completion, a value of 0 (zero) is returned. If the
revoke() function fails, it returns a value of -1, and errno is set to
indicate the error.
If the revoke() function fails, errno may be set to one of the following
[EINVAL] The file represented by the pathname is of the incorrect type.
The size of the pathname exceeds PATH_MAX or a pathname component
is longer than NAME_MAX.
[ENOENT] A component of the specified pathname does not exist, or the path
parameter points to an empty string.
[ENOTDIR] A component of the path prefix is not a directory.
[ENOTTY] The sysconfigtab variable revoke-tty-only is set on, but the dev-
ice is not a tty.