Commit | Line | Data |
---|---|---|
0b873931 | 1 | /* Copyright (C) 2007-2013 B.A.T.M.A.N. contributors: |
c6c8fea2 SE |
2 | * |
3 | * Marek Lindner, Simon Wunderlich | |
4 | * | |
5 | * This program is free software; you can redistribute it and/or | |
6 | * modify it under the terms of version 2 of the GNU General Public | |
7 | * License as published by the Free Software Foundation. | |
8 | * | |
9 | * This program is distributed in the hope that it will be useful, but | |
10 | * WITHOUT ANY WARRANTY; without even the implied warranty of | |
11 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU | |
12 | * General Public License for more details. | |
13 | * | |
14 | * You should have received a copy of the GNU General Public License | |
15 | * along with this program; if not, write to the Free Software | |
16 | * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA | |
17 | * 02110-1301, USA | |
c6c8fea2 SE |
18 | */ |
19 | ||
20 | #ifndef _NET_BATMAN_ADV_PACKET_H_ | |
21 | #define _NET_BATMAN_ADV_PACKET_H_ | |
22 | ||
ef261577 ML |
23 | /** |
24 | * enum batadv_packettype - types for batman-adv encapsulated packets | |
a1f1ac5c SW |
25 | * @BATADV_IV_OGM: originator messages for B.A.T.M.A.N. IV |
26 | * @BATADV_BCAST: broadcast packets carrying broadcast payload | |
27 | * @BATADV_CODED: network coded packets | |
28 | * | |
29 | * @BATADV_UNICAST: unicast packets carrying unicast payload traffic | |
30 | * @BATADV_UNICAST_FRAG: unicast packets carrying a fragment of the original | |
31 | * payload packet | |
32 | * @BATADV_UNICAST_4ADDR: unicast packet including the originator address of | |
33 | * the sender | |
34 | * @BATADV_ICMP: unicast packet like IP ICMP used for ping or traceroute | |
ef261577 ML |
35 | * @BATADV_UNICAST_TVLV: unicast packet carrying TVLV containers |
36 | */ | |
acd34afa | 37 | enum batadv_packettype { |
a1f1ac5c SW |
38 | /* 0x00 - 0x3f: local packets or special rules for handling */ |
39 | BATADV_IV_OGM = 0x00, | |
40 | BATADV_BCAST = 0x01, | |
41 | BATADV_CODED = 0x02, | |
42 | /* 0x40 - 0x7f: unicast */ | |
43 | #define BATADV_UNICAST_MIN 0x40 | |
44 | BATADV_UNICAST = 0x40, | |
45 | BATADV_UNICAST_FRAG = 0x41, | |
46 | BATADV_UNICAST_4ADDR = 0x42, | |
47 | BATADV_ICMP = 0x43, | |
48 | BATADV_UNICAST_TVLV = 0x44, | |
49 | #define BATADV_UNICAST_MAX 0x7f | |
50 | /* 0x80 - 0xff: reserved */ | |
7cdcf6dd AQ |
51 | }; |
52 | ||
53 | /** | |
54 | * enum batadv_subtype - packet subtype for unicast4addr | |
55 | * @BATADV_P_DATA: user payload | |
5c3a0e55 AQ |
56 | * @BATADV_P_DAT_DHT_GET: DHT request message |
57 | * @BATADV_P_DAT_DHT_PUT: DHT store message | |
58 | * @BATADV_P_DAT_CACHE_REPLY: ARP reply generated by DAT | |
7cdcf6dd AQ |
59 | */ |
60 | enum batadv_subtype { | |
5c3a0e55 AQ |
61 | BATADV_P_DATA = 0x01, |
62 | BATADV_P_DAT_DHT_GET = 0x02, | |
63 | BATADV_P_DAT_DHT_PUT = 0x03, | |
64 | BATADV_P_DAT_CACHE_REPLY = 0x04, | |
e8958dbf | 65 | }; |
c6c8fea2 SE |
66 | |
67 | /* this file is included by batctl which needs these defines */ | |
60cf7981 | 68 | #define BATADV_COMPAT_VERSION 15 |
e8958dbf | 69 | |
18c68d59 SW |
70 | /** |
71 | * enum batadv_iv_flags - flags used in B.A.T.M.A.N. IV OGM packets | |
72 | * @BATADV_NOT_BEST_NEXT_HOP: flag is set when ogm packet is forwarded and was | |
73 | * previously received from someone else than the best neighbor. | |
74 | * @BATADV_PRIMARIES_FIRST_HOP: flag is set when the primary interface address | |
75 | * is used, and the packet travels its first hop. | |
76 | * @BATADV_DIRECTLINK: flag is for the first hop or if rebroadcasted from a | |
77 | * one hop neighbor on the interface where it was originally received. | |
78 | */ | |
acd34afa | 79 | enum batadv_iv_flags { |
18c68d59 SW |
80 | BATADV_NOT_BEST_NEXT_HOP = BIT(0), |
81 | BATADV_PRIMARIES_FIRST_HOP = BIT(1), | |
82 | BATADV_DIRECTLINK = BIT(2), | |
e8958dbf | 83 | }; |
c6c8fea2 SE |
84 | |
85 | /* ICMP message types */ | |
acd34afa SE |
86 | enum batadv_icmp_packettype { |
87 | BATADV_ECHO_REPLY = 0, | |
88 | BATADV_DESTINATION_UNREACHABLE = 3, | |
89 | BATADV_ECHO_REQUEST = 8, | |
90 | BATADV_TTL_EXCEEDED = 11, | |
91 | BATADV_PARAMETER_PROBLEM = 12, | |
e8958dbf | 92 | }; |
c6c8fea2 | 93 | |
e1bf0c14 ML |
94 | /* tt data subtypes */ |
95 | #define BATADV_TT_DATA_TYPE_MASK 0x0F | |
a73105b8 | 96 | |
e1bf0c14 ML |
97 | /** |
98 | * enum batadv_tt_data_flags - flags for tt data tvlv | |
99 | * @BATADV_TT_OGM_DIFF: TT diff propagated through OGM | |
100 | * @BATADV_TT_REQUEST: TT request message | |
101 | * @BATADV_TT_RESPONSE: TT response message | |
102 | * @BATADV_TT_FULL_TABLE: contains full table to replace existing table | |
103 | */ | |
104 | enum batadv_tt_data_flags { | |
105 | BATADV_TT_OGM_DIFF = BIT(0), | |
106 | BATADV_TT_REQUEST = BIT(1), | |
107 | BATADV_TT_RESPONSE = BIT(2), | |
108 | BATADV_TT_FULL_TABLE = BIT(4), | |
a73105b8 AQ |
109 | }; |
110 | ||
acd34afa | 111 | /* BATADV_TT_CLIENT flags. |
8de47de5 | 112 | * Flags from BIT(0) to BIT(7) are sent on the wire, while flags from BIT(8) to |
0eb01568 AQ |
113 | * BIT(15) are used for local computation only. |
114 | * Flags from BIT(4) to BIT(7) are kept in sync with the rest of the network. | |
9cfc7bd6 | 115 | */ |
acd34afa | 116 | enum batadv_tt_client_flags { |
8de47de5 SE |
117 | BATADV_TT_CLIENT_DEL = BIT(0), |
118 | BATADV_TT_CLIENT_ROAM = BIT(1), | |
0eb01568 | 119 | BATADV_TT_CLIENT_WIFI = BIT(4), |
8de47de5 SE |
120 | BATADV_TT_CLIENT_NOPURGE = BIT(8), |
121 | BATADV_TT_CLIENT_NEW = BIT(9), | |
122 | BATADV_TT_CLIENT_PENDING = BIT(10), | |
0035f97e | 123 | BATADV_TT_CLIENT_TEMP = BIT(11), |
a73105b8 AQ |
124 | }; |
125 | ||
c018ad3d AQ |
126 | /** |
127 | * batadv_vlan_flags - flags for the four MSB of any vlan ID field | |
128 | * @BATADV_VLAN_HAS_TAG: whether the field contains a valid vlan tag or not | |
129 | */ | |
130 | enum batadv_vlan_flags { | |
131 | BATADV_VLAN_HAS_TAG = BIT(15), | |
132 | }; | |
133 | ||
23721387 | 134 | /* claim frame types for the bridge loop avoidance */ |
acd34afa | 135 | enum batadv_bla_claimframe { |
3eb8773e SW |
136 | BATADV_CLAIM_TYPE_CLAIM = 0x00, |
137 | BATADV_CLAIM_TYPE_UNCLAIM = 0x01, | |
acd34afa SE |
138 | BATADV_CLAIM_TYPE_ANNOUNCE = 0x02, |
139 | BATADV_CLAIM_TYPE_REQUEST = 0x03, | |
23721387 SW |
140 | }; |
141 | ||
414254e3 ML |
142 | /** |
143 | * enum batadv_tvlv_type - tvlv type definitions | |
144 | * @BATADV_TVLV_GW: gateway tvlv | |
17cf0ea4 | 145 | * @BATADV_TVLV_DAT: distributed arp table tvlv |
3f4841ff | 146 | * @BATADV_TVLV_NC: network coding tvlv |
e1bf0c14 | 147 | * @BATADV_TVLV_TT: translation table tvlv |
122edaa0 | 148 | * @BATADV_TVLV_ROAM: roaming advertisement tvlv |
414254e3 ML |
149 | */ |
150 | enum batadv_tvlv_type { | |
151 | BATADV_TVLV_GW = 0x01, | |
17cf0ea4 | 152 | BATADV_TVLV_DAT = 0x02, |
3f4841ff | 153 | BATADV_TVLV_NC = 0x03, |
e1bf0c14 | 154 | BATADV_TVLV_TT = 0x04, |
122edaa0 | 155 | BATADV_TVLV_ROAM = 0x05, |
414254e3 ML |
156 | }; |
157 | ||
23721387 SW |
158 | /* the destination hardware field in the ARP frame is used to |
159 | * transport the claim type and the group id | |
160 | */ | |
96412690 | 161 | struct batadv_bla_claim_dst { |
23721387 SW |
162 | uint8_t magic[3]; /* FF:43:05 */ |
163 | uint8_t type; /* bla_claimframe */ | |
3e2f1a1b | 164 | __be16 group; /* group id */ |
f6c57a46 | 165 | }; |
23721387 | 166 | |
96412690 | 167 | struct batadv_header { |
c6c8fea2 SE |
168 | uint8_t packet_type; |
169 | uint8_t version; /* batman version field */ | |
3b27ffb0 | 170 | uint8_t ttl; |
f6c57a46 SE |
171 | /* the parent struct has to add a byte after the header to make |
172 | * everything 4 bytes aligned again | |
173 | */ | |
174 | }; | |
76543d14 | 175 | |
ef261577 ML |
176 | /** |
177 | * struct batadv_ogm_packet - ogm (routing protocol) packet | |
178 | * @header: common batman packet header | |
18c68d59 | 179 | * @flags: contains routing relevant flags - see enum batadv_iv_flags |
ef261577 ML |
180 | * @tvlv_len: length of tvlv data following the ogm header |
181 | */ | |
96412690 SE |
182 | struct batadv_ogm_packet { |
183 | struct batadv_header header; | |
18c68d59 | 184 | uint8_t flags; |
e0f5211f | 185 | __be32 seqno; |
c1faead3 AQ |
186 | uint8_t orig[ETH_ALEN]; |
187 | uint8_t prev_sender[ETH_ALEN]; | |
414254e3 | 188 | uint8_t reserved; |
3b27ffb0 | 189 | uint8_t tq; |
ef261577 | 190 | __be16 tvlv_len; |
9284a47e SW |
191 | /* __packed is not needed as the struct size is divisible by 4, |
192 | * and the largest data type in this struct has a size of 4. | |
193 | */ | |
194 | }; | |
c6c8fea2 | 195 | |
96412690 | 196 | #define BATADV_OGM_HLEN sizeof(struct batadv_ogm_packet) |
c6c8fea2 | 197 | |
0bf84c16 AQ |
198 | /** |
199 | * batadv_icmp_header - common ICMP header | |
200 | * @header: common batman header | |
201 | * @msg_type: ICMP packet type | |
202 | * @dst: address of the destination node | |
203 | * @orig: address of the source node | |
204 | * @uid: local ICMP socket identifier | |
205 | */ | |
206 | struct batadv_icmp_header { | |
96412690 | 207 | struct batadv_header header; |
3b27ffb0 | 208 | uint8_t msg_type; /* see ICMP message types above */ |
c1faead3 AQ |
209 | uint8_t dst[ETH_ALEN]; |
210 | uint8_t orig[ETH_ALEN]; | |
c6c8fea2 | 211 | uint8_t uid; |
0bf84c16 AQ |
212 | }; |
213 | ||
214 | /** | |
215 | * batadv_icmp_packet - ICMP packet | |
216 | * @icmph: common ICMP header | |
217 | * @reserved: not used - useful for alignment | |
218 | * @seqno: ICMP sequence number | |
219 | */ | |
220 | struct batadv_icmp_packet { | |
221 | struct batadv_icmp_header icmph; | |
3b27ffb0 | 222 | uint8_t reserved; |
0bf84c16 | 223 | __be16 seqno; |
f6c57a46 | 224 | }; |
c6c8fea2 | 225 | |
7e071c79 | 226 | #define BATADV_RR_LEN 16 |
c6c8fea2 | 227 | |
0bf84c16 AQ |
228 | /** |
229 | * batadv_icmp_packet_rr - ICMP RouteRecord packet | |
230 | * @icmph: common ICMP header | |
231 | * @rr_cur: number of entries the rr array | |
232 | * @seqno: ICMP sequence number | |
233 | * @rr: route record array | |
9cfc7bd6 | 234 | */ |
96412690 | 235 | struct batadv_icmp_packet_rr { |
0bf84c16 | 236 | struct batadv_icmp_header icmph; |
c6c8fea2 | 237 | uint8_t rr_cur; |
0bf84c16 | 238 | __be16 seqno; |
7e071c79 | 239 | uint8_t rr[BATADV_RR_LEN][ETH_ALEN]; |
f6c57a46 | 240 | }; |
c6c8fea2 | 241 | |
da6b8c20 SW |
242 | #define BATADV_ICMP_MAX_PACKET_SIZE sizeof(struct batadv_icmp_packet_rr) |
243 | ||
e022b956 SE |
244 | /* All packet headers in front of an ethernet header have to be completely |
245 | * divisible by 2 but not by 4 to make the payload after the ethernet | |
246 | * header again 4 bytes boundary aligned. | |
247 | * | |
248 | * A packing of 2 is necessary to avoid extra padding at the end of the struct | |
249 | * caused by a structure member which is larger than two bytes. Otherwise | |
250 | * the structure would not fulfill the previously mentioned rule to avoid the | |
251 | * misalignment of the payload after the ethernet header. It may also lead to | |
252 | * leakage of information when the padding it not initialized before sending. | |
253 | */ | |
254 | #pragma pack(2) | |
255 | ||
96412690 SE |
256 | struct batadv_unicast_packet { |
257 | struct batadv_header header; | |
a73105b8 | 258 | uint8_t ttvn; /* destination translation table version number */ |
c1faead3 | 259 | uint8_t dest[ETH_ALEN]; |
f6c57a46 SE |
260 | /* "4 bytes boundary + 2 bytes" long to make the payload after the |
261 | * following ethernet header again 4 bytes boundary aligned | |
262 | */ | |
263 | }; | |
c6c8fea2 | 264 | |
7cdcf6dd AQ |
265 | /** |
266 | * struct batadv_unicast_4addr_packet - extended unicast packet | |
267 | * @u: common unicast packet header | |
268 | * @src: address of the source | |
269 | * @subtype: packet subtype | |
270 | */ | |
271 | struct batadv_unicast_4addr_packet { | |
272 | struct batadv_unicast_packet u; | |
273 | uint8_t src[ETH_ALEN]; | |
274 | uint8_t subtype; | |
275 | uint8_t reserved; | |
276 | /* "4 bytes boundary + 2 bytes" long to make the payload after the | |
277 | * following ethernet header again 4 bytes boundary aligned | |
278 | */ | |
279 | }; | |
280 | ||
610bfc6b MH |
281 | /** |
282 | * struct batadv_frag_packet - fragmented packet | |
283 | * @header: common batman packet header with type, compatversion, and ttl | |
284 | * @dest: final destination used when routing fragments | |
285 | * @orig: originator of the fragment used when merging the packet | |
286 | * @no: fragment number within this sequence | |
287 | * @reserved: reserved byte for alignment | |
288 | * @seqno: sequence identification | |
289 | * @total_size: size of the merged packet | |
290 | */ | |
291 | struct batadv_frag_packet { | |
292 | struct batadv_header header; | |
293 | #if defined(__BIG_ENDIAN_BITFIELD) | |
294 | uint8_t no:4; | |
295 | uint8_t reserved:4; | |
296 | #elif defined(__LITTLE_ENDIAN_BITFIELD) | |
297 | uint8_t reserved:4; | |
298 | uint8_t no:4; | |
299 | #else | |
300 | #error "unknown bitfield endianess" | |
301 | #endif | |
302 | uint8_t dest[ETH_ALEN]; | |
303 | uint8_t orig[ETH_ALEN]; | |
304 | __be16 seqno; | |
305 | __be16 total_size; | |
306 | }; | |
307 | ||
96412690 SE |
308 | struct batadv_bcast_packet { |
309 | struct batadv_header header; | |
3b27ffb0 | 310 | uint8_t reserved; |
3e2f1a1b | 311 | __be32 seqno; |
c1faead3 | 312 | uint8_t orig[ETH_ALEN]; |
f6c57a46 SE |
313 | /* "4 bytes boundary + 2 bytes" long to make the payload after the |
314 | * following ethernet header again 4 bytes boundary aligned | |
315 | */ | |
e022b956 SE |
316 | }; |
317 | ||
318 | #pragma pack() | |
c6c8fea2 | 319 | |
3c12de9a MH |
320 | /** |
321 | * struct batadv_coded_packet - network coded packet | |
322 | * @header: common batman packet header and ttl of first included packet | |
323 | * @reserved: Align following fields to 2-byte boundaries | |
324 | * @first_source: original source of first included packet | |
325 | * @first_orig_dest: original destinal of first included packet | |
326 | * @first_crc: checksum of first included packet | |
327 | * @first_ttvn: tt-version number of first included packet | |
328 | * @second_ttl: ttl of second packet | |
329 | * @second_dest: second receiver of this coded packet | |
330 | * @second_source: original source of second included packet | |
331 | * @second_orig_dest: original destination of second included packet | |
332 | * @second_crc: checksum of second included packet | |
333 | * @second_ttvn: tt version number of second included packet | |
334 | * @coded_len: length of network coded part of the payload | |
335 | */ | |
336 | struct batadv_coded_packet { | |
337 | struct batadv_header header; | |
338 | uint8_t first_ttvn; | |
339 | /* uint8_t first_dest[ETH_ALEN]; - saved in mac header destination */ | |
340 | uint8_t first_source[ETH_ALEN]; | |
341 | uint8_t first_orig_dest[ETH_ALEN]; | |
342 | __be32 first_crc; | |
343 | uint8_t second_ttl; | |
344 | uint8_t second_ttvn; | |
345 | uint8_t second_dest[ETH_ALEN]; | |
346 | uint8_t second_source[ETH_ALEN]; | |
347 | uint8_t second_orig_dest[ETH_ALEN]; | |
348 | __be32 second_crc; | |
e6a0b495 | 349 | __be16 coded_len; |
3c12de9a MH |
350 | }; |
351 | ||
ef261577 ML |
352 | /** |
353 | * struct batadv_unicast_tvlv - generic unicast packet with tvlv payload | |
354 | * @header: common batman packet header | |
355 | * @reserved: reserved field (for packet alignment) | |
356 | * @src: address of the source | |
357 | * @dst: address of the destination | |
358 | * @tvlv_len: length of tvlv data following the unicast tvlv header | |
359 | * @align: 2 bytes to align the header to a 4 byte boundry | |
360 | */ | |
361 | struct batadv_unicast_tvlv_packet { | |
362 | struct batadv_header header; | |
363 | uint8_t reserved; | |
364 | uint8_t dst[ETH_ALEN]; | |
365 | uint8_t src[ETH_ALEN]; | |
366 | __be16 tvlv_len; | |
367 | uint16_t align; | |
368 | }; | |
369 | ||
370 | /** | |
371 | * struct batadv_tvlv_hdr - base tvlv header struct | |
372 | * @type: tvlv container type (see batadv_tvlv_type) | |
373 | * @version: tvlv container version | |
374 | * @len: tvlv container length | |
375 | */ | |
376 | struct batadv_tvlv_hdr { | |
377 | uint8_t type; | |
378 | uint8_t version; | |
379 | __be16 len; | |
380 | }; | |
381 | ||
414254e3 ML |
382 | /** |
383 | * struct batadv_tvlv_gateway_data - gateway data propagated through gw tvlv | |
384 | * container | |
385 | * @bandwidth_down: advertised uplink download bandwidth | |
386 | * @bandwidth_up: advertised uplink upload bandwidth | |
387 | */ | |
388 | struct batadv_tvlv_gateway_data { | |
389 | __be32 bandwidth_down; | |
390 | __be32 bandwidth_up; | |
391 | }; | |
392 | ||
e1bf0c14 ML |
393 | /** |
394 | * struct batadv_tvlv_tt_data - tt data propagated through the tt tvlv container | |
395 | * @flags: translation table flags (see batadv_tt_data_flags) | |
396 | * @ttvn: translation table version number | |
7ea7b4a1 AQ |
397 | * @vlan_num: number of announced VLANs. In the TVLV this struct is followed by |
398 | * one batadv_tvlv_tt_vlan_data object per announced vlan | |
e1bf0c14 ML |
399 | */ |
400 | struct batadv_tvlv_tt_data { | |
401 | uint8_t flags; | |
402 | uint8_t ttvn; | |
7ea7b4a1 AQ |
403 | __be16 num_vlan; |
404 | }; | |
405 | ||
406 | /** | |
407 | * struct batadv_tvlv_tt_vlan_data - vlan specific tt data propagated through | |
408 | * the tt tvlv container | |
409 | * @crc: crc32 checksum of the entries belonging to this vlan | |
410 | * @vid: vlan identifier | |
411 | * @reserved: unused, useful for alignment purposes | |
412 | */ | |
413 | struct batadv_tvlv_tt_vlan_data { | |
414 | __be32 crc; | |
415 | __be16 vid; | |
ced72933 | 416 | uint16_t reserved; |
e1bf0c14 ML |
417 | }; |
418 | ||
419 | /** | |
420 | * struct batadv_tvlv_tt_change - translation table diff data | |
421 | * @flags: status indicators concerning the non-mesh client (see | |
422 | * batadv_tt_client_flags) | |
423 | * @reserved: reserved field | |
424 | * @addr: mac address of non-mesh client that triggered this tt change | |
c018ad3d | 425 | * @vid: VLAN identifier |
e1bf0c14 ML |
426 | */ |
427 | struct batadv_tvlv_tt_change { | |
428 | uint8_t flags; | |
429 | uint8_t reserved; | |
430 | uint8_t addr[ETH_ALEN]; | |
c018ad3d | 431 | __be16 vid; |
e1bf0c14 ML |
432 | }; |
433 | ||
122edaa0 ML |
434 | /** |
435 | * struct batadv_tvlv_roam_adv - roaming advertisement | |
436 | * @client: mac address of roaming client | |
c018ad3d | 437 | * @vid: VLAN identifier |
122edaa0 ML |
438 | */ |
439 | struct batadv_tvlv_roam_adv { | |
440 | uint8_t client[ETH_ALEN]; | |
c018ad3d | 441 | __be16 vid; |
122edaa0 ML |
442 | }; |
443 | ||
c6c8fea2 | 444 | #endif /* _NET_BATMAN_ADV_PACKET_H_ */ |