commits

commits@lists.open-mesh.org

1 participants
12425 discussions

[batctl] master: batctl: Handle allocation error in vlan_get_link_parse (2ea390c)
by postmaster＠open-mesh.org 04 Dec '17

04 Dec '17

Repository : ssh://git@open-mesh.org/batctl On branch : master >--------------------------------------------------------------- commit 2ea390ce9bdda39d3c15bd9470009f56f42d5ed9 Author: Sven Eckelmann <sven(a)narfation.org> Date: Sat Dec 2 08:45:59 2017 +0100 batctl: Handle allocation error in vlan_get_link_parse The malloc could fail and return NULL. In this case, the processing of the current interface index has to be stopped to avoid writing to NULL (which would cause a segfault). Fixes: d29288fe0583 ("batctl: implement vlan-to-link helper functions") Signed-off-by: Sven Eckelmann <sven(a)narfation.org> Signed-off-by: Simon Wunderlich <sw(a)simonwunderlich.de> >--------------------------------------------------------------- 2ea390ce9bdda39d3c15bd9470009f56f42d5ed9 functions.c | 3 +++ 1 file changed, 3 insertions(+) diff --git a/functions.c b/functions.c index 8bcf52d..5e4eda0 100644 --- a/functions.c +++ b/functions.c @@ -812,6 +812,9 @@ static int vlan_get_link_parse(struct nl_msg *msg, void *arg) idx = *(int *)nla_data(tb[IFLA_LINK]); free(nl_arg->iface); nl_arg->iface = malloc(IFNAMSIZ + 1); + if (!nl_arg->iface) + goto err; + if (!if_indextoname(idx, nl_arg->iface)) goto err;

1 0

[batman-adv] master: batman-adv: Fix lock for ogm cnt access in batadv_iv_ogm_calc_tq (9a3b1954)
by postmaster＠open-mesh.org 04 Dec '17

04 Dec '17

Repository : ssh://git@open-mesh.org/batman-adv On branch : master >--------------------------------------------------------------- commit 9a3b195410e5d2f285cdf0073fef721ff8d9474d Author: Sven Eckelmann <sven(a)narfation.org> Date: Sun Dec 3 11:26:45 2017 +0100 batman-adv: Fix lock for ogm cnt access in batadv_iv_ogm_calc_tq The originator node object orig_neigh_node is used to when accessing the bcast_own(_sum) and real_packet_count information. The access to them has to be protected with the spinlock in orig_neigh_node. But the function uses the lock in orig_node instead. This is incorrect because they could be two different originator node objects. Fixes: f14416760b62 ("batman-adv: protect bit operations to count OGMs with spinlock") Signed-off-by: Sven Eckelmann <sven(a)narfation.org> Signed-off-by: Simon Wunderlich <sw(a)simonwunderlich.de> >--------------------------------------------------------------- 9a3b195410e5d2f285cdf0073fef721ff8d9474d net/batman-adv/bat_iv_ogm.c | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/net/batman-adv/bat_iv_ogm.c b/net/batman-adv/bat_iv_ogm.c index 1b659ab6..bbe8414b 100644 --- a/net/batman-adv/bat_iv_ogm.c +++ b/net/batman-adv/bat_iv_ogm.c @@ -1214,7 +1214,7 @@ static bool batadv_iv_ogm_calc_tq(struct batadv_orig_node *orig_node, orig_node->last_seen = jiffies; /* find packet count of corresponding one hop neighbor */ - spin_lock_bh(&orig_node->bat_iv.ogm_cnt_lock); + spin_lock_bh(&orig_neigh_node->bat_iv.ogm_cnt_lock); if_num = if_incoming->if_num; orig_eq_count = orig_neigh_node->bat_iv.bcast_own_sum[if_num]; neigh_ifinfo = batadv_neigh_ifinfo_new(neigh_node, if_outgoing); @@ -1224,7 +1224,7 @@ static bool batadv_iv_ogm_calc_tq(struct batadv_orig_node *orig_node, } else { neigh_rq_count = 0; } - spin_unlock_bh(&orig_node->bat_iv.ogm_cnt_lock); + spin_unlock_bh(&orig_neigh_node->bat_iv.ogm_cnt_lock); /* pay attention to not get a value bigger than 100 % */ if (orig_eq_count > neigh_rq_count)

1 0

[linux-merge]linux integration; annotated tag, v4.15-rc2, created. v4.15-rc2
by postmaster＠open-mesh.org 03 Dec '17

03 Dec '17

The annotated tag, v4.15-rc2 has been created at 9f92a4865a74b206034b1358b226a1237ad7e6c9 (tag) tagging ae64f9bd1d3621b5e60d7363bc20afb46aede215 (commit) replaces v4.15-rc1 tagged by Linus Torvalds on Sun Dec 3 11:02:00 2017 -0500 - Shortlog ------------------------------------------------------------ Linux 4.15-rc2 -----BEGIN PGP SIGNATURE----- iQEcBAABAgAGBQJaJB/4AAoJEHm+PkMAQRiGszoIAIZniwYijqbvutnB8GR5FtJD 3lbIIw9UWD654NSnWTQ5kswahm82daNPyRNh7REULwRxYjGnxOP/zwg55l04Jwfh fzcilE/QCdwEGcFxG5d/dqQQ13WiqzRkR8BH+jL1HtK199FMxAS2X0iZyaFprvsM S5mYUAPN5rYr1SqZmJv2SI4rXL+oGJXPTgk8r72qLHyoQcdnyirmMLb9CawO6YGA JsgwGUbC5fCli8W0yPmOEKEp67E85zQ27B9SeHq8dNLr+ITbbnWy+NSWqGa13fc4 xuq7SGV9jiq3iumcFQ0PCEzJeCOSEpFVXhJ/eYG09beZ5EugMxqTbnT9hxrrcKc= =JFxM -----END PGP SIGNATURE----- ----------------------------------------------------------------------- -- linux integration

1 0

[alfred] master: alfred: Convert README to reStructuredText (6be59ad)
by postmaster＠open-mesh.org 01 Dec '17

01 Dec '17

Repository : ssh://git@open-mesh.org/alfred On branch : master >--------------------------------------------------------------- commit 6be59adc442f5385690013442a73ef6c50c0296a Author: Sven Eckelmann <sven(a)narfation.org> Date: Mon Nov 20 15:04:32 2017 +0100 alfred: Convert README to reStructuredText The current format of the file is not well defined. The reStructuredText format (as used by other batman-adv related files) has the benefit that it is similar easy to read and write. And it allows other tools to parse the content of the file and convert it in a sensible way to a different file format. Multiple git repository web-based management software also can directly render these files as properly formatted HTML output. Signed-off-by: Sven Eckelmann <sven(a)narfation.org> >--------------------------------------------------------------- 6be59adc442f5385690013442a73ef6c50c0296a README => README.rst | 311 +++++++++++++++++++++++++++------------------------ 1 file changed, 164 insertions(+), 147 deletions(-) diff --git a/README b/README.rst similarity index 55% rename from README rename to README.rst index 28f3dc9..d7446a3 100644 --- a/README +++ b/README.rst @@ -1,12 +1,17 @@ +.. SPDX-License-Identifier: GPL-2.0 + +============================================================== A.L.F.R.E.D - Almighty Lightweight Fact Remote Exchange Daemon --------------------------------------------------------------- +============================================================== + + "alfred is a user space daemon to efficiently[tm] flood the network with + useless data - like vis, weather data, network notes, etc" + + - Marek Lindner, 2012 -"alfred is a user space daemon to efficiently[tm] flood the network with - useless data - like vis, weather data, network notes, etc" - - Marek Lindner, 2012 Introduction ------------- +============ alfred is a user space daemon for distributing arbitrary local information over the mesh/network in a decentralized fashion. This data can be anything which @@ -24,47 +29,51 @@ information available from all alfred servers in the network. Alternatively, alfred can be configured to distribute the local information via IPv4 multicast. This is configured by setting the IPv4 multicast group address in the -4 option. + Compilation ------------ +=========== alfred depends on: - * librt (usually part of libc) - * IPv6 support in the kernel/host system - * libnl-3 - support for netlink sockets - * libnl-3-genl - support for generic netlink messages + +* librt (usually part of libc) +* IPv6 support in the kernel/host system +* libnl-3 - support for netlink sockets +* libnl-3-genl - support for generic netlink messages and optionally: - * libgps - if you want to distribute GPS information - * libcap - if you want extra security by dropping unneeded privileges -To compile alfred, simply type: +* libgps - if you want to distribute GPS information +* libcap - if you want extra security by dropping unneeded privileges + +To compile alfred, simply type:: - $ make + $ make -This will compile alfred, batadv-vis & alfred-gpsd. To install, use +This will compile alfred, batadv-vis & alfred-gpsd. To install, use:: - $ make install + $ make install (with the right privileges). -If you don't want to compile batadv-vis, add the directive CONFIG_ALFRED_VIS=n: +If you don't want to compile batadv-vis, add the directive CONFIG_ALFRED_VIS=n:: - $ make CONFIG_ALFRED_VIS=n - $ make CONFIG_ALFRED_VIS=n install + $ make CONFIG_ALFRED_VIS=n + $ make CONFIG_ALFRED_VIS=n install If you don't want to compile alfred-gpsd, add the directive -CONFIG_ALFRED_GPSD=n: +CONFIG_ALFRED_GPSD=n:: + + $ make CONFIG_ALFRED_GPSD=n + $ make CONFIG_ALFRED_GPSD=n install - $ make CONFIG_ALFRED_GPSD=n - $ make CONFIG_ALFRED_GPSD=n install +If don't want to compile with libcap to drop privileges, use:: -If don't want to compile with libcap to drop privileges, use: + $ make CONFIG_ALFRED_CAPABILITIES=n + $ make CONFIG_ALFRED_CAPABILITIES=n install - $ make CONFIG_ALFRED_CAPABILITIES=n - $ make CONFIG_ALFRED_CAPABILITIES=n install Usage ------ +===== First, alfred must run as daemon (server) in background to be used. This can either be done by some init-scripts from your distribution (if you have @@ -97,14 +106,14 @@ having all nodes in master mode is possible (for maximum decentrality and overhead). To put it together, let us start alfred in master mode on our bridge br0 -(assuming that this bridge includes the batman interface bat0): +(assuming that this bridge includes the batman interface bat0):: - $ alfred -i br0 -m + $ alfred -i br0 -m Now that the server is running, let us input some data. This can be done by -using the alfred binary in client mode from the command line: +using the alfred binary in client mode from the command line:: - $ cat /etc/hostname | alfred -s 64 + $ cat /etc/hostname | alfred -s 64 This will set the hostname as data for datatype 64. Note that 0 - 63 are reserved (please send us an e-mail if you want to register a datatype), and can @@ -113,12 +122,13 @@ to assign a version to your data which can be filtered by other alfred users. Skipping the parameter entirely has the same effect as setting the parameter to 0 ('-V 0'). -After the hostname has been set on a few alfred hosts, the can be retrieved again: +After the hostname has been set on a few alfred hosts, the can be retrieved +again:: - $ alfred -r 64 -{ "fe:f1:00:00:01:01", "OpenWRT-node-1\x0a" }, -{ "fe:f1:00:00:02:01", "OpenWRT-node-2\x0a" }, -{ "fe:f1:00:00:03:01", "OpenWRT-node-3\x0a" }, + $ alfred -r 64 + { "fe:f1:00:00:01:01", "OpenWRT-node-1\x0a" }, + { "fe:f1:00:00:02:01", "OpenWRT-node-2\x0a" }, + { "fe:f1:00:00:03:01", "OpenWRT-node-3\x0a" }, Note that the information must be periodically written again to alfred, otherwise it will timeout and alfred will forget about it (after 10 minutes). @@ -129,8 +139,9 @@ unix sockets (client connects and talks to servers). On the other hand, "slaves" and "masters" are the roles alfred can take over in the network between different machines (slaves send information to masters). + Vis ---- +=== batadv-vis can be used to visualize your batman-adv mesh network. It read the neighbor information and local client table and distributes this information via @@ -139,98 +150,100 @@ the whole picture of the network. batadv-vis, similar to to alfred, combines server (daemon) and client functionality in the 'batadv-vis' binary. The batadv-vis server must be started -to let batadv-vis work: +to let batadv-vis work:: - $ batadv-vis -i bat0 -s + $ batadv-vis -i bat0 -s This server will read the neighbor and client information from batman-adv every 10 seconds and set it in alfred via unix socket. Obviously, the alfred server must run too to get this information set. -To get a graphviz-compatible vis output, simply type: - $ batadv-vis -digraph { - subgraph "cluster_fe:f0:00:00:04:01" { - "fe:f0:00:00:04:01" - } - "fe:f0:00:00:04:01" -> "fe:f0:00:00:05:01" [label="1.000"] - "fe:f0:00:00:04:01" -> "fe:f0:00:00:03:01" [label="1.004"] - "fe:f0:00:00:04:01" -> "00:00:43:05:00:04" [label="TT"] - "fe:f0:00:00:04:01" -> "fe:f1:00:00:04:01" [label="TT"] - subgraph "cluster_fe:f0:00:00:02:01" { - "fe:f0:00:00:02:01" - } - "fe:f0:00:00:02:01" -> "fe:f0:00:00:03:01" [label="1.000"] - "fe:f0:00:00:02:01" -> "fe:f0:00:00:01:01" [label="1.008"] - "fe:f0:00:00:02:01" -> "fe:f0:00:00:08:01" [label="1.000"] - "fe:f0:00:00:02:01" -> "fe:f1:00:00:02:01" [label="TT"] - "fe:f0:00:00:02:01" -> "00:00:43:05:00:02" [label="TT"] - subgraph "cluster_fe:f0:00:00:08:01" { - "fe:f0:00:00:08:01" - } -[...] -} - -For a json line formatted output, use: - - $ batadv-vis -f json -{ "primary" : "fe:f0:00:00:04:01" } -{ "router" : "fe:f0:00:00:04:01", "neighbor" : "fe:f0:00:00:05:01", "label" : "1.000" } -{ "router" : "fe:f0:00:00:04:01", "neighbor" : "fe:f0:00:00:03:01", "label" : "1.008" } -{ "router" : "fe:f0:00:00:04:01", "gateway" : "00:00:43:05:00:04", "label" : "TT" } -{ "router" : "fe:f0:00:00:04:01", "gateway" : "fe:f1:00:00:04:01", "label" : "TT" } -{ "primary" : "fe:f0:00:00:02:01" } -{ "router" : "fe:f0:00:00:02:01", "neighbor" : "fe:f0:00:00:03:01", "label" : "1.000" } -{ "router" : "fe:f0:00:00:02:01", "neighbor" : "fe:f0:00:00:01:01", "label" : "1.016" } -{ "router" : "fe:f0:00:00:02:01", "neighbor" : "fe:f0:00:00:08:01", "label" : "1.000" } -{ "router" : "fe:f0:00:00:02:01", "gateway" : "fe:f1:00:00:02:01", "label" : "TT" } -{ "router" : "fe:f0:00:00:02:01", "gateway" : "00:00:43:05:00:02", "label" : "TT" } -{ "primary" : "fe:f0:00:00:08:01" } -[...] - -and for output where the complete document is json, use: - - $ batadv-vis -f jsondoc -{ - "source_version" : "2013.3.0-14-gcd34783", - "algorithm" : 4, - "vis" : [ - { "primary" : "fe:f0:00:00:04:01", - "neighbors" : [ - { "router" : "fe:f0:00:00:04:01", - "neighbor" : "fe:f0:00:00:05:01", - "metric" : "1.000" }, - { "router" : "fe:f0:00:00:04:01", - "neighbor" : "fe:f0:00:00:03:01", - "metric" : "1.008" } - ], - "clients" : [ - "00:00:43:05:00:04", - "fe:f1:00:00:04:01" - ] - }, - { "primary" : "fe:f0:00:00:02:01", - "neighbors" : [ - { "router" : "fe:f0:00:00:02:01", - "neighbor" : "fe:f0:00:00:03:01", - "metric" : "1.000" }, - { "router" : "fe:f0:00:00:02:01", - "neighbor" : "fe:f0:00:00:01:01", - "metric" : "1.016" }, - { "router" : "fe:f0:00:00:02:01", - "neighbor" : "fe:f0:00:00:08:01", - "metric" : "1.000" } - ], - "clients" : [ - "fe:f1:00:00:02:01", - "00:00:43:05:00:02" - ] - }, - { "primary" : "fe:f0:00:00:08:01", -[...] +To get a graphviz-compatible vis output, simply type:: + + $ batadv-vis + digraph { + subgraph "cluster_fe:f0:00:00:04:01" { + "fe:f0:00:00:04:01" + } + "fe:f0:00:00:04:01" -> "fe:f0:00:00:05:01" [label="1.000"] + "fe:f0:00:00:04:01" -> "fe:f0:00:00:03:01" [label="1.004"] + "fe:f0:00:00:04:01" -> "00:00:43:05:00:04" [label="TT"] + "fe:f0:00:00:04:01" -> "fe:f1:00:00:04:01" [label="TT"] + subgraph "cluster_fe:f0:00:00:02:01" { + "fe:f0:00:00:02:01" + } + "fe:f0:00:00:02:01" -> "fe:f0:00:00:03:01" [label="1.000"] + "fe:f0:00:00:02:01" -> "fe:f0:00:00:01:01" [label="1.008"] + "fe:f0:00:00:02:01" -> "fe:f0:00:00:08:01" [label="1.000"] + "fe:f0:00:00:02:01" -> "fe:f1:00:00:02:01" [label="TT"] + "fe:f0:00:00:02:01" -> "00:00:43:05:00:02" [label="TT"] + subgraph "cluster_fe:f0:00:00:08:01" { + "fe:f0:00:00:08:01" + } + [...] + } + +For a json line formatted output, use:: + + $ batadv-vis -f json + { "primary" : "fe:f0:00:00:04:01" } + { "router" : "fe:f0:00:00:04:01", "neighbor" : "fe:f0:00:00:05:01", "label" : "1.000" } + { "router" : "fe:f0:00:00:04:01", "neighbor" : "fe:f0:00:00:03:01", "label" : "1.008" } + { "router" : "fe:f0:00:00:04:01", "gateway" : "00:00:43:05:00:04", "label" : "TT" } + { "router" : "fe:f0:00:00:04:01", "gateway" : "fe:f1:00:00:04:01", "label" : "TT" } + { "primary" : "fe:f0:00:00:02:01" } + { "router" : "fe:f0:00:00:02:01", "neighbor" : "fe:f0:00:00:03:01", "label" : "1.000" } + { "router" : "fe:f0:00:00:02:01", "neighbor" : "fe:f0:00:00:01:01", "label" : "1.016" } + { "router" : "fe:f0:00:00:02:01", "neighbor" : "fe:f0:00:00:08:01", "label" : "1.000" } + { "router" : "fe:f0:00:00:02:01", "gateway" : "fe:f1:00:00:02:01", "label" : "TT" } + { "router" : "fe:f0:00:00:02:01", "gateway" : "00:00:43:05:00:02", "label" : "TT" } + { "primary" : "fe:f0:00:00:08:01" } + [...] + +and for output where the complete document is json, use:: + + $ batadv-vis -f jsondoc + { + "source_version" : "2013.3.0-14-gcd34783", + "algorithm" : 4, + "vis" : [ + { "primary" : "fe:f0:00:00:04:01", + "neighbors" : [ + { "router" : "fe:f0:00:00:04:01", + "neighbor" : "fe:f0:00:00:05:01", + "metric" : "1.000" }, + { "router" : "fe:f0:00:00:04:01", + "neighbor" : "fe:f0:00:00:03:01", + "metric" : "1.008" } + ], + "clients" : [ + "00:00:43:05:00:04", + "fe:f1:00:00:04:01" + ] + }, + { "primary" : "fe:f0:00:00:02:01", + "neighbors" : [ + { "router" : "fe:f0:00:00:02:01", + "neighbor" : "fe:f0:00:00:03:01", + "metric" : "1.000" }, + { "router" : "fe:f0:00:00:02:01", + "neighbor" : "fe:f0:00:00:01:01", + "metric" : "1.016" }, + { "router" : "fe:f0:00:00:02:01", + "neighbor" : "fe:f0:00:00:08:01", + "metric" : "1.000" } + ], + "clients" : [ + "fe:f1:00:00:02:01", + "00:00:43:05:00:02" + ] + }, + { "primary" : "fe:f0:00:00:08:01", + [...] + Alfred-gpsd ------------ +=========== Alfred-gpsd can be used to distibute GPS location information about your batman-adv mesh network. This information could be, for example, @@ -242,31 +255,32 @@ on the command line, which is useful for static nodes without a GPS. Alfred-gpsd, similar to to alfred, combines server (daemon) and client functionality in the 'alfred-gpsd' binary. The alfred-gpsd server must be started to distribute location information. When retrieving -location information from gpsd, it should be started with: +location information from gpsd, it should be started with:: - $ alfred-gpsd -s + $ alfred-gpsd -s -For a static location, use: +For a static location, use:: - $ alfred-gpsd -s -l 48.858222,2.2945,358 + $ alfred-gpsd -s -l 48.858222,2.2945,358 This server will set the location in alfred via unix socket. Obviously, the alfred server must run too to get this information set. When using gpsd, it updates alfred every 2 seconds. With a static location, the update it made every 5 minutes. -To get JSON formatted output, use: +To get JSON formatted output, use:: - $ alfred-gpsd -[ - { "source" : "f6:00:48:13:d3:1e", "tpv" : {"class":"TPV","tag":"RMC","device":"/dev/ttyACM0","mode":3,"time":"2013-10-01T10:43:20.000Z","ept":0.005,"lat":52.575485000,"lon":-1.339716667,"alt":122.500,"epx":10.199,"epy":15.720,"epv":31.050,"track":0.0000,"speed":0.010,"climb":0.000,"eps":31.44} }, - { "source" : "8e:4c:77:b3:65:b4", "tpv" : {"class":"TPV","device":"command line","time":"2013-10-01T10:43:05.129Z","lat":48.858222,"lon":2.2945,"alt":358.000000,"mode":3} } -] + $ alfred-gpsd + [ + { "source" : "f6:00:48:13:d3:1e", "tpv" : {"class":"TPV","tag":"RMC","device":"/dev/ttyACM0","mode":3,"time":"2013-10-01T10:43:20.000Z","ept":0.005,"lat":52.575485000,"lon":-1.339716667,"alt":122.500,"epx":10.199,"epy":15.720,"epv":31.050,"track":0.0000,"speed":0.010,"climb":0.000,"eps":31.44} }, + { "source" : "8e:4c:77:b3:65:b4", "tpv" : {"class":"TPV","device":"command line","time":"2013-10-01T10:43:05.129Z","lat":48.858222,"lon":2.2945,"alt":358.000000,"mode":3} } + ] See gpsd_json(5) for documentation of the tpv object. + Running alfred as non-root user -------------------------------- +=============================== Alfred currently requires special capabilities and access rights to work correctly. The user root is normally the only user having these @@ -274,25 +288,26 @@ capabilities/rights on a standard Linux system. Operations requiring special capabilities: - * bind to device - * creating the unix socket - * accessing the debugfs filesystem +* bind to device +* creating the unix socket +* accessing the debugfs filesystem The first operation can still be executed when the admin grants the special capability CAP_NET_RAW+CAP_NET_ADMIN to anyone executing the alfred binary. The unix socket can also be moved using the parameter '-u' to a different -directory which can be accessed by the user. +directory which can be accessed by the user:: - $ sudo setcap cap_net_admin,cap_net_raw+ep alfred - $ ./alfred -u alfred.sock -i eth0 + $ sudo setcap cap_net_admin,cap_net_raw+ep alfred + $ ./alfred -u alfred.sock -i eth0 The user running alfred must still be in a group which is allowed to access /sys/kernel/debugfs to correctly choose best neighbors for communication. It is possible (but not recommended) to disable the neighbor selection/prioritization using the parameter '-b none'. + License -------- +======= alfred, batadv-vis and alfred-gpsd are licensed under the terms of version 2 of the GNU General Public License (GPL). Please see the LICENSE file. @@ -303,23 +318,25 @@ programs to include this header file (e.g. for communicating with alfred via unix sockets) without enforcing the restrions of the GPL license on this third party program. + Contact -------- +======= As alfred was developed to help on batman-adv, we share communication channels. Please send us comments, experiences, questions, anything :) -IRC: #batman on irc.freenode.org -Mailing-list: b.a.t.m.a.n(a)lists.open-mesh.org (optional subscription - at https://lists.open-mesh.org/mm/listinfo/b.a.t.m.a.n) +IRC: + #batman on irc.freenode.org +Mailing-list: + b.a.t.m.a.n(a)open-mesh.org (optional subscription at + https://lists.open-mesh.org/mm/listinfo/b.a.t.m.a.n) -If you have test reports/patches/ideas, please read the wiki for further instruction -on how to contribute: +If you have test reports/patches/ideas, please read the wiki for further +instruction on how to contribute: https://www.open-mesh.org/projects/open-mesh/wiki/Contribute You can also contact the Authors: -Simon Wunderlich <sw(a)simonwunderlich.de> -Sven Eckelmann <sven(a)open-mesh.com> - +* Marek Lindner <mareklindner(a)neomailbox.ch> +* Simon Wunderlich <sw(a)simonwunderlich.de>

