NOM¶
request_key - Demander une clé au gestionnaire de clés du noyau
SYNOPSIS¶
#include <keyutils.h>
key_serial_t request_key(const char *type, const char *description,
const char *callout_info,
key_serial_t keyring);
DESCRIPTION¶
request_key() demande au noyau de trouver une clé d'un
type
donné, qui correspond à la
description
spécifiée, et si une clé est trouvée, l'attache au
trousseau (
keyring) donné en argument et renvoie son
numéro de série.
request_key() cherche une clé correspondant aux critères
d'abord récursivement à l'intérieur des trousseaux
attachés au processus appelant, dans l'ordre suivant : trousseau
spécifique au processus léger (
thread), trousseau
spécifique au processus, et enfin le trousseau de session.
Si
request_key() est appelé depuis un programme lui-même
appelé par
request_key() au nom d'un autre processus afin de
générer une clé, alors les trousseaux de cet autre
processus seront ensuite parcourus, l'accès étant
contrôlé par les attributs UID, GID, les groupes et le contexte
de sécurité de cet autre processus.
Une correspondance est d'abord recherchée avec toutes les clés
d'un trousseau avant de chercher dans les trousseaux trouvés dans ce
trousseau. Seules les clés qui sont accessibles à l'appelant
peuvent être trouvées, et de même seuls les trousseaux
qui lui sont accessibles peuvent être parcourus.
Si aucune clé n'est trouvée, et si
callout_info
possède une valeur non NULL, cette fonction va essayer de chercher plus
loin. Dans un tel cas, l'argument
callout_info est passé
à un service de l'espace utilisateur, tel que
/sbin/request-key,
pour générer la clé.
Si cela échoue aussi, alors une erreur est renvoyée, et une
clé temporaire négative est insérée dans le
trousseau spécifié. Cette clé expirera au bout de
quelques secondes, mais en attendant, tous les appels ultérieurs
à
request_key() avec les mêmes arguments échouera.
Le numéro de série
keyring peut être celui d'un
trousseau valide sur lequel l'appelant possède les droits en
écriture, ou il peut être un identifiant de trousseau
spécial :
- KEY_SPEC_THREAD_KEYRING
- Pour indiquer le trousseau spécifique au processus léger
(thread) de l'appelant.
- KEY_SPEC_PROCESS_KEYRING
- Pour indiquer le trousseau spécifique au processus de
l'appelant.
- KEY_SPEC_SESSION_KEYRING
- Pour indiquer le trousseau spécifique à la session de
l'appelant.
- KEY_SPEC_USER_KEYRING
- Pour indiquer le trousseau spécifique à l'UID de
l'appelant.
- KEY_SPEC_USER_SESSION_KEYRING
- Pour indiquer le trousseau spécifique à la session de l'UID
de l'appelant.
Si une clé est créée, qu'elle soit valide ou
négative, elle remplacera toute autre clé possédant le
même type et la même description dans le trousseau destination.
VALEUR RENVOYÉE¶
En cas de succès,
request_key() renvoie le numéro de
série de la clé trouvée. En cas d'erreur, la valeur
-1 est renvoyée et
errno contient un code d'erreur
approprié.
ERREURS¶
- EACCES
- Le trousseau n'était pas disponible pour pouvoir être
modifié par l'utilisateur.
- EINTR
- La requête a été interrompue par un signal.
- EDQUOT
- Le quota de clés de cet utilisateur serait dépassé si
la clé était créée ou ajoutée au
trousseau.
- EKEYEXPIRED
- Une clé expirée a été trouvée, mais
aucun remplacement n'a pu être obtenu.
- EKEYREJECTED
- La tentative de générer une nouvelle clé a
été rejetée.
- EKEYREVOKED
- Une clé révoquée a été trouvée,
mais aucun remplacement n'a pu être obtenu.
- ENOMEM
- Il n'y a pas assez de mémoire pour créer une
clé.
- ENOKEY
- Aucune clé correspondante n'a été
trouvée.
ÉDITION DE LIENS¶
Bien qu'il s'agisse d'un appel système Linux, cette fonction n'est pas
présente dans
libc, mais peut être trouvée dans
libkeyutils. L'édition des liens doit être être
effectuée avec l'option
-lkeyutils.
VOIR AUSSI¶
keyctl(1),
add_key(2),
keyctl(2),
request-key(8)
COLOPHON¶
Cette page fait partie de la publication 3.65 du projet
man-pages Linux.
Une description du projet et des instructions pour signaler des anomalies
peuvent être trouvées à l'adresse
http://www.kernel.org/doc/man-pages/.
TRADUCTION¶
Depuis 2010, cette traduction est maintenue à l'aide de l'outil po4a
<
http://po4a.alioth.debian.org/> par l'équipe de traduction
francophone au sein du projet perkamon
<
http://perkamon.alioth.debian.org/>.
Denis Barbier (2010).
Veuillez signaler toute erreur de traduction en écrivant à
<debian-l10n-french@lists.debian.org> ou par un rapport de bogue sur le
paquet
manpages-fr.
Vous pouvez toujours avoir accès à la version anglaise de ce
document en utilisant la commande «
man -L C
<section>
<page_de_man> ».