KEYCTL_REVOKE(2const)                                    KEYCTL_REVOKE(2const)

NAME
       KEYCTL_REVOKE - revoke a key

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_REVOKE, key_serial_t key);

DESCRIPTION
       Revoke the key with the ID provided in key.  The key is scheduled for
       garbage collection; it will no longer be findable, and will be
       unavailable for further operations.  Further attempts to use the key
       will fail with the error EKEYREVOKED.

       The caller must have write or setattr permission on the key.

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_revoke(3).

STANDARDS
       Linux.

HISTORY
       Linux 2.6.10.

SEE ALSO
       keyctl(2), keyctl_revoke(3)

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