summaryrefslogtreecommitdiff
path: root/man
diff options
context:
space:
mode:
authorDavid Howells <dhowells@redhat.com>2019-08-16 12:52:47 +0100
committerDavid Howells <dhowells@redhat.com>2019-08-19 15:41:03 +0100
commit877a60343810a46d4d2c3b66287211f12f1035d5 (patch)
tree309f4e18ae071747a0e0552703c7ba5c68fb1774 /man
parent93052ad750f2af1cc9b592005cfb95880dc44f4a (diff)
downloadkeyutils-877a60343810a46d4d2c3b66287211f12f1035d5.tar.gz
Allow keyctl new_session to name the session keyring
Allow "keyctl new_session" to name the session keyring it creates and attaches to the parent: $ keyctl new_session fred 52095209 Signed-off-by: David Howells <dhowells@redhat.com>
Diffstat (limited to 'man')
-rw-r--r--man/keyctl.19
1 files changed, 6 insertions, 3 deletions
diff --git a/man/keyctl.1 b/man/keyctl.1
index d1008ff..dd1f4a5 100644
--- a/man/keyctl.1
+++ b/man/keyctl.1
@@ -69,7 +69,7 @@ keyctl \- key management facility control
.br
\fBkeyctl\fR setperm <key> <mask>
.br
-\fBkeyctl\fR new_session
+\fBkeyctl\fR new_session [<name>]
.br
\fBkeyctl\fR session
.br
@@ -736,10 +736,12 @@ unconfined_u:unconfined_r:unconfined_t:s0\-s0:c0.c1023
.fi
.RE
.SS Give the parent process a new session keyring
-\fBkeyctl new_session\fR
+\fBkeyctl new_session [<name>]\fR
This command is used to give the invoking process (typically a shell) a new
-session keyring, discarding its old session keyring.
+session keyring, discarding its old session keyring. If a name is given, the
+keyring is given that name, otherwise it will be given a name of "_ses" and
+will not be manually joinable.
.RS
.nf
@@ -761,6 +763,7 @@ call, and so may only affect processes with matching credentials.
Furthermore, the change does not take effect till the parent process next
transitions from kernel space to user space - typically when the \fBwait\fP()
system call returns.
+
.SS Remove dead keys from the session keyring tree
\fBkeyctl reap\fR