1 0

[alfred] master: alfred: Convert CHANGELOG to reStructuredText (943fd99)
by postmaster＠open-mesh.org 01 Dec '17

01 Dec '17

Repository : ssh://git@open-mesh.org/alfred On branch : master >--------------------------------------------------------------- commit 943fd999f664d1072136a88cd57c4ba15b4ad27c Author: Sven Eckelmann <sven(a)narfation.org> Date: Mon Nov 20 14:50:25 2017 +0100 alfred: Convert CHANGELOG to reStructuredText The current format of the file is not well defined. The reStructuredText format (as used by other batman-adv related files) has the benefit that it is similar easy to read and write. And it allows other tools to parse the content of the file and convert it in a sensible way to a different file format. Multiple git repository web-based management software also can directly render these files as properly formatted HTML output. Signed-off-by: Sven Eckelmann <sven(a)narfation.org> >--------------------------------------------------------------- 943fd999f664d1072136a88cd57c4ba15b4ad27c CHANGELOG | 169 -------------------------------------------------------- CHANGELOG.rst | 175 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 175 insertions(+), 169 deletions(-) diff --git a/CHANGELOG b/CHANGELOG deleted file mode 100644 index c7018fb..0000000 --- a/CHANGELOG +++ /dev/null @@ -1,169 +0,0 @@ -alfred 2017.3: - - * reduction of memory usage when using --update-command - - -- Thu, 28 Sep 2017 13:43:18 +0200 - -alfred 2017.2: - - * reduce cpu load when rating multiple master servers - * coding style cleanups and refactoring - - -- Fri, 28 Jul 2017 13:45:50 +0200 - -alfred 2017.1: - - * (no changes) - - -- Tue, 23 May 2017 11:40:21 +0200 - -alfred 2017.0: - - * support IPv4 multicast distribution - * coding style cleanups - - -- Tue, 28 Feb 2017 17:22:49 +0100 - -alfred 2016.5: - - * support interface validity checks on systems without debugfs - * remove debugfs check during batadv-vis startup - * allow out-of-order txend packets during transmissions - - -- Thu, 15 Dec 2016 18:11:55 +0100 - -alfred 2016.4: - - * add expert option to specify sync interval - * fix various bugs in batadv-vis netlink integration - * fix build build problems with libnl-tiny - - -- Thu, 27 Oct 2016 21:22:32 +0200 - -alfred 2016.3: - - * integrate support for batman-adv netlink - - -- Thu, 01 Sep 2016 16:18:35 +0200 - -alfred 2016.2: - - * add support for automatic debugfs mount with enabled - CONFIG_ALFRED_CAPABILITIES - - -- Thu, 09 Jun 2016 16:21:19 +0200 - -alfred 2016.1: - - * add support for master servers to receive push_data packets with foreign - source addresses - * various code cleanups - * bugs squashed: - - ignore invalid EUI64 addresses - - -- Thu, 21 Apr 2016 14:09:12 +0200 - -alfred 2016.0: - - * various code and documentation cleanups - - -- Tue, 19 Jan 2016 16:44:26 +0100 - -alfred 2015.2: - - * mention libcap in the README - * Fix typos - - -- Mon, 23 Nov 2015 20:35:20 +0100 - -alfred 2015.1: - - * add support to run on interfaces with multiple link-local addresses - * various code cleanups - * bugs squashed: - - reduce of maximum payload size to always fit into UDP datagrams - - -- Tue, 04 Aug 2015 14:59:10 +0200 - -alfred 2015.0: - - * add support to call commands after data was updated - * automatic reduction of process capabilities when not needed anymore - * allow printing of the data version number in the alfred client mode - * various code cleanups - * bugs squashed: - - update of the version number when data was updated with different - version number - - tighten size check on received packet - - -- Tue, 28 Apr 2015 20:39:51 +0200 - -alfred 2014.4.0: - - * add support for multiple interfaces per master - * add support for changing interfaces on the fly - * changes to support multiple alfred interfaces: - - bind alfred to a specific interface - - allow configuring the unix socket path - * enhanced debugging - - -- Wed, 31 Dec 2014 00:40:42 +0100 - -alfred 2014.3.0: - - * fix various possible memleak, access errors and strncpy issues - * handle fcntl return codes - * fix altitude verification check in gpsd - - -- Mon, 21 Jul 2014 16:53:01 +0200 - -alfred 2014.2.0: - - * Handle EPERM errors on every sendto - * Check for changed interface properties, e.g. recreation or - changed MAC- and IPv6 addresses - - -- Thu, 15 May 2014 19:41:44 +0200 - -alfred 2014.1.0: - - * don't leak socket fd in batadv-vis - - -- Thu, 13 Mar 2014 12:10:26 +0100 - -alfred 2014.0.0: - - * add installation of the alfred-gpsd manpage - * add -lm to linker flags for libgps in alfred-gpsd - - -- Sat, 04 Jan 2014 20:17:07 +0100 - -alfred 2013.4.0: - - * add new json output format for vis - * add gps location information service for alfred - * allow network interface to vanish and return without restart - * allow to switch between master and slave operation without restart - * renamed vis to batadv-vis to avoid collisions with other vis binaries - * add manpages - * various code cleanups - * bugs squashed: - - * handle failing write() in unix sockets - * Fix crash when vis opened empty file - - -- Sun, 13 Oct 2013 22:55:43 +0200 - -alfred 2013.3.0: - - * initial release of alfred after beta (synced release cycle with - batman-adv) - * allows to share arbitrary local information over a (mesh) network - * initial support for vis (previously in-kernel feature of batman-adv - to visualize the network) included - * easy but flexible communication interface to allow data applications - of all kinds - * two-tiered architecture (master and slaves) - * exchanges data via IPv6 unicast/multicast - - -- Sun, 28 Jul 2013 18:56:52 +0200 diff --git a/CHANGELOG.rst b/CHANGELOG.rst new file mode 100644 index 0000000..c559f54 --- /dev/null +++ b/CHANGELOG.rst @@ -0,0 +1,175 @@ +.. SPDX-License-Identifier: GPL-2.0 + +2017.3 (2017-09-28) +=================== + +* reduction of memory usage when using --update-command + + +2017.2 (2017-07-28) +=================== + +* reduce cpu load when rating multiple master servers +* coding style cleanups and refactoring + + +2017.1 (2017-05-23) +=================== + +* (no changes) + + +2017.0 (2017-02-28) +=================== + +* support IPv4 multicast distribution +* coding style cleanups + + +2016.5 (2016-12-15) +=================== + +* support interface validity checks on systems without debugfs +* remove debugfs check during batadv-vis startup +* allow out-of-order txend packets during transmissions + + +2016.4 2016-10-27) +=================== + +* add expert option to specify sync interval +* fix various bugs in batadv-vis netlink integration +* fix build build problems with libnl-tiny + + +2016.3 (2016-09-01) +=================== + +* integrate support for batman-adv netlink + + +2016.2 (2016-06-09) +=================== + +* add support for automatic debugfs mount with enabled + CONFIG_ALFRED_CAPABILITIES + + +2016.1 (2016-04-21) +=================== + +* add support for master servers to receive push_data packets with foreign + source addresses +* various code cleanups +* bugs squashed: + + - ignore invalid EUI64 addresses + + +2016.0 (2016-01-19) +=================== + +* various code and documentation cleanups + + +2015.2 (2015-11-23) +=================== + +* mention libcap in the README +* Fix typos + + +2015.1 (2015-08-04) +=================== + +* add support to run on interfaces with multiple link-local addresses +* various code cleanups +* bugs squashed: + + - reduce of maximum payload size to always fit into UDP datagrams + + +2015.0 (2015-04-28) +=================== + +* add support to call commands after data was updated +* automatic reduction of process capabilities when not needed anymore +* allow printing of the data version number in the alfred client mode +* various code cleanups +* bugs squashed: + + - update of the version number when data was updated with different + version number + - tighten size check on received packet + + +2014.4.0 (2014-12-31) +===================== + +* add support for multiple interfaces per master +* add support for changing interfaces on the fly +* changes to support multiple alfred interfaces: + + - bind alfred to a specific interface + - allow configuring the unix socket path + +* enhanced debugging + + +2014.3.0 (2014-07-21) +===================== + +* fix various possible memleak, access errors and strncpy issues +* handle fcntl return codes +* fix altitude verification check in gpsd + + +2014.2.0 (2014-05-15) +===================== + +* Handle EPERM errors on every sendto +* Check for changed interface properties, e.g. recreation or + changed MAC- and IPv6 addresses + + +2014.1.0 (2014-03-13) +===================== + +* don't leak socket fd in batadv-vis + + +2014.0.0 (2014-01-04) +===================== + +* add installation of the alfred-gpsd manpage +* add -lm to linker flags for libgps in alfred-gpsd + + +2013.4.0 (2013-10-13) +===================== + +* add new json output format for vis +* add gps location information service for alfred +* allow network interface to vanish and return without restart +* allow to switch between master and slave operation without restart +* renamed vis to batadv-vis to avoid collisions with other vis binaries +* add manpages +* various code cleanups +* bugs squashed: + + - handle failing write() in unix sockets + - Fix crash when vis opened empty file + + +2013.3.0 (2013-07-28) +===================== + +* initial release of alfred after beta (synced release cycle with + batman-adv) +* allows to share arbitrary local information over a (mesh) network +* initial support for vis (previously in-kernel feature of batman-adv + to visualize the network) included +* easy but flexible communication interface to allow data applications + of all kinds +* two-tiered architecture (master and slaves) +* exchanges data via IPv6 unicast/multicast

1 0

[batman-adv] ecsv/rst, master: batman-adv: Convert README to reStructuredText (dce473cd)
by postmaster＠open-mesh.org 01 Dec '17

01 Dec '17

Repository : ssh://git@open-mesh.org/batman-adv On branches: ecsv/rst,master >--------------------------------------------------------------- commit dce473cda936636961c390730c22457c93adaca3 Author: Sven Eckelmann <sven(a)narfation.org> Date: Mon Nov 20 17:12:54 2017 +0100 batman-adv: Convert README to reStructuredText The current format of the file is not well defined. The reStructuredText format (as used by other batman-adv related files) has the benefit that it is similar easy to read and write. And it allows other tools to parse the content of the file and convert it in a sensible way to a different file format. Multiple git repository web-based management software also can directly render these files as properly formatted HTML output. Signed-off-by: Sven Eckelmann <sven(a)narfation.org> >--------------------------------------------------------------- dce473cda936636961c390730c22457c93adaca3 README.external | 51 --------------------------------------------- README.external.rst | 59 +++++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 59 insertions(+), 51 deletions(-) diff --git a/README.external b/README.external deleted file mode 100644 index 03f08ad1..00000000 --- a/README.external +++ /dev/null @@ -1,51 +0,0 @@ -BATMAN-ADV external module --------------------------- - -The batman-adv module is shipped as part of the Linux kernel -and as external module. The external module allows to get -new features without upgrading to a newer kernel version -and to get batman-adv specific bugfixes for kernels that are -not supported anymore. It compiles against and should work -with Linux 3.2 - 4.14. Supporting older versions is not -planned, but it's probably easy to backport it. If you work on a -backport, feel free to contact us. :-) - -COMPILE -------- - -To compile against your currently installed kernel, just type: - -# make - -if you want to compile against some other kernel, use: - -# make KERNELPATH=/path/to/kernel - -if you want to install this module: - -# sudo make install - -CONFIGURATION -------------- - -The in-kernel module can be configured through -menuconfig. When compiling outside of the kernel tree, it is -necessary to configure it using the make options. Each -option can be set to to y (enabled), n (disabled) or m (build as -module). Available options and their possible values are -(default marked with an "*") - - * CONFIG_BATMAN_ADV_DEBUGFS=[y*|n] (B.A.T.M.A.N. debugfs entries) - * CONFIG_BATMAN_ADV_DEBUG=[y|n*] (B.A.T.M.A.N. debugging) - * CONFIG_BATMAN_ADV_BLA=[y*|n] (B.A.T.M.A.N. bridge loop avoidance) - * CONFIG_BATMAN_ADV_DAT=[y*|n] (B.A.T.M.A.N. Distributed ARP Table) - * CONFIG_BATMAN_ADV_MCAST=[y*|n] (B.A.T.M.A.N. multicast optimizations) - * CONFIG_BATMAN_ADV_NC=[y|n*] (B.A.T.M.A.N. Network Coding) - * CONFIG_BATMAN_ADV_BATMAN_V=[y|n*] (B.A.T.M.A.N. V routing algorithm) - -e.g., debugging can be enabled by - -# make CONFIG_BATMAN_ADV_DEBUG=y - -Keep in mind that all options must also be added to "make -install" call. diff --git a/README.external.rst b/README.external.rst new file mode 100644 index 00000000..40a00452 --- /dev/null +++ b/README.external.rst @@ -0,0 +1,59 @@ +.. SPDX-License-Identifier: GPL-2.0 + +========================== +BATMAN-ADV external module +========================== + +Introduction +============ + +The batman-adv module is shipped as part of the Linux kernel +and as external module. The external module allows to get +new features without upgrading to a newer kernel version +and to get batman-adv specific bugfixes for kernels that are +not supported anymore. It compiles against and should work +with Linux 3.2 - 4.14. Supporting older versions is not +planned, but it's probably easy to backport it. If you work on a +backport, feel free to contact us. :-) + + +COMPILE +======= + +To compile against your currently installed kernel, just type:: + + # make + +if you want to compile against some other kernel, use:: + + # make KERNELPATH=/path/to/kernel + +if you want to install this module:: + + # sudo make install + + +CONFIGURATION +============= + +The in-kernel module can be configured through +menuconfig. When compiling outside of the kernel tree, it is +necessary to configure it using the make options. Each +option can be set to to y (enabled), n (disabled) or m (build as +module). Available options and their possible values are +(default marked with an "*") + + * ``CONFIG_BATMAN_ADV_DEBUGFS=[y*|n]`` (B.A.T.M.A.N. debugfs entries) + * ``CONFIG_BATMAN_ADV_DEBUG=[y|n*]`` (B.A.T.M.A.N. debugging) + * ``CONFIG_BATMAN_ADV_BLA=[y*|n]`` (B.A.T.M.A.N. bridge loop avoidance) + * ``CONFIG_BATMAN_ADV_DAT=[y*|n]`` (B.A.T.M.A.N. Distributed ARP Table) + * ``CONFIG_BATMAN_ADV_MCAST=[y*|n]`` (B.A.T.M.A.N. multicast optimizations) + * ``CONFIG_BATMAN_ADV_NC=[y|n*]`` (B.A.T.M.A.N. Network Coding) + * ``CONFIG_BATMAN_ADV_BATMAN_V=[y|n*]`` (B.A.T.M.A.N. V routing algorithm) + +e.g., debugging can be enabled by:: + + # make CONFIG_BATMAN_ADV_DEBUG=y + +Keep in mind that all options must also be added to ``make install`` +call.

