Index for Section 2

Alphabetical listing for R

Bottom of page

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 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
  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:

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

  [ENOTTY]  The sysconfigtab variable revoke-tty-only is set on, but the
	    device is not a tty.

Index for Section 2

Alphabetical listing for R

Top of page