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 9.2 |