battool(8)

NAME

battool - B.A.T.M.A.N. toolchain for B.A.T.M.A.N. Advanced

SYNOPSIS

battool module [options] {destination or interface}

DESCRIPTION

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 the B.A.T.M.A.N. toolchain (battool for short) was created. At the moment the battool contains ping, traceroute and batdump which can be used as module.
The battool uses the unix socket provided by B.A.T.M.A.N. Advanced to inject custom icmp packets into the data flow. Thats why ping and traceroute work almost like their IP based counterparts. Batdump analyzes the Traffic and packet types used B.A.T.M.A.N. Advanced.

OPTIONS

battool ping [options] [mac address|host name] The following options are supported:
-c (count)

stop after n pings (default is infinite)

-i (interval)

interval to wait between 2 pings (default is 1 second)

-t (timeout interval)

timeout interval in seconds (default is 1 second)

battool traceroute [mac address|hostname]

Traceroute sends 3 packets to each hop, awaits the answers and prints out the

response times.

battool batdump [options] [interface]

The following options are supported:

-a (all packets)

switch tcpdump behaviour to work as the "normal" tcpdump and filter for non-batman advanced packets

-d (dump packets)

print packet data in hex

-p (packet type)

specify to filter for certain batman packets:

1 batman packets - these transport the B.A.T.M.A.N. originator

messages to build the mesh network

2 batman icmp packets - lightweight implementation of the ICMP

protocol (needed for ping and traceroute)

3 batman unicast packets - unicast data is bound as payload in

these packets

4 batman broadcast packets - broadcast data is bound as payload

in these packets

-v (verbose)

prints more information about each packet

FILES

bat-hosts
This file is simliar to the /etc/hosts file. You can write one MAC address and one host name per line. The battool 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. ;)

SEE ALSO

batmand-adv (8)

AUTHOR

battool was written by Andreas Langer <a.langer@q-dsl.de>.
This manual page was written by Simon Wunderlich <siwu@hrz.tu-chemnitz.de>.

battool(8)