Scroll to navigation

pthread_attr_setstacksize(3) Library Functions Manual pthread_attr_setstacksize(3)

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 :

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.

2 mai 2024 Pages du manuel de Linux 6.8