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.