pthread_key_create(3)      Library Functions Manual      pthread_key_create(3)

NUME
       pthread_key_create, pthread_key_delete, pthread_setspecific,
       pthread_getspecific - gestionarea datelor specifice firului de
       execu<?>ie

REZUMAT
       #include <pthread.h>

       int pthread_key_create(pthread_key_t *key, void (*destr_function) (void
       *)); int pthread_key_delete(pthread_key_t key); int
       pthread_setspecific(pthread_key_t key, const void *pointer); void *
       pthread_getspecific(pthread_key_t key);

DESCRIERE
       Programele au adesea nevoie de variabile globale sau statice care au
       valori diferite in diferite fire de execu<?>ie. Deoarece firele de
       execu<?>ie impart un singur spa<?>iu de memorie, acest lucru nu poate
       fi realizat cu variabile obi<?>nuite. Datele specifice firelor de
       execu<?>ie reprezinta raspunsul POSIX la aceasta necesitate.

       Fiecare fir de execu<?>ie are un bloc de memorie privat, zona de date
       specifica firului de execu<?>ie sau, pe scurt, zona TSD. Aceasta zona
       este indexata cu ajutorul cheilor TSD. Zona TSD asociaza valori de tip
       void * cheilor TSD. Cheile TSD sunt comune tuturor firelor, dar
       valoarea asociata unei anumite chei TSD poate fi diferita in fiecare
       fir.

       Pentru a fi mai concre<?>i, zonele TSD pot fi considerate ca fiind
       matrice de indicatori void *, cheile TSD ca indici intregi in aceste
       matrice, iar valoarea unei chei TSD ca valoare a elementului de matrice
       corespunzator in firul de apelare.

       Atunci cand este creat un fir, zona TSD a acestuia asociaza ini<?>ial
       NULL cu toate cheile.

       pthread_key_create aloca o noua cheie TSD. Cheia este stocata in
       loca<?>ia indicata de key. Exista o limita de PTHREAD_KEYS_MAX pentru
       numarul de chei alocate la un moment dat. Valoarea asociata ini<?>ial
       cheii returnate este NULL in toate firele de execu<?>ie in curs.

       Argumentul destr_function, daca nu este NULL, specifica o func<?>ie de
       distrugere asociata cu cheia. Atunci cand un fir de execu<?>ie se
       termina prin pthread_exit sau prin anulare, destr_function este apelata
       cu argumentele valorii asociate cheii in acel fir de execu<?>ie.
       destr_function nu este apelata daca valoarea respectiva este NULL.
       Ordinea in care sunt apelate func<?>iile de distrugere in momentul
       terminarii firului nu este specificata.

       Inainte de apelarea func<?>iei de distrugere, valoarea NULL este
       asociata cu cheia in firul curent. Cu toate acestea, o func<?>ie de
       distrugere ar putea reasocia valorile non-NULL la aceasta cheie sau la
       o alta cheie. Pentru a rezolva aceasta problema, daca, dupa ce to<?>i
       destructorii au fost apela<?>i pentru toate valorile non-NULL, mai
       exista inca valori non-NULL cu destructori asocia<?>i, procesul se
       repeta. Implementarea ,,LinuxThreads" opre<?>te procesul dupa
       PTHREAD_DESTRUCTOR_ITERATIONS itera<?>ii, chiar daca mai raman cateva
       valori non-NULL cu descriptori asocia<?>i. Alte implementari pot
       efectua bucle la nesfar<?>it.

       pthread_key_delete anuleaza alocarea unei chei TSD. Nu verifica daca
       exista valori non-NULL asociate cu cheia respectiva in firele de
       execu<?>ie in curs de execu<?>ie <?>i nici nu apeleaza func<?>ia de
       distrugere asociata cu cheia.

       pthread_setspecific modifica valoarea asociata cu key in firul de
       apelare, stocand in schimb pointer-ul dat.

       pthread_getspecific returneaza valoarea asociata in prezent cu key in
       firul de apelare.

VALOAREA RETURNATA
       pthread_key_create, pthread_key_delete <?>i pthread_setspecific
       returneaza 0 in caz de succes <?>i un cod de eroare diferit de zero in
       caz de e<?>ec. In caz de succes, pthread_key_create stocheaza cheia nou
       alocata in loca<?>ia indicata de argumentul sau key.

       pthread_getspecific returneaza valoarea asociata cu key in caz de
       succes, <?>i NULL in caz de eroare.

ERORI-IE<?>IRE
       In caz de eroare, pthread_key_create returneaza urmatorul cod de
       eroare:

              EAGAIN Cheile PTHREAD_KEYS_MAX sunt deja alocate.

       In caz de eroare, pthread_key_delete <?>i pthread_setspecific
       returneaza urmatorul cod de eroare:

              EINVAL key nu este o cheie TSD valida, alocata.

       pthread_getspecific returneaza NULL daca key nu este o cheie TSD
       valida, alocata.

CONSULTA<?>I <?>I
       pthread_create(3), pthread_exit(3), pthread_testcancel(3).

EXEMPLU
       Urmatorul fragment de cod aloca o matrice de 100 de caractere specifica
       firului de execu<?>ie, cu recuperare automata la ie<?>irea din fir:


              /* Cheia pentru memoria tampon specifica firului */ static pthread_key_t buffer_key;  /* O singura ini<?>ializare a cheii */ static pthread_once_t buffer_key_once = PTHREAD_ONCE_INIT;  /* Alocarea memoriei tampon specifice firului */ void buffer_alloc(void) {   pthread_once(&buffer_key_once, buffer_key_alloc);   pthread_setspecific(buffer_key, malloc(100)); }  /* Returneaza memoria tampon specifica firului */ char * get_buffer(void) {   return (char *) pthread_getspecific(buffer_key); }  /* Alocarea cheii */ static void buffer_key_alloc() {   pthread_key_create(&buffer_key, buffer_destroy); }  /* Elibereaza memoria tampon specifica firului */ static void buffer_destroy(void * buf) {   free(buf); }


TRADUCERE
       Traducerea in limba romana a acestui manual a fost facuta de Remus-
       Gabriel Chelu <remusgabriel.chelu@disroot.org>

       Aceasta traducere este documenta<?>ie gratuita; citi<?>i Licen<?>a
       publica generala GNU Versiunea 3
       <https://www.gnu.org/licenses/gpl-3.0.html> sau o versiune ulterioara
       cu privire la condi<?>ii privind drepturile de autor.  NU se asuma
       NICIO RESPONSABILITATE.

       Daca gasi<?>i erori in traducerea acestui manual, va rugam sa
       trimite<?>i un e-mail la <translation-team-ro@lists.sourceforge.net>.

Pagini de manual de Linux 6.06 24 noiembrie 2023         pthread_key_create(3)