*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->OpenBSD man pages -> revoke (2)              



NAME    [Toc]    [Back]

     revoke - revoke file access

SYNOPSIS    [Toc]    [Back]

     #include <unistd.h>

     revoke(const char *path);

DESCRIPTION    [Toc]    [Back]

     The revoke function invalidates all current  open  file  descriptors in the
     system for the file named by path.  Subsequent operations on
any such descriptors
 fail, with the exceptions that  a  read()  from  a
character device
     file  which has been revoked returns a count of zero (end of
file), and a
     close() call will succeed.  If the file is  a  special  file
for a device
     which is open, the device close function is called as if all
open references
 to the file had been closed.

     Access to a file may be revoked only by its owner or the superuser.  The
     revoke  function  is normally used to prepare a terminal device for a new
     login session, preventing any access by a previous  user  of
the terminal.

RETURN VALUES    [Toc]    [Back]

     A  0  value  indicated that the call succeeded.  A -1 return
value indicates
     an error occurred and errno is set to indicated the  reason.

ERRORS    [Toc]    [Back]

     Access  to  the named file is revoked unless one of the following:

     [ENOTDIR]     A component of the path prefix is not a directory.

                   A component of a pathname exceeded 255 characters, or an
                   entire path name exceeded 1024 characters.

     [ENOENT]      The named file or a component of the path name
does not exist.

     [EACCES]      Search permission is denied for a component of
the path

     [ELOOP]       Too many symbolic links  were  encountered  in
translating the

     [EFAULT]       path  points  outside the process's allocated
address space.

     [EPERM]       The caller is neither the owner  of  the  file
nor the superuser.

SEE ALSO    [Toc]    [Back]


HISTORY    [Toc]    [Back]

     The revoke function was introduced in 4.3BSD-Reno.

OpenBSD      3.6                           June      4,      1993
[ Back ]
 Similar pages
Name OS Title
sgi_revoke IRIX revoke access to a file
VOP_REVOKE FreeBSD revoke access to a device and its aliases
CSSM_CL_CrlAddCert Tru64 Revoke an input certificate (CDSA)
CL_CrlAddCert Tru64 Revoke an input certificate (CDSA)
vdevgone OpenBSD revoke all specified minor numbered vnodes for a device
AFclosefile IRIX close an audio file, update file header if file was opened for write access.
TP_CertRevoke Tru64 Determine if the revoking certificate group can revoke the subject certificate group (CDSA)
CSSM_TP_CertRevoke Tru64 Determine if the revoking certificate group can revoke the subject certificate group (CDSA)
fhopen NetBSD access file via file handle
fhstatfs FreeBSD access file via file handle
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service