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⟩.