
WHAT IS XSYSINFO:

xsysinfo is an X application to display some Linux kernel
parameters in graphical form. It is like a mix of top, free and xload
with the difference that the values are shown in form of a horizontal bar.
The displayed values are: CPU load, CPU idle, Memory size, Cache size and
Swap size (details see below).

The actual version was written under Linux 0.98, the code for kmem access
is based on ps-0.97.6. For later releases maybe some change will be
neccessary. 


HOW TO INSTALL:

Unpack the xsysinfo archive in your directory with:

tar xvzf xsysinfo-1.0.tar.Z

There is a compiled xsysinfo included in the archive, which needs the new
X distribution (XFree-1.1) with the 4.1 jump libs. If you want to
install this binary just type

make install

as root and check that /usr/X386/bin/xsysinfo has the same
permissions as ps. If not, change it to setuid-root with

chown root /usr/X386/bin/xsysinfo
chmod u+s /usr/X386/bin/xsysinfo

or if you have the MCC release of Linux to setgid-mem with

chgrp mem /usr/X386/bin/xsysinfo
chmod g+s /usr/X386/bin/xsysinfo

If you want to create your own compiled version just type:

xmkmf
make

(you'll need the programming package and the libraries from the XFree
distribution to do this.)
Now you can install it as described above.


HOW TO START:

To start type 

xsysinfo &

All toolkit options will be accepted, so 

xsysinfo -geometry 300x300 &

will start xsysinfo with size 300x300 Pixels.


WHAT IS DISPLAYED:

Xsysinfo displays the following values:

  - CPU load
	CPU load average between 0.000-1.000.

  - CPU idle
	percentage CPU idle time to real time.

  - Memory
        percentage of used physical memory to total physical memory,
	without counting the buffer cache.

  - Cache
	percentage of physical memory used for the buffer cache to
	total physical memory.

  - Swap
	percentage of used swap space on /dev/swap to total swap space.



THANKS:

I like to thank
- Branko Lankester, who wrote ps & friends, upon xsysinfo is based.
- Linus for writing this great OS.
- all others who made Linux to what it is.


COMMENTS:

Comments, bug reports, whishes etc... are welcome. Send them to me
Gabor Herr (herr@iti.informatik.th-darmstadt.de).

Have fun...


Gabor
