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

NOM

       mremap - Modifier une projection de la mémoire virtuelle

SYNOPSIS

       #define _GNU_SOURCE
       #include <sys/mman.h>

       void *mremap(void *old_address, size_t old_size,
                    size_t new_size, int flags);

DESCRIPTION

       mremap()  agrandit  (ou  diminue)  une  projection  (Ndt :  mapping) de
       mémoire virtuelle en mémoire réelle,  en  la  déplaçant  éventuellement
       (sous  contrôle  de  l’argument  flags  et  de la place disponible dans
       l’espace d’adressage virtuel).

       old_address est l’ancienne adresse  du  bloc  de  mémoire  virtuelle  à
       agrandir  (ou  à  diminuer).  Veuillez  noter que old_address doit être
       alignée sur une frontière de page. old_size est la taille  du  bloc  de
       mémoire  virtuelle. new_size est la taille désirée pour le nouveau bloc
       de mémoire.

       Sous Linux, la mémoire est divisée en pages. Un  processus  utilisateur
       dispose  d’un  ou  plusieurs segments linéaires de mémoire virtuelle. À
       chaque segment correspond une ou plusieurs projections dans  les  pages
       de  mémoire réelle (dans la table des pages). Chaque segment de mémoire
       virtuelle dispose de ses propres droits d’accès (sa protection), ce qui
       peut  déclencher  des fautes de segmentation si la mémoire est utilisée
       incorrectement (par exemple, en écrivant dans  un  segment  en  lecture
       seule).  De  même  une  tentative  d’accès  à  la mémoire en‐dehors des
       segments déclenche également une faute de segmentation.

       mremap() utilise le schéma de la table des  pages  de  Linux.  mremap()
       modifie la correspondance entre les adresses virtuelles et les pages de
       mémoire réelle. Ce mécanisme peut  être  utilisé  pour  implémenter  un
       realloc(3) très efficace.

       L’argument  flags est soit 0, soit un OU binaire « | » avec les options
       suivantes :

       MREMAP_MAYMOVE
              Par défaut, s’il n’y a pas suffisamment d’espace  pour  agrandir
              une  projection à son emplacement actuel, mremap() échoue. Si ce
              drapeau est  utilisé,  le  noyau  est  autorisé  à  déplacer  la
              projection  à  une  autre adresse virtuelle si nécessaire. Si la
              projection est déplacée, les pointeurs absolus  vers  l’ancienne
              projection   deviennent   invalides   (il   faut   utiliser  des
              différences par rapport à l’adresse de début de la  projection).

       MREMAP_FIXED (depuis Linux 2.3.31)
              Ce drapeau a un but similaire à MAP_FIXED pour mmap(2). S’il est
              utilisé, mremap() prend un cinquième argument void  *new_address
              qui  contient  une  adresse  alignée  sur un début de page, vers
              laquelle la projection  doit  être  déplacée.  Toute  projection
              existant   précédemment   dans  la  zone  entre  new_address  et
              new_address+new_size est supprimée. Si MREMAP_FIXED est utilisé,
              MREMAP_MAYMOVE doit l’être aussi.

       Si  le  segment  de  mémoire  indiqué  par  old_address et old_size est
       verrouillé (par mlock(2) ou similaire), ce verrou est maintenu quand le
       segment  est  modifié  et/ou  déplacé.  Par  conséquent, la quantité de
       mémoire verrouillée par le processus peut changer.

VALEUR RENVOYÉE

       mremap() renvoie un pointeur sur la nouvelle zone de mémoire  virtuelle
       s’il  réussit.  En  cas  d’échec,  la  valeur  MAP_FAILED (c’est-à-dire
       (void*) -1) est renvoyée et errno contient le code d’erreur.

ERREURS

       EAGAIN L’appelant a tenté d’agrandir un segment de mémoire  verrouillé,
              mais c’est impossible sans dépasser la limite RLIMIT_MEMLOCK.

       EFAULT Erreur  de  segmentation  (« Segmentation  fault »). Une adresse
              dans  l’intervalle  entre  old_address  et  old_address+old_size
              n’est  pas  une  adresse  virtuelle valide pour ce processus. On
              peut également obtenir EFAULT même s’il existe  des  projections
              recouvrant  la  zone complète demandée, mais que ces projections
              sont de types différents.

       EINVAL Un paramètre invalide a été utilisé. Les causes  possibles  sont
              un  mauvais  alignement de old_address, une valeur différente de
              MREMAP_MAYMOVE  ou  MREMAP_FIXED  dans  flags,  new_size  à   0,
              new_size  ou  new_address  est  invalide,  ou  la  nouvelle zone
              spécifiée  par  new_address  et  new_size  recouvre  en   partie
              l’ancienne  zone  définie  par old_address et old_size, ou enfin
              utilisation de MREMAP_FIXED sans MREMAP_MAYMOVE.

       ENOMEM La zone de mémoire ne peut pas  être  agrandie  à  l’emplacement
              actuel,  et  l’option  MREMAP_MAYMOVE  n’a  pas été fournie dans
              flags. Ou encore, il n’y  a  plus  assez  de  mémoire  virtuelle
              disponible.

CONFORMITÉ

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

NOTES

       Avant la version 2.4, la glibc ne  fournissait  pas  la  définition  de
       MREMAP_FIXED et le prototype de mremap() ne permettait pas de passer le
       paramètre new_address.

VOIR AUSSI

       brk(2),  getpagesize(2),  getrlimit(2),  mlock(2),  mmap(2),   sbrk(2),
       malloc(3), realloc(3), feature_test_macros(7)

       Votre  manuel de systèmes d’exploitations favori, pour des informations
       supplémentaires sur la mémoire paginée. (Modern  Operating  Systems  de
       Andrew  S.  Tannenbaum, Inside Linux par Randolf Bentson, The Design of
       the UNIX Operating System par Maurice J. Bach.)

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