PERSISTENT-KEYRING(7)

ИМЯ
persistent-keyring - пользовательская постоянная связка ключей

ОПИСАНИЕ
Постоянная связка ключей — это связка, используемая для привязки от имени пользователя. Для каждого UID ядро создаёт отдельную постоянную связку ключей, которая используется всеми нитями, принадлежащими этому UID. Постоянная связка ключей имеет имя (описание) в виде _persistent.<UID>, <UID> — ID пользователя соответствующего пользователя.

Прямой доступ к постоянной связке ключей невозможен, даже процессам с подходящим UID. Вместо этого сначала она должна быть прицеплена к одной из связок ключей процесса, до этого связка ключей может получить доступ к постоянной связке ключей согласно правам своего владельца. Эта связь создаётся с помощью функции keyctl_get_persistent(3).

Если постоянная связка ключей не существует на момент вызова операции keyctl_get_persistent(3), то она автоматически создаётся.

Каждый раз при выполнении операции keyctl_get_persistent(3) срок действия постоянного ключа сбрасывается в значение:

    /proc/sys/kernel/keys/persistent_keyring_expiry

По истечению срока действия постоянная связка ключей удаляется и все ссылки на неё затем удаляются сборщиком мусора. После этого ключ будет пересоздан при следующем вызове keyctl_get_persistent(3).

В постоянной связке ключей напрямую невозможно искать с помощью request_key(2); в ней можно искать только, если она прицеплена к одной из связок ключей, по которой выполняется request_key(2).

Постоянная связка ключей не зависит от clone(2), fork(2), vfork(2), execve(2) и _exit(2). Она существует до истечения срока действия таймера, после чего удаляется сборщиком мусора. Это позволяет связке ключей хранить ключи дольше жизни ядерной записи соответствующего UID (удаление которой приводит к уничтожению user-keyring(7) и user-session-keyring(7)). Таким образом, постоянную связку ключей можно использовать для хранения токенов аутентификации для процессов, которые выполняются без взаимодействия с пользователем, например программы, выполняемые cron(8).

Постоянная связка ключей используется для хранения объектов, для UID, которые сами имеют ограниченный срок жизни (например, токены kerberos). Если такие токены больше не используются (т. е., связка ключей недоступна), то срок действия постоянной связки ключей позволяет автоматически удалять соответствующие ей объекты.

  Специальные операции
Библиотека keyutils для работы с постоянными связками ключей предоставляет функцию keyctl_get_persistent(3) (эта функция является интерфейсом к операции keyctl(2) KEYCTL_GET_PERSISTENT). Данная операция позволяет вызывающей нити получить постоянную связку ключей, соответствующую её UID или, если нить имеет мандат CAP_SETUID, то постоянная связка ключей соответствует какому-то другому UID в этом же пространстве имён пользователя.

ЗАМЕЧАНИЯ
Каждое пространство имён пользователя имеет свою связку ключей с именем .persistent_register, в которой содержатся ссылки на все постоянные ключи в этом пространстве имён (связку ключей .persistent_register можно увидеть при чтении в пространстве имён содержимого файла /proc/keys для UID 0). Операция keyctl_get_persistent(3) ищет ключ с именем в виде _persistent.<UID> в этой связке ключей, создаёт ключ, если он не существует и прицепляет его в связку ключей.

СМОТРИТЕ ТАКЖЕ
keyctl(1), keyctl(3), keyctl_get_persistent(3), keyrings(7), process-keyring(7), session-keyring(7), thread-keyring(7), user-keyring(7), user-session-keyring(7)