
Lockstat
--------

Lockstat is the basic tool used to control the kernel's Lockmeter
functionality:  e.g., turning the kernel's data gathering on or off, and
retrieving that data from the kernel so that Lockstat can massage it and
produce printed reports.  See http://oss.sgi.com/projects/lockmeter for
details.

The Lockstat tarball includes files for building the basic Lockstat command,
as well as files for building and executing "locktop" and "pmda_lockstat",
which are the Lockstat-related components for Performance Co-Pilot (PCP)
functionality.  See the files lockstat/locktop/README and
lockstat/pmda_lockstat/README and the website http://oss.sgi.com/projects/pcp
for details.

The default lockstat/Makefile only builds the basic Lockstat tool.  The
alternative lockstat/Makefile.pcp (e.g., make -f Makefile.pcp) builds both
Lockstat and the various PCP components.

Compiling Lockstat requires the kernel file "lockmeter.h", which is found in
source tree of a lockmeter-capable kernel (i.e., a kernel that has been patched
by the lockmeter patch).  The Lockstat Makefile expects that the symbol
LINUX_INC_ROOT points to such a lockmeter-capable kernel source tree.
LINUX_INC_ROOT defaults to "/usr/src/linux/include".  If this default is
incorrect, then you must redefine the symbol as appropriate before attempting
the 'make'.

Questions?  Send email to owner-lockmeter@oss.sgi.com or to the entire
mailing list, lockmeter@oss.sgi.com.  Feel free to join the mailing list by
sending email to majordomo@oss.sgi.com with a text body
	subscribe lockmeter <your-email-address>
