XSysStats README:

DESCRIPTION:

XSysStats is a system information display tool similar to perfmeter.  It
displays its information in the form of a strip chart.  It can also display
information about remote hosts, as perfmeter can do.

XSysStats can display any number of graphs at one time in the same window.
Information being displayed in the window need not be all of the same host.
For example, you could have it display the percentage of cpu being utilized
of half a dozen (or more) different hosts.  Also, splitting the window
into smaller windows is now supported (similar to what the perfmeter
in OW 3 allows)

The only system this has been tested on is a Sun 3/60 running SunOs 4.1.1,
x11R5 and X11R6.  I have gotten reports of it running on Sparc systems, also
Solaris 2.3, and a patch for NetBSD has also been put in.  It should also
compile on AIX systems.  For other systems, some porting may be required for
it to work.  XSysStats uses the 'rstat' function to get information.  This
probably does not exist on all machines, and the structure it uses may vary
between different machines.  See the PORTING file for more information on
how to port to different systems.

XSysStats requirs an ANSI compiler.  Gcc works fine, and Sun's acc also work
(but may result in warnings at compile time.)  For further information about
ANSI compile support, look below in the NOTES section.  Running some of the
programs that convert function declarations from ANSI to non ANSI may let it
compile on non ANSI systems, but I do not guarentee that this will work.

There are some things that perfmeter (Openwindows 2 version) is able to do
that XSysStats can not do.  Perfmeter in its iconic form displays a meter
with hands. XSysStats only displays information while in its open state.
Also, perfmeter allows the user to change what information it displays, or
how frequently it updates it.  Once XSysStats has been run, what it displays
is locked into place.

XSysStats does have the advantage that the only X library it uses is the
base X11 library.  This means the resident size is smaller than perfmeter (a
lot of space can be saved if you run several perfmeters, as these could then
be combined into one XSysStats window) XSysStats in general consumes less
CPU time than perfmeter does (an XSysStats program displaying four graphs
about one machine takes less than half the time a perfmeter took displaying
just one graph.)  However, for reasons I have not figured out, it seems to
consume more CPU time than perfmeter if reporting on remote hosts.  Even
with this increased cost, it only accounted for about 1.5% of the cpu time on
my sun 3/60.

LICENSE:

XSysStats is Copyright (C) 1993, 1994 by Mark Wedel (master@rahul.net).

XSysStats can be redistributed provided it is done free of charge.
XSysStats can also be modified, but original credit must be given to
Mark Wedel.

XSysStats is provided as is.  I take no responsibility for damage
or problems caused by the use of XSysStats.

TO BUILD:

    If using imake, the following should work fine:

	1) xmkmf
	2) make
	3) make install
	4) make install.man

    If you are instead using make, try:

	1) cp Makefile.noIm Makefile
	2) Edit the Makefile.  Most things are pretty standard and clear.
	3) make
	4) make install

BUGS/PROBLEMS/FIXES:

If you have fixed some problem, or added support for another machine,
you can send me the patch at master@rahul.net.

If you notice a bug, you can send me mail at the same address.  Please
do not send bug reports of it not compiling on a specific machine because
rstat does not exist (or most other problems if they are in the porting.c
file.)  I likely will not have access to the hardware necessary to track
them down, so I will be able to do nothing about it.  If you are willing
to provide access to that hardware/software, then I will try to solve
the problem.

Please make sure you include the version number.  Invoking xsysstats
without any options will display the version at the top.

NOTES:

If you send me mail, please include a valid mail address I can reach
you at.

If you are looking for a C/X11 programmer to hire, send me mail.

Mark Wedel
master@rahul.net
November 29, 1994
