aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--man7/keyrings.720
-rw-r--r--man7/persistent-keyring.72
-rw-r--r--man7/session-keyring.72
3 files changed, 12 insertions, 12 deletions
diff --git a/man7/keyrings.7 b/man7/keyrings.7
index 385ee07b11..96d9b37410 100644
--- a/man7/keyrings.7
+++ b/man7/keyrings.7
@@ -14,7 +14,7 @@
.SH NAME
keyrings \- in-kernel key management and retention facility
.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
-.SH OVERVIEW
+.SH DESCRIPTION
The
.B keyrings
facility is primarily a way for drivers to retain or cache security data,
@@ -52,7 +52,7 @@ This document contains the following sections:
.br
.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
.P
-.SH KEYS
+.SS Keys
The facility provides the concept of a '\fBkey\fR', where all of the above
examples are encapsulated within objects of this type.
.P
@@ -111,7 +111,7 @@ See the
.BR keyctl_describe (3)
manual page for more information.
.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
-.SH KEY TYPES
+.SS Key types
.P
The facility provides several basic types of key:
.IP "\fBkeyring\fR"
@@ -138,7 +138,7 @@ There are more specialised key types available also, but they're not discussed
here as they're not intended for normal userspace use.
.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
.P
-.SH KEYRINGS
+.SS Keyrings
As previously mentioned, keyrings are a special type of key that contain links
to other keys (which may include other keyrings).
Keys may be linked to by multiple keyrings.
@@ -173,7 +173,7 @@ and
.BR keyctl_unlink (3)
manual pages for more information.
.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
-.SH ANCHORING KEYS
+.SS Anchoring keys
.P
To prevent a key from being prematurely garbage collected,
it must anchored to keep its reference count elevated
@@ -239,7 +239,7 @@ and
.BR persistent-keyring (7)
manual pages for more information.
.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
-.SH POSSESSION
+.SS Possession
.P
The concept of '\fBpossession\fR' is important to understanding the keyrings
security model.
@@ -273,7 +273,7 @@ When it creates the session keyring,
adds a link to the user keyring,
thus making the user keyring and anything it contains possessed by default.
.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
-.SH ACCESS RIGHTS
+.SS Access rights
.P
Each key has the following security-related attributes:
.P
@@ -347,7 +347,7 @@ and
.BR selinux (8)
manual pages for more information.
.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
-.SH SEARCHING FOR KEYS
+.SS Searching for keys
.P
One of the key features of this facility is the ability to find a key that it
is retaining.
@@ -391,7 +391,7 @@ and
.BR keyctl_search (3)
for more information.
.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
-.SH ON-DEMAND KEY CREATION
+.SS On-demand key creation
.P
If a key cannot be found,
.BR request_key (2)
@@ -422,7 +422,7 @@ and
.BR request-key.conf (5)
manual pages for more information.
.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
-.SH USERS
+.SS Users
.P
The facility has a number of users and usages, but is not limited to those
that already exist.
diff --git a/man7/persistent-keyring.7 b/man7/persistent-keyring.7
index ee2dd54d73..4c4fb6be14 100644
--- a/man7/persistent-keyring.7
+++ b/man7/persistent-keyring.7
@@ -48,7 +48,7 @@ in the destruction of the user and user session keyrings).
.P
If a persistent keyring does not exist when it is accessed, it will be
created.
-.SH SPECIAL OPERATIONS
+.SS Special operations
The keyutils library provides a special operation for manipulating persistent
keyrings:
.IP \fBkeyctl_get_persistent\fP()
diff --git a/man7/session-keyring.7 b/man7/session-keyring.7
index 8b23760eb5..8ad5c43f12 100644
--- a/man7/session-keyring.7
+++ b/man7/session-keyring.7
@@ -44,7 +44,7 @@ refers to it exits.
If a process doesn't have a session keyring when it is accessed, then, under
certain circumstances, the \fBuser session keyring\fR will be attached as the
session keyring and under others a new session keyring will be created.
-.SH SPECIAL OPERATIONS
+.SS Special operations
The keyutils library provides a number of special operations for manipulating
session keyrings:
.IP \fBkeyctl_join_session_keyring\fP()