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 "PROCESS-KEYRING" 7 2017-03-13 Linux "Linux Programmer's Manual"
14 process-keyring \- per-process shared keyring
16 The process keyring is a keyring used to anchor keys on behalf of a process.
17 It is created only when a process requests it.
18 The process keyring has the name (description)
21 A special serial number value,
22 .BR KEY_SPEC_PROCESS_KEYRING ,
23 is defined that can be used in lieu of the actual serial number of
24 the calling process's process keyring.
28 utility, '\fB@p\fP' can be used instead of a numeric key ID in
29 much the same way, but since
31 is a program run after forking, this is of no utility.
33 A thread created using the
36 flag has the same process keyring as the caller of
38 When a new process is created using
40 it initially has no process keyring.
41 A process's process keyring is cleared on
43 The process keyring is destroyed when the last
44 thread that refers to it terminates.
46 If a process doesn't have a process keyring when it is accessed,
47 then the process keyring will be created if the keyring is to be modified;
57 .BR persistent\-keyring (7),
58 .BR session\-keyring (7),
59 .BR thread\-keyring (7),
60 .BR user\-keyring (7),
61 .BR user\-session\-keyring (7)