types.h 36 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995
  1. /* Copyright (C) 2007-2013 B.A.T.M.A.N. contributors:
  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
  18. */
  19. #ifndef _NET_BATMAN_ADV_TYPES_H_
  20. #define _NET_BATMAN_ADV_TYPES_H_
  21. #include "packet.h"
  22. #include "bitarray.h"
  23. #include <linux/kernel.h>
  24. /**
  25. * Maximum overhead for the encapsulation for a payload packet
  26. */
  27. #define BATADV_HEADER_LEN \
  28. (ETH_HLEN + max(sizeof(struct batadv_unicast_packet), \
  29. sizeof(struct batadv_bcast_packet)))
  30. #ifdef CONFIG_BATMAN_ADV_DAT
  31. /* batadv_dat_addr_t is the type used for all DHT addresses. If it is changed,
  32. * BATADV_DAT_ADDR_MAX is changed as well.
  33. *
  34. * *Please be careful: batadv_dat_addr_t must be UNSIGNED*
  35. */
  36. #define batadv_dat_addr_t uint16_t
  37. #endif /* CONFIG_BATMAN_ADV_DAT */
  38. /**
  39. * struct batadv_hard_iface_bat_iv - per hard interface B.A.T.M.A.N. IV data
  40. * @ogm_buff: buffer holding the OGM packet
  41. * @ogm_buff_len: length of the OGM packet buffer
  42. * @ogm_seqno: OGM sequence number - used to identify each OGM
  43. */
  44. struct batadv_hard_iface_bat_iv {
  45. unsigned char *ogm_buff;
  46. int ogm_buff_len;
  47. atomic_t ogm_seqno;
  48. };
  49. /**
  50. * struct batadv_hard_iface - network device known to batman-adv
  51. * @list: list node for batadv_hardif_list
  52. * @if_num: identificator of the interface
  53. * @if_status: status of the interface for batman-adv
  54. * @net_dev: pointer to the net_device
  55. * @frag_seqno: last fragment sequence number sent by this interface
  56. * @num_bcasts: number of payload re-broadcasts on this interface (ARQ)
  57. * @hardif_obj: kobject of the per interface sysfs "mesh" directory
  58. * @refcount: number of contexts the object is used
  59. * @batman_adv_ptype: packet type describing packets that should be processed by
  60. * batman-adv for this interface
  61. * @soft_iface: the batman-adv interface which uses this network interface
  62. * @rcu: struct used for freeing in an RCU-safe manner
  63. * @bat_iv: BATMAN IV specific per hard interface data
  64. * @cleanup_work: work queue callback item for hard interface deinit
  65. */
  66. struct batadv_hard_iface {
  67. struct list_head list;
  68. int16_t if_num;
  69. char if_status;
  70. struct net_device *net_dev;
  71. atomic_t frag_seqno;
  72. uint8_t num_bcasts;
  73. struct kobject *hardif_obj;
  74. atomic_t refcount;
  75. struct packet_type batman_adv_ptype;
  76. struct net_device *soft_iface;
  77. struct rcu_head rcu;
  78. struct batadv_hard_iface_bat_iv bat_iv;
  79. struct work_struct cleanup_work;
  80. };
  81. /**
  82. * struct batadv_orig_node - structure for orig_list maintaining nodes of mesh
  83. * @orig: originator ethernet address
  84. * @primary_addr: hosts primary interface address
  85. * @router: router that should be used to reach this originator
  86. * @batadv_dat_addr_t: address of the orig node in the distributed hash
  87. * @bcast_own: bitfield containing the number of our OGMs this orig_node
  88. * rebroadcasted "back" to us (relative to last_real_seqno)
  89. * @bcast_own_sum: counted result of bcast_own
  90. * @last_seen: time when last packet from this node was received
  91. * @bcast_seqno_reset: time when the broadcast seqno window was reset
  92. * @batman_seqno_reset: time when the batman seqno window was reset
  93. * @gw_flags: flags related to gateway class
  94. * @flags: for now only VIS_SERVER flag
  95. * @last_ttvn: last seen translation table version number
  96. * @tt_crc: CRC of the translation table
  97. * @tt_buff: last tt changeset this node received from the orig node
  98. * @tt_buff_len: length of the last tt changeset this node received from the
  99. * orig node
  100. * @tt_buff_lock: lock that protects tt_buff and tt_buff_len
  101. * @tt_size: number of global TT entries announced by the orig node
  102. * @tt_initialised: bool keeping track of whether or not this node have received
  103. * any translation table information from the orig node yet
  104. * @last_real_seqno: last and best known sequence number
  105. * @last_ttl: ttl of last received packet
  106. * @bcast_bits: bitfield containing the info which payload broadcast originated
  107. * from this orig node this host already has seen (relative to
  108. * last_bcast_seqno)
  109. * @last_bcast_seqno: last broadcast sequence number received by this host
  110. * @neigh_list: list of potential next hop neighbor towards this orig node
  111. * @frag_list: fragmentation buffer list for fragment re-assembly
  112. * @last_frag_packet: time when last fragmented packet from this node was
  113. * received
  114. * @neigh_list_lock: lock protecting neigh_list, router and bonding_list
  115. * @hash_entry: hlist node for batadv_priv::orig_hash
  116. * @bat_priv: pointer to soft_iface this orig node belongs to
  117. * @ogm_cnt_lock: lock protecting bcast_own, bcast_own_sum,
  118. * neigh_node->real_bits & neigh_node->real_packet_count
  119. * @bcast_seqno_lock: lock protecting bcast_bits & last_bcast_seqno
  120. * @bond_candidates: how many candidates are available
  121. * @bond_list: list of bonding candidates
  122. * @refcount: number of contexts the object is used
  123. * @rcu: struct used for freeing in an RCU-safe manner
  124. * @in_coding_list: list of nodes this orig can hear
  125. * @out_coding_list: list of nodes that can hear this orig
  126. * @in_coding_list_lock: protects in_coding_list
  127. * @out_coding_list_lock: protects out_coding_list
  128. */
  129. struct batadv_orig_node {
  130. uint8_t orig[ETH_ALEN];
  131. uint8_t primary_addr[ETH_ALEN];
  132. struct batadv_neigh_node __rcu *router; /* rcu protected pointer */
  133. #ifdef CONFIG_BATMAN_ADV_DAT
  134. batadv_dat_addr_t dat_addr;
  135. #endif
  136. unsigned long *bcast_own;
  137. uint8_t *bcast_own_sum;
  138. unsigned long last_seen;
  139. unsigned long bcast_seqno_reset;
  140. unsigned long batman_seqno_reset;
  141. uint8_t gw_flags;
  142. uint8_t flags;
  143. atomic_t last_ttvn;
  144. uint16_t tt_crc;
  145. unsigned char *tt_buff;
  146. int16_t tt_buff_len;
  147. spinlock_t tt_buff_lock; /* protects tt_buff & tt_buff_len */
  148. atomic_t tt_size;
  149. bool tt_initialised;
  150. uint32_t last_real_seqno;
  151. uint8_t last_ttl;
  152. DECLARE_BITMAP(bcast_bits, BATADV_TQ_LOCAL_WINDOW_SIZE);
  153. uint32_t last_bcast_seqno;
  154. struct hlist_head neigh_list;
  155. struct list_head frag_list;
  156. unsigned long last_frag_packet;
  157. /* neigh_list_lock protects: neigh_list, router & bonding_list */
  158. spinlock_t neigh_list_lock;
  159. struct hlist_node hash_entry;
  160. struct batadv_priv *bat_priv;
  161. /* ogm_cnt_lock protects: bcast_own, bcast_own_sum,
  162. * neigh_node->real_bits & neigh_node->real_packet_count
  163. */
  164. spinlock_t ogm_cnt_lock;
  165. /* bcast_seqno_lock protects: bcast_bits & last_bcast_seqno */
  166. spinlock_t bcast_seqno_lock;
  167. atomic_t bond_candidates;
  168. struct list_head bond_list;
  169. atomic_t refcount;
  170. struct rcu_head rcu;
  171. #ifdef CONFIG_BATMAN_ADV_NC
  172. struct list_head in_coding_list;
  173. struct list_head out_coding_list;
  174. spinlock_t in_coding_list_lock; /* Protects in_coding_list */
  175. spinlock_t out_coding_list_lock; /* Protects out_coding_list */
  176. #endif
  177. };
  178. /**
  179. * struct batadv_gw_node - structure for orig nodes announcing gw capabilities
  180. * @list: list node for batadv_priv_gw::list
  181. * @orig_node: pointer to corresponding orig node
  182. * @deleted: this struct is scheduled for deletion
  183. * @refcount: number of contexts the object is used
  184. * @rcu: struct used for freeing in an RCU-safe manner
  185. */
  186. struct batadv_gw_node {
  187. struct hlist_node list;
  188. struct batadv_orig_node *orig_node;
  189. unsigned long deleted;
  190. atomic_t refcount;
  191. struct rcu_head rcu;
  192. };
  193. /**
  194. * struct batadv_neigh_node - structure for single hop neighbors
  195. * @list: list node for batadv_orig_node::neigh_list
  196. * @addr: mac address of neigh node
  197. * @tq_recv: ring buffer of received TQ values from this neigh node
  198. * @tq_index: ring buffer index
  199. * @tq_avg: averaged tq of all tq values in the ring buffer (tq_recv)
  200. * @last_ttl: last received ttl from this neigh node
  201. * @bonding_list: list node for batadv_orig_node::bond_list
  202. * @last_seen: when last packet via this neighbor was received
  203. * @real_bits: bitfield containing the number of OGMs received from this neigh
  204. * node (relative to orig_node->last_real_seqno)
  205. * @real_packet_count: counted result of real_bits
  206. * @orig_node: pointer to corresponding orig_node
  207. * @if_incoming: pointer to incoming hard interface
  208. * @lq_update_lock: lock protecting tq_recv & tq_index
  209. * @refcount: number of contexts the object is used
  210. * @rcu: struct used for freeing in an RCU-safe manner
  211. */
  212. struct batadv_neigh_node {
  213. struct hlist_node list;
  214. uint8_t addr[ETH_ALEN];
  215. uint8_t tq_recv[BATADV_TQ_GLOBAL_WINDOW_SIZE];
  216. uint8_t tq_index;
  217. uint8_t tq_avg;
  218. uint8_t last_ttl;
  219. struct list_head bonding_list;
  220. unsigned long last_seen;
  221. DECLARE_BITMAP(real_bits, BATADV_TQ_LOCAL_WINDOW_SIZE);
  222. uint8_t real_packet_count;
  223. struct batadv_orig_node *orig_node;
  224. struct batadv_hard_iface *if_incoming;
  225. spinlock_t lq_update_lock; /* protects tq_recv & tq_index */
  226. atomic_t refcount;
  227. struct rcu_head rcu;
  228. };
  229. /**
  230. * struct batadv_bcast_duplist_entry - structure for LAN broadcast suppression
  231. * @orig[ETH_ALEN]: mac address of orig node orginating the broadcast
  232. * @crc: crc32 checksum of broadcast payload
  233. * @entrytime: time when the broadcast packet was received
  234. */
  235. #ifdef CONFIG_BATMAN_ADV_BLA
  236. struct batadv_bcast_duplist_entry {
  237. uint8_t orig[ETH_ALEN];
  238. __be32 crc;
  239. unsigned long entrytime;
  240. };
  241. #endif
  242. /**
  243. * enum batadv_counters - indices for traffic counters
  244. * @BATADV_CNT_TX: transmitted payload traffic packet counter
  245. * @BATADV_CNT_TX_BYTES: transmitted payload traffic bytes counter
  246. * @BATADV_CNT_TX_DROPPED: dropped transmission payload traffic packet counter
  247. * @BATADV_CNT_RX: received payload traffic packet counter
  248. * @BATADV_CNT_RX_BYTES: received payload traffic bytes counter
  249. * @BATADV_CNT_FORWARD: forwarded payload traffic packet counter
  250. * @BATADV_CNT_FORWARD_BYTES: forwarded payload traffic bytes counter
  251. * @BATADV_CNT_MGMT_TX: transmitted routing protocol traffic packet counter
  252. * @BATADV_CNT_MGMT_TX_BYTES: transmitted routing protocol traffic bytes counter
  253. * @BATADV_CNT_MGMT_RX: received routing protocol traffic packet counter
  254. * @BATADV_CNT_MGMT_RX_BYTES: received routing protocol traffic bytes counter
  255. * @BATADV_CNT_TT_REQUEST_TX: transmitted tt req traffic packet counter
  256. * @BATADV_CNT_TT_REQUEST_RX: received tt req traffic packet counter
  257. * @BATADV_CNT_TT_RESPONSE_TX: transmitted tt resp traffic packet counter
  258. * @BATADV_CNT_TT_RESPONSE_RX: received tt resp traffic packet counter
  259. * @BATADV_CNT_TT_ROAM_ADV_TX: transmitted tt roam traffic packet counter
  260. * @BATADV_CNT_TT_ROAM_ADV_RX: received tt roam traffic packet counter
  261. * @BATADV_CNT_DAT_GET_TX: transmitted dht GET traffic packet counter
  262. * @BATADV_CNT_DAT_GET_RX: received dht GET traffic packet counter
  263. * @BATADV_CNT_DAT_PUT_TX: transmitted dht PUT traffic packet counter
  264. * @BATADV_CNT_DAT_PUT_RX: received dht PUT traffic packet counter
  265. * @BATADV_CNT_DAT_CACHED_REPLY_TX: transmitted dat cache reply traffic packet
  266. * counter
  267. * @BATADV_CNT_NC_CODE: transmitted nc-combined traffic packet counter
  268. * @BATADV_CNT_NC_CODE_BYTES: transmitted nc-combined traffic bytes counter
  269. * @BATADV_CNT_NC_RECODE: transmitted nc-recombined traffic packet counter
  270. * @BATADV_CNT_NC_RECODE_BYTES: transmitted nc-recombined traffic bytes counter
  271. * @BATADV_CNT_NC_BUFFER: counter for packets buffered for later nc decoding
  272. * @BATADV_CNT_NC_DECODE: received and nc-decoded traffic packet counter
  273. * @BATADV_CNT_NC_DECODE_BYTES: received and nc-decoded traffic bytes counter
  274. * @BATADV_CNT_NC_DECODE_FAILED: received and decode-failed traffic packet
  275. * counter
  276. * @BATADV_CNT_NC_SNIFFED: counter for nc-decoded packets received in promisc
  277. * mode.
  278. * @BATADV_CNT_NUM: number of traffic counters
  279. */
  280. enum batadv_counters {
  281. BATADV_CNT_TX,
  282. BATADV_CNT_TX_BYTES,
  283. BATADV_CNT_TX_DROPPED,
  284. BATADV_CNT_RX,
  285. BATADV_CNT_RX_BYTES,
  286. BATADV_CNT_FORWARD,
  287. BATADV_CNT_FORWARD_BYTES,
  288. BATADV_CNT_MGMT_TX,
  289. BATADV_CNT_MGMT_TX_BYTES,
  290. BATADV_CNT_MGMT_RX,
  291. BATADV_CNT_MGMT_RX_BYTES,
  292. BATADV_CNT_TT_REQUEST_TX,
  293. BATADV_CNT_TT_REQUEST_RX,
  294. BATADV_CNT_TT_RESPONSE_TX,
  295. BATADV_CNT_TT_RESPONSE_RX,
  296. BATADV_CNT_TT_ROAM_ADV_TX,
  297. BATADV_CNT_TT_ROAM_ADV_RX,
  298. #ifdef CONFIG_BATMAN_ADV_DAT
  299. BATADV_CNT_DAT_GET_TX,
  300. BATADV_CNT_DAT_GET_RX,
  301. BATADV_CNT_DAT_PUT_TX,
  302. BATADV_CNT_DAT_PUT_RX,
  303. BATADV_CNT_DAT_CACHED_REPLY_TX,
  304. #endif
  305. #ifdef CONFIG_BATMAN_ADV_NC
  306. BATADV_CNT_NC_CODE,
  307. BATADV_CNT_NC_CODE_BYTES,
  308. BATADV_CNT_NC_RECODE,
  309. BATADV_CNT_NC_RECODE_BYTES,
  310. BATADV_CNT_NC_BUFFER,
  311. BATADV_CNT_NC_DECODE,
  312. BATADV_CNT_NC_DECODE_BYTES,
  313. BATADV_CNT_NC_DECODE_FAILED,
  314. BATADV_CNT_NC_SNIFFED,
  315. #endif
  316. BATADV_CNT_NUM,
  317. };
  318. /**
  319. * struct batadv_priv_tt - per mesh interface translation table data
  320. * @vn: translation table version number
  321. * @ogm_append_cnt: counter of number of OGMs containing the local tt diff
  322. * @local_changes: changes registered in an originator interval
  323. * @changes_list: tracks tt local changes within an originator interval
  324. * @local_hash: local translation table hash table
  325. * @global_hash: global translation table hash table
  326. * @req_list: list of pending & unanswered tt_requests
  327. * @roam_list: list of the last roaming events of each client limiting the
  328. * number of roaming events to avoid route flapping
  329. * @changes_list_lock: lock protecting changes_list
  330. * @req_list_lock: lock protecting req_list
  331. * @roam_list_lock: lock protecting roam_list
  332. * @local_entry_num: number of entries in the local hash table
  333. * @local_crc: Checksum of the local table, recomputed before sending a new OGM
  334. * @last_changeset: last tt changeset this host has generated
  335. * @last_changeset_len: length of last tt changeset this host has generated
  336. * @last_changeset_lock: lock protecting last_changeset & last_changeset_len
  337. * @work: work queue callback item for translation table purging
  338. */
  339. struct batadv_priv_tt {
  340. atomic_t vn;
  341. atomic_t ogm_append_cnt;
  342. atomic_t local_changes;
  343. struct list_head changes_list;
  344. struct batadv_hashtable *local_hash;
  345. struct batadv_hashtable *global_hash;
  346. struct list_head req_list;
  347. struct list_head roam_list;
  348. spinlock_t changes_list_lock; /* protects changes */
  349. spinlock_t req_list_lock; /* protects req_list */
  350. spinlock_t roam_list_lock; /* protects roam_list */
  351. atomic_t local_entry_num;
  352. uint16_t local_crc;
  353. unsigned char *last_changeset;
  354. int16_t last_changeset_len;
  355. /* protects last_changeset & last_changeset_len */
  356. spinlock_t last_changeset_lock;
  357. struct delayed_work work;
  358. };
  359. /**
  360. * struct batadv_priv_bla - per mesh interface bridge loope avoidance data
  361. * @num_requests; number of bla requests in flight
  362. * @claim_hash: hash table containing mesh nodes this host has claimed
  363. * @backbone_hash: hash table containing all detected backbone gateways
  364. * @bcast_duplist: recently received broadcast packets array (for broadcast
  365. * duplicate suppression)
  366. * @bcast_duplist_curr: index of last broadcast packet added to bcast_duplist
  367. * @bcast_duplist_lock: lock protecting bcast_duplist & bcast_duplist_curr
  368. * @claim_dest: local claim data (e.g. claim group)
  369. * @work: work queue callback item for cleanups & bla announcements
  370. */
  371. #ifdef CONFIG_BATMAN_ADV_BLA
  372. struct batadv_priv_bla {
  373. atomic_t num_requests;
  374. struct batadv_hashtable *claim_hash;
  375. struct batadv_hashtable *backbone_hash;
  376. struct batadv_bcast_duplist_entry bcast_duplist[BATADV_DUPLIST_SIZE];
  377. int bcast_duplist_curr;
  378. /* protects bcast_duplist & bcast_duplist_curr */
  379. spinlock_t bcast_duplist_lock;
  380. struct batadv_bla_claim_dst claim_dest;
  381. struct delayed_work work;
  382. };
  383. #endif
  384. /**
  385. * struct batadv_debug_log - debug logging data
  386. * @log_buff: buffer holding the logs (ring bufer)
  387. * @log_start: index of next character to read
  388. * @log_end: index of next character to write
  389. * @lock: lock protecting log_buff, log_start & log_end
  390. * @queue_wait: log reader's wait queue
  391. */
  392. #ifdef CONFIG_BATMAN_ADV_DEBUG
  393. struct batadv_priv_debug_log {
  394. char log_buff[BATADV_LOG_BUF_LEN];
  395. unsigned long log_start;
  396. unsigned long log_end;
  397. spinlock_t lock; /* protects log_buff, log_start and log_end */
  398. wait_queue_head_t queue_wait;
  399. };
  400. #endif
  401. /**
  402. * struct batadv_priv_gw - per mesh interface gateway data
  403. * @list: list of available gateway nodes
  404. * @list_lock: lock protecting gw_list & curr_gw
  405. * @curr_gw: pointer to currently selected gateway node
  406. * @reselect: bool indicating a gateway re-selection is in progress
  407. */
  408. struct batadv_priv_gw {
  409. struct hlist_head list;
  410. spinlock_t list_lock; /* protects gw_list & curr_gw */
  411. struct batadv_gw_node __rcu *curr_gw; /* rcu protected pointer */
  412. atomic_t reselect;
  413. };
  414. /**
  415. * struct batadv_priv_vis - per mesh interface vis data
  416. * @send_list: list of batadv_vis_info packets to sent
  417. * @hash: hash table containing vis data from other nodes in the network
  418. * @hash_lock: lock protecting the hash table
  419. * @list_lock: lock protecting my_info::recv_list
  420. * @work: work queue callback item for vis packet sending
  421. * @my_info: holds this node's vis data sent on a regular basis
  422. */
  423. struct batadv_priv_vis {
  424. struct list_head send_list;
  425. struct batadv_hashtable *hash;
  426. spinlock_t hash_lock; /* protects hash */
  427. spinlock_t list_lock; /* protects my_info::recv_list */
  428. struct delayed_work work;
  429. struct batadv_vis_info *my_info;
  430. };
  431. /**
  432. * struct batadv_priv_dat - per mesh interface DAT private data
  433. * @addr: node DAT address
  434. * @hash: hashtable representing the local ARP cache
  435. * @work: work queue callback item for cache purging
  436. */
  437. #ifdef CONFIG_BATMAN_ADV_DAT
  438. struct batadv_priv_dat {
  439. batadv_dat_addr_t addr;
  440. struct batadv_hashtable *hash;
  441. struct delayed_work work;
  442. };
  443. #endif
  444. /**
  445. * struct batadv_priv_nc - per mesh interface network coding private data
  446. * @work: work queue callback item for cleanup
  447. * @debug_dir: dentry for nc subdir in batman-adv directory in debugfs
  448. * @min_tq: only consider neighbors for encoding if neigh_tq > min_tq
  449. * @max_fwd_delay: maximum packet forward delay to allow coding of packets
  450. * @max_buffer_time: buffer time for sniffed packets used to decoding
  451. * @timestamp_fwd_flush: timestamp of last forward packet queue flush
  452. * @timestamp_sniffed_purge: timestamp of last sniffed packet queue purge
  453. * @coding_hash: Hash table used to buffer skbs while waiting for another
  454. * incoming skb to code it with. Skbs are added to the buffer just before being
  455. * forwarded in routing.c
  456. * @decoding_hash: Hash table used to buffer skbs that might be needed to decode
  457. * a received coded skb. The buffer is used for 1) skbs arriving on the
  458. * soft-interface; 2) skbs overheard on the hard-interface; and 3) skbs
  459. * forwarded by batman-adv.
  460. */
  461. struct batadv_priv_nc {
  462. struct delayed_work work;
  463. struct dentry *debug_dir;
  464. u8 min_tq;
  465. u32 max_fwd_delay;
  466. u32 max_buffer_time;
  467. unsigned long timestamp_fwd_flush;
  468. unsigned long timestamp_sniffed_purge;
  469. struct batadv_hashtable *coding_hash;
  470. struct batadv_hashtable *decoding_hash;
  471. };
  472. /**
  473. * struct batadv_priv - per mesh interface data
  474. * @mesh_state: current status of the mesh (inactive/active/deactivating)
  475. * @soft_iface: net device which holds this struct as private data
  476. * @stats: structure holding the data for the ndo_get_stats() call
  477. * @bat_counters: mesh internal traffic statistic counters (see batadv_counters)
  478. * @aggregated_ogms: bool indicating whether OGM aggregation is enabled
  479. * @bonding: bool indicating whether traffic bonding is enabled
  480. * @fragmentation: bool indicating whether traffic fragmentation is enabled
  481. * @ap_isolation: bool indicating whether ap isolation is enabled
  482. * @bridge_loop_avoidance: bool indicating whether bridge loop avoidance is
  483. * enabled
  484. * @distributed_arp_table: bool indicating whether distributed ARP table is
  485. * enabled
  486. * @vis_mode: vis operation: client or server (see batadv_vis_packettype)
  487. * @gw_mode: gateway operation: off, client or server (see batadv_gw_modes)
  488. * @gw_sel_class: gateway selection class (applies if gw_mode client)
  489. * @gw_bandwidth: gateway announced bandwidth (applies if gw_mode server)
  490. * @orig_interval: OGM broadcast interval in milliseconds
  491. * @hop_penalty: penalty which will be applied to an OGM's tq-field on every hop
  492. * @log_level: configured log level (see batadv_dbg_level)
  493. * @bcast_seqno: last sent broadcast packet sequence number
  494. * @bcast_queue_left: number of remaining buffered broadcast packet slots
  495. * @batman_queue_left: number of remaining OGM packet slots
  496. * @num_ifaces: number of interfaces assigned to this mesh interface
  497. * @mesh_obj: kobject for sysfs mesh subdirectory
  498. * @debug_dir: dentry for debugfs batman-adv subdirectory
  499. * @forw_bat_list: list of aggregated OGMs that will be forwarded
  500. * @forw_bcast_list: list of broadcast packets that will be rebroadcasted
  501. * @orig_hash: hash table containing mesh participants (orig nodes)
  502. * @forw_bat_list_lock: lock protecting forw_bat_list
  503. * @forw_bcast_list_lock: lock protecting forw_bcast_list
  504. * @orig_work: work queue callback item for orig node purging
  505. * @cleanup_work: work queue callback item for soft interface deinit
  506. * @primary_if: one of the hard interfaces assigned to this mesh interface
  507. * becomes the primary interface
  508. * @bat_algo_ops: routing algorithm used by this mesh interface
  509. * @bla: bridge loope avoidance data
  510. * @debug_log: holding debug logging relevant data
  511. * @gw: gateway data
  512. * @tt: translation table data
  513. * @vis: vis data
  514. * @dat: distributed arp table data
  515. * @network_coding: bool indicating whether network coding is enabled
  516. * @batadv_priv_nc: network coding data
  517. */
  518. struct batadv_priv {
  519. atomic_t mesh_state;
  520. struct net_device *soft_iface;
  521. struct net_device_stats stats;
  522. uint64_t __percpu *bat_counters; /* Per cpu counters */
  523. atomic_t aggregated_ogms;
  524. atomic_t bonding;
  525. atomic_t fragmentation;
  526. atomic_t ap_isolation;
  527. #ifdef CONFIG_BATMAN_ADV_BLA
  528. atomic_t bridge_loop_avoidance;
  529. #endif
  530. #ifdef CONFIG_BATMAN_ADV_DAT
  531. atomic_t distributed_arp_table;
  532. #endif
  533. atomic_t vis_mode;
  534. atomic_t gw_mode;
  535. atomic_t gw_sel_class;
  536. atomic_t gw_bandwidth;
  537. atomic_t orig_interval;
  538. atomic_t hop_penalty;
  539. #ifdef CONFIG_BATMAN_ADV_DEBUG
  540. atomic_t log_level;
  541. #endif
  542. atomic_t bcast_seqno;
  543. atomic_t bcast_queue_left;
  544. atomic_t batman_queue_left;
  545. char num_ifaces;
  546. struct kobject *mesh_obj;
  547. struct dentry *debug_dir;
  548. struct hlist_head forw_bat_list;
  549. struct hlist_head forw_bcast_list;
  550. struct batadv_hashtable *orig_hash;
  551. spinlock_t forw_bat_list_lock; /* protects forw_bat_list */
  552. spinlock_t forw_bcast_list_lock; /* protects forw_bcast_list */
  553. struct delayed_work orig_work;
  554. struct work_struct cleanup_work;
  555. struct batadv_hard_iface __rcu *primary_if; /* rcu protected pointer */
  556. struct batadv_algo_ops *bat_algo_ops;
  557. #ifdef CONFIG_BATMAN_ADV_BLA
  558. struct batadv_priv_bla bla;
  559. #endif
  560. #ifdef CONFIG_BATMAN_ADV_DEBUG
  561. struct batadv_priv_debug_log *debug_log;
  562. #endif
  563. struct batadv_priv_gw gw;
  564. struct batadv_priv_tt tt;
  565. struct batadv_priv_vis vis;
  566. #ifdef CONFIG_BATMAN_ADV_DAT
  567. struct batadv_priv_dat dat;
  568. #endif
  569. #ifdef CONFIG_BATMAN_ADV_NC
  570. atomic_t network_coding;
  571. struct batadv_priv_nc nc;
  572. #endif /* CONFIG_BATMAN_ADV_NC */
  573. };
  574. /**
  575. * struct batadv_socket_client - layer2 icmp socket client data
  576. * @queue_list: packet queue for packets destined for this socket client
  577. * @queue_len: number of packets in the packet queue (queue_list)
  578. * @index: socket client's index in the batadv_socket_client_hash
  579. * @lock: lock protecting queue_list, queue_len & index
  580. * @queue_wait: socket client's wait queue
  581. * @bat_priv: pointer to soft_iface this client belongs to
  582. */
  583. struct batadv_socket_client {
  584. struct list_head queue_list;
  585. unsigned int queue_len;
  586. unsigned char index;
  587. spinlock_t lock; /* protects queue_list, queue_len & index */
  588. wait_queue_head_t queue_wait;
  589. struct batadv_priv *bat_priv;
  590. };
  591. /**
  592. * struct batadv_socket_packet - layer2 icmp packet for socket client
  593. * @list: list node for batadv_socket_client::queue_list
  594. * @icmp_len: size of the layer2 icmp packet
  595. * @icmp_packet: layer2 icmp packet
  596. */
  597. struct batadv_socket_packet {
  598. struct list_head list;
  599. size_t icmp_len;
  600. struct batadv_icmp_packet_rr icmp_packet;
  601. };
  602. /**
  603. * struct batadv_bla_backbone_gw - batman-adv gateway bridged into the LAN
  604. * @orig: originator address of backbone node (mac address of primary iface)
  605. * @vid: vlan id this gateway was detected on
  606. * @hash_entry: hlist node for batadv_priv_bla::backbone_hash
  607. * @bat_priv: pointer to soft_iface this backbone gateway belongs to
  608. * @lasttime: last time we heard of this backbone gw
  609. * @wait_periods: grace time for bridge forward delays and bla group forming at
  610. * bootup phase - no bcast traffic is formwared until it has elapsed
  611. * @request_sent: if this bool is set to true we are out of sync with this
  612. * backbone gateway - no bcast traffic is formwared until the situation was
  613. * resolved
  614. * @crc: crc16 checksum over all claims
  615. * @refcount: number of contexts the object is used
  616. * @rcu: struct used for freeing in an RCU-safe manner
  617. */
  618. #ifdef CONFIG_BATMAN_ADV_BLA
  619. struct batadv_bla_backbone_gw {
  620. uint8_t orig[ETH_ALEN];
  621. unsigned short vid;
  622. struct hlist_node hash_entry;
  623. struct batadv_priv *bat_priv;
  624. unsigned long lasttime;
  625. atomic_t wait_periods;
  626. atomic_t request_sent;
  627. uint16_t crc;
  628. atomic_t refcount;
  629. struct rcu_head rcu;
  630. };
  631. /**
  632. * struct batadv_bla_claim - claimed non-mesh client structure
  633. * @addr: mac address of claimed non-mesh client
  634. * @vid: vlan id this client was detected on
  635. * @batadv_bla_backbone_gw: pointer to backbone gw claiming this client
  636. * @lasttime: last time we heard of claim (locals only)
  637. * @hash_entry: hlist node for batadv_priv_bla::claim_hash
  638. * @refcount: number of contexts the object is used
  639. * @rcu: struct used for freeing in an RCU-safe manner
  640. */
  641. struct batadv_bla_claim {
  642. uint8_t addr[ETH_ALEN];
  643. unsigned short vid;
  644. struct batadv_bla_backbone_gw *backbone_gw;
  645. unsigned long lasttime;
  646. struct hlist_node hash_entry;
  647. struct rcu_head rcu;
  648. atomic_t refcount;
  649. };
  650. #endif
  651. /**
  652. * struct batadv_tt_common_entry - tt local & tt global common data
  653. * @addr: mac address of non-mesh client
  654. * @hash_entry: hlist node for batadv_priv_tt::local_hash or for
  655. * batadv_priv_tt::global_hash
  656. * @flags: various state handling flags (see batadv_tt_client_flags)
  657. * @added_at: timestamp used for purging stale tt common entries
  658. * @refcount: number of contexts the object is used
  659. * @rcu: struct used for freeing in an RCU-safe manner
  660. */
  661. struct batadv_tt_common_entry {
  662. uint8_t addr[ETH_ALEN];
  663. struct hlist_node hash_entry;
  664. uint16_t flags;
  665. unsigned long added_at;
  666. atomic_t refcount;
  667. struct rcu_head rcu;
  668. };
  669. /**
  670. * struct batadv_tt_local_entry - translation table local entry data
  671. * @common: general translation table data
  672. * @last_seen: timestamp used for purging stale tt local entries
  673. */
  674. struct batadv_tt_local_entry {
  675. struct batadv_tt_common_entry common;
  676. unsigned long last_seen;
  677. };
  678. /**
  679. * struct batadv_tt_global_entry - translation table global entry data
  680. * @common: general translation table data
  681. * @orig_list: list of orig nodes announcing this non-mesh client
  682. * @list_lock: lock protecting orig_list
  683. * @roam_at: time at which TT_GLOBAL_ROAM was set
  684. */
  685. struct batadv_tt_global_entry {
  686. struct batadv_tt_common_entry common;
  687. struct hlist_head orig_list;
  688. spinlock_t list_lock; /* protects orig_list */
  689. unsigned long roam_at;
  690. };
  691. /**
  692. * struct batadv_tt_orig_list_entry - orig node announcing a non-mesh client
  693. * @orig_node: pointer to orig node announcing this non-mesh client
  694. * @ttvn: translation table version number which added the non-mesh client
  695. * @list: list node for batadv_tt_global_entry::orig_list
  696. * @refcount: number of contexts the object is used
  697. * @rcu: struct used for freeing in an RCU-safe manner
  698. */
  699. struct batadv_tt_orig_list_entry {
  700. struct batadv_orig_node *orig_node;
  701. uint8_t ttvn;
  702. struct hlist_node list;
  703. atomic_t refcount;
  704. struct rcu_head rcu;
  705. };
  706. /**
  707. * struct batadv_tt_change_node - structure for tt changes occured
  708. * @list: list node for batadv_priv_tt::changes_list
  709. * @change: holds the actual translation table diff data
  710. */
  711. struct batadv_tt_change_node {
  712. struct list_head list;
  713. struct batadv_tt_change change;
  714. };
  715. /**
  716. * struct batadv_tt_req_node - data to keep track of the tt requests in flight
  717. * @addr: mac address address of the originator this request was sent to
  718. * @issued_at: timestamp used for purging stale tt requests
  719. * @list: list node for batadv_priv_tt::req_list
  720. */
  721. struct batadv_tt_req_node {
  722. uint8_t addr[ETH_ALEN];
  723. unsigned long issued_at;
  724. struct list_head list;
  725. };
  726. /**
  727. * struct batadv_tt_roam_node - roaming client data
  728. * @addr: mac address of the client in the roaming phase
  729. * @counter: number of allowed roaming events per client within a single
  730. * OGM interval (changes are committed with each OGM)
  731. * @first_time: timestamp used for purging stale roaming node entries
  732. * @list: list node for batadv_priv_tt::roam_list
  733. */
  734. struct batadv_tt_roam_node {
  735. uint8_t addr[ETH_ALEN];
  736. atomic_t counter;
  737. unsigned long first_time;
  738. struct list_head list;
  739. };
  740. /**
  741. * struct batadv_nc_node - network coding node
  742. * @list: next and prev pointer for the list handling
  743. * @addr: the node's mac address
  744. * @refcount: number of contexts the object is used by
  745. * @rcu: struct used for freeing in an RCU-safe manner
  746. * @orig_node: pointer to corresponding orig node struct
  747. * @last_seen: timestamp of last ogm received from this node
  748. */
  749. struct batadv_nc_node {
  750. struct list_head list;
  751. uint8_t addr[ETH_ALEN];
  752. atomic_t refcount;
  753. struct rcu_head rcu;
  754. struct batadv_orig_node *orig_node;
  755. unsigned long last_seen;
  756. };
  757. /**
  758. * struct batadv_nc_path - network coding path
  759. * @hash_entry: next and prev pointer for the list handling
  760. * @rcu: struct used for freeing in an RCU-safe manner
  761. * @refcount: number of contexts the object is used by
  762. * @packet_list: list of buffered packets for this path
  763. * @packet_list_lock: access lock for packet list
  764. * @next_hop: next hop (destination) of path
  765. * @prev_hop: previous hop (source) of path
  766. * @last_valid: timestamp for last validation of path
  767. */
  768. struct batadv_nc_path {
  769. struct hlist_node hash_entry;
  770. struct rcu_head rcu;
  771. atomic_t refcount;
  772. struct list_head packet_list;
  773. spinlock_t packet_list_lock; /* Protects packet_list */
  774. uint8_t next_hop[ETH_ALEN];
  775. uint8_t prev_hop[ETH_ALEN];
  776. unsigned long last_valid;
  777. };
  778. /**
  779. * struct batadv_nc_packet - network coding packet used when coding and
  780. * decoding packets
  781. * @list: next and prev pointer for the list handling
  782. * @packet_id: crc32 checksum of skb data
  783. * @timestamp: field containing the info when the packet was added to path
  784. * @neigh_node: pointer to original next hop neighbor of skb
  785. * @skb: skb which can be encoded or used for decoding
  786. * @nc_path: pointer to path this nc packet is attached to
  787. */
  788. struct batadv_nc_packet {
  789. struct list_head list;
  790. __be32 packet_id;
  791. unsigned long timestamp;
  792. struct batadv_neigh_node *neigh_node;
  793. struct sk_buff *skb;
  794. struct batadv_nc_path *nc_path;
  795. };
  796. /**
  797. * batadv_skb_cb - control buffer structure used to store private data relevant
  798. * to batman-adv in the skb->cb buffer in skbs.
  799. * @decoded: Marks a skb as decoded, which is checked when searching for coding
  800. * opportunities in network-coding.c
  801. */
  802. struct batadv_skb_cb {
  803. bool decoded;
  804. };
  805. /**
  806. * struct batadv_forw_packet - structure for bcast packets to be sent/forwarded
  807. * @list: list node for batadv_socket_client::queue_list
  808. * @send_time: execution time for delayed_work (packet sending)
  809. * @own: bool for locally generated packets (local OGMs are re-scheduled after
  810. * sending)
  811. * @skb: bcast packet's skb buffer
  812. * @packet_len: size of aggregated OGM packet inside the skb buffer
  813. * @direct_link_flags: direct link flags for aggregated OGM packets
  814. * @num_packets: counter for bcast packet retransmission
  815. * @delayed_work: work queue callback item for packet sending
  816. * @if_incoming: pointer incoming hard-iface or primary iface if locally
  817. * generated packet
  818. */
  819. struct batadv_forw_packet {
  820. struct hlist_node list;
  821. unsigned long send_time;
  822. uint8_t own;
  823. struct sk_buff *skb;
  824. uint16_t packet_len;
  825. uint32_t direct_link_flags;
  826. uint8_t num_packets;
  827. struct delayed_work delayed_work;
  828. struct batadv_hard_iface *if_incoming;
  829. };
  830. /**
  831. * struct batadv_frag_packet_list_entry - storage for fragment packet
  832. * @list: list node for orig_node::frag_list
  833. * @seqno: sequence number of the fragment
  834. * @skb: fragment's skb buffer
  835. */
  836. struct batadv_frag_packet_list_entry {
  837. struct list_head list;
  838. uint16_t seqno;
  839. struct sk_buff *skb;
  840. };
  841. /**
  842. * struct batadv_vis_info - local data for vis information
  843. * @first_seen: timestamp used for purging stale vis info entries
  844. * @recv_list: List of server-neighbors we have received this packet from. This
  845. * packet should not be re-forward to them again. List elements are struct
  846. * batadv_vis_recvlist_node
  847. * @send_list: list of packets to be forwarded
  848. * @refcount: number of contexts the object is used
  849. * @hash_entry: hlist node for batadv_priv_vis::hash
  850. * @bat_priv: pointer to soft_iface this orig node belongs to
  851. * @skb_packet: contains the vis packet
  852. */
  853. struct batadv_vis_info {
  854. unsigned long first_seen;
  855. struct list_head recv_list;
  856. struct list_head send_list;
  857. struct kref refcount;
  858. struct hlist_node hash_entry;
  859. struct batadv_priv *bat_priv;
  860. struct sk_buff *skb_packet;
  861. } __packed;
  862. /**
  863. * struct batadv_vis_info_entry - contains link information for vis
  864. * @src: source MAC of the link, all zero for local TT entry
  865. * @dst: destination MAC of the link, client mac address for local TT entry
  866. * @quality: transmission quality of the link, or 0 for local TT entry
  867. */
  868. struct batadv_vis_info_entry {
  869. uint8_t src[ETH_ALEN];
  870. uint8_t dest[ETH_ALEN];
  871. uint8_t quality;
  872. } __packed;
  873. /**
  874. * struct batadv_vis_recvlist_node - list entry for batadv_vis_info::recv_list
  875. * @list: list node for batadv_vis_info::recv_list
  876. * @mac: MAC address of the originator from where the vis_info was received
  877. */
  878. struct batadv_vis_recvlist_node {
  879. struct list_head list;
  880. uint8_t mac[ETH_ALEN];
  881. };
  882. /**
  883. * struct batadv_vis_if_list_entry - auxiliary data for vis data generation
  884. * @addr: MAC address of the interface
  885. * @primary: true if this interface is the primary interface
  886. * @list: list node the interface list
  887. *
  888. * While scanning for vis-entries of a particular vis-originator
  889. * this list collects its interfaces to create a subgraph/cluster
  890. * out of them later
  891. */
  892. struct batadv_vis_if_list_entry {
  893. uint8_t addr[ETH_ALEN];
  894. bool primary;
  895. struct hlist_node list;
  896. };
  897. /**
  898. * struct batadv_algo_ops - mesh algorithm callbacks
  899. * @list: list node for the batadv_algo_list
  900. * @name: name of the algorithm
  901. * @bat_iface_enable: init routing info when hard-interface is enabled
  902. * @bat_iface_disable: de-init routing info when hard-interface is disabled
  903. * @bat_iface_update_mac: (re-)init mac addresses of the protocol information
  904. * belonging to this hard-interface
  905. * @bat_primary_iface_set: called when primary interface is selected / changed
  906. * @bat_ogm_schedule: prepare a new outgoing OGM for the send queue
  907. * @bat_ogm_emit: send scheduled OGM
  908. */
  909. struct batadv_algo_ops {
  910. struct hlist_node list;
  911. char *name;
  912. int (*bat_iface_enable)(struct batadv_hard_iface *hard_iface);
  913. void (*bat_iface_disable)(struct batadv_hard_iface *hard_iface);
  914. void (*bat_iface_update_mac)(struct batadv_hard_iface *hard_iface);
  915. void (*bat_primary_iface_set)(struct batadv_hard_iface *hard_iface);
  916. void (*bat_ogm_schedule)(struct batadv_hard_iface *hard_iface);
  917. void (*bat_ogm_emit)(struct batadv_forw_packet *forw_packet);
  918. };
  919. /**
  920. * struct batadv_dat_entry - it is a single entry of batman-adv ARP backend. It
  921. * is used to stored ARP entries needed for the global DAT cache
  922. * @ip: the IPv4 corresponding to this DAT/ARP entry
  923. * @mac_addr: the MAC address associated to the stored IPv4
  924. * @last_update: time in jiffies when this entry was refreshed last time
  925. * @hash_entry: hlist node for batadv_priv_dat::hash
  926. * @refcount: number of contexts the object is used
  927. * @rcu: struct used for freeing in an RCU-safe manner
  928. */
  929. struct batadv_dat_entry {
  930. __be32 ip;
  931. uint8_t mac_addr[ETH_ALEN];
  932. unsigned long last_update;
  933. struct hlist_node hash_entry;
  934. atomic_t refcount;
  935. struct rcu_head rcu;
  936. };
  937. /**
  938. * struct batadv_dat_candidate - candidate destination for DAT operations
  939. * @type: the type of the selected candidate. It can one of the following:
  940. * - BATADV_DAT_CANDIDATE_NOT_FOUND
  941. * - BATADV_DAT_CANDIDATE_ORIG
  942. * @orig_node: if type is BATADV_DAT_CANDIDATE_ORIG this field points to the
  943. * corresponding originator node structure
  944. */
  945. struct batadv_dat_candidate {
  946. int type;
  947. struct batadv_orig_node *orig_node;
  948. };
  949. #endif /* _NET_BATMAN_ADV_TYPES_H_ */