NOM

       pthread_setconcurrency, pthread_getconcurrency - Définir ou récupérer le niveau de concurrence

BIBLIOTHÈQUE

       Bibliothèque de threads POSIX (libpthread, -lpthread)

SYNOPSIS

       #include <pthread.h>

       int pthread_setconcurrency(int new_level);
       int pthread_getconcurrency(void);

DESCRIPTION

       La fonction pthread_setconcurrency() informe l'implémentation du niveau de concurrence (nombre de threads
       exécutés  en parallèle indiqué par new_level) souhaité par l'application. Ce n'est qu'une indication pour
       l'implémentation : POSIX.1 ne spécifie pas le niveau de  concurrence  qui  doit  résulter  d'un  appel  à
       pthread_setconcurrency().

       Une  valeur de 0 pour new_level indique à l'implémentation qu'elle peut gérer le niveau de concurrence au
       niveau qu'elle juge approprié.

       pthread_getconcurrency() renvoie le niveau de concurrence du processus.

VALEUR RENVOYÉE

       En cas de réussite, pthread_setconcurrency() renvoie 0 ; en cas d'erreur, elle renvoie un numéro d'erreur
       non nul.

       pthread_getconcurrency() ne peut pas échouer et renvoie le  niveau  de  concurrence  défini  par  l'appel
       précédent à pthread_setconcurrency() ou 0 si pthread_setconcurrency() n'a pas été appelé auparavant.

ERREURS

       pthread_setconcurrency() peut échouer avec les erreurs suivantes :

       EINVAL new_level est négatif.

       POSIX.1  documente  également  une  erreur  EAGAIN  (« la  valeur  indiquée par new_level entraînerait un
       dépassement des ressources du système »).

VERSIONS

       Ces fonctions sont disponibles depuis la glibc 2.1.

ATTRIBUTS

       Pour une explication des termes utilisés dans cette section, consulter attributes(7).
       ┌──────────────────────────────────────────────────────────────────────┬──────────────────────┬─────────┐
       │ Interface                                                            │ Attribut             │ Valeur  │
       ├──────────────────────────────────────────────────────────────────────┼──────────────────────┼─────────┤
       │ pthread_setconcurrency(), pthread_getconcurrency()                   │ Sécurité des threads │ MT-Safe │
       └──────────────────────────────────────────────────────────────────────┴──────────────────────┴─────────┘

STANDARDS

       POSIX.1-2001, POSIX.1-2008.

NOTES

       Le niveau de concurrence par défaut est de 0.

       Les niveaux de concurrence n'ont de sens que pour les implémentations des threads M:N, pour lesquelles  à
       un moment donné un sous-ensemble de threads d'un processus peut être associé à un plus petit nombre d'en‐
       tités ordonnançable du noyau. Définir le niveau de concurrence permet à une application de donner une in‐
       dication  au noyau pour qu'il fournisse le bon nombre d'entités ordonnançable pour une exécution efficace
       de l'application.

       A la fois LinuxThreads et NPTL sont des implémentations des  threads  1:1,  donc  définir  le  niveau  de
       concurrence  n'a pas de signification. En d'autres termes, sous Linux ces fonctions existent essentielle‐
       ment pour la compatibilité avec d'autres systèmes et elles n'ont aucun effet sur  l'exécution  d'un  pro‐
       gramme.

VOIR AUSSI

       pthread_attr_setscope(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  <tvi‐
       gnaud@mandriva.com>,  François  Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe Guérard <fe‐
       vrier@tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-luc.coulon@wanadoo.fr>, Julien Cristau  <jcristau@de‐
       bian.org>,   Thomas   Huriaux   <thomas.huriaux@gmail.com>,  Nicolas  François  <nicolas.francois@centra‐
       liens.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   <fhan‐
       trais@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 à  de‐
       bian-l10n-french@lists.debian.org.

Pages du manuel de Linux 6.03                   15 décembre 2022                       pthread_setconcurrency(3)