Loading

NOM

       pthread_attr_setstacksize,   pthread_attr_getstacksize   -  Définir  ou
       obtenir l’attribut de taille de  la  pile  de  l’objet  regroupant  les
       attributs de thread

SYNOPSIS

       #include <pthread.h>

       int pthread_attr_setstacksize(pthread_attr_t *attr, size_t stacksize);
       int pthread_attr_getstacksize(pthread_attr_t *attr, size_t *stacksize);

       Compilez et effectuez l’édition des liens avec l’option -pthread.

       La  fonction  pthread_attr_setstacksize() définit, à la valeur indiquée
       par stacksize, l’attribut contenant la taille de la pile  dans  l’objet
       d’attributs de thread auquel attr fait référence.

       L’attribut  contenant la taille de la pile détermine la taille minimale
       (en octets) de la pile qui sera  allouée  pour  les  threads  créés  en
       utilisant l’objet d’attributs de thread attr.

       La  fonction pthread_attr_getstacksize() renvoie, dans le tampon pointé
       par stacksize, l’attribut contenant la taille de  la  pile  de  l’objet
       d’attributs de thread attr.

VALEUR RENVOYÉE

       En  cas  de réussite, ces fonctions renvoient 0 ; en cas d’erreur elles
       renvoient un numéro d’erreur non nul.

ERREURS

       pthread_attr_setstacksize() peut échouer avec les erreurs suivantes :

       EINVAL La taille de la pile est inférieure à PTHREAD_STACK_MIN  (16384)
              octets.

       Sur  certains  systèmes,  pthread_attr_setstacksize() peut échouer avec
       l’erreur EINVAL si stacksize n’est pas un multiple  de  la  taille  des
       pages système.

VERSIONS

       Ces fonctions sont fournies par la glibc depuis la version 2.1.

CONFORMITÉ

       POSIX.1-2001.

EXEMPLE

       Voir pthread_create(3).

NOTES

       Pour  des  détails  sur  la  taille  par défaut de la pile des nouveaux
       threads, voir pthread_create(3).

       La taille de la pile d’un thread est fixée au  moment  de  la  création
       d’un  thread.  Seul  le thread principal peut dynamiquement agrandir sa
       pile.

       La  fonction  pthread_attr_setstack(3)  permet  à  une  application  de
       définir  à  la  fois  la taille et l’emplacement d’une pile allouée par
       l’appelant qui doit être utilisée par un thread.

BOGUES

       Au moment de la glibc 2.8, si  le  paramètre  stacksize  n’est  pas  un
       multiple  de  STACK_ALIGN (16 octets sur la plupart des architectures),
       la taille peut être rduite, ce qui est contraire à  POSIX.1-2001,  qui
       indique que la pile allouée doit être d’au moins stacksize octets.

VOIR AUSSI

       getrlimit(2),    pthread_attr_init(3),    pthread_attr_setguardsize(3),
       pthread_attr_setstack(3), pthread_create(3), pthreads(7)

COLOPHON

       Cette page fait partie de  la  publication  3.23  du  projet  man-pages
       Linux.  Une description du projet et des instructions pour signaler des
       anomalies      peuvent      être       trouvées       à       l’adresse
       http://www.kernel.org/doc/man-pages/.

TRADUCTION

       Cette  page  de  manuel  a  été  traduite  et est maintenue par Nicolas
       François <nicolas.francois@centraliens.net> et l’équipe francophone  de
       traduction de Debian.

       Veuillez   signaler   toute   erreur   de   traduction  en  écrivant  à
       <debian-l10n-french@lists.debian.org> ou par un rapport de bogue sur le
       paquet manpages-fr.

       Vous  pouvez  toujours avoir accès à la version anglaise de ce document
       en utilisant la commande « man -L C <section> <page_de_man> ».