File:  [ELWIX - Embedded LightWeight unIX -] / embedaddon / bmon / README.md
Revision 1.1.1.1 (vendor branch): download - view: text, annotated - select for diffs - revision graph
Mon Oct 21 14:58:35 2019 UTC (4 years, 7 months ago) by misho
Branches: bmon, MAIN
CVS tags: v4_0p0, HEAD
bmon ver 4.0

    1: # bmon - Bandwidth Monitor
    2: 
    3: [![Build Status](https://travis-ci.org/tgraf/bmon.svg?branch=master)](https://travis-ci.org/tgraf/bmon)
    4: [![Coverity Status](https://scan.coverity.com/projects/2864/badge.svg)](https://scan.coverity.com/projects/2864)
    5: 
    6: bmon is a monitoring and debugging tool to capture networking related
    7: statistics and prepare them visually in a human friendly way. It
    8: features various output methods including an interactive curses user
    9: interface and a programmable text output for scripting.
   10: 
   11: ## Download
   12: 
   13:  * [Latest Release](https://github.com/tgraf/bmon/releases/latest)
   14:  * [Older Releases](https://github.com/tgraf/bmon/releases)
   15: 
   16: ## Debian/Ubuntu Installation
   17: 
   18: ```
   19: git clone https://github.com/tgraf/bmon.git
   20: cd bmon
   21: apt-get install build-essential make libconfuse-dev libnl-3-dev libnl-route-3-dev libncurses-dev pkg-config dh-autoreconf
   22: ./autogen.sh
   23: ./configure
   24: make
   25: make install
   26: bmon
   27: ```
   28: ## CentOS (6) Installation
   29: 
   30: ```
   31: git clone https://github.com/tgraf/bmon.git
   32: cd bmon
   33: yum install make libconfuse-devel libnl3-devel libnl-route3-devel ncurses-devel
   34: ./autogen.sh
   35: ./configure
   36: make
   37: make install
   38: bmon
   39: ```
   40: 
   41: ## OSX Installation
   42: Install libconfuse
   43: ```
   44: wget https://github.com/martinh/libconfuse/releases/download/v2.8/confuse-2.8.zip
   45: unzip confuse-2.8.zip && cd confuse-2.8
   46: PATH=/usr/local/opt/gettext/bin:$PATH ./configure
   47: make
   48: make install
   49: ```
   50: 
   51: Install bmon
   52: ```
   53: git clone https://github.com/tgraf/bmon.git
   54: cd bmon
   55: ./autogen.sh
   56: ./configure
   57: make
   58: make install
   59: bmon
   60: ```
   61: 
   62: -------------
   63: ## New in 4.0
   64:  * Use monotonic clock instead of realtime clock
   65:  * Pick default selected interface based on policy
   66:  * Collect RX NoHandler statistics if available (Linux)
   67:  * CentOS installation instructions
   68:  * Proper stdout flush in ASCII mode
   69:  * Bugfixes
   70: 
   71: -------------
   72: ### Usage
   73: 
   74: To run bmon in the default curses mode:
   75: 
   76: > bmon
   77: 
   78: There are many other options available and full help is
   79: provided via:
   80: 
   81: > bmon --help
   82: 
   83: ## Screenshots
   84: 
   85: ![Screenshot 1](https://github.com/tgraf/bmon/raw/gh-pages/images/shot3.png)
   86: ![Screenshot 2](https://github.com/tgraf/bmon/raw/gh-pages/images/shot1.png)
   87: ![Screenshot 3](https://github.com/tgraf/bmon/raw/gh-pages/images/shot2.png)
   88: 
   89: ## Copyright
   90: 
   91: Various authors, see git commit log.
   92: 
   93: > *Copyright (c) 2001-2016 Thomas Graf <tgraf@suug.ch>*
   94: > *Copyright (c) 2013 Red Hat, Inc.*
   95: 
   96: Please see the [LICENSE.BSD](https://github.com/tgraf/bmon/blob/master/LICENSE.BSD)
   97: and [LICENSE.MIT](https://github.com/tgraf/bmon/blob/master/LICENSE.MIT) files for
   98: additional details.
   99: 

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>