pthread_attr_setguardsize(3)                          Library Functions Manual

NUME
       pthread_attr_setguardsize, pthread_attr_getguardsize -
       stabile<?>te/ob<?>ine atributul de dimensiune a garzii in obiectul
       atributele firului de execu<?>ie

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

SINOPSIS
       #include <pthread.h>

       int pthread_attr_setguardsize(pthread_attr_t *attr, size_t guardsize);
       int pthread_attr_getguardsize(const pthread_attr_t *restrict attr,
                                     size_t *restrict guardsize);

DESCRIERE
       Func<?>ia pthread_attr_setguardsize() stabile<?>te atributul ,,guard
       size" (dimensiune a garzii) al obiectului de atribute ale firelor la
       care face referire attr la valoarea specificata in guardsize.

       Daca guardsize este mai mare decat 0, atunci pentru fiecare fir nou
       creat folosind attr, sistemul aloca o regiune suplimentara de cel
       pu<?>in guardsize octe<?>i la sfar<?>itul stivei firului pentru a
       ac<?>iona ca zona de garda pentru stiva (a se vedea insa sec<?>iunea
       ERORI).

       Daca guardsize este 0, atunci firele noi create cu attr nu vor avea o
       zona de garda.

       Dimensiunea implicita a garzii este aceea<?>i cu dimensiunea paginii
       sistemului.

       Daca atributul adresei stivei a fost stabilit in attr (utilizand
       pthread_attr_setstack(3) sau pthread_attr_setstackaddr(3)), ceea ce
       inseamna ca apelantul aloca stiva firului, atunci atributul dimensiunii
       garzii este ignorat (de exemplu, pthread_attr_setstackaddr(3)),
       sistemul nu creeaza nicio zona de garda): este responsabilitatea
       aplica<?>iei sa gestioneze depa<?>irea stivei (poate prin utilizarea
       mprotect(2) pentru a defini manual o zona de garda la capatul stivei pe
       care a alocat-o).

       Func<?>ia pthread_attr_getguardsize() returneaza atributul "guard size"
       al obiectului atribute ale firului de execu<?>ie la care se face
       referire prin attr in memoria tampon indicata de guardsize..

VALOAREA RETURNATA
       In caz de succes, aceste func<?>ii returneaza 0; in caz de eroare, ele
       returneaza un numar de eroare diferit de zero.

ERORI-IE<?>IRE
       POSIX.1 documenteaza o eroare EINVAL in cazul in care attr sau
       guardsize nu este valida.  In Linux, aceste func<?>ii reu<?>esc
       intotdeauna (dar aplica<?>iile portabile <?>i pregatite pentru viitor
       ar trebui totu<?>i sa se ocupe de o posibila returnare de eroare).

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

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

ISTORIC
       glibc 2.1.  POSIX.1-2001.

NOTE
       O zona de garda consta in pagini de memorie virtuala care sunt
       protejate pentru a impiedica accesul la citire <?>i scriere.  In cazul
       in care un fir de execu<?>ie i<?>i depa<?>e<?>te stiva in zona de
       garda, atunci, pe majoritatea arhitecturilor, prime<?>te un semnal
       SIGSEGV, fiind astfel notificat de depa<?>ire.  Zonele de garda incep
       la limitele paginilor, iar dimensiunea zonei de garda este rotunjita in
       mod intern la dimensiunea paginii sistemului la crearea unui fir; (cu
       toate acestea, pthread_attr_getguardsize() returneaza dimensiunea de
       garda care a fost setata de pthread_attr_setguardsize().).

       Stabilirea unei dimensiuni de garda de 0 poate fi utila pentru a
       economisi memorie intr-o aplica<?>ie care creeaza multe fire de
       execu<?>ie <?>i <?>tie ca nu se poate produce niciodata o depa<?>ire a
       stivei.

       Alegerea unei dimensiuni de garda mai mari decat dimensiunea implicita
       poate fi necesara pentru detectarea depa<?>irilor de stiva in cazul in
       care un fir aloca structuri de date mari pe stiva.

ERORI
       Ca <?>i in glibc 2.8, implementarea NPTL threading include zona de
       garda in cadrul alocarii dimensiunii stivei, in loc sa aloce spa<?>iu
       suplimentar la sfar<?>itul stivei, a<?>a cum prevede POSIX.1; (acest
       lucru poate avea ca rezultat o eroare EINVAL de la pthread_create(3)
       daca valoarea dimensiunii de garda este prea mare, nefiind lasat
       spa<?>iu pentru stiva propriu-zisa).

       Implementarea invechita a LinuxThreads a facut ceea ce trebuia, alocand
       spa<?>iu suplimentar la sfar<?>itul stivei pentru zona de garda.

EXEMPLE
       A se vedea pthread_getattr_np(3).

CONSULTA<?>I <?>I
       mmap(2), mprotect(2), pthread_attr_init(3), pthread_attr_setstack(3),
       pthread_attr_setstacksize(3), pthread_create(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.18    17 mai 2025     pthread_attr_setguardsize(3)