2 .\" Copyright (C) 2014 Red Hat, Inc. All Rights Reserved.
3 .\" Written by David Howells (dhowells@redhat.com)
5 .\" %%%LICENSE_START(GPLv2+_SW_ONEPARA)
6 .\" This program is free software; you can redistribute it and/or
7 .\" modify it under the terms of the GNU General Public License
8 .\" as published by the Free Software Foundation; either version
9 .\" 2 of the License, or (at your option) any later version.
12 .TH "THREAD-KEYRING" 7 2017-03-13 Linux "Linux Programmer's Manual"
14 thread-keyring \- per-thread keyring
16 The thread keyring is a keyring used to anchor keys on behalf of a process.
17 It is created only when a thread requests it.
18 The thread keyring has the name (description)
21 A special serial number value,
22 .BR KEY_SPEC_THREAD_KEYRING ,
23 is defined that can be used in lieu of the actual serial number of
24 the calling thread's thread keyring.
28 utility, '\fB@t\fP' can be used instead of a numeric key ID in
29 much the same way, but as
31 is a program run after forking, this is of no utility.
33 Thread keyrings are not inherited across
39 A thread keyring is destroyed when the thread that refers to it terminates.
41 Initially, a thread does not have a thread keyring.
42 If a thread doesn't have a thread keyring when it is accessed,
43 then it will be created if it is to be modified;
44 otherwise the operation fails with the error
52 .BR persistent\-keyring (7),
53 .BR process\-keyring (7),
54 .BR session\-keyring (7),
55 .BR user\-keyring (7),
56 .BR user\-session\-keyring (7)