home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 22 / AACD 22.iso / AACD / System / PatchRAM / PatchRAM.readme < prev    next >
Encoding:
Text File  |  2001-05-26  |  7.7 KB  |  236 lines
  1. Short:    Patch Os 3.9 RAM-Handler to show right size
  2. Uploader: thor@einstein.math.tu-berlin.de (Thomas Richter)
  3. Author:   thor@einstein.math.tu-berlin.de (Thomas Richter)
  4. Type:     util/boot
  5. Version:  2.00.3
  6. Requires: Os 3.9, Ram-Handler 44.21
  7.  
  8. This file patches the RAM disk to show the real size occupied - its no longer
  9. 100% full. 
  10. ____________________________________________________________________________
  11.  
  12. Changes made in 2.00:
  13.  
  14. Completely new and different implementation for the Os 3.9 RAM-Handler,
  15. PatchRAM is now a permanent patch for RAM that comes in the form of a
  16. patch-file.
  17.  
  18.  
  19. Changes made in 2.00.2:
  20.  
  21. Added a new release of LoadModule.
  22.  
  23.  
  24. Changes made in 2.00.3:
  25.  
  26. Added a new release of LoadModule (again)
  27. ____________________________________________________________________________
  28.  
  29.                         The THOR-Software Licence
  30.  
  31.  
  32. This License applies to the computer programs known as "PatchRAM".
  33. The "Program", below, refers to such program.
  34.  
  35.  
  36. The programs and files in this distribution are freely distributable
  37. under the restrictions stated below, but are also Copyright (c)
  38. Thomas Richter.
  39.  
  40.  
  41. Distribution of the Program by a commercial organization without written
  42. permission from the author to any third party is prohibited if any payment
  43. is made in connection with such distribution, whether directly
  44. (as in payment for a copy of the Program) or indirectly (as in payment
  45. for some service related to the Program, or payment for some product
  46. or service that includes a copy of the Program "without charge";
  47. these are only examples, and not an exhaustive enumeration of prohibited
  48. activities). However, the following methods of distribution involving
  49. payment shall not in and of themselves be a violation of this restriction:
  50.  
  51.  
  52. (i) Posting the Program on a public access information storage and
  53. retrieval service for which a fee is received for retrieving information
  54. (such as an on-line service), provided that the fee is not
  55. content-dependent (i.e., the fee would be the same for retrieving the same
  56. volume of information consisting of random data).
  57.  
  58.  
  59.  
  60. (ii) Distributing the Program on a CD-ROM, provided that the files
  61. containing the Program are reproduced entirely and verbatim on such
  62. CD-ROM, and provided further that all information on such CD-ROM be
  63. redistributable for non-commercial purposes without charge.
  64.  
  65.  
  66.  
  67. Everything in this distribution must be kept together, in original
  68. and unmodified form.
  69.  
  70.  
  71.  
  72.  
  73. Limitations.
  74.  
  75. THE PROGRAM IS PROVIDED TO YOU "AS IS," WITHOUT WARRANTY. THERE IS NO
  76. WARRANTY FOR THE PROGRAM, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT
  77. LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
  78. PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS. THE ENTIRE
  79. RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD
  80. THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY
  81. SERVICING, REPAIR OR CORRECTION.
  82.  
  83.  
  84.  
  85. IF YOU DO NOT ACCEPT THIS LICENCE, YOU MUST DELETE ALL FILES CONTAINED IN
  86. THIS ARCHIVE.
  87.  
  88. _____________________________________________________________________________
  89.  
  90.  
  91. Installation:
  92.  
  93. The installation of PatchRAM is a bit more trickier than it used to be 
  94. because it is a permanent patch and replaces the code within the RAM
  95. handler directly.
  96.  
  97. 0) Unpack the archive to wherever you want. Open a shell and change
  98. the current directory to where the archive was unpacket.
  99.  
  100. 1) Extraction of the RAM-Handler: This step requires the Os 3.9 
  101. "AmigaOs ROM Update" file and the "ExtractModule" program in this
  102. distribution. Now enter on the command line:
  103.  
  104. version "DEVS:AmigaOs ROM Update"
  105.  
  106. 2) The output of this command should be "44.26" or the patch cannot be
  107. applied.
  108.  
  109.  
  110. 3) Enter the following command on the command line:
  111.  
  112. ExtractModule from "Devs:AmigaOS ROM Update" module 8 to ram:Ram-Handler
  113.  
  114. 4) This command will place the RAM-Handler within the ROM-Updates file to
  115. RAM:Ram-Handler. Now apply the patch to this file by entering the
  116. following command:
  117.  
  118. spatch -oram:Ram-Handler.new -pRam-Handler.pch RAM:Ram-Handler
  119.  
  120. 5) This command will generate the new RAM-Handler. Copy it now to "L:" by
  121. entering the following command:
  122.  
  123. copy ram:Ram-Handler.new to L:Ram-Handler
  124.  
  125. 6) You have now two alternatives how to make use of the new Ram-Handler. As
  126. it is no longer part of the ROM-Updates file, it has to enter the system in
  127. a different way. Alternative I) is to use the "LoadModule" command, 
  128. alternative II) is to mount it manually.
  129.  
  130.  
  131. Alternative I): This will make the new RAM-Handler reset-resident in much the
  132. same way as SetPatch did.
  133.  
  134. 7) Copy the LoadModule command from this archive to C:
  135.  
  136. copy LoadModule to C:
  137.  
  138. 8) Edit the startup-sequence with an editor of your choice. In the following,
  139. let's assume the default system editor, "Ed":
  140.  
  141. Ed S:Startup-Sequence
  142.  
  143. 9) Locate the "SetPatch" command within the startup-sequence, place the
  144. cursor on the "S" of "SetPatch" and press <RETURN>. This will insert a new
  145. blank line ON TOP of SetPatch. Move the cursor upwards into this blank
  146. line and enter the following command:
  147.  
  148. LoadModule L:Ram-Handler NOREBOOT
  149.  
  150. 10) You may also load additional modules here, i.e. the Os 3.9 icon.library 
  151. or the Os 3.9 workbench.library. Just give their full paths as arguments to
  152. the LoadModule command. *NOTE THAT IT IS IMPORTANT THAT LOADMODULE IS RUN
  153. BEFORE SETPATCH*. With these modifications, the command line could look
  154. like this:
  155.  
  156. LoadModule L:Ram-Handler LIBS:icon.library LIBS:workbench.library NOREBOOT
  157.  
  158.  
  159. The advantage of "LoadModule" is that the ROM modules loaded by
  160. this command can be protected from getting overwritten by means of 
  161. the "MuProtectModules" program of the same author (not included in this archive).
  162.  
  163. 11) Locate the "SetPatch" command within the startup-sequence. Move the cursor
  164. behind "SetPatch", and add the command line option "SKIPROMMODULES ram-handler"
  165. to the command. The setpatch command line should then read approximately as
  166. follows:
  167.  
  168. SetPatch SKIPROMMODULES ram-handler >NIL:
  169.  
  170.  
  171. If you already have to skip parts of the update, as for example the scsi.device,
  172. the line should rather look like this:
  173.  
  174. SetPatch SKIPROMMODULES scsi.device,ram-handler >NIL:
  175.  
  176. 12) Save the changes of the startup-sequence back. For "Ed", press first <ESC>,
  177. then <X>, then <RETURN>.
  178.  
  179. 13) To make the changes active, a reboot is *NOT* enough. You should turn
  180. off the machine, wait for half a minute, and reboot. This will flush the
  181. RAM resident parts of the ROM-Updates mechanism.
  182.  
  183.  
  184. Alternative II): Mounting the RAM-Handler by hand in a non-reset-resident
  185. way.
  186.  
  187. 7) Copy the the files "RAM" and "RAM.info" to DEVS:DosDrivers:
  188.  
  189. copy RAM RAM.info to DEVS:DosDrivers
  190.  
  191. 8) Edit the Startup-Sequence with an editor of your choice. For the following,
  192. let's assume you use the system editor "Ed":
  193.  
  194. ed S:Startup-Sequence
  195.  
  196. 9) Locate the "SetPatch" command within the startup-sequence. Move the cursor
  197. behind "SetPatch", and add the command line option "SKIPROMMODULES ram-handler"
  198. to the command. The setpatch command line should then read approximately as
  199. follows:
  200.  
  201. SetPatch SKIPROMMODULES ram-handler >NIL:
  202.  
  203.  
  204. If you already have to skip parts of the update, as for example the scsi.device,
  205. the line should rather look like this:
  206.  
  207. SetPatch SKIPROMMODULES scsi.device,ram-handler >NIL:
  208.  
  209.  
  210. Note the double quotes!
  211.  
  212.  
  213. 10) Press <RETURN> and insert the following commands *BELOW* SetPatch, one in
  214. a line; note that it is important that these commands are run *AFTER* SetPatch
  215. (different from alternative I):
  216.  
  217. Assign RAM: DisMount
  218. Assign ENV: ENVARC:
  219. Mount DEVS:DosDrivers/RAM
  220. Assign ENV: Remove
  221.  
  222. 11) To save the changes back when using "Ed", press <ESC>, then <X>, then 
  223. <RETURN>. This step depends on the editor you use, though.
  224.  
  225. _____________________________________________________________________________
  226.  
  227.  
  228. For more information concerning "LoadModule", check "LoadModule.lha" on
  229. Aminet.
  230.  
  231. _____________________________________________________________________________
  232.  
  233.  
  234. May 2001,
  235.     Thomas
  236.