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.

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 │
       └──────────────────────────────────────────────────────────────────────┴──────────────────────┴─────────┘

VERSIONS

       Ces fonctions sont fournies depuis la glibc 2.1.

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
       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 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
       indique 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
       <tvignaud@mandriva.com>,  François  Micaux,  Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe Guérard
       <fevrier@tigreraye.org>,   Jean-Luc   Coulon   (f5ibh)   <jean-luc.coulon@wanadoo.fr>,   Julien   Cristau
       <jcristau@debian.org>,      Thomas      Huriaux      <thomas.huriaux@gmail.com>,     Nicolas     François
       <nicolas.francois@centraliens.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   <fhantrais@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  à
       debian-l10n-french@lists.debian.org.

Pages du manuel de Linux 6.9.1                     2 mai 2024                       pthread_attr_setstacksize(3)