bwbar (8) - Linux Manuals

bwbar: create a textual and graphical readout of current bandwidth usage

NAME

bwbar - create a textual and graphical readout of current bandwidth usage

SYNOPSIS

bwbar [ --input|-i ] [ --output|-o ] [ --directory|-d directory ] [ --text-file|-t file ] [ --png-file|-p file ] [ --interval|-t seconds ] [ --width|-x pixels ] [ --height|-y pixels ] [ --border|-b pixels ] [ --kbps|-k ] [ --Mbps|-M ] [ --Gbps|-G ] [ --help|-h ] interface max-Mbps

DESCRIPTION

This manual page briefly documents the bwbar program.

bwbar is a simple daemon which creatse a readout of current bandwidth usage, generally for inclusion on a webpage. The output appear in both a text file and a PNG format bargraph in the specified output directory, and is based on data gathered from the specified device and the specified maximum bandwidth.

OPTIONS

--input|-i

Measure the input bandwidth

--output|-o

Measure output bandwidth (default)

--directory|-d

Specify the output directory

--text-file|-f

Specify the name of the text-format ouput file (defaults to "ubar.txt")

--png-file|-p

Specify the name of the PNG-format output file (defaults to "ubar.png")

--interval|-t

Set the poll interval in seconds (defaults to 15 seconds)

--width|-x

Set the width of the graphical bar (defaults to 600 pixels)

--height|-y

Set the height of the graphical bar (defaults to 4 pixels)

--border|-b

Set the border width of the graphical bar (defaults to 1 pixel)

--kbps|-k

Set the units of bandwidth measure to kilobits/second

--Mbps|-M

Set the units of bandwidth measure to megabits/second (default)

--Gbps|-G

Set the units of bandwidth measure to gigabits/second

--Daemon|-D

Run as daemon

--help|-h

Online help

AUTHOR

bwbar was written by Peter Anvin <hpa [at] zytor.com>.

This manual page was prepared by Nick Rusnov <nickrusnov [at] debian.org> for the Debian Project.