bwm-ng man page on DragonFly

Man page or keyword search:  
man Server   44335 pages
apropos Keyword Search (all sections)
Output format
DragonFly logo
[printable version]

bwm-ng(1)		     Bandwidth Monitor NG		     bwm-ng(1)

NAME
       bwm-ng - Bandwidth Monitor NG (Next Generation), a live bandwidth moni‐
       tor 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 spe‐
       cific 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 han‐
       dle 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  system‐
		  call.

	      kstat :
		  This	is  the default for Solaris. It uses the kstat system‐
		  call.

	      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/libstat‐
		  grab 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	avail‐
		  able. 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 differ‐
       ent  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  differ‐
       ent 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, pack‐
	      ets 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 --out‐
	      file 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)
[top]

List of man pages available for DragonFly

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net