revoke(2)							System Calls Manual							 revoke(2)

NAME

       revoke - Voids all references to a file

SYNOPSIS

       revoke(	    char *path);

PARAMETERS

       Points to a null-terminated string containing the appropriate pathname.

DESCRIPTION

       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 suc-
       ceed 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 sysconfigtab 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 conform 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 manner.

RETURN VALUES

       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.

ERRORS

       If  the	revoke() function fails, errno may be set to one of the following values: 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.  A component of  the  specified  pathname
       does  not  exist,  or  the  path parameter points to an empty string.  A component of the path prefix is not a directory.  The sysconfigtab
       variable revoke-tty-only is set on, but the device is not a tty.  delim off

																	 revoke(2)