BEZEICHNUNG

       msync - eine Datei mit einem Speicherabbild synchronisieren

ÜBERSICHT

       #include <sys/mman.h>

       int msync(void *Adresse, size_t Länge, int Schalter);

BESCHREIBUNG

       msync  leitet  Änderungen,  die  in der im Speicher befindlichen Kopie einer Datei gemacht
       wurden, mittels mmap(2) zurück in das Dateisystem. Ohne Verwendung dieses Aufrufs  besteht
       keine  Garantie,  dass  Änderungen  auf  die  Platte  geschrieben  werden, bevor munmap(2)
       aufgerufen wird. Um  genauer  zu  sein:  Der  Teil  der  Datei,  der  dem  Speicherbereich
       entspricht, der bei Adresse anfängt und Länge lang ist, wird aktualisiert.

       Das  Argument  Schalter  sollte entweder MS_ASYNC oder MS_SYNC angeben. Es kann zusätzlich
       das Bit MS_INVALIDATE enthalten. Diese Bits haben folgende Bedeutung:

       MS_ASYNC
              gibt  an,  dass  eine  Aktualisierung  geplant  wird,  der  Aufruf  jedoch   sofort
              zurückkehrt.

       MS_SYNC
              fordert eine Aktualisierung an und wartet, bis sie abgeschlossen ist.

       MS_INVALIDATE
              erbittet, dass andere Abbildungen der selben Datei verworfen werden sollen (so dass
              sie mit den neuen nur geschriebenen Werten aktualisiert werden können).

RÜCKGABEWERT

       Bei Erfolg wird Null zurückgegeben. Bei einem  Fehler  wird  -1  zurückgegeben  und  errno
       gesetzt, um den Fehler anzuzeigen.

FEHLER

       EBUSY  MS_INVALIDATE  wurde in Schalter angegeben und es existiert eine Speichersperre für
              den angegebenen Adressbereich.

       EINVAL adresse ist kein Vielfaches der SEITENGRÖßE oder ein anderes  Bit  als  MS_ASYNC  |
              MS_INVALIDATE  |  MS_SYNC  ist  in  Schalter  gesetzt  oder in schalter sind sowohl
              MS_SYNC als auch MS_ASYNC gesetzt.

       ENOMEM Der angegebene Speicher (oder ein Teil davon) wurde nicht abgebildet.

KONFORM ZU

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

       Dieser Aufruf wurde in Linux 1.3.21 eingeführt  und  dann  EFAULT  an  Stelle  von  ENOMEM
       benutzt. In Linux 2.4.19 wurde dies auf den POSIX-Wert ENOMEM geändert.

       Auf  POSIX-Systemen,  auf denen msync() verfügbar ist, sind sowohl _POSIX_MAPPED_FILES als
       auch _POSIX_SYNCHRONIZED_IO in <unistd.h> als ein Wert größer als 0 definiert. (Siehe auch
       sysconf(3).)

ANMERKUNGEN

       Gemäß  POSIX  muss  entweder  MS_SYNC  oder  MS_ASYNC in Schalter angegeben werden und das
       tatsächliche Fehlschlagen beim Einfügen von einem dieser Schalter wird dazu  führen,  dass
       msync() auf einigen Systemen scheitert. Linux erlaubt jedoch einen Aufruf von msync() ohne
       diese Schalter mit einer Semantik, die (derzeit) der Angabe von MS_ASYNC entspricht. (Seit
       Linux  2.6.19 ist MS_ASYNC de facto ein Leerbefehl, da der Kernel unsaubere Seiten korrekt
       verfolgt und wenn nötig aus  dem  Speicher  leert.)  Trotz  des  Linux-Verhaltens  sollten
       portable,  zukunftssichere  Anwendungen  sicherstellen,  dass sie MS_SYNC oder MS_ASYNC in
       Schalter angeben.

SIEHE AUCH

       mmap(2)

       B.O. Gallmeister, POSIX.4, O'Reilly, Seiten 128–129 und 389–391.

KOLOPHON

       Diese Seite  ist  Teil  der  Veröffentlichung  5.13  des  Projekts  Linux-man-pages.  Eine
       Beschreibung  des  Projekts,  Informationen,  wie  Fehler gemeldet werden können sowie die
       aktuelle Version dieser Seite finden sich unter https://www.kernel.org/doc/man-pages/.

ÜBERSETZUNG

       Die deutsche Übersetzung dieser Handbuchseite wurde von Martin Schulze <joey@infodrom.org>
       und Chris Leick <c.leick@vollbio.de> erstellt.

       Diese  Übersetzung  ist  Freie  Dokumentation;  lesen  Sie  die GNU General Public License
       Version 3 ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ oder neuer bezüglich der  Copyright-
       Bedingungen. Es wird KEINE HAFTUNG übernommen.

       Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-
       Mail an die Mailingliste der Übersetzer ⟨debian-l10n-german@lists.debian.org⟩.