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.