NOM

       msync - Synchroniser un fichier et une projection en mémoire

BIBLIOTHÈQUE

       Bibliothèque C standard (libc, -lc)

SYNOPSIS

       #include <sys/mman.h>

       int msync(void addr[.length], size_t length, int flags);

DESCRIPTION

       msync()  écrit  les modifications qui ont été effectuées sur la copie d'un fichier qui est
       projeté en mémoire par mmap(2) sur le système de  fichiers.  Si  l'on  n'utilise  pas  cet
       appel,  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.

       Le  paramètre  flags  devrait  indiquer  exactement  MS_ASYNC  et MS_SYNC et il peut aussi
       inclure le bit MS_INVALIDATE. Ces bits ont la signification suivante :

       MS_ASYNC
              Indiquer la programmation d'une mise à jour, mais l'appel renvoie immédiatement.

       MS_SYNC
              Demander une mise à jour et attendre qu'elle se termine.

       MS_INVALIDATE
              Demander d'invalider d'autres projections du même fichier (pour  qu'elles  puissent
              être mises à jour avec les nouvelles valeurs écrites récemment).

VALEUR RENVOYÉE

       En  cas  de succès, zéro est renvoyé. En cas d'erreur, -1 est renvoyé et errno est définie
       pour préciser l'erreur.

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.

STANDARDS

       POSIX.1-2001, POSIX.1-2008.

       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.

       Sur les systèmes conformes à la spécification POSIX sur lesquels 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, p. 128–129 et 389–391.

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  ⟨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⟩.