SysTutorials

Linux Manual Pages › Section 8

bwbar(8)

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.