home *** CD-ROM | disk | FTP | other *** search
/ The Fred Fish Collection 1.5 / ffcollection-1-5-1992-11.iso / ff_progs / diskutil / hackdisk.lha / hackdisk.doc < prev    next >
Encoding:
Text File  |  1992-07-14  |  4.2 KB  |  123 lines
  1. Hackdisk V1.10
  2.  
  3. By Dan Babcock
  4. Copyright (C) 1992 by Dan Babcock
  5.  
  6. ------------
  7. Distribution
  8. ------------
  9.  
  10. Hackdisk may be freely copied for non-commercial purposes (only).
  11.  
  12. -----------------
  13. What is hackdisk?
  14. -----------------
  15.  
  16. Hackdisk is a complete trackdisk.device replacement, minus
  17. support for 5.25 inch and 150RPM drives. It works with any
  18. version of Kickstart.
  19.  
  20. ----------------------------
  21. What's wrong with trackdisk?
  22. ----------------------------
  23.  
  24. The standard trackdisk module works well, but it isn't perfect.
  25. My major gripe is that it doesn't offer a verify option. I used
  26. TrackSalve (a brilliant program by Dirk Reisig) before KS2.0 and
  27. received enough "verify error" messages to realize that this
  28. feature is very valuable. Hackdisk has a verify option that may
  29. be turned on or off at any time for any drive. The verify is very
  30. efficient and compares the raw MFM data bit-for-bit.
  31.  
  32. Hackdisk is faster than trackdisk 2.0. A DiskCopy to RAD: is 5
  33. seconds faster. A DiskCopy from RAD: with verify is only 1.6
  34. times slower than trackdisk, not 2 times slower like you might
  35. expect! Please note that this performance increase is gained by
  36. better programming, NOT by pushing the drive beyond its
  37. specifications.
  38.  
  39. Hackdisk requires more chip RAM for its verify buffer, but
  40. conserves memory by using one track buffer for all drives, rather
  41. than a track buffer for each drive. Experience shows that this
  42. does not hurt performance.
  43.  
  44. For programmers, Hackdisk eliminates the silly restrictions on
  45. read/write parameters. You can specify a read or write at any
  46. byte offset, any byte length, to/from any byte address.
  47.  
  48. -------------------
  49. Installing Hackdisk
  50. -------------------
  51.  
  52. Hackdisk is really an operating system module more than a
  53. "program". Thus you can't execute it from the CLI, for example. A
  54. special program called RamKick is required. (RamKick should be
  55. included in this archive).
  56.  
  57.     [Ed note:  Because of the questionable origins of
  58.     RamKick, I have deleted it from the distribution.
  59.     It had no copyright I could find, but neither was
  60.     there any indication that it was freely redistri-
  61.     butable.  -Fred]
  62.  
  63.                            RamKick was used by the little-known
  64. Hedley/Moniterm release of the OS to replace many ROM-resident
  65. libraries. Please keep in mind that RamKick is a general purpose
  66. program that has nothing to do with Hackdisk; I just happen to
  67. use it. (And I don't feel like writing my own right now...).
  68.  
  69. Type "ramkick ?" to see the options. If you don't know what
  70. everything does, don't worry, because I don't either! Use the
  71. "Kick" script as an example. (Note: It doesn't matter where you
  72. put hackdisk.device, but DEVS: is a good place). The Kick script
  73. uses a tiny program called "HackDiskTest" to test whether
  74. Hackdisk is installed. It will also print out the version number
  75. and copyright. Therefore you can put this at the start of your
  76. startup-sequence to have Hackdisk loaded whenever needed. If you
  77. have an autobooting hard drive, it won't slow down booting much.
  78.  
  79. A3000 owners: For some reason, RamKick does not automatically
  80. reboot (using the -reboot option). Because I don't have a 3000 to
  81. play with there's not much I can do about it.
  82.  
  83. Another RamKick note: Sometimes after booting a game or demo the
  84. machine will enter a infinite reboot cycle. This is caused by
  85. RamKick or Hackdisk being partially (but not fully) corrupted.
  86. RamKick should perform more extensive checksums...
  87.  
  88. If you are technically inclined, you may reassemble/relocate
  89. Hackdisk and burn a new kickstart EPROM. (Or use one of those
  90. SRAM kickstart boards). Simple place the raw code (starting with
  91. $4AFC) on top of the trackdisk.device code. You will be left with
  92. some free ROM space to play with as a bonus.
  93.  
  94. -------------------------
  95. Turning Verify Off and On
  96. -------------------------
  97.  
  98. By default, verify is ON for all drives. You can use the tiny
  99. program (2.0-only!) ToggleVerify to invert the verify state.
  100.  
  101. Programmers: The verify bit is bit 1 of TDU_PUBFLAGS.
  102.  
  103. -------
  104. Credits
  105. -------
  106.  
  107. Special thanks go to the following Amiga wizards:
  108.  
  109. Dirk Reisig        - for TrackSalve
  110. Sebastiano Vigna    - for SuperDuper
  111. Mike Schwartz        - for sharing his game kernel etc.
  112.  
  113. ----------
  114. My Address
  115. ----------
  116.  
  117. Post Office Box 1532
  118. Southgate, MI  48195
  119. U.S.A.
  120.  
  121. I am reachable via Usenet as Dan_E_Babcock@cup.portal.com.
  122.  
  123.