Provided by: manpages-fr-dev_3.57d1p1-1_all bug

NOM

       madvise - Configurer l'utilisation de la mémoire

SYNOPSIS

       #include <sys/mman.h>

       int madvise(void *addr, size_t length, int advice);

   Exigences    de    macros    de   test   de   fonctionnalités   pour   la   glibc   (consultez
   feature_test_macros(7)) :

       madvise() : _BSD_SOURCE

DESCRIPTION

       L'appel système madvise() conseille le noyau sur la  façon  de  gérer  la  pagination  sur
       l'intervalle  d'adresses  débutant  à  l'adresse  addr et de taille length (en octets). Il
       permet à une application  d'indiquer  au  noyau  l'utilisation  qu'elle  compte  faire  de
       certaines  zones de mémoire partagée ou projetée de façon à ce que le noyau puisse choisir
       les techniques de lecture anticipée et de mise en cache appropriées. Cet appel ne  modifie
       pas la sémantique de l'application (sauf dans le cas de MADV_DONTNEED), mais peut avoir un
       impact sur ses performances. Le noyau est libre d'ignorer le conseil.

       Le conseil est spécifié par le paramètre advice qui peut prendre les valeurs

       MADV_NORMAL
              Pas de traitement particulier. Il s'agit du comportement par défaut.

       MADV_RANDOM
              Prévoit des accès aux pages dans un ordre aléatoire. (Ainsi, la  lecture  anticipée
              sera moins utile qu'elle ne l'est en général.)

       MADV_SEQUENTIAL
              prévoit  des  accès  aux  pages  dans  un  ordre séquentiel. (Aussi, les pages d'un
              intervalle donné peuvent être systématiquement lues par  anticipation,  et  peuvent
              être libérées rapidement après avoir été accédées.)

       MADV_WILLNEED
              Prévoit  un  accès  dans  un  futur  proche.  (Ainsi,  lire quelques pages de façon
              anticipée peut être une bonne idée.)

       MADV_DONTNEED
              Ne prévoit pas d'accès dans un futur proche. (Pour l'instant,  l'application  en  a
              fini  avec  l'intervalle  considéré,  ainsi le noyau peut‐il libérer les ressources
              associées à ce dernier.) Les accès ultérieurs aux pages de l'intervalle réussiront,
              mais  résulteront soit en un rechargement du fichier projeté sous‐jacent (consultez
              mmap(2)), soit en un remplissage avec des zéros pour les pages sans fichier.

       MADV_REMOVE (depuis Linux 2.6.16)
              Libérer  un  ensemble  contigu  de  pages  et   les   ressources   correspondantes.
              Actuellement,  ceci  n'est  possible  que  sur shmfs/tmpfs ; les autres systèmes de
              fichiers renvoient l'erreur ENOSYS.

       MADV_DONTFORK (depuis Linux 2.6.16)
              Ne pas rendre les pages de cet intervalle disponibles au  fils  après  un  fork(2).
              Ceci  est  utile  pour  empêcher  la  sémantique  de  copie à l'écriture de changer
              l'emplacement physique d'une page si le père y écrit après  un  fork(2).  (De  tels
              déplacements  posent  des  problèmes  si  le  matériel accède directement à la page
              (DMA)).

       MADV_DOFORK (depuis Linux 2.6.16)
              Annuler l'effet de MADV_DONTFORK et restaurer le comportement par  défaut,  où  une
              projection en mémoire est héritée après un fork(2).

       MADV_HWPOISON (depuis Linux 2.6.32)
              Empoisonne  une  page  et  la traite comme une corruption de la mémoire matérielle.
              Cette   opération   n'est   disponible   que   pour   les   processus   privilégiés
              (CAP_SYS_ADMIN). À la suite de cette opération, le processus appelant peut recevoir
              un SIGBUS et la page devenir non affectée. Cette  fonctionnalité  est  prévue  pour
              tester  le code de gestion des erreurs de la mémoire ; elle n'est disponible que si
              le noyau a été configuré avec CONFIG_MEMORY_FAILURE.

       MADV_SOFT_OFFLINE (depuis Linux 2.6.33)
              Déconnecte les pages dans l'intervalle spécifié par addr et length. La  mémoire  de
              chaque  page  dans  l'intervalle spécifié est préservée (lors du prochain accès, le
              même contenu sera visible, mais dans  une  nouvelle  page  physique),  et  la  page
              originale  est  déconnectée  (ce  qui signifie qu'elle n'est plus utilisée, et plus
              prise en compte par les mécanismes habituels de gestion de la mémoire). L'effet  de
              l'opération  MADV_SOFT_OFFLINE  est  invisible  au processus appelant (c'est-à-dire
              qu'elle n'en change pas la sémantique). Cette fonctionnalité est prévue pour tester
              le  code  de  gestion  des  erreurs de la mémoire ; elle n'est disponible que si le
              noyau a été configuré avec CONFIG_MEMORY_FAILURE.

       MADV_MERGEABLE (depuis Linux 2.6.32)
              Active la fusion des pages identiques par le noyau  (Kernel  Samepage  Merging,  ou
              KSM) pour les pages dans l'intervalle spécifié par addr et length. Le noyau analyse
              régulièrement les régions de la mémoire utilisateur  qui  ont  été  marquées  comme
              pouvant  être  fusionnées, à la recherche de pages avec un contenu identique. Elles
              sont remplacées par une page unique protégée en écriture (qui sera  automatiquement
              recopiée  si  un  processus  veut plus tard modifier le contenu de la page). KSM ne
              fusionne que les pages anonymes privées (consultez mmap(2)). La fonctionnalité  KSM
              est  prévue  pour  des  applications  qui  génèrent  beaucoup d'instances des mêmes
              données (par exemple des systèmes  de  virtualisation  tels  que  KVM).  Elle  peut
              nécessiter  beaucoup  de  ressources  de  traitement ;  à utiliser avec précaution.
              Consultez le fichier Documentation/vm/ksm.txt dans les sources du noyau Linux  pour
              plus  de  détails.  Les  opérations  MADV_MERGEABLE  et  MADV_UNMERGEABLE  ne  sont
              disponibles que si le noyau a été configuré avec CONFIG_KSM.

       MADV_UNMERGEABLE (depuis Linux 2.6.32)
              Annuler  l'effet  d'une  opération  MADV_MERGEABLE  précédente   sur   l'intervalle
              d'adresse  spécifié ; KSM annule la fusion sur les pages qui avaient été fusionnées
              dans l'intervalle spécifié par addr et length.

       MADV_HUGEPAGE (depuis Linux 2.6.38)
              Active la gestion transparente des pages immenses (Transparent Huge Pages, ou  THP)
              pour  les pages dans l'intervalle spécifié par addr et length. Actuellement, THP ne
              fonctionne qu'avec  les  pages  anonymes  privées  (consultez  mmap(2)).  Le  noyau
              analysera régulièrement les régions qui ont été marquées comme candidates aux pages
              immenses pour les remplacer par des pages immenses. Le  noyau  allouera  aussi  des
              pages  immenses directement quand la région est naturellement alignée sur la taille
              de  page  immense   (consultez   posix_memalign(2)).   Cette   fonctionnalité   est
              initialement  prévue  pour des applications qui utilisent de grosses projections de
              données et accèdent à de grosses zones de cette mémoire en même temps (par  exemple
              les  systèmes  de  virtualisation  comme  QEMU).  Il peut très facilement gaspiller
              beaucoup de mémoire (par exemple une projection de 2 Mo qui n'accède qu'à  un  seul
              octet  a  pour  conséquence  2 Mo de mémoire connectée au lieu d'une page de 4 ko).
              Consultez le fichier Documentation/vm/ktranshuge.txt  dans  les  sources  du  noyau
              Linux pour plus de détails. Les opérations MADV_HUGEPAGE et MADV_NOHUGEPAGE ne sont
              disponibles que si le noyau a été configuré avec CONFIG_TRANSPARENT_HUGEPAGE.

       MADV_NOHUGEPAGE (depuis Linux 2.6.38)
              S'assure que la mémoire dans l'intervalle spécifié par addr et length ne  sera  pas
              perdue dans des pages immenses.

       MADV_DONTDUMP (depuis Linux 3.4)
              Exclue  de  l'image mémoire (« core dump ») les pages dans l'intervalle indiqué par
              addr et length. C'est utile pour les applications dont de larges zones  de  mémoire
              sont  notoirement  inutiles  dans  une  image mémoire. L'effet de MADV_DONTDUMP est
              prioritaire  sur  le  masque  de  bits  configuré  via   /proc/PID/coredump_filter,
              consultez core(5).

       MADV_DODUMP (depuis Linux 3.4)
              Annuler l'effet de MADV_DONTDUMP.

VALEUR RENVOYÉE

       En  cas  de  succès  madvise()  renvoie  zéro. En cas d'erreur, il renvoie -1 et errno est
       positionné de façon adéquate.

ERREURS

       EAGAIN Une ressource du noyau est temporairement indisponible.

       EBADF  La projection existe, mais la zone n'est pas associée à un fichier.

       EINVAL Cette erreur peut survenir pour les raisons suivantes :

              *  La valeur len est négative.

              *  addr n'est pas aligné sur une page.

              *  advice n'a pas une valeur valide.

              *  L'application tente  de  libérer  des  pages  verrouillées  ou  partagées  (avec
                 MADV_DONTNEED).

              *  MADV_MERGEABLE  ou MADV_UNMERGEABLE a été indiqué dans advice, mais le noyau n'a
                 pas été configuré avec l'option CONFIG_KSM.

       EIO    (pour MADV_WILLNEED) Suivre la consigne de pagination sur cette zone dépasserait la
              limite maximale de mémoire physique utilisable par le processus.

       ENOMEM (pour MADV_WILLNEED) Mémoire insuffisante ; échec de pagination.

       ENOMEM Les  adresses  de  l'intervalle  spécifié  ne  sont  pas projetées actuellement, ou
              n'appartiennent pas à l'espace d'adressage du processus.

