Provided by: manpages-fr-dev_3.65d1p1-1_all 
NOM
get_mempolicy - Lire la politique mémoire NUMA d'un processus
SYNOPSIS
#include <numaif.h>
int get_mempolicy(int *mode, unsigned long *nodemask,
unsigned long maxnode, unsigned long addr,
unsigned long flags);
Effectuez l'édition des liens avec l'option -lnuma.
DESCRIPTION
get_mempolicy() lit la politique NUMA du processus appelant ou d'une adresse en mémoire,
selon la valeur de flags.
Une machine NUMA a différents contrôleurs mémoire à différentes distances de CPU
particulières. La politique de la mémoire définit à partir de quel nœud la mémoire pour ce
processus sera allouée.
Si flags est nul, la politique par défaut du processus appelant (définie par
set_mempolicy(2)) est renvoyée. La politique renvoyée (mode et nodemask) peut être
utilisée avec set_mempolicy(2) pour restaurer la politique du processus dans son état au
moment de l'appel à get_mempolicy().
Si flags indique MPOL_F_MEMS_ALLOWED (disponible depuis Linux 2.6.24), le paramètre mode
est ignoré et l'ensemble des nœuds (mémoires) que le processus est autorisé à utiliser
dans les appels suivants à mbind(2) ou set_mempolicy(2) (en l'absence de drapeaux de mode)
est renvoyé dans nodemask. Il n'est pas permit de combiner MPOL_F_MEMS_ALLOWED avec
MPOL_F_ADDR ou MPOL_F_NODE.
Si flags indique MPOL_F_ADDR, l'information renvoyée concerne la politique gouvernant la
mémoire à l'adresse addr. Cette politique peut être différente de la politique par défaut
du processus si mbind(2) ou une des fonctions d'aide décrites dans numa(3) a été utilisée
pour mettre en place une politique pour la page contenant l'adresse addr.
Si le paramètre mode n'est pas NULL, get_mempolicy() stockera le mode de politique et tout
drapeau de mode optionnel de la politique NUMA requise à l'endroit pointé par ce
paramètre. Si nodemask n'est pas NULL, le masque de nœud associé à la politique sera
stockée à l'emplacement pointé par cet argument. maxnode spécifie le nombre d'identifiants
de nœuds qui peuvent être stockés dans nodemask, c'est-à-dire, la valeur maximale de
l'identifiant de nœud plus un. La valeur indiquée dans maxnode est toujours arrondie à un
multiple de sizeof(unsigned long).
Si flags indique à la fois MPOL_F_NODE et MPOL_F_ADDR, get_mempolicy() renverra, à
l'endroit pointé par mode, l'identifiant de nœud du nœud sur lequel l'adresse addr est
allouée. Si aucune page n'a encore été allouée pour l'adresse spécifiée, get_mempolicy()
allouera une page comme si le processus avait réalisé un accès en lecture [chargement] à
cette adresse, et renverra l'identifiant du nœud où cette page a été allouée.
Si flags indique MPOL_F_NODE mais pas MPOL_F_ADDR et que la politique actuelle est
MPOL_INTERLEAVE, get_mempolicy() renverra à l'endroit pointé par un paramètre mode non nul
l'identifiant du prochain nœud à utiliser pour l'entrelacement des pages internes du noyau
allouées au nom du processus. Ces allocations incluent des pages pour les fichiers de
mémoire projetée dans les plages de mémoire projetée du processus en utilisant l'appel
mmap(2) avec l'attribut MAP_PRIVATE pour les accès en lecture, et dans les plages de
mémoire projetée avec l'attribut MAP_SHARED pour tous les autres accès.
D'autres valeurs d'attribut sont réservées.
Pour un survol des politiques possibles, consultez set_mempolicy(2).
VALEUR RENVOYÉE
get_mempolicy() renvoie 0 s'il réussit, ou -1 s'il échoue, auquel cas errno contient le
code d'erreur.
ERREURS
EFAULT Une partie de la plage mémoire spécifiée par nodemask et maxnode pointe en dehors
de votre espace d'adressage accessible.
EINVAL La valeur spécifiée par maxnode est inférieure au nombre d'identifiants de nœud
pris en charge par le système. Ou flags spécifie des valeurs autres que MPOL_F_NODE
ou MPOL_F_ADDR ; ou flags spécifie MPOL_F_ADDR et addr est NULL, ou flags ne
spécifie pas MPOL_F_ADDR et addr n'est pas NULL. Ou flags spécifie MPOL_F_NODE mais
pas MPOL_F_ADDR et la politique actuelle du processus n'est pas MPOL_INTERLEAVE. Ou
flags spécifie MPOL_F_MEMS_ALLOWED avec MPOL_F_ADDR ou MPOL_F_NODE. (Et il y a
d'autres cas pour EINVAL)
VERSIONS
L'appel système get_mempolicy() a été ajouté au noyau Linux dans la version 2.6.7.
CONFORMITÉ
Cet appel système est spécifique à Linux.
NOTES
Pour des informations sur la prise en charge par des bibliothèques, consultez numa(7).
VOIR AUSSI
getcpu(2), mbind(2), mmap(2), set_mempolicy(2), numa(3), numa(7), numactl(8)
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/>.
Christophe Blaess <http://www.blaess.fr/christophe/> (1996-2003), Alain Portal
<http://manpagesfr.free.fr/> (2003-2006). Julien Cristau 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> ».