(Updated 17.2.2008 for beta3)


NOTE!

This is a beta that will be merged to vnStat 1.7 or later. Most features
should however already be usable although some graphical glitches
can be visible. Bugs and enhancement ideas can be sent at
http://forums.humdi.net/ or by email.



What is vnstati
:::::::::::::::

 vnstati is the image output command for vnStat. It provides png image file
 output as an addition to console outputs provided by vnStat.


Installing (Linux)
::::::::::::::::::

 Before proceeding, make sure that libgd2 and libgd2-dev are installed. The
 binary cannot be compiled otherwise. Also vnStat 1.4 or later needs to be
 installed and configured. Then run as root the usual

     make && make install

 This will compile the binary and install it along with the man page. The
 example cgi script locate in the 'examples' directory needs to be installed
 manually since it requires some configuration before it can be used. Open
 it with a text editor and check the variables in the beginning of the file.


Installing (BSD)
::::::::::::::::
     
 The install procedure is similar to the Linux intructions. However, the
 required packages are named gmake, gd and gd-dev. Also use gmake instead
 of make and bsdinstall instead of install.
 
 If the gmake command produces errors then library path aren't probably
 set correctly. Add the following in front of the line and try again:

     LIBRARY_PATH="/usr/local/lib" CPATH="/usr/local/include"


Available options
:::::::::::::::::

 A list of all options is available with 'vnstati --help'.
 See the man(1) page for option explanations.

 An example configuration file is included in the cfg directory. It contains
 at the end of the file the necessary new options for adjusting colors. These
 lines can also be added to the end of /etc/vnstat.conf.

 The new configuration file lines are:

HeaderFormat    "%d.%m.%Y %H:%M"
CBackground     "FFFFFF"
CEdge           "AEAEAE"
CHeader         "606060"
CHeaderTitle    "FFFFFF"
CHeaderDate     "FFFFFF"
CText           "000000"
CLine           "B0B0B0"
CLineL          "-"
CRx             "92CF00"
CTx             "606060"
CRxD            "-"
CTxD            "-"


Contacting the author
:::::::::::::::::::::

 email:    Teemu Toivola <tst at iki dot fi>
 irc:      Vergo (IRCNet)
 web:      http://humdi.net/vnstat/
 forum:    http://forums.humdi.net/
