LDP
/
man-pages
mirror of https://github.com/mkerrisk/man-pages
0
1
Fork 0
Code Releases Activity

thread-keyring.7: Various rewordings and additions 

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2016-11-02 15:19:22 +01:00
parent f6993c8cde
commit c2bd9d60a1
1 changed files with 20 additions and 15 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

35
man7/thread-keyring.7
View File

@ -15,27 +15,32 @@ thread-keyring \- per-thread keyring
.SH DESCRIPTION .SH DESCRIPTION
The thread keyring is a keyring used to anchor keys on behalf of a process. The thread keyring is a keyring used to anchor keys on behalf of a process.
It is created only when a thread requests it. It is created only when a thread requests it.
.P
A special serial number value, A special serial number value,
.BR KEY_SPEC_THREAD_KEYRING , .BR KEY_SPEC_THREAD_KEYRING ,
is defined that is defined that can be used in lieu of the actual serial number of
can be used in lieu of the calling thread's thread keyring's actual serial the calling thread's thread keyring.
number.
.P From the
From the keyctl utility, '\fB@t\fP' can be used instead of a numeric key ID in .BR keyctl (1)
much the same way, but as keyctl is a program run after forking, this is of no utility, '\fB@t\fP' can be used instead of a numeric key ID in
utility. much the same way, but as
.P .BR keyctl (1)
is a program run after forking, this is of no utility.
Thread keyrings are not inherited across Thread keyrings are not inherited across
.BR clone (2) .BR clone (2)
and
.BR fork (2)
and are cleared by and are cleared by
.BR execve (2). .BR execve (2).
A thread keyring is destroyed when the thread that refers to it exits. A thread keyring is destroyed when the thread that refers to it terminates.
.P
If a thread doesn't have a thread keyring when it is accessed, then the thread Initially, a thread does not have a thread keyring.
keyring will be created if the keyring is to be modified, otherwise error If a thread doesn't have a thread keyring when it is accessed,
.B ENOKEY then it will be created if it is to be modified;
will be issued. otherwise the operation will fail with the error
.BR ENOKEY .
.SH SEE ALSO .SH SEE ALSO
.ad l .ad l
.nh .nh