README

	Sysfs Utilities Package - Includes Libsysfs (v. 2.1.1)
	======================================================

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)
Version 2, 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
-----------------

Feel free to report bugs by opening an issue in the GitHub Issue Tracker.

5. Contributions
----------------

For submitting patches, open a GitHub pull request. Please make sure that they
are rebased on top of the current master. Code submission guidelines are the
same as the Linux Kernel contribution guidelines.

You probably want to read the through Linux kernel Documentation/SubmittingPatches
for guidance.