home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format 69 / af069sub.adf / SIP / SIP.doc < prev    next >
Text File  |  1978-02-03  |  17KB  |  475 lines
  1.  
  2. ##
  3. ## For reading this file you may use :
  4. ##
  5. ##  Program-Name    available at
  6. ##
  7. ##  - ShowHyp       (e.g. coming with GadToolsBox V2.0c)
  8. ##  - Hyper         (AmigaLibDisks)
  9. ##  - AmigaGuide    (various Packages)
  10. ##  - MultiView     (Workbench)
  11. ##
  12.  
  13. ----------------------------------------------------------------------------------
  14. MAIN
  15. ----------------------------------------------------------------------------------
  16.  
  17.  
  18.                             SIP V2.20
  19.  
  20.                            - FREEWARE -
  21.  
  22.              © 1992-94 by Andreas R. Kleinert. All rights reserved.
  23.  
  24.               This program was written under OS V3.00 and is therefore
  25.               fully compatible. It needs OS V2.04+.
  26.               This program needs 'asl.library'      V37+
  27.                              and 'diskfont.library' V37+.
  28.               This program supports 'amigaguide.library' V39+.
  29.  
  30.               Release Date : 26.06.1994
  31.  
  32. 'Copyright'
  33. 'Disclaimer'
  34. 'Distribution'
  35. 'Function'
  36. 'Correspondence'
  37. 'System Information'
  38. 'History'
  39. 'More Copyrights'
  40.  
  41.  
  42. ----------------------------------------------------------------------------------
  43. Copyright
  44. ----------------------------------------------------------------------------------
  45.  
  46.     The program SIP V2.20 and its documentation files are
  47.     (C)opyright 1992-94 by Andreas R. Kleinert. All rights reserved.
  48.  
  49.  
  50. ----------------------------------------------------------------------------------
  51. Disclaimer
  52. ----------------------------------------------------------------------------------
  53.  
  54.     The author takes no responsibility for any results of the use of this
  55.     program.
  56.     This software is provided "AS IS" and there is no warranty of any kind,
  57.     so that you use this software at your own risk.
  58.  
  59.  
  60. ----------------------------------------------------------------------------------
  61. Distribution
  62. ----------------------------------------------------------------------------------
  63.  
  64.     The program SIP V2.20 is freely distributable (FREEWARE).
  65.     You may copy it, if the copyright notice is left intact and
  66.     all of its parts are included in the distribution.
  67.     This program must not be included in commercial packages or commercial
  68.     program collections without my written permission.
  69.     This program must not be sold in any way, but it is allowed to take
  70.     a nominal fee including the costs for copying.
  71.  
  72.     This program may be put on public domain disks or included in public
  73.     domain disk libraries.
  74.     Special permission hereby goes to Fred Fish's AmigaLib-Disks and
  75.     the german series (in alphabetical order) :
  76.     AmigaSzene, BerndsPD, FRANZ, GPD, SaarAG, TAIFUN and TIME.
  77.  
  78.     This program may also be distributed via electronic mail and may be
  79.     put into mailboxes as long as the redistribution conditions are
  80.     respected in all points.
  81.  
  82.     By using or distributing this program you automatically agree to
  83.     all of the above conditions and terms.
  84.  
  85.  
  86. ----------------------------------------------------------------------------------
  87. Function
  88. ----------------------------------------------------------------------------------
  89.  
  90.     Intention :
  91.     ===========
  92.  
  93.     "SIP" stands for "System Information Program".
  94.  
  95.     SIP may look very similar to other programs with similar intentions,
  96.     but has really nothing to do with them except of the task to fulfil.
  97.  
  98.     What I wanted to create, was a program that should bring the same comfort
  99.     to you as other programs, but which also should be compatible to the new
  100.     OS 2.04 and use the special features of the new Kickstart.
  101.  
  102.  
  103.     Function :
  104.     ==========
  105.  
  106.     SIP allows you to watch and manipulate most of the elementary parts of
  107.     the Operating System of your Amiga, as (e.g.) Tasks, Libraries, Devices,
  108.     Ports and Windows.
  109.     It also brings you the possibility of viewing some of the most important
  110.     vectors in the system and to clear them, to make sure to keep your system
  111.     free of viruses and all the other garbage which affects working with
  112.     your Amiga.
  113.  
  114.     SIP has been written under V3.00 of the AmigaOS and only runs under
  115.     OS V2.04+.
  116.  
  117.  
  118.     Usage :
  119.     =======
  120.  
  121.         Function-Overview :
  122.         -------------------
  123.  
  124.      Gadget              Function
  125.      ----------------------------------------------------------------------
  126.  
  127.      Tasks               Shows Tasks by name and more
  128.      Windows             Shows Screens and Windows by name
  129.      Libraries           Shows Libraries by name and more
  130.      Devices             Shows Devices by name and more
  131.      Resources           Shows Resources by name and more
  132.      Ports               Shows Ports by name and more
  133.      Residents           Shows Residents by name and more
  134.      Interrupts          Shows Interrupts by number and more
  135.      Vectors             Shows some vectors (CoolCapture, etc.)
  136.      Memory              Shows information about memory
  137.      Mount               Shows all mounted devices by name
  138.      Assign              Pops up a File-Requester to show assigns and volumes
  139.      Fonts               Pops up a Font-Requester to show all available fonts
  140.      Hardware            Gives some information about the Hardware
  141.  
  142.  
  143.      Action-Gadget       Function
  144.      ----------------------------------------------------------------------
  145.  
  146.      Remove!             a) Removes a Task/Window/Library/Device/Resource/
  147.                             Port or Interrupt.
  148.      Clear!              b) Clears Cold-/Cool- and WarmCapture entries in
  149.                             SysBase.
  150.  
  151.      Priority!           Sets new Priority for a Task/Library/Device/Resource/
  152.                          Port or Resident.
  153.  
  154.      <Close-Gadget>      (see Menus : "Quit")
  155.  
  156.  
  157.      Menu                   Function
  158.      ----------------------------------------------------------------------
  159.  
  160.      Project/Help           Opens the AmigaGuide Online-Help
  161.             /Info           Opens the Info-Window of SIP
  162.             /Start WB       Starts the Workbench
  163.             /Quit           Opens the Iconify-Requester
  164.      Switch/SIP Dos Tools   Switches to the "SIP Dos Tools"
  165.            /SuperView ...   Switches to SuperView-/SuperPlay-Library
  166.                             Resource Viewer
  167.  
  168.  
  169.      In the Iconify-Requester you may choose between three possibilities :
  170.  
  171.                            - Cancel                       1. Go back.
  172.  
  173.                                                           2. Iconify
  174.                            - O.K.                       /
  175.                                                         \
  176.                                                           3. Really Quit
  177.  
  178.  
  179.        Notes :
  180.        ~~~~~~~
  181.  
  182.        - "Iconify" saves some memory (GUI, Lists, etc.)
  183.  
  184.        - You may click on all the gadgets without destroying anything,
  185.          EXCEPT the following gadgets :
  186.  
  187.           - Remove!     Remove s.th., if s.th. is chosen
  188.           - Priority!   Set priority, if s.th. is chosen
  189.  
  190.        Here's an example, how to "Remove!" a Task from the system :
  191.  
  192.        Example :
  193.        ---------
  194.  
  195.                Action         Gadget / Text to select
  196.                --------------------------------------
  197.  
  198.                <Clicked on>   Tasks
  199.                <Selected>     "Background CLI"
  200.                <Clicked on>   Remove!
  201.  
  202.                Then you'll see, that the task "Background CLI" will have been
  203.                removed.
  204.  
  205.  
  206.      SIP Dos Tools :
  207.      ---------------
  208.  
  209.      In the Menu "SIP Dos Tools" you may view Bootblocks of Disks
  210.      (DF1: to DF3:) or format Disks or Dos-Volumes (DF1: bis DF3,
  211.      any Devices).
  212.  
  213.      Please note, that for formatting of 720 KB-Disks the appropriate
  214.      Handlers (PC0: bis PCx:) have to be mounted and that Quick-Formatting
  215.      of Amiga- to 720 KB-Disks or of 720 KB- to Amiga-Disks cannot work.
  216.      Therefore for this, as well as for new Disks, please select
  217.      Hard-Formatting.
  218.      Also the maximum length for the name of 720 KB-Disks is 12 characters :
  219.      the rest will be ignored.
  220.  
  221.      For Hard-Formatting "SYS:System/Format" is used.
  222.  
  223.  
  224.     Construction :
  225.     ==============
  226.  
  227.     - The surface of this program has been created under use of the famous
  228.       program "GadToolsBox V2.0c", written by Jan van den Baard.
  229.  
  230.     - Many of the functions of this program are to find as more powerful and
  231.       more complexe CLI-Commands in my CLI-/Shell-Package "AKCC", which is
  232.       SHAREWARE and to find on several Public Domain Series.
  233.       The current version/release number of AKCC is V3.03 (at the moment
  234.       with 35 commands).
  235.  
  236.  
  237. ----------------------------------------------------------------------------------
  238. Correspondence
  239. ----------------------------------------------------------------------------------
  240.  
  241.     If you like, you may send me some money. Perhaps this will motivate me
  242.     to continue programming such programs or just making updates of
  243.     this one. Send bug-reports, money or whatever to :
  244.  
  245.        Andreas R. Kleinert,
  246.        Grube Hohe Grethe 23,
  247.        D-57074 Siegen,
  248.        Germany.                      email : ...
  249.  
  250.  
  251. ----------------------------------------------------------------------------------
  252. SystemInformation
  253. ----------------------------------------------------------------------------------
  254.  
  255.     SIP was programmed on an Amiga 4000 with 68030EC (25Mhz),
  256.     4 MB, 85/260 MB IDE/AT-HD and OS 3.00 under SAS/C V6.51.
  257.  
  258.  
  259. ----------------------------------------------------------------------------------
  260. History
  261. ----------------------------------------------------------------------------------
  262.  
  263.      V2.20 : (26.06.1994, original-size : 42424 Bytes)
  264.      -------
  265.  
  266.       - ListView-List now dynamically allocated and delocated,
  267.         which also increases speed a lot !!
  268.       - now font-sensitive and PublicScreen-friendly
  269.  
  270.  
  271.      V2.18 : (03.06.1994, original-size : 41688 Bytes)
  272.      -------
  273.  
  274.       - full recompilation under use of SAS/C V6.51
  275.       - increased speed of clearing Main-ListView's Gadget Data
  276.       - WINDOWS : no more "NULL-POINTER" texts (now "[Untitled]")
  277.       - removed old "text style" docs, wrote new AmigaGuide-Files
  278.       - AmigaGuide-Documentation as OnLine-Help (localized) under V39+
  279.       - fixed problems with "Unit" values for "Handlers"
  280.       - various improvements
  281.  
  282.  
  283.      V2.17 : (20.02.1994, original-size : 41564 Bytes)
  284.      -------
  285.  
  286.       - full recompilation under use of SAS/C V6.5
  287.       - removed CXBREAK-replacement
  288.       - fixed Handler-StackSize again : was right before
  289.       - did much (internal) source-code optimization
  290.       - added new "Switch"-Menu, where the available SVObjects of
  291.         superview.library and SPObjects of superplay.library are
  292.         displayed together with some additional information
  293.       - and more
  294.  
  295.  
  296.      V2.16 : (21.11.1993, original-size : 39336 Bytes)
  297.      -------
  298.  
  299.       - SelectionDisplay-Gadget now TextGadget
  300.       - added KickTag-Display (Vectors)
  301.       - removing of Ports now depending on addresses, not on names
  302.       - improved Documentation a little bit
  303.       - more small enhancements
  304.  
  305.  
  306.      V2.15 : (31.10.1993, original-size : 39024 Bytes)
  307.      -------
  308.  
  309.       - use of SAS/C V6.3
  310.       - UNDERSCOREs for the Gadgets
  311.       - changes in Resident-Viewer
  312.       - removing of Windows AND Screens possible,
  313.         now depending on addresses, not on names
  314.       - removing of Tasks now depending on addresses, not on names
  315.       - ListView no longer shows (last) selected Item
  316.       - recognizes 68040 FPU
  317.       - former "FAST" memory values now interpreted as EXTended Memory
  318.       - fixed bug in memory size calculation
  319.       - updated documentation
  320.       - and many more improvements
  321.  
  322.  
  323.      V2.14 : (24.07.1993, original size : 36000 Bytes)
  324.      -------
  325.  
  326.       - use of GadToolsBox V2.0c (V37.300)
  327.       - removed SAS/C handling routines for CTRL-C/D (CXBREAK)
  328.       - AmigaGuide-Documentation
  329.  
  330.  
  331.      V2.12 : (10.06.1993, original size : 35692 Bytes)
  332.      -------
  333.  
  334.       - now with additional menupoint "SIP Dos Tools"
  335.         (integration of "KBoot V1.02" and "Well-Format V1.00") :
  336.          - Viewing of Bootblocks of Disks
  337.          - Diskformatting quick/hard, OFS/FFS ic
  338.            (quick : internal, hard : external ("SYS:System/Format") )
  339.       - improved error-handling in low-memory situations
  340.       - removed unnecessary code
  341.       - changed Task-Display
  342.       - changes in Residents-/Libraries-/Devices-/Handler-Viewer
  343.       - another bug-fix in the Resident-Viewer
  344.       - bug-fix in the Resource-Viewer
  345.  
  346.  
  347.      V2.06 : (12.05.1993, original size : 29708 Bytes)
  348.      -------
  349.  
  350.       - Hardware : added Agnus/Alice recognition. Not perfect so far !?
  351.       - the "Resident-View-WB-Known-Bug" now seems to be FINALLY fixed
  352.       - internal changes to the Interrupt-Routine
  353.       - some optimizations
  354.  
  355.  
  356.      V2.05 : (15.04.1993, original size : 29964 Bytes)
  357.      -------
  358.  
  359.       - Remove! : new Requester for Tasks/Processes :
  360.          1. RemTask
  361.          2. Break Task (CTRL-C, -D, -E or -F)
  362.       - Hardware : recognizes Denise-/Lisa-Chips via their ID
  363.       - new Menu for starting Workbench
  364.  
  365.  
  366.      V2.04 : (April 1993, original size : 28088 Bytes)
  367.      -------
  368.  
  369.       - Resident-Viewer still crashed sometimes. Bug hopefully fixed now.
  370.       - new abort-routine (V33-style Error-Requester, runs anywhere).
  371.       - found out, that Asl-Font-Requester at least needs "diskfont.library"
  372.         of OS V2.0x to pop up. Added note to Doc-File.
  373.  
  374.  
  375.      V2.03 : (original size : 27856 Bytes)
  376.      -------
  377.  
  378.       - improvements
  379.       - more informationen about Handler ("MOUNT" before)
  380.  
  381.  
  382.      V2.02 : (original size : 27668 Bytes)
  383.      -------
  384.  
  385.       - use of SAS/C V6.00
  386.       - fixed a bad bug, which occured under OS V3.0
  387.         (Kickstart V39.106, exec.library V39.47, intuition.library V39.2084,
  388.          gadtools.library V39.356), but _not_ under OS V2.04 !!!
  389.         If selected the ListView-Gadget, a "class&IDCMP_CLOSEWINDOW"
  390.         resulted in TRUE, although it should not.
  391.         This should have been filtered out by "GT_GetIMsg()", but was not.
  392.         Now using an absolutely clear "class==IDCMP_CLOSEWINDOW".
  393.       - added auto-activation
  394.       - re-added possibility to watch files in Assign-Requester
  395.       - fixed handling of Resident-IDs (might have been crashed, if no
  396.         valid ID-Pointer (or NULL) set), Forbid()/Permit()
  397.       - removed memory-values from "Hardware" and fixed those values in
  398.         "Memory" (so that "not FAST ..." is reported, if 0x00000000 is
  399.         found)
  400.       - changed/added some other things
  401.       - improved doc-file (even older revision-entries)
  402.  
  403.  
  404.      V2.01 : (original size : 27672 Bytes)
  405.      -------
  406.  
  407.       - added some "__aligned" statements
  408.       - fixed another (possible) bug-source in string-buffering
  409.       - closed silly "memory black-hole" in "Mount"-Option
  410.  
  411.  
  412.      V2.00 :
  413.      -------
  414.  
  415.       - changed name from "BRTM" to "SIP", to show that it is not just
  416.         a clone of other programs with its intention
  417.       - complete re-design of the Surface, because of use of
  418.         GadToolsBox V1.4 : code should be better now (less
  419.         "by hand"-changes because of multiple-windows technique).
  420.       - changes in Help- and Info-Window, as well as small
  421.         differences in quality of design.
  422.       - fixed a bug in string-buffering and conversion of strings
  423.         for Screen-Display
  424.         (perhaps this wasn't the last one ...)
  425.       - AGAIN : improvements on this doc-file
  426.         (yes, you are still reading it ...)
  427.  
  428.  
  429.      V1.05 :
  430.      -------
  431.  
  432.       - fixed some "surface" things ("More" now is fully obsolete),
  433.         changed some texts inside
  434.       - fixed a bad bug in clear-routine for gadgets
  435.       - consequent use of "__regargs" (SAS/C V5.10a/b)
  436.       - improves on this doc-file
  437.         (yes, this which you are reading now ...)
  438.       - Asl-Requester (for Assigns) now for Dirs only
  439.         (no selection of files possible any longer)
  440.       - Requesters are (should be) bigger
  441.  
  442.      V1.01 :
  443.      -------
  444.       - self-detaches from CLI/Shell by "cback.o"
  445.       - improved display of library-data
  446.       - more information about resources
  447.       - number of messages displayed, when "hanging" at ports
  448.       - "$VER"sion-string for use with the CLI-/Shell-Command "Version"
  449.       - closes the remaining stdio-window on the WB
  450.         (=> no longer error-texts on the WB, but in the CLI/Shell).
  451.  
  452.      V1.00 :
  453.      -------
  454.       - First and initial release.
  455.  
  456.  
  457.  
  458. ----------------------------------------------------------------------------------
  459. MoreCopyrights
  460. ----------------------------------------------------------------------------------
  461.  
  462.     Some of the mentioned names or products above may be copyrighted by
  463.     companies or trademarks of companies.
  464.  
  465.     More Copyrights :
  466.  
  467.     - "GadToolsBox" V2.0c is GIFTWARE and
  468.       © 1991-1993 by Jan van den Baard.
  469.     - "AKCC" V3.03 is SHAREWARE and
  470.       © 1990-94 by Andreas R. Kleinert.
  471.  
  472.  
  473.  
  474.  
  475.