-
Notifications
You must be signed in to change notification settings - Fork 26
/
README
154 lines (116 loc) · 5.28 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
bwm-ng v0.6.3
Copyright (C) 2004-2021 Volker Gropp (bwmng@gropp.org)
http://www.gropp.org/?id=projects&sub=bwm-ng
What is this?
=============
Bandwidth Monitor NG is a small and simple console-based live network and disk
io bandwidth monitor for Linux, BSD, Solaris, Mac OS X and others.
Short list of features:
- supports /proc/net/dev, netstat, getifaddr, sysctl, kstat, /proc/diskstats
/proc/partitions, IOKit, devstat and libstatgrab
- unlimited number of interfaces/devices supported
- interfaces/devices are added or removed dynamically from list
- white-/blacklist of interfaces/devices
- output of KB/s, Kb/s, packets, errors, average, max and total sum
- output in curses, plain console, CSV or HTML
- configfile
This was influenced by the old bwm util written by written by Barney
(barney@freewill.tzo.com) which had some issues with faster interfaces and
was very simple. Since i had almost all code done anyway for other projects,
i decided to create my own version.
I actually dont know if netstat input is usefull at all. I saw this elsewhere,
so i added it. Its target is "netstat 1.42 (2001-04-15)" linux or
Free/Open/NetBSD. If there are other formats i would be happy to add them.
For info about libstatgrab please refer to http://www.i-scream.org/libstatgrab/
Supported Platforms
===================
network routines sucessfully tested on:
Linux 2.4 and above*
FreeBSD 4.8, 5.3, 6.2*
MacOS X 10.1 and above*
Solaris 10 x86*
SunOS 5.9 sparc Solaris 9
OpenBSD 3.4, 3.6, 4.0*
NetBSD 1.6.1, 2.0, 3.0*
IRIX64 6.5
Win2000, WinXP, Windows Vista
*disk monitoring working aswell
please email me of working or not working platforms. Disk IO might work only on a limited
number of platforms.
INSTALL
=======
Autotools are used to build this. Run the autogen.sh to generate the configure script.
For detailed decription please read INSTALL
./configure --help for a list of options
./configure
make
to install use as root:
make install
WIN32
=====
To compile the Windows version in Linux (debian):
./configure --with-win32 --without-procnetdev --without-diskstats --without-curses --without-netstatlinux --build i686-pc-linux-gnu --host i586-mingw32msvc
make
get ansi.sys for better output: http://en.wikipedia.org/wiki/ANSI.SYS
Specs
=====
csv output format:
Type rate:
unix timestamp;iface_name;bytes_out/s;bytes_in/s;bytes_total/s;bytes_in;bytes_out;packets_out/s;packets_in/s;packets_total/s;packets_in;packets_out;errors_out/s;errors_in/s;errors_in;errors_out;bits_out/s;bits_in/s;bits_total/s;bits_in;bits_out\n
Type svg, sum, max:
unix timestamp;iface_name;bytes_out;bytes_in;bytes_total;packets_out;packets_in;packets_total;errors_out;errors_in\n
Use --count 0 to skip the all zero output after start.
html output format:
edit the bwm-ng.css to modify the output. Please note the htmlrefresh only
modifies the META refresh, you maybe wanna sync --timeout and --htmlrefresh
USAGE
=====
USAGE: bwm-ng [OPTION] ... [CONFIGFILE]
Please read the manpage or `bwm-ng -h` for a list and explanation of options.
Keybindings (curses only):
'h' show help
'q' exit
'+' increases timeout by 100ms
'-' decreases timeout by 100ms
'k','d' switch KB and auto assign Byte/KB/MB/GB
'a' cycle: show all interfaces, only those which are up,
only up and not hidden
's' sum hidden ifaces to total aswell or not
'n' cycle: input methods
'u' cycle: bytes,bits,packets,errors
't' cycle: current rate, max, sum since start, average for last 30 sec
Configfile
==========
either via cmdline or /etc/bwm-ng.conf or ~/.bwm-ng.conf
it consists of:
longoption=value
with 1 or 0 as values for keys without a value in cmdline options.
For more help take a look at bwm-ng.conf-example
Misc
====
Bugs/Known Problems:
- curses output coredumps on netbsd 1.6.1 (maybe others) with unknown TERM
set and configfile support compiled in
- no other yet, wow ;) (please report if you found one)
Todo:
- Docs
- checking options to be valid
- mysql output (ipac-ng compatible)
- setting which stats to output for csv/sql
- distributed gathering of stats (client/server)
- whatever you can think of
******************************************************************************
* This program is free software; you can redistribute it and/or modify *
* it under the terms of the GNU General Public License as published by *
* the Free Software Foundation; either version 2 of the License, or *
* (at your option) any later version. *
* *
* This program is distributed in the hope that it will be useful, *
* but WITHOUT ANY WARRANTY; without even the implied warranty of *
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
* GNU General Public License for more details. *
* *
* You should have received a copy of the GNU General Public License *
* along with this program; if not, write to the Free Software *
* Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA *
******************************************************************************