BEZEICHNUNG

       cacheflush - Befehls- und/oder Datencache(s) zurückschreiben und freigeben

ÜBERSICHT

       #include <sys/cachectl.h>

       int cacheflush(void *Adr, int aByte, int cache);

       Hinweis:  Auf  einigen Architekturen gibt es keinen Glibc-Wrapper für diesen Systemaufruf;
       siehe ANMERKUNGEN.

BESCHREIBUNG

       cacheflush() schreibt den Inhalt der angegebenen Cache(s)  für  den  Benutzeradressbereich
       Adr bis (Adr+aByte-1) in den Speicher zurück. cache ist eine der folgenden Konstanten:

       ICACHE den Befehlscache freigeben.

       DCACHE zurück  in  den  Speicher  schreiben  und  die  betroffenen Bereiche des Caches für
              ungültig erklären, also freigeben.

       BCACHE identisch mit (ICACHE|DCACHE).

RÜCKGABEWERT

       cacheflush() gibt 0 bei Erfolg zurück. Im Fehlerfall wird  -1  zurückgeliefert  und  errno
       gesetzt, um den Fehler anzuzeigen.

FEHLER

       EFAULT Auf  den  Adressbereich  von Adr bis (Adr+aByte-1) kann (ganz oder teilweise) nicht
              zugegriffen werden.

       EINVAL Dem Parameter cache ist keiner der Werte  ICACHE,  DCACHE  oder  BCACHE  zugewiesen
              (siehe aber auch FEHLER).

KONFORM ZU

       Historisch war dieser Systemaufruf auf allen MIPS-UNIX-Varianten, inklusive RISC/os, IRIX,
       Ultrix, NetBSD, OpenBSD und FreeBSD  (und  auf  einigen  nicht-UNIX-MIPS-Betriebssystemen)
       verfügbar,   so   dass   die   Existenz   dieses   Aufrufs  in  MIPS-Betriebssystemen  der
       de-facto-Standard ist.

   Vorsicht
       cacheflush() sollte nicht in Programmen verwandt werden, die portabel sein  sollen.  Unter
       Linux  erschien  dieser  Aufruf  zuerst  auf der MIPS-Architektur, heutzutage stellt Linux
       einen Systemaufruf cacheflush() aber auch auf einigen anderen Architekturen zur Verfügung,
       allerdings mit anderen Argumenten.

ANMERKUNGEN

   Architektur-spezifische Varianten
       Glibc  stellt  einen  Wrapper  für  die Architekturen ARC, CSKY, MIPS und NIOS2 für diesen
       Systemaufruf bereit, dessen Prototyp in der ÜBERSICHT gezeigt ist.

       Auf einigen anderen Architekturen stellt Linux diesen Systemaufruf mit anderen  Argumenten
       bereit:

       M68K:
              int cacheflush(unsigned long Adr, int scope, int cache,
                             unsigned long laenge);

       SH:
              int cacheflush(unsigned long Adr, unsigned long laenge, int op);

       NDS32:
              int cacheflush(unsigned int start, unsigned int ende, int cache);

       Auf  den  obigen Architekturen stellt Glibc keinen Wrapper für diesen Systemaufruf bereit;
       rufen Sie ihn mittels syscall(2) auf.

   GCC-Alternative
       Sie  werden  wahrscheinlich  die  in  GCC  eingebaute  Funktion  __builtin___clear_cache()
       verwenden  wollen,  die  eine  portierbare  Schnittstelle über die von GCC und kompatiblen
       Compilern  unterstützten  Plattformen  bereitstellt,  außer  Sie  benötigen  die   feinere
       Steuerung, die dieser Systemaufruf bereitstellt.

           void __builtin___clear_cache(void *anfang, void *ende);

       Auf  Plattformen,  bei denen der Instruktionszwischenspeicher nicht rausgeschrieben werden
       muss, hat __builtin___clear_cache() keine Auswirkung.

       Hinweis: Auf einigen GCC-kompatiblen Compilern verwendet der Prototyp für diese eingebaute
       Funktion char * anstatt void * für die Parameter.

FEHLER

       Linux-Kernel älter als Version 2.6.11 ignorieren die Argumente Adr und aByte. Dadurch wird
       die Funktion relativ aufwändig. Daher wird immer der ganze Cache freigegeben.

       Die Funktion verhält sich immer so, als ob BCACHE als Argument für cache übergeben  worden
       wäre und führt keine Fehlerprüfung auf dem Argument cache durch.

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  Ralf Baechle <ralf@waldorf-
       gmbh.de>,  Martin  Eberhard  Schauer  <Martin.E.Schauer@gmx.de>   und   Helge   Kreutzmann
       <debian@helgefjell.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⟩.