@DATABASE SIP_Documentation @WIDTH 80 ## ## For reading this file you may use : ## ## Program-Name available at ## ## - ShowHyp (e.g. coming with GadToolsBox V2.0c) ## - Hyper (AmigaLibDisks) ## - AmigaGuide (various Packages) ## - MultiView (Workbench) ## @NODE MAIN "SIP V2.20 : Documentation" SIP V2.20 - FREEWARE - © 1992-94 by Andreas R. Kleinert. All rights reserved. This program was written under OS V3.00 and is therefore fully compatible. It needs OS V2.04+. This program needs 'asl.library' V37+ and 'diskfont.library' V37+. This program supports 'amigaguide.library' V39+. Release Date : 26.06.1994 @{"Copyright" LINK Copyright} @{"Disclaimer" LINK Disclaimer} @{"Distribution" LINK Distribution} @{"Function" LINK Function} @{"Correspondence" LINK Correspondence} @{"System Information" LINK SystemInformation} @{"History" LINK History} @{"More Copyrights" LINK MoreCopyrights} @ENDNODE @NODE "Copyright" The program SIP V2.20 and its documentation files are (C)opyright 1992-94 by Andreas R. Kleinert. All rights reserved. @ENDNODE @NODE "Disclaimer" The author takes no responsibility for any results of the use of this program. This software is provided "AS IS" and there is no warranty of any kind, so that you use this software at your own risk. @ENDNODE @NODE "Distribution" The program SIP V2.20 is freely distributable (FREEWARE). You may copy it, if the copyright notice is left intact and all of its parts are included in the distribution. This program must not be included in commercial packages or commercial program collections without my written permission. This program must not be sold in any way, but it is allowed to take a nominal fee including the costs for copying. This program may be put on public domain disks or included in public domain disk libraries. Special permission hereby goes to Fred Fish's AmigaLib-Disks and the german series (in alphabetical order) : AmigaSzene, BerndsPD, FRANZ, GPD, SaarAG, TAIFUN and TIME. This program may also be distributed via electronic mail and may be put into mailboxes as long as the redistribution conditions are respected in all points. By using or distributing this program you automatically agree to all of the above conditions and terms. @ENDNODE @NODE "Function" Intention : =========== "SIP" stands for "System Information Program". SIP may look very similar to other programs with similar intentions, but has really nothing to do with them except of the task to fulfil. What I wanted to create, was a program that should bring the same comfort to you as other programs, but which also should be compatible to the new OS 2.04 and use the special features of the new Kickstart. Function : ========== SIP allows you to watch and manipulate most of the elementary parts of the Operating System of your Amiga, as (e.g.) Tasks, Libraries, Devices, Ports and Windows. It also brings you the possibility of viewing some of the most important vectors in the system and to clear them, to make sure to keep your system free of viruses and all the other garbage which affects working with your Amiga. SIP has been written under V3.00 of the AmigaOS and only runs under OS V2.04+. Usage : ======= Function-Overview : ------------------- Gadget Function ---------------------------------------------------------------------- Tasks Shows Tasks by name and more Windows Shows Screens and Windows by name Libraries Shows Libraries by name and more Devices Shows Devices by name and more Resources Shows Resources by name and more Ports Shows Ports by name and more Residents Shows Residents by name and more Interrupts Shows Interrupts by number and more Vectors Shows some vectors (CoolCapture, etc.) Memory Shows information about memory Mount Shows all mounted devices by name Assign Pops up a File-Requester to show assigns and volumes Fonts Pops up a Font-Requester to show all available fonts Hardware Gives some information about the Hardware Action-Gadget Function ---------------------------------------------------------------------- Remove! a) Removes a Task/Window/Library/Device/Resource/ Port or Interrupt. Clear! b) Clears Cold-/Cool- and WarmCapture entries in SysBase. Priority! Sets new Priority for a Task/Library/Device/Resource/ Port or Resident. (see Menus : "Quit") Menu Function ---------------------------------------------------------------------- Project/Help Opens the AmigaGuide Online-Help /Info Opens the Info-Window of SIP /Start WB Starts the Workbench /Quit Opens the Iconify-Requester Switch/SIP Dos Tools Switches to the "SIP Dos Tools" /SuperView ... Switches to SuperView-/SuperPlay-Library Resource Viewer In the Iconify-Requester you may choose between three possibilities : - Cancel 1. Go back. 2. Iconify - O.K. / \ 3. Really Quit Notes : ~~~~~~~ - "Iconify" saves some memory (GUI, Lists, etc.) - You may click on all the gadgets without destroying anything, EXCEPT the following gadgets : - Remove! Remove s.th., if s.th. is chosen - Priority! Set priority, if s.th. is chosen Here's an example, how to "Remove!" a Task from the system : Example : --------- Action Gadget / Text to select -------------------------------------- Tasks "Background CLI" Remove! Then you'll see, that the task "Background CLI" will have been removed. SIP Dos Tools : --------------- In the Menu "SIP Dos Tools" you may view Bootblocks of Disks (DF1: to DF3:) or format Disks or Dos-Volumes (DF1: bis DF3, any Devices). Please note, that for formatting of 720 KB-Disks the appropriate Handlers (PC0: bis PCx:) have to be mounted and that Quick-Formatting of Amiga- to 720 KB-Disks or of 720 KB- to Amiga-Disks cannot work. Therefore for this, as well as for new Disks, please select Hard-Formatting. Also the maximum length for the name of 720 KB-Disks is 12 characters : the rest will be ignored. For Hard-Formatting "SYS:System/Format" is used. Construction : ============== - The surface of this program has been created under use of the famous program "GadToolsBox V2.0c", written by Jan van den Baard. - Many of the functions of this program are to find as more powerful and more complexe CLI-Commands in my CLI-/Shell-Package "AKCC", which is SHAREWARE and to find on several Public Domain Series. The current version/release number of AKCC is V3.03 (at the moment with 35 commands). @ENDNODE @NODE "Correspondence" If you like, you may send me some money. Perhaps this will motivate me to continue programming such programs or just making updates of this one. Send bug-reports, money or whatever to : Andreas R. Kleinert, Grube Hohe Grethe 23, D-57074 Siegen, Germany. email : ... @ENDNODE @NODE "SystemInformation" SIP was programmed on an Amiga 4000 with 68030EC (25Mhz), 4 MB, 85/260 MB IDE/AT-HD and OS 3.00 under SAS/C V6.51. @ENDNODE @NODE "History" V2.20 : (26.06.1994, original-size : 42424 Bytes) ------- - ListView-List now dynamically allocated and delocated, which also increases speed a lot !! - now font-sensitive and PublicScreen-friendly V2.18 : (03.06.1994, original-size : 41688 Bytes) ------- - full recompilation under use of SAS/C V6.51 - increased speed of clearing Main-ListView's Gadget Data - WINDOWS : no more "NULL-POINTER" texts (now "[Untitled]") - removed old "text style" docs, wrote new AmigaGuide-Files - AmigaGuide-Documentation as OnLine-Help (localized) under V39+ - fixed problems with "Unit" values for "Handlers" - various improvements V2.17 : (20.02.1994, original-size : 41564 Bytes) ------- - full recompilation under use of SAS/C V6.5 - removed CXBREAK-replacement - fixed Handler-StackSize again : was right before - did much (internal) source-code optimization - added new "Switch"-Menu, where the available SVObjects of superview.library and SPObjects of superplay.library are displayed together with some additional information - and more V2.16 : (21.11.1993, original-size : 39336 Bytes) ------- - SelectionDisplay-Gadget now TextGadget - added KickTag-Display (Vectors) - removing of Ports now depending on addresses, not on names - improved Documentation a little bit - more small enhancements V2.15 : (31.10.1993, original-size : 39024 Bytes) ------- - use of SAS/C V6.3 - UNDERSCOREs for the Gadgets - changes in Resident-Viewer - removing of Windows AND Screens possible, now depending on addresses, not on names - removing of Tasks now depending on addresses, not on names - ListView no longer shows (last) selected Item - recognizes 68040 FPU - former "FAST" memory values now interpreted as EXTended Memory - fixed bug in memory size calculation - updated documentation - and many more improvements V2.14 : (24.07.1993, original size : 36000 Bytes) ------- - use of GadToolsBox V2.0c (V37.300) - removed SAS/C handling routines for CTRL-C/D (CXBREAK) - AmigaGuide-Documentation V2.12 : (10.06.1993, original size : 35692 Bytes) ------- - now with additional menupoint "SIP Dos Tools" (integration of "KBoot V1.02" and "Well-Format V1.00") : - Viewing of Bootblocks of Disks - Diskformatting quick/hard, OFS/FFS ic (quick : internal, hard : external ("SYS:System/Format") ) - improved error-handling in low-memory situations - removed unnecessary code - changed Task-Display - changes in Residents-/Libraries-/Devices-/Handler-Viewer - another bug-fix in the Resident-Viewer - bug-fix in the Resource-Viewer V2.06 : (12.05.1993, original size : 29708 Bytes) ------- - Hardware : added Agnus/Alice recognition. Not perfect so far !? - the "Resident-View-WB-Known-Bug" now seems to be FINALLY fixed - internal changes to the Interrupt-Routine - some optimizations V2.05 : (15.04.1993, original size : 29964 Bytes) ------- - Remove! : new Requester for Tasks/Processes : 1. RemTask 2. Break Task (CTRL-C, -D, -E or -F) - Hardware : recognizes Denise-/Lisa-Chips via their ID - new Menu for starting Workbench V2.04 : (April 1993, original size : 28088 Bytes) ------- - Resident-Viewer still crashed sometimes. Bug hopefully fixed now. - new abort-routine (V33-style Error-Requester, runs anywhere). - found out, that Asl-Font-Requester at least needs "diskfont.library" of OS V2.0x to pop up. Added note to Doc-File. V2.03 : (original size : 27856 Bytes) ------- - improvements - more informationen about Handler ("MOUNT" before) V2.02 : (original size : 27668 Bytes) ------- - use of SAS/C V6.00 - fixed a bad bug, which occured under OS V3.0 (Kickstart V39.106, exec.library V39.47, intuition.library V39.2084, gadtools.library V39.356), but _not_ under OS V2.04 !!! If selected the ListView-Gadget, a "class&IDCMP_CLOSEWINDOW" resulted in TRUE, although it should not. This should have been filtered out by "GT_GetIMsg()", but was not. Now using an absolutely clear "class==IDCMP_CLOSEWINDOW". - added auto-activation - re-added possibility to watch files in Assign-Requester - fixed handling of Resident-IDs (might have been crashed, if no valid ID-Pointer (or NULL) set), Forbid()/Permit() - removed memory-values from "Hardware" and fixed those values in "Memory" (so that "not FAST ..." is reported, if 0x00000000 is found) - changed/added some other things - improved doc-file (even older revision-entries) V2.01 : (original size : 27672 Bytes) ------- - added some "__aligned" statements - fixed another (possible) bug-source in string-buffering - closed silly "memory black-hole" in "Mount"-Option V2.00 : ------- - changed name from "BRTM" to "SIP", to show that it is not just a clone of other programs with its intention - complete re-design of the Surface, because of use of GadToolsBox V1.4 : code should be better now (less "by hand"-changes because of multiple-windows technique). - changes in Help- and Info-Window, as well as small differences in quality of design. - fixed a bug in string-buffering and conversion of strings for Screen-Display (perhaps this wasn't the last one ...) - AGAIN : improvements on this doc-file (yes, you are still reading it ...) V1.05 : ------- - fixed some "surface" things ("More" now is fully obsolete), changed some texts inside - fixed a bad bug in clear-routine for gadgets - consequent use of "__regargs" (SAS/C V5.10a/b) - improves on this doc-file (yes, this which you are reading now ...) - Asl-Requester (for Assigns) now for Dirs only (no selection of files possible any longer) - Requesters are (should be) bigger V1.01 : ------- - self-detaches from CLI/Shell by "cback.o" - improved display of library-data - more information about resources - number of messages displayed, when "hanging" at ports - "$VER"sion-string for use with the CLI-/Shell-Command "Version" - closes the remaining stdio-window on the WB (=> no longer error-texts on the WB, but in the CLI/Shell). V1.00 : ------- - First and initial release. @ENDNODE @NODE "MoreCopyrights" Some of the mentioned names or products above may be copyrighted by companies or trademarks of companies. More Copyrights : - "GadToolsBox" V2.0c is GIFTWARE and © 1991-1993 by Jan van den Baard. - "AKCC" V3.03 is SHAREWARE and © 1990-94 by Andreas R. Kleinert. @ENDNODE