alloc_hugepages

ALLOC_HUGEPAGES(2)         Manuel du programmeur Linux        ALLOC_HUGEPAGES(2)



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 connaît des pages
       ordinaires (4 Kio) et des pages immenses (2 à 4 Mio). 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 immense 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 immenses configurées. Peut être lu ou écrit.

       /proc/meminfo
              Indique le nombre de pages immenses 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 immenses (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 immenses peut être indiqué en utilisant
       l'argument hugepages= au démarrage.

COLOPHON
       Cette page fait partie de la publication 5.08 du projet man-pages Linux.
       Une description du projet et des instructions pour signaler des anomalies
       et la dernière version de cette page, peuvent être trouvées à l'adresse
       https://www.kernel.org/doc/man-pages/.


TRADUCTION
       La traduction française de cette page de manuel a été créée par
       Christophe Blaess <https://www.blaess.fr/christophe/>, Stéphan Rafin
       <stephan.rafin@laposte.net>, Thierry Vignaud <tvignaud@mandriva.com>,
       François Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe
       Guérard <fevrier@tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-
       luc.coulon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas
       Huriaux <thomas.huriaux@gmail.com>, Nicolas François
       <nicolas.francois@centraliens.net>, Florentin Duneau <fduneau@gmail.com>,
       Simon Paillard <simon.paillard@resel.enst-bretagne.fr>, Denis Barbier
       <barbier@debian.org>, David Prévot <david@tilapin.org> et Jean-Philippe
       MENGUAL <jpmengual@debian.org>

       Cette traduction est une documentation libre ; veuillez vous reporter à
       la GNU General Public License version 3 concernant les conditions de
       copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.

       Si vous découvrez un bogue dans la traduction de cette page de manuel,
       veuillez envoyer un message à <debian-l10n-french@lists.debian.org>.



Linux                           15 septembre 2017             ALLOC_HUGEPAGES(2)