home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 10 / Fresh_Fish_10_2352.bin / new / util / moni / scout / docs / english / scout.doc < prev    next >
Text File  |  1995-07-04  |  54KB  |  1,736 lines
  1.  
  2.                              Scout 37.105
  3.                              Release 2.2
  4.                             User's Manual
  5.                   Copyright (C) 1994 Andreas Gelhausen
  6.  
  7. What is Scout?
  8. ==============
  9.  
  10.        Scout is a tool that allows you to monitor your computer
  11. system.  It displays many different things -- like tasks, ports,
  12. assigns, expansion boards, resident commands, interrupts, etc.  -- and
  13. you can perform some certain actions on them.
  14.  
  15.    For example you can freeze tasks, close windows and screens, release
  16. semaphores or remove locks, ports and interrupts.
  17.  
  18. Through AmiTCP it's also possible to use Scout as an TCP/IP service.
  19.  
  20.    Since version 2.0 of Scout you can use nearly all implemented
  21. functions through shell parameters. Therefore it's not necessary to
  22. install MUI for using Scout, but you will need MUI, if you want
  23. to use Scout with its graphical user interface.
  24.  
  25. Copyright
  26. =========
  27.  
  28.    Scout 37.105 (Release 2.2) - Copyright (C) 1994 by Andreas Gelhausen,
  29. all rights reserved.
  30.  
  31.        Scout is a giftware program and you are only allowed to
  32. freely distribute it, if you let this archive unchanged.  No part of
  33. this archive is allowed to be distributed with commercial software
  34. without a written permission of the author.
  35.  
  36. Disclaimer
  37. ==========
  38.  
  39.    No warranties are made for this program. All use is at your own risk.
  40. No liability or responsibility is assumed for any damages occured
  41. during the usage of Scout. You have been warned.
  42.  
  43. Giftware
  44. ========
  45.  
  46.        Scout 37.105 is giftware. If you like and use this program,
  47. you are welcome to appreciate my programming efforts by sending me a
  48. little present -- thanks a lot in advance!  =:^)
  49.  
  50. System Requirements
  51. ===================
  52.  
  53.     Scout only requires Amiga operating system version 2.04.
  54.  
  55.    If you want to use Scout's graphical user interface, you also have
  56. to install MUI version 2.1 or higher.  See also MUI.
  57.  
  58.    The TCP/IP features of Scout are only available, if you have
  59. installed the version 4.0 of AmiTCP.  See also AmiTCP.
  60.  
  61. MUI - MagicUserInterface
  62. ========================
  63.  
  64.              (C) Copyright 1993/94 by Stefan Stuntz
  65.  
  66.    MUI is a system to generate and maintain graphical user interfaces.
  67. With the aid of a preferences program, the user of an application has
  68. the ability to customize the outfit according to his personal taste.
  69.  
  70.    MUI is distributed as shareware. To obtain a complete package
  71. containing lots of examples and more information about registration
  72. please look for a file called muiXXusr.lha (XX means the latest
  73. version number) on your local bulletin boards or on public domain disks.
  74.  
  75.    If you want to register directly, feel free to send DM 30.- or US$
  76. 20.- to
  77.  
  78.                         Stefan Stuntz
  79.                    Eduard-Spranger-Straße 7
  80.                         80935 München
  81.                            GERMANY
  82.  
  83. AmiTCP
  84. ======
  85.  
  86.        AmiTCP is a TCP/IP protocol stack for the Amiga. The demo
  87. version 4.0 (or higher) should be available in greater public domain
  88. collections or on the AmiNet. Ask your preferred Amiga dealer.  =:^)
  89.  
  90. Installing Scout
  91. ================
  92.  
  93.    You only have to copy the program scout and the data file
  94. scout.data to your favourite directory and then you can start it.
  95. The file scout.data includes data of expansion boards.
  96.  
  97. How to use Scout
  98. ****************
  99.  
  100.    This chapter describes the usage of Scout through its graphical
  101. user interface. This graphical user interface is based on the Magic
  102. User Interface (MUI) and MUI have to be installed in your system,
  103. if you want to use Scout trough windows and so on.
  104.  
  105.    If you don't like MUI, you should see Scout without MUI.
  106.  
  107.    If you start the program you will see the main window which includes
  108. many gadgets.  Each of these gadgets represents a certain kind of
  109. system structure.
  110.  
  111. You can choose between:
  112.  
  113.    Assigns, Devices, Expansions, Fonts, InputHandlers, Interrupts,
  114. Libraries, Locks, Memory, Mounted Devices, Ports, Resident Commands,
  115. Residents, Resources, Semaphores, Tasks, Vectors and Windows.
  116.  
  117.    Click one of these gadgets and another window will be opened with a
  118. list of the structure type that is indicated on the pressed gadget.
  119.  
  120.          Example: Press the task gadget and you will get a window with
  121.      the list of tasks and processes.
  122.  
  123.    You can also select these functions by pressing the underlined key
  124. you see on each gadget or by using the right mousebutton menu.
  125.  
  126.    If you wish to handle/remove a given structure, you should know what
  127. you do.
  128.  
  129.          Warning: Wrong handling of the showed structures can crash
  130.      your system. At the worst you will lose your data.
  131.  
  132.     Please note: You should not be surprised, if you don't find a
  133. certain detail information in this manual, because it's to much work to
  134. explain each element of all the structures you could see in this
  135. program.
  136.  
  137.    Many books are written about these things and if you want to have
  138. more information about them, you should have a look in the specialized
  139. literature.
  140.  
  141. Assigns
  142. =======
  143.  
  144.    This type of structure assigns a logical name to a directory.
  145.  
  146.    If you assign the directory dh0:data/documents the logical name
  147. texts:, you will also be able to choose a file filename in that
  148. directory with the path `texts:filename'.
  149.  
  150. Column items
  151. ------------
  152.  
  153. Address
  154.      Address of the assign structure.
  155.  
  156. Name
  157.      Logical name of a directory
  158.  
  159. Path
  160.      Here you will find the path of the directory.
  161.  
  162. Actions
  163. -------
  164.  
  165. Update
  166.      Selecting this gadget updates the list of assigns.
  167.  
  168. Print
  169.      This function allows you to send the list of Assigns to printer
  170.      or a selected file.
  171.  
  172. Remove
  173.      The selected assign will be removed with this function.
  174.  
  175. Exit
  176.      The Assigns window will be closed.
  177.  
  178. Devices
  179. =======
  180.  
  181.    A device is -- like a library (see Libraries) -- a collection of
  182. functions/procedures, which have to do certain jobs.
  183.  
  184.    E.g. the trackdisk.device includes functions for the floppy disk
  185. handling.
  186.  
  187. Column items
  188. ------------
  189.  
  190. Address
  191.      Address of the device structure
  192.  
  193. ln_Name
  194.      Name of a device
  195.  
  196. ln_Pri
  197.      Priority of a device
  198.  
  199. OpenC
  200.      This element shows how often the device was opened.
  201.  
  202. RPC
  203.          RPC means RAM Pointer Count and shows how many jump
  204.      addresses of the device point into RAM.  In this way many programs
  205.      -- like the setpatch command from Commodore -- patch the system.
  206.  
  207.      Many viruses patch the system in this way too, but don't panic now.
  208.      If you check your system in regular intervals with a current virus
  209.      killer, it should be out of danger.
  210.  
  211.      If the whole program code of the device is located in RAM, you will
  212.      find a dash (minus sign) here, because in this case it's
  213.      unimportant how many jump addresses point into RAM.
  214.  
  215. ln_Type
  216.      Type of this structure (usually device)
  217.  
  218. Actions
  219. -------
  220.  
  221. Update
  222.      If you select this gadget, the list of devices will be updated.
  223.  
  224. Print
  225.      This function allows you to send the list of Devices to printer
  226.      or a selected file.
  227.  
  228. Remove
  229.      The selected device will be removed with this function provided
  230.      that no program uses this device anymore and the OpenC is zero.
  231.  
  232. Priority
  233.      Herewith the priority of the device can be changed.  A little
  234.      window will be opened, that asks you for a new priority.  Through
  235.      the new priority it can happen that the device gets a new place in
  236.      the device list.
  237.  
  238. More
  239.      Another window will be opened and you will see more informations
  240.      about the selected device.
  241.  
  242.      You will have the same effect, if you doubleclick an element of the
  243.      device list.
  244.  
  245. Exit
  246.      The Devices window will be closed.
  247.  
  248. Expansions
  249. ==========
  250.  
  251.    In this list you will find all your expansion boards (graphic bo