** compilation & installation **
no fancy configure and make scripts are yet available. Compilation is fairly simple, provided you have the Qt libraries and include files installed. Also the libraries include files of glibtop are necessary to compile.
I used following setup:
libgtop-1.0.7
qt-2.0.2
The program normally works in a standard redhat 6.1 environment. I haven't tested it on other platforms.
The libgtop libray claim to be portable on other platforms. So, qperfmeter, as a result will also be, provided you also install qt. There is one exception however: I haven't found a libgtop function to read disk statistics. This restricts the usage to linux only at the time being. To be able to see disk statistics, an extra compilation flag needs to included in the makefile:-DLINUX. Remove this compilation flag when building for other platforms.
Installation is simple: just copy the executable to your preferred bin directory. Or: edit the PREFIX variable in the makefile to your preferred destination and do a make install
** program execution **
The options are the ones that can be provided for any Qt application. This is quoted from the Qt documentation:
All Qt programs automatically support the following command line options:
-style= style, sets the application GUI style. Possible values are motif, windows, and platinum.
-session= session, restores the application from an earlier session.
-qdevel activates the Application Builder window, which allows run-time inspection of the program.
-qtranslate activates the Application Translator window, which allows translation of the texts shown in the program.
The X11 version of Qt also supports some traditional X11 command line options:
-display display, sets the X display (default is $DISPLAY).
-geometry geometry, sets the client geometry of the main widget.
-fn or -font font, defines the application font.
-bg or -background color, sets the default background color and an application palette (light and dark shades are calculated).
-fg or -foreground color, sets the default foreground color.
-btn or -button color, sets the default button color.
-name name, sets the application name.
-title title, sets the application title (caption).
-visual TrueColor, forces the application to use a TrueColor visual on an 8-bit display.
-ncols count, limits the number of colors allocated in the color cube on a 8-bit display, if the application is using the
QApplication::ManyColor color specification. If count is 216 then a 6x6x6 color cube is used (ie. 6 levels of red, 6 of green, and 6 of
blue); for other values, a cube approximately proportional to a 2x3x1 cube is used.
-cmap, causes the application to install a private color map on an 8-bit display.
** contributions **
Any contribution is highly appreciated. In the TODO file you find a list of items that still need to be taken care of. To add more statistics you can always send source and header files of PerfInfo subclasses. Every subclass needs to implement 3 functions (specified pure abstract in PerfInfo.h):
virtual float getValue() = 0;
virtual string getName() const = 0;
virtual float getThreshold() const = 0;
The getValue function returns periodically (when the timer elapses) new values which are represented in the Graph objects. The getName function has to return a string containing the name of the graph. For cosmetic reasons please restrict the number of characters to 4. The getThreshold function returns the initial scale. When the value returned by getValue exceeds this scale, the graph's scale is automatically adjusted.
** contact information **
Koen Bailleul
KBF Consult bvba.
email: Koen.Bailleul@kbf.be
url: http://www.kbf.be/
url: http://www.kbf.be/linux/
** legal stuff **
** This program is released under the GNU GENERAL PUBLIC LICENSE. ** ** It can be further distributed and modifed if the original author, ** ** KBF CONSULT, is mentioned. The GNU GPL can be found in file COPYING. **
** This file may be distributed under the terms of the Q Public License **
** as defined by Troll Tech AS of Norway and appearing in the file ** ** LICENSE.QPL included in the packaging of this file. **