1 0

[batman-adv] ecsv/rst, master: batman-adv: Convert CHANGELOG to reStructuredText (cf64a04f)
by postmaster＠open-mesh.org 01 Dec '17

01 Dec '17

Repository : ssh://git@open-mesh.org/batman-adv On branches: ecsv/rst,master >--------------------------------------------------------------- commit cf64a04f05fed86cf04f3713da1efd230f8d7608 Author: Sven Eckelmann <sven(a)narfation.org> Date: Mon Nov 20 17:27:26 2017 +0100 batman-adv: Convert CHANGELOG to reStructuredText The current format of the file is not well defined. The reStructuredText format (as used by other batman-adv related files) has the benefit that it is similar easy to read and write. And it allows other tools to parse the content of the file and convert it in a sensible way to a different file format. Multiple git repository web-based management software also can directly render these files as properly formatted HTML output. Signed-off-by: Sven Eckelmann <sven(a)narfation.org> >--------------------------------------------------------------- cf64a04f05fed86cf04f3713da1efd230f8d7608 CHANGELOG | 634 ------------------------------------------------------- CHANGELOG.rst | 666 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 666 insertions(+), 634 deletions(-) diff --git a/CHANGELOG b/CHANGELOG deleted file mode 100644 index b32d1d09..00000000 --- a/CHANGELOG +++ /dev/null @@ -1,634 +0,0 @@ -batman-adv 2017.3 - - * support latest kernels (3.2 - 4.14) - * coding style cleanups and refactoring - * bugs squashed: - - fix TT sync flag inconsistencies - - ignore invalid throughput values from wifi interfaces - - -- Thu, 28 Sep 2017 13:43:18 +0200 - -batman-adv 2017.2 - - * support latest kernels (3.2 - 4.13) - * avoid bridge loop detection mac addresses in translation tables - * coding style cleanups and refactoring - * bugs squashed: - - ignore invalid throughput values from wifi interfaces - - -- Fri, 28 Jul 2017 13:38:45 +0200 - -batman-adv 2017.1 - - * support latest kernels (3.2 - 4.12) - * bridge loop avoidance improvements for various corner cases - * reduction of maximum fragment size - * coding style cleanups and refactoring - * bugs squashed: - - fix rx packet/bytes stats on local DAT ARP reply - - -- Tue, 23 May 2017 11:40:21 +0200 - -batman-adv 2017.0.1 - - * support latest kernels (3.2 - 4.11) - * bugs squashed: - - avoid API incompatibilities with new EWMA implementation - - generate equally size fragments to reduce chance of padding or MTU problems - - fix initialization of gateway sel class when BATMAN_V is compiled in - - -- Tue, 07 Mar 2017 16:33:11 +0100 - -batman-adv 2017.0 - - * support latest kernels (3.2 - 4.11) - * remove bridge loop avoidance addresses from translation table - * allow to build B.A.T.M.A.N. V without cfg80211 integration on Linux < 3.16 - * coding style cleanups and refactoring - * bugs squashed: - - fix interface reference counter on fragmentation errors - - avoid double free on fragment merge error - - fix support for up to 16 fragments - - fix build of multicast compatibility code on some architectures - - -- Tue, 28 Feb 2017 17:22:49 +0100 - -batman-adv 2016.5 - - * support latest kernels (3.2 - 4.10) - * change installation path back to $INSTALL_MOD_DIR/updates/net/batman-adv - * add simple (re)broadcast avoidance - * reduce multicast TT and TVLV update delays under B.A.T.M.A.N. V - * support B.A.T.M.A.N. V throughput detection when using VLANs on top of WiFi - * improve documentation of sysfs and debugfs files - * coding style cleanups and refactoring - * bugs squashed: - - detect missing primaryif during tp_send as error - - fix re-adding of previously removed interfaces via rtnetlink - - fix rare race conditions on interface removal - - handle allocation error when generating TT responses - - -- Thu, 15 Dec 2016 18:11:55 +0100 - -batman-adv 2016.4 - - * support latest kernels (3.2 - 4.9) - * add GW selection algorithm for B.A.T.M.A.N. V - * add support for querying most tables/lists via netlink - * adjusted device modifications for easier handling via rtnl (ip-link) - * disabled (bad) debugfs support in network namespaces - * add improved compat-patches support (note the new build directory) - * reduced translation table memory consumption - * coding style cleanups and refactoring - * bugs squashed: - - avoid locking problems when modifying interfaces - - fix sysfs errors on fast device deletion/creation events - - add missing memory barriers for neighbor list modifications - - fix tpmeter debug log output - - -- Thu, 27 Oct 2016 21:12:07 +0200 - -batman-adv 2016.3 - - * support latest kernels (3.2 - 4.8) - * multicast optimization support for bridged setups - * initial, limited support for batman-adv netlink family - * throughput meter implementation - * support for frame priority in fragment packets - * kernel doc updates and coding style cleanups - * bugs squashed: - - fix (re-)initialization of ELP tweaking options - - fix elp packet data reservation - - fix nullptr dereference after using vlan_insert_tag - - fix various reference counting bugs in bonding, bla, tt and - originator code - - fix speedy join in gateway client mode - - -- Thu, 01 Sep 2016 16:12:26 +0200 - -batman-adv 2016.2 - - * support latest kernels (3.2 - 4.7) - * initial, limited support for network namespaces - * kernel doc updates and coding style cleanups - * cleanup of legacy kernel compat code - * support for detection and reporting of complex bridge loops - * bugs squashed: - - fix some TT issues: double free for full table request structs - (created problems on multi-core systems) and a double put of VLAN - objects - - fix various B.A.T.M.A.N. V issues: fix mac address after address - change, ELP orig address on secondary interfaces, null pointer - dereference in metric comparison, refcount issues, ... - - fix skb deref after transmission - - avoid duplicate neigh_node additions - - replace WARN with rate limited output on non-existing VLAN - - fix ICMP RR ethernet header access after skb_linearize - - fix memleak of untagged vlan when removing interface via rtnl-link - - fix build against Debian Stretch kernels - - -- Thu, 09 Jun 2016 15:37:44 +0200 - -batman-adv 2016.1 - - * support latest kernels (3.2 - 4.6) - * drop support for older kernels 2.6.29 - 3.1 - * B.A.T.M.A.N. V routing algorithm support - * kernel doc updates and coding style cleanups - * conversion to the kref based reference counting framework - * bugs squashed: - - fix endless loop in bat-on-bat netdevice check when using veth - - fix various reference counting issues - - init neigh node last seen field - - fix integer overflow in batadv_iv_ogm_calc_tq - - fix broadcast/ogm queue limit on a removed interface - - fix DAT candidate selection to use VID - - fix unexpected free of bcast_own on add_if error - - check skb size before using encapsulated ETH+VLAN header - - -- Thu, 21 Apr 2016 14:10:38 +0200 - -batman-adv 2016.0 - - * support latest kernels (2.6.29 - 4.5) - * add list of unique single hop neighbors and export it via debugfs - * massive kernel doc updates and coding style cleanups - * redesign/fix RCU handling when cleaning up to avoid bad memory access - * increase bridge loop avoidance wait time to 60 seconds - * remove bridge loop avoidance state when it gets disabled - * support for interfaces which switch from non-ethernet to ethernet mode - * bugs squashed: - - fix lockdep splat when doing mcast_free or batadv_tlv_container_remove - - fix invalid memory access when shrinking buffer for the OGM-return-rate - measurement on interface removal - - -- Tue, 19 Jan 2016 17:02:46 +0100 - -batman-adv 2015.2 - - * support latest kernels (2.6.29 - 4.4) - * cleanup of coding style and kernel docs - * fix includes in various files - * add lower layer head/tail room to avoid problems when slave devices - encapsulate packets and have not enough space available - * fix hard_header_len which allows sending packets shorter than 64byte - * Remove obsolete deleted attribute for gateway node to simplify - code and avoid delayed free of structures referenced by the gateway - * Add lockdep asserts to find locking problems - * bugs squashed: - - Fix gw_bandwidth calculation on 32 bit systems - - prevent potential hlist double deletion - - fix soft interface access on unload - - fix invalid stack access in DAT - - lock CRC access in bridge loop avoidance - - fix TT client duplicate detection with VLANs - - fix excess VLANs in TT requests - - avoid keeping false temporary TT entries - - fix TT speedy join for DAT cache replies - - fix TT memory leak on add with invalid VLAN - - -- Mon, 23 Nov 2015 20:25:19 +0100 - -batman-adv 2015.1 - - * support latest kernels (2.6.29 - 4.2) - * cleanup of coding style - * cleanup of the compatibility layer - * convert to the Linux source directory structure - * adjust default configuration - - disable network coding - - enable bridge loop avoidance - * bugs squashed: - - avoid DAT to mess up local LAN state - - fix race conditions in DAT/NC/TT/MCAST TVLV handlers - - fix build system POSIX compatibility - - fix gateway selection in fast connection (1) gw_mode - - fix initialization of detected gateway, which caused hangs on unloads - - fix race conditions in the translation table - - fix kernel crash due to missing NULL checks in vlan handlers - - fix potentially broken header access by multicast optimization - - fix broadcast packets cleanup for purged outgoing interface - - -- Tue, 04 Aug 2015 14:34:42 +0200 - -batman-adv 2015.0 - - * support latest kernels (2.6.29 - 4.1) - * cleanup of coding style and add kerneldoc - * bugs squashed: - - fix incorrect lockdep warning in network coding - - fix condition when bonding should be used - - fix support of bridged batman-adv devices with kernel < 2.6.39 - - -- Tue, 28 Apr 2015 20:20:02 +0200 - -batman-adv 2014.4.0 - - * support latest kernels (2.6.29 - 3.19) - * double default hop penalty - * bugs squashed: - - fix wrong size calculations and out of order support in - fragmentation (fixes CVE-2014-9428) - - fix double fetch in RCU for old kernels (<3.9) - - fix NULL dereference and check in gateway code - - fix multicast counters - - fix network coding SKB control block initialization - - fix last_seen initialization for orig nodes - - -- Mon, 05 Jan 2015 20:03:39 +0100 - -batman-adv 2014.3.0 - - * support latest kernels (2.6.29 - 3.16) - * drop QinQ claim frames in bridge loop avoidance - * fix a bogus warning from batadv_is_on_batman_iface() - * removed SET_ETHTOOL_OPS - * style improvements: - - remove semi-colon after macro definition - - add blank line between declarations and the rest of the code - - -- Mon, 21 Jul 2014 16:02:17 +0200 - -batman-adv 2014.2.0 - - * support latest kernels (2.6.29 - 3.15) - * add multicast optimization for certain type of multicast networks - to send data only to nodes actually registered using new TVLVs - and the translation table - * use ether_addr_copy instead of memcpy - * remove obsolete reset mac headers - * bugs squashed: - - fix various (reference counting) bugs introduced by the multi - interface optimization - - fix a reference count problem when sending fragmented packets - - count references for originator nodes referenced by gateway - - fix local TT check for outgoing arp requests in DAT - - fix TT inconsistencies when VLANs are re-created very fast - - update TT entries for each VLAN when the MAC address of the - parent interface is changed - - improve documentation of DAT, TT and general kerneldoc - - -- Thu, 15 May 2014 19:36:10 +0200 - -batman-adv 2014.1.0 - - * support latest kernels (2.6.29 - 3.14) - * add mesh wide multi interface optimization, which replaces the old - interface alternating and bonding features with a new network wide - implementation - * add mesh wide client isolation based on fwmark by using and - propagating the new isolation flag in TT - * send every DHCP packet as bat-unicast when gateway feature is used - * add new build checks for packet sizes to avoid architecture dependent - problems - * bugs squashed: - - deselect current gateway when switching away from client mode - - fix batman-adv header MTU calculation - - fix potential paging error for unicast transmissions - - fix vlan refcounter imbalance on failure paths - - fix TT-TVLV parsing and a TVLV leak - - fix TT CRC computation by ensuring byte order - - fix function names, paranthesis, comments, warnings, chachacha ... - - -- Thu, 13 Mar 2014 12:08:00 +0100 - -batman-adv 2014.0.0 - - * support latest kernels (2.6.29 - 3.13) - * This release contains major rework to allow better backward compatibility - in the future. Unfortunately these changes require a bump of the compat - version to 15, making this and future releases incompatible to the previous - releases. - * add TVLV container infrastructure for OGMs and TT packets - * remove vis functionality (replaced by userspace tool alfred) - * reorder packet types and flags in packet types - * move some packet members (gw flags, TT, ...) into TVLV containers - * rewrite the fragementation code for more fragments (up to 16), more - general usage (not only unicast packets) and reassembly on the way - * add VLAN awareness to TT, DAT and AP isolation - * use CRC32 instead of CRC16 for TT - * generalize many functions (neighbor comparison, etc) to prepare - code-sharing of BATMAN IV and BATMAN V - * set SKB priority according to content (for correct WMM classification) - * add a dummy soft-interface rx mode handler to allow static multicast - listeners - * bugs squashed: - - various packet alignment and size fixes (especially on ARM) - - white space, typos, kernel doc, etc - - improve backward compatibility code - - -- Sat, 04 Jan 2014 20:20:05 +0100 - -batman-adv 2013.4.0 - - * support latest kernels (2.6.29 - 3.12) - * bugs squashed: - - fix potential kernel paging errors for unicast transmissions - - fix network coding initialization for multiple soft interfaces - - fix BLA VLAN handling regression - - improve backward compatibility code - - -- Sun, 13 Oct 2013 18:50:11 +0200 - -batman-adv 2013.3.0: - - * support latest kernels (2.6.29 - 3.11) - * send each broadcast only once on non-wireless interfaces - * change VID handling to prepare enhanced VLAN features - * bugs squashed: - - forward late OGMs from best next hop - - avoid double free of bat_counters - - fix rcu barrier miss - - use the proper header len when checking the TTVN - - make DAT drop ARP requests targeting local clients - * style improvements, code moving and refactoring - - -- Sat, 20 Jul 2013 22:06:46 +0200 - -batman-adv 2013.2.0: - - * support latest kernels (2.6.29 - 3.10) - * add network coding feature - * add rtnl interface configuration support - * fix rtnl and sysfs locking issue - * avoid duplicate interface enslaving - * bugs squashed: - - verify tt len to not exceed packet len - - fix identification of own mac addresses - * style improvements (change seq_printf to seq_puts) - - -- Sat, 20 Apr 2013 16:42:51 +0200 - -batman-adv 2013.1.0: - - * support latest kernels (2.6.29 - 3.9) - * add lots of kerneldoc in types.h - * clean up (kerneldoc alignment, group tt definitions, renaming, ...) - * TT improvements: - - add CRC to debugging tables - - ignore multicast addresses - - reduce local TT timeout from 1 hour to 10 minutes - * Initialize lockdep class keys for hashes - * unbloat bat_priv if debug is not enabled - * bugs squashed - - fix possible sysfs/rtnl deadlock when deregistering - - fix some DAT bugs (skb leak, invalid MAC addresses, NULL pointer dereference) - - -- Sat, 02 Mar 2013 16:02:00 +0100 - -batman-adv 2013.0.0: - -* support latest kernels (2.6.29 - 3.8) -* cleanup of coding style and add kerneldoc -* add new distributed ARP table feature to cache ARP entries -* remove __packed attribute whenever possible to allow better compiler - optimizations -* use kernel-registered BATMAN Ethernet type -* block ECTP traffic to remove integration problems when using BLA -* allow roaming multiple times in TT -* bugs squashed - - fix lockdeps for interfaces - - disallow batman-over-batman configurations - - various BLA fixes (wait at startup, hashing, duplist, ...) - - fix TT roaming cases - - fix TT packet rerouting - - fix TT flags handling - - fix speedy join/BLA interaction bug - - fix random jitter calculation - - -- Sat, 12 Jan 2013 12:00:16 +0100 - -batman-adv 2012.4.0: - -* support latest kernels (2.6.29 - 3.7) -* cleanup of coding style -* integration of remaining packet counters in ethtool statistic -* speedy join of new non-mesh clients based on broadcast packets -* added bridge loop avoidance backbone gateway debugfs table -* workaround for kernel bug when running on top of vlan device -* bugs squashed - - announcement of own MAC address after modification - - wrong counting of received OGMs on x86 - - route flapping in multiple interfaces setup - - receiving of translation table requests for foreign nodes - - invalid memory access after failure during the interface appending - - wrong calculation of packet crc which lead to dropping of broadcast - packets when bridge loop avoidance is enabled - - -- Mon, 29 Oct 2012 16:47:05 +0100 - -batman-adv 2012.3.0: - -* support latest kernels (2.6.29 - 3.6) -* added namespace-like prefix for all batman-adv symbols -* integrated extended statistic support using ethtool -* important bugs fixed - - correct endianness for translation table crc - - avoid race condition in translation table replacements - - ensure gateway gets selected - - allow broadcasts with enabled AP isolation - - fix vis output for multiple interface configurations - - fix race condition during adds in hashes - - fix dropped DHCP packets with enabled bridge loop avoidance and gateway - support - - don't leak information through uninitialized packets fields - - -- Sun, 19 Aug 2012 21:28:23 +0200 - -batman-adv 2012.2.0: - -* support latest kernels (2.6.29 - 3.5) -* cleanup of coding style (use of named constants instead of values, refactored - code to reduce readability, replace bitarrays with kernel functionality, ...) -* tweaking hop penalty to reduce route flapping -* enhanced the framework to support multiple routing algorithms -* reimplemented the bridge loop avoidance with support for multiple active - backbone gateways -* some bugs fixed (translation table flag handling, correct unicast rerouting, - endianness fixed for translation table crc, avoid of routing loops by being - strict on forwarded ogms, ...) - - -- Tue, 12 Jun 2012 18:21:54 +0200 - -batman-adv 2012.1.0: - -* support latest kernels (2.6.29 - 3.4) -* makefile rewrite (install target, cleanups, new selection system for features) -* cleanup of coding style (explicit marking of common headers, common unit for - time specific defines, ...) -* Added framework to switch between different routing algorithms -* some bugs fixes (distinguish between wrap-around ttvn and uninitialized ttvn - value, ...) - - -- Fri, 30 Mar 2012 19:31:12 +0300 - -batman-adv 2012.0.0: - -* support latest kernels (2.6.29 - 3.3) -* Fix bat_socket_read memory corruption (CVE-2011-4604) -* Cleanup of gateway handling code -* many bugs (hang when softif creation fails, memory leaks when hashes - table cannot be filled, wrong filter for missed ogms, many smaller - translation table problems, ...) fixed - - -- Sun, 05 Feb 2012 15:06:08 +0100 - -batman-adv 2011.4.0: - -* support latest kernels (2.6.29 - 3.2) -* starting of code refactoring to support multiple protocol versions -* added support for AP-isolation to prevent non-mesh WIFI clients to talk to - each other over the mesh -* some bugs (memory leaks in the translation table, wrong initialization of - ethernet addresses of translation table entries, ...) squashed - - -- Sun, 13 Nov 2011 20:40:05 +0100 - -batman-adv 2011.3.1: - -* don't send all packets to selected gateway as broadcast -* prevent translation table corruptions caused by uninitialized memory and - invalid sizes send through client announcement mechanism - - -- Tue, 18 Oct 2011 20:40:59 +0200 - -batman-adv 2011.3.0: - -* support latest kernels (2.6.29 - 3.1) -* remove compat code for < 2.6.29 -* cleanup of coding style -* improve client and roaming announcement mechanisms -* add framework to inform userspace of gateway changes using uevent -* improve gateway handling to filter out incoming DHCP renewal requests -* many bugs (acceptance of delayed rebroadcasts, unsigned char on powerpc used - to store -1, ...) squashed - - -- Sun, 21 Aug 2011 14:49:20 +0200 - -batman-adv 2011.2.0: - -* support latest kernels (2.6.21 - 3.0) -* cleanup of coding style -* rename of HNA to TT -* support for multi vlan in bridge loop detection -* many bug fixes (rcu protection of router/primary_if/softif_neigh, - race condition in TQ calculation, deadlock when creating new mesh - interfaces, ...) - - -- Sun, 19 Jun 2011 20:07:47 +0200 - -batman-adv 2011.1.0: - -* support latest kernels (2.6.21 - 2.6.39) -* cleanup of coding style -* removal of the big orig_hash lock and usage of fine grained locking -* many bug fixes (fragmented packets linearisation, fragments numbering, - verification of added interfaces, ...) - - -- Sun, 17 Apr 2011 17:41:53 +0200 - -batman-adv 2011.0.0: - -* support latest kernels (2.6.21 - 2.6.38) -* conversion of reference counting to kref -* allow merging and refragmentation of unicast packets during transfers -* add softif bridge loop detection -* make hop_penalty configurable through sysfs -* reimplement most of the batman-adv hash functionality -* support for optimized DHCP based gateway selection -* cleanup of the sysfs code - - -- Sat, 29 Jan 2011 20:08:05 +0100 - -batman-adv 2010.2.0: - -* support latest kernels (2.6.21 - 2.6.37) -* further cleanup of coding style -* new rcu and referenced based interface management -* support for multiple mesh clouds -* create packets directly in socket buffers -* add layer2 unicast packet fragmentation -* usage of optimised kernel functionality for ogm counting -* many bugs (false warnings, processing of big ogms, ...) squashed - - -- Sun, 21 Nov 2010 21:02:40 +0100 - -batman-adv 2010.1.0: - -* support latest kernels (2.6.21 - 2.6.36) -* further cleanup of coding style -* recording of routes for batman icmp messages -* move of complex sysfs files to debugfs -* change output of all sysfs files to single-value-only -* reintroduce virtual file for the debug log -* bonding and alternating added -* add ttl to broadcasts -* change all sequence numbers to 32 bit -* show last-seen in originator table -* many bugs (rounding issues, locking, netdev event handler, ...) squashed - - -- Sat, 04 Sep 2010 13:56:38 +0200 - -batman-adv 2010.0.0: - -* support latest kernels (2.6.21 - 2.6.35) -* further code refactoring and cleaning for coding style -* move from procfs based configuration to sysfs -* reorganized sequence number handling -* limit queue lengths for batman and broadcast packets -* many bugs (endless loop and rogue packets on shutdown, wrong tcpdump output, - missing frees in error situations, sleeps in atomic contexts) squashed - - -- Fri, 18 Jun 2010 21:34:26 +0200 - -batman-adv 0.2.1: - -* support latest kernels (2.6.20 - 2.6.33) -* receive packets directly using skbs, remove old sockets and threads -* fix various regressions in the vis server -* don't disable interrupts while sending -* replace internal logging mechanism with standard kernel logging -* move vis formats into userland, one general format remains in the kernel -* allow MAC address to be set, correctly initialize them -* code refactoring and cleaning for coding style -* many bugs (null pointers, locking, hash iterators) squashed - - -- Sun, 21 Mar 2010 20:46:47 +0100 - -batman-adv 0.2: - -* support latest kernels (2.6.20 - 2.6.31) -* temporary routing loops / TTL code bug / ghost entries in originator table fixed -* internal packet queue for packet aggregation & transmission retry (ARQ) - for payload broadcasts added -* interface detection converted to event based handling to avoid timers -* major linux coding style adjustments applied -* all kernel version compatibility functions has been moved to compat.h -* use random ethernet address generator from the kernel -* /sys/module/batman_adv/version to export kernel module version -* vis: secondary interface export for dot draw format + JSON output format added -* many bugs (alignment issues, race conditions, deadlocks, etc) squashed - - -- Sat, 07 Nov 2009 15:44:31 +0100 - -batman-adv 0.1: - -* support latest kernels (2.6.20 - 2.6.28) -* LOTS of cleanup: locking, stack usage, memory leaks -* Change Ethertype from 0x0842 to 0x4305 - unregistered at IEEE, if you want to sponsor an official Ethertype ($2500) - please contact us - - -- Sun, 28 Dec 2008 00:44:31 +0100 - -batman-adv 0.1-beta: - -* layer 2 meshing based on BATMAN TQ algorithm in kernelland -* operates on any ethernet like interface -* supports IPv4, IPv6, DHCP, etc -* is controlled via /proc/net/batman-adv/ -* bridging via brctl is supported -* interface watchdog (interfaces can be (de)activated dynamically) -* offers integrated vis server which meshes/syncs with other vis servers in range - - -- Mon, 05 May 2008 14:10:04 +0200 diff --git a/CHANGELOG.rst b/CHANGELOG.rst new file mode 100644 index 00000000..16eb6e6d --- /dev/null +++ b/CHANGELOG.rst @@ -0,0 +1,666 @@ +.. SPDX-License-Identifier: GPL-2.0 + +2017.3 (2017-09-28) +=================== + +* support latest kernels (3.2 - 4.14) +* coding style cleanups and refactoring +* bugs squashed: + + - fix TT sync flag inconsistencies + - ignore invalid throughput values from wifi interfaces + + +2017.2 (2017-07-28) +=================== + +* support latest kernels (3.2 - 4.13) +* avoid bridge loop detection mac addresses in translation tables +* coding style cleanups and refactoring +* bugs squashed: + + - ignore invalid throughput values from wifi interfaces + + +2017.1 (2017-05-23) +=================== + +* support latest kernels (3.2 - 4.12) +* bridge loop avoidance improvements for various corner cases +* reduction of maximum fragment size +* coding style cleanups and refactoring +* bugs squashed: + + - fix rx packet/bytes stats on local DAT ARP reply + + +2017.0.1 (2017-03-07) +===================== + +* support latest kernels (3.2 - 4.11) +* bugs squashed: + + - avoid API incompatibilities with new EWMA implementation + - generate equally size fragments to reduce chance of padding or MTU problems + - fix initialization of gateway sel class when BATMAN_V is compiled in + + +2017.0 (2017-02-28) +=================== + +* support latest kernels (3.2 - 4.11) +* remove bridge loop avoidance addresses from translation table +* allow to build B.A.T.M.A.N. V without cfg80211 integration on Linux < 3.16 +* coding style cleanups and refactoring +* bugs squashed: + + - fix interface reference counter on fragmentation errors + - avoid double free on fragment merge error + - fix support for up to 16 fragments + - fix build of multicast compatibility code on some architectures + + +2016.5 (2016-12-15) +=================== + +* support latest kernels (3.2 - 4.10) +* change installation path back to $INSTALL_MOD_DIR/updates/net/batman-adv +* add simple (re)broadcast avoidance +* reduce multicast TT and TVLV update delays under B.A.T.M.A.N. V +* support B.A.T.M.A.N. V throughput detection when using VLANs on top of WiFi +* improve documentation of sysfs and debugfs files +* coding style cleanups and refactoring +* bugs squashed: + + - detect missing primaryif during tp_send as error + - fix re-adding of previously removed interfaces via rtnetlink + - fix rare race conditions on interface removal + - handle allocation error when generating TT responses + + +2016.4 (2016-10-27) +=================== + +* support latest kernels (3.2 - 4.9) +* add GW selection algorithm for B.A.T.M.A.N. V +* add support for querying most tables/lists via netlink +* adjusted device modifications for easier handling via rtnl (ip-link) +* disabled (bad) debugfs support in network namespaces +* add improved compat-patches support (note the new build directory) +* reduced translation table memory consumption +* coding style cleanups and refactoring +* bugs squashed: + + - avoid locking problems when modifying interfaces + - fix sysfs errors on fast device deletion/creation events + - add missing memory barriers for neighbor list modifications + - fix tpmeter debug log output + + +2016.3 (2016-09-01) +=================== + +* support latest kernels (3.2 - 4.8) +* multicast optimization support for bridged setups +* initial, limited support for batman-adv netlink family +* throughput meter implementation +* support for frame priority in fragment packets +* kernel doc updates and coding style cleanups +* bugs squashed: + + - fix (re-)initialization of ELP tweaking options + - fix elp packet data reservation + - fix nullptr dereference after using vlan_insert_tag + - fix various reference counting bugs in bonding, bla, tt and + originator code + - fix speedy join in gateway client mode + + +2016.2 (2016-06-09) +=================== + +* support latest kernels (3.2 - 4.7) +* initial, limited support for network namespaces +* kernel doc updates and coding style cleanups +* cleanup of legacy kernel compat code +* support for detection and reporting of complex bridge loops +* bugs squashed: + + - fix some TT issues: double free for full table request structs + (created problems on multi-core systems) and a double put of VLAN + objects + - fix various B.A.T.M.A.N. V issues: fix mac address after address + change, ELP orig address on secondary interfaces, null pointer + dereference in metric comparison, refcount issues, ... + - fix skb deref after transmission + - avoid duplicate neigh_node additions + - replace WARN with rate limited output on non-existing VLAN + - fix ICMP RR ethernet header access after skb_linearize + - fix memleak of untagged vlan when removing interface via rtnl-link + - fix build against Debian Stretch kernels + + +2016.1 (2016-04-21) +=================== + +* support latest kernels (3.2 - 4.6) +* drop support for older kernels 2.6.29 - 3.1 +* B.A.T.M.A.N. V routing algorithm support +* kernel doc updates and coding style cleanups +* conversion to the kref based reference counting framework +* bugs squashed: + + - fix endless loop in bat-on-bat netdevice check when using veth + - fix various reference counting issues + - init neigh node last seen field + - fix integer overflow in batadv_iv_ogm_calc_tq + - fix broadcast/ogm queue limit on a removed interface + - fix DAT candidate selection to use VID + - fix unexpected free of bcast_own on add_if error + - check skb size before using encapsulated ETH+VLAN header + + +2016.0 (2016-01-19) +=================== + +* support latest kernels (2.6.29 - 4.5) +* add list of unique single hop neighbors and export it via debugfs +* massive kernel doc updates and coding style cleanups +* redesign/fix RCU handling when cleaning up to avoid bad memory access +* increase bridge loop avoidance wait time to 60 seconds +* remove bridge loop avoidance state when it gets disabled +* support for interfaces which switch from non-ethernet to ethernet mode +* bugs squashed: + + - fix lockdep splat when doing mcast_free or batadv_tlv_container_remove + - fix invalid memory access when shrinking buffer for the OGM-return-rate + measurement on interface removal + + +2015.2 (2015-11-23) +=================== + +* support latest kernels (2.6.29 - 4.4) +* cleanup of coding style and kernel docs +* fix includes in various files +* add lower layer head/tail room to avoid problems when slave devices + encapsulate packets and have not enough space available +* fix hard_header_len which allows sending packets shorter than 64byte +* Remove obsolete deleted attribute for gateway node to simplify + code and avoid delayed free of structures referenced by the gateway +* Add lockdep asserts to find locking problems +* bugs squashed: + + - Fix gw_bandwidth calculation on 32 bit systems + - prevent potential hlist double deletion + - fix soft interface access on unload + - fix invalid stack access in DAT + - lock CRC access in bridge loop avoidance + - fix TT client duplicate detection with VLANs + - fix excess VLANs in TT requests + - avoid keeping false temporary TT entries + - fix TT speedy join for DAT cache replies + - fix TT memory leak on add with invalid VLAN + + +2015.1 (2015-08-04) +=================== + +* support latest kernels (2.6.29 - 4.2) +* cleanup of coding style +* cleanup of the compatibility layer +* convert to the Linux source directory structure +* adjust default configuration + + - disable network coding + - enable bridge loop avoidance + +* bugs squashed: + + - avoid DAT to mess up local LAN state + - fix race conditions in DAT/NC/TT/MCAST TVLV handlers + - fix build system POSIX compatibility + - fix gateway selection in fast connection (1) gw_mode + - fix initialization of detected gateway, which caused hangs on unloads + - fix race conditions in the translation table + - fix kernel crash due to missing NULL checks in vlan handlers + - fix potentially broken header access by multicast optimization + - fix broadcast packets cleanup for purged outgoing interface + + +2015.0 (2015-04-28) +=================== + +* support latest kernels (2.6.29 - 4.1) +* cleanup of coding style and add kerneldoc +* bugs squashed: + - fix incorrect lockdep warning in network coding + - fix condition when bonding should be used + - fix support of bridged batman-adv devices with kernel < 2.6.39 + + +2014.4.0 (2015-01-05) +===================== + +* support latest kernels (2.6.29 - 3.19) +* double default hop penalty +* bugs squashed: + + - fix wrong size calculations and out of order support in + fragmentation (fixes CVE-2014-9428) + - fix double fetch in RCU for old kernels (<3.9) + - fix NULL dereference and check in gateway code + - fix multicast counters + - fix network coding SKB control block initialization + - fix last_seen initialization for orig nodes + + +2014.3.0 (2014-07-21) +===================== + +* support latest kernels (2.6.29 - 3.16) +* drop QinQ claim frames in bridge loop avoidance +* fix a bogus warning from batadv_is_on_batman_iface() +* removed SET_ETHTOOL_OPS +* style improvements: + + - remove semi-colon after macro definition + - add blank line between declarations and the rest of the code + + +2014.2.0 (2014-05-15) +===================== + +* support latest kernels (2.6.29 - 3.15) +* add multicast optimization for certain type of multicast networks + to send data only to nodes actually registered using new TVLVs + and the translation table +* use ether_addr_copy instead of memcpy +* remove obsolete reset mac headers +* bugs squashed: + + - fix various (reference counting) bugs introduced by the multi + interface optimization + - fix a reference count problem when sending fragmented packets + - count references for originator nodes referenced by gateway + - fix local TT check for outgoing arp requests in DAT + - fix TT inconsistencies when VLANs are re-created very fast + - update TT entries for each VLAN when the MAC address of the + parent interface is changed + - improve documentation of DAT, TT and general kerneldoc + + +2014.1.0 (2014-03-13) +===================== + +* support latest kernels (2.6.29 - 3.14) +* add mesh wide multi interface optimization, which replaces the old + interface alternating and bonding features with a new network wide + implementation +* add mesh wide client isolation based on fwmark by using and + propagating the new isolation flag in TT +* send every DHCP packet as bat-unicast when gateway feature is used +* add new build checks for packet sizes to avoid architecture dependent + problems +* bugs squashed: + + - deselect current gateway when switching away from client mode + - fix batman-adv header MTU calculation + - fix potential paging error for unicast transmissions + - fix vlan refcounter imbalance on failure paths + - fix TT-TVLV parsing and a TVLV leak + - fix TT CRC computation by ensuring byte order + - fix function names, paranthesis, comments, warnings, chachacha ... + + +2014.0.0 (2014-01-04) +===================== + +* support latest kernels (2.6.29 - 3.13) +* This release contains major rework to allow better backward compatibility + in the future. Unfortunately these changes require a bump of the compat + version to 15, making this and future releases incompatible to the previous + releases. +* add TVLV container infrastructure for OGMs and TT packets +* remove vis functionality (replaced by userspace tool alfred) +* reorder packet types and flags in packet types +* move some packet members (gw flags, TT, ...) into TVLV containers +* rewrite the fragementation code for more fragments (up to 16), more + general usage (not only unicast packets) and reassembly on the way +* add VLAN awareness to TT, DAT and AP isolation +* use CRC32 instead of CRC16 for TT +* generalize many functions (neighbor comparison, etc) to prepare + code-sharing of BATMAN IV and BATMAN V +* set SKB priority according to content (for correct WMM classification) +* add a dummy soft-interface rx mode handler to allow static multicast + listeners +* bugs squashed: + + - various packet alignment and size fixes (especially on ARM) + - white space, typos, kernel doc, etc + - improve backward compatibility code + + +2013.4.0 (2013-10-13) +===================== + +* support latest kernels (2.6.29 - 3.12) +* bugs squashed: + + - fix potential kernel paging errors for unicast transmissions + - fix network coding initialization for multiple soft interfaces + - fix BLA VLAN handling regression + - improve backward compatibility code + + +2013.3.0 (2013-07-20) +===================== + +* support latest kernels (2.6.29 - 3.11) +* send each broadcast only once on non-wireless interfaces +* change VID handling to prepare enhanced VLAN features +* bugs squashed: + + - forward late OGMs from best next hop + - avoid double free of bat_counters + - fix rcu barrier miss + - use the proper header len when checking the TTVN + - make DAT drop ARP requests targeting local clients + +* style improvements, code moving and refactoring + + +2013.2.0 (2013-04-20) +===================== + +* support latest kernels (2.6.29 - 3.10) +* add network coding feature +* add rtnl interface configuration support +* fix rtnl and sysfs locking issue +* avoid duplicate interface enslaving +* bugs squashed: + + - verify tt len to not exceed packet len + - fix identification of own mac addresses + +* style improvements (change seq_printf to seq_puts) + + +2013.1.0 (2013-03-02) +===================== + +* support latest kernels (2.6.29 - 3.9) +* add lots of kerneldoc in types.h +* clean up (kerneldoc alignment, group tt definitions, renaming, ...) +* TT improvements: + + - add CRC to debugging tables + - ignore multicast addresses + - reduce local TT timeout from 1 hour to 10 minutes + +* Initialize lockdep class keys for hashes +* unbloat bat_priv if debug is not enabled +* bugs squashed + + - fix possible sysfs/rtnl deadlock when deregistering + - fix some DAT bugs (skb leak, invalid MAC addresses, NULL pointer dereference) + + +2013.0.0 (2013-01-12) +===================== + +* support latest kernels (2.6.29 - 3.8) +* cleanup of coding style and add kerneldoc +* add new distributed ARP table feature to cache ARP entries +* remove __packed attribute whenever possible to allow better compiler + optimizations +* use kernel-registered BATMAN Ethernet type +* block ECTP traffic to remove integration problems when using BLA +* allow roaming multiple times in TT +* bugs squashed + + - fix lockdeps for interfaces + - disallow batman-over-batman configurations + - various BLA fixes (wait at startup, hashing, duplist, ...) + - fix TT roaming cases + - fix TT packet rerouting + - fix TT flags handling + - fix speedy join/BLA interaction bug + - fix random jitter calculation + + +2012.4.0 (2012-10-29) +===================== + +* support latest kernels (2.6.29 - 3.7) +* cleanup of coding style +* integration of remaining packet counters in ethtool statistic +* speedy join of new non-mesh clients based on broadcast packets +* added bridge loop avoidance backbone gateway debugfs table +* workaround for kernel bug when running on top of vlan device +* bugs squashed + + - announcement of own MAC address after modification + - wrong counting of received OGMs on x86 + - route flapping in multiple interfaces setup + - receiving of translation table requests for foreign nodes + - invalid memory access after failure during the interface appending + - wrong calculation of packet crc which lead to dropping of broadcast + packets when bridge loop avoidance is enabled + + +2012.3.0 (2012-08-19) +===================== + +* support latest kernels (2.6.29 - 3.6) +* added namespace-like prefix for all batman-adv symbols +* integrated extended statistic support using ethtool +* important bugs fixed + + - correct endianness for translation table crc + - avoid race condition in translation table replacements + - ensure gateway gets selected + - allow broadcasts with enabled AP isolation + - fix vis output for multiple interface configurations + - fix race condition during adds in hashes + - fix dropped DHCP packets with enabled bridge loop avoidance and gateway + support + - don't leak information through uninitialized packets fields + + +2012.2.0 (2012-06-12) +===================== + +* support latest kernels (2.6.29 - 3.5) +* cleanup of coding style (use of named constants instead of values, refactored + code to reduce readability, replace bitarrays with kernel functionality, ...) +* tweaking hop penalty to reduce route flapping +* enhanced the framework to support multiple routing algorithms +* reimplemented the bridge loop avoidance with support for multiple active + backbone gateways +* some bugs fixed (translation table flag handling, correct unicast rerouting, + endianness fixed for translation table crc, avoid of routing loops by being + strict on forwarded ogms, ...) + + +2012.1.0 (2012-03-30) +===================== + +* support latest kernels (2.6.29 - 3.4) +* makefile rewrite (install target, cleanups, new selection system for features) +* cleanup of coding style (explicit marking of common headers, common unit for + time specific defines, ...) +* Added framework to switch between different routing algorithms +* some bugs fixes (distinguish between wrap-around ttvn and uninitialized ttvn + value, ...) + + +2012.0.0 (2012-02-05) +===================== + +* support latest kernels (2.6.29 - 3.3) +* Fix bat_socket_read memory corruption (CVE-2011-4604) +* Cleanup of gateway handling code +* many bugs (hang when softif creation fails, memory leaks when hashes + table cannot be filled, wrong filter for missed ogms, many smaller + translation table problems, ...) fixed + + +2011.4.0 (2011-11-13) +===================== + +* support latest kernels (2.6.29 - 3.2) +* starting of code refactoring to support multiple protocol versions +* added support for AP-isolation to prevent non-mesh WIFI clients to talk to + each other over the mesh +* some bugs (memory leaks in the translation table, wrong initialization of + ethernet addresses of translation table entries, ...) squashed + + +2011.3.1 (2011-10-18) +===================== + +* don't send all packets to selected gateway as broadcast +* prevent translation table corruptions caused by uninitialized memory and + invalid sizes send through client announcement mechanism + + +2011.3.0 (2011-08-21) +===================== + +* support latest kernels (2.6.29 - 3.1) +* remove compat code for < 2.6.29 +* cleanup of coding style +* improve client and roaming announcement mechanisms +* add framework to inform userspace of gateway changes using uevent +* improve gateway handling to filter out incoming DHCP renewal requests +* many bugs (acceptance of delayed rebroadcasts, unsigned char on powerpc used + to store -1, ...) squashed + + +2011.2.0 (2011-06-19) +===================== + +* support latest kernels (2.6.21 - 3.0) +* cleanup of coding style +* rename of HNA to TT +* support for multi vlan in bridge loop detection +* many bug fixes (rcu protection of router/primary_if/softif_neigh, + race condition in TQ calculation, deadlock when creating new mesh + interfaces, ...) + + +2011.1.0 (2011-04-17) +===================== + +* support latest kernels (2.6.21 - 2.6.39) +* cleanup of coding style +* removal of the big orig_hash lock and usage of fine grained locking +* many bug fixes (fragmented packets linearisation, fragments numbering, + verification of added interfaces, ...) + + +2011.0.0 (2011-01-29) +===================== + +* support latest kernels (2.6.21 - 2.6.38) +* conversion of reference counting to kref +* allow merging and refragmentation of unicast packets during transfers +* add softif bridge loop detection +* make hop_penalty configurable through sysfs +* reimplement most of the batman-adv hash functionality +* support for optimized DHCP based gateway selection +* cleanup of the sysfs code + + +2010.2.0 (2010-11-21) +===================== + +* support latest kernels (2.6.21 - 2.6.37) +* further cleanup of coding style +* new rcu and referenced based interface management +* support for multiple mesh clouds +* create packets directly in socket buffers +* add layer2 unicast packet fragmentation +* usage of optimised kernel functionality for ogm counting +* many bugs (false warnings, processing of big ogms, ...) squashed + + +2010.1.0 (2010-09-04) +===================== + +* support latest kernels (2.6.21 - 2.6.36) +* further cleanup of coding style +* recording of routes for batman icmp messages +* move of complex sysfs files to debugfs +* change output of all sysfs files to single-value-only +* reintroduce virtual file for the debug log +* bonding and alternating added +* add ttl to broadcasts +* change all sequence numbers to 32 bit +* show last-seen in originator table +* many bugs (rounding issues, locking, netdev event handler, ...) squashed + + +2010.0.0 (2010-06-18) +===================== + +* support latest kernels (2.6.21 - 2.6.35) +* further code refactoring and cleaning for coding style +* move from procfs based configuration to sysfs +* reorganized sequence number handling +* limit queue lengths for batman and broadcast packets +* many bugs (endless loop and rogue packets on shutdown, wrong tcpdump output, + missing frees in error situations, sleeps in atomic contexts) squashed + + +0.2.1 (2010-03-21) +================== + +* support latest kernels (2.6.20 - 2.6.33) +* receive packets directly using skbs, remove old sockets and threads +* fix various regressions in the vis server +* don't disable interrupts while sending +* replace internal logging mechanism with standard kernel logging +* move vis formats into userland, one general format remains in the kernel +* allow MAC address to be set, correctly initialize them +* code refactoring and cleaning for coding style +* many bugs (null pointers, locking, hash iterators) squashed + + +0.2 (2009-11-07) +================ + +* support latest kernels (2.6.20 - 2.6.31) +* temporary routing loops / TTL code bug / ghost entries in originator table fixed +* internal packet queue for packet aggregation & transmission retry (ARQ) + for payload broadcasts added +* interface detection converted to event based handling to avoid timers +* major linux coding style adjustments applied +* all kernel version compatibility functions has been moved to compat.h +* use random ethernet address generator from the kernel +* /sys/module/batman_adv/version to export kernel module version +* vis: secondary interface export for dot draw format + JSON output format added +* many bugs (alignment issues, race conditions, deadlocks, etc) squashed + + +0.1 (2008-12-28) +================ + +* support latest kernels (2.6.20 - 2.6.28) +* LOTS of cleanup: locking, stack usage, memory leaks +* Change Ethertype from 0x0842 to 0x4305 + unregistered at IEEE, if you want to sponsor an official Ethertype ($2500) + please contact us + + +0.1-beta (2008-05-05) +===================== + +* layer 2 meshing based on BATMAN TQ algorithm in kernelland +* operates on any ethernet like interface +* supports IPv4, IPv6, DHCP, etc +* is controlled via /proc/net/batman-adv/ +* bridging via brctl is supported +* interface watchdog (interfaces can be (de)activated dynamically) +* offers integrated vis server which meshes/syncs with other vis servers in range

