man7/thread-keyring.7

   1 .\" Copyright (C) 2014 Red Hat, Inc. All Rights Reserved.
   2 .\" Written by David Howells (dhowells@redhat.com)
   3 .\"
   4 .\" SPDX-License-Identifier: GPL-2.0-or-later
   5 .\"
   6 .TH thread-keyring 7 (date) "Linux man-pages (unreleased)"
   7 .SH NAME
   8 thread-keyring \- per-thread keyring
   9 .SH DESCRIPTION
  10 The thread keyring is a keyring used to anchor keys on behalf of a process.
  11 It is created only when a thread requests it.
  12 The thread keyring has the name (description)
  13 .IR _tid .
  14 .PP
  15 A special serial number value,
  16 .BR KEY_SPEC_THREAD_KEYRING ,
  17 is defined that can be used in lieu of the actual serial number of
  18 the calling thread's thread keyring.
  19 .PP
  20 From the
  21 .BR keyctl (1)
  22 utility, '\fB@t\fP' can be used instead of a numeric key ID in
  23 much the same way, but as
  24 .BR keyctl (1)
  25 is a program run after forking, this is of no utility.
  26 .PP
  27 Thread keyrings are not inherited across
  28 .BR clone (2)
  29 and
  30 .BR fork (2)
  31 and are cleared by
  32 .BR execve (2).
  33 A thread keyring is destroyed when the thread that refers to it terminates.
  34 .PP
  35 Initially, a thread does not have a thread keyring.
  36 If a thread doesn't have a thread keyring when it is accessed,
  37 then it will be created if it is to be modified;
  38 otherwise the operation fails with the error
  39 .BR ENOKEY .
  40 .SH SEE ALSO
  41 .ad l
  42 .nh
  43 .BR keyctl (1),
  44 .BR keyctl (3),
  45 .BR keyrings (7),
  46 .BR persistent\-keyring (7),
  47 .BR process\-keyring (7),
  48 .BR session\-keyring (7),
  49 .BR user\-keyring (7),
  50 .BR user\-session\-keyring (7)