Index for Section 2

Alphabetical listing for R

revoke(2)
NAME
  revoke - Voids all references to a file

SYNOPSIS
  revoke(
	  char *path);

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

DESCRIPTION
  The revoke() system 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 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:

  [EINVAL]  The file represented by the pathname is of the incorrect type.

  [ENAMETOOLONG]
	    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.