.B #include <keyutils.h>
.sp
.BI "long keyctl(int " cmd ", ...);"
+.fi
.SH DESCRIPTION
.BR keyctl ()
has a number of functions available:
.TP
-.B KEYCTL_GET_KEYRING_ID
+.B KEYCTL_GET_KEYRING_ID
Ask for a keyring's ID.
.TP
-.B KEYCTL_JOIN_SESSION_KEYRING
+.B KEYCTL_JOIN_SESSION_KEYRING
Join or start named session keyring.
.TP
-.B KEYCTL_UPDATE
+.B KEYCTL_UPDATE
Update a key.
.TP
-.B KEYCTL_REVOKE
+.B KEYCTL_REVOKE
Revoke a key.
.TP
-.B KEYCTL_CHOWN
+.B KEYCTL_CHOWN
Set ownership of a key.
.TP
-.B KEYCTL_SETPERM
+.B KEYCTL_SETPERM
Set perms on a key.
.TP
-.B KEYCTL_DESCRIBE
+.B KEYCTL_DESCRIBE
Describe a key.
.TP
-.B KEYCTL_CLEAR
+.B KEYCTL_CLEAR
Clear contents of a keyring.
.TP
-.B KEYCTL_LINK
+.B KEYCTL_LINK
Link a key into a keyring.
.TP
-.B KEYCTL_UNLINK
+.B KEYCTL_UNLINK
Unlink a key from a keyring.
.TP
-.B KEYCTL_SEARCH
+.B KEYCTL_SEARCH
Search for a key in a keyring.
.TP
-.B KEYCTL_READ
+.B KEYCTL_READ
Read a key or keyring's contents.
.TP
-.B KEYCTL_INSTANTIATE
+.B KEYCTL_INSTANTIATE
Instantiate a partially constructed key.
.TP
-.B KEYCTL_NEGATE
+.B KEYCTL_NEGATE
Negate a partially constructed key.
.TP
-.B KEYCTL_SET_REQKEY_KEYRING
+.B KEYCTL_SET_REQKEY_KEYRING
Set default request-key keyring.
.TP
-.B KEYCTL_SET_TIMEOUT
+.B KEYCTL_SET_TIMEOUT
Set timeout on a key.
.TP
-.B KEYCTL_ASSUME_AUTHORITY
+.B KEYCTL_ASSUME_AUTHORITY
Assume authority to instantiate key.
.P
These are wrapped by
will be returned and errno will have been set to an appropriate error.
.SH ERRORS
.TP
-.B ENOKEY
-No matching key was found or an invalid key was specified.
+.B EACCES
+A key operation wasn't permitted.
+.TP
+.B EDQUOT
+The key quota for the caller's user would be exceeded by creating a key or
+linking it to the keyring.
.TP
.B EKEYEXPIRED
An expired key was found or specified.
.TP
-.B EKEYREVOKED
-A revoked key was found or specified.
-.TP
.B EKEYREJECTED
A rejected key was found or specified.
.TP
-.B EDQUOT
-The key quota for the caller's user would be exceeded by creating a key or
-linking it to the keyring.
+.B EKEYREVOKED
+A revoked key was found or specified.
.TP
-.B EACCES
-A key operation wasn't permitted.
+.B ENOKEY
+No matching key was found or an invalid key was specified.
.SH LINKING
Although this is a Linux system call, it is not present in
.I libc