home | help
NAME
     iograph -- create HTML graphs showing network traffic

SYNOPSIS
     iograph [-i interface] [-o outdir] [-d datafile]

DESCRIPTION
     The iograph program collects network statistics for an interface of the lo-
     cal host and stores the number of sent and received bytes in a small binary
     database.

     It then creates HTML pages printing the statistics for one day (hourly dis-
     play),  one  month  (daily  display) or for the past twelve month. The HTML
     pages print the number of bytes sent / received together with a bar graph.

   Options
     -i interface
	     The network interface for which statistics are to be collected.

     -o outdir
	     Directory where to place the resulting HTML pages.
	     Do not add a trailing slash!

     -d datafile
	     Name of the database file.

   Usage
     iograph is intended to be run as a cron job. Add the following line to your
     system crontab(8):

	   0   *   *   *    *	 root /usr/local/bin/iograph	-i    ath0    -o
	   /usr/local/www/iograph -d /var/db/iograph.dat

AUTHORS
     Markus Dolze <bsdfan@nurfuerspam.de>

BUGS
     The  intended interval is one hour. If it is called more than once an hour,
     the data point for the past hour is overwritten with the traffic since  the
     last run.

     On  i386  systems,  FreeBSD's  network  counters are 32 bit long, therefore
     wrapping at 4 GB.	iograph will produce wrong results if more than 4 GB are
     transfered within one hour, because it can only detect one counter wrap.

			       September 23, 2007		      IOGRAPH(8)

home | help