Documentation for AllocREVpatch V2.0 by Michael Mutschler

for bugs/suggestions write to

  Michael Mutschler
  Somborer Weg 11
  71067 Sindelfingen
  Germany

EMAIL:
Internet: amiga2@info2.rus.uni-stuttgart.de
UUCP:     micha@agnus.tynet.sub.org
FIDO:     2:246/1115.1



purpose:
 Since I got a new turbocard, with 32bit-RAM I now have the problem, with
filling up the 32-bit RAM very fast, and then only the 16-bit RAM is left.
Then I thought of placing some data explicitely into the 16-bit RAM, e.g. the
RAM-Disk. Now, I found a Flag in the AllocMem() call called MEMF_REVERSE.
Because my RAM ist one big block (4MB Fast and the 4MB 16-bit in one block)
This is the right function. So all this program does, is set the REVERSE-bit
dependent on the calling Task/Process.

How it works:
The patch is installed (~300 bytes!!) and when AllocMem() is called, the patch
looks for the process-name. If the caller is a task, the task-name is taken.
Then it is compared case-insensitive to the list of tasks. If successful,
MEMB_REVERSE is set, and the mem is allocated. If CHIP-MEM is requested,
nothing is else is done. Of course Kick 2.0+ is required.


USAGE:
 AllocREVpatch [INSTALL|REMOVE]

INSTALL means, install the patch;
REMOVE  removes it. (after checking if possible)

without parameter, you get the main prefs with a nice GUI, and the patch is
being installed when necessary:

The Listview-Gadget shows the tasks currently being patched.
The UP/DOWN buttons move the active entry up/down.
INS inserts an item above the active entry.
DEL deletes the active entry.
ADD appends a new entry at the end of the list.
SORT sorts the list.

Toggling the "active" button (de-)activates the patch. this is the only
function which takes immediately effect.

SAVE saves the prefs to "S:AllocREVpatch.prefs"
I used S: and not ENV: because I call the patch before ENV is available, so
the ENV-Variables go to 16-bit RAM...

REMOVE removes the patch and quits.

OK activates the changes & quits.

Closing the Window exits immediately without activating the changes.



The Menu:

Open:
  Load new prefs with an ASL-Requester

Save As:
  Save prefs to different file.

About:
  Try it

Quit:
  same as pressing OK-button


Edit-Menu

Default:
  get the default settings of the patch
Last Saved:
  get the last settings saved ("S:AllocREVpatch.prefs")
Restore:
  undo all settings


Settings-Menu

Create Icon
   Not implemented :-)
   Does anybody need it????



Of course you can use the Keyboard too
"u" - UP
"d" - DOWN
"i" - INS
"e" - DEL
"a" - ADD
"o" - SORT
"s" - SAVE
"r" - REMOVE
"k" - OK
"v" - activate
"q" - quit immediately without saving

arrow up   - activate entry above
arrow down - activate entry below
return     - activate string gadget



Future enhancements (if I get enough response :-))
- add the feature of not only do a MEMF_REVERSE, but support different memory
  boards in the system, i.e. multiple boards with different priority.
- a guide
- Let's see what you suggest ...