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 Daniel Stekloff Mohan Kumar