$Header: /cvsroot/wmbars/wmbars/index.html,v 1.3 2003/03/14 08:00:17 jmmcg Exp $
Build Requirements:
To build WMBars you will need to install:
-
libstdc++: The C++ Standard Library, usually installed as part of your G++ installation.
-
libboost: The Boost library, v1.29 or greater.
-
libxml++: The 'C++' wrapper to the above, v0.21 or greater. See "http://sourceforge.net/projects/libxmlplusplus".) Ensure that if you use the Sourceforge download of libxml++ that you modify your "/etc/ld.so.conf" file to include "/usr/local/lib" and run "ldconfig" to update the dynamic-linker path-cache correctly.
I recommend using the appropriate packages for your distribution of Linux, if they are thesame version as, or newer than the above.
To build & install:
-
Extract the source tarball.
-
"cd" into the directory in which the source tarball was expanded to.
-
As root type "make install". (This installs the files into "/usr/local/bin/" and the default configuration file into "~/.wmbarsrc.xml".)
To uninstall:
To uninstall type "make uninstall" as root.
Useage Notes:
-
Edit the file "~/.wmbarsrc.xml" to have your desired items to be monitored at the desired intervals. Use the file "/usr/local/bin/wmbarsrc.xdr" to validate your modified XML configuration file, as this is the primary way to check the correctness of this configuration file.
-
You may have up to three items displayed at a time, but any number of items may be monitored. They scroll up the display, scrolled once every update period, eventually looping back to the beginning. If less than three items are displayed, the lower bar graphs are left empty.
-
All command line options are "long options", type "wmbars --help" to view them all.
-
Type "wmbars --version" to view warranty, version and author information with a brief piece of help text.
-
If you have one or more S.M.A.R.T. enabled hard-drives, you might be able to monitor their temperature. I successfully use "hddtemp" v0.2 to read the temperature of my hard-drive in my laptop, but note that this causes the hard-drive light to regularly flash. I have no idea if this reduces the power saving on the hard drive, it does not *appear* to... (I also modified the configuration file of "hddtemp" so that it correctly recognises my hard drive.) (Indeed this was one of the reasons I wrote this program - to monitor both CPU & hdd temperatures.)
-
The "LineToScan" is zero-indexed, like all good 'C' progams!
-
The "MaxVal" should be in the units of the items read, as this normalizes the bar graph correctly.
More Details:
WMBars is hosted at Sourceforge where you can find:
Credits:
This code was developed by J.M.McGuiness.
The idea for this code came from WMTop. The bar graph code has been taken from that code, otherwise the back-end stuff is all my own, and my fault, no-one else's!
License & Warranty.
This code is released under the GPL, with absolutely no warranty, express or implied. Please see the files "COPYING" and "WARRANTY" in the release distribution for more details.
