thread-keyring (7)

Leading comments

Copyright (C) 2014 Red Hat, Inc. All Rights Reserved.
Written by David Howells (dhowells@redhat.com)

This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public Licence
as published by the Free Software Foundation; either version
2 of the Licence, or (at your option) any later version.

(The comments found at the beginning of the groff file "man7/thread-keyring.7".)

NAME

thread-keyring - Per-thread keyring

DESCRIPTION

The thread keyring is a keyring used to anchor keys on behalf of a process. It is only created when a thread requests it. A special serial number value, KEY_SPEC_THREAD_KEYRING, is defined that can be used in lieu of the calling thread's thread keyring's actual serial number. From the keyctl utility, '@t' can be used instead of a numeric key ID in much the same way, but as keyctl is a program run after forking, this is of no utility. Thread keyrings are not inherited across clone() and are cleared by execve(). A thread keyring is destroyed when the thread that refers to it exits. If a thread doesn't have a thread keyring when it is accessed, then the thread keyring will be created if the keyring is to be modified, otherwise error ENOKEY will be issued.

SEE ALSO

keyctl(1),
keyctl(3),
keyrings(7),
process-keyring(7),
session-keyring(7),
user-keyring(7),
user-session-keyring(7)
persistent-keyring(7)