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