Scout 37.227 Release 3.0 User's Manual Copyright (C) 1994-2002 Andreas Gelhausen, Richard K"orber, Thore B"ockelmann ›1m›22m›1m›22m›1m›22m›1m›22m›1m›22m›1m›22mWhat is Scout? ============== ›1m Scout›22m is a tool that allows you to monitor your computer system. It displays many different things -- like tasks, ports, assigns, expansion boards, resident commands, interrupts, etc. -- and you can perform some certain actions on them. For example you can freeze tasks, close windows and screens, release semaphores or remove locks, ports and interrupts. Through ›1mAmiTCP›22m it's also possible to use ›1mScout›22m as an TCP/IP service. Since version 2.0 of ›1mScout›22m you can use nearly all implemented functions through shell parameters. Therefore it's not necessary to install ›1mMUI›22m for using ›1mScout›22m, but you will need ›1mMUI›22m, if you want to use ›1mScout›22m with its graphical user interface. Copyright ========= Please read the following parts carefully. You accept the following terms by starting the software, even for a test drive only. ›1mCOPYRIGHT›22m Scout 37.227 (Release 3.0) - Copyright (C) 1994-2002 by Andreas Gelhausen, Richard K"orber and Thore B"ockelmann, all rights reserved. You only have the right to use the software, but no rights on the software itself. Disassembling, resourcing and all other ways of reverse engineering is forbidden. ›1mFREEWARE›22m Scout is FreeWare. You are allowed to use the packet without paying a fee or similar to the authors. Of course we would appreciate a small donor! ;-) ›1mCOPYING›22m You can copy the packet as long as it remains entire and unchanged. You are allowed to compress the packet using a customary compression software (as lha, lzh, lzx, dms). You must not compress single files of the packet (e.g. PowerPacker or Imploder). ›1mDISTRIBUTION›22m You must not exceed an usual price on the market for your working and material. This means a maximum of 5 DM (or the equivalent amount in other currencies, including all taxes) for disks and 35 DM for CD-ROMs containing a PD software collection. In any case, you need a written permission from us if you want to include Scout on a cover disk or in connection with a commercial product. We explicitly permit the distribution via AmiNet, Meeting Pearls and Fred Fish. ›1mLIABILITY›22m You are using the program as it is, with all flaws, and on your own risk! We grant no warranty for the software meeting a special purpose. This software may cause financial damage or harm people. ›1mLIMITATIONS›22m You are not allowed to use this software and its results * for fascism or military purposes * if you do not agree to the copyright note In this case you must delete the software and all related and generated files immediately! ›1mCONTENTS OF THE PACKET›22m The Scout packet is ›3monly›23m entire with these files: Scout/arexx/activatetask.scout Scout/arexx/arexx.readme Scout/arexx/arexx.readme.info Scout/arexx/breaktask.scout Scout/arexx/freezetask.scout Scout/arexx/poptofront.scout Scout/arexx/settaskpri.scout Scout/arexx/startup.scout Scout/arexx.info Scout/help/deutsch/scout-39.guide Scout/help/deutsch/scout-39.guide.info Scout/help/deutsch/scout.doc Scout/help/deutsch/scout.doc.info Scout/help/deutsch/scout.dvi Scout/help/deutsch/scout.guide Scout/help/deutsch/scout.guide.info Scout/help/deutsch.info Scout/help/english/scout-39.guide Scout/help/english/scout-39.guide.info Scout/help/english/scout.doc Scout/help/english/scout.doc.info Scout/help/english/scout.dvi Scout/help/english/scout.guide Scout/help/english/scout.guide.info Scout/help/english.info Scout/help.info Scout/icons/icons.readme Scout/icons/icons.readme.info Scout/icons/Scout.info Scout/icons/ScoutDock Scout/icons/ScoutDock.info Scout/icons.info Scout/libs/identify.library Scout/libs/identify.readme Scout/libs/identify.readme.info Scout/libs.info Scout/Product-Info Scout/Scout Scout/Scout.info Scout/scout.history Scout/Scout.history.info Scout/Scout.readme Scout/Scout.readme.info Scout.info ›1mTRADEMARKS›22m All copyrights and trademarks are held by their owners. System Requirements =================== ›1mScout›22m only requires AmigaOS version 2.04. The ›1midentify.library›22m V8 is not required, but I strongly suggest to install it to give Scout its full power. See also Identify. If you want to use ›1mScout's›22m graphical user interface, you also have to install ›1mMUI›22m version 2.1 or higher. See also MUI. The TCP/IP features of ›1mScout›22m are only available, if you have installed the version 4.0 of ›1mAmiTCP›22m. See also AmiTCP. MUI - MagicUserInterface ======================== (C) Copyright 1992-97 by Stefan Stuntz MUI is a system to generate and maintain graphical user interfaces. With the aid of a preferences program, the user of an application has the ability to customize the outfit according to his personal taste. MUI is distributed as shareware. To obtain a complete package containing lots of examples and more information about registration please look for a file called ›1mmuiXXusr.lha›22m (XX means the latest version number) on your local bulletin boards or on public domain disks. If you want to register directly, feel free to send DM 30.- or US$ 20.- to Stefan Stuntz Eduard-Spranger-Strasse 7 80935 M"unchen GERMANY Identify ======== Copyright (C) 1996-97 Richard K"orber ›1m Identify›22m is a Shared Library that decodes expansion IDs, guru codes and library functions, and identifies your system. ›1m Identify›22m is FreeWare. You can find a complete package in the AmiNet (›1mutil/libs/Identify.lha›22m) or on the author's home page: ›1mhttp://www.is-koeln.de/einwohner/shred/›22m. To get in contact, write to ›1mshred@chessy.aworld.de›22m. AmiTCP ====== ›1m AmiTCP›22m is a TCP/IP protocol stack for the Amiga. The demo version 4.0 (or higher) should be available in greater public domain collections or on the AmiNet. Ask your preferred Amiga dealer. =:^) Installing Scout ================ You only have to copy the program ›1mscout›22m to your favourite directory, and ›1midentify.library›22m to ›1mlibs:›22m. Then you can start it. How to use Scout **************** This chapter describes the usage of ›1mScout›22m through its graphical user interface. This graphical user interface is based on the ›1mMagic User Interface›22m (›1mMUI›22m) and ›1mMUI›22m have to be installed in your system, if you want to use ›1mScout›22m trough windows and so on. If you don't like ›1mMUI›22m, you should see Scout without MUI. If you start the program you will see the main window which includes many gadgets. Each of these gadgets represents a certain kind of system structure. You can choose between: Allocations, Assigns, BoopsiClasses, Commodities, Devices, Expansions, Fonts, InputHandlers, Interrupts, Libraries, Locks, LowMemory, Memory, Mounted Devices, Ports, Resident Commands, Residents, Resources, ScreenMode, Semaphores, System, Tasks, Timer, Vectors, Windows, Patches, Catalogs and AudioModes. Click one of these gadgets and another window will be opened with a list of the structure type that is indicated on the pressed gadget. ›1m Example:›22m Press the task gadget and you will get a window with the list of tasks and processes. You can also select these functions by pressing the underlined key you see on each gadget or by using the right mousebutton menu. If you wish to handle/remove a given structure, you should know what you do. ›1m Warning:›22m Wrong handling of the showed structures can crash your system. At the worst you will lose your data. ›1mPlease note:›22m You should not be surprised, if you don't find a certain detail information in this manual, because it's to much work to explain each element of all the structures you could see in this program. Many books are written about these things and if you want to have more information about them, you should have a look in the specialized literature. Allocations =========== This window informs about who allocated what hardware resource. CIA --- The Amiga owns two CIA to control its hardware, the keyboard and the printer interfaces. Additionally, it contains a couple of timer. This window shows which parts of the CIA are not yet allocated, or which program allocated the resource. ›1mTimer A›22m ›1mTimer B›22m This are two 16bit timer. They can also be coupled to a 32bit timer. ›1mAlarm›22m This resource informs if a third timer reached an alarm value. ›1mSerial›22m This is a simple serial interface. Usually, the CIA-A one's is used for communicating with the keyboard. The CIA-B serial interface will not be allocated in most cases. ›1mFlag›22m This is a special control line. It is connected from the CIA-A to the Index line of the floppy disk drives. Note: newer DraCos do not contain the CIA chips. Thus, these hardware resources will be emulated or are even not offered. Ports ----- This are the resources for the internal parallel and serial interfaces. ›1mSerial Port›22m This are the plain data transfer registers (transmitting and receiving). ›1mSerial Control›22m This are the serial control lines, as Carrier Detect. ›1mParallel Port›22m This are the data lines of the parallel port. ›1mParallel Control›22m This are the control lines of the parallel port, as Busy or Paper Out. Actions ------- ›1mUpdate›22m The window is updates each time you press this button. ›1mPrint›22m The window's contents are printed or saved to a file of your choice. ›1mExit›22m The window will be closed. Assigns ======= This type of structure assigns a logical name to a directory. If you assign the directory ›1mdh0:data/documents›22m the logical name ›1mtexts:›22m, you will also be able to choose a file FILENAME in that directory with the path `texts:FILENAME'. Column items ------------ ›1mAddress›22m Address of the assign structure. ›1mName›22m Logical name of a directory ›1mPath›22m Here you will find the path of the directory. Actions ------- ›1mUpdate›22m Selecting this gadget updates the list of assigns. ›1mPrint›22m This function allows you to send the list of ›1mAssigns›22m to printer or a selected file. ›1mRemove›22m The selected assign will be removed with this function. ›1mExit›22m The ›1mAssigns›22m window will be closed. BoopsiClasses ============= BOOPSI classes are object oriented classes. The classes in this list are all classes that are publically available from intuition. Column items ------------ ›1mAddress›22m This is the address of the ›1mIClass›22m structure, which contains all data of this class. ›1mObjects›22m Shows the current amount of objects constructed by this class. ›1mSubclasses›22m Shows the current amount of sub classes (public and private) which are derived from this class. ›1mSuperclass›22m A pointer to the ›1mIClass›22m structure of the parent class. ›1mDispatcher›22m A pointer to the dispatcher code, which realizes all methods of the class. ›1mName›22m The name of the class. Actions ------- ›1mUpdate›22m The list will be updated. ›1mPrint›22m This function allows you to send the list to printer or a selected file. ›1mRemove›22m Removes the selected class from the system. This is only possible if neither objects nor sub classes exist from this class. ›1mMore›22m Opens a window with further information. ›1mExit›22m Closes the window. Commodities =========== Commodities are small utilities. Most of them react on the input stream, or manipulate it. You can find some commodity examples in the ›1mTools›22m drawer of your Workbench. Column items ------------ ›1mAddress›22m Points to the ›1mCxObj›22m structure of the commodity, containing all data about it. ›1mln_Type›22m Structure type. Usually, it will be ›1mBroker›22m. ›1mln_Pri›22m Priority of the commodity broker. ›1mFlags›22m Flags describing the broker. ›1mPort›22m All messages of the broker are sent to this MessagePort. ›1mName›22m Name of the commodity. Actions ------- ›1mAppear›22m ›1mDisappear›22m Let the selected commodity's GUI pop up or disappear. Some commodities do not have a GUI. ›1mEnable›22m ›1mDisable›22m The commodity will be enabled or disabled. ›1mKill›22m Let the selected commodity remove itself in a clean way. ›1mListChg›22m ›1mUnique›22m The commodity is notified that the list has been changed or that another commodity with the same name was about to be added. This is only useful for programmers to test out their commmodities. ›1mUpdate›22m The list will be updated. ›1mPrint›22m This function allows you to send the list to printer or a selected file. ›1mPriority›22m This function allows you to change the priority of a commodity. ›1mRemove›22m Removes the selected commodity from the system. Please try a frienly remove before, using ›1mKill›22m. Maybe the commodity removes itself voluntarily. =;^) ›1mMore›22m Opens a window with further information. ›1mExit›22m Closes the window. Devices ======= A device is -- like a library (see Libraries) -- a collection of functions/procedures, which have to do certain jobs. E.g. the ›1mtrackdisk.device›22m includes functions for the floppy disk handling. Column items ------------ ›1mAddress›22m Address of the device structure ›1mln_Name›22m Name of a device ›1mln_Pri›22m Priority of a device ›1mOpenC›22m This element shows how often the device was opened. ›1mRPC›22m ›1m RPC›22m means ›1mRAM Pointer Count›22m and shows how many jump addresses of the device point into RAM. In this way many programs -- like the ›1msetpatch›22m command from Commodore -- patch the system. Many viruses patch the system in this way too, but don't panic now. If you check your system in regular intervals with a current virus killer, it should be out of danger. If the whole program code of the device is located in RAM, you will find a dash (minus sign) here, because in this case it's unimportant how many jump addresses point into RAM. ›1mln_Type›22m Type of this structure (usually ›1mdevice›22m) Actions ------- ›1mUpdate›22m If you select this gadget, the list of devices will be updated. ›1mPrint›22m This function allows you to send the list of ›1mDevices›22m to printer or a selected file. ›1mRemove›22m The selected device will be removed with this function provided that no program uses this device anymore and the ›1mOpenC›22m is zero. ›1mPriority›22m Herewith the priority of the device can be changed. A little window will be opened, that asks you for a new priority. Through the new priority it can happen that the device gets a new place in the device list. ›1mMore›22m Another window will be opened and you will see more informations about the selected device. You will have the same effect, if you doubleclick an element of the device list. ›1mFunctions›22m All device function offsets and addresses are shown up in a subwindow. If an appropriate ›1m.fd›22m file exists and an ›1mFD:›22m assign points to its directory, then you will also see the function names. ›1mExit›22m The ›1mDevices›22m window will be closed. Expansions ========== ›1m IMPORTANT:›22m All Scout releases before 2.10 are not compatible to this release! So if you want to read this list using TCP/IP, make sure that the remote system runs the latest version as well! This window shows a list about all your expansion boards (graphic boards, memory expansions and so on) too. Column items ------------ ›1mAddress›22m The address of the expansion structure. ›1mBoardAddr›22m Usually you will find the ROM of the card here. If this address points into RAM, the card is a memory expansion. ›1mType›22m Information about the board. See the More window for further information. ›1mManufacturer›22m Name of the board manufacturer. ›1mProduct›22m Name and class of the product. Additional information ---------------------- If you select one item from the list, the text field below shows up some additional information: ›1mSize›22m If the entry belongs to a memory expansion, the size of the memory is displayed here. Otherwise it's the ROM size of the card. ›1mFlags›22m See the More window. ›1mID›22m ManufacturerID, assigned by Commodore, followed by the Productnumber, assigned by the manufacturer of the board. ›1mSN›22m Serialnumber of the card (usually unused) Actions ------- ›1mPrint›22m This function allows you to send the list of ›1mExpansions›22m to printer or a selected file. ›1mMore›22m Now a window will be opened, that includes more informations about the selected expansion board. Doubleclick an element of the ›1mExpansions›22m list and you will have the same effect. ›1mExit›22m The ›1mExpansions›22m window will be closed. Unknown expansion boards ------------------------ If you select an expansion board by selecting its list item, you will get the name of the manufacturer and the card in the textfield you find below the list, provided that the installed version of ›1midentify.library›22m knows about these data. If no information is available in this textfield or the given information is wrong, you should send me the following data, please. 1. ManufacturerID (Manufacturer) 2. ProductID (Product) 3. Name of the company 4. Name of your expansion card 5. Function of your card If you send me these data, the next version of ›1mIdentify›22m will include your expansion boards. Please be as precise you can. Fonts ===== This function will show you all fonts existing in your system. Column items ------------ ›1mYSize›22m Vertical size of the font ›1mCount›22m Here you can see how many programs use the font. ›1mType›22m ›1m ROMFONT›22m means the font is located in ROM and ›1mDISKFONT›22m means the font was loaded from disk/harddisk. ›1mName›22m Name of the font Actions ------- ›1mUpdate›22m The list of fonts will be updated. ›1mPrint›22m This function allows you to send the list of ›1mFonts›22m to printer or a selected file. ›1mClose›22m The font will be closed by using this function. ›1mRemove›22m It is possible to remove a font from system, provided that no program uses it and it's no ›1mROMFONT›22m. ›1mExit›22m The ›1mFonts›22m window disappears. InputHandlers ============= Input handlers take care of all user input arriving in system (pressed keys, mouseclicks, inserted disks, etc.). They stand one behind the other like on a production line and analyze the user input. The input handler with the highest priority gets the `events' first and if it doesn't know how to react on these `events', the second input handler gets them, and so on. Usually the system input handler has a priority of 50. Every input handler, that wants to get the user input before the system, must have a higher priority. Column items ------------ ›1mln_Name›22m Name of the input handler ›1mln_Pri›22m Its priority ›1mis_Data›22m This address points to some data needed by the input handler. ›1mis_Code›22m The program code starts here. If the code is located in RAM, the address is of different color. Otherwise you can find the code in ROM. Some viruses install an input handler in system. In this case the ›1mis_Code›22m address points into RAM, but many other programs uses input handlers, too. Don't panic! Actions ------- ›1mUpdate›22m The list of input handlers will be updated when you select this gadget. ›1mPrint›22m This function allows you to send the list of ›1mInputHandlers›22m to printer or a selected file. ›1mRemove›22m Removes an input handler from system. ›1mPriority›22m Changes the priority of an input handler. ›1mExit›22m The window will be closed. Interrupts ========== Interrupts are important events the computer system has to react on. It exists a list of interrupt routines for each interrupt type. If a certain interrupt occurs, all these interrupt routines will be called. During their execution the running program will be interrupted. Column items ------------ ›1mln_Name›22m Name of the interrupt ›1mln_Pri›22m Its priority ›1mis_Data›22m At this address you find the data of the interrupt. ›1mis_Code›22m Address of the interrupt code. If this address points into RAM, it's of a different color. ›1mNUM›22m This number represents the type of event the interrupt routine is called on. The ›1mIntName›22m you find in the interrupt detail window gives you a little bit more information about it. ›1m Example:›22m Number 5 means that the interrupt is called at every vertical blank interval. Actions ------- ›1mUpdate›22m The list of interrupts will be updated. ›1mPrint›22m This function allows you to send the list of ›1mInterrupts›22m to printer or a selected file. ›1mRemove›22m If the interrupt is a server you can remove it from system. An interrupt handler can't be removed by ›1mScout›22m. If you call ›1mavail flush›22m and the audio.device isn't used, the interrupt handlers of the audio.device will be removed. ›1mMore›22m Now a window will be opened that includes more details of the interrupt. ›1mExit›22m Selecting this gadget will close the ›1mInterrupts›22m window. Libraries ========= A library is a collection of functions/procedures, which have to do certain jobs. E.g. the `graphics.library' includes routines for graphical display. Column items ------------ ›1mAddress›22m Adress of the library structure ›1mln_Name›22m Name of a library ›1mln_Pri›22m Priority of a library ›1mOpenC›22m Here you see, how often the library was opened. ›1mRPC›22m ›1m RPC›22m means ›1mRAM Pointer Count›22m and shows how many jump addresses of the library point into RAM. In this way many programs -- like the ›1msetpatch›22m command from Commodore -- patch the system. Many viruses patch the system in this way too, but don't panic now. If you check your system in regular intervals with a current virus killer, it should be out of danger. If the whole program code of the library is located in RAM, you will find a dash (minus sign) here, because in this case it's unimportant how many jump addresses point into RAM. ›1mln_Type›22m Type of this structure (usually ›1mlibrary›22m) Actions ------- ›1mPriority›22m Herewith the priority of the library can be changed. A little window will be opened, that asks you for a new priority. Through the new priority it can happen that the library gets a new place in the list of libraries. ›1mClose›22m A library must be closed by all programs, if you want to remove it from system. In this case the ›1mOpenC›22m is zero. If you select this function, you will be asked, how often you want to close it. You can choose between ›1mOnce›22m and ›1mAll›22m. Select ›1mAll›22m and the library will so often be closed till the ›1mOpenC›22m is zero. ›1mRemove›22m The selected library will be removed with this function provided that no program uses this library anymore and the ›1mOpenC›22m is zero. Some libraries can't be removed from system without a reset. So you shouldn't wonder about it, if this happens. ›1mFunctions›22m All library function offsets and addresses are shown up in a subwindow. If an appropriate ›1m.fd›22m file exists and an ›1mFD:›22m assign points to its directory, then you will also see the function names. ›1mUpdate›22m The list of libraries will be updated. ›1mPrint›22m This function allows you to send the list of ›1mLibraries›22m to printer or a selected file. ›1mMore›22m A window will be opened that includes more details of the library. ›1mExit›22m Selecting this gadget will close the ›1mlibrary›22m window. Locks ===== A lock structure shows you, that a program reads from or perhaps write into a file or a directory. With this type of structure the system prevents, that a file will be deleted while another program gets some data from it. Column items ------------ ›1mAccess›22m Here you can see the type of access. This could be ›1mREAD›22m, ›1mWRITE›22m or ›1mOWN›22m. ›1mOWN›22m stands for a lock ›1mScout›22m created to get the elements of this list. ›1mPath›22m Path of the file or directory Actions ------- ›1mUpdate›22m The list of ›1mLocks›22m will be updated. ›1mPrint›22m This function allows you to send the list of ›1mLocks›22m to printer or a selected file. ›1mRemove›22m A lock will be removed through dos.library's `UnLock()' function. ›1mPattern›22m If you give ›1mScout›22m a pattern, only the locks with a matching path will be shown. ›1mExit›22m The ›1mLocks›22m window will be closed. LowMemory ========= This list contains all low memory handler known to the system. These handlers are called in their sequence if a memory allocation is about to fail due to missing resources. The handlers try to free as much unused memory space as possible. `ramlib' is such a low memory handler removing unused libraries and devices from the system's memory. It is always present. ›1m Note:›22m Low memory handlers are only available since AmigaOS 3.0. On older systems this list will always be empty. Column items ------------ ›1mAddress›22m Address of the low memory handler structure. ›1mln_Name›22m Name of the handler. ›1mln_Type›22m Type of the handler. ›1mln_Pri›22m Priority of the handler. All handlers are called in their priority sequence. ›1mis_Data›22m A pointer to some handler's private data. ›1mis_Code›22m A pointer to the low memory handler code. Actions ------- ›1mUpdate›22m The list will be actualized. ›1mPrint›22m This function allows you to send the list to printer or a selected file. ›1mRemove›22m The low memory handler will be removed from system. ›1mPriority›22m Changes the priority of the selected handler. ›1mExit›22m The window will be closed. Memory ====== In this list you will find the segments of your memory. At least you will find an entry for your chip memory. Column items ------------ ›1mln_Name›22m Name of the memory segment (e.g. ›1mchip memory›22m) ›1mln_Pri›22m Priority of memory ›1mmh_Lower›22m First address of memory ›1mmh_Upper›22m Last address of memory Actions ------- ›1mPrint›22m This function allows you to send the list of the memory segments to printer or a selected file. ›1mPriority›22m This function allows you to change the priority of a memory segment. The memory segment with the highest priority will be preferred from system, provided that no certain type of memory is demanded. ›1mMore›22m Another window will be opened. This window includes more information about the memory segment. ›1mExit›22m The window will be closed. Mounted Devices =============== In this list you will find all your devices like disk drives, printer devices, etc. Column items ------------ ›1mName›22m Name of the device ›1mUnit›22m Unit number ›1mHeads›22m Number of heads ›1mCyl›22m Number of cylinders ›1mState›22m The state shows you for example, if a disk is in drive. ›1mDiskType›22m Type of a disk (e.g. OFS (OldFileSystem), FFS (FastFileSystem), ...) ›1mHandler or Device›22m The handler or the device you find here has to manage the stream of data from and to the device. Actions ------- ›1mUpdate›22m The list will be updated. ›1mPrint›22m This function allows you to send the list of ›1mMounted Devs›22m to printer or a selected file. ›1mExit›22m The window will be closed. Ports ===== Programs are able to communicate together through ports. Column items ------------ ›1mAddress›22m Here you will find the port structure. ›1mln_Name›22m Name of port ›1mln_Pri›22m Priority of port ›1mmp_SigTask›22m The task is communicating through the port. Actions ------- ›1mUpdate›22m The ports list will be updated. ›1mPrint›22m This function allows you to send the list of ›1mPorts›22m to printer or a selected file. ›1mRemove›22m The port will be removed. ›1mPriority›22m Herewith the port priority can be changed. ›1mExit›22m The ›1mPorts›22m window will be closed. Resident Commands ================= This list includes all resident commands. That means all commands you find in ROM and the commands you made `resident' through the ›1mresident›22m command. Positions and sizes of their hunks you will find here, too. Column items ------------ ›1mName›22m Name of the command ›1mUseCount›22m Here you can see, how often a command was being executed at the time the list was build. ›1mLower›22m First address of hunk in memory ›1mUpper›22m Last address of hunk in memory ›1mSize›22m Size of hunk (upper - lower - 8 bytes overhead) Actions ------- ›1mUpdate›22m The list of ›1mResident Commands›22m will be updated. ›1mPrint›22m This function allows you to send the list of ›1mResident Commands›22m to printer or a selected file. ›1mRemove›22m The selected command will be removed with this function provided that no program uses this command anymore and the ›1mUseCount›22m is zero. ›1mExit›22m The window disappears. Residents ========= Resident modules are reset-protected segments (code and data). In the list of ›1mResidents›22m you usually find libraries, devices and resources. A programmer has the possibility to make his own programs reset-protected. He has to initialize a resident structure for it and then he can link the program through the kick-vectors (see Vectors) to the list of the resident modules. The residents you linked to system are usually located in RAM and are of a different color. If you find a resident module that points into RAM and you don't know which program has created it, you should start your favourite virus detector and let it check your memory. Many viruses prefer this way to travel around. Column items ------------ ›1mAddress›22m At this address the resident module is located. ›1mln_Name›22m Name of the resident module ›1mrt_Pri›22m Priority ›1mrt_IdString›22m Identity string of the resident module. Actions ------- ›1mUpdate›22m The list of ›1mResidents›22m will be updated. ›1mPrint›22m This function allows you to send the list of ›1mResidents›22m to printer or a selected file. ›1mMore›22m Selecting this gadget opens a new window with more information about the selected resident module. ›1mExit›22m The ›1mResidents›22m window will be closed. Resources ========= Usually a resource is -- like a library (see Libraries) -- a collection of functions/procedures, which have to do certain jobs. E.g. the `filesystem.resource' includes functions for the filesystem handling. Column items ------------ ›1mAddress›22m Address of the resource structure ›1mln_Name›22m Name of a resource ›1mln_Pri›22m Priority of a resource ›1mOpenC›22m This element shows how often the resource was opened. ›1mRPC›22m ›1m RPC›22m means ›1mRAM Pointer Count›22m and shows how many jump addresses of the resource point into RAM. In this way many programs -- like the ›1msetpatch›22m command from Commodore -- patch the system. Many viruses patch the system in this way too, but don't panic now. If you check your system in regular intervals with a current virus killer, it should be out of danger. If the whole program code of the resource is located in RAM, you will find a dash (minus sign) here, because in this case it's unimportant how many jump addresses point into RAM. ›1mln_Type›22m Type of this structure (usually ›1mresource›22m) Actions ------- ›1mUpdate›22m The list of ›1mResources›22m will be updated. ›1mPrint›22m This function allows you to send the list of ›1mResources›22m to printer or a selected file. ›1mRemove›22m The selected resource will be removed with this function, provided that no program uses it anymore and the ›1mOpenC›22m is zero. ›1mPriority›22m Herewith the priority of the resource can be changed. A small window will be opened, that asks you for a new priority. Through the new priority it can happen that the resource gets a new position in the list of resources. ›1mMore›22m Select this gadget and you get a new window with more information about the selected resource. ›1mFunctions›22m All resource function offsets and addresses are shown up in a subwindow. If an appropriate ›1m.fd›22m file exists and an ›1mFD:›22m assign points to its directory, then you will also see the function names. Note that some resources do not have functions. ›1mExit›22m The ›1mResources›22m window will be closed. ›1m Please note:›22m If you should find three dashes (minus signs) at ›1mOpenC›22m and/or ›1mRPC›22m, the resource has no typical library structure. This happens for example at the `FileSystem.resource'. ScreenMode ========== Screen modes define all monitor resolutions that the system is able to show up. You surely have already selected a screen mode before. In this list, you will find all available modes. Most of the programs filter out some of them when they do not meet their purpose. Column items ------------ ›1mModeID›22m An identification number, unique to each mode. ›1mWidth›22m Nominal width of the resolution in pixeln. ›1mHeight›22m Nominal height of the resolution in pixeln. ›1mDepth›22m Maximum number of planes. The amount of colors which can be simultaneously displayed depends on this. ›1mScreenMode›22m Name of the screen mode. Some modes do not have a real name, so Scout will generate it. Then it might differ from the name generated by other programs or screen mode requesters. Actions ------- ›1mUpdate›22m The list will be updated. ›1mPrint›22m This function allows you to send the list to printer or a selected file. ›1mMore›22m Further information about the screen mode are displayed in a subwindow. This includes the overscan resolutions and the frequencies. Due to an inaccuracy of the operating system, the real frequencies might be a little bit different to those displayed. ›1mExit›22m The window will be closed. Semaphores ========== The use of semaphores is a way of single-threading critical sections. For example only one program is allowed to use the printer at one time, otherwise the texts would be mixed. Column items ------------ ›1mln_Name›22m Name of a semaphore ›1mNest›22m This item counts how often the semaphore has been obtained by the owner task. ›1mQueue›22m This counter shows you, how many programs want to obtain the semaphore. ›1mOwner›22m Here you will find the name of the task that owns the semaphore. Actions ------- ›1mUpdate›22m The list of ›1mSemaphores›22m will be updated. ›1mPrint›22m This function allows you to send the list of ›1mSemaphores›22m to printer or a selected file. ›1mObtain›22m This function is used to gain access to a semaphore. The ›1mNestCnt›22m will be increased at one by this call. ›1mRelease›22m Herewith you can make a signal semaphore available to others. ›1mExit›22m The ›1mSemaphores›22m window will be closed. System ====== Actions ------- ›1mPrint›22m This function allows you to send the list to printer or a selected file. ›1mExit›22m The window will be closed. Entry items ----------- In this window you will find some (partially technical) information about your computer. Please excuse the ordinary look of the window, but it is very easy to add more lines this way. Tasks ===== In this window you find a list of all tasks and processes being in system. Each program you start will be executed as a task or process. Column items ------------ ›1mln_Name›22m Name of the task/process ›1mln_Type›22m Type of the structure (›1mtask›22m or ›1mprocess›22m) ›1mln_Pri›22m Priority of the task/process ›1mNUM›22m If a non detaching program was started from shell, you will find here the number of the process. Programs you started from Workbench have a dash here. ›1mState›22m Here you see the state of the task or process. You will find Scout's own process on the top of the list with a ›1mrun›22m at this place, because this process is always running when it gets the task list. ›1m ready›22m means the task wants to work, but it's interrupted by the execution of another task. A task that is waiting for a certain signal is in the state ›1mwait›22m. In this case it doesn't need processing time. ›1mSigWait›22m Signalmask the task is waiting for. Actions ------- ›1mPrint›22m This function allows you to send the list of ›1mTasks›22m to printer or a selected file. ›1mFreeze›22m With this function you freeze the selected task. It can still be found in the list of tasks, but it gets no processing time from system. ›1m Warning:›22m If you try to freeze tasks essential to the system like `input.device', you should have saved all important data, cause a RESET is the only way out! ›1mActivate›22m A frozen task can be activated here. ›1mCPU›22m Here you will find a text field and a cycle gadget. This text field displays -- dependent on the state of the cycle gadget -- the CPU load in percent. For the cycle gadget you can choose between three states: ›1moff›22m In this case the CPU load won't be displayed. If you select another state, ›1mScout›22m will patch some system functions to calculate the CPU load of all tasks. ›1mfull›22m If you select this state, ›1mScout›22m sets the real cpu load to 100%. That means the total of the CPU loads of all tasks and processes will be 100%. Therefore nothing will be displayed in the text field. ›1min %›22m ›1m Scout›22m starts a task named ›1m« Scout's cheat task »›22m to calculate the real CPU load and it will be displayed in the text field. ›1mSecs›22m This string gadget allows you to set the intervall time for updating of the CPU load display. ›1mUpdate›22m The list will be updated. ›1mRemove›22m A task will be removed from the list. You should prefer the freeze function, if you perhaps need this task again. See also ›1mBreak›22m! ›1mSignal›22m If you select a signal mask, it will be send to the task. ›1mBreak›22m A signal mask that includes the signals CTRL-C and CTRL-D will be send to the task you selected. Many tasks and processes end, if they receive these signals. ›1mPriority›22m The priority of a task can be changed with this function. ›1mMore›22m Selecting this gadget will open another window that displays more informations about the task or the process. ›1mExit›22m The window will be closed. Timer ===== This window lists all current requests of the timer.device. Column items ------------ ›1mAddress›22m Address of the IO request structure. ›1mReplyPort›22m Address of the port the request will be replied to. ›1mTime›22m Time that this request will stay in this list. ›1mUnit›22m There are two different measures: VBlank (which has less overhead) and MicroHz (which is more accurate). ›1mTask›22m Name of the requesting task. Actions ------- ›1mPrint›22m This function allows you to send the list to printer or a selected file. ›1mUpdate›22m The list will be updated. ›1mExit›22m The window will be closed. Vectors ======= Actions ------- ›1mUpdate›22m The displayed vectors will be updated. ›1mPrint›22m This function allows you to send the list of ›1mVectors›22m to printer or a selected file. ›1mExit›22m The window will be closed. Reset Vectors ------------- A program can make itself reset-protected by using the reset vectors. If the vectors are unused, they have a value of zero. The programs which use the Kick-Vectors (KickTagPtr, KickMemPtr and KickCheckSum) can also be found in the list of resident structures. See also Residents. Auto Vector Interrupts ---------------------- In a computer system with a MC68000 processor you will find the seven ›1mAuto Vector Interrupts›22m from address $64 to address $7c. Higher processors (MC68010, etc.) have the VBR (Vector Base Register) that allows you to move the interrupt table to FAST-MEM. The system will be a little bit faster then. ›1mScout›22m uses the VBR if it exists. Interrupt Vectors ----------------- Here you see 16 interrupt vectors (IntVecs). These vectors are located in the `ExecBase' (base structure of the exec.library). Windows ======= All screens with the windows opened on them are listed here. Screens are of a different color as windows. Column items ------------ ›1mPos(x,y)›22m x and y position of the screen/window ›1mSize(x,y)›22m x and y size of the screen/window ›1mTitle›22m Title of the screen/window Actions ------- ›1mUpdate›22m The list will be updated. ›1mPrint›22m This function allows you to send the list of ›1mWindows›22m to printer or a selected file. ›1mClose›22m With this function it is possible to close screens and/or windows. If you close a screen, all windows on it will be closed too. ›1mTo Front›22m The selected screen/window will be popped to front. ›1mMore›22m If you select this gadget another window will be opened that displays more informations about the window or the screen. ›1mExit›22m The window will be closed. Patches ======= All patches currently installed in the system are listed here. Column items ------------ ›1mLibrary›22m Name of the patched resource ›1mOffset›22m Decimal and Hex offset of the patched function ›1mFunction›22m Name of the patched function. This name is obtained from the accoring .fd file. ›1mState›22m Current state of the patch. This can either be ›1mactive›22m, ›1mdisabled›22m or ›1mremoved›22m. ›1mPatcher›22m Name of the program that applied this patch. Actions ------- ›1mUpdate›22m The list will be updated. ›1mPrint›22m This function allows you to send the list of ›1mPatches›22m to printer or a selected file. ›1mEnable›22m If you select this gadget the selected (disabled) patches will be enabled again. ›1mDisable›22m If you select this gadget the selected (enabled) patches will be disabled. ›1m Warning:›22m This is a very dangerous action!! Please read the SaferPatches documentation! ›1mExit›22m The window will be closed. Catalogs ======== All locale catalogs currently loaded are listed here. Column items ------------ ›1mcat_Version›22m Version number of the catalog file. ›1mcat_Language›22m Language of the catalog file. ›1mcat_Name›22m Name of the catalog file. Actions ------- ›1mUpdate›22m The list will be updated. ›1mPrint›22m This function allows you to send the list of ›1mCatalogs›22m to printer or a selected file. ›1mExit›22m The window will be closed. AudioModes ========== All AHI audiomodes are listed here. Column items ------------ ›1mID›22m ModeID of the AudioMode. ›1mName›22m Name of the AudioMode. ›1mBits›22m Bits per sample. ›1mmin Freq›22m Minimum mixing frequency. ›1mmax Freq›22m Maximum mixing frequency. Actions ------- ›1mUpdate›22m The list will be updated. ›1mPrint›22m This function allows you to send the list of ›1mPatches›22m to printer or a selected file. ›1mMore›22m Selecting this gadget will open another window that displays more informations about the AudioMode. ›1mExit›22m The window will be closed. Scout and AmiTCP ================ This section will show you what you have to do for using ›1mScout›22m as a TCP/IP service through ›1mAmiTCP›22m. Nearly all functions of ›1mScout›22m can also be used via ›1mAmiTCP›22m. Now some knowledge will be assumed. If you don't know, what kind of program ›1mAmiTCP›22m represents, you should read ›1mAmiTCP's›22m user's manual before. (See also AmiTCP.) If you have installed ›1mAmiTCP›22m, you can use ›1mScout›22m as client and server. Except the installed programs of ›1mAmiTCP›22m you don't need another program for using ›1mScout›22m on networks. If you want to make your computer available for other systems on the network, you have to do following two steps: 1. Add the line ›1mscout 6543/tcp›22m to file ›1mAmiTCP:db/services›22m. 2. Now please add the line ›1mscout stream tcp nowait root dh0:scout›22m to file ›1mAmiTCP:db/inetd.conf›22m. Make sure that the path at the end of this line is the right path for ›1mscout›22m. That's it! If you start ›1mAmiTCP›22m now, your computer is available for other systems through using the options ›1mHOST›22m, ›1mUSER›22m and ›1mPASSWORD›22m. ›1mExample:›22m If I want perform some actions on some system structures of my own system for example, I have to start ›1mScout›22m through something like: 1> scout HOST crash.north.de USER atte PASSWORD secret If you leave out option ›1mPASSWORD›22m, you will be asked for the correct password through the ›1mpassword:›22m prompt. In this case nobody can see your password, because it won't be displayed in shell. If you don't use option ›1mUSER›22m, ›1mAmiTCP›22m takes the username that is actually available in system. The usage of ›1mAmiTCP›22m doesn't provide the installation of ›1mMUI›22m. All of ›1mScout's›22m shell commands (see also Commands) can be used via network through ›1mAmiTCP›22m. ›1mExample:›22m If I want to get the task list of my system, I have to use something like: 1> scout HOST crash.north.de USER atte PASSWORD secret Tasks You and all other users must always identify themselves through their usernames (option ›1mUSER›22m) and their passwords (option ›1mPASSWORD›22m). It's also possible to allow or deny certain systems the usage of some services through the file ›1mAmiTCP:db/inet.access›22m. See also the user's manual of ›1mAmiTCP›22m. If you want to get more informations about the implemented options and commands, you should also see Options and Commands. ›1m NOTE:›22m Please take care that the remote system runs the latest Scout version as well, to avoid incompatibilities. Scout without MUI ================= Nearly all through the graphical user interface available functions of ›1mScout›22m are also available via shell. Therefore you don't really need ›1mMUI›22m for using ›1mScout›22m. But if you want to use ›1mScout's›22m graphical user interface, you must have ›1mMUI›22m in your system. Options ******* There are some options for ›1mScout›22m which you can use, when you start the program. The following options are available from shell and as tool types from Workbench. ›1mICONIFIED›22m ›1m Usage:›22m ›1mICONIFIED›22m If this option is activ, ›1mScout›22m starts iconified. ›1mPORTNAME›22m ›1m Usage:›22m ›1mPORTNAME›22m=PORTNAME The name of Scout's ARexx port can be changed into PORTNAME. Without this option the ARexx port is called `SCOUT.X'. The ›1mX›22m stands for a decimal number that will be incremented, if a so called port already exists. ›1mTOOLPRI›22m ›1m Usage:›22m ›1mTOOLPRI›22m=VALUE This option allows you to change the priority of Scout's process into VALUE. ›1mSTARTUP›22m ›1m Usage:›22m ›1mSTARTUP›22m=COMMAND The variable COMMAND should be an ARexx script or a single ARexx command. Both (script or command) will be executed, when ›1mScout›22m will be started. In this way you can open more than only the main window by starting. Try for example the command ›1mOpenWindow Tasks›22m and you will get two windows by starting (the main window and the task list window). (See also Commands.) ›1mINTERVALTIME›22m ›1m Usage:›22m ›1mINTERVALTIME›22m=SECONDS This options allows you to save your preferred update time for the list of tasks. (See also Tasks.) ›1mCPUDISPLAY›22m ›1m Format:›22m ›1mCPUDISPLAY›22m=VALUE Through the variable VALUE you can select the state of the ›1mCPU›22m cycle gadget you find in the ›1mTasks›22m window. (See also Tasks.) * ›1m1›22m means ›1mCPU: full›22m * ›1m2›22m means ›1mCPU: in %›22m ›1mHOST›22m ›1m Format:›22m ›1mHOST›22m=HOSTNAME This options allows you to specify the system (HOSTNAME) you want to manipulate via network through ›1mAmiTCP›22m. ›1mUSER›22m ›1m Format:›22m ›1mUSER›22m=USERNAME You have to use this option to identify yourself by using ›1mScout›22m as a TCP/IP service. ›1mPASSWORD›22m ›1m Format:›22m ›1mPASSWORD›22m=PASSWORD Without a password ›1mScout›22m can't connect to another system via network. This option allows you to set the correct password. ›1mCOMMAND›22m ›1m Format:›22m ›1mCOMMAND›22m=COMMANDLINE Nearly all of ›1mScout's›22m implemented functions are available from shell through this option. You don't need the ›1mCOMMAND›22m key to use this option. (See also Commands.) ›1mSINGLEWINDOWS›22m ›1m Format:›22m ›1mSINGLEWINDOWS›22m Some users don't like to handle the many windows of Scout. This option solves the problem of too many windows. If this option is selected, only one list window and only one detail window is opened at a time. Scout's commands via ARexx and shell ************************************ ›1mScout›22m supports two kinds of commands: 1. commands only available from shell 2. commands available from ARexx and shell ARexx port ---------- It's a feature of ›1mMUI›22m to give each application its own ARexx port. Therefore ›1mScout›22m also has an ARexx port that usually has the name ›1mSCOUT.X›22m. The ›1mX›22m stands for a decimal number that will be incremented, if a so called port already exists. You will find the name of ›1mScout's›22m ARexx port in the window you get, if you select the ›1mProject/About›22m menu. Using tasknames: ---------------- If a task or a process was started from shell and hasn't detached itself, you will find the name of the command being executed, where usually the taskname is displayed. The real name of those tasks usually is something like ›1mBackground CLI›22m, but such a taskname isn't useful. ›1m Example:›22m If you start a non detaching task like ›1mDH0:Debug/Sushi›22m from shell, you will see ›1mDH0:Debug/Sushi›22m as taskname. Some ARexx commands need a taskname as parameter. You have to select those from CLI started self detaching tasks by using their command names like ›1mScout›22m displays them in the lists of tasks. Commands only available from shell ================================== ›1mHelp›22m ›1m Format:›22m ›1mHelp›22m This command is the most important one and it doesn't need parameters. If you try ›1mHelp›22m, ›1mScout›22m prints a list of all available commands to shell. =:^) Now 18 commands follow. These commands allow the user to get all lists of system structures from shell. Therefore you only need to install ›1mMUI›22m for using ›1mScout's›22m graphical user interface. Each of the following commands has a shortened form that stands behind the command in parentheses. ›1m Allocations›22m (a), ›1mBoopsiClasses›22m (b), ›1mCommands›22m (c), ›1mDevices›22m (d), ›1mTimer›22m (e), ›1mFonts›22m (f), ›1mAssigns›22m (g), ›1mInputHandlers›22m (h), ›1mInterrupts›22m (i), ›1mLowMemory›22m (j), ›1mCommodities›22m (k), ›1mLibraries›22m (l), ›1mMemory›22m (m), ›1mMounts›22m (n), ›1mLocks›22m (o), ›1mPorts›22m (p), ›1mResidents›22m (r), ›1mSemaphores›22m (s), ›1mTasks›22m (t), ›1mResources›22m (u), ›1mVectors›22m (v), ›1mWindows›22m (w), ›1mExpansions›22m (x), ›1mSystem›22m (y) and ›1mScreenMode›22m (z). ›1mExample:›22m To get the list of ports, you only have to use ›1mscout ports›22m or ›1mscout p›22m from shell. Commands available from ARexx and shell ======================================= ›1mFindTask›22m ›1m Usage:›22m ›1mFindTask›22m TASK This command allows you to check, if task TASK exists in system or not. The result is the address of the task TASK, if it has been found. TASK can be the name or the address of a task. ›1mFreezeTask›22m ›1m Usage:›22m ›1mFreezeTask›22m TASK The task TASKNAME will be frozen. After that it will still be found in system's task list, but then it doesn't need processing time. You can choose the name or the address of a task for TASK. ›1mActivateTask›22m ›1m Usage:›22m ›1mActivateTask›22m TASK If task TASK was frozen, it will be activated, otherwise an error occured. TASK is again a task's name or an address. ›1mRemoveTask›22m ›1m Usage:›22m ›1mRemoveTask›22m TASK This command removes the task TASK. It's lost forever. ›1mBreakTask›22m ›1m Usage:›22m ›1mBreakTask›22m TASK ›1m Scout›22m sends the task TASK a certain signal mask that includes the signals CTRL-C and CTRL-D. Many programs support these signals and finish themselves, if they receive one of them. ›1mSignalTask›22m ›1m Usage:›22m ›1mSignalTask›22m TASK HEXSIGNAL This command allows you to send a signal HEXSIGNAL to the task TASK. The signal must specified as a hexadecimal number. ›1m Example:›22m SendSignal 'scout' 0x001000 sends task ›1mscout›22m a CTRL-C and after that ›1mScout›22m ends. ›1mSetTaskPri›22m ›1m Usage:›22m ›1mSetTaskPri›22m TASK PRIORITY The task TASK gets a new priority (PRIORITY). ›1mRemovePort›22m ›1m Usage:›22m ›1mRemovePort›22m PORT The port PORT will be removed from ›1mScout›22m. PORT can be the name of a port or its address. ›1mGetLockNumber›22m ›1m Usage:›22m ›1mGetLockNumber›22m LOCKPATTERN This command returns the number of locks which have paths matching to the pattern LOCKPATTERN. ›1m Example:›22m Use the command GetLockNumber 'WORK:Utilities/#?' and you will know, how many locks are currently used for files in the directory ›1mWORK:Utilities/›22m. ›1mRemoveLocks›22m ›1m Usage:›22m ›1mRemoveLocks›22m LOCKPATTERN Use this command and all locks which have paths matching to the pattern LOCKPATTERN will be removed. (See also ›1mGetLockNumber›22m.) ›1mRemoveLock›22m ›1m Format:›22m ›1mRemoveLock›22m LOCKADDRESS The lock at adress LOCKADDRESS will be removed. ›1mFindNode›22m ›1m Usage:›22m ›1mFindNode›22m NODETYPE NODENAME This command allows you to find a certain node. You only have to know its name (NODENAME) and its type (NODETYPE). NODETYPE can have following values: ›1mLIBRARY›22m, ›1mDEVICE›22m, ›1mRESOURCE›22m, ›1mMEMORY›22m, ›1mSEMAPHORE›22m, ›1mPORT›22m or ›1mINPUTHANDLER›22m. ›1m Example:›22m If you want to get the address of the ›1mdisk.resource›22m you must use: FindNode RESOURCE 'disk.resource' ›1mGetPriority›22m ›1m Usage:›22m ›1mGetPriority›22m NODEADDRESS This command allows you to check the priority of a certain node structure. This includes all following structure types: tasks, libraries, devices, resources, ports, residents, input handlers, interrupts, semaphores and the elements of the memory list. You only have to know the address (NODEADDRESS) of that structure. ›1m Example:›22m The following ARexx commands store the priority of your chip memory in the variable ›1mpri›22m: FindName MEMORY 'chip memory' addr = result GetPriority addr pri = result ›1mSetPriority›22m ›1m Usage:›22m ›1mSetPriority›22m NODETYPE NODENAME If you want to change the priority of the node NODENAME, you can use this command. Again NODETYPE can have following values: ›1mLIBRARY›22m, ›1mDEVICE›22m, ›1mRESOURCE›22m, ›1mMEMORY›22m, ›1mSEMAPHORE›22m, ›1mPORT›22m or ›1mINPUTHANDLER›22m. ›1mCloseLibrary›22m ›1m Format:›22m ›1mCloseLibrary›22m LIBRARY The library LIBRARY will be closed once. LIBRARY can be the name of the library or its address. ›1mRemoveLibrary›22m ›1m Format:›22m ›1mRemoveLibrary›22m LIBRARY The library LIBRARY will be removed, if no program uses it. ›1mRemoveDevice›22m ›1m Format:›22m ›1mRemoveDevice›22m DEVICE The selected device DEVICE will be removed. For DEVICE use the name or the address of the device. ›1mRemoveResource›22m ›1m Format:›22m ›1mRemoveResource›22m RESOURCE The resource RESOURCE will be removed. ›1mObtainSemaphore›22m ›1m Format:›22m ›1mObtainSemaphore›22m SEMAPHORE This command allows you to obtain the given semaphore. SEMAPHORE can be the semaphore's name or address. ›1mReleaseSemaphore›22m ›1m Format:›22m ›1mReleaseSemaphore›22m SEMAPHORE The semaphore SEMAPHORE will be once released. ›1mRemoveSemaphore›22m ›1m Format:›22m ›1mRemoveSemaphore›22m SEMAPHORE You are able to remove the semaphore SEMAPHORE by using this command. ›1mRemoveInputhandler›22m ›1m Format:›22m ›1mRemoveInputhandler›22m INPUTHANDLER The input handler INPUTHANDLER selected through name or address will be removed. ›1mFindResident›22m ›1m Usage:›22m ›1mFindResident›22m RESIDENT This command returns the address of the resident structure RESIDENT. ›1mFindInterrupt›22m ›1m Usage:›22m ›1mFindInterrupt›22m INTERRUPTNAME The address of the interrupt INTERRUPTNAME will be returned. ›1mRemoveInterrupt›22m ›1m Format:›22m ›1mRemoveInterrupt›22m INTERRUPTNAME The interrupt you have selected through INTERRUPTNAME will be removed. ›1mFlushDevs›22m ›1m Usage:›22m ›1mFlushDevs›22m All not used devices will be removed. The used memory will be freed. ›1mFlushFonts›22m ›1m Usage:›22m ›1mFlushFonts›22m If a diskfont is in memory, but no program uses it, it will be removed. ›1mFlushLibs›22m ›1m Usage:›22m ›1mFlushLibs›22m All not used libraries will be removed. The used memory will be freed. ›1mFlushAll›22m ›1m Usage:›22m ›1mFlushAll›22m This function includes ›1mFlushDevs›22m, ›1mFlushFonts›22m and ›1mFlushLibs›22m. All not used devices, libraries and fonts will be removed and the used memory will be freed. ›1mClearResetVectors›22m ›1m Usage:›22m ›1mClearResetVectors›22m The six reset vectors will be cleared, if you select this function (see Vectors). ›1mPopToFront›22m ›1m Usage:›22m ›1mPopToFront›22m TITLE This command allows you to pop a screen or window to front. You only have to know its (TITLE). ›1mCloseWindow›22m ›1m Usage:›22m ›1mCloseWindow›22m WINDOWTITLE This command closes the window that is specified through its title (WINDOWTITLE). ›1mCloseScreen›22m ›1m Usage:›22m ›1mCloseScreen›22m SCREENTITLE If you select this command, the screen (SCREENTITLE) will be closed with all its windows. ›1mCloseFont›22m ›1m Format:›22m ›1mCloseFont›22m ADDRESS The font at address ADDRESS will be closed once. ›1mRemoveFont›22m ›1m Format:›22m ›1mRemoveFont›22m ADDRESS This command removes the font at address ADDRESS, if it's not used by any program. ›1mRemoveCommand›22m ›1m Format:›22m ›1mRemoveCommand›22m ADDRESS ›1m Scout›22m makes the resident command at address ADDRESS not resident. ›1mRemoveAssign›22m ›1m Format:›22m ›1mRemoveAssign›22m NAME With this command you're able to remove the assign NAME. ›1mRemoveAssignList›22m ›1m Format:›22m ›1mRemoveAssignList›22m NAME ADDRESS This command removes the directory at address ADDRESS from assign NAME. You will find the address of that directory in the list of assigns. ›1mPrintList›22m ›1m Format:›22m ›1mPrintList›22m LISTCHARACTER FILENAME This command allows you to print a list (specified by the listcharacter) into the file FILENAME. ›1m Example:›22m PrintList t 'ram:tasklist' will print the list of tasks into the file 'ram:tasklist'. ›1mOpenWindow›22m ›1m Usage:›22m ›1mOpenWindow›22m WINDOWID All windows you get if you select a gadget of ›1mScout's›22m main window, can be opened with this command. The WINDOWID is the same text you find on the main window gadgets. ›1m Example:›22m OpenWindow 'Mounted Devs' will open the window with the list of mounted devices. ›1mCxAppear›22m ›1mCxDisappear›22m ›1mCxEnable›22m ›1mCxDisable›22m ›1mCxKill›22m ›1mCxListChg›22m ›1mCxUnique›22m ›1m Format:›22m ›1mCx...›22m NAME Sends the command to the commodity named NAME. ›1mRemoveCx›22m ›1m Format:›22m ›1mRemoveCx›22m COMMODITY Removes the appropriate commodity from the list. Please consider this as `emergency break'. Use it only if ›1mCxKill›22m failed. ›1mSetCxPri›22m ›1m Format:›22m ›1mSetCxPri›22m COMMODITY PRIORITY Sets the priority of a commodity. ›1mRemoveClass›22m ›1m Format:›22m ›1mRemoveClass›22m CLASS The appropriate BOOPSI class is removed, if no objects and no subclasses are existing. How to get updates ================== The newest version of ›1mScout›22m should always be available on AmiNet or Public Domain collections, which are up-to-date. You can also find the latest version on my home page: http://www.is-koeln.de/einwohner/shred/ Credits ======= Now we have to thank some people for supporting the development of ›1mScout›22m on many different kinds: * Klaus `gizmo' Weber, he was always available to Atte and his many questions (not a few) during the programming of ›1mScout›22m. * Christian `cosinus' Stelter, he gave the permission to use his many manuals. * Stefan Stuntz for his great ›1mMagicUserInterface›22m * all (hopefully still) bug reporting and feature requesting people: Kai `wusel' Siering, Martin Hauner, Peter Meyer, Karl `Charly' Skibinski, Michael `Mick' Hohmann, Thore B"ockelmann, Bernardo Innocenti, Daniel Lundberg, ... and last but not least * all the others we've forgotten for reporting bugs, sending expansion boards data and so on. How to reach the author ======================= If you have questions, suggestions, bug reports or anything else, you can contact me at: Richard K"orber Hornstrasse 20 51465 Bergisch Gladbach - Germany - E-Mail: shred@chessy.aworld.de richard.koerber@koeln.netsurf.de Send E-Mails whenever possible.. If you want to contact Andreas Gelhausen, you can reach him at: Andreas Gelhausen Graf Spee Str. 23b 26123 Oldenburg - Germany - E-Mail: atte@crash.north.de Please do not contact him for bug reports, suggestions and similar. But if you feel the urge to send a gift, then he is the right address! That's it! =:^) Index ***** AHI ... AudioModes Allocations ... Allocations AmiTCP ... AmiTCP ARexx ... Commands ARexx port ... Commands Assigns ... Assigns AudioModes ... AudioModes Author Info ... Author Info Boards ... Expansions BoopsiClasses ... BoopsiClasses Catalogs ... Catalogs Command ... Commands Command Line Options ... Options Commodities ... Commodities Contents ... Copyright Copying ... Copyright Copyright ... Copyright Credits ... Credits Device names, logical ... Assigns Devices ... Devices DISKFONT ... Fonts Distribution ... Copyright Expansions ... Expansions Fonts ... Fonts FreeWare ... Copyright Handler, LowMemory ... LowMemory Hardware ... Expansions Identify ... Identify Input events ... InputHandlers InputHandlers ... InputHandlers Installation ... Installation Interrupts ... Interrupts Introduction ... Introduction Legalities ... Copyright Liability ... Copyright Libraries ... Libraries Limitation ... Copyright Locks ... Locks Logical device names ... Assigns LowMemory ... LowMemory MagicUserInterface ... MUI Main Window ... Using Scout Manufacturer ... Expansions Memory ... Memory Mounted Devices ... Mounted Devs MUI ... MUI No Warranty ... Copyright Options ... Options Patches ... Patches Ports ... Ports Processes ... Tasks RAM Pointer Count ... Devices Resident Commands ... Resident Cmds Residents ... Residents Resource allocation ... Allocations Resources ... Resources ROMFONT ... Fonts RPC ... Devices ScreenMode ... ScreenMode Screens ... Windows Semaphores ... Semaphores System ... System System Requirements ... System Requirements Tasknames ... Commands Tasks ... Tasks TCP/IP ... AmiTCP Timer ... Timer Tool Types ... Options Trademarks ... Copyright Updates ... Updates Using Scout ... Using Scout VBR ... Vectors Vectors ... Vectors Vertical blank interrupt ... Interrupts What is Scout? ... Introduction Windows ... Windows