1 0

[batman-adv] ecsv/rst, master: batman-adv: Add .rst to README symlink (d3e6d102)
by postmaster＠open-mesh.org 01 Dec '17

01 Dec '17

Repository : ssh://git@open-mesh.org/batman-adv On branches: ecsv/rst,master >--------------------------------------------------------------- commit d3e6d102d7330a5004342f9fb327ccb5a33bd4e3 Author: Sven Eckelmann <sven(a)narfation.org> Date: Mon Nov 20 17:10:35 2017 +0100 batman-adv: Add .rst to README symlink Web-based management software for git and editors usually only enable the parsing of reStructuredText files when they detect the file ending .rst. Signed-off-by: Sven Eckelmann <sven(a)narfation.org> >--------------------------------------------------------------- d3e6d102d7330a5004342f9fb327ccb5a33bd4e3 README => README.rst | 0 1 file changed, 0 insertions(+), 0 deletions(-) diff --git a/README b/README.rst similarity index 100% rename from README rename to README.rst

1 0

[batctl] ecsv/rst, master: batctl: Convert CHANGELOG to reStructuredText (f8779ce)
by postmaster＠open-mesh.org 01 Dec '17

01 Dec '17

Repository : ssh://git@open-mesh.org/batctl On branches: ecsv/rst,master >--------------------------------------------------------------- commit f8779cee8fe012862317eab0de1d6933bcc2e30f Author: Sven Eckelmann <sven(a)narfation.org> Date: Mon Nov 20 15:50:31 2017 +0100 batctl: Convert CHANGELOG to reStructuredText The current format of the file is not well defined. The reStructuredText format (as used by other batman-adv related files) has the benefit that it is similar easy to read and write. And it allows other tools to parse the content of the file and convert it in a sensible way to a different file format. Multiple git repository web-based management software also can directly render these files as properly formatted HTML output. Signed-off-by: Sven Eckelmann <sven(a)narfation.org> >--------------------------------------------------------------- f8779cee8fe012862317eab0de1d6933bcc2e30f CHANGELOG | 56 ------------------------------------------------------- CHANGELOG.rst | 60 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 60 insertions(+), 56 deletions(-) diff --git a/CHANGELOG b/CHANGELOG deleted file mode 100644 index af9b676..0000000 --- a/CHANGELOG +++ /dev/null @@ -1,56 +0,0 @@ -batctl 2017.3 - - * bugs squashed: - - Fix error messages on traceroute send failures - - -- Thu, 28 Sep 2017 13:43:18 +0200 - -batctl 2017.2 - - * coding style cleanups and refactoring - - -- Fri, 28 Jul 2017 13:42:03 +0200 - -batctl 2017.1 - - * (no changes) - - -- Tue, 23 May 2017 11:40:21 +0200 - -batctl 2017.0 - - * remove root check for read-only sysfs and rtnl functionality - * coding style cleanups - * bugs squashed: - - fix check for root priviliges when started under modified effective uid - - -- Tue, 28 Feb 2017 17:22:49 +0100 - -batctl 2016.5 - - * reimplement traceroute/ping commands in userspace without debugfs - * switch interface manipulation from (legacy) sysfs to rtnetlink - * coding style cleanups - - -- Thu, 15 Dec 2016 18:11:55 +0100 - -batctl 2016.4: - - * integrate support for batman-adv netlink - * coding style cleanups - * documentation updates - * bugs squashed: - - fix endless loop in TP meter on some platforms - - fix build errors caused by name conflicts - - -- Thu, 27 Oct 2016 21:19:38 +0200 - -batctl 2016.3 - - * synchronize common headers with batman-adv - * support multicast logging and debug table - * split tcpdump OGM packet filter in OGM and OGMv2 filter - * add infrastructure to communicate with batadv netlink family - * integrate command to control new kernel throughput meter - - -- Thu, 01 Sep 2016 16:18:35 +0200 diff --git a/CHANGELOG.rst b/CHANGELOG.rst new file mode 100644 index 0000000..9083816 --- /dev/null +++ b/CHANGELOG.rst @@ -0,0 +1,60 @@ +.. SPDX-License-Identifier: GPL-2.0 + +2017.3 (2017-09-28) +=================== + +* bugs squashed: + + - Fix error messages on traceroute send failures + + +2017.2 (2017-06-28) +=================== + +* coding style cleanups and refactoring + + +2017.1 (2017-05-23) +==================== + +* (no changes) + + +2017.0 (2017-02-28) +=================== + +* remove root check for read-only sysfs and rtnl functionality +* coding style cleanups +* bugs squashed: + + - fix check for root priviliges when started under modified effective uid + + +2016.5 (2016-12-15) +=================== + +* reimplement traceroute/ping commands in userspace without debugfs +* switch interface manipulation from (legacy) sysfs to rtnetlink +* coding style cleanups + + +2016.4 (2016-10-27) +=================== + +* integrate support for batman-adv netlink +* coding style cleanups +* documentation updates +* bugs squashed: + + - fix endless loop in TP meter on some platforms + - fix build errors caused by name conflicts + + +2016.3 (2016-09-01) +=================== + +* synchronize common headers with batman-adv +* support multicast logging and debug table +* split tcpdump OGM packet filter in OGM and OGMv2 filter +* add infrastructure to communicate with batadv netlink family +* integrate command to control new kernel throughput meter

