si - Version 1.0
   - By Joe Turgeon (jturgeon@isd.net)
   - http://siv.sourceforge.net/


/-------\
| ABOUT |
\-------/
  si (System Information Viewer) is a Linux application that 
displays information about the local computer from data gathered 
from the /proc filesystem, a readable interface to kernel memory.

  To run, si requires an operating system which supports and 
implements the /proc filesystem.  The Linux kernel allows 
disabling the /proc filesystem, which would cause si to not 
function.  si also requires a C compiler, and standard C libraries.
The color and process-view mode will only function if ncurses is 
installed at the time of compilation. 


/--------------\
| INSTALLATION |
\--------------/
  To configure, type:	'./configure'
  To compile si, type:	'make'
  To test si, type:	'src/si'
  To install si, type:	'make install'
  To run si, type:	'si'


/-------\
| USAGE |
\-------/
  Since version 0.5, si automatically sends the output to 'less' 
so piping si to a pager is not required.  Version 0.6 added a 
command-line option to send output to a file, which can be used:
	si -f mycomputer.info

  One or more of the following arguments may be used with si:
	-h or -?	will display usage information
	-f <file>	will send output to the file specified
	-o 		when used with one or more of the 
			  following characters will display only 
			  the corresponding section:
		s  -  System Section  (CPU, IO-ports, interrupts...)
		h  -  Hardware Section  (TTY, IDE, SCSI devices...)
		m  -  Memory Section  (total memory, used memory...)
		k  -  Kernel Section  (kernel version, modules...)
		f  -  File-System Section  (partitions, mounts...)
		n  -  Network Section  (host and domain name)
		p  -  Process Section  (information on running processes)
	-p		will disable sending output to pager
	--dump		will use dump output mode (default)
	--data		will use data dump output mode
	--color		will use color output mode
	--ps		will use process view mode
	--html		will use HTML output mode

  Since version 0.7 you may setup a default configuration file.  
This file may be named: '~/.si.conf' or '/etc/si.conf'.  For more 
information on using this file, read the included 'si.conf'.

  Version 0.8 adds multiple output modes.  The standard output mode 
is referred to as the "dump output mode" and is default.  There is 
a "color output mode" which uses ncurses to display colorized pages.  
The "process view mode" displays the colorized process information 
page also found in the color mode.

  Version 0.9 adds a HTML output mode.  When si is executed with 
the --html flag the information about the system is returned in 
HTML.  Using this option, si can be used as a CGI program.

  Version 1.0 adds a data dump output mode.  This output mode, selected 
by the --data command line argument, displays the information collected 
by si without verbose formatting.  The output could be parsed and used 
by another program which requires system information.

  Example formatted dump output can be found in the file: 'OUTPUT'.


/----------------\
| SPECIAL THANKS |
\----------------/
  Special thanks to the following people who have
aided the development of si:
	* Dr. Guenter Bechly
	* Dean Johnson
	* Micheal Slusarz
	* all who have sent bug reports or suggestions


/-----------------------\
| CONTACTING THE AUTHOR |
\-----------------------/
  If you encounter any problems while running si, please contact 
the author (Joe Turgeon) via e-mail at jturgeon@isd.net.  If you 
have any questions or suggestions please do so as well.  Please 
note that this project is far from finished, and please watch for 
updates frequently.

  Thank you for using si.