| |
| 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> |
