3 Distributed network monitoring tools
5 Copyright (C) 2011 Emmanuel Roullit
7 https://github.com/eroullit/dabba
12 dabba is a set of network tools written for Linux.
14 The project has 4 main components:
15 - libdabba - low-level zero-copy network library
16 - libdabba-rpc - protobuf-based rpc library for dabbad and dabba
17 - dabbad - multi-threaded task manager and RPC query processor
18 - dabba - CLI 'à la git' to communicate with dabbad and submit tasks
20 Currently supported feature are listed in the CODING file.
25 There's a public Git repository at http://github.com/eroullit/dabba
26 where you can check out the latest code base.
28 git clone git://github.com/eroullit/dabba.git
30 Contributions are welcome, CODING regroups all information about it.
35 dabba needs these to compile and run properly:
36 - Linux kernel >= 2.6.31
45 - setcap (within libcap2-bin package)
47 Recommended optional packages:
55 $ mkdir build && cd build && cmake .. && make
57 To install it after being built:
58 $ sudo make install/strip
63 To configure dabba to run with a regular user account:
69 Automatic tests are available. There are two kinds:
70 - Read-only (which do not interfere with network interface settings)
71 - Read-write (which modify network interface settings)
73 WARNING: Read-write tests might degrade or disable the
74 interface connectivity while tests are running. Avoid to run
75 then on production interfaces.
77 To run read-only automatic tests, make sure proper capabilities are granted and
78 run in the build directory:
79 $ ctest --output-on-failure
81 To run read-only automatic tests, make sure proper capabilities are granted,
82 set the `TEST_DEV` variable with the interface name to modify
83 and run in the build directory:
84 $ TEST_DEV=eth0 ctest --output-on-failure
92 As long as dabbad is running, captures tasks can be submitted:
93 $ dabba capture start --interface eth0 --pcap /tmp/example.pcap
95 Running captures can be listed in YAML format:
101 packet mmap size: 32768
103 pcap: /tmp/example.pcap
106 Stopping the capture:
107 $ dabba capture stop --id 3076324160
112 Copyright (C) 2011-2012 Emmanuel Roullit <emmanuel.roullit@gmail.com>
114 This program is free software; you can redistribute it and/or modify
115 it under the terms of the GNU General Public License as published by
116 the Free Software Foundation; either version 2 of the License, or (at
117 your option) any later version.
119 This program is distributed in the hope that it will be useful, but
120 WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
121 or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
124 You should have received a copy of the GNU General Public License along
125 with this program; if not, write to the Free Software Foundation, Inc.,
126 51 Franklin St, Fifth Floor, Boston, MA 02110, USA
132 Send me a message to @eroullit on GitHub
134 For suggestions or bug reports:
135 https://github.com/eroullit/dabba and feel free to open an issue.