Rechercher une page de manuel
sched_setaffinity
Langue: fr
Version: 18 juillet 2003 (openSuse - 09/10/07)
Section: 2 (Appels système)
SYNOPSIS
#include <sched.h>int sched_setaffinity(pid_t pid, unsigned int lg, unsigned long *masque);
int sched_getaffinity(pid_t pid, unsigned int lg, unsigned long *masque);
DESCRIPTION
sched_setaffinity fixe le masque des préférences du processus pid vis-à-vis du CPU. Si pid vaut zéro, il s'agit du processus appelant.Les préférences sont représentées par les bits stockées dans le masque. Le bit de moindre poid représente le numéro logique du premier processeur, tandis que le bit de poid le plus fort représent le numéro de dernier processeur. Un bit activé correspond à un processeur utilisable pour l'ordonnancement alors qu'un bit inhibé représent un processeur refuse. En d'autres terme, le processus est attaché et ne s'exécutera que sur les processeurs dont les bits sont activés. D'habitude tous les bits du masque sont validés.
L'argument lg représente la longueur des données pointées par le masque. Normalement, il s'agit de la taille d'un mot du système. Pour assurer la compatibilités avec les futurs noyaux Linux, comme cette taille peut varier, le masque fourni doit être au moins aussi grand que le masque d'affinité stocké dans le noyau.
La fonction sched_getaffinity écrit dans la zone pointée par masque (dont la taille est lg) le masque de préférences du processus pid. Si pid vaut zéro, le masque du processus en cours est renvoyé.
VALEUR RENVOYÉE
S'ils réussissent sched_setaffinity et sched_getaffinity renvoient tous deux zéro. S'ils échouent, ils renvoient -1 et errno sera rempli avec le code d'erreur.ERREURS
- EFAULT
- Une adresse mémoire est invalide.
- ESRCH
- Impossible de trouver le processus du pid indiqué.
- 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.
- EINVAL
- Le masque des préférences ne contient pas de processeurs présents sur le système, ou lg est plus petit que la taille du masque d'affinité utilisé par le noyau.
HISTORIQUE
Les appels-système d'affinité ont été introduit dans Linux 2.5.8.VOIR AUSSI
sched_setscheduler(2), sched_getscheduler(2), sched_get_priority_max(2), sched_get_priority_min(2), nice(2), setpriority(2), getpriority(2),sched_setscheduler(2) décrit le fonctionnement de l'ordonnancement sous Linux.
TRADUCTION
Christophe Blaess, 1996-2003.Contenus ©2006-2024 Benjamin Poulain
Design ©2006-2024 Maxime Vantorre