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

Introduction
How to Install 2.1 Caveats/Known issues
Licenses
Reporting Bugs
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.

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.

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

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

Sysfsutils

Install / Use

README

Contents