pthread_attr_setaffinity_npLibrary Functions Manpthread_attr_setaffinity_np(3)
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
BIBLIOTHÈQUE
Bibliothèque de threads POSIX (libpthread, -lpthread)
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(const pthread_attr_t *attr,
size_t cpusetsize, cpu_set_t *cpuset);
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'at-
tributs 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 succès, ces fonctions renvoient 0 ; en cas d'erreur, elles
renvoient un code 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 depuis la glibc 2.3.4.
ATTRIBUTS
Pour une explication des termes utilisés dans cette section, consulter
attributes(7).
┌─────────────────────────────────────┬──────────────────────┬─────────┐
│Interface │ Attribut │ Valeur │
├─────────────────────────────────────┼──────────────────────┼─────────┤
│pthread_attr_setaffinity_np(), │ Sécurité des threads │ MT-Safe │
│pthread_attr_getaffinity_np() │ │ │
└─────────────────────────────────────┴──────────────────────┴─────────┘
STANDARDS
Ces fonctions sont des extensions GNU non standard ; d'où le 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'en-
semble de CPU fourni à l'appel système sous-jacent était toujours si-
zeof(cpu_set_t).
VOIR AUSSI
sched_setaffinity(2), pthread_attr_init(3), pthread_setaffinity_np(3),
cpuset(7), 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_attr_setaffinity_np(3)
Generated by dwww version 1.15 on Sat Jun 29 01:36:24 CEST 2024.