Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Apropos / Subsearch:
optional field

revoke(2)							    revoke(2)

  revoke - Voids all references	to a file


	  char *path);


  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.