#define _GNU_SOURCE
#include <sched.h>

int sched_setaffinity(pid_t pid, unsigned int cpusetsize,
                      cpu_set_t *mask);

int sched_getaffinity(pid_t pid, unsigned int cpusetsize,
                      cpu_set_t *mask);

void CPU_CLR(int cpu, cpu_set_t *set);


int CPU_ISSET(int cpu, cpu_set_t *set);


void CPU_SET(int cpu, cpu_set_t *set);


void CPU_ZERO(cpu_set_t *set);

Un masque d'affinité CPU est représenté par la structure cpu_set_t, un « ensemble de CPU », pointée par mask. Quatre macros sont fournies pour manipuler les ensembles de CPU. CPU_ZERO() efface un ensemble. CPU_SET() et CPU_CLR() ajoute et retire, respectivement, la CPU indiquée d'un ensemble. CPU_ISSET() teste si la CPU fait partie d'un ensemble ; cela est utile après le retour de sched_getaffinity(). La première CPU disponible sur le système correspond à une valeur cpu de 0, la CPU suivante correspond à une valeur cpu de 1, et ainsi de suite. La constante CPU_SETSIZE (1024) spécifie une valeur plus grande de un que le nombre maximum de CPU qui peuvent appartenir à un ensemble de CPU.

sched_setaffinity() fixe le masque d'affinité du processus dont l'ID est pid à la valeur spécifiée dans mask. Si pid vaut zéro, il s'agit du processus appelant. L'argument cpusetsize est la longueur (en octet) de la donnée pointée par mask. Normalement, cet argument devrait être spécifié comme sizeof(cpu_set_t).

Si le processus spécifié par pid n'est actuellement pas en cours d'exécution sur l'une des CPU spécifiées dans mask, le processus est déplacé sur l'une des CPU spécifiées dans mask.

sched_getaffinity() écrit le masque d'affinité du processus dont l'ID est pid dans la structure cpu_set_t pointée par mask. L'argument cpusetsize spécifie la taille (en octet) de mask. Si pid vaut zéro, le masque du processus appelant est renvoyé.  

EFAULT

Une adresse mémoire est invalide.

EINVAL

Le masque mask des préférences ne contient pas de processeurs présents sur le système, ou cpusetsize est plus petit que la taille du masque d'affinité utilisé par le noyau.

EPERM

Le processus appelant n'a pas les privilèges appropriés. Le processus qui invoque sched_setaffinity() doit avoir un UID effectif égal à l'UID effectif ou réel du processus identifié par pid, ou avoir la capacité CAP_SYS_NICE.

ESRCH

Impossible de trouver le processus du pid indiqué.

Le masque d'affinité est actuellement un attribut par thread qui peut être ajusté de manière indépendante pour chacun des threads d'un groupe de threads. La valeur renvoyée par un appel à gettid(2) peut être passée à l'argument pid. Définir pid à 0 positionnera l'attribut pour le thread actuel et passer la valeur renvoyée par un appel à getpid(2) positionnera l'attribut pour le thread principal du groupe de threads.

Un fils créé avec fork(2) hérite du masque d'affinité CPU de son père. Le masque d'affinité est préservé à travers un execve(2).

Cette page de manuel décrit l'interface glibc pour les appels d'affinité CPU. L'interface actuelle d'appels système est légèrement différente avec le mask ayant pour type unsigned long *, reflétant le fait que l'implémentation sous-jacente des ensembles de CPU est un simple masque de bits. S'il réussit, l'appel système brut sched_getaffinity() renvoie la taille (en octets) du type de donnée cpumask_t qui est utilisé en interne par le noyau pour représenter le masque de bits de l'ensemble CPU.  

Ce document est une traduction réalisée par Christophe Blaess <http://www.blaess.fr/christophe/> le 18 juillet 2003 et révisée le 8 janvier 2008.

L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 2 sched_setaffinity ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.

NOM

SYNOPSIS

DESCRIPTION

VALEUR RENVOYÉE

ERREURS

VERSIONS

CONFORMITÉ

NOTES

VOIR AUSSI

TRADUCTION