Provided by: manpages-fr-dev_3.17.1-1_all bug

NOM

       alloc_hugepages, free_hugepages - Allouer ou libérer des pages immenses

SYNOPSIS

       void *alloc_hugepages(int key, void *addr, size_t len,
                             int prot, int flag);

       int free_hugepages(void *addr);

DESCRIPTION

       Les  appels  système  alloc_hugepages()  et  free_hugepages()  ont  été
       introduits  dans  Linux 2.5.36 et retirés à nouveau dans le 2.5.54. Ils
       n’existaient  que  sur  i386  et  ia64   (compilation   avec   l’option
       CONFIG_HUGETLB_PAGE).  Dans  Linux  2.4.20  le  numéro  d’appel système
       existe, mais l’appel renvoie toujours ENOSYS.

       Sur un i386, le mécanisme matériel  de  gestion  mémoire  manipule  des
       pages  ordinaires  (4 Ko)  et  des  pages immenses (2 à 4 Mo). De même,
       l’ia64 connaît des pages  immenses  de  diverses  tailles.  Ces  appels
       système  servent à projeter ces pages immenses dans l’espace mémoire du
       processus ou à les libérer. Les pages  immenses  sont  verrouillées  en
       mémoire et jamais swappées.

       Le  paramètre  key  est  un identifiant. Lorsqu’il vaut zéro, les pages
       sont privées et non héritées par les processus  descendants.  Lorsqu’il
       est  positif,  les  pages  sont  partagées avec les autres applications
       utilisant la même key, et héritées par les processus enfants.

       Le paramètre addr de free_hugepages() indique  quelle  page  doit  être
       libérée  —  il  a  été  renvoyé  lors de l’appel alloc_hugepages(). (La
       mémoire n’est véritablement libérée que lorsque tous  ses  utilisateurs
       la  relâchent). Le paramètre addr de alloc_hugepages() est un désir que
       le noyau peut suivre ou non. Les  adresses  doivent  être  correctement
       alignées.

       Le  paramètre  len est la taille du segment désiré. Il doit s’agir d’un
       multiple de la taille d’une page immense.

       Le paramètre prot indique le type de protection du segment.  Il  s’agit
       d’une association de PROT_READ, PROT_WRITE, PROT_EXEC.

       Le  paramètre flag est ignoré, sauf si key est positif. Dans ce cas, si
       flag vaut IPC_CREAT, alors un nouveau segment de page énorme  est  créé
       si aucun n’existe avec cette clé. Sinon, l’erreur ENOENT est renvoyé si
       aucun segment correspondant à la clé n’existe.

VALEUR RENVOYÉE

       S’il réussit alloc_hugepages() renvoie l’adresse du segment alloué,  et
       free_hugepages()  renvoie  zéro.  En  cas d’erreur, ils renvoient -1 et
       remplissent errno avec le code d’erreur.

ERREURS

       ENOSYS L’appel système n’est pas supporté par ce noyau.

FICHIERS

       /proc/sys/vm/nr_hugepages Nombre de  pages  énormes  configurées.  Peut
       être lu ou écrit.

       /proc/meminfo  Indique le nombre de pages énormes configurées, et leurs
       tailles  dans  les  trois  variables  HugePages_Total,  HugePages_Free,
       Hugepagesize.

CONFORMITÉ

       Cet  appel  système est spécifique à Linux sur processeurs Intel, et ne
       doit pas être employé dans des programmes destinés à être portables.

NOTES

       Ces appels système ont disparu ; ils n’existaient qu’entre Linux 2.5.36
       et  2.5.54.  Maintenant,  le  système  de  fichiers hugetblfs peut être
       employé à leur place. La mémoire correspondant aux pages énormes (si le
       processeur  les supporte) peut être obtenue par un mmap(2) des fichiers
       de ce système de fichiers virtuel.

       Le nombre maximal de pages  énormes  peut  être  indiqué  en  utilisant
       l’argument hugepages= au démarrage.

COLOPHON

       Cette  page  fait  partie  de  la  publication 3.17 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

       Cette page de manuel a été traduite  et  mise  à  jour  par  Christophe
       Blaess  <http://www.blaess.fr/christophe/> entre 1996 et 2003, puis par
       Alain Portal <aportal AT univ-montp2 DOT fr> jusqu’en 2006, et  mise  à
       disposition sur http://manpagesfr.free.fr/.

       Les mises à jour et corrections de la version présente dans Debian sont
       directement gérées par Julien Cristau <jcristau@debian.org> et l’équipe
       francophone de traduction de Debian.

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