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