NOM

       pthread_attr_setstacksize, pthread_attr_getstacksize - Définir ou obtenir la taille de la pile de l'objet
       d'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.

DESCRIPTION

       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.

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 stacksize 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-2001,  qui
       indique que la pile allouée doit être d'au moins stacksize octets.

EXEMPLE

       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)

COLOPHON

       Cette page fait partie de la publication 3.65 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

       Depuis 2010, cette traduction est maintenue à l'aide de l'outil po4a <http://po4a.alioth.debian.org/> par
       l'équipe de traduction francophone au sein du projet perkamon <http://perkamon.alioth.debian.org/>.

       Nicolas François et l'équipe francophone de traduction de Debian (2006-2009).

       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> ».

Linux                                             15 mars 2012                      PTHREAD_ATTR_SETSTACKSIZE(3)