NOM¶

add_key - Ajouter une clé au gestionnaire de clés du noyau

BIBLIOTHÈQUE¶

Bibliothèque C standard (libc, -lc)

SYNOPSIS¶

#include <keyutils.h>

key_serial_t add_key(const char *type, const char *description,
                     const void payload[.plen], size_t plen,
                     key_serial_t keyring);

Note : il n'existe pas d'enveloppe pour cet appel système dans la glibc ; voir NOTES.

DESCRIPTION¶

add_key() crée ou met à jour une clé ayant un type et une description donnés, l'instancie avec une charge utile (payload) de longueur plen, l'attache au trousseau (keyring) spécifié, et renvoie son numéro de série.

La clé peut être rejetée si les données fournies sont dans un mauvais format ou si elles sont non valables de toute autre façon.

Si le trousseau (keyring) de destination contient déjà une clé avec ce type et cette description, alors, si le type de la clé le permet, cette clé sera mise à jour au lieu de créer une nouvelle clé. Dans le cas contraire, une nouvelle clé sera créée, et le trousseau sera mis à jour pour remplacer le lien vers l'ancienne clé par un lien vers la nouvelle.

Le numéro de série du trousseau de destination peut être celui d'un trousseau valable sur lequel l'appelant a le droit d'écriture. Il peut aussi être un des identifiants spéciaux suivants :

KEY_SPEC_THREAD_KEYRING

Cela spécifie le trousseau spécifique aux processus légers (thread-keyring(7)) de l'appelant.

KEY_SPEC_PROCESS_KEYRING

Cela spécifie le trousseau spécifique aux processus de l'appelant (process-keyring(7)).

KEY_SPEC_SESSION_KEYRING

Cela spécifie le trousseau spécifique à la session de l'appelant (session-keyring(7)).

KEY_SPEC_USER_KEYRING

Cela spécifie le trousseau spécifique à l'UID de l'appelant (user-keyring(7)).

KEY_SPEC_USER_SESSION_KEYRING

Cela spécifie le trousseau spécifique à la session de l'UID de l'appelant (user-session-keyring(7)).

VALEUR RENVOYÉE¶

En cas de succès, add_key() renvoie le numéro de série de la clé créée ou mise à jour. En cas d'erreur, -1 est renvoyé et errno est positionné pour indiquer l'erreur.

ERREURS¶

EACCES

Le trousseau n'était pas disponible pour pouvoir être modifié par l'utilisateur.

EDQUOT

Le quota de clés de cet utilisateur serait dépassé si la clé était créée ou ajoutée au trousseau.

EFAULT

Un ou plusieurs type, description et payload (charge utile) pointent à l'extérieur de l'espace d'adresses accessible au processus.

EINVAL

La longueur de la chaîne (y compris l'octet NULL final) spécifié dans type ou description a dépassé la limite (respectivement 32 et 4096 octets).

EINVAL

La charge utile (payload) n’est pas valable.

EINVAL

type était "logon" et la description n'était pas qualifiée avec une chaîne de préfixes sous la forme "service:".

EKEYEXPIRED

Le trousseau a expiré.

EKEYREVOKED

Le trousseau a été révoqué.

ENOKEY

Le trousseau n'existe pas.

ENOMEM

Il n'y a pas assez de mémoire pour créer une clé.

EPERM

type commençait par un point (« . »). Les types de clé commençant par un point sont réservés à l'implémentation.

EPERM

type valait "keyring" et la description commençait par un point (« . »). Les trousseaux dont les descriptions (noms) commençant par un point sont réservés à l'implémentation.

STANDARDS¶

Linux.

HISTORIQUE¶

Linux 2.6.10.

NOTES¶

Aucune enveloppe n'est fournie pour cet appel système dans la glibc. Une enveloppe est fournie dans le paquet libkeyutils (le paquet qui l'accompagne fournit le fichier d'en-tête <keyutils.h>). Quand vous utilisez l'enveloppe de cette bibliothèque, liez-la avec -lkeyutils.

EXEMPLES¶

Le programme ci-dessous crée une clé dont le type, la description et la charge utile sont indiqués dans les paramètres de la ligne de commande, puis il lie la clé au trousseau de la session. La session d'interpréteur suivante montre l'utilisation du programme :

$ ./a.out user mykey "Une charge utile"
L'identifiant de la clé est is 64a4dca
$ grep '64a4dca' /proc/keys
064a4dca I--Q---    1 perm 3f010000  1000  1000 user    mykey: 12

#include <keyutils.h>
#include <stdint.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
int
main(int argc, char *argv[])
{


    key_serial_t key;


    if (argc != 4) {


        fprintf(stderr, "Utilisation : %s type description charge_utile\n",


                argv[0]);


        exit(EXIT_FAILURE);


    }


    key = add_key(argv[1], argv[2], argv[3], strlen(argv[3]),


                  KEY_SPEC_SESSION_KEYRING);


    if (key == -1) {


        perror("add_key");


        exit(EXIT_FAILURE);


    }


    printf("L'identifiant de la clé est %jx\n", (uintmax_t) key);


    exit(EXIT_SUCCESS);
}

VOIR AUSSI¶

keyctl(1), keyctl(2), request_key(2), keyctl(3), keyrings(7), keyutils(7), persistent-keyring(7), process-keyring(7), session-keyring(7), thread-keyring(7), user-keyring(7), user-session-keyring(7)

Les fichiers Documentation/security/keys/core.rst et Documentation/keys/request-key.rst des sources du noyau (ou, avant Linux 4.13, Documentation/security/keys.txt et Documentation/security/keys-request-key.txt).

TRADUCTION¶

La traduction française de cette page de manuel a été créée par Christophe Blaess <https://www.blaess.fr/christophe/>, Stéphan Rafin <stephan.rafin@laposte.net>, Thierry Vignaud <tvignaud@mandriva.com>, François Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe Guérard <fevrier@tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-luc.coulon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas Huriaux <thomas.huriaux@gmail.com>, Nicolas François <nicolas.francois@centraliens.net>, Florentin Duneau <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-bretagne.fr>, Denis Barbier <barbier@debian.org>, David Prévot <david@tilapin.org> et Jean-Philippe MENGUAL <jpmengual@debian.org>

Cette traduction est une documentation libre ; veuillez vous reporter à la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.

Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à debian-l10n-french@lists.debian.org.