home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 6 / FreshFish_September1994.bin / bbs / util / mayflower.lha / MayFlower / PeekMem / PeekMem.doc < prev    next >
Encoding:
Text File  |  1994-06-10  |  6.6 KB  |  153 lines
  1.  
  2.                         PeekMem 4.0 (19940228)
  3.  
  4.                         by Stephen D. Childers
  5.  
  6. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  7.                   *******  CAUTION NOTICE  *******
  8.  
  9. Peeking at certain memory locations within your Amiga system    --\ /--
  10. can cause very strange things to happen, be prepared to RESET   (o) (o)
  11. your system if you are not sure of what you are peeking at.        ^
  12. Consult your Amiga manuals.                                     \_____/
  13.  
  14. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  15. Program Description:
  16.  
  17.    1) Program will display hex data contained within a given range of
  18.       memory.
  19.  
  20.    2) This version of PeekMem does not disable multitasking when peeking
  21.       at a range of memory; this means that the memory range may be
  22.       changing while peeking at it. Keep this in mind when looking over
  23.       data that looks strange or unexpected during a peeking session.
  24.  
  25.    3) This version of PeekMem does not check the memory size of your
  26.       system. It will attempt to peek at the memory range that you
  27.       specify whether that memory IS or IS NOT installed.
  28.  
  29.       see "NOTE for A3000 users:" below.
  30.  
  31.    4) Can only be used from CLI. Can be made resident.
  32.  
  33.    5) Program (when run from CLI) will interact with the 'c:Why' command
  34.       after program failures; this command may provide a more detailed
  35.       explanation of why the program failed.
  36.  
  37.       The 'Why' command should be used immediately after a program
  38.       failure to extract the last program's result code, because
  39.       that result code is changed upon the execution of the next CLI
  40.       command.
  41.  
  42.    6) Certain error reports will contain the name of the argument, file,
  43.       device, (etc) that is associated with failure when it occurs.
  44.  
  45. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  46. NOTE for A3000 users:
  47.  
  48.    If you attempt to access memory that does not physically exist
  49.    somewhere in your machine then the program will almost come to a
  50.    complete standstill, and printouts of the addresses involved will be
  51.    intolerably slow, and system freezes except during printouts, and
  52.    Ctrl-C will not work as expected. To force the program to BREAK
  53.    (without rebooting) then you must perform the following steps:
  54.  
  55.    1) Press space bar, PeekMem's window must be the active one.
  56.       If PeekMem's window is not active then perform the
  57.       following substeps:
  58.  
  59.       1.1) Hold down the menu button until mouse can be moved then
  60.            continue to hold down the menu button.
  61.       1.2) Move mouse into PeekMem's window and then release menu button,
  62.            system will freeze again.
  63.       1.3) Continueously press the left mouse button until PeekMem's
  64.            window becomes active.
  65.       1.4) Press space bar.
  66.  
  67.    2) Wait until mouse is freely movable, then activate another CLI
  68.       window and type "status", now note PeekMem's process number.
  69.  
  70.    3) Then type:
  71.          >Break x C   ; x = PeekMem's process number.
  72.  
  73.    4) Activate PeekMem's window and press backspace until PeekMem breaks.
  74.  
  75.    I do not know (as of Feb 1994) why the system responds the way it
  76.    does when attempting to access memory that is not actually within the
  77.    computer.
  78.  
  79. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  80. CLI Usage:
  81.  
  82.    > PeekMem [!|?] [[-options] location range]
  83.  
  84.       ! = Show author info
  85.       ? = Show some help
  86.  
  87.       options: a = Do not show address number
  88.                c = Show as hex for C compiler, will set option a
  89.                t = Do not show text portion at end of hex data
  90.  
  91.       location = The address location within memory.
  92.                  The range of input values for location are:
  93.                    Decimal =  0 to 4294967295
  94.                    Hex     = H0 to Hffffffff
  95.  
  96.       range    = The number of bytes to be displayed in hex format.
  97.                  The range of input values for range are:
  98.                    Decimal =  1 to 4294967295
  99.                    Hex     = H1 to Hffffffff
  100.  
  101.    Hex values must be preceded with the 'h' character.
  102.    _____________________________________________________________________
  103.  
  104.    Try this example:
  105.  
  106.    > Peekmem hf80000 hb0
  107.  
  108. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  109. Version History:
  110.  
  111.    The following information briefly describes changes or improvements
  112.    made to each version, and they will be described in descending order;
  113.    meaning latest version information begins first:
  114.    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  115.    Version 4.0 (19940228) -
  116.    1) Changed version numbering format. Program can now be used with
  117.       the "Version" command. Date within parenthesis is shown in a
  118.       somewhat international format as (yyyymmdd).
  119.    2) Added "NOTE for A3000 users:"
  120.    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  121.    Version 19930731 -
  122.    1) Optimized and refined source thereby making program smaller.
  123.    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  124.    Version 19920109 -
  125.    1) Removed a CLI parsing problem.
  126.    2) Can be made resident.
  127.    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  128.    Version 19910807 - The first version.
  129.  
  130. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  131.    ___   ___   ___   ___   ___   ___   ___   ___   ___   ___   ___
  132.   /   \_/   \_/   \_/   \_/   \_/   \_/   \_/   \_/   \_/   \_/   \
  133.   \                                                               /
  134.   /     24  Then said Jesus unto his disciples, If any man will   \
  135.   \  come after me, let him deny himself, and take up his cross,  /
  136.   /  and follow me.                                               \
  137.   \     25  For whosoever will save his life shall lose it: and   /
  138.   /  whosoever will lose his life for my sake shall find it.      \
  139.   \     26  For what is a man profited, if he shall gain the      /
  140.   /  whole world, and lose his own soul? or what shall a man      \
  141.   \  give in exchange for his soul?                               /
  142.   /     27  For the Son of man shall come in the glory of his     \
  143.   \  Father with his angels; and then he shall reward every man   /
  144.   /  according to his works.                                      \
  145.   \                                                               /
  146.   /                        The Holy Bible - Matthew 16:24-27      \
  147.   \                             (King James by the way)           /
  148.   /    _     _     _     _     _     _     _     _     _     _    \
  149.   \___/ \___/ \___/ \___/ \___/ \___/ \___/ \___/ \___/ \___/ \___/
  150.  
  151. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  152.                               End Of Document
  153.