KEYCTL_CLEAR(2const)                                      KEYCTL_CLEAR(2const)

NAME
       KEYCTL_CLEAR - clear a keyring

LIBRARY
       Standard C library (libc, -lc)

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

DESCRIPTION
       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).

STANDARDS
       Linux.

HISTORY
       Linux 2.6.10.

SEE ALSO
       keyctl(2), keyctl_clear(3)

Linux man-pages 6.10              2024-08-21              KEYCTL_CLEAR(2const)