pthread_join(3)            Library Functions Manual            pthread_join(3)

NUME
       pthread_join - se une<?>te cu un fir terminat

BIBLIOTECA
       Biblioteca de fire de execu<?>ie POSIX (libpthread, -lpthread)

REZUMAT
       #include <pthread.h>

       int pthread_join(pthread_t thread, void **retval);

DESCRIERE
       Func<?>ia pthread_join() a<?>teapta ca firul specificat de thread sa se
       incheie.  In cazul in care firul respectiv s-a incheiat deja, atunci
       pthread_join() returneaza imediat.  Firul specificat de thread trebuie
       sa poata fi asociat.

       Daca retval nu este NULL, atunci pthread_join() copiaza starea de
       ie<?>ire a firului <?>inta (adica valoarea pe care firul <?>inta a
       furnizat-o lui pthread_exit(3)) in loca<?>ia indicata de retval.  In
       cazul in care firul <?>inta a fost anulat, atunci PTHREAD_CANCELED este
       plasat in loca<?>ia indicata de retval.

       In cazul in care mai multe fire de execu<?>ie incearca simultan sa se
       uneasca cu acela<?>i fir de execu<?>ie, rezultatele sunt nedefinite.
       In cazul in care firul care apeleaza pthread_join() este anulat, atunci
       firul <?>inta va continua sa poata fi unit (adica nu va fi deta<?>at).

VALOAREA RETURNATA
       In caz de succes, pthread_join() returneaza 0; in caz de eroare,
       returneaza un numar de eroare.

ERORI-IE<?>IRE
       EDEADLK
              A fost detectat un impas (de exemplu, doua fire de execu<?>ie au
              incercat sa se uneasca una cu cealalta); sau thread specifica
              firul de execu<?>ie apelant.

       EINVAL thread nu este un fir de execu<?>ie care poate fi ata<?>at.

       EINVAL Un alt fir de execu<?>ie a<?>teapta deja sa se uneasca cu acest
              fir.

       ESRCH  Nu a putut fi gasit niciun fir de execu<?>ie cu identificatorul
              thread.

ATRIBUTE
       Pentru o explica<?>ie a termenilor folosi<?>i in aceasta sec<?>iune, a
       se vedea attributes(7).

       +--------------------------------------+---------------------+---------+
       |Interfa<?>a                           | Atribut             | Valoare |
       +--------------------------------------+---------------------+---------+
       |pthread_join()                        | Siguran<?>a firelor | MT-Safe |
       +--------------------------------------+---------------------+---------+
STANDARDE
       POSIX.1-2008.

ISTORIC
       POSIX.1-2001.

NOTE
       Dupa un apel reu<?>it la pthread_join(), apelantului i se garanteaza ca
       firul <?>inta s-a incheiat.  Apelantul poate alege apoi sa efectueze
       orice opera<?>iune de cura<?>are necesara dupa terminarea firului (de
       exemplu, eliberarea memoriei sau a altor resurse care au fost alocate
       firului <?>inta).

       Alaturarea cu un fir care a fost alaturat anterior are ca rezultat un
       comportament nedefinit.

       Daca nu se reu<?>e<?>te o imbinare cu un fir care poate fi imbinat
       (adica unul care nu este deta<?>at), se produce un ,,fir zombi".
       Evita<?>i sa face<?>i acest lucru, deoarece fiecare fir zombi consuma
       anumite resurse de sistem, iar atunci cand se vor acumula suficiente
       fire zombi, nu va mai fi posibila crearea de noi fire (sau procese).

       Nu exista un analog <<pthreads>> al waitpid(-1, &status, 0), adica
       ,,unirea cu orice fir terminat".  Daca crede<?>i ca ave<?>i nevoie de
       aceasta func<?>ionalitate, probabil ca trebuie sa va regandi<?>i
       proiectarea aplica<?>iei.

       Toate firele de execu<?>ie dintr-un proces sunt similare: orice fir de
       execu<?>ie se poate alatura oricarui alt fir de execu<?>ie din proces.

EXEMPLE
       A se vedea pthread_create(3).

CONSULTA<?>I <?>I
       pthread_cancel(3), pthread_create(3), pthread_detach(3),
       pthread_exit(3), pthread_tryjoin_np(3), pthreads(7)

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 31 octombrie 2023               pthread_join(3)