home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 9 / FreshFishVol9-CD2.bin / bbs / util / xoper-2.4.lha / Xoper / Xoper.doc < prev    next >
Text File  |  1993-10-05  |  25KB  |  662 lines
  1.                 Xoper V2.3
  2.  
  3.             Copyright (c) Werner Gunther 1991
  4.  
  5. Xoper is a freeware program to display and to control system activity.
  6. Permition is granted to freely distribute this program.
  7.  
  8. --------------------------------------------------------------------------
  9. Changes in V1.2:
  10. New commands: Snoop, Capture, ClrCool, ClrWarm, ClrCold.
  11. Added        : CPU usage by task.
  12.  
  13. Cancel command has been rewritten, some minor bugs removed.
  14. ---------------------------------------------------------------------------
  15. Changes in V1.3:
  16. New commands: [S]=Stack usage, Sort, Hide, Hidden, Header, Window,
  17.           InputHandler.
  18. Added        : Support of startup-scripts, I/O Interrupts/second, 'Kill' an
  19.           alias for 'Cancel'.
  20. Some BIG bugs have been removed: The port-display used to GURU if more than
  21. 32 Ports did exist. The Cli Xoper has been started did act like having a
  22. priority of 128. Unlock didn't unlock sometimes, the interrupt/priority
  23. field did contain rubbish, Currentdir didn't examine all Processes.
  24. There were some more, minor bugs, all (hopefully) removed.
  25. ---------------------------------------------------------------------------
  26. Changes in V1.3b:
  27. New commands: [C] information on CLI-Tasks.
  28. Added        : 'Time 0' stops any update, System-Requesters are now handeled
  29.           correctly (affects 'Kill' and 'Closewindow').
  30. ---------------------------------------------------------------------------
  31. Changes in V2.0:
  32. The 'user interface' (what user interface ?) has been rewritten from
  33. scratch, and a small iconify routine has been added. To customize the whole
  34. thing a little bit, there are a few new commands:
  35.  MinimumChars, HistoryLines, ShowHistory, KillHistory, OutputLines,
  36. IconifyOff, BackDropIcon, UseScreen, UseWindow.
  37. Other new commands include:
  38. TimerIO, RemResident, Repeat, TrapGuru, Setfont, DiskChange, Alias,
  39. SaveOutput.
  40. Addresses are now shown as 32-Bit values for 68020 compatibility. The 'More'
  41. command is obsolete and has been removed. The 'interrupt list' has two new
  42. fields. 'Time' w/o parameters shows current setting. 'display commands'
  43. separated by blanks will display the lists one by one, instead of
  44. displaying them all at once.
  45. ---------------------------------------------------------------------------
  46. Changes in V2.1:
  47. Mostly bug fixes:
  48.  KS1.3 dependancy removed. Using UseScreen in the startup file could crash
  49. the program if started with the -b flag. The S (stack) command wasn't
  50. robust enought. Some strangness in the 'KILL' routine have been removed.
  51. The iconizing routine couldn't distinguish between multiple drags and
  52. doubleclicks.
  53. Added: SetFKeys, Time accepts values < 1, 'Windows' shows the owner task (if
  54. available). The task display shows the name of the loaded command
  55. (enclosed in '[]') instead of the name, if the task is a CLI, 'CLICmd'
  56. toggles this feature on/off. Commandline completion using <tab>.
  57.  
  58. A new program 'KillXoper' has been added to the distribution to remove
  59. Xoper from memory in case it loops or freezes (I hope it won't be needed).
  60. ---------------------------------------------------------------------------
  61. Changes in V2.2:
  62. The 'KillXoper' routine has been put into Xoper's main program. Loaded CLI
  63. commands are always displayed, not only in the task list.
  64. ---------------------------------------------------------------------------
  65. Changes in V2.3:
  66. General Fixes for WB2.0x, FPU and 680xx processors. A complete redesign
  67. of the 'task usage' section, including a new display showing the total
  68. amount of cpu-time by task.
  69. Added new fields to the task, fonts, screen and cli display; scrollbars,
  70. logging of open files and filelocks, a 'frags' like display.
  71. The 'save' function appends its output to a file, toggeling commands may
  72. be followed by 'on' or 'off' for clearer startup-scripts.
  73. (the 68881 code was done by Lothar English)
  74. ---------------------------------------------------------------------------
  75. Changes in V2.4:
  76. Xoper now handles non-proportinal fonts bigger than 8x8 pixels correctly.
  77. The old style can be forced with the new option 'usetopaz', Xoper will use
  78. topaz/8 instead. Xoper now takes care of the screens barheight and window
  79. border widths. Commandline completation now works at every position of the
  80. inputline and cycles instantly. If running under Kick2.0+ Xoper clones the
  81. default public screen and makes it's own screen public. Search for startup
  82. script first in 'currentdir' then in 'env:' and last in 's:'. Older cmds as
  83. 'cancel','alert','remnode' and 'remintserver' now displayed in the help page.
  84. The input-handler checking for Amiga-Amiga-x is now permanently installed.
  85.  
  86. Lots of bugs removed and major code cleanup.
  87. ---------------------------------------------------------------------------
  88.  
  89. Starting Xoper from CLI:
  90.  
  91. Xoper [kill] [-b] [T] [F] [S] [L] [D] [R] [E] [M] [P] [I] [C] [U]
  92.  
  93. These parameters are described below. For all those who like long
  94. Startup-Sequences, overcrowded memory and hot-keys enter
  95.  
  96. Xoper -b
  97.  
  98. This will install Xoper in background waiting for LeftAmiga-RightAmiga-X
  99. to pop up. In both cases you don't have to RUN or RUNBACK Xoper, it will
  100. always create its own process.
  101.  
  102. Xoper kill
  103.  
  104. will kill an already running Xoper task from outside, in case Xoper hangs or
  105. guru's.
  106.  
  107. At startup Xoper loads and executes a file named S:Xoper.Startup if such a
  108. file is available. This startup-script is used to set default values, the
  109. window size or the initial default list to be displayed. The Xoper-window
  110. will only be opened after the startup-script has been processed. Look at the
  111. end of the document for a sample startup file.
  112.  
  113. Xoper Window:
  114. -------------
  115.  The window (or screen if you request one) is devided into two sections: a
  116. very small input line on the bottom and a large output area on the top. If
  117. the output exceeds the size of the window you may scroll or 'page' through
  118. the text using the num-pad keys:
  119.  
  120. A1000  A2000/A500
  121.   7    Home        Top of display
  122.   1    End        Bottom
  123.   9    Pg Up        one page up
  124.   3    Pg Dn        one page down
  125.   8    Up Arrow    one line up
  126.   2    Down Arrow    one line down
  127.   4    Left Arrow    one page left
  128.   6    Right Arrow    one page right
  129.  
  130.  The input section has some line editing facilities and a history buffer
  131. contollable with the following keys (similar to NewCon and ConMan):
  132.  
  133. Cursor left        cursor one character left
  134. Shift  left        cursor to the start of the next word
  135. Cursor right        one character right
  136. Shift  right        previous word
  137. Cursor Up        previous line in history buffer
  138. Shift  Up        top of buffer
  139. Cursor Down        next line in history buffer
  140. Shift  Down        bottom of buffer
  141. DEL            DEL
  142. BS            backspace
  143. Ctrl   X        delete line
  144. Ctrl   Y        delete EOL
  145. Ins   (numpad '0')      toggles insert mode (default is 'on')
  146. Del   (numpad '.')      same as DEL
  147.  
  148. ESC            moves the input area from the bottom into the
  149.             output section. Entering a command here (i.e
  150.             overwiting an output line), will cause Xoper to add
  151.             the address of that node to your command line.
  152.             Example: Show the hunks of a 'File.System' process:
  153.             type 'T' to get a list of all tasks, press <esc>,
  154.             move the cursor to the line displaying the
  155.             File.System process and type 'Hunks <enter>'. Press
  156.             <enter> once more to return to the usual Xoper
  157.             display.
  158. Help            displays a help panel.
  159. TAB            Command line completion.
  160.             Example: press <c>, hit <tab> several times.
  161.  
  162. The Xoper window has, beside the usual closewindow and depth-arrange
  163. gadgets, a custom gadget on its title bar, used to iconify Xoper. The icon
  164. may be moved anywhere on the screen just by dragging it, double clicking
  165. the icon will restart the program. The window itself is a simple_refresh
  166. window, so it may look a little bit sluggish when it needs a refresh.
  167.  
  168. Xoper Commands:
  169. ---------------
  170.  
  171. Commands are entered in the command line at the bottom of the window,
  172. these are divided into two groups:
  173.  
  174. Display commands: These are always single character entries and may be
  175. specified in any order, upper or lower case, after the prompt or from CLI
  176. as parameters. If more than one list has to be displayed, you may enter
  177. several commands in one line. Separating them with blanks displays the lists
  178. one by one instead of showing them all at once.
  179.  
  180. T = Tasks (Default if Xoper is called without parameters)
  181. Task node (HEX), Display type, status, priority (decimal), CPU u