Linux Certif

Toute la documentation sur la certification Linux LPI

get_mempolicy

NOM

get_mempolicy - Obtenir la politique mémoire d'un processus

SYNOPSIS

#include <numaif.h>

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

DESCRIPTION

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).

VALEUR RENVOYÉE

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

CONFORMITÉ

Cet appel est spécifique à Linux.

NOTES

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.

Versions et prise en charge bibliothèque

Voir mbind(2).

VOIR AUSSI

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

TRADUCTION

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 22 novembre 2007.

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.