NOM¶
msync - Synchroniser un fichier et une projection en mémoire
SYNOPSIS¶
#include <sys/mman.h>
int msync(void *addr, size_t length, int
flags );
DESCRIPTION¶
msync() écrit sur le disque les modifications qui ont
été effectuées sur la copie d'un fichier qui est
projeté en mémoire par
mmap(2). Si l'on n'utilise pas
cette fonction, rien ne garantit que les changements soient écrits
avant la suppression de la projection par
munmap(2). Pour être
plus précis, la portion du fichier correspondant à la zone
mémoire commençant en
addr et ayant une longueur de
length est mise à jour.
L'argument
flags comprend les bits
MS_ASYNC,
MS_SYNC et
MS_INVALIDATE, mais
MS_ASYNC et
MS_SYNC ne peuvent pas
être utilisés conjointement.
MS_ASYNC demande une mise
à jour, mais l'appel retourne immédiatement.
MS_SYNC
demande une mise à jour, et attend qu'elle se termine avant de revenir.
MS_INVALIDATE demande l'invalidation de toutes les autres projections
du même fichier, afin qu'elles soient toutes remises à jour avec
les nouvelles données écrites.
VALEUR RENVOYÉE¶
S'il réussit, cet appel système renvoie 0. S'il échoue, il
renvoie -1 et remplit
errno en conséquence.
ERREURS¶
- EBUSY
- MS_INVALIDATE était positionné dans flags,
mais un verrouillage mémoire existe pour l'intervalle
indiqué.
- EINVAL
- addr n'est pas aligné sur une frontière de page (un
multiple de PAGESIZE), ou d'autres bits que MS_ASYNC |
MS_INVALIDATE | MS_SYNC sont à 1 dans flags.
Ou bien MS_SYNC et MS_ASYNC sont tous les deux
spécifiés dans flags.
- ENOMEM
- La zone mémoire indiquée (ou une partie de cette zone) n'est
pas une projection.
POSIX.1-2001.
Cet appel a été introduit dans Linux 1.3.21, et utilisait
EFAULT au lieu de
ENOMEM. Dans Linux 2.4.19, ceci a
été remplacé par la valeur POSIX
ENOMEM.
DISPONIBILITɶ
Sur les systèmes conformes à la spécification POSIX sur
lequel
msync() est disponible, les constantes symboliques
_POSIX_MAPPED_FILES et
_POSIX_SYNCHRONIZED_IO sont
définies dans
<unistd.h> comme étant des valeurs
supérieures à 0. (Consultez aussi
sysconf(3).)
NOTES¶
POSIX spécifie qu'au moins
MS_SYNC ou
MS_ASYNC doit
être indiqué dans
flags, et que si aucun des deux n'est
indiqué
msync() échouera sur certains systèmes.
Cependant, Linux autorise d'appeler
msync() sans indiquer aucun des
deux attributs, avec une sémantique actuellement équivalente
à indiquer
MS_ASYNC. (Depuis Linux 2.6.19,
MS_ASYNC est sans effet, puisque le noyau suit correctement les pages
modifiées et les transfère vers le disque si besoin.)
Malgré le comportement de Linux, les applications portables et
destinées à être pérennes doivent indiquer au
moins
MS_SYNC ou
MS_ASYNC dans
flags.
VOIR AUSSI¶
mmap(2)
B.O. Gallmeister, POSIX.4, O'Reilly, pp. 128–129 et 389–391.
COLOPHON¶
Cette page fait partie de la publication 3.65 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/>.
Christophe Blaess <
http://www.blaess.fr/christophe/> (1996-2003), Alain
Portal <
http://manpagesfr.free.fr/> (2003-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> ».