1 0

[batctl] ecsv/rst, master: batctl: Convert README to reStructuredText (a5027a0)
by postmaster＠open-mesh.org 01 Dec '17

01 Dec '17

Repository : ssh://git@open-mesh.org/batctl On branches: ecsv/rst,master >--------------------------------------------------------------- commit a5027a0d565e008f704c7033ce10dcbe32dceecf Author: Sven Eckelmann <sven(a)narfation.org> Date: Mon Nov 20 17:09:52 2017 +0100 batctl: Convert README to reStructuredText The current format of the file is not well defined. The reStructuredText format (as used by other batman-adv related files) has the benefit that it is similar easy to read and write. And it allows other tools to parse the content of the file and convert it in a sensible way to a different file format. Multiple git repository web-based management software also can directly render these files as properly formatted HTML output. Signed-off-by: Sven Eckelmann <sven(a)narfation.org> >--------------------------------------------------------------- a5027a0d565e008f704c7033ce10dcbe32dceecf README | 614 ----------------------------------------------------- README.rst | 698 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 698 insertions(+), 614 deletions(-) diff --git a/README b/README deleted file mode 100644 index ce049d4..0000000 --- a/README +++ /dev/null @@ -1,614 +0,0 @@ -############################################################################## -# batctl - B.A.T.M.A.N. advanced control and management tool # -############################################################################## - - - -Introduction -============ - -Why do I need batctl ? B.A.T.M.A.N. advanced operates on layer 2 and thus all -hosts participating in the virtual switch are completely transparent for all -protocols above layer 2. Therefore the common diagnosis tools do not work as -expected. To overcome these problems batctl was created. At the moment batctl -contains ping, traceroute, tcpdump and interfaces to the kernel module -settings. - - -How does it work ? -================== - -batctl uses the debugfs/batman_adv/bat0/socket device provided by the B.A.T.M.A.N. -advanced kernel module to inject custom icmp packets into the data flow. That's why -ping and traceroute work almost like their IP based counterparts. Tcpdump was -designed because B.A.T.M.A.N. advanced encapsulates all traffic within batman -packets, so that the normal tcpdump would not recognize the packets. - - -The bat-hosts file -================== - -This file is simliar to the /etc/hosts file. You can write one MAC address and -one host name per line. batctl will analyze the file to find the matching MAC -address to your provided host name. Host names are much easier to remember than -MAC addresses. ;) - - -batctl statistics -================= - -The batman-adv kernel module maintains a number of traffic counters which are exported -to user space. With batctl these counters can be easily retrieved. The output may vary -depending on which features have been compiled into the kernel module. For example, if -the distributed arp table (short: dat) wasn't selected as an option at compile time -its counters won't be shown. -Each module subsystem has its own counters which are indicated by their prefixes: - * mgmt - mesh protocol counters - * tt - translation table counters - * dat - distributed arp table counters -All counters without a prefix concern payload (pure user data) traffic. - -Usage: batctl statistics - -Example: - -$ batctl statistics - tx: 14 - tx_bytes: 1316 - tx_errors: 0 - rx: 14 - rx_bytes: 1316 - forward: 0 - forward_bytes: 0 - mgmt_tx: 18 - mgmt_tx_bytes: 762 - mgmt_rx: 17 - mgmt_rx_bytes: 1020 - tt_request_tx: 0 - tt_request_rx: 0 - tt_response_tx: 0 - tt_response_rx: 0 - tt_roam_adv_tx: 0 - tt_roam_adv_rx: 0 - dat_request_tx: 0 - dat_request_rx: 0 - dat_reply_tx: 1 - dat_reply_rx: 0 - -batctl translate -================ - -Translates a destination (hostname, IPv4, IPv6, MAC, bat_host-name) to the -originator mac address responsible for it. - -Usage: batctl translate mac|bat-host|host-name|IP-address - -Example: - -$ batctl translate www.google.de -02:ca:fe:af:fe:01 -$ batctl translate 02:ca:fe:af:fe:01 -02:ca:fe:af:fe:01 -$ batctl translate 192.168.1.2 -02:ca:fe:af:fe:05 -$ batctl translate fe:fe:00:00:09:01 -02:ca:fe:af:fe:05 -$ batctl translate 2001::1 -02:ca:fe:af:fe:05 - -batctl ping -============ - -Sends a Layer 2 batman-adv ping to check round trip time and connectivity - -Usage: batctl ping [parameters] mac|bat-host|host-name|IP-address -parameters: - -c ping packet count - -h print this help - -i interval in seconds - -t timeout in seconds - -T don't try to translate mac to originator address - -R record route - -Example: - -$ batctl ping fe:fe:00:00:09:01 -PING fe:fe:00:00:09:01 (fe:fe:00:00:09:01) 19(47) bytes of data -19 bytes from fe:fe:00:00:09:01 icmp_seq=1 ttl=43 time=8.74 ms -19 bytes from fe:fe:00:00:09:01 icmp_seq=2 ttl=43 time=7.48 ms -19 bytes from fe:fe:00:00:09:01 icmp_seq=3 ttl=43 time=8.23 ms -^C--- fe:fe:00:00:09:01 ping statistics --- -3 packets transmitted, 3 received, 0% packet loss -rtt min/avg/max/mdev = 7.476/8.151/8.743/1.267 ms - -batctl traceroute -================== - -Traceroute sends 3 packets to each hop, awaits the answers and prints out the -response times. - -Usage: batctl traceroute [parameters] mac|bat-host|host-name|IP-address - -Example: - -$ batctl traceroute fe:fe:00:00:09:01 -traceroute to fe:fe:00:00:09:01 (fe:fe:00:00:09:01), 50 hops max, 19 byte packets - 1: fe:fe:00:00:02:01 4.932 ms 2.338 ms 1.333 ms - 2: fe:fe:00:00:03:01 6.860 ms 1.579 ms 1.260 ms - 3: fe:fe:00:00:04:01 2.342 ms 1.547 ms 1.655 ms - 4: fe:fe:00:00:05:01 2.906 ms 2.211 ms 2.253 ms - 5: fe:fe:00:00:06:01 3.577 ms 2.687 ms 3.088 ms - 6: fe:fe:00:00:07:01 4.217 ms 5.741 ms 3.551 ms - 7: fe:fe:00:00:08:01 5.017 ms 5.547 ms 4.294 ms - 8: fe:fe:00:00:09:01 5.730 ms 4.970 ms 6.437 ms - - - -batctl tcpdump -=============== - -tcpdump layer 2 and/or layer 3 traffic on the given interface - -Usage: batctl tcpdump [parameters] interface [interface] -parameters: - -c compat filter - only display packets matching own compat version (14) - -h print this help - -n don't convert addresses to bat-host names - -p dump specific packet type - -x dump all packet types except specified -packet types: - 1 - batman ogm packets - 2 - batman icmp packets - 4 - batman unicast packets - 8 - batman broadcast packets - 16 - batman unicast tvlv packets - 32 - batman fragmented packets - 64 - batman tt / roaming packets - 128 - non batman packets - 129 - batman ogm & non batman packets - -tcpdump supports standard interfaces as well as raw wifi interfaces running in monitor mode. - -Example output for tcpdump: - -$ batctl tcpdump mesh0 -01:51:42.401188 BAT kansas: OGM via neigh kansas, seqno 6718, tq 255, ttl 50, v 9, flags [..I], length 28 -01:51:42.489735 BAT kansas: OGM via neigh wyoming, seqno 6718, tq 245, ttl 49, v 9, flags [.D.], length 28 -01:51:42.510330 BAT wyoming: OGM via neigh wyoming, seqno 6721, tq 255, ttl 50, v 9, flags [..I], length 28 -01:51:42.601092 BAT wyoming: OGM via neigh kansas, seqno 6721, tq 245, ttl 49, v 9, flags [.D.], length 28 -01:51:43.361076 BAT kansas > wyoming: ICMP echo request, id 0, seq 1, ttl 1, v 9, length 19 -01:51:43.365347 BAT wyoming > kansas: ICMP echo reply, id 0, seq 1, ttl 50, v 9, length 19 -01:51:43.372224 BAT kansas > wyoming: ICMP echo request, id 0, seq 2, ttl 1, v 9, length 19 -01:51:43.376506 BAT wyoming > kansas: ICMP echo reply, id 0, seq 2, ttl 50, v 9, length 19 -01:51:43.381250 BAT kansas: OGM via neigh kansas, seqno 6719, tq 255, ttl 50, v 9, flags [..I], length 28 -01:51:43.386281 BAT kansas > wyoming: ICMP echo request, id 0, seq 3, ttl 1, v 9, length 19 -01:51:43.387910 BAT wyoming > kansas: ICMP echo reply, id 0, seq 3, ttl 50, v 9, length 19 -01:51:43.479503 BAT kansas: OGM via neigh wyoming, seqno 6719, tq 245, ttl 49, v 9, flags [.D.], length 28 -01:51:43.509899 BAT wyoming: OGM via neigh wyoming, seqno 6722, tq 255, ttl 50, v 9, flags [..I], length 28 -01:51:43.600999 BAT wyoming: OGM via neigh kansas, seqno 6722, tq 245, ttl 49, v 9, flags [.D.], length 28 -01:51:44.381064 BAT kansas: OGM via neigh kansas, seqno 6720, tq 255, ttl 50, v 9, flags [..I], length 28 - -batctl bisect_iv -================ - -Analyzes the B.A.T.M.A.N. IV logfiles to build a small internal database of all sent sequence -numbers and routing table changes. This database can be used to search for routing loops -(default action), to trace OGMs of a host (use "-t" to specify the mac address or -bat-host name) throughout the network or to display routing tables of the nodes (use "-r" to -specify the mac address or bat-host name). You can name a specific sequence number or a range -using the "-s" option to limit the output's range. Furthermore you can filter the output by -specifying an originator (use "-o" to specify the mac address or bat-host name) to only see -data connected to this originator. If "-n" was given batctl will not replace the mac -addresses with bat-host names in the output. - -Usage: batctl bisect_iv [parameters] <file1> <file2> .. <fileN> -parameters: - -h print this help - -l run a loop detection of given mac address or bat-host (default) - -n don't convert addresses to bat-host names - -r print routing tables of given mac address or bat-host - -s seqno range to limit the output - -t trace seqnos of given mac address or bat-host - -Examples: - -$ batctl bisect_iv log/* -l uml3 -Analyzing routing tables of originator: uml3 [all sequence numbers] - -Checking host: uml3 -Path towards uml7 (seqno 9 via neigh uml5): -> uml5 -> uml6 -Path towards uml7 (seqno 10 via neigh uml4): -> uml4 -> uml5 -> uml6 -Path towards uml6 (seqno 4 via neigh uml4): -> uml4 -Path towards uml8 (seqno 12 via neigh uml4): -> uml4 -> uml5 -> uml6 -> uml7 -Path towards uml8 (seqno 203 via neigh uml4): -> uml4 -> uml6 -> uml7 -Path towards uml8 (seqno 391 via neigh uml2): -> uml2 -> uml3 -> uml2 aborted due to loop! -Path towards uml8 (seqno 396 via neigh uml4): -> uml4 -> uml6 -> uml7 -Path towards uml9 (seqno 10 via neigh uml5): -> uml5 -> uml6 -> uml7 -> uml9. -Path towards uml9 (seqno 10 via neigh uml4): -> uml4 -> uml5 -> uml6 -> uml7 -> uml9. -Path towards uml9 (seqno 11 via neigh uml4): -> uml4 -> uml6 -> uml7 -> uml8 -> uml9. -Path towards uml9 (seqno 12 via neigh uml4): -> uml4 -> uml5 -> uml6 -> uml7 -> uml8 -> uml9. -Path towards uml9 (seqno 21 via neigh uml5): -> uml5 -> uml6 -> uml7 -> uml8 -> uml9. -Path towards uml9 (seqno 22 via neigh uml4): -> uml4 -> uml5 -> uml6 -> uml7 -> uml8 -> uml9. - -$ ./batctl bisect_iv -t uml3 log/* -Sequence number flow of originator: uml3 [all sequence numbers] -[...] -+=> uml3 (seqno 19) -|- uml2 [tq: 255, ttl: 50, neigh: uml3, prev_sender: uml3] -| |- uml3 [tq: 154, ttl: 49, neigh: uml2, prev_sender: uml3] -| \- uml1 [tq: 154, ttl: 49, neigh: uml2, prev_sender: uml3] -| |- uml3 [tq: 51, ttl: 48, neigh: uml1, prev_sender: uml2] -| \- uml2 [tq: 51, ttl: 48, neigh: uml1, prev_sender: uml2] -|- uml5 [tq: 255, ttl: 50, neigh: uml3, prev_sender: uml3] -| |- uml6 [tq: 33, ttl: 48, neigh: uml5, prev_sender: uml3] -| | |- uml5 [tq: 11, ttl: 47, neigh: uml6, prev_sender: uml5] -| | |- uml7 [tq: 11, ttl: 47, neigh: uml6, prev_sender: uml5] -| | | |- uml8 [tq: 3, ttl: 46, neigh: uml7, prev_sender: uml6] -| | | | |- uml6 [tq: 0, ttl: 45, neigh: uml8, prev_sender: uml7] -| | | | |- uml9 [tq: 0, ttl: 45, neigh: uml8, prev_sender: uml7] -| | | | \- uml7 [tq: 0, ttl: 45, neigh: uml8, prev_sender: uml7] -| | | |- uml6 [tq: 3, ttl: 46, neigh: uml7, prev_sender: uml6] -| | | |- uml9 [tq: 3, ttl: 46, neigh: uml7, prev_sender: uml6] -| | | \- uml5 [tq: 3, ttl: 46, neigh: uml7, prev_sender: uml6] -| | \- uml4 [tq: 11, ttl: 47, neigh: uml6, prev_sender: uml5] -| |- uml7 [tq: 33, ttl: 48, neigh: uml5, prev_sender: uml3] -| \- uml4 [tq: 33, ttl: 48, neigh: uml5, prev_sender: uml3] -\- uml4 [tq: 255, ttl: 50, neigh: uml3, prev_sender: uml3] - |- uml3 [tq: 106, ttl: 49, neigh: uml4, prev_sender: uml3] - |- uml6 [tq: 106, ttl: 49, neigh: uml4, prev_sender: uml3] - |- uml2 [tq: 106, ttl: 49, neigh: uml4, prev_sender: uml3] - \- uml5 [tq: 106, ttl: 49, neigh: uml4, prev_sender: uml3] -+=> uml3 (seqno 20) -|- uml2 [tq: 255, ttl: 50, neigh: uml3, prev_sender: uml3] -| |- uml3 [tq: 160, ttl: 49, neigh: uml2, prev_sender: uml3] -| |- uml1 [tq: 160, ttl: 49, neigh: uml2, prev_sender: uml3] -| \- uml4 [tq: 160, ttl: 49, neigh: uml2, prev_sender: uml3] -|- uml5 [tq: 255, ttl: 50, neigh: uml3, prev_sender: uml3] -| |- uml3 [tq: 43, ttl: 48, neigh: uml5, prev_sender: uml3] -| |- uml6 [tq: 43, ttl: 48, neigh: uml5, prev_sender: uml3] -| | |- uml8 [tq: 16, ttl: 47, neigh: uml6, prev_sender: uml5] -| | |- uml5 [tq: 16, ttl: 47, neigh: uml6, prev_sender: uml5] -| | |- uml7 [tq: 16, ttl: 47, neigh: uml6, prev_sender: uml5] -| | | |- uml8 [tq: 5, ttl: 46, neigh: uml7, prev_sender: uml6] -| | | | |- uml6 [tq: 0, ttl: 45, neigh: uml8, prev_sender: uml7] -| | | | |- uml9 [tq: 0, ttl: 45, neigh: uml8, prev_sender: uml7] -| | | | \- uml7 [tq: 0, ttl: 45, neigh: uml8, prev_sender: uml7] -| | | \- uml6 [tq: 5, ttl: 46, neigh: uml7, prev_sender: uml6] -| | \- uml4 [tq: 16, ttl: 47, neigh: uml6, prev_sender: uml5] -| \- uml4 [tq: 43, ttl: 48, neigh: uml5, prev_sender: uml3] -|- uml1 [tq: 255, ttl: 50, neigh: uml3, prev_sender: uml3] -| \- uml2 [tq: 49, ttl: 48, neigh: uml1, prev_sender: uml3] -\- uml4 [tq: 255, ttl: 50, neigh: uml3, prev_sender: uml3] - |- uml3 [tq: 114, ttl: 49, neigh: uml4, prev_sender: uml3] - |- uml6 [tq: 114, ttl: 49, neigh: uml4, prev_sender: uml3] - |- uml2 [tq: 114, ttl: 49, neigh: uml4, prev_sender: uml3] - \- uml5 [tq: 114, ttl: 49, neigh: uml4, prev_sender: uml3] -[...] - -batctl originators -================== - -Check the Originators table - -Usage: batctl originators|o - -Example: - -$ batctl originators -[B.A.T.M.A.N. adv 2011.4.0, MainIF/MAC: eth0/fe:fe:00:00:01:01 (bat0)] - Originator last-seen (#/255) Nexthop [outgoingIF]: Potential nexthops ... -fe:fe:00:00:08:01 0.820s (194) fe:fe:00:00:02:01 [ eth0]: fe:fe:00:00:03:01 ( 65) fe:fe:00:00:02:01 (194) -fe:fe:00:00:03:01 0.980s (245) fe:fe:00:00:02:01 [ eth0]: fe:fe:00:00:03:01 ( 81) fe:fe:00:00:02:01 (245) -fe:fe:00:00:05:01 0.140s (221) fe:fe:00:00:02:01 [ eth0]: fe:fe:00:00:03:01 ( 76) fe:fe:00:00:02:01 (221) -fe:fe:00:00:04:01 0.010s (235) fe:fe:00:00:02:01 [ eth0]: fe:fe:00:00:02:01 (235) fe:fe:00:00:03:01 ( 81) -fe:fe:00:00:09:01 0.830s (187) fe:fe:00:00:02:01 [ eth0]: fe:fe:00:00:03:01 ( 63) fe:fe:00:00:02:01 (187) -fe:fe:00:00:06:01 0.830s (213) fe:fe:00:00:02:01 [ eth0]: fe:fe:00:00:03:01 ( 71) fe:fe:00:00:02:01 (213) -fe:fe:00:00:02:01 0.240s (255) fe:fe:00:00:02:01 [ eth0]: fe:fe:00:00:03:01 ( 81) fe:fe:00:00:02:01 (255) -fe:fe:00:00:07:01 0.670s (200) fe:fe:00:00:02:01 [ eth0]: fe:fe:00:00:03:01 ( 68) fe:fe:00:00:02:01 (200) - -Since 2014.1.0, each batman interface has an individual originator table as well which is only used for routing. -These table explain to which neighbor a packet is forwarded when the packet is received on the specified interface. - -Example: - -$ batctl originators -i eth0 -[B.A.T.M.A.N. adv master-b82b9b2, IF/MAC: eth0/fe:f0:00:00:02:01 (bat0 BATMAN_IV)] - Originator last-seen (#/255) Nexthop [outgoingIF]: Potential nexthops ... -fe:f1:00:00:03:01 0.170s (255) fe:f1:00:00:03:01 [ eth1]: fe:f1:00:00:03:01 (255) -fe:f1:00:00:01:01 0.510s (253) fe:f1:00:00:01:01 [ eth1]: fe:f1:00:00:01:01 (253) -fe:f0:00:00:05:01 0.660s (222) fe:f1:00:00:03:01 [ eth1]: fe:f0:00:00:03:01 (198) fe:f1:00:00:03:01 (222) -fe:f0:00:00:03:01 0.560s (252) fe:f1:00:00:03:01 [ eth1]: fe:f1:00:00:03:01 (252) fe:f0:00:00:03:01 (240) -fe:f0:00:00:04:01 0.250s (240) fe:f1:00:00:03:01 [ eth1]: fe:f1:00:00:03:01 (240) fe:f0:00:00:03:01 (211) -fe:f0:00:00:01:01 0.850s (255) fe:f1:00:00:01:01 [ eth1]: fe:f1:00:00:01:01 (255) fe:f0:00:00:01:01 (238) -$ batctl originators -i eth1 -[B.A.T.M.A.N. adv master-b82b9b2, IF/MAC: eth1/fe:f1:00:00:02:01 (bat0 BATMAN_IV)] - Originator last-seen (#/255) Nexthop [outgoingIF]: Potential nexthops ... -fe:f1:00:00:03:01 0.880s (240) fe:f1:00:00:03:01 [ eth1]: fe:f1:00:00:03:01 (240) -fe:f1:00:00:01:01 0.250s (239) fe:f1:00:00:01:01 [ eth1]: fe:f1:00:00:01:01 (239) -fe:f0:00:00:05:01 0.340s (211) fe:f1:00:00:03:01 [ eth1]: fe:f0:00:00:03:01 (210) fe:f1:00:00:03:01 (211) -fe:f0:00:00:03:01 0.260s (253) fe:f0:00:00:03:01 [ eth0]: fe:f1:00:00:03:01 (240) fe:f0:00:00:03:01 (253) -fe:f0:00:00:04:01 0.010s (225) fe:f0:00:00:03:01 [ eth0]: fe:f1:00:00:03:01 (224) fe:f0:00:00:03:01 (225) -fe:f0:00:00:01:01 0.510s (255) fe:f0:00:00:01:01 [ eth0]: fe:f1:00:00:01:01 (240) fe:f0:00:00:01:01 (255) - - -batctl interface -================ - -display or modify the interface settings - -Usage: batctl interface|if [add|del iface(s)] - -Example: - -$ batctl interface -eth0: active - -batctl interval -=============== - -display or modify the originator interval in ms - -Usage: batctl orig_interval|it [interval] - -Example: - -$ batctl interval -1000 - -batctl log -========== - -read the log produced by the kernel module - -Usage: batctl log|l - -Example: - -$ batctl log -[ 400] Received BATMAN packet via NB: fe:fe:00:00:02:01 IF: eth0 [fe:fe:00:00:01:01] (from OG: fe:fe:00:00:01:01 via prev OG: fe:fe:00:00:01:01 seqno 670, tq 245, TTL 49, V 8, IDF 1) -[ 400] Drop packet: originator packet from myself (via neighbour) -[ 400] Received BATMAN packet via NB: fe:fe:00:00:02:01 IF: eth0 [fe:fe:00:00:01:01] (from OG: fe:fe:00:00:02:01 via prev OG: fe:fe:00:00:02:01 seqno 545, tq 255, TTL 50, V 8, IDF 0) -[ 400] updating last_seqno: old 544, new 545 -[ 400] bidirectional: orig = fe:fe:00:00:02:01 neigh = fe:fe:00:00:02:01 => own_bcast = 64, real recv = 64, local tq: 255, asym_penalty: 255, total tq: 255 -[ 400] update_originator(): Searching and updating originator entry of received packet -[ 400] Updating existing last-hop neighbour of originator -[...] - -batctl loglevel -=============== - -display or modify the log level - -Usage: batctl loglevel|ll [level] - -Example: -$ batctl loglevel -[x] all debug output disabled (none) -[ ] messages related to routing / flooding / broadcasting (batman) -[ ] messages related to route added / changed / deleted (routes) -[ ] messages related to translation table operations (tt) -[ ] messages related to bridge loop avoidance (bla) -[ ] messages related to arp snooping and distributed arp table (dat) -[ ] messages related to network coding (nc) -[ ] messages related to multicast (mcast) - -batctl nc_nodes -=============== - -display the neighbor nodes considered for network coded packets - -Usage: batctl nc_nodes|nn - -Example: - -Node: fe:fe:00:0a:01:01 - Ingoing: fe:fe:00:0a:01:01 fe:fe:00:0a:02:01 - Outgoing: fe:fe:00:0a:01:01 fe:fe:00:0a:02:01 - -Where: -- Node is the neighbor -- Ingoing is the neighbors this neighbor can hear packets from -- Outgoing is the neighbors that can hear packets from this neighbor - -batctl network_coding -===================== - -display or modify the network coding setting - -Usage: batctl network_coding|nc [0|1] - -Note that network coding requires a working promiscuous mode on all interfaces. - -batctl multicast_mode -===================== - -display or modify the multicast mode setting - -Usage: batctl multicast_mode|mm [0|1] - -batctl mcast_flags -================= - -display local and remote multicast flags - -Usage batctl mcast_flags|mf - -Example: - -Multicast flags (own flags: [U46]) -* Bridged [U] U -* No IGMP/MLD Querier [4/6]: ./. -* Shadowing IGMP/MLD Querier [4/6]: 4/6 -------------------------------------------- - Originator Flags -02:04:64:a4:39:c1 [U..] -02:04:64:a4:39:c2 [U..] -02:04:64:a4:39:c3 [...] - -where: -- Originator: the MAC address of the originating (primary interface) - batman-adv node -- Flags: multicast flags of the according node -- U: wants all unsnoopable multicast traffic, meaning other nodes need to always - forward any multicast traffic destined to ff02::1 or 224.0.0.0/24 to it -- 4: wants all IPv4 multicast traffic, meaning other nodes need to always - forward any IPv4 multicast traffic to it -- 6: wants all IPv6 multicast traffic, meaning other nodes need to always - forward any IPv6 multicast traffic to it - -If a node does not have multicast optimizations available (e.g. old batman-adv -version or optimizations not compiled in), therefore not announcing any -multicast tvlv/flags, a '-' will be displayed instead of '[...]'. - -batctl aggregation -================== - -display or modify the packet aggregation setting - -Usage: batctl aggregation|ag [0|1] - -batctl isolation_mark -===================== - -display or modify the isolation mark. -This value is used by Extended Isolation feature. - -Usage: batctl isolation_mark|mark $value[/0x$mask] - -Example 1: batctl mark 0x00000001/0xffffffff -Example 2: batctl mark 0x00040000/0xffff0000 -Example 3: batctl mark 16 -Example 4: batctl mark 0x0f - -batctl translocal -================= - -display the local translation table - -Usage: batctl translocal|tl - -Example: - -$ batctl translocal -Locally retrieved addresses (from bat0) announced via TT (TTVN: 1): - * fe:fe:00:00:01:01 [RPNXW] - -In particular, RPNXW are flags which have the following meanings: - -- R/Roaming: this client moved to another node but it is still kept for - consistency reasons until the next OGM is sent. -- P/noPurge: this client represents the local soft interface and will never - be deleted. -- N/New: this client has recently been added but is not advertised in the - mesh until the next OGM is sent (for consistency reasons). -- X/delete: this client has to be removed for some reason, but it is still - kept for consistency reasons until the next OGM is sent. -- W/Wireless: this client is connected to the node through a wireless - device. - -If any of the flags is not enabled, a '.' will substitute its symbol. - -batctl transglobal -================== - -display the global translation table - -Usage: batctl transglobal|tg - -Example: - -Globally announced TT entries received via the mesh bat0 - Client (TTVN) Originator (Curr TTVN) Flags - * fe:fe:00:00:01:01 ( 12) via fe:fe:00:00:01:02 ( 50) [RXW] - -where: -- TTVN: is the translation-table-version-number which introduced this - client -- Curr TTVN: is the translation-table-version-number currently advertised by - the originator serving this client (different clients - advertised by the same originator have the same Curr TTVN) -- Flags that mean: - - R/Roaming: this client moved to another node but it is still kept - for consistency reasons until the next OGM is sent. - - X/delete: this client has to be removed for some reason, but it is - still kept for consistency reasons until the next - OGM is sent. - - W/Wireless: this client is connected to the node through a - wireless device. - -If any of the flags is not enabled, a '.' will substitute its symbol. - -batctl dat_cache -================= - -display the local D.A.T. cache - -Usage batctl dat_cache|dc - -Example: - -Distributed ARP Table (bat0): - IPv4 MAC last-seen - * 172.100.0.1 b6:9b:d0:ea:b1:13 0:00 - -where: -- IPv4 is the IP address of a client in the mesh network -- MAC is the MAC address associated to that IP -- last-seen is the amount of time since last refresh of this entry - -batctl and network name spaces -============================== - -The batman-adv kernel module is netns aware. Mesh instances can be -created in name spaces, and interfaces in that name space added to the -mesh. The mesh interface cannot be moved between name spaces, as is -typical for virtual interfaces. - -The following example creates two network namespaces, and uses veth -pairs to connect them together into a mesh of three nodes. - -EMU1="ip netns exec emu1" -EMU2="ip netns exec emu2" - -ip netns add emu1 -ip netns add emu2 - -ip link add emu1-veth1 type veth peer name emu2-veth1 -ip link set emu1-veth1 netns emu1 -ip link set emu2-veth1 netns emu2 - -$EMU1 ip link set emu1-veth1 name veth1 -$EMU2 ip link set emu2-veth1 name veth1 - -$EMU1 ip link set veth1 up -$EMU2 ip link set veth1 up - -ip link add emu1-veth2 type veth peer name veth2 -ip link set emu1-veth2 netns emu1 -$EMU1 ip link set emu1-veth2 name veth2 - -$EMU1 ip link set veth2 up -ip link set veth2 up - -$EMU1 batctl if add veth1 -$EMU1 batctl if add veth2 -$EMU1 ip link set bat0 up - -$EMU2 batctl if add veth1 -$EMU2 ip link set bat0 up - -batctl if add veth2 -ip link set bat0 up - -alfred and batadv-vis can also be used with name spaces. In this -example, only netns has been used, so there are no filesystem name -spaces. Hence the unix domain socket used by alfred needs to be given -a unique name per instance. - -($EMU1 alfred -m -i bat0 -u /var/run/emu1-alfred.soc) & -($EMU2 alfred -m -i bat0 -u /var/run/emu2-alfred.soc) & -alfred -m -i bat0 & - -($EMU1 batadv-vis -s -u /var/run/emu1-alfred.soc) & -($EMU2 batadv-vis -s -u /var/run/emu2-alfred.soc) & -batadv-vis -s & diff --git a/README.rst b/README.rst new file mode 100644 index 0000000..256e153 --- /dev/null +++ b/README.rst @@ -0,0 +1,698 @@ +.. SPDX-License-Identifier: GPL-2.0 + +========================================================== +batctl - B.A.T.M.A.N. advanced control and management tool +========================================================== + +Introduction +============ + +Why do I need batctl ? B.A.T.M.A.N. advanced operates on layer 2 and thus all +hosts participating in the virtual switch are completely transparent for all +protocols above layer 2. Therefore the common diagnosis tools do not work as +expected. To overcome these problems batctl was created. At the moment batctl +contains ping, traceroute, tcpdump and interfaces to the kernel module +settings. + + +How does it work ? +================== + +batctl uses the debugfs/batman_adv/bat0/socket device provided by the B.A.T.M.A.N. +advanced kernel module to inject custom icmp packets into the data flow. That's why +ping and traceroute work almost like their IP based counterparts. Tcpdump was +designed because B.A.T.M.A.N. advanced encapsulates all traffic within batman +packets, so that the normal tcpdump would not recognize the packets. + + +The bat-hosts file +================== + +This file is similar to the /etc/hosts file. You can write one MAC address and +one host name per line. batctl will analyze the file to find the matching MAC +address to your provided host name. Host names are much easier to remember than +MAC addresses. ;) + + +batctl statistics +================= + +The batman-adv kernel module maintains a number of traffic counters which are exported +to user space. With batctl these counters can be easily retrieved. The output may vary +depending on which features have been compiled into the kernel module. For example, if +the distributed arp table (short: dat) wasn't selected as an option at compile time +its counters won't be shown. + +Each module subsystem has its own counters which are indicated by their prefixes: + +mgmt: + mesh protocol counters +tt: + translation table counters +dat: + distributed arp table counters + +All counters without a prefix concern payload (pure user data) traffic. + +Usage:: + + batctl statistics + +Example:: + + $ batctl statistics + tx: 14 + tx_bytes: 1316 + tx_errors: 0 + rx: 14 + rx_bytes: 1316 + forward: 0 + forward_bytes: 0 + mgmt_tx: 18 + mgmt_tx_bytes: 762 + mgmt_rx: 17 + mgmt_rx_bytes: 1020 + tt_request_tx: 0 + tt_request_rx: 0 + tt_response_tx: 0 + tt_response_rx: 0 + tt_roam_adv_tx: 0 + tt_roam_adv_rx: 0 + dat_request_tx: 0 + dat_request_rx: 0 + dat_reply_tx: 1 + dat_reply_rx: 0 + + +batctl translate +================ + +Translates a destination (hostname, IPv4, IPv6, MAC, bat_host-name) to the +originator mac address responsible for it. + +Usage:: + + batctl translate mac|bat-host|host-name|IP-address + +Example:: + + $ batctl translate www.google.de + 02:ca:fe:af:fe:01 + $ batctl translate 02:ca:fe:af:fe:01 + 02:ca:fe:af:fe:01 + $ batctl translate 192.168.1.2 + 02:ca:fe:af:fe:05 + $ batctl translate fe:fe:00:00:09:01 + 02:ca:fe:af:fe:05 + $ batctl translate 2001::1 + 02:ca:fe:af:fe:05 + + +batctl ping +=========== + +Sends a Layer 2 batman-adv ping to check round trip time and connectivity + +Usage:: + + batctl ping [parameters] mac|bat-host|host-name|IP-address + parameters: + -c ping packet count + -h print this help + -i interval in seconds + -t timeout in seconds + -T don't try to translate mac to originator address + -R record route + +Example:: + + $ batctl ping fe:fe:00:00:09:01 + PING fe:fe:00:00:09:01 (fe:fe:00:00:09:01) 19(47) bytes of data + 19 bytes from fe:fe:00:00:09:01 icmp_seq=1 ttl=43 time=8.74 ms + 19 bytes from fe:fe:00:00:09:01 icmp_seq=2 ttl=43 time=7.48 ms + 19 bytes from fe:fe:00:00:09:01 icmp_seq=3 ttl=43 time=8.23 ms + ^C--- fe:fe:00:00:09:01 ping statistics --- + 3 packets transmitted, 3 received, 0% packet loss + rtt min/avg/max/mdev = 7.476/8.151/8.743/1.267 ms + + +batctl traceroute +================= + +Traceroute sends 3 packets to each hop, awaits the answers and prints out the +response times. + +Usage:: + + batctl traceroute [parameters] mac|bat-host|host-name|IP-address + +Example:: + + $ batctl traceroute fe:fe:00:00:09:01 + traceroute to fe:fe:00:00:09:01 (fe:fe:00:00:09:01), 50 hops max, 19 byte packets + 1: fe:fe:00:00:02:01 4.932 ms 2.338 ms 1.333 ms + 2: fe:fe:00:00:03:01 6.860 ms 1.579 ms 1.260 ms + 3: fe:fe:00:00:04:01 2.342 ms 1.547 ms 1.655 ms + 4: fe:fe:00:00:05:01 2.906 ms 2.211 ms 2.253 ms + 5: fe:fe:00:00:06:01 3.577 ms 2.687 ms 3.088 ms + 6: fe:fe:00:00:07:01 4.217 ms 5.741 ms 3.551 ms + 7: fe:fe:00:00:08:01 5.017 ms 5.547 ms 4.294 ms + 8: fe:fe:00:00:09:01 5.730 ms 4.970 ms 6.437 ms + + +batctl tcpdump +============== + +tcpdump layer 2 and/or layer 3 traffic on the given interface + +Usage:: + + batctl tcpdump [parameters] interface [interface] + parameters: + -c compat filter - only display packets matching own compat version (14) + -h print this help + -n don't convert addresses to bat-host names + -p dump specific packet type + -x dump all packet types except specified + packet types: + 1 - batman ogm packets + 2 - batman icmp packets + 4 - batman unicast packets + 8 - batman broadcast packets + 16 - batman unicast tvlv packets + 32 - batman fragmented packets + 64 - batman tt / roaming packets + 128 - non batman packets + 129 - batman ogm & non batman packets + +tcpdump supports standard interfaces as well as raw wifi interfaces running in monitor mode. + +Example output for tcpdump:: + + $ batctl tcpdump mesh0 + 01:51:42.401188 BAT kansas: OGM via neigh kansas, seqno 6718, tq 255, ttl 50, v 9, flags [..I], length 28 + 01:51:42.489735 BAT kansas: OGM via neigh wyoming, seqno 6718, tq 245, ttl 49, v 9, flags [.D.], length 28 + 01:51:42.510330 BAT wyoming: OGM via neigh wyoming, seqno 6721, tq 255, ttl 50, v 9, flags [..I], length 28 + 01:51:42.601092 BAT wyoming: OGM via neigh kansas, seqno 6721, tq 245, ttl 49, v 9, flags [.D.], length 28 + 01:51:43.361076 BAT kansas > wyoming: ICMP echo request, id 0, seq 1, ttl 1, v 9, length 19 + 01:51:43.365347 BAT wyoming > kansas: ICMP echo reply, id 0, seq 1, ttl 50, v 9, length 19 + 01:51:43.372224 BAT kansas > wyoming: ICMP echo request, id 0, seq 2, ttl 1, v 9, length 19 + 01:51:43.376506 BAT wyoming > kansas: ICMP echo reply, id 0, seq 2, ttl 50, v 9, length 19 + 01:51:43.381250 BAT kansas: OGM via neigh kansas, seqno 6719, tq 255, ttl 50, v 9, flags [..I], length 28 + 01:51:43.386281 BAT kansas > wyoming: ICMP echo request, id 0, seq 3, ttl 1, v 9, length 19 + 01:51:43.387910 BAT wyoming > kansas: ICMP echo reply, id 0, seq 3, ttl 50, v 9, length 19 + 01:51:43.479503 BAT kansas: OGM via neigh wyoming, seqno 6719, tq 245, ttl 49, v 9, flags [.D.], length 28 + 01:51:43.509899 BAT wyoming: OGM via neigh wyoming, seqno 6722, tq 255, ttl 50, v 9, flags [..I], length 28 + 01:51:43.600999 BAT wyoming: OGM via neigh kansas, seqno 6722, tq 245, ttl 49, v 9, flags [.D.], length 28 + 01:51:44.381064 BAT kansas: OGM via neigh kansas, seqno 6720, tq 255, ttl 50, v 9, flags [..I], length 28 + + +batctl bisect_iv +================ + +Analyzes the B.A.T.M.A.N. IV logfiles to build a small internal database of all sent sequence +numbers and routing table changes. This database can be used to search for routing loops +(default action), to trace OGMs of a host (use "-t" to specify the mac address or +bat-host name) throughout the network or to display routing tables of the nodes (use "-r" to +specify the mac address or bat-host name). You can name a specific sequence number or a range +using the "-s" option to limit the output's range. Furthermore you can filter the output by +specifying an originator (use "-o" to specify the mac address or bat-host name) to only see +data connected to this originator. If "-n" was given batctl will not replace the mac +addresses with bat-host names in the output. + +Usage:: + + batctl bisect_iv [parameters] <file1> <file2> .. <fileN> + parameters: + + -h print this help + -l run a loop detection of given mac address or bat-host (default) + -n don't convert addresses to bat-host names + -r print routing tables of given mac address or bat-host + -s seqno range to limit the output + -t trace seqnos of given mac address or bat-host + +Examples:: + + $ batctl bisect_iv log/* -l uml3 + Analyzing routing tables of originator: uml3 [all sequence numbers] + + Checking host: uml3 + Path towards uml7 (seqno 9 via neigh uml5): -> uml5 -> uml6 + Path towards uml7 (seqno 10 via neigh uml4): -> uml4 -> uml5 -> uml6 + Path towards uml6 (seqno 4 via neigh uml4): -> uml4 + Path towards uml8 (seqno 12 via neigh uml4): -> uml4 -> uml5 -> uml6 -> uml7 + Path towards uml8 (seqno 203 via neigh uml4): -> uml4 -> uml6 -> uml7 + Path towards uml8 (seqno 391 via neigh uml2): -> uml2 -> uml3 -> uml2 aborted due to loop! + Path towards uml8 (seqno 396 via neigh uml4): -> uml4 -> uml6 -> uml7 + Path towards uml9 (seqno 10 via neigh uml5): -> uml5 -> uml6 -> uml7 -> uml9. + Path towards uml9 (seqno 10 via neigh uml4): -> uml4 -> uml5 -> uml6 -> uml7 -> uml9. + Path towards uml9 (seqno 11 via neigh uml4): -> uml4 -> uml6 -> uml7 -> uml8 -> uml9. + Path towards uml9 (seqno 12 via neigh uml4): -> uml4 -> uml5 -> uml6 -> uml7 -> uml8 -> uml9. + Path towards uml9 (seqno 21 via neigh uml5): -> uml5 -> uml6 -> uml7 -> uml8 -> uml9. + Path towards uml9 (seqno 22 via neigh uml4): -> uml4 -> uml5 -> uml6 -> uml7 -> uml8 -> uml9. + + $ ./batctl bisect_iv -t uml3 log/* + Sequence number flow of originator: uml3 [all sequence numbers] + [...] + +=> uml3 (seqno 19) + |- uml2 [tq: 255, ttl: 50, neigh: uml3, prev_sender: uml3] + | |- uml3 [tq: 154, ttl: 49, neigh: uml2, prev_sender: uml3] + | \- uml1 [tq: 154, ttl: 49, neigh: uml2, prev_sender: uml3] + | |- uml3 [tq: 51, ttl: 48, neigh: uml1, prev_sender: uml2] + | \- uml2 [tq: 51, ttl: 48, neigh: uml1, prev_sender: uml2] + |- uml5 [tq: 255, ttl: 50, neigh: uml3, prev_sender: uml3] + | |- uml6 [tq: 33, ttl: 48, neigh: uml5, prev_sender: uml3] + | | |- uml5 [tq: 11, ttl: 47, neigh: uml6, prev_sender: uml5] + | | |- uml7 [tq: 11, ttl: 47, neigh: uml6, prev_sender: uml5] + | | | |- uml8 [tq: 3, ttl: 46, neigh: uml7, prev_sender: uml6] + | | | | |- uml6 [tq: 0, ttl: 45, neigh: uml8, prev_sender: uml7] + | | | | |- uml9 [tq: 0, ttl: 45, neigh: uml8, prev_sender: uml7] + | | | | \- uml7 [tq: 0, ttl: 45, neigh: uml8, prev_sender: uml7] + | | | |- uml6 [tq: 3, ttl: 46, neigh: uml7, prev_sender: uml6] + | | | |- uml9 [tq: 3, ttl: 46, neigh: uml7, prev_sender: uml6] + | | | \- uml5 [tq: 3, ttl: 46, neigh: uml7, prev_sender: uml6] + | | \- uml4 [tq: 11, ttl: 47, neigh: uml6, prev_sender: uml5] + | |- uml7 [tq: 33, ttl: 48, neigh: uml5, prev_sender: uml3] + | \- uml4 [tq: 33, ttl: 48, neigh: uml5, prev_sender: uml3] + \- uml4 [tq: 255, ttl: 50, neigh: uml3, prev_sender: uml3] + |- uml3 [tq: 106, ttl: 49, neigh: uml4, prev_sender: uml3] + |- uml6 [tq: 106, ttl: 49, neigh: uml4, prev_sender: uml3] + |- uml2 [tq: 106, ttl: 49, neigh: uml4, prev_sender: uml3] + \- uml5 [tq: 106, ttl: 49, neigh: uml4, prev_sender: uml3] + +=> uml3 (seqno 20) + |- uml2 [tq: 255, ttl: 50, neigh: uml3, prev_sender: uml3] + | |- uml3 [tq: 160, ttl: 49, neigh: uml2, prev_sender: uml3] + | |- uml1 [tq: 160, ttl: 49, neigh: uml2, prev_sender: uml3] + | \- uml4 [tq: 160, ttl: 49, neigh: uml2, prev_sender: uml3] + |- uml5 [tq: 255, ttl: 50, neigh: uml3, prev_sender: uml3] + | |- uml3 [tq: 43, ttl: 48, neigh: uml5, prev_sender: uml3] + | |- uml6 [tq: 43, ttl: 48, neigh: uml5, prev_sender: uml3] + | | |- uml8 [tq: 16, ttl: 47, neigh: uml6, prev_sender: uml5] + | | |- uml5 [tq: 16, ttl: 47, neigh: uml6, prev_sender: uml5] + | | |- uml7 [tq: 16, ttl: 47, neigh: uml6, prev_sender: uml5] + | | | |- uml8 [tq: 5, ttl: 46, neigh: uml7, prev_sender: uml6] + | | | | |- uml6 [tq: 0, ttl: 45, neigh: uml8, prev_sender: uml7] + | | | | |- uml9 [tq: 0, ttl: 45, neigh: uml8, prev_sender: uml7] + | | | | \- uml7 [tq: 0, ttl: 45, neigh: uml8, prev_sender: uml7] + | | | \- uml6 [tq: 5, ttl: 46, neigh: uml7, prev_sender: uml6] + | | \- uml4 [tq: 16, ttl: 47, neigh: uml6, prev_sender: uml5] + | \- uml4 [tq: 43, ttl: 48, neigh: uml5, prev_sender: uml3] + |- uml1 [tq: 255, ttl: 50, neigh: uml3, prev_sender: uml3] + | \- uml2 [tq: 49, ttl: 48, neigh: uml1, prev_sender: uml3] + \- uml4 [tq: 255, ttl: 50, neigh: uml3, prev_sender: uml3] + |- uml3 [tq: 114, ttl: 49, neigh: uml4, prev_sender: uml3] + |- uml6 [tq: 114, ttl: 49, neigh: uml4, prev_sender: uml3] + |- uml2 [tq: 114, ttl: 49, neigh: uml4, prev_sender: uml3] + \- uml5 [tq: 114, ttl: 49, neigh: uml4, prev_sender: uml3] + [...] + + +batctl originators +================== + +Check the Originators table + +Usage:: + + batctl originators|o + +Example:: + + $ batctl originators + [B.A.T.M.A.N. adv 2011.4.0, MainIF/MAC: eth0/fe:fe:00:00:01:01 (bat0)] + Originator last-seen (#/255) Nexthop [outgoingIF]: Potential nexthops ... + fe:fe:00:00:08:01 0.820s (194) fe:fe:00:00:02:01 [ eth0]: fe:fe:00:00:03:01 ( 65) fe:fe:00:00:02:01 (194) + fe:fe:00:00:03:01 0.980s (245) fe:fe:00:00:02:01 [ eth0]: fe:fe:00:00:03:01 ( 81) fe:fe:00:00:02:01 (245) + fe:fe:00:00:05:01 0.140s (221) fe:fe:00:00:02:01 [ eth0]: fe:fe:00:00:03:01 ( 76) fe:fe:00:00:02:01 (221) + fe:fe:00:00:04:01 0.010s (235) fe:fe:00:00:02:01 [ eth0]: fe:fe:00:00:02:01 (235) fe:fe:00:00:03:01 ( 81) + fe:fe:00:00:09:01 0.830s (187) fe:fe:00:00:02:01 [ eth0]: fe:fe:00:00:03:01 ( 63) fe:fe:00:00:02:01 (187) + fe:fe:00:00:06:01 0.830s (213) fe:fe:00:00:02:01 [ eth0]: fe:fe:00:00:03:01 ( 71) fe:fe:00:00:02:01 (213) + fe:fe:00:00:02:01 0.240s (255) fe:fe:00:00:02:01 [ eth0]: fe:fe:00:00:03:01 ( 81) fe:fe:00:00:02:01 (255) + fe:fe:00:00:07:01 0.670s (200) fe:fe:00:00:02:01 [ eth0]: fe:fe:00:00:03:01 ( 68) fe:fe:00:00:02:01 (200) + +Since 2014.1.0, each batman interface has an individual originator table as well which is only used for routing. +These table explain to which neighbor a packet is forwarded when the packet is received on the specified interface. + +Example:: + + $ batctl originators -i eth0 + [B.A.T.M.A.N. adv master-b82b9b2, IF/MAC: eth0/fe:f0:00:00:02:01 (bat0 BATMAN_IV)] + Originator last-seen (#/255) Nexthop [outgoingIF]: Potential nexthops ... + fe:f1:00:00:03:01 0.170s (255) fe:f1:00:00:03:01 [ eth1]: fe:f1:00:00:03:01 (255) + fe:f1:00:00:01:01 0.510s (253) fe:f1:00:00:01:01 [ eth1]: fe:f1:00:00:01:01 (253) + fe:f0:00:00:05:01 0.660s (222) fe:f1:00:00:03:01 [ eth1]: fe:f0:00:00:03:01 (198) fe:f1:00:00:03:01 (222) + fe:f0:00:00:03:01 0.560s (252) fe:f1:00:00:03:01 [ eth1]: fe:f1:00:00:03:01 (252) fe:f0:00:00:03:01 (240) + fe:f0:00:00:04:01 0.250s (240) fe:f1:00:00:03:01 [ eth1]: fe:f1:00:00:03:01 (240) fe:f0:00:00:03:01 (211) + fe:f0:00:00:01:01 0.850s (255) fe:f1:00:00:01:01 [ eth1]: fe:f1:00:00:01:01 (255) fe:f0:00:00:01:01 (238) + $ batctl originators -i eth1 + [B.A.T.M.A.N. adv master-b82b9b2, IF/MAC: eth1/fe:f1:00:00:02:01 (bat0 BATMAN_IV)] + Originator last-seen (#/255) Nexthop [outgoingIF]: Potential nexthops ... + fe:f1:00:00:03:01 0.880s (240) fe:f1:00:00:03:01 [ eth1]: fe:f1:00:00:03:01 (240) + fe:f1:00:00:01:01 0.250s (239) fe:f1:00:00:01:01 [ eth1]: fe:f1:00:00:01:01 (239) + fe:f0:00:00:05:01 0.340s (211) fe:f1:00:00:03:01 [ eth1]: fe:f0:00:00:03:01 (210) fe:f1:00:00:03:01 (211) + fe:f0:00:00:03:01 0.260s (253) fe:f0:00:00:03:01 [ eth0]: fe:f1:00:00:03:01 (240) fe:f0:00:00:03:01 (253) + fe:f0:00:00:04:01 0.010s (225) fe:f0:00:00:03:01 [ eth0]: fe:f1:00:00:03:01 (224) fe:f0:00:00:03:01 (225) + fe:f0:00:00:01:01 0.510s (255) fe:f0:00:00:01:01 [ eth0]: fe:f1:00:00:01:01 (240) fe:f0:00:00:01:01 (255) + + +batctl interface +================ + +display or modify the interface settings + +Usage:: + + batctl interface|if [add|del iface(s)] + +Example:: + + $ batctl interface + eth0: active + + +batctl interval +=============== + +display or modify the originator interval in ms + +Usage:: + + batctl orig_interval|it [interval] + +Example:: + + $ batctl interval + 1000 + + +batctl log +========== + +read the log produced by the kernel module + +Usage:: + + batctl log|l + +Example:: + + $ batctl log + [ 400] Received BATMAN packet via NB: fe:fe:00:00:02:01 IF: eth0 [fe:fe:00:00:01:01] (from OG: fe:fe:00:00:01:01 via prev OG: fe:fe:00:00:01:01 seqno 670, tq 245, TTL 49, V 8, IDF 1) + [ 400] Drop packet: originator packet from myself (via neighbour) + [ 400] Received BATMAN packet via NB: fe:fe:00:00:02:01 IF: eth0 [fe:fe:00:00:01:01] (from OG: fe:fe:00:00:02:01 via prev OG: fe:fe:00:00:02:01 seqno 545, tq 255, TTL 50, V 8, IDF 0) + [ 400] updating last_seqno: old 544, new 545 + [ 400] bidirectional: orig = fe:fe:00:00:02:01 neigh = fe:fe:00:00:02:01 => own_bcast = 64, real recv = 64, local tq: 255, asym_penalty: 255, total tq: 255 + [ 400] update_originator(): Searching and updating originator entry of received packet + [ 400] Updating existing last-hop neighbour of originator + [...] + + +batctl loglevel +=============== + +display or modify the log level + +Usage:: + + batctl loglevel|ll [level] + +Example:: + + $ batctl loglevel + [x] all debug output disabled (none) + [ ] messages related to routing / flooding / broadcasting (batman) + [ ] messages related to route added / changed / deleted (routes) + [ ] messages related to translation table operations (tt) + [ ] messages related to bridge loop avoidance (bla) + [ ] messages related to arp snooping and distributed arp table (dat) + [ ] messages related to network coding (nc) + [ ] messages related to multicast (mcast) + + +batctl nc_nodes +=============== + +display the neighbor nodes considered for network coded packets + +Usage:: + + batctl nc_nodes|nn + +Example:: + + Node: fe:fe:00:0a:01:01 + Ingoing: fe:fe:00:0a:01:01 fe:fe:00:0a:02:01 + Outgoing: fe:fe:00:0a:01:01 fe:fe:00:0a:02:01 + +Where + +Node: + is the neighbor +Ingoing: + is the neighbors this neighbor can hear packets from +Outgoing: + is the neighbors that can hear packets from this neighbor + + +batctl network_coding +===================== + +display or modify the network coding setting + +Usage:: + + batctl network_coding|nc [0|1] + +Note that network coding requires a working promiscuous mode on all interfaces. + + +batctl multicast_mode +===================== + +display or modify the multicast mode setting + +Usage:: + + batctl multicast_mode|mm [0|1] + + +batctl mcast_flags +================== + +display local and remote multicast flags + +Usage:: + + batctl mcast_flags|mf + +Example:: + + Multicast flags (own flags: [U46]) + * Bridged [U] U + * No IGMP/MLD Querier [4/6]: ./. + * Shadowing IGMP/MLD Querier [4/6]: 4/6 + ------------------------------------------- + Originator Flags + 02:04:64:a4:39:c1 [U..] + 02:04:64:a4:39:c2 [U..] + 02:04:64:a4:39:c3 [...] + +where + +Originator: + the MAC address of the originating (primary interface) batman-adv node +Flags: + multicast flags of the according node +U: + wants all unsnoopable multicast traffic, meaning other nodes need to always + forward any multicast traffic destined to ff02::1 or 224.0.0.0/24 to it +4: + wants all IPv4 multicast traffic, meaning other nodes need to always forward + any IPv4 multicast traffic to it +6: + wants all IPv6 multicast traffic, meaning other nodes need to always forward + any IPv6 multicast traffic to it + +If a node does not have multicast optimizations available (e.g. old batman-adv +version or optimizations not compiled in), therefore not announcing any +multicast tvlv/flags, a '-' will be displayed instead of '[...]'. + + +batctl aggregation +================== + +display or modify the packet aggregation setting + +Usage:: + + batctl aggregation|ag [0|1] + + +batctl isolation_mark +===================== + +display or modify the isolation mark. +This value is used by Extended Isolation feature. + +Usage:: + + batctl isolation_mark|mark $value[/0x$mask] + +* Example 1: ``batctl mark 0x00000001/0xffffffff`` +* Example 2: ``batctl mark 0x00040000/0xffff0000`` +* Example 3: ``batctl mark 16`` +* Example 4: ``batctl mark 0x0f`` + + +batctl translocal +================= + +display the local translation table + +Usage:: + + batctl translocal|tl + +Example:: + + $ batctl translocal + Locally retrieved addresses (from bat0) announced via TT (TTVN: 1): + * fe:fe:00:00:01:01 [RPNXW] + +In particular, RPNXW are flags which have the following meanings: + +R/Roaming: + this client moved to another node but it is still kept for consistency reasons + until the next OGM is sent. +P/noPurge: + this client represents the local soft interface and will never be deleted. +N/New: + this client has recently been added but is not advertised in the mesh until + the next OGM is sent (for consistency reasons). +X/delete: + this client has to be removed for some reason, but it is still kept for + consistency reasons until the next OGM is sent. +W/Wireless: + this client is connected to the node through a wireless device. + +If any of the flags is not enabled, a '.' will substitute its symbol. + + +batctl transglobal +================== + +display the global translation table + +Usage:: + + batctl transglobal|tg + +Example:: + + Globally announced TT entries received via the mesh bat0 + Client (TTVN) Originator (Curr TTVN) Flags + * fe:fe:00:00:01:01 ( 12) via fe:fe:00:00:01:02 ( 50) [RXW] + +where + +TTVN: + is the translation-table-version-number which introduced this client +Curr TTVN: + is the translation-table-version-number currently advertised by the + originator serving this client (different clients advertised by the same + originator have the same Curr TTVN) +Flags that mean: + R/Roaming: + this client moved to another node but it is still kept for consistency + reasons until the next OGM is sent. + X/delete: + this client has to be removed for some reason, but it is still kept for + consistency reasons until the next OGM is sent. + W/Wireless: + this client is connected to the node through a wireless device. + +If any of the flags is not enabled, a '.' will substitute its symbol. + + +batctl dat_cache +================= + +display the local D.A.T. cache + +Usage:: + + batctl dat_cache|dc + +Example:: + + Distributed ARP Table (bat0): + IPv4 MAC last-seen + * 172.100.0.1 b6:9b:d0:ea:b1:13 0:00 + +where + +IPv4: + is the IP address of a client in the mesh network +MAC: + is the MAC address associated to that IP +last-seen: + is the amount of time since last refresh of this entry + + +batctl and network name spaces +============================== + +The batman-adv kernel module is netns aware. Mesh instances can be +created in name spaces, and interfaces in that name space added to the +mesh. The mesh interface cannot be moved between name spaces, as is +typical for virtual interfaces. + +The following example creates two network namespaces, and uses veth +pairs to connect them together into a mesh of three nodes:: + + EMU1="ip netns exec emu1" + EMU2="ip netns exec emu2" + + ip netns add emu1 + ip netns add emu2 + + ip link add emu1-veth1 type veth peer name emu2-veth1 + ip link set emu1-veth1 netns emu1 + ip link set emu2-veth1 netns emu2 + + $EMU1 ip link set emu1-veth1 name veth1 + $EMU2 ip link set emu2-veth1 name veth1 + + $EMU1 ip link set veth1 up + $EMU2 ip link set veth1 up + + ip link add emu1-veth2 type veth peer name veth2 + ip link set emu1-veth2 netns emu1 + $EMU1 ip link set emu1-veth2 name veth2 + + $EMU1 ip link set veth2 up + ip link set veth2 up + + $EMU1 batctl if add veth1 + $EMU1 batctl if add veth2 + $EMU1 ip link set bat0 up + + $EMU2 batctl if add veth1 + $EMU2 ip link set bat0 up + + batctl if add veth2 + ip link set bat0 up + +alfred and batadv-vis can also be used with name spaces. In this +example, only netns has been used, so there are no filesystem name +spaces. Hence the unix domain socket used by alfred needs to be given +a unique name per instance:: + + ($EMU1 alfred -m -i bat0 -u /var/run/emu1-alfred.soc) & + ($EMU2 alfred -m -i bat0 -u /var/run/emu2-alfred.soc) & + alfred -m -i bat0 & + + ($EMU1 batadv-vis -s -u /var/run/emu1-alfred.soc) & + ($EMU2 batadv-vis -s -u /var/run/emu2-alfred.soc) & + batadv-vis -s &

1 0

Jump to page:

2025

2024

2023

2022

2021

2020

2019

2018

2017

2016

2015

2014

2013

2012

2011

2010

2009

commits