home *** CD-ROM | disk | FTP | other *** search
/ Magazyn Amiga 3 / MA_Cover_3.iso / blabla / execmon / execmon.doc < prev    next >
Encoding:
Text File  |  1998-01-24  |  9.8 KB  |  265 lines
  1.  
  2.                                  ExecMon 2.5c
  3.                             © 1996-97 Szymon Pura
  4.                                   EMAILWARE
  5.                                 BLABLA PRODUCT
  6.  
  7. Last change: 05 Dec 1997
  8.  
  9. ===============
  10. WHAT IS EXECMON
  11. ===============
  12.  
  13.     ExecMon  is  a  powerful,  fast  and reliable system monitor.  It's main
  14.   purpose  is  displaying and controlling Amiga activities, such as windows,
  15.   libraries, memory, locks and a lot more.  ExecMon is especially useful for
  16.   debugging and for removing crashed programs from memory.
  17.  
  18.     Please  note,  that ExecMon is meant only for experienced and advanced
  19.   Amiga   users.   ExecMon  allows  you  to  change  some  low-level  system
  20.   structures, and IMPROPER USAGE WILL CAUSE YOUR MACHINE TO CRASH.
  21.  
  22.     ExecMon  has  been  tested  on 68000,68EC020 and 68030 machines, under
  23.   OS2.04, 3.0 and 3.1.  Remember, that some of ExecMon's features use really
  24.   'dirty'  tricks  and  assumptions about OS, which may conflict with future
  25.   releases of the operating system.
  26.  
  27.     At the moment NO  reads/writes are performed on custom chips' registers.
  28.   Also, NO system routines are patched.
  29.  
  30. ============
  31. INSTALLATION
  32. ============
  33.  
  34.   Just copy ExecMon and its icon to the selected directory.
  35.  
  36.   NOTE:   Since  V2.2, preferences file is stored in PROGDIR:  instead of
  37.           ENVARC:.
  38.  
  39.           Since V2.4, ExecMon will also look for its config file in ENV:.
  40.  
  41.   ExecMon  requires  Kickstart  V37+  and  Reqtools V38+ to run.  Note, that
  42.   Kickstart  V39+ is recommended:  the newer OS allows to do some operations
  43.   in much 'cleaner' way.
  44.  
  45. =====
  46. START
  47. =====
  48.  
  49.   Just type 'ExecMon' from CLI or double-click on ExecMon icon from WB.
  50.  
  51.   No commandline arguments or tooltypes are recognized.
  52.  
  53. =====
  54. USAGE
  55. =====
  56.  
  57.     ExecMon  opens  its own screen, public or custom.  The main window looks
  58.   like this:
  59.  
  60.   /-------------------------------------------------------------------------\
  61.   |                                                                         |
  62.   |                         Main display area                               |
  63.   |                                                                         |
  64.   |                                                                         |
  65.   |                                                                         |
  66.   \-------------------------------------------------------------------------/
  67.  
  68.     /------------------------------\       /------------------------------\
  69.     |                              |       |                              |
  70.     |          Lists               |       |          Operators           |
  71.     |                              |       |                              |
  72.     |                              |       \------------------------------/
  73.     |                              |       |         Refresh List         |
  74.     \------------------------------/       \------------------------------/
  75.  
  76.  
  77.     First  select  one  of the 'Lists' items.  Now all available operators
  78.   will  appear  in the listview to the right.  You can invoke them by simple
  79.   mouse click. If you select an entry from the main list, some additional
  80.   commands may appear in 'Operators' list.
  81.  
  82.     All  lists  are  sorted according to related subsystem.  There's no more
  83.   documentation  on  lists  available  at  the moment, sorry.  I haven't got
  84.   enough  time  to  do  this,  not  to  mention  my  poor  English.  Anyway,
  85.   experienced  users  shouldn't  have  any  diffilcuties,  I  tried to  make
  86.   ExecMon as easy-to-use as possible.
  87.  
  88. =========
  89. LOG FILES
  90. =========
  91.  
  92.   There are two ways to create a log-file:
  93.  
  94.   1. Use the 'Write log file...' function from the pull-down menu.
  95.      A file-requester will open, asking for logfile name.
  96.      Log file will be created immediately.
  97.  
  98.   2. Use the 'Open log file...' function from the pull-down menu.
  99.      A file-requester will open, asking for logfile name.
  100.      Now use 'Add to log file' function to write displayed list, and
  101.      select 'Close log file' when you're done.
  102.  
  103.   Options:
  104.   - Include date - current date will be included in the log file
  105.  
  106.   - Include header - a header text will be included in the log file
  107.  
  108.   - Console sequences - log   file  may  contain  some  additional
  109.      text-formatting  console  sequences.   Switch  it  off to obtain pure
  110.      ASCII file.
  111.  
  112. =========
  113. TECHNICAL
  114. =========
  115.  
  116.  o 68060 is not currently recognized by functions from 'Hardware'.
  117.    This is mainly because OS3.1 doesn't support it directly.
  118.  
  119.  o Currently, the only disk libraries needed by ExecMon are
  120.    reqtools.library and diskfont.library. No other disk-based
  121.    subsystems are required, that should allow it to run without
  122.    much overhead.
  123.  
  124.  o Some operations are protected by Disable()/Enable() pair,so note that
  125.    NO  SERIAL/PARALLEL  ACTIVITY  SHOULD  BE  PERFORMED  WHEN  EXECMON IS
  126.    WORKING  (there  should be no ill effects when ExecMon is just running
  127.    and waiting for user input).
  128.  
  129.  o The 'Open device' function from 'Devices' list simply increases
  130.    LIB_OPENCNT field of the Device structure.
  131.  
  132.  o The 'Open monitor' function from 'Monitors' list simply increases
  133.    the open counter without notifying graphics.library
  134.  
  135.  o Most  lists are protected against damaged system structures, but still
  136.    some Enforcer hits may occur - they're completely harmless and are usually
  137.    caused  by  read accesses to low memory regions.  But in normal situations
  138.    _NO_ Enforcer/Mungwall hits should appear - if you detect one, please send
  139.    a bug report to me.
  140.    (There's only one exception: on systems with VBR set to 0 (and also 68000
  141.    machines) ExecMon will access low memory regions during preparation of the
  142.    'Vector Base'.)
  143.  
  144. =======
  145. HISTORY
  146. =======
  147.  
  148.  o 25/05/96   1.0
  149.    - first release
  150.  
  151.  o 01/06/96   1.0a
  152.    - GUI slightly improved
  153.    - Now listviews are clipped, most problems with huge fonts fixed
  154.  
  155.  o 15/06/96   1.1
  156.    - Improved TextFont list
  157.    - 'Examine window' fixed
  158.    - Optimized for shorter object and source files
  159.    - Minor bugfixes in rendering code
  160.  
  161.  o 23/06/96   1.1a
  162.    - GoToSleep fixed
  163.    - 'Signal task' improved
  164.    - Two Enforcer hits removed
  165.  
  166.  o 04/02/97   2.0   :-}
  167.    - Private memory pools are used instead of 'Vecs'.
  168.    - Almost full protection against damaged CSTR and BSTR's implemented.
  169.    - Major optimizations - ExecMon should perform significantly faster.
  170.    - LogFile functions greatly improved.
  171.    - 'Examine screen/window' greatly improved.
  172.    - 'Examine drive' added to Drives.
  173.    - 'Change flags', 'Change ver', 'Change pri' added to KickTagList.
  174.    - 'Close device', 'Open device' added to Devices.
  175.    - 'Open monitor' added to Monitors.
  176.    - 'Change flags', 'Rename port' added to Message ports.
  177.    - Subclass counter added to BOOPSI.
  178.    - Exec/MemoryList added.
  179.    - Keyboard/ResetHandlers added.
  180.    - Exec/KickMemList added.
  181.    - Some smaller and bigger bugs fixed - LONG's and ULONG's should be fixed.
  182.  
  183.  o 14/02/97   2.1
  184.    - Some global code clenup, resulting in shorter object file
  185.    - Screen creation greatly improved, error handling finally added.
  186.      Now ExecMon is able to open a custom screen.
  187.    - Now ExecMon can work in 640x200 resolution
  188.    - Overscan gadget added to ScreenMode requester
  189.    - 'Load Preferences...' requester fixed  8->
  190.    - 'Flush memory' added to MemoryHandlers
  191.    - Status bar fixed (could accidentally display some strange characters)
  192.    - Expansion/Boards and Expansion/Bootnodes added
  193.  
  194.  o 27/02/97   2.2
  195.    - Lots of tiny harmless bugs fixed.
  196.    - ExecBase is now cached for speedup, and most accesses to ExecBase
  197.      are now made via system calls instead of direct peeking.
  198.    - Now Dos/Locks list shows names of exclusive locks correctly.
  199.    - Volumes/'Examine volume' added.
  200.    - Drives/'Examine drive' now shows also InfoData structure whenever
  201.      possible.
  202.    - Dos/CLIs list added.
  203.    - Dos/Residents list added.
  204.    - Hardware/'Cache control' added.
  205.    - Hardware/'CPU registers' added.
  206.    - Hardware/General added.
  207.    - Drives/Inhibit added.
  208.    - PublicScreens/Lock & Unlock added. Also the 'Close screen' is fixed.
  209.    - Preferences file is now stored in PROGDIR: instead of ENVARC:.
  210.    - Now screen font is used during menu creation.
  211.  
  212.  o 01/05/97   2.3
  213.    - Internal engine greatly improved. ExecMon is now faster and shorter
  214.          than 2.2.
  215.    - Dos/Assigns - 'Assign lock' and 'Assign path' fixed.
  216.    - Some other minor fixes and improvements - Interrupts, KickMemList,
  217.      Tasks.
  218.  
  219.  o 21/05/97   2.4
  220.    - a potentially dangerous bug in GUI engine fixed.
  221.    - Hardware/VectorBase added.
  222.    - Hardware/CPU registers now also shows MMU registers of 68030.
  223.          (68020+68851 and  68040/60 MMUs are not supported yet)
  224.    - Graphics/DisplayDatabase added.
  225.    - If prefs file is not found in the program directory, ENV: will be searched.
  226.  
  227.  o 21/08/97   2.5
  228.    - Some optimizations made. ExecMon is now shorter than 2.4.
  229.    - Several minor and major bugs fixed (ModifyIDCMP, Dos Residents, RefreshList).
  230.    - Keymap list added.
  231.    - 'Hardware Registers' finally fixed and improved.
  232.    - Some minor improvements (FileSystems, BOOPSI, Interrupts).
  233.    - Totally redone font selection.
  234.    - 'Action list' improved, should be easier to use it.
  235.  
  236.  o 04/09/97   2.5a/2.5b
  237.    - Some minor adjustments done.
  238.    - Minor, but still troublesome bug fixed.
  239.  
  240.  o 05/12/97   2.5c
  241.    - Bug fixed in task list
  242.    - Now windows remember their position
  243.  
  244. ======
  245. AUTHOR
  246. ======
  247.  
  248.     ExecMon  is EMAILWARE.  It can be freely distributed as long as no more
  249.   than a nominal fee is charged to cover time and copying costs.  All use is
  250.   at  your  own  risk.
  251.  
  252.     If you like this program, please send me an e-mail.
  253.  
  254.     This is a BLABLA product.
  255.  
  256.   Suggestions, donations, bug reports are welcome at:  (use e-mail if possible)
  257.  
  258.                                  Szymon Pura
  259.                                szymp@friko.onet.pl
  260.  
  261.                                  Witosa 8/57
  262.                               42-224 Czestochowa
  263.                                     POLAND
  264.                                +48 (0)34 624666
  265.