NAME¶
keyctl_revoke - Revoke a key
SYNOPSIS¶
#include <keyutils.h>
long keyctl_revoke(key_serial_t key);
DESCRIPTION¶
keyctl_revoke() marks a key as being revoked.
After this operation has been performed on a key, attempts to access it will
meet with error
EKEYREVOKED.
The caller must have
write permission on a key to be able revoke it.
RETURN VALUE¶
On success
keyctl_revoke() returns
0. On error, the value
-1 will be returned and errno will have been set to an appropriate
error.
ERRORS¶
- ENOKEY
- The specified key does not exist.
- EKEYREVOKED
- The key has already been revoked.
- EACCES
- The named key exists, but is not writable by the calling
process.
LINKING¶
This is a library function that can be found in
libkeyutils. When
linking,
-lkeyutils should be specified to the linker.
SEE ALSO¶
keyctl(1),
add_key(2),
keyctl(2),
request_key(2),
keyctl(3),
keyutils(7),
keyrings(7)