cacheflush(2) System Calls Manual cacheflush(2) NOM cacheflush - Vider le contenu des memoires caches BIBLIOTHEQUE Bibliotheque C standard (libc, -lc) SYNOPSIS #include int cacheflush(void addr[.nbytes], int nbytes, int cache); Note : sur certaines architectures, il n'existe pas d'enveloppe glibc pour cet appel systeme ; voir NOTES. DESCRIPTION cacheflush() vide le contenu des memoires caches indiquees de l'espace d'adressage utilisateur compris entre addr et (addr+nbytes-1). La memoire cache est l'une des suivantes : ICACHE Vider le cache d'instructions. DCACHE Reecrire le cache en memoire et invalider le cache concerne. BCACHE Identique a (ICACHE|DCACHE). VALEUR RENVOYEE cacheflush() renvoie 0 s'il reussit. En cas d'erreur, il renvoie -1 et il positionne errno pour indiquer l'erreur. ERREURS EFAULT Une partie de l'espace d'adressage entre addr et (addr+nbytes-1) n'est pas accessible. EINVAL Le parametre cache est different de ICACHE, DCACHE ou BCACHE (mais voir BOGUES). VERSIONS cacheflush() ne devrait pas etre utilise dans des programmes concus pour etre portables. Sur Linux, cet appel est apparu pour la premiere fois sur l'architecture MIPS, mais Linux offre aujourd'hui un appel systeme cacheflush() sur d'autres architectures, mais avec des parametres differents. Variantes dependantes de l'architecture La glibc fournit une enveloppe pour cet appel systeme, dont le prototype est presente en SYNOPSIS, pour les architectures suivantes : ARC, CSKY, MIPS et NIOS2. Sur d'autres architectures, Linux fournit cet appel systeme avec des parametres differents : M68K : int cacheflush(unsigned long addr, int scope, int cache, unsigned long len); SH : int cacheflush(unsigned long addr, unsigned long len, int op); NDS32 : int cacheflush(unsigned int start, unsigned int end, int cache); Sur les architectures ci-dessus, la glibc ne fournit pas d'enveloppe autour de cet appel systeme ; appelez-le avec syscall(2). Alternative GCC Sauf si vous avez besoin du controle tres fin fourni par cet appel systeme, vous voudrez probablement utiliser la fonction integree a GCC, __builtin___clear_cache(), qui offre une interface portable sur toutes les plateformes prises en charge par GCC et les compilateurs compatibles : void __builtin___clear_cache(void *begin, void *end); Sur les plateformes qui n'ont pas besoin de vider le cache d'instruction, __builtin___clear_cache() n'a aucun effet. Note : sur certains compilateurs compatibles avec GCC, le prototype de cette fonction integree utilise char * au lieu de void * pour les parametres. STANDARDS Historiquement, cet appel systeme etait disponible sur toutes les variantes UNIX MIPS, notamment RISC/os, IRIX, Ultrix, NetBSD, OpenBSD et FreeBSD (et aussi sur des systemes d'exploitation MIPS non UNIX), ainsi l'existence de cet appel dans les systemes d'exploitation MIPS est de facto standard. BOGUES Les noyaux Linux avant Linux 2.6.11 ignorent les parametres addr et nbytes, ce qui rend cette fonction assez couteuse. Par consequent, le cache entier est toujours vide. Cette fonction se comporte toujours comme si BCACHE etait passe en parametre cache et elle ne verifie pas les erreurs dans le parametre cache. TRADUCTION La traduction francaise de cette page de manuel a ete creee par Christophe Blaess , Stephan Rafin , Thierry Vignaud , Francois Micaux, Alain Portal , Jean-Philippe Guerard , Jean-Luc Coulon (f5ibh) , Julien Cristau , Thomas Huriaux , Nicolas Francois , Florentin Duneau , Simon Paillard , Denis Barbier , David Prevot et Jean-Philippe MENGUAL Cette traduction est une documentation libre ; veuillez vous reporter a la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITE LEGALE. Si vous decouvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message a . Pages du manuel de Linux 6.06 31 octobre 2023 cacheflush(2)