NOM

       pthread_attr_setstacksize, pthread_attr_getstacksize - Définir ou obtenir la taille de la pile de l'objet
       d'attributs de thread

BIBLIOTHÈQUE

       Bibliothèque de threads POSIX (libpthread, -lpthread)

SYNOPSIS

       #include <pthread.h>

       int pthread_attr_setstacksize(pthread_attr_t *attr, size_t taille_pile);
       int pthread_attr_getstacksize(const pthread_attr_t *restrict attr,
                                     size_t *restrict taille_pile);

DESCRIPTION

       La  fonction  pthread_attr_setstacksize()  définit,  à  la  valeur  indiquée  par taille_pile, 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 taille_pile, l'attribut
       contenant la taille de la pile de l'objet d'attributs de thread attr.

VALEUR RENVOYÉE

       En cas de succès, ces fonctions renvoient 0 ; en cas d'erreur, elles renvoient un code 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 taille_pile n'est
       pas un multiple de la taille des pages système.

VERSIONS

       Ces fonctions sont fournies depuis la glibc 2.1.

ATTRIBUTS

       Pour une explication des termes utilisés dans cette section, consulter attributes(7).
       ┌──────────────────────────────────────────────────────────────────────┬──────────────────────┬─────────┐
       │ Interface                                                            │ Attribut             │ Valeur  │
       ├──────────────────────────────────────────────────────────────────────┼──────────────────────┼─────────┤
       │ pthread_attr_setstacksize(), pthread_attr_getstacksize()             │ Sécurité des threads │ MT-Safe │
       └──────────────────────────────────────────────────────────────────────┴──────────────────────┴─────────┘

STANDARDS

       POSIX.1-2001, POSIX.1-2008.

NOTES

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

       La taille de la pile d'un thread est définie au moment de la création d'un thread. Seul le thread princi‐
       pal peut dynamiquement agrandir sa pile.

       La fonction pthread_attr_setstack(3) permet à une application de définir à la fois la taille et  l'empla‐
       cement 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 taille_pile n'est pas un multiple de STACK_ALIGN (16 octets
       sur la plupart des architectures), la taille peut être réduite, ce qui est contraire à POSIX.1,  qui  in‐
       dique que la pile allouée doit être d'au moins taille_pile octets.

EXEMPLES

       Consultez pthread_create(3).

VOIR AUSSI

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

TRADUCTION

       La  traduction  française   de   cette   page   de   manuel   a   été   créée   par   Christophe   Blaess
       <https://www.blaess.fr/christophe/>,  Stéphan  Rafin  <stephan.rafin@laposte.net>,  Thierry Vignaud <tvi‐
       gnaud@mandriva.com>, François Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe  Guérard  <fe‐
       vrier@tigreraye.org>,  Jean-Luc Coulon (f5ibh) <jean-luc.coulon@wanadoo.fr>, Julien Cristau <jcristau@de‐
       bian.org>,  Thomas  Huriaux  <thomas.huriaux@gmail.com>,   Nicolas   François   <nicolas.francois@centra‐
       liens.net>, Florentin Duneau <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-bretagne.fr>,
       Denis   Barbier   <barbier@debian.org>,   David  Prévot  <david@tilapin.org>,  Frédéric  Hantrais  <fhan‐
       trais@gmail.com> et Jean-Pierre Giraud <jean-pierregiraud@neuf.fr>

       Cette traduction est une documentation libre ; veuillez vous  reporter  à  la  GNU General Public License
       version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.

       Si  vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à de‐
       bian-l10n-french@lists.debian.org.

Pages du manuel de Linux 6.03                   15 décembre 2022                    pthread_attr_setstacksize(3)