pthread_attr_setscope(3)

NOM
pthread_attr_setscope, pthread_attr_getscope — Définir ou obtenir l'attribut portée de compétition d'un objet d'attributs de thread

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

SYNOPSIS
#include <pthread.h>

int pthread_attr_setscope(pthread_attr_t *attr, int portée);
int pthread_attr_getscope(const pthread_attr_t *restrict attr,
                          int *restrict portée);

DESCRIPTION
La fonction pthread_attr_setscope() définit l'attribut de portée (« scope ») de compétition de l'objet d'attributs de thread auquel attr fait référence à la valeur indiquée par portée. Cet attribut détermine l'ensemble des threads avec lesquels un thread est en compétition pour les ressources, telles que le CPU. POSIX.1 spécifie deux valeurs possibles pour portée :

PTHREAD_SCOPE_SYSTEM
    Le thread est en compétition pour les ressources avec tous les threads de tous les processus du système qui sont dans le même domaine d'ordonnancement (un groupe composé d'un ou de plusieurs processeurs). Les threads PTHREAD_SCOPE_SYSTEM sont ordonnancés entre eux en fonction de leur priorité et de la politique d'ordonnancement.

PTHREAD_SCOPE_PROCESS
    Le thread est en compétition pour les ressources avec tous les threads du même processus du système qui ont aussi été créés avec PTHREAD_SCOPE_PROCESS. Les threads PTHREAD_SCOPE_PROCESS sont ordonnancés entre eux à l'intérieur du processus en fonction de leur priorité et de la politique d'ordonnancement. POSIX.1 ne spécifie pas comment régler la compétition entre ces threads et les threads d'autres processus du système, ni avec les threads du même processus qui ont été créés avec PTHREAD_SCOPE_SYSTEM.

POSIX.1 impose qu'une implémentation doit accepter au moins l'une de ces portées de compétition. Linux accepte PTHREAD_SCOPE_SYSTEM, mais pas PTHREAD_SCOPE_PROCESS.

Sur les systèmes qui acceptent plusieurs portées de compétition, pour que la politique définie par pthread_attr_setscope() puisse être prise en compte lors de l'appel de pthread_create(3), l'appelant doit définir l'attribut d'ordonnancement hérité de l'objet d'attributs attr au moyen de pthread_attr_setinheritsched(3), en lui assignant la valeur PTHREAD_EXPLICIT_SCHED.

La fonction pthread_attr_getscope() renvoie, dans le tampon pointé par portée, l'attribut de portée de compétition 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_setscope() peut échouer avec les erreurs suivantes :

EINVAL
    Une valeur non valable a été spécifiée dans portée.

ENOTSUP
    La valeur PTHREAD_SCOPE_PROCESS est spécifiée dans portée, or elle n'est pas prise en charge sous Linux.

ATTRIBUTS
Pour une explication des termes utilisés dans cette section, consulter attributes(7).
Interface | Attribut | Valeur
pthread_attr_setscope(), pthread_attr_getscope() | Sécurité des threads | MT-Safe

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

NOTES
La porté de compétition PTHREAD_SCOPE_SYSTEM indique typiquement qu'un thread dans l'espace utilisateur est rattaché directement à une entité unique d'ordonnancement du noyau. C'est le cas sous Linux avec l'implémentation obsolète LinuxThreads, mais aussi avec l'implémentation moderne NPTL, qui sont toutes les deux des implémentations de threads 1:1.

POSIX.1 spécifie que la portée de compétition par défaut est définie par l'implémentation.

VOIR AUSSI
pthread_attr_init(3), pthread_attr_setaffinity_np(3), pthread_attr_setinheritsched(3), pthread_attr_setschedparam(3), pthread_attr_setschedpolicy(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 (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.