Commit b19ad29f authored by Sven Eckelmann's avatar Sven Eckelmann Committed by Greg Kroah-Hartman

Staging: batman-adv: Start new development cycle

Version 2010.1.0 of the extra kernel module was released and thus the
documentation should be updated and everything prepared for the the
upcoming patchset.
Signed-off-by: default avatarSven Eckelmann <sven.eckelmann@gmx.de>
Signed-off-by: default avatarGreg Kroah-Hartman <gregkh@suse.de>
parent cbbdd771
[state: 12-06-2010] [state: 04-09-2010]
BATMAN-ADV BATMAN-ADV
---------- ----------
...@@ -67,15 +67,21 @@ All mesh wide settings can be found in batman's own interface ...@@ -67,15 +67,21 @@ All mesh wide settings can be found in batman's own interface
folder: folder:
# ls /sys/class/net/bat0/mesh/ # ls /sys/class/net/bat0/mesh/
# aggregate_ogm originators transtable_global vis_mode # aggregated_ogms bonding orig_interval vis_mode
# orig_interval transtable_local vis_data
There is a special folder for debugging informations:
# ls /sys/kernel/debug/batman_adv/bat0/
# originators socket transtable_global transtable_local
# vis_data
Some of the files contain all sort of status information regard- Some of the files contain all sort of status information regard-
ing the mesh network. For example, you can view the table of ing the mesh network. For example, you can view the table of
originators (mesh participants) with: originators (mesh participants) with:
# cat /sys/class/net/bat0/mesh/originators # cat /sys/kernel/debug/batman_adv/bat0/originators
Other files allow to change batman's behaviour to better fit your Other files allow to change batman's behaviour to better fit your
requirements. For instance, you can check the current originator requirements. For instance, you can check the current originator
...@@ -83,7 +89,7 @@ interval (value in milliseconds which determines how often batman ...@@ -83,7 +89,7 @@ interval (value in milliseconds which determines how often batman
sends its broadcast packets): sends its broadcast packets):
# cat /sys/class/net/bat0/mesh/orig_interval # cat /sys/class/net/bat0/mesh/orig_interval
# status: 1000 # 1000
and also change its value: and also change its value:
...@@ -137,7 +143,7 @@ at least very similar) data. ...@@ -137,7 +143,7 @@ at least very similar) data.
When configured as server, you can get a topology snapshot of When configured as server, you can get a topology snapshot of
your mesh: your mesh:
# cat /sys/class/net/bat0/mesh/vis_data # cat /sys/kernel/debug/batman_adv/bat0/vis_data
This raw output is intended to be easily parsable and convertable This raw output is intended to be easily parsable and convertable
with other tools. Have a look at the batctl README if you want a with other tools. Have a look at the batctl README if you want a
...@@ -181,32 +187,25 @@ enabled when compiling the batman-adv module. When building bat- ...@@ -181,32 +187,25 @@ enabled when compiling the batman-adv module. When building bat-
man-adv as part of kernel, use "make menuconfig" and enable the man-adv as part of kernel, use "make menuconfig" and enable the
option "B.A.T.M.A.N. debugging". option "B.A.T.M.A.N. debugging".
Those additional debug messages can be accessed using a special
file in debugfs
# cat /sys/kernel/debug/batman_adv/bat0/log
The additional debug output is by default disabled. It can be en- The additional debug output is by default disabled. It can be en-
abled either at kernel modules load time or during run time. To abled during run time. Following log_levels are defined:
enable debug output at module load time, add the module parameter
debug=<value>. <value> can take one of four values.
0 - All debug output disabled 0 - All debug output disabled
1 - Enable messages related to routing / flooding / broadcasting 1 - Enable messages related to routing / flooding / broadcasting
2 - Enable route or hna added / changed / deleted 2 - Enable route or hna added / changed / deleted
3 - Enable all messages 3 - Enable all messages
e.g. The debug output can be changed at runtime using the file
/sys/class/net/bat0/mesh/log_level. e.g.
# modprobe batman-adv debug=2
will load the module and enable debug messages for when routes or
HNAs change.
The debug output can also be changed at runtime using the file
/sys/module/batman-adv/parameters/debug. e.g.
# echo 2 > /sys/module/batman-adv/parameters/debug
enables debug messages for when routes or HNAs # echo 2 > /sys/class/net/bat0/mesh/log_level
The debug output is sent to the kernel logs. So try dmesg, lo- will enable debug messages for when routes or HNAs change.
gread, etc to see the debug messages.
BATCTL BATCTL
......
...@@ -30,7 +30,7 @@ ...@@ -30,7 +30,7 @@
#define DRIVER_DESC "B.A.T.M.A.N. advanced" #define DRIVER_DESC "B.A.T.M.A.N. advanced"
#define DRIVER_DEVICE "batman-adv" #define DRIVER_DEVICE "batman-adv"
#define SOURCE_VERSION "maint" #define SOURCE_VERSION "next"
/* B.A.T.M.A.N. parameters */ /* B.A.T.M.A.N. parameters */
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment