| REVOKE(2) | System Calls Manual | REVOKE(2) | 
revoke —
#include <unistd.h>
int
  
  revoke(const
    char *path);
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(2) from a character device
  file which has been revoked returns a count of zero (end of file), and a
  close(2) 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 super user.
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.
EACCES]EFAULT]ELOOP]ENAMETOOLONG]NAME_MAX}
      characters, or an entire path name exceeded
      {PATH_MAX} characters.ENOENT]ENOTDIR]EPERM]revoke() function was introduced in
  4.3BSD-Reno.
| July 3, 2011 | NetBSD 10.0 |