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)

Version 1.50 has been tested on a Sparc 2 running Solaris 2.5 under X11R6.
Prior versions have been tested on sun 3/60's under 4.1.1 I have also 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 (however, in version 1.50, the
low level calls the duplicate rstat are now in place, so all you should need
is a fairly complete rpc library).  Rstat 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 requires 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.)

Starting with version 1.50, XSysStats can use a new rpc method.  In this
mode, it will only open a connection once to the remote host, and just stay
in contact with the remote rstat program.  This reduces cpu
consumption by a good amount.

LICENSE:

XSysStats is Copyright (C) 1993, 1994, 1995, 1997, 2000 by Mark Wedel
(mwedel@scruz.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.

XSysStats was developed as a personal project on my home system.  This is
not a product of my employer, Pyramid Technology, and they take no
responsibility of its use.

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 mwedel@scruz.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.

Linux seems to lack xdr_statstime in any of its library.  However, you can
grab the rpc.rstatd-3.03 package and just link in rstat_xdr.o, and
everything seems to be happy.  You probably want this package if you just
want rstatd on the linux box, since it doesn't look like linux comes with it.

Mark Wedel
mwedel@scruz.net
May 29, 2000
