Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] pthread_key_create, pthread_key_delete, pthread_setspecific, pthread_getspecific - gestion de données spécifiques à un thread [size=18] [b]Résumé[/b] [/size] [b]#include <pthread.h>[/b] [b][i]int pthread_key_create(pthread_key_t * clé , void (* destr_function ) (void ));[/i][/b] [b][i]int pthread_key_delete(pthread_key_t clé );[/i][/b] [b][i]int pthread_setspecific(pthread_key_t clé , const void pointeur );[/i][/b] [b][i]void * pthread_getspecific(pthread_key_t clé );[/i][/b] [size=18] [b]Description[/b] [/size] Les programmes ont souvent besoin de variables globales ou statiques ayant différentes valeurs dans des threads différents. Comme les threads partagent le même espace mémoire, cet objectif ne peut être réalisé avec les variables usuelles. Les données spécifiques à un thread de POSIX sont la réponse à ce problème. Chaque thread possède un segment mémoire privé, le TSD (Thred-Specific Data : Données Spécifiques au Thread). Cette zone mémoire est indexée par des clés TSD. La zone TST associe des valeurs du type [b]void [/b] aux clés TST. Ces clés sont communes à tous les threads, mais la valeur associée à une clé donnée est différente dans chaque thread. Pour concrétiser ce formalisme, les zones TSD peuvent être vues commes des tableaux de pointeurs [b]void[/b] , les clés TSD comme des indices entiers pour ces tableaux, et les valeurs des clés TSD comme les valeurs des entrées correspondantes dans le tableau du thread appelant. Quand un thread est créé, sa zone TST est unitialement associée aux clés [b]NULL[/b]. [b]pthread_key_create[/b] alloue une nouvelle clé TSD. Cette clé est enregistrée à l'emplacement pointée par [b]clé .[/b] Il ne peut y avoir plus de [b]PTHREAD_KEYS_MAX[/b] clés allouées à un instant donné. La valeur initialement associée avec la clé renvoyée est [b]NULL[/b] dans tous les threads en cours d'exécution. L'argument [i]destr_function[/i], si différent de [b]NULL ,[/b] spécifie une fonction destructrice associée à une clé. Quand le thread se termine par [b]pthread_exit[/b] ou par une annulation, [i]destr_function[/i] est appelée avec en argument les valeurs associées aux clés de ce thread. La fonction [i]destr_function[/i] n'est pas appelée si cette valeur est [b]NULL .[/b] L'ordre dans lequel les fonctions de desctruction sont appelées lors de la fin du thread n'est pas spécifiée. Avant que la fonction de destruction soit appelée, la valeur [b]NULL[/b] est associée à la clé dans le thread courant. Une fonction de destruction peut cependant réassocier une valeur différente de [b]NULL[/b] à cette clé ou une autre clé. Pour gérer ce cas de figure, si après l'appel de tous les destructeurs pour les valeurs différentes de [b]NULL[/b], il existe toujours des valeurs différentes de [b]NULL[/b] avec des destructeurs associés, alors la procédure est répétée. L'implémentation de LinuxThreads interrompt cette procédure après [b]PTHREAD_DESTRUCTOR_ITERATIONS[/b] itérations, même s'il reste des valeurs différentes de [b]NULL[/b] associées à des descripteurs. Les autres implémentations peuvent boucler sans fin. [b]pthread_key_delete[/b] désalloue une clé TSD. Elle ne vérifie pas si des valeurs différentes de [b]NULL[/b] sont associées avec cette clé dans les threads en cours d'exécution, ni n'appelle la fonction de destruction associée avec cette clé. [b]pthread_setspecific[/b] change la valeur associée avec [i]clé[/i] dans le thread appelant, sauve le paramètre [i]pointeur[/i] à sa place. [b]pthread_getspecific[/b] renvoie la valeur actuellement associée avec [i]clé[/i] dans le thread appelant. [size=18] [b]Valeur renvoyée[/b] [/size] [b]pthread_key_create ,[/b] [b]pthread_key_delete ,[/b] et [b]pthread_setspecific[/b] renvoient 0 en cas de succès et un code d'erreur non nul en cas d'échec. En cas de succès, [b]pthread_key_create[/b] enregistre la clé récemment créée à l'emplacement pointé par son arguement [i]clé[/i]. [b]pthread_getspecific[/b] renvoie la valeur associée à [i]clé[/i] en cas de succès et [b]NULL[/b] en cas d'erreur. [size=18] [b]Erreurs[/b] [/size] [b]pthread_key_create[/b] renvoient l'un des codes d'erreur suivants :[table][row][col]    [/col][col] [b]EAGAIN[/b] [b]PTHREAD_KEYS_MAX[/b] [table][row][col]    [/col][col]les clés sont déjà allouées[/col][/row][/table] [b]pthread_key_delete[/b] et [b]pthread_setspecific[/b] renvoient l'un des codes d'erreur suivants :[table][row][col]    [/col][col][/col][/row][/table] [b]EINVAL[/b] [i]clé[/i] [table][row][col]    [/col][col]n'est pas une clé valide ou allouée[/col][/row][/table] [b]pthread_getspecific[/b] renvoie [b]NULL[/b] si la [i]clé[/i] n'est pas associée à des données spécifiques. [/col][/row][/table] [size=18] [b]Auteur[/b] [/size] Xavier Leroy <Xavier.Leroy@inria.fr> [size=18] [b]Voir aussi[/b] [/size] pthread_create(3), pthread_exit(3), pthread_testcancel(3). [size=18] [b]Exemple[/b] [/size] L'extrait de code suivant alloue dans un thread un tableau de 100 caractères, avec libération de la mémoire automatiquement à la fin de l'exécution du thread. [table][row][col]    [/col][col] .ft 3 .nf /* Clé pour le tampon spécifique au thread / static pthread_key_t buffer_key; / Initialisation unique de la clé / static pthread_once_t buffer_key_once = PTHREAD_ONCE_INIT; / Alloue le tampon spécifique au thread / void buffer_alloc(void) { pthread_once(&buffer_key_once, buffer_key_alloc); pthread_setspecific(buffer_key, malloc(100)); } / Renvoie le tampon spécifique au thread / char get_buffer(void) { return (char ) pthread_getspecific(buffer_key); } / Alloue la clée / static void buffer_key_alloc() { pthread_key_create(&buffer_key, buffer_destroy); } / Libère le tampon spécifique au thread / static void buffer_destroy(void buf) { free(buf); } .ft    [/col][/row][/table] .fi [size=18] [b]Traduction[/b] [/size] [i]Thierry Vignaud < tvignaud@mandrakesoft.com >, 2000[/i] [b][/b] Christophe Blaess, 2003.
Fichier