1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
|
.\" Copyright, the authors of the Linux man-pages project
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
.TH KEYCTL_UNLINK 2const 2025-05-17 "Linux man-pages (unreleased)"
.SH NAME
KEYCTL_UNLINK
\-
unlink a key from a keyring
.SH LIBRARY
Standard C library
.RI ( libc ,\~ \-lc )
.SH SYNOPSIS
.nf
.BR "#include <linux/keyctl.h>" " /* Definition of " KEY* " constants */"
.BR "#include <sys/syscall.h>" " /* Definition of " SYS_* " constants */"
.B #include <unistd.h>
.P
.BI "long syscall(SYS_keyctl, KEYCTL_UNLINK, key_serial_t " key ,
.BI " key_serial_t " keyring );
.fi
.SH DESCRIPTION
Unlink a key from a keyring.
.P
The ID of the key to be unlinked is specified in
.IR key ;
the ID of the keyring from which it is to be unlinked is specified in
.IR keyring .
.P
If the key is not currently linked into the keyring, an error results.
.P
The caller must have
.I write
permission on the keyring from which the key is being removed.
.P
If the last link to a key is removed,
then that key will be scheduled for destruction.
.SH RETURN VALUE
On success,
0 is returned.
.P
On error, \-1 is returned, and
.I errno
is set to indicate the error.
.SH ERRORS
.TP
.B ENOENT
The key to be unlinked isn't linked to the keyring.
.SH VERSIONS
A wrapper is provided in the
.I libkeyutils
library:
.BR keyctl_unlink (3).
.SH STANDARDS
Linux.
.SH HISTORY
Linux 2.6.10.
.SH SEE ALSO
.BR keyctl (2),
.BR keyctl_unlink (3),
.BR KEYCTL_LINK (2const)
|
