Sous-routine ukeyset_init

Objectif

Initialise un jeu de clés utilisateur.

Bibliothèque

Bibliothèque C standard (libc.a)

Syntaxe

#include <sys/ukeys.h>

int ukeyset_init (nset, flags)
ukeyset_t * nset;
unsigned int flags;

Descriptif

La sous-routine ukeyset_init initialise l'ensemble de clés utilisateur désigné par le paramètre nset . L'ensemble de clés comporte des accès en lecture et en écriture qui sont activés pour UKEY_PUBLIC seul et désactivés pour toutes les autres clés. Si l'indicateur UK_INIT_ADD_PRIVATE est spécifié, l'accès en lecture et en écriture pour toutes les clés d'utilisateur privées disponibles est activé.

Paramètres

Tableau 1. Paramètres
Article	Descriptif
`Nset`	Pointe vers l'utilisateur-clé-set à initialiser.
`Flags`	Doit être défini sur zéro pour le comportement par défaut (uniquement la clé d'utilisateur publique activée) ou sur `UK_INIT_ADD_PRIVATE` si toutes les clés d'utilisateur privées doivent également être activées.

Valeurs renvoyées

Si l'opération aboutit, la sous-routine ukeyset_init renvoie la valeur 0. Sinon, il renvoie une valeur de -1 et définit la variable globale errno pour indiquer l'erreur.

Codes d'erreur

La sous-routine ukeyset_init échoue si les conditions suivantes sont remplies:

Tableau 2. Codes d'erreur
Article	Descriptif
`EINVAL`	Paramètre d'indicateur non valide, ou paramètre `Nset` NULL ou mal aligneur.
`ENOSYS`	Il ne s'agit pas d'un processus activé pour les clés utilisateur.

Informations connexes

Sous-routine ukey_enable .

Sous-routine ukey_setjmp .

Sous-routine ukeyset_add_key, ukeyset_remove_key, ukeyset_add_set, ukeyset_remove_set .

Sous-routine ukeyset_activate .

Sous-routine ukeyset_ismember .

Sous-routine pthread_attr_getukeyset_np or pthread_attr_setukeyset_np .