Club Amiga de Montreal - CAM/CAM_CD_1.iso/files/514b.lha/sind_v3.03/sind.doc

Text File | 1991-06-08 | 6KB | 108 lines

SIND: System Info Display v3.03
by Mike Berro  25 Jul 89 [11 May 91]
(c)1989/91 by BCS Software  All Rights Reserved
P.O. Box 923113, Sylmar CA 91392-3113
CompuServe: 76004,2001 / PLink: M.BERRO
"1939" BBS at [phone] (multi-line)

If you find this program useful, amusing or informative, please let me
know, and in return I will send you information about our software and
hardware for professional video applications.  If you send me $15, I
will include a faster version of SIND (no "about" window), and the
shareware version of BARSNTONE(tm), which produces standard full-overscan
SMPTE color bars and a 1 kHz tone.

General Description
-------------------
   SIND allows you to peek into the Amiga Operating System ("OS") and
take snapshots of the current status.  This is especially useful for
programmers, who must make certain that their programs free all of
the resources they utilize when the user exits.  You can also analyze
what a particular program is doing to the OS.  The casual user may
get a kick out of discovering things such as that the Intuition Library
in 1.2 is up to revision 702, or that WordPerfect[tm] calls its tasks
"kashmir".
   I wrote (and re-wrote) SIND to hone my programming skills, and to
test some ideas in programming and user interface.  I would appreciate
comments and suggestions almost as much as the money.

Version 3 Features
------------------
   SIND now gives much more info.  The Task list includes priority, flags,
state, address, stack pointer, and signals allocated.  The Libraries and
Devices lists include version and revision, open count, flags, negative
size, positive size, checksum and the ID string.  Ports reveals the
priority, flags, signal bit and signal task address.
   Screens & Windows now displays the size and depth of each screen.
DOS Devices and Directories now list the priority, the task address,
the stack size and the handler name.  DOS Volumes now lists the creation
date and time, the task address and the lock list.
   Memory now shows the largest, and commas add to the readability of
the numbers.
   An added feature shows all fonts that are currently loaded into RAM,
and includes the size, style and flags.
   SIND now can optionally create its own 8 color screen, with or without
interlace, or can open its windows on the Workbench screen.  You can jump
from one mode to the other via a menu selection.  You can force SIND to
come up in a particular mode from either the Workbench (using ToolTypes)
or CLI (default mode is a custom non-interlaced screen).
   You can now have up to four SIND windows open at once.  Each window
title tells you the name of the info displayed, and the date and time
the info was collected.  Now that SIND updates a window only upon command,
you can visually compare "before" and "after" system states.  "Save" and
"Print" do not update the window.
   Each SIND window now updates only when you click inside the window, or
change display modes.  The time of the last update is displayed in the
window title, as is a description of what is being displayed.
  The SIND printout and saved files are better formatted, and include the
date and time that the information was collected.
  The SIND program is now almost 30K long.  Still, that's not too big
considering what it does.  The "bevelled" look uses only a few hundred
bytes, and no extra chip memory, so I'm leaving it in.

Menu Commands
-------------
New         Opens a new SIND window.  This selection is ghosted when four
            windows are open.
Save        Save the contents of the current window.  The file name is
            "SIND.docNN", where NN starts at "01" and increments to "99".
            SIND does not detect if the file already exists.  The file is
            created in the same directory as SIND when run from the Workbench,
            or in the current directory when run from the CLI.
Print       Prints the contents of the current window.  An extra line-feed
            is added at the bottom, but not a form-feed.
Close       Closes the current window.  Same as clicking on the CLOSEWINDOW
            gadget.  If it is the last window, SIND will exit.
Quit        Closes all SIND windows and exits.

The Display Menu selects what info is to be displayed in the current
window.  The info is not interpreted; it is "raw" data.  Check the RKM
for more information on what it all means, or just experiment.  You
cannot change any system parameters using SIND.

The Options Menu selects whether SIND opens windows on the Workbench screen,
or creates its own custom screen.  "SIND Screen" creates a 640x200x3 screen,
"Interlace" creates a 640x400x3 screen.  If you are unable to open four
windows in interlace mode, you have probably run out of CHIP memory.

Default Startup Options
-----------------------
   From CLI, add the letter "I" for interlace mode, or "W" for Workbench.
From Workbench, use the Info menu slecetion to change the Tool Types field.
Set "FLAGS=I" for interlace, or "FLAGS=W" for Workbench.

Miscellaneous Information
-------------------------
   SIND displays no error messages, but errors (insufficient memory for a
new window or file save problems) should not cause problems.
   If you want to permanently change the SIND custom screen colors, filezap
the program and look for the ascii text "Colors".  The next 8 words comprise
the color map.  Please don't distribute a modified version.
   In case you were wondering, SIND uses its own fast text routine, which
includes its own font for the data display.
   SIND windows are no longer GIMMEZEROZERO, so they are no longer slow.
   SIND has been tested on the 68020 and 68030, and on the Super Agnus, and
seems to work fine.
   SIND is 100% assembly language.  Most of the routines are reentrant,
so I suppose I could eventually make SIND resident.