pthread_setconcurrency(3) Library Functions Manual pthread_setconcurrency(3)
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'er-
reur, 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 also documents an EAGAIN error ("the value specified by new_le-
vel would cause a system resource to be exceeded").
VERSIONS
These functions are available since glibc 2.1.
ATTRIBUTS
Pour une explication des termes utilisés dans cette section, consulter
attributes(7).
┌─────────────────────────────────────┬──────────────────────┬─────────┐
│Interface │ Attribut │ Valeur │
├─────────────────────────────────────┼──────────────────────┼─────────┤
│pthread_setconcurrency(), │ Sécurité des threads │ MT-Safe │
│pthread_getconcurrency() │ │ │
└─────────────────────────────────────┴──────────────────────┴─────────┘
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'enti-
tés ordonnançable du noyau. Définir le niveau de concurrence permet à
une application de donner une indication 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 essentiellement pour
la compatibilité avec d'autres systèmes et elles n'ont aucun effet sur
l'exécution d'un programme.
VOIR AUSSI
pthread_attr_setscope(3), pthreads(7)
TRADUCTION
La traduction française de cette page de manuel a été créée par Chris-
tophe Blaess <https://www.blaess.fr/christophe/>, Stéphan Rafin <ste-
phan.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.cou-
lon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas Huriaux
<thomas.huriaux@gmail.com>, Nicolas François <nicolas.francois@centra-
liens.net>, Florentin Duneau <fduneau@gmail.com>, Simon Paillard <si-
mon.paillard@resel.enst-bretagne.fr>, Denis Barbier <barbier@de-
bian.org>, David Prévot <david@tilapin.org> et Frédéric Hantrais <fhan-
trais@gmail.com>
Cette traduction est une documentation libre ; veuillez vous reporter à
la GNU General Public License version 3
⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ 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⟩.
Pages du manuel de Linux 6.03 15 décembre 2022 pthread_setconcurrency(3)
Generated by dwww version 1.15 on Sat Jun 29 01:34:28 CEST 2024.