xenstat
=======

xenstat is a resource-monitoring framework for Xen.  It includes a
statistics-collection library, libxenstat, and an ncurses-based real-time
monitoring program, vm-top.


libxenstat
----------

To build and install libxenstat, run "make" and (as root) "make install" in
the libxenstat directory.  By default, this will install the library to
/usr/local/lib and the header to /usr/local/include.  You can install to a
prefix other than /usr/local by setting the "prefix" variable on the "make
install" command line, or you can change the location for the library or
header by setting the "libdir" or "includedir" variables respectively; for
example, "make prefix=$HOME/local install".

You can optionally build the scripting-language bindings by running "make
all-bindings" in libxenstat.  To build the bindings, you need SWIG, as well as
the development packages for perl and python.  Note that the bindings are not
currently installed by make install.


vm-top
------

To build and install vm-top, run "make" and (as root) "make install" in the
tools directory.  By default, this will install the vm-top binary to
/usr/local/sbin and the manpage to /usr/local/share/man.  You can install to a
prefix other than /usr/local by setting the "prefix" variable on the "make
install" command line, or you can change the location for the binary or the
manpage by setting the "sbindir" or "mandir" variables.

Once installed, you can run "vm-top" as root within Dom0 to display a
real-time, interactive display of the Xen system and the current domains.  See
the vm-top manpage for details on options and interactive commands.


Authors
-------
Josh Triplett <josht@us.ibm.com>
David Hendricks <dhendrix@us.ibm.com>
Judy Fischbach <jfisch@us.ibm.com>

Report bugs to Daniel Stekloff <dsteklof@us.ibm.com>.
