home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 9 / FreshFishVol9-CD2.bin / bbs / util / mayflower.lha / MayFlower / PokeMem / PokeMem.doc < prev    next >
Text File  |  1994-06-10  |  5KB  |  105 lines
  1.  
  2.                         PokeMem 4.0 (19940309)
  3.  
  4.                         by Stephen D. Childers
  5.  
  6. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  7.                   *******  CAUTION NOTICE  *******
  8.  
  9.  --\ /--   This program will poke data values directly into memory.
  10.  (o) (o)   Poking system memory like this can cause very strange things
  11.     ^      to happen, be prepared to RESET your system if you are not
  12.  \_____/   sure what you are poking into. Consult your Amiga manuals.
  13.  
  14. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  15. Program Description:
  16.  
  17.    1) PokeMem allows you to poke predetermined values into memory
  18.       locations within your Amiga.
  19.  
  20.    2) This version of PokeMem does not check the memory size of your
  21.       system. It will attempt to poke the memory location that you
  22.       specify whether that memory IS or IS NOT installed.
  23.  
  24.    3) This version of PokeMem will only poke ONE BYTE at a time, keep
  25.       this in mind if poking around special chip registers.
  26.  
  27.    4) Can only be used from CLI. Can be made resident.
  28.  
  29.    5) Program (when run from CLI) will interact with the 'c:Why' command
  30.       after program failures; this command may provide a more detailed
  31.       explanation of why the program failed.
  32.  
  33.       The 'Why' command should be used immediately after a program
  34.       failure to extract the last program's result code, because
  35.       that result code is changed upon the execution of the next CLI
  36.       command.
  37.  
  38.    6) Certain error reports will contain the name of the argument, file,
  39.       device, (etc) that is associated with failure when it occurs.
  40.  
  41. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  42. CLI Usage:
  43.  
  44.    > PokeMem [!|?] [location -datatype data]
  45.  
  46.       ! = Show author info
  47.       ? = Show some help
  48.  
  49.       location  = The address location (hex or decimal) within memory.
  50.                   The range of address values for location are:
  51.                     Decimal = 0 to 4294967295
  52.                     Hex = H0 to Hffffffff
  53.  
  54.       -datatype = Flag which describes format of data, flags are:
  55.                     h = hex format, s = string format
  56.  
  57.       data      = The data going into memory.
  58.  
  59. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  60. CLI imaginary example:
  61.  
  62.    To poke a value of 77 hex into a certain memory location would be as:
  63.  
  64.    > PokeMem hdff036 -h 77       ; I wonder what this will do ?
  65.  
  66. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  67. Version History:
  68.  
  69.    The following information briefly describes changes or improvements
  70.    made to each version, and they will be described in descending order;
  71.    meaning latest version information begins first:
  72.    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  73.    Version 4.0 (19940309) -
  74.    1) Changed version numbering format. Program can now be used with the
  75.       "Version" command. Date within parenthesis is shown in a somewhat
  76.       international format as (yyyymmdd).
  77.    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  78.    Version 19930731 -
  79.    1) Optimized and refined source code thereby making program smaller.
  80.    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  81.    Version 19920109 -
  82.    1) Removed a CLI parsing problem.
  83.    2) Can be made resident.
  84.    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  85.    Version 19910807 - The first version.
  86. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  87.      _ /\ _ /\ _ /\ _ /\ _ /\ _ /\ _ /\ _ /\ _ /\ _ /\ _ /\ _ /\ _
  88.     /_X__X_X__X_X__X_X__X_X__X_X__X_X__X_X__X_X__X_X__X_X__X_X__X_\
  89.    //                                                             \\
  90.   //      7   Be not deceived; God is not mocked: for whatsoever   \\
  91.   \\   a man soweth, that shall he also reap.                      //
  92.    \\     8   For he that soweth to his flesh shall of the flesh  //
  93.    //  reap corruption; but he that soweth to the Spirit shall    \\
  94.    \\  of the Spirit reap life everlasting.                       //
  95.    //                                                             \\
  96.   //                   The Holy Ghost's Bible - Galatians 6:7-8    \\
  97.   \\                            (King James by the way)            //
  98.    \\_ __ _ __ _ __ _ __ _ __ _ __ _ __ _ __ _ __ _ __ _ __ _ __ _//
  99.     \_X  X_X  X_X  X_X  X_X  X_X  X_X  X_X  X_X  X_X  X_X  X_X  X_/
  100.        \/   \/   \/   \/   \/   \/   \/   \/   \/   \/   \/   \/
  101.  
  102. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  103.                              End Of Document
  104.  
  105.