mremap(2) System Calls Manual mremap(2)
NOM
mremap - Modifier une projection de la mémoire virtuelle
BIBLIOTHÈQUE
Bibliothèque C standard (libc, -lc)
SYNOPSIS
#define _GNU_SOURCE /* Consultez feature_test_macros(7) */
#include <sys/mman.h>
void *mremap(void old_address[.old_size], size_t old_size,
size_t new_size, int flags, ... /* void *new_address */);
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 ali-
gnée sur une frontière de page. old_size est l'ancienne taille du bloc
de mémoire virtuelle. new_size est la taille désirée pour le nouveau
bloc de mémoire. Un cinquième argument, new_address, peut éventuelle-
ment être fourni ; voyez la description de MREMAP_FIXED ci-dessous.
Si la valeur de old_size est de zéro et si old_address renvoie à une
projection partageable (voir MAP_SHARED de mmap(2)), mremap() créera
une nouvelle projection des mêmes pages. new_size sera la taille de la
nouvelle projection et l'emplacement de la nouvelle projection peut
être indiqué avec new_address ; voir la description de MREMAP_FIXED
ci-dessous. Si une nouvelle projection est demandée à l'aide de cette
méthode, l'attribut MREMAP_MAYMOVE doit être indiqué également.
L'argument de masquage flags est soit 0, soit un des attributs sui-
vants :
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 projec-
tion à une autre adresse virtuelle si nécessaire. Si la projec-
tion est déplacée, les pointeurs absolus vers l'ancienne projec-
tion deviennent caduques (il faut utiliser des décalages 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 la-
quelle la projection doit être déplacée. Toute projection exis-
tant précédemment dans la zone entre new_address et new_size est
supprimée.
Si MREMAP_FIXED est indiqué, MREMAP_MAYMOVE doit également être
indiqué.
MREMAP_DONTUNMAP (depuis Linux 5.7)
Cet attribut, qui doit être utilisé avec MREMAP_MAYMOVE, refait
une projection vers une nouvelle adresse mais il ne supprime pas
celle à old_address.
L'attribut MREMAP_DONTUNMAP ne peut être utilisé qu'avec des
projections privées anonymes (voir la description de MAP_PRIVATE
et de MAP_ANONYMOUS dans mmap(2)).
À la fin, tous les accès à la plage indiquée par old_address et
old_size donneront une erreur de pagination. Elle sera gérée par
un gestionnaire userfaultfd(2) si l'adresse se situe dans une
plage précédemment enregistrée avec userfaultfd(2). Sinon, le
noyau alloue une page remplie de zéros pour gérer cette erreur.
L'attribut MREMAP_DONTUNMAP peut être utilisé pour déplacer de
manière atomique une projection tout en laissant la source asso-
ciée. Voir les NOTES pour des applications possibles de MRE-
MAP_DONTUNMAP.
Si le segment de mémoire indiqué par old_address et old_size est ver-
rouillé (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 est défini pour indiquer l'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 Une adresse dans l'intervalle entre old_address et old_ad-
dress+old_size n'est pas une adresse virtuelle valable 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 non valable a été donné. Parmi les causes pos-
sibles :
• old_address n'était pas aligné sur une page ;
• une autre valeur que MREMAP_MAYMOVE, MREMAP_FIXED ou MRE-
MAP_DONTUNMAP a été indiquée dans flags ;
• new_size était zéro ;
• new_size ou new_address n'était pas valable ;
• la nouvelle plage d'adresses indiquée par new_address et
new_size chevauche l'ancienne plage d'adresses indiquée par
old_address et old_size ;
• MREMAP_FIXED ou MREMAP_DONTUNMAP était indiqué sans MRE-
MAP_MAYMOVE ;
• MREMAP_DONTUNMAP était indiqué mais une ou plusieurs pages de
la plage indiquée par old_address et old_size n'étaient pas
privées et anonymes ;
• MREMAP_DONTUNMAP était indiqué et old_size n'était pas égal à
new_size ;
• old_size était de zéro et old_address ne renvoie pas à une
projection partageable (mais voir BOGUES) ;
• old_size valait zéro et l'attribut MREMAP_MAYMOVE n'était pas
indiqué.
ENOMEM Pas assez de mémoire disponible pour terminer l'opération. Les
causes possibles sont :
• La zone de mémoire ne peut pas être agrandie à l'emplacement
virtuel actuel, et l'option MREMAP_MAYMOVE n'a pas été four-
nie dans flags. Ou encore, il n'y a plus assez de mémoire
(virtuelle) disponible.
• MREMAP_DONTUNMAP a été utilisé, provoquant la création d'une
nouvelle projection qui dépasserait la mémoire (virtuelle)
disponible. Ou alors elle excéderait le nombre maximal de
projections autorisées.
STANDARDS
Cet appel système est spécifique à Linux et ne devrait pas être employé
dans des programmes destinés à être portables.
NOTES
mremap() modifie la correspondance entre les adresses virtuelles et les
pages de mémoire. Ce mécanisme peut être utilisé pour implémenter un
realloc(3) très efficace.
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 (SIGSEGV) si l'accès à la
mémoire est mal géré (par exemple, en écrivant dans un segment en lec-
ture seule). De même, une tentative d'accès à la mémoire en dehors des
segments déclenche une faute de segmentation.
Si mremap() est utilisé pour déplacer ou étendre une zone verrouillée
avec mlock(2) ou équivalent, l'appel mremap() fera le maximum pour rem-
plir la nouvelle zone mais il n'échouera pas avec ENOMEM si la zone ne
peut pas être remplie.
Avant la glibc 2.4, glibc ne fournissait pas la définition de MRE-
MAP_FIXED et le prototype de mremap() ne permettait pas de passer le
paramètre new_address.
Cas d'utilisation de MREMAP_DONTUNMAP
Parmi les applications possibles de MREMAP_DONTUNMAP :
• userfaultfd(2) non coopératif : une application peut retirer une
plage d'adresses virtuelles en utilisant MREMAP_DONTUNMAP, puis uti-
liser un gestionnaire userfaultfd(2) pour gérer les erreurs de pagi-
nation qui arrivent ensuite lorsque d'autres threads du processus
créent des pages dans la plage retirée.
• Récupérateur de mémoire : MREMAP_DONTUNMAP peut être utilisé avec
userfaultfd(2) pour implémenter des algorithmes de ramasse-miettes
(garbage collection) (par exemple, dans une machine virtuelle Java).
Une telle implémentation peut être moins coûteuse (et plus simple)
que les techniques de collecte traditionnelles qui impliquent de
marquer des pages avec une protection PROT_NONE ainsi que l'utilisa-
tion d'un gestionnaire SIGSEGV pour capter les accès à ces pages.
BOGUES
Avant Linux 4.14, si old_size valait zéro et si la projection à la-
quelle renvoyait old_address était une projection privée (MAP_PRIVATE
de mmap(2)), mremap() créait une nouvelle projection privée sans lien
avec celle d'origine. Ce comportement était intentionnel et probable-
ment non prévu dans des applications de l'espace utilisateur (l'inten-
tion de mremap() étant de créer une nouvelle projection à partir de
celle d'origine). Depuis Linux 4.14, mremap() échoue avec l'erreur EIN-
VAL dans ce scénario.
VOIR AUSSI
brk(2), getpagesize(2), getrlimit(2), mlock(2), mmap(2), sbrk(2), mal-
loc(3), realloc(3)
Votre manuel favori à propos de systèmes d'exploitation, pour des in-
formations supplémentaires sur la mémoire paginée (par exemple Modern
Operating Systems de Andrew S. Tanenbaum, Inside Linux par Randolf
Bentson, The Design of the UNIX Operating System par Maurice J. Bach)
TRADUCTION
La traduction française de cette page de manuel a été créée par Chris-
tophe Blaess <https://www.blaess.fr/christophe/>, Stéphan Rafin <ste-
phan.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.cou-
lon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas Huriaux
<thomas.huriaux@gmail.com>, Nicolas François <nicolas.francois@centra-
liens.net>, Florentin Duneau <fduneau@gmail.com>, Simon Paillard <si-
mon.paillard@resel.enst-bretagne.fr>, Denis Barbier <barbier@de-
bian.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
⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ 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⟩.
Pages du manuel de Linux 6.03 5 février 2023 mremap(2)
Generated by dwww version 1.15 on Sat Jun 29 01:47:06 CEST 2024.