CacheCop watches exec.library's CachePreDMA() and CachePostDMA() and
reports device drivers that use them wrongly. A driver that prepares a
buffer for DMA and never calls CachePostDMA() can leave caches or MMU
state wrong on 68040/68060 systems and with MMU libraries, which is hard
to trace back to the driver responsible.

CacheCop tracks every transfer from its first CachePreDMA() to the
CachePostDMA() that closes it and reports, as they happen:

- CachePostDMA() without a matching CachePreDMA()
- DMA_Continue without a first CachePreDMA()
- a new transfer overlapping one that is still outstanding
- DMA_ReadFromRAM differing between pre and post
- a post whose address or length is not the transfer's initial one, or
  that passes DMA_Continue (rules from The MuLib Programmer's Manual)
- a post past a length the MMU library shortened, without the
  DMA_Continue calls for the rest
- transfers outstanding for longer than TIMEOUT seconds

Each report names the caller's PC, resolved through SegTracker, resident
modules, library/device jump tables (which also names drivers a boot ROM
relocated into RAM) or expansion ROMs, and its task, including whether
the call came from an interrupt.

Usage:
  run cachecop START [SERIAL] [TIMEOUT=n]
  cachecop STATUS      counters, violations, outstanding transfers
  cachecop EVENTS      the last 64 violations in detail
  cachecop RESET       clear counters and the violation log
  cachecop STOP        remove the patches and quit
  cachecop WHERE addr  name the code at an address (e.g. from a log)

SERIAL also logs every violation to the serial port with RawPutChar(), so
it survives a crash (and shows up in Sashimi). STATUS and EVENTS return
WARN when a violation was seen.

dmatest is a test program that makes both correct and deliberately broken
call sequences; "dmatest DISK <device> [unit]" reads through a real driver
so its calls can be checked. The ADF boots into a self-test: it starts
CacheCop, runs dmatest ALL and shows the status.

Source code: https://github.com/reinauer/CacheCop
License: public domain / Unlicense

 PERMSSN    UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
drwxr-xr-x     0/0           0       0 ****** -lhd- 0000 Nov  9 01:05 CacheCop-1.0/
-rw-r--r--     0/0        1175    2322  50.6% -lh5- a0dc Nov  9 01:05 CacheCop-1.0/CacheCop.readme
-rw-r--r--     0/0        2987    6432  46.4% -lh5- c8ba Nov  9 01:05 CacheCop-1.0/README.md
-rwxr-xr-x     0/0        9105   15408  59.1% -lh5- 7356 Nov  9 01:05 CacheCop-1.0/cachecop
-rwxr-xr-x     0/0        3523    6376  55.3% -lh5- 5f87 Nov  9 01:05 CacheCop-1.0/dmatest
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total         5 files   16790   30538  55.0%            Nov 10 02:13