get_mempolicy − Obtenir la politique mémoire d’un processus.

#include <numaif.h>

int get_mempolicy(int *policy, unsigned long *nodemask,
                  unsigned long maxnode, unsigned long addr,
                  unsigned long flags);

get_mempolicy() permet d’obtenir la politique NUMA du processus appelant ou d’une adresse mémoire suivant la configuration 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 dans quel noeud la mémoire pour ce processus sera allouée.

Si flags vaut 0, l’information sur la politique par défaut du processus appelant (comme celle configurée avec set_mempolicy(2)) est renvoyée.

Si flags spécifie MPOL_F_ADDR, l’information renvoyée est celle qui gouverne l’adresse mémoire donnée dans addr. Cette politique peut être différente de la politique par défaut du processus si on a utilisé set_mempolicy(2) pour définir une politique pour la page contenant l’adresse addr.

Si policy n’est pas NULL, il est utilisé pour renvoyer la politique. Si nodemask n’est pas NULL, il est utilisé pour renvoyer le masque de noeud associé à la politique. maxnode est le nombre maximum de bits plus un que l’on peut stocker dans nodemask. Le nombre de bit est toujours arrondi à un multiple de unsigned long.

Pour une vue d’ensemble des politiques possibles, voir set_mempolicy(2).

S’il réusit, get_mempolicy() renvoie 0 ; s’il échoue, il renvoie −1 et écrit errno en conséquence.

Cette page de manuel est incomplète : elle ne documente pas les détails de l’attribut MPOL_F_NODE qui modifie l’action de get_mempolicy(). Cela est délibéré : cet attribut n’est pas conçu pour être utilisé dans une application et son action peut être modifiée ou retirée dans de futures versions du noyau. Ne l’utilisez pas.

Voir mbind(2).

Cet appel est spécifique à Linux.

mbind(2), set_mempolicy(2), numactl(8), numa(3)

Ce document est une traduction réalisée par Alain Portal <aportal AT univ-montp2 DOT fr> le 21 juillet 2006 et révisée le 14 août 2006.

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 get_mempolicy ». N’hésitez pas à signaler à l’auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.