unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

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



revoke(2)							    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 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
  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 dev-
	    ice	is not a tty.