home *** CD-ROM | disk | FTP | other *** search
/ Fish 'n' More 2 / fishmore-publicdomainlibraryvol.ii1991xetec.iso / fish / misc_utils / bootcache / bootcache.doc < prev    next >
Text File  |  1990-12-17  |  4KB  |  116 lines
  1.  
  2.  
  3.                           BootCACHE 1.0 User Manual
  4.  
  5.                                  Sep 12, 1990
  6.  
  7.  
  8.  
  9. Preface
  10. =======
  11.  
  12.      This program is public domain, source code is included. You are free
  13. to use/change it as long as you leave my copyright notice intact.  If you do
  14. make some nice improvements I'd like to hear about them, so please let me
  15. know.  You can distribute this program as long as you don't ask any more
  16. money for it than a nominal fee for copying, and if you keep this document
  17. with it.  If you want to include this program in a commercial product you
  18. need my written permission.
  19.      If you have suggestions or remarks about this program, or if you find
  20. any bugs, please let me know.
  21.  
  22.      Write to the following address:
  23.  
  24.                                 Nico François
  25.                                 Corbielaan 13
  26.                                 B-3060 Bertem
  27.                                 BELGIUM
  28.  
  29.  
  30. Contents
  31. ========
  32.  
  33. 1. An introduction
  34.  
  35. 2. Usage
  36.  
  37.  
  38. 1. An introduction
  39. ==================
  40.  
  41.      This little utility was written because I was frustrated with the amount
  42. of programs that no longer worked on an Amiga equiped with a 68020/68030
  43. processor, mostly games.  If you own an A2000 equiped with a turbocard you can
  44. switch back to the original 68000 processor to run these programs, but if you
  45. own an A3000 you don't have this possibility.  So what do you do ?
  46.      Some of these programs simply don't work because they use nasty things
  47. like self-modifying code.  The 68020 and 68030 have small on chip caches for
  48. instructions and data (68030 only) and when you try to run a self-modifying
  49. program chances are it won't work because of these caches.
  50.      So what is needed is a utility that will disable all the processor caches
  51. during a reboot, before you boot the program.  Well, that's exactly what
  52. BootCACHE does.  It doesn't guarantee you that your favourite game will work
  53. on a 68030 equiped Amiga, but it does improve the chances it will.
  54.      Source code is included and shows how to install resident programs in a
  55. clean way so you can install multiple resident utilities.  The source is in
  56. assembly and is ready to be assembled by DevPac.  It should be no problem at
  57. all to get it to assemble under another assembler.
  58.      BootCACHE supports Kickstart & Workbench 2.0.
  59.  
  60.  
  61. 2. Usage 
  62. ========
  63.  
  64.      BootCACHE can only be used from the CLI, use it like this:
  65.  
  66.      '1> BootCACHE INSTALL'   or   '1> BootCACHE BOOTBLOCK'
  67.  
  68.      to install the CACHE romtag. The next time you reboot all processor
  69.      caches will be turned off.
  70.        If you are a Kickstart 2.0 user you can also install BootCACHE with the
  71.      BOOTBLOCK option.  This will install a romtag that will disable caches
  72.      *BEFORE* the bootblock is read, making sure the caches are off for
  73.      programs that boot from the bootblock.  Note that *AFTER* the bootblock
  74.      has been executed the caches will be reinitialized by Kickstart 2.0, so
  75.      the caches will *NOT* be disabled if the program boots from the startup-
  76.      sequence.  You must use the INSTALL option for these programs.
  77.        Kickstart 1.3 users may use either INSTALL or BOOTBLOCK, both have the
  78.      same effect, disabling caches before AND after bootblock execution.
  79.  
  80.      To remove the BootCACHE romtag type:
  81.  
  82.      '1> BootCACHE REMOVE'
  83.  
  84.  
  85. NOTE: - BootCACHE works just fine with the RAD ramdisk. (Unlike some other
  86.         rebootable programs).
  87.       - At the time of this writing Kickstart 2.0 is still beta and I have
  88.         noticed that rebootable programs only work ONCE, they do not survive
  89.         a second reboot.  Let's hope this gets fixed :-)
  90.       - Kickstart 1.3 users with the new 1Mb chip Obese Agnus *MUST* put the
  91.         following command in their startup-sequence (if not already there):
  92.         'SetPatch r'.  Otherwise BootCACHE will not survive a reboot.
  93.       - BootCACHE turns the screen green during a reboot to notify you it is
  94.         active.
  95.  
  96.  
  97.                            As always, I hope you find this program useful !
  98.  
  99.  
  100.                               PROGRAM HISTORY:
  101.  
  102. *****************************************************************************
  103. VERSION 1.0
  104.  
  105.      First release.
  106.  
  107. *****************************************************************************
  108.  
  109. BootCACHE 1.0 written by Nico François (Yes, Nico is my first name :-)
  110.  
  111. (c) 1990 Nico François / PowerPeak
  112.  
  113.                                    //
  114.                        Thanks to \X/ Amiga for being the best computer ever !
  115.  
  116.