Debian Codegraph @

man/batmand.8

raw
1 .\" Hey, EMACS: -*- nroff -*-
2 .\" First parameter, NAME, should be all caps
3 .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
4 .\" other parameters are allowed: see man(7), man(1)
5 .TH BATMAND 8 "Sep 7, 2007"
6 .\" Please adjust this date whenever revising the manpage.
7 .\"
8 .\" Some roff macros, for reference:
9 .\" .nh disable hyphenation
10 .\" .hy enable hyphenation
11 .\" .ad l left justify
12 .\" .ad b justify to both left and right margins
13 .\" .nf disable filling
14 .\" .fi enable filling
15 .\" .br insert line break
16 .\" .sp <n> insert n+1 empty lines
17 .\" for manpage-specific macros, see man(7)
18 .\" --------------------------------------------------------------------------
19 .\" Process this file with
20 .\" groff -man batmand.8 -Tutf8
21 .\" --------------------------------------------------------------------------
22 .TH "batmand" 8
23 .SH NAME
24 batmand \- better approach to mobile ad\(hyhoc networking
25 .SH SYNOPSIS
26 .B batmand
27 .RI [ options ] interface [ interface ... ]
28 .br
29 .SH DESCRIPTION
30 .B B.A.T.M.A.N
31 means better approach to mobile ad\(hyhoc networking, this is a new routing protocol for multi\(hyhop ad\(hyhoc mesh networks. Go to https://www.open\-mesh.org/ to get more information.
32 .PP
33 The following document will explain how to use the \fBbatman daemon\fP.
34 .PP
35 The batmand binary can be run in 2 different ways. First you need to start the daemon with "batmand [options] interface" (daemon mode) and then you can connect to that daemon to issue further commands with "batmand \-c [options]" (client mode). Some of the options below are always available, some are not. See the example section to get an idea.
36 .SH OPTIONS
37 .TP
38 .B \-a add announced network(s)
39 Add networks to the daemons list of available connections to another network(s). This option can be used multiple times and can be used to add networks dynamically while the daemon is running. The parameter has to be in the form of ip\(hyaddress/netmask.
40 .TP
41 .B \-A delete announced network(s)
42 Delete networks to the daemons list of available connections to another network(s). This option can be used multiple times and can only be used while the daemon is running. The parameter has to be in the form of ip\(hyaddress/netmask.
43 .TP
44 .B \-b run debug connection in batch mode
45 The debug information are updated after a period of time by default, so if you use "\-b" it will execute once and then stop. This option is useful for script integration of the debug output and is only available in client mode together with "\-d 1" or "\-d 2".
46 .TP
47 .B \-c connect via unix socket
48 Use this option to switch to client mode. Deploy it without any arguments to get the current configuration even if changed at runtime.
49 .TP
50 .B \-d debug level
51 The debug level can be set to five values.
52 .RS 17
53 default: 0 \-> debug disabled
54 .RE
55 .RS 10
56 allowed values: 1 \-> list neighbors
57 .RE
58 .RS 25
59 2 \-> list gateways
60 3 \-> observe batman
61 4 \-> observe batman (verbose)
62 5 \-> memory debug / cpu usage
63 .RE
64 .RS 7
65 Note that debug level 5 can be disabled at compile time.
66 .RE
67 .TP
68 .B \-g gateway class
69 The gateway class is used to tell other nodes in the network your available internet bandwidth. Just enter any number (optionally followed by "kbit" or "mbit") and the daemon will guess your appropriate gateway class. Use "/" to separate the down\(hy and upload rates. You can omit the upload rate and batmand will assume an upload of download / 5.
70 .RS 17
71 default: 0 \-> gateway disabled
72 .RE
73 .RS 10
74 allowed values: 5000
75 .RE
76 .RS 25
77 5000kbit
78 5mbit
79 5mbit/1024
80 5mbit/1024kbit
81 5mbit/1mbit
82 .RE
83 .TP
84 .B \-h short help
85 .TP
86 .B \-H verbose help
87 .TP
88 .B \-o originator interval in ms
89 A node transmits broadcast messages (we call them originator message or OGM) to inform the neighboring nodes about it's existence.
90 Originator interval is the time to wait after sending one message and before sending the next message. The default value is 1000 ms (1 second).
91 In a mobile network, you may want to detect network changes very quickly, so you need to send message very often, for example, use a value of 500 ms.
92 In a static network, you can save bandwidth by using a higher value.
93 This option is only available in daemon mode.
94 .TP
95 .B \-p preferred gateway
96 Set the internet gateway by yourself. Note: This automatically switches your daemon to "internet search mode" with "\-r 1" unless "\-r" is given. If the preferred gateway is not found the gateway selection will use the current routing class to choose a gateway.
97 .TP
98 .B \-r routing class
99 The routing class can be set to four values \(hy it enables "internet search mode". The daemon will choose an internet gateway based on certain criteria (unless "\-p" is specified):
100 .RS 17
101 default: 0 \-> set no default route
102 .RE
103 .RS 10
104 allowed values: 1 \-> use fast connection
105 .RE
106 .RS 25
107 2 \-> use stable connection
108 3 \-> use fast\(hyswitch connection
109 XX \-> use late\(hyswitch connection
110 .RE
111 .RS 7
112 In level 1, B.A.T.M.A.N tries to find the best available connection by considering the gateway's advertised throughput as well as the link quality towards the gateway.
113 In level 2, B.A.T.M.A.N compares the link quality of the internet node and chooses the one with the best link quality.
114 In level 3, B.A.T.M.A.N compares the link quality of the internet node and chooses the one with the best link quality but switches to another gateway as soon as a better connection is found.
115 In level XX (number between 3 and 256) B.A.T.M.A.N compares the link quality of the internet node and chooses the one with the best link quality but switches to another gateway as soon as this gateway has a TQ value which is XX better than the currently selected gateway.
116 .RE
117 .TP
118 .B \-s visualization server
119 Since no topology database is computed by the protocol an additional solution to create topology graphs has been implemented, the vis server. Batman daemons may send their local view about their single\(hyhop neighbors to the vis server. It collects the information and provides data in a format similar to OLSR's topology information output. Therefore existing solutions to draw topology graphs developed for OLSR can be used to visualize mesh\(hyclouds using B.A.T.M.A.N.
120 .TP
121 .B \-v print version
122 .TP
123 .B \-\-disable\-client\-nat
124 Since version 0.3.2 batmand uses iptables to set the NAT rules on the gateX interface of the batman client (\-r XX). That option disables this feature of batmand and switches the internet tunnel mode to "half tunnels" (the packets towards the gateway are tunneled but not the packets that are coming back) unless NAT was enabled manually. Be sure to know what you are doing! Without NAT the gateway needs to have a route to the client or the packets will be dropped silently.
125 .TP
126 .B \-\-no\-detach
127 Run batmand in foreground
128 .TP
129 .B \-\-policy\-routing\-script
130 This option disables the policy routing feature of batmand \(hy all routing changes are send to the script which can make use of this information or not. Firmware and package maintainers can use this option to tightly integrate batmand into their own routing policies. This option is only available in daemon mode.
131 .SH EXAMPLES
132 .TP
133 .B batmand eth1 wlan0:test
134 Start batman daemon on interface "eth1" and on alias interface "wlan0:test"
135 .TP
136 .B batmand \-o 2000 \-a 192.168.100.1/32 \-a 10.0.0.0/24 eth1
137 Start batman daemon on interface "eth1" with originator interval of 2000 ms while announcing 192.168.100.1 and 10.0.0.0/24.
138 .TP
139 .B batmand \-s 192.168.1.1 \-d 1 eth1
140 Start batman daemon on interface "eth1", sending topology information to 192.168.1.1 and with debug level 1 (does not fork into the background).
141 .TP
142 .B batmand eth1 && batmand \-c \-d 1 \-b
143 Start batman daemon on interface "eth1". Connect in client mode to get the debug level 1 output once (batch mode).
144 .TP
145 .B batmand \-g 2000kbit/500kbit eth1 && batmand \-c \-r 1
146 Start batman daemon on interface "eth1" as internet gateway. Connect in client mode to disable the internet gateway and enable internet search mode.
147 .br
148 .SH AUTHOR
149 batmand was written by Marek Lindner <lindner_marek\-at\-yahoo.de>, Axel Neumann <axel\-at\-open\-mesh.net>, Stefan Sperling <stsp\-at\-stsp.in\-berlin.de>, Corinna 'Elektra' Aichele <onelektra\-at\-gmx.net>, Thomas Lopatic <thomas\-at\-lopatic.de>, Felix Fietkau <nbd\-at\-nbd.name>, Ludger Schmudde <lui\-at\-schmudde.com>, Simon Wunderlich <siwu\-at\-hrz.tu\-chemnitz.de>, Andreas Langer <a.langer\-at\-q\-dsl.de>.
150 .PP
151 This manual page was written by Wesley Tsai <[email protected]>,
152 for the Debian GNU/Linux system.