4]----------------
3]BOOTCACHE 1.0
3]By Nico Francois
4]----------------

     This little utility was written because I was frustrated with the number
of programs that no longer worked on an Amigas equipped with a 68020/68030
processor, mostly games.
     If you own an A2000 equipped with a turbocard you can switch back to the
original 68000 processor to run these programs, but with an A3000 you don't
have this possibility. So what do you do?
     Some of these programs simply don't work because they use nasty things
like self-modifying code. The 68020 and 68030 have small on-chip caches for
instructions and data (68030 only) and when you try to run a self-modifying
program, chances are it won't work because of these caches.
     So what is needed is a utility that will disable all the processor
caches during a reboot, before you boot the program. Well, that's exactly
what BootCACHE does. It doesn't guarantee you that your favorite game will
work on a 68030 Amiga, but it does improve the chances it will.
     Source code is included and shows how to install resident programs in a
clean way so you can install multiple resident utilities. The source is in
assembly and is ready to be assembled by DevPac. It should be no problem at
all to get it to assemble under another assembler.
     (JUMPDISK NOTE: The source code is crunched as published in JUMPDISK. 
It can be read on screen or sent to the printer, but as prelude to working
with it, see the Article Menu entry on how to decrunch a text file.)
     BootCACHE supports Kickstart and Workbench 2.0.

3]USAGE
     BootCACHE can only be used from the CLI. Copy it to the C directory of
the Workbench. That command, to copy it from JUMPDISK, follows:

copy j:bootcache/bootcache to c/bootcache <and press Return>

     Then reboot with that same Workbench, open a CLI or Shell and type:

BootCACHE INSTALL <and press Return>

or

BootCACHE BOOTBLOCK <press Return>

. . . to install the CACHE romtag. The next time you reboot, all processor
caches will be turned off.
      Kickstart 2.0 users can also install BootCACHE with the BOOTBLOCK
option. This will install a romtag that will disable caches BEFORE the
bootblock is read, making sure the caches are off for programs that boot from
the bootblock. Note that AFTER the bootblock has been executed, the caches
will be reinitialized by Kickstart 2.0, so the caches will NOT be disabled if
the program boots from the startup-sequence. You must use the INSTALL option
for these programs.
      Kickstart 1.3 users may use either INSTALL or BOOTBLOCK. Both have the
same effect of disabling caches before AND after bootblock execution.
     To remove the BootCACHE romtag, type:

BootCACHE REMOVE <press Return>

3]NOTA BENE
     BootCACHE works just fine with the RAD ramdisk, unlike some other
rebootable programs.
     At the time of this writing, Kickstart 2.0 is still beta and I have
noticed that rebootable programs only work once. They do not survive a second
reboot. Let's hope this gets fixed.
     Kickstart 1.3 users with the new 1Mb chip Obese Agnus MUST put the
following command in their startup-sequence, if is isn't already there:

SetPatch r

. . . Otherwise BootCACHE will not survive a reboot.
     BootCACHE turns the screen green during reboot to notify you it's
active.

3]DISTRIBUTE IT
     This program, a JUMPDISK premiere, may be widely useful, and for that
reason I am declaring it freely distributable, including source code. I
retain copyright. You are free to use and change it as long as you leave my
copyright notice intact. If you do make some nice improvements, I'd like to
hear about them, so please let me know. You may distribute this program as
long as you don't ask any more money for it than a nominal fee for copying,
and if you keep this document with it. If you want to include this program in
a commercial product you need my written permission.
     If you have suggestions or remarks about this program, or if you find
any bugs, please let me know at the following address: Nico François,
Corbielaan 13, B-3060 Bertem, BELGIUM.

4]END OF TEXT