home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 477.lha / SystemTracer_v1.0 / SystemTracer.doc < prev    next >
Encoding:
Text File  |  1991-02-12  |  5.7 KB  |  167 lines
  1.  
  2.  
  3.     SystemTracer V1.0
  4.     -----------------
  5.     a tool for viewing and editing the Amiga system structures
  6.     written in 1990 by Guido Burkard
  7.  
  8.  
  9. 1. How to start the SyTra
  10. -------------------------
  11. To start the SyTra, just type its name in the CLI. To start SyTra in the
  12. background, type "run SystemTracer -bg". The SyTra "sleeps" now until you
  13. hit the HELP key.
  14. Note: The SyTra will automatically notice whether you're Amiga is running
  15. with the NTSC (USA,200 pixels y) or the PAL (Europe, 256 pixels y)
  16. resolution and will open its window fitting in the Workbench Screen.
  17.  
  18. 2. How to use the SyTra
  19. -----------------------
  20. When the SyTra is started, it opens its own window and you can see the ">>"
  21. prompt. Now you can enter commands. Here's a summary of SyTra's commands:
  22.  
  23. l    List structure        List current structure:
  24.                 The title tells you the type and the name
  25.                 of the structure. The following structure
  26.                 listing    contains (from left to right):
  27.                 - absolute address (hexadecimal)
  28.                 - relative structure offset (hex)
  29.                 - number of the structure entry (decimal)
  30.                 - type and name of the entry
  31.                   (if the entry is a member of an array,
  32.                    there is also the array index)
  33.                 - content of the entry
  34.                 After starting SyTra, "ExecBase" is the
  35.                 current    structure. You can pause the output
  36.                 by holding down the CTRL key and stop the
  37.                 output by hitting the SHIFT key.
  38.  
  39. n    New(next) structure    Jump to a structure named or pointed at
  40.                 in the current structure. SyTra will ask
  41.                 you for the entry number (and for the
  42.                 index if it's an array). You can look up
  43.                 entry numbers in the structure listing
  44.                 (command l). If you enter a number which
  45.                 doesn't belong to a structure, SyTra will
  46.                 produce an error message. 
  47.  
  48. p    Previous structure    SyTra remembers the path on which you went
  49.                 to the current structure. With the p
  50.                 command you go one step back on the path.
  51.                 If you are yet at the place where you began,
  52.                 SyTra will produce an error message.
  53.  
  54. o    Open lib/get base    With this command you can begin a new path 
  55.                 through the structures starting at one of
  56.                 the following structures:
  57.                 - ExecBase  - IntuitionBase  - GfxBase
  58.  
  59. s    System hex/dec        Change from one system to the other:
  60.                 - hexadecimal  - decimal
  61.                 Note: Addresses, offset and memory para-
  62.                 meters are always shown and entered in hex.
  63.  
  64. e    Edit entry        Change the value of an entry in the current
  65.                 structure. You have to enter the entry
  66.                 number and - if you want to change the
  67.                 member of an array - the array index (also
  68.                 shown in the structure listing).
  69.                 If you want to change whole structures,
  70.                 you have to enter every part of the
  71.                 structure (and also sub-structures, 
  72.                 sub-sub-structures, and so on).
  73.                 If you want to change structure pointers,
  74.                 there are several possibilities:
  75.                 - a allocate
  76.                 Allocate new memory for the structure,
  77.                 enter the new structure and set the
  78.                 pointer on it. If you want to allocate
  79.                 memory, SyTra will always ask you for the
  80.                 memory parameters. This is the same number
  81.                 as AllocMem needs.
  82.                 (e.g. $02 for CHIP-memory)
  83.                 - o overwrite
  84.                 Write over the existing structure being
  85.                 pointed at.
  86.                 - p point
  87.                 Just set the pointer at any place in the
  88.                 memory, where there is yet such a structure.
  89.  
  90. w    Write structure        Write any structure anywhere in the memory.
  91.                 SyTra will ask you for the structure name.
  92.                 It will do if you enter just the first few
  93.                 letters of the structure's name if there's
  94.                 no other one beginning with the same
  95.                 letters.
  96.                  Note: SyTra differs between capital and
  97.                 small letters!
  98.                 - o overwrite
  99.                 Just write anywhere in the memory
  100.                 (use carefully!)
  101.                 - a allocate
  102.                 Allocate memory and write structure there.
  103.  
  104. r    Read structure        Read any structure from anywhere in the
  105.                 memory.
  106.  
  107. f    Free structure        Free structure's memory which you wrote 
  108.                 (allocate mode) before to the memory.
  109.  
  110. t    Type string to memory    Same as "Write structure" but for strings.
  111.  
  112. u    Untype (free) string    Same as "Free structure" but for strings.
  113.  
  114. m    Monitor memory        Hex monitor listing
  115.                 hold down CTRL to pause
  116.                 hit SHIFT to stop
  117.  
  118. x,q    Exit (Quit)        Terminate SyTra
  119.  
  120. c    Close window        Closes the SyTra window but keeps running
  121.                 in the background (exactly as if you'd
  122.                 have started SyTra with the "-bg" option).
  123.                 Hit HELP to re-open window.            
  124.  
  125. h,?    Help            Command help
  126.                 Gives a short summary of the SyTra commands.
  127.  
  128. d    Disk operations        A list of disk functions will be shown and 
  129.                 the "disk>>" prompt will be shown.
  130.                 You can either select one of the functions
  131.                 by typing its shorthand or exit the disk
  132.                 operations menu by just hitting ENTER.
  133.                 - s save structure
  134.                 saves a structure from memory to disk
  135.                 - l load structure
  136.                 loads a structure saved with the save
  137.                 operation into memory
  138.                 - a save as Assembler code
  139.                 translates a structure into assembler
  140.                 source code and saves it as ASCII to disk
  141.                 note: certain pointers and structures have
  142.                 to be filled in afterwards by the user
  143.                 - c save as C code
  144.                 translates a structure into C source code
  145.                 and saves it as ASCII to disk
  146.                 note: certain pointers and structures have
  147.                 to be filled in afterwards by the user
  148.                 - m save memory
  149.                 saves a part of the memory to disk
  150.                 - e load memory
  151.                 loads a file into memory
  152.  
  153. 3. Notes
  154. --------
  155. a) Be careful with this tool. It's easy to cause system crashes with it...
  156.  
  157. b) The m (monitor) command is a bit slow. Sorry for that...
  158.  
  159. c) I wrote this tool under Kickstart 1.2, so it may cause troubles
  160.    under V1.3, and I'm quite sure that it won't work under V2.0...
  161.  
  162. d) This program is Public Domain and may be freely distributed.
  163.  
  164. e) Critics and contributions are welcome, write to:
  165.  
  166.    Guido Burkard, Stockfeldstr. 230, CH-5243 Muelligen, Switzerland (Europe)
  167.