KEYCTL_CLEAR2const
Clear a keyring
Usage
#include <linux/keyctl.h> /* Definition of KEY* constants */ #include <sys/syscall.h> /* Definition of SYS_* constants */ #include <unistd.h>
long syscall(SYS_keyctl, KEYCTL_CLEAR, key_serial_t key);
Library
Standard C library (libc, -lc)
Overview
Clear the contents of (i.e., unlink all keys from) a keyring.
The ID of the key (which must be of keyring type) is provided in key.
The caller must have write permission on the keyring.
Return value
On success, 0 is returned.
On error, -1 is returned, and errno is set to indicate the error.
Versions
A wrapper is provided in the libkeyutils library: keyctl_clear(3).