CONFORMITÉ

       POSIX.1b.   POSIX.1-2001   spécifie   l'appel   posix_madvise(3)   avec   des   constantes
       POSIX_MADV_NORMAL,  POSIX_MADV_RANDOM, etc. et un comportement proche de celui décrit ici.
       Il existe un appel similaire posix_fadvise(2) pour les accès aux fichiers.

       MADV_REMOVE, MADV_DONTFORK, MADV_DOFORK, MADV_HWPOISON, MADV_MERGEABLE et MADV_UNMERGEABLE
       sont spécifiques à Linux.

NOTES

   Notes sur Linux
       L'implémentation  Linux  actuelle  (2.4.0)  perçoit  davantage cet appel système comme une
       commande que comme un conseil et est ainsi susceptible de renvoyer une erreur  quand  elle
       ne  parvient  pas  à  réaliser  ce  qu'elle  devrait  accomplir  en  réponse à ce conseil.
       (Consultez la  description  des  ERREURS  ci‐dessus.)  Il  s'agit  d'un  comportement  non
       standard.

       L'implémentation  Linux  nécessite que l'adresse addr soit alignée sur une page, et permet
       que length vaille zéro. S'il y a des parties de l'intervalle d'adresses  spécifié  qui  ne
       sont  pas projetées, la version Linux de madvise() les ignore et applique l'appel au reste
       de l'intervalle (mais renvoie ENOMEM comme il se doit).

VOIR AUSSI

       getrlimit(2), mincore(2), mmap(2), mprotect(2), msync(2), munmap(2), core(5)

COLOPHON

       Cette page fait partie de la publication 3.57 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/>.

       Stéphan Rafin (2002), Alain Portal <http://manpagesfr.free.fr/> (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> ».