revoke man page on MirBSD

Man page or keyword search:  
man Server   6113 pages
apropos Keyword Search (all sections)
Output format
MirBSD logo
[printable version]

REVOKE(2)		   BSD Programmer's Manual		     REVOKE(2)

NAME
     revoke - revoke file access

SYNOPSIS
     #include <unistd.h>

     int
     revoke(const char *path);

DESCRIPTION
     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 dev-
     ice 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 dev-
     ice 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
     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
     Access to the named file is revoked unless one of the following:

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

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

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

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

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

     [EPERM]	   The caller is neither the owner of the file nor the su-
		   peruser.

SEE ALSO
     close(2)

HISTORY
     The revoke function was introduced in 4.3BSD-Reno.

MirOS BSD #10-current		 June 4, 1993				     1
[top]

List of man pages available for MirBSD

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net