 
		sysdiag, Command Line Diagnostics
		=================================



Content
--------
 1. Introduction
 2. License
 3. Dependencies.
 4. Reporting Bugs




1. Introduction
---------------
sysdiag is a utility that enables the user to run diagnotics on devices present
on the system. It also enables the user to list all the devices on the system, 
show event log information from the system logs for the device.

Sysdiag makes use of libsysfs, which is a library that provides set of apis
to query device information from the sysfs.

sysdiag functionalites can be broadly classfied into following catogories.

- List devices.
- Show Error Logs.
- Query device information.
- Run diagnostics.

To run diagnostics sysdiag requires the sg3_utils package to be installed.

sysdiag runs diagnostics based on the class of device. sysdiag provides an
option to add or remove the diagnostic utilities based on the class of device.
This can be done through sysdiag.conf file. A default config file is provided
with this package.


2. License 
----------

sysdiag utility is licensed under the GPL. The full text of the GPL is
located in the package's base directory:

sysdiag/GPL

The libsysfs library is licensed under the LGPL. The full text of the LGPL is
located in the lib directory of the package.

sysdiag/lib/LGPL

3. Dependencies
---------------

sysdiag requires the libsysfs library to be present in the system and looks for
the library in the /usr/local/lib directory. Please modify the Makefile if the 
libsysfs is present in some other path.

The latest libsysfs can be obtained from:

http://linux-diag.sourceforge.net/Sysfsutils.html

Also sysdiag needs to have the sg3_utils package to be installed to run 
diagnostics on the scsi devices.
sg3_utils can be obtained from:

http://www.torque.net/sg


4. Reporting Bugs
-----------------
Please direct all bugs to either the linux-diag mailing list - 
linux-diag@lists.sourceforge.net - or to the author:

Nitin Vashisth <nitin@in.ibm.com>

