KEYCTL_CLEAR(2const)

NAME

KEYCTL_CLEAR - clear a keyring

LIBRARY

Standard C library (libc, -lc)

#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);

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.

On success, 0 is returned.

On error, -1 is returned, and errno is set to indicate the error.

A wrapper is provided in the libkeyutils library: keyctl_clear(3).

Linux.

Linux 2.6.10.