Provided by: bwm-ng_0.6-3.1ubuntu2_amd64 
NAME
bwm-ng - Bandwidth Monitor NG (Next Generation), a live bandwidth monitor for network and disk io.
SYNOPSIS
bwm-ng [options] ... [configfile]
DESCRIPTION
bwm-ng can be used to monitor the current bandwidth of all or some specific network interfaces or disks
(or partitions). It shows total of in and out as well as total of all interfaces/devices. Several
different output methods are supported (curses, curses2, plain, csv and html).
bwm-ng is not limited in the number of interfaces or disks and can handle new ones dynamically while its
running or hide those which are not up.
INPUT METHODS
The input methods used pretty much depends on your OS and system. You can choose the preferred method
either at start or in curses during run-time. Each method can only be used if bwm-ng was compiled with
support for it.
Currently supported network input methods:
proc :
This is the default for Linux based systems. It parses the special procfs file /proc/net/dev.
This should be used if in doubt in Linux.
getifaddrs :
This is the default on BSD systems like FreeBSD, NetBSD, OpenBSD and recent Mac OS X (>=10.3).
This should be used if in doubt on those systems. It uses the getifaddrs systemcall.
kstat :
This is the default for Solaris. It uses the kstat systemcall.
sysctl :
This is the default on Systems like IRIX and other UNIX. It can be used on many other systems
like early Mac OS X as well. It uses the sysctl systemcall.
netstat :
This is a Backup for systems without the above, or other problems.
libstatgrab :
bwm-ng can use the external library libstatgrab to gather the data. please refer to
http://www.i-scream.org/libstatgrab for more info about this.
Currently supported disk input methods:
disk:
Shows the diskio on Linux 2.6+ systems using /proc/diskstats. Instead of packets the number of
read/writes will be shown.
kstatdisk:
same as kstat network input but for disk io. It uses the kstat systemcall from Solaris.
sysctl:
Written for NetBSD and OpenBSD, but maybe working on other Platforms aswell.
devstat:
devstat library based input. You can find this on FreeBSD based systems.
ioservice:
framework IOKit based input. You can find this on Darwin systems like MacOSX.
libstatdisk:
same as libstatgrab but for disk io (http://www.i-scream.org/libstatgrab/).
OUTPUT METHODS
You can select several different ways to output the data gathered by bwm-ng.
You can use one of:
curses:
This is the default output method. Usually this fits you the most. In curses mode you can
control bwm-ng with several keys. Press 'h' for a online help. To quit using this mode either
press 'q' or ctrl-c.
curses2:
Shows bar charts of the current IO, using curses output.
plain:
Plain or ASCII is mostly a backup if curses is not available. You cannot control bwm-ng at all
in this mode. To quit press ctrl-c. But for one single single output using this is the mode
that fits the best.
csv:
CSV is designed to use with scripts for easy parsing. For a list of those elements please take
a look at README - Specs section. To skip the first output with only zeros use
bwm-ng -o csv -c 0
html:
This is designed for use in the WWW. It uses the CSS file bwm-ng.css in current working dir.
"--htmlrefresh" only affects the refresh of the page by the browser. For best results use the
same value for --timeout and --htmlrefresh.
OPTIONS
The options that are recognized by bwm-ng can be divided into 3 different groups. The long versions can
only be used if bwm-ng was compiled with getopt_long.
INPUT
These options specify the method to gather the data as well as different options for them.
-i, --input method
selects which method to use. It can be one of the above (see INPUT METHODS) if support for it was
compiled in.
-f, --procfile filename
selects the file to parse in proc input method. This is usually /proc/net/dev.
--diskstatsfile filename"
selects the file to parse in disk input method. This is usually /proc/diskstats.
--partitionsfile filename"
selects the file to parse in disk input method on older Kernel. This is usually /proc/partitions.
-n, --netstat path
specifies the binary to execute for netstat input method. Because this may be a security flaw
support for this option is not compiled in bwm-ng by default.
OUTPUT
These options select the way to output the data and several options for the output.
-o, --output method
selects which method to use for output. It can be one of the above (see OUTPUT METHODS) if support
for it was compiled in.
-u, --unit value
selects which unit to show. It can be one of bytes, bits, packets or errors.
-T, --type value
specifies the type of stats to show. Use one of rate for the current rate/s, max for the maximal
value achieved since startup of bwm-ng, sum for the total sum counted since startup of bwm-ng or
avg for the average over the last 30 seconds.
-c, --count number
number of outputs for Plain and CSV output mode. Use '1' for once single output. Using '0' in CSV
mode will skip first output that always consists of zero values.
-C, --csvchar char
specifies the delimiter char for CSV mode. The default is ';'.
-F, --outfile filename
specifies the use of a outfile instead of stdout. This option only affects CSV and HTML mode.
-R, --htmlrefresh seconds
sets the HTML Meta refresh field to seconds in HTML mode. This will result in a reload of the
page every n seconds by the browser. If this is set you want to use --htmlheader as well.
-H, --htmlheader [value]
if this option is used, bwm-ng will print the correct HTML header (<html></html>) including Meta
fields before and after data. This is only useful in HTML mode. value can be 0 (off) or 1 (on),
if the value is not given '1' is used.
-N, --ansiout
disable ANSI Codes for Plain output.
--longdisknames
show long realnames of disks in Darwin (ioservice input)
OTHER
These options specify the general behavior of bwm-ng.
-t, --timeout msec
displays and gathers stats every n msec (1msec = 1/1000sec). The default is 500msec.
-d, --dynamic [value]
shows bytes and bits with dynamic unit like K, M or G (Kilo, Mega, Giga). value can be 0 (off) or
1 (on), without a value '1' is used.
-a, --allif [mode]
specifies whether only up and selected interfaces (mode=0), all which are up but maybe not
selected (mode=1) or all, even down and not selected interfaces (mode=2). If no interface list
given (--interfaces) mode=1 and mode=2 are the same.
-I, --interfaces list
show only interfaces which are in this comma separated list (whitelist). If the list is prefixed
by a '%' its meaning is negated and interfaces in this list are hidden from output (blacklist).
(Example: %eth0,tun0)
-S, --sumhidden [value]
if given and the optional value is not 0, count also hidden and not shown interfaces for total
value.
-A, --avglength seconds
sets the span in which the stats for average mode are collected. Default is 30 seconds or
2*timeout.
-D, --daemon [value]
fork into background and daemonize if given and the optional value is not 0. This only affects
HTML and CSV mode and --outfile is required.
-h, --help
show a help of command line options.
-V, --version
print version info
CONFIGFILE
The behavior of bwm-ng can be also controlled by a configfile. By default bwm-ng first reads /etc/bwm-
ng.conf and then ~/.bwm-ng.conf. If specified on command line bwm-ng skips those. It consists of the
same long-options as used for command line as keys followed by a '=' and the value. Lines starting with a
# or unknown key will be ignored.
For example:
DYNAMIC=1
UNIT=bits
PROCFILE=/proc/net/dev
OUTPUT=plain
OTHER FILES
bwm-ng.css the CSS file used for html output.
SEE ALSO
bwm-ng.conf-example for an example of the configfile, README for other comments and hints about bwm-ng.
http://www.gropp.org/ for new version or further help and links.
AUTHORS
Volker Gropp <bwmng@gropp.org> wrote bwm-ng and is current maintainer.
For further Authors please refer to AUTHORS file which should come with bwm-ng.
2007-03-01 bwm-ng(1)