1THREAD-KEYRING(7)          Linux Programmer's Manual         THREAD-KEYRING(7)
2
3
4

NAME

6       thread-keyring - per-thread keyring
7

DESCRIPTION

9       The  thread  keyring  is  a  keyring used to anchor keys on behalf of a
10       process.  It is created only when a thread  requests  it.   The  thread
11       keyring has the name (description) _tid.
12
13       A special serial number value, KEY_SPEC_THREAD_KEYRING, is defined that
14       can be used in lieu of the actual serial number of the calling thread's
15       thread keyring.
16
17       From  the  keyctl(1) utility, '@t' can be used instead of a numeric key
18       ID in much the same way, but as keyctl(1) is a program run after  fork‐
19       ing, this is of no utility.
20
21       Thread  keyrings  are not inherited across clone(2) and fork(2) and are
22       cleared by execve(2).  A thread keyring is destroyed  when  the  thread
23       that refers to it terminates.
24
25       Initially,  a  thread  does  not  have  a  thread keyring.  If a thread
26       doesn't have a thread keyring when it is accessed, then it will be cre‐
27       ated  if  it  is to be modified; otherwise the operation fails with the
28       error ENOKEY.
29

SEE ALSO

31       keyctl(1), keyctl(3), keyrings(7), persistent-keyring(7),
32       process-keyring(7), session-keyring(7), user-keyring(7),
33       user-session-keyring(7)
34

COLOPHON

36       This page is part of release 4.16 of the Linux man-pages project.  A
37       description of the project, information about reporting bugs, and the
38       latest version of this page, can be found at
39       https://www.kernel.org/doc/man-pages/.
40
41
42
43Linux                             2017-03-13                 THREAD-KEYRING(7)
Impressum