rom/exec/cachecleare.c

   1 /*
   2     Copyright © 1995-2011, The AROS Development Team. All rights reserved.
   3     $Id$
   4
   5     Desc: CacheClearE() - Clear the caches with extended control.
   6     Lang: english
   7 */
   8
   9 #include <aros/debug.h>
  10 #include <exec/types.h>
  11 #include <exec/execbase.h>
  12 #include <aros/libcall.h>
  13
  14 /*****************************************************************************
  15
  16     NAME */
  17 #include <proto/exec.h>
  18
  19         AROS_LH3(void, CacheClearE,
  20
  21 /*  SYNOPSIS */
  22         AROS_LHA(APTR, address, A0),
  23         AROS_LHA(IPTR, length, D0),
  24         AROS_LHA(ULONG, caches, D1),
  25
  26 /*  LOCATION */
  27         struct ExecBase *, SysBase, 107, Exec)
  28
  29 /*  FUNCTION
  30         Flush the contents of the CPU instruction or data caches. If some
  31         of the cache contains dirty data, push it to memory first.
  32
  33         For most systems DMA will not effect processor caches. If *any*
  34         external (non-processor) event changes system memory, you MUST
  35         clear the cache. For example:
  36
  37             DMA
  38             Code relocation to run at a different address
  39             Building jump tables
  40             Loading code from disk
  41
  42     INPUTS
  43         address -   Address to start the operation. This address may be
  44                     rounded DOWN due to hardware granularity.
  45         length  -   Length of the memory to flush. This will be rounded
  46                     up, of $FFFFFFFF to indicate that all addresses
  47                     should be cleared.
  48         caches  -   Bit flags to indicate which caches should be cleared
  49
  50                         CACRF_ClearI    -   Clear the instruction cache
  51                         CACRF_ClearD    -   Clear the data cache
  52
  53                     All other bits are reserved.
  54
  55     RESULT
  56         The caches will be flushed.
  57
  58     NOTES
  59         It is possible that on some systems the entire cache will be
  60         even if this was not the specific request.
  61
  62     EXAMPLE
  63
  64     BUGS
  65
  66     SEE ALSO
  67         CacheClearU(), CacheControl()
  68
  69     INTERNALS
  70         This is a rather CPU dependant function. You should replace it
  71         in your $(KERNEL).
  72
  73 ******************************************************************************/
  74 {
  75     AROS_LIBFUNC_INIT
  76
  77     /* This function is entirely architecture-specific. Replace when needed. */
  78
  79     AROS_LIBFUNC_EXIT
  80 } /* CacheClearE */
  81