1#@!#!123s

: / usr / share / doc / libsysfs /
Filename : README
back
	Sysfs Utilities Package - Includes Libsysfs(v. 2.1.0)
	======================================================

Contents
--------
 1. Introduction
 2. How to Install
    2.1 Caveats/Known issues
 3. Licenses
 4. Reporting Bugs


1. Introduction
---------------

This package's purpose is to provide a set of utilities for interfacing
with sysfs, a virtual filesystem in Linux kernel versions 2.5+ that
provides a tree of system devices. While a filesystem is a very useful
interface, we've decided to provide a stable programming interface
that will hopefully make it easier for applications to query system devices
and their attributes.

This package currently includes:

- libsysfs: a library for accessing system devices.
- systool: an application to view system device information by bus, class,
	and topology.
- A number of example usage routines in the "test" directory.
- A comprehensive testsuite, also shipped as part of the "test" directory. This
	testsuite can be used to test _all_ the APIs exported by Libsysfs.
	Please refer the libsysfs.txt file in the "docs" directory for
	details as to how to use the testsuite.


2. How to Install
-----------------

Run the "configure" script to generate Makefiles. Use "make" to build the
library and utilities.

For a successful install, run "make install" as super-user. "make uninstall"
will clean up all installed files.


3. Licenses
-----------

The commands and tests are licensed under the GNU Public License (GPL)
Version2, June 1991. The full text of the GPL is located in this package's
"cmd" directory:

sysfsutils/cmd/GPL

The library is licensed under the GNU Lesser Public License (LGPL)
Version 2.1, February 1999. The full text of the LGPL is located in
this package's "lib" directory:

sysfsutils/lib/LGPL


4. Reporting Bugs
-----------------

Please direct all bugs to either the linux-diag mailing list -
linux-diag-devel@lists.sourceforge.net - or to the authors:

Ananth Mavinakayanahalli <ananth@in.ibm.com>
Daniel Stekloff <dsteklof@us.ibm.com>
Mohan Kumar <mohan@in.ibm.com>