rom/exec/cachecontrol.c

   1 /*
   2     Copyright © 1995-2001, The AROS Development Team. All rights reserved.
   3     $Id$
   4
   5     Desc: CacheControl() - Global control of the system caches.
   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_LH2(ULONG, CacheControl,
  20
  21 /*  SYNOPSIS */
  22         AROS_LHA(ULONG, cacheBits, D0),
  23         AROS_LHA(ULONG, cacheMask, D1),
  24
  25 /*  LOCATION */
  26         struct ExecBase *, SysBase, 108, Exec)
  27
  28 /*  FUNCTION
  29         This function will provide global control of all the processor
  30         instruction and data caches. It is not possible to have per
  31         task control.
  32
  33         The actions undertaken by this function are very CPU dependant,
  34         however the actions performed will match the specified options
  35         as close as is possible.
  36
  37         The commands currently defined in the include file exec/execbase.h
  38         are closely related to the cache control register of the Motorola
  39         MC68030 CPU.
  40
  41     INPUTS
  42         cacheBits   -   The new state of the bits
  43         cacheMask   -   A mask of the bits you wish to change.
  44
  45     RESULT
  46         oldBits     -   The complete value of the cache control bits
  47                         prior to the call of this function.
  48
  49         Your requested actions will have been performed. As a side effect
  50         this function will also cause the caches to be cleared.
  51
  52     NOTES
  53         On CPU's without a separate instruction and data cache, these will
  54         be considered as equal.
  55
  56     EXAMPLE
  57
  58     BUGS
  59
  60     SEE ALSO
  61         CacheClearE(), CacheClearU()
  62
  63     INTERNALS
  64         This function requires replacing in $(KERNEL), or possibly
  65         even $(ARCH) in some cases.
  66
  67 ******************************************************************************/
  68 {
  69     AROS_LIBFUNC_INIT
  70
  71     /* I don't go strict if this function is used, because it is not
  72        required for a correctly operating system (ouch bad choice of
  73        words). Only complain if the function is used.
  74     */
  75 #warning TODO: Write exec/CacheControl()
  76     aros_print_not_implemented("CacheControl");
  77     return 0;
  78
  79     AROS_LIBFUNC_EXIT
  80 } /* CacheControl */