NOM

       pthread_attr_setaffinity_np,  pthread_attr_getaffinity_np  - Définir ou obtenir l'attribut
       d'affinité CPU d'un objet d'attributs de thread

SYNOPSIS

       #define _GNU_SOURCE             /* Consultez feature_test_macros(7) */
       #include <pthread.h>

       int pthread_attr_setaffinity_np(pthread_attr_t *attr,
                          size_t cpusetsize, const cpu_set_t *cpuset);
       int pthread_attr_getaffinity_np(pthread_attr_t *attr,
                          size_t cpusetsize, cpu_set_t *cpuset);

       Compilez et effectuez l'édition des liens avec l'option -pthread.

DESCRIPTION

       La fonction pthread_attr_setaffinity_np() définit l'attribut du masque d'affinité  CPU  de
       l'objet  d'attributs de thread auquel attr fait référence à la valeur indiquée par cpuset.
       Cet attribut détermine le masque d'affinité CPU d'un  thread  créé  en  utilisant  l'objet
       d'attributs de thread attr.

       La  fonction  pthread_attr_getaffinity_np()  renvoie,  dans  le  tampon pointé par cpuset,
       l'attribut du masque d'affinité CPU de l'objet d'attributs  de  thread  auquel  attr  fait
       référence.

       Le  paramètre  cpusetsize  est  la  longueur  (en  octets)  du  tampon  pointé par cpuset.
       Typiquement, ce paramètre sera sizeof (cpu_set_t).

       Pour plus de détails sur les masques d'affinité CPU, consultez sched_setaffinity(2).  Pour
       une  description d'un jeu de macros qui peuvent être utilisées pour manipuler et inspecter
       des ensembles de CPU, consultez CPU_SET(3).

VALEUR RENVOYÉE

       En cas de réussite, ces fonctions renvoient 0 ; en cas d'erreur elles renvoient un  numéro
       d'erreur non nul.

ERREURS

       EINVAL (pthread_attr_setaffinity_np())  Le cpuset indiquait un CPU en dehors de l'ensemble
              pris en charge par le noyau (l'option  de  configuration  CONFIG_NR_CPUS  du  noyau
              définit  l'intervalle  de l'ensemble pris en charge par le type de données du noyau
              pour représenter les ensembles de CPU).

       EINVAL (pthread_attr_getaffinity_np()) Un CPU du masque d'affinité de l'objet  d'attributs
              de  thread  auquel attr fait référence réside en dehors de l'intervalle indiqué par
              cpusetsize (c'est-à-dire, cpuset/cpusetsize est trop petit).

       ENOMEM (pthread_attr_setaffinity_np()) Impossible d'allouer de la mémoire.

VERSIONS

       Ces fonctions sont fournies par la glibc depuis la version 2.3.4.

CONFORMITÉ

       Ces fonctions sont des extensions non standard GNU ; c'est la raison  du  suffixe  « _np »
       (non portable) dans leur nom.

NOTES

       Dans  la glibc 2.3.3, uniquement, les versions de ces fonctions n'avaient pas de paramètre
       cpusetsize. À la  place,  la  taille  de  l'ensemble  de  CPU  fourni  à  l'appel  système
       sous-jacent était toujours sizeof(cpu_set_t).

VOIR AUSSI

       sched_setaffinity(2),    pthread_attr_init(3),    pthread_setaffinity_np(3),    cpuset(7),
       pthreads(7)

COLOPHON

       Cette page fait partie de la publication 3.65 du projet man-pages Linux.  Une  description
       du  projet  et  des  instructions  pour  signaler  des  anomalies  peuvent être trouvées à
       l'adresse http://www.kernel.org/doc/man-pages/.

TRADUCTION

       Depuis   2010,   cette   traduction   est   maintenue   à   l'aide   de    l'outil    po4a
       <http://po4a.alioth.debian.org/>  par l'équipe de traduction francophone au sein du projet
       perkamon <http://perkamon.alioth.debian.org/>.

       Nicolas François et l'équipe francophone de traduction de Debian (2006-2009).

       Veuillez     signaler     toute     erreur     de     traduction     en     écrivant     à
       <debian-l10n-french@lists.debian.org>   ou   par   un  rapport  de  bogue  sur  le  paquet
       manpages-fr.

       Vous pouvez toujours avoir accès à la version anglaise de  ce  document  en  utilisant  la
       commande « man -L C <section> <page_de_man> ».