rom/exec/cacheclearu.c

   1 /*
   2     Copyright © 1995-2011, The AROS Development Team. All rights reserved.
   3     $Id$
   4
   5     Desc: CacheClearU - Simple way of clearing the caches.
   6     Lang: english
   7 */
   8
   9 #include <exec/types.h>
  10 #include <exec/execbase.h>
  11 #include <aros/libcall.h>
  12
  13 /*****************************************************************************
  14
  15     NAME */
  16 #include <proto/exec.h>
  17
  18         AROS_LH0(void, CacheClearU,
  19
  20 /*  LOCATION */
  21         struct ExecBase *, SysBase, 106, Exec)
  22
  23 /*  FUNCTION
  24         Flush the entire contents of the CPU instruction and data caches.
  25         If some of the cache contains dirty data, push it to memory first.
  26
  27         For most systems DMA will not effect processor caches. If *any*
  28         external (non-processor) event changes system memory, you MUST
  29         clear the cache. For example:
  30
  31             DMA
  32             Code relocation to run at a different address
  33             Building jump tables
  34             Loading code from disk
  35
  36     INPUTS
  37
  38     RESULT
  39         The caches will be flushed.
  40
  41     NOTES
  42         It is possible that on some systems the entire cache will be
  43         even if this was not the specific request.
  44
  45     EXAMPLE
  46
  47     BUGS
  48
  49     SEE ALSO
  50         CacheClearE(), CacheControl(), CachePreDMA(), CachePostDMA()
  51
  52     INTERNALS
  53         Although it is not necessary, but it could be more efficient if
  54         this function was replaced by a function in $(KERNEL).
  55
  56 ******************************************************************************/
  57 {
  58     AROS_LIBFUNC_INIT
  59
  60     /* Just dump the whole lot */
  61     CacheClearE(0, ~0, CACRF_ClearI | CACRF_ClearD);
  62
  63     AROS_LIBFUNC_EXIT
  64 } /* CacheClearU */