br_private.h 17 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609
  1. /*
  2. * Linux ethernet bridge
  3. *
  4. * Authors:
  5. * Lennert Buytenhek <buytenh@gnu.org>
  6. *
  7. * This program is free software; you can redistribute it and/or
  8. * modify it under the terms of the GNU General Public License
  9. * as published by the Free Software Foundation; either version
  10. * 2 of the License, or (at your option) any later version.
  11. */
  12. #ifndef _BR_PRIVATE_H
  13. #define _BR_PRIVATE_H
  14. #include <linux/netdevice.h>
  15. #include <linux/if_bridge.h>
  16. #include <linux/netpoll.h>
  17. #include <linux/u64_stats_sync.h>
  18. #include <net/route.h>
  19. #define BR_HASH_BITS 8
  20. #define BR_HASH_SIZE (1 << BR_HASH_BITS)
  21. #define BR_HOLD_TIME (1*HZ)
  22. #define BR_PORT_BITS 10
  23. #define BR_MAX_PORTS (1<<BR_PORT_BITS)
  24. #define BR_VERSION "2.3"
  25. /* Control of forwarding link local multicast */
  26. #define BR_GROUPFWD_DEFAULT 0
  27. /* Don't allow forwarding control protocols like STP and LLDP */
  28. #define BR_GROUPFWD_RESTRICTED 0x4007u
  29. /* Path to usermode spanning tree program */
  30. #define BR_STP_PROG "/sbin/bridge-stp"
  31. typedef struct bridge_id bridge_id;
  32. typedef struct mac_addr mac_addr;
  33. typedef __u16 port_id;
  34. struct bridge_id
  35. {
  36. unsigned char prio[2];
  37. unsigned char addr[6];
  38. };
  39. struct mac_addr
  40. {
  41. unsigned char addr[6];
  42. };
  43. struct br_ip
  44. {
  45. union {
  46. __be32 ip4;
  47. #if IS_ENABLED(CONFIG_IPV6)
  48. struct in6_addr ip6;
  49. #endif
  50. } u;
  51. __be16 proto;
  52. };
  53. struct net_bridge_fdb_entry
  54. {
  55. struct hlist_node hlist;
  56. struct net_bridge_port *dst;
  57. struct rcu_head rcu;
  58. unsigned long updated;
  59. unsigned long used;
  60. mac_addr addr;
  61. unsigned char is_local;
  62. unsigned char is_static;
  63. };
  64. struct net_bridge_port_group {
  65. struct net_bridge_port *port;
  66. struct net_bridge_port_group __rcu *next;
  67. struct hlist_node mglist;
  68. struct rcu_head rcu;
  69. struct timer_list timer;
  70. struct br_ip addr;
  71. };
  72. struct net_bridge_mdb_entry
  73. {
  74. struct hlist_node hlist[2];
  75. struct net_bridge *br;
  76. struct net_bridge_port_group __rcu *ports;
  77. struct rcu_head rcu;
  78. struct timer_list timer;
  79. struct br_ip addr;
  80. bool mglist;
  81. };
  82. struct net_bridge_mdb_htable
  83. {
  84. struct hlist_head *mhash;
  85. struct rcu_head rcu;
  86. struct net_bridge_mdb_htable *old;
  87. u32 size;
  88. u32 max;
  89. u32 secret;
  90. u32 ver;
  91. };
  92. struct net_bridge_port
  93. {
  94. struct net_bridge *br;
  95. struct net_device *dev;
  96. struct list_head list;
  97. /* STP */
  98. u8 priority;
  99. u8 state;
  100. u16 port_no;
  101. unsigned char topology_change_ack;
  102. unsigned char config_pending;
  103. port_id port_id;
  104. port_id designated_port;
  105. bridge_id designated_root;
  106. bridge_id designated_bridge;
  107. u32 path_cost;
  108. u32 designated_cost;
  109. unsigned long designated_age;
  110. struct timer_list forward_delay_timer;
  111. struct timer_list hold_timer;
  112. struct timer_list message_age_timer;
  113. struct kobject kobj;
  114. struct rcu_head rcu;
  115. unsigned long flags;
  116. #define BR_HAIRPIN_MODE 0x00000001
  117. #define BR_BPDU_GUARD 0x00000002
  118. #define BR_ROOT_BLOCK 0x00000004
  119. #define BR_MULTICAST_FAST_LEAVE 0x00000008
  120. #ifdef CONFIG_BRIDGE_IGMP_SNOOPING
  121. u32 multicast_startup_queries_sent;
  122. unsigned char multicast_router;
  123. struct timer_list multicast_router_timer;
  124. struct timer_list multicast_query_timer;
  125. struct hlist_head mglist;
  126. struct hlist_node rlist;
  127. #endif
  128. #ifdef CONFIG_SYSFS
  129. char sysfs_name[IFNAMSIZ];
  130. #endif
  131. #ifdef CONFIG_NET_POLL_CONTROLLER
  132. struct netpoll *np;
  133. #endif
  134. };
  135. #define br_port_exists(dev) (dev->priv_flags & IFF_BRIDGE_PORT)
  136. static inline struct net_bridge_port *br_port_get_rcu(const struct net_device *dev)
  137. {
  138. struct net_bridge_port *port =
  139. rcu_dereference_rtnl(dev->rx_handler_data);
  140. return br_port_exists(dev) ? port : NULL;
  141. }
  142. static inline struct net_bridge_port *br_port_get_rtnl(struct net_device *dev)
  143. {
  144. return br_port_exists(dev) ?
  145. rtnl_dereference(dev->rx_handler_data) : NULL;
  146. }
  147. struct br_cpu_netstats {
  148. u64 rx_packets;
  149. u64 rx_bytes;
  150. u64 tx_packets;
  151. u64 tx_bytes;
  152. struct u64_stats_sync syncp;
  153. };
  154. struct net_bridge
  155. {
  156. spinlock_t lock;
  157. struct list_head port_list;
  158. struct net_device *dev;
  159. struct br_cpu_netstats __percpu *stats;
  160. spinlock_t hash_lock;
  161. struct hlist_head hash[BR_HASH_SIZE];
  162. #ifdef CONFIG_BRIDGE_NETFILTER
  163. struct rtable fake_rtable;
  164. bool nf_call_iptables;
  165. bool nf_call_ip6tables;
  166. bool nf_call_arptables;
  167. #endif
  168. unsigned long flags;
  169. #define BR_SET_MAC_ADDR 0x00000001
  170. u16 group_fwd_mask;
  171. /* STP */
  172. bridge_id designated_root;
  173. bridge_id bridge_id;
  174. u32 root_path_cost;
  175. unsigned long max_age;
  176. unsigned long hello_time;
  177. unsigned long forward_delay;
  178. unsigned long bridge_max_age;
  179. unsigned long ageing_time;
  180. unsigned long bridge_hello_time;
  181. unsigned long bridge_forward_delay;
  182. u8 group_addr[ETH_ALEN];
  183. u16 root_port;
  184. enum {
  185. BR_NO_STP, /* no spanning tree */
  186. BR_KERNEL_STP, /* old STP in kernel */
  187. BR_USER_STP, /* new RSTP in userspace */
  188. } stp_enabled;
  189. unsigned char topology_change;
  190. unsigned char topology_change_detected;
  191. #ifdef CONFIG_BRIDGE_IGMP_SNOOPING
  192. unsigned char multicast_router;
  193. u8 multicast_disabled:1;
  194. u8 multicast_querier:1;
  195. u32 hash_elasticity;
  196. u32 hash_max;
  197. u32 multicast_last_member_count;
  198. u32 multicast_startup_queries_sent;
  199. u32 multicast_startup_query_count;
  200. unsigned long multicast_last_member_interval;
  201. unsigned long multicast_membership_interval;
  202. unsigned long multicast_querier_interval;
  203. unsigned long multicast_query_interval;
  204. unsigned long multicast_query_response_interval;
  205. unsigned long multicast_startup_query_interval;
  206. spinlock_t multicast_lock;
  207. struct net_bridge_mdb_htable __rcu *mdb;
  208. struct hlist_head router_list;
  209. struct timer_list multicast_router_timer;
  210. struct timer_list multicast_querier_timer;
  211. struct timer_list multicast_query_timer;
  212. #endif
  213. struct timer_list hello_timer;
  214. struct timer_list tcn_timer;
  215. struct timer_list topology_change_timer;
  216. struct timer_list gc_timer;
  217. struct kobject *ifobj;
  218. };
  219. struct br_input_skb_cb {
  220. struct net_device *brdev;
  221. #ifdef CONFIG_BRIDGE_IGMP_SNOOPING
  222. int igmp;
  223. int mrouters_only;
  224. #endif
  225. };
  226. #define BR_INPUT_SKB_CB(__skb) ((struct br_input_skb_cb *)(__skb)->cb)
  227. #ifdef CONFIG_BRIDGE_IGMP_SNOOPING
  228. # define BR_INPUT_SKB_CB_MROUTERS_ONLY(__skb) (BR_INPUT_SKB_CB(__skb)->mrouters_only)
  229. #else
  230. # define BR_INPUT_SKB_CB_MROUTERS_ONLY(__skb) (0)
  231. #endif
  232. #define br_printk(level, br, format, args...) \
  233. printk(level "%s: " format, (br)->dev->name, ##args)
  234. #define br_err(__br, format, args...) \
  235. br_printk(KERN_ERR, __br, format, ##args)
  236. #define br_warn(__br, format, args...) \
  237. br_printk(KERN_WARNING, __br, format, ##args)
  238. #define br_notice(__br, format, args...) \
  239. br_printk(KERN_NOTICE, __br, format, ##args)
  240. #define br_info(__br, format, args...) \
  241. br_printk(KERN_INFO, __br, format, ##args)
  242. #define br_debug(br, format, args...) \
  243. pr_debug("%s: " format, (br)->dev->name, ##args)
  244. extern struct notifier_block br_device_notifier;
  245. /* called under bridge lock */
  246. static inline int br_is_root_bridge(const struct net_bridge *br)
  247. {
  248. return !memcmp(&br->bridge_id, &br->designated_root, 8);
  249. }
  250. /* br_device.c */
  251. extern void br_dev_setup(struct net_device *dev);
  252. extern void br_dev_delete(struct net_device *dev, struct list_head *list);
  253. extern netdev_tx_t br_dev_xmit(struct sk_buff *skb,
  254. struct net_device *dev);
  255. #ifdef CONFIG_NET_POLL_CONTROLLER
  256. static inline struct netpoll_info *br_netpoll_info(struct net_bridge *br)
  257. {
  258. return br->dev->npinfo;
  259. }
  260. static inline void br_netpoll_send_skb(const struct net_bridge_port *p,
  261. struct sk_buff *skb)
  262. {
  263. struct netpoll *np = p->np;
  264. if (np)
  265. netpoll_send_skb(np, skb);
  266. }
  267. extern int br_netpoll_enable(struct net_bridge_port *p, gfp_t gfp);
  268. extern void br_netpoll_disable(struct net_bridge_port *p);
  269. #else
  270. static inline struct netpoll_info *br_netpoll_info(struct net_bridge *br)
  271. {
  272. return NULL;
  273. }
  274. static inline void br_netpoll_send_skb(const struct net_bridge_port *p,
  275. struct sk_buff *skb)
  276. {
  277. }
  278. static inline int br_netpoll_enable(struct net_bridge_port *p, gfp_t gfp)
  279. {
  280. return 0;
  281. }
  282. static inline void br_netpoll_disable(struct net_bridge_port *p)
  283. {
  284. }
  285. #endif
  286. /* br_fdb.c */
  287. extern int br_fdb_init(void);
  288. extern void br_fdb_fini(void);
  289. extern void br_fdb_flush(struct net_bridge *br);
  290. extern void br_fdb_changeaddr(struct net_bridge_port *p,
  291. const unsigned char *newaddr);
  292. extern void br_fdb_change_mac_address(struct net_bridge *br, const u8 *newaddr);
  293. extern void br_fdb_cleanup(unsigned long arg);
  294. extern void br_fdb_delete_by_port(struct net_bridge *br,
  295. const struct net_bridge_port *p, int do_all);
  296. extern struct net_bridge_fdb_entry *__br_fdb_get(struct net_bridge *br,
  297. const unsigned char *addr);
  298. extern int br_fdb_test_addr(struct net_device *dev, unsigned char *addr);
  299. extern int br_fdb_fillbuf(struct net_bridge *br, void *buf,
  300. unsigned long count, unsigned long off);
  301. extern int br_fdb_insert(struct net_bridge *br,
  302. struct net_bridge_port *source,
  303. const unsigned char *addr);
  304. extern void br_fdb_update(struct net_bridge *br,
  305. struct net_bridge_port *source,
  306. const unsigned char *addr);
  307. extern int br_fdb_delete(struct ndmsg *ndm,
  308. struct net_device *dev,
  309. const unsigned char *addr);
  310. extern int br_fdb_add(struct ndmsg *nlh, struct nlattr *tb[],
  311. struct net_device *dev,
  312. const unsigned char *addr,
  313. u16 nlh_flags);
  314. extern int br_fdb_dump(struct sk_buff *skb,
  315. struct netlink_callback *cb,
  316. struct net_device *dev,
  317. int idx);
  318. /* br_forward.c */
  319. extern void br_deliver(const struct net_bridge_port *to,
  320. struct sk_buff *skb);
  321. extern int br_dev_queue_push_xmit(struct sk_buff *skb);
  322. extern void br_forward(const struct net_bridge_port *to,
  323. struct sk_buff *skb, struct sk_buff *skb0);
  324. extern int br_forward_finish(struct sk_buff *skb);
  325. extern void br_flood_deliver(struct net_bridge *br, struct sk_buff *skb);
  326. extern void br_flood_forward(struct net_bridge *br, struct sk_buff *skb,
  327. struct sk_buff *skb2);
  328. /* br_if.c */
  329. extern void br_port_carrier_check(struct net_bridge_port *p);
  330. extern int br_add_bridge(struct net *net, const char *name);
  331. extern int br_del_bridge(struct net *net, const char *name);
  332. extern void br_net_exit(struct net *net);
  333. extern int br_add_if(struct net_bridge *br,
  334. struct net_device *dev);
  335. extern int br_del_if(struct net_bridge *br,
  336. struct net_device *dev);
  337. extern int br_min_mtu(const struct net_bridge *br);
  338. extern netdev_features_t br_features_recompute(struct net_bridge *br,
  339. netdev_features_t features);
  340. /* br_input.c */
  341. extern int br_handle_frame_finish(struct sk_buff *skb);
  342. extern rx_handler_result_t br_handle_frame(struct sk_buff **pskb);
  343. /* br_ioctl.c */
  344. extern int br_dev_ioctl(struct net_device *dev, struct ifreq *rq, int cmd);
  345. extern int br_ioctl_deviceless_stub(struct net *net, unsigned int cmd, void __user *arg);
  346. /* br_multicast.c */
  347. #ifdef CONFIG_BRIDGE_IGMP_SNOOPING
  348. extern unsigned int br_mdb_rehash_seq;
  349. extern int br_multicast_rcv(struct net_bridge *br,
  350. struct net_bridge_port *port,
  351. struct sk_buff *skb);
  352. extern struct net_bridge_mdb_entry *br_mdb_get(struct net_bridge *br,
  353. struct sk_buff *skb);
  354. extern void br_multicast_add_port(struct net_bridge_port *port);
  355. extern void br_multicast_del_port(struct net_bridge_port *port);
  356. extern void br_multicast_enable_port(struct net_bridge_port *port);
  357. extern void br_multicast_disable_port(struct net_bridge_port *port);
  358. extern void br_multicast_init(struct net_bridge *br);
  359. extern void br_multicast_open(struct net_bridge *br);
  360. extern void br_multicast_stop(struct net_bridge *br);
  361. extern void br_multicast_deliver(struct net_bridge_mdb_entry *mdst,
  362. struct sk_buff *skb);
  363. extern void br_multicast_forward(struct net_bridge_mdb_entry *mdst,
  364. struct sk_buff *skb, struct sk_buff *skb2);
  365. extern int br_multicast_set_router(struct net_bridge *br, unsigned long val);
  366. extern int br_multicast_set_port_router(struct net_bridge_port *p,
  367. unsigned long val);
  368. extern int br_multicast_toggle(struct net_bridge *br, unsigned long val);
  369. extern int br_multicast_set_querier(struct net_bridge *br, unsigned long val);
  370. extern int br_multicast_set_hash_max(struct net_bridge *br, unsigned long val);
  371. extern struct net_bridge_mdb_entry *br_mdb_ip_get(
  372. struct net_bridge_mdb_htable *mdb,
  373. struct br_ip *dst);
  374. extern struct net_bridge_mdb_entry *br_multicast_new_group(struct net_bridge *br,
  375. struct net_bridge_port *port, struct br_ip *group);
  376. extern void br_multicast_free_pg(struct rcu_head *head);
  377. extern struct net_bridge_port_group *br_multicast_new_port_group(
  378. struct net_bridge_port *port,
  379. struct br_ip *group,
  380. struct net_bridge_port_group *next);
  381. extern void br_mdb_init(void);
  382. extern void br_mdb_notify(struct net_device *dev, struct net_bridge_port *port,
  383. struct br_ip *group, int type);
  384. #define mlock_dereference(X, br) \
  385. rcu_dereference_protected(X, lockdep_is_held(&br->multicast_lock))
  386. #if IS_ENABLED(CONFIG_IPV6)
  387. #include <net/addrconf.h>
  388. static inline int ipv6_is_transient_multicast(const struct in6_addr *addr)
  389. {
  390. if (ipv6_addr_is_multicast(addr) && IPV6_ADDR_MC_FLAG_TRANSIENT(addr))
  391. return 1;
  392. return 0;
  393. }
  394. #endif
  395. static inline bool br_multicast_is_router(struct net_bridge *br)
  396. {
  397. return br->multicast_router == 2 ||
  398. (br->multicast_router == 1 &&
  399. timer_pending(&br->multicast_router_timer));
  400. }
  401. #else
  402. static inline int br_multicast_rcv(struct net_bridge *br,
  403. struct net_bridge_port *port,
  404. struct sk_buff *skb)
  405. {
  406. return 0;
  407. }
  408. static inline struct net_bridge_mdb_entry *br_mdb_get(struct net_bridge *br,
  409. struct sk_buff *skb)
  410. {
  411. return NULL;
  412. }
  413. static inline void br_multicast_add_port(struct net_bridge_port *port)
  414. {
  415. }
  416. static inline void br_multicast_del_port(struct net_bridge_port *port)
  417. {
  418. }
  419. static inline void br_multicast_enable_port(struct net_bridge_port *port)
  420. {
  421. }
  422. static inline void br_multicast_disable_port(struct net_bridge_port *port)
  423. {
  424. }
  425. static inline void br_multicast_init(struct net_bridge *br)
  426. {
  427. }
  428. static inline void br_multicast_open(struct net_bridge *br)
  429. {
  430. }
  431. static inline void br_multicast_stop(struct net_bridge *br)
  432. {
  433. }
  434. static inline void br_multicast_deliver(struct net_bridge_mdb_entry *mdst,
  435. struct sk_buff *skb)
  436. {
  437. }
  438. static inline void br_multicast_forward(struct net_bridge_mdb_entry *mdst,
  439. struct sk_buff *skb,
  440. struct sk_buff *skb2)
  441. {
  442. }
  443. static inline bool br_multicast_is_router(struct net_bridge *br)
  444. {
  445. return 0;
  446. }
  447. #endif
  448. /* br_netfilter.c */
  449. #ifdef CONFIG_BRIDGE_NETFILTER
  450. extern int br_netfilter_init(void);
  451. extern void br_netfilter_fini(void);
  452. extern void br_netfilter_rtable_init(struct net_bridge *);
  453. #else
  454. #define br_netfilter_init() (0)
  455. #define br_netfilter_fini() do { } while(0)
  456. #define br_netfilter_rtable_init(x)
  457. #endif
  458. /* br_stp.c */
  459. extern void br_log_state(const struct net_bridge_port *p);
  460. extern struct net_bridge_port *br_get_port(struct net_bridge *br,
  461. u16 port_no);
  462. extern void br_init_port(struct net_bridge_port *p);
  463. extern void br_become_designated_port(struct net_bridge_port *p);
  464. extern int br_set_forward_delay(struct net_bridge *br, unsigned long x);
  465. extern int br_set_hello_time(struct net_bridge *br, unsigned long x);
  466. extern int br_set_max_age(struct net_bridge *br, unsigned long x);
  467. /* br_stp_if.c */
  468. extern void br_stp_enable_bridge(struct net_bridge *br);
  469. extern void br_stp_disable_bridge(struct net_bridge *br);
  470. extern void br_stp_set_enabled(struct net_bridge *br, unsigned long val);
  471. extern void br_stp_enable_port(struct net_bridge_port *p);
  472. extern void br_stp_disable_port(struct net_bridge_port *p);
  473. extern bool br_stp_recalculate_bridge_id(struct net_bridge *br);
  474. extern void br_stp_change_bridge_id(struct net_bridge *br, const unsigned char *a);
  475. extern void br_stp_set_bridge_priority(struct net_bridge *br,
  476. u16 newprio);
  477. extern int br_stp_set_port_priority(struct net_bridge_port *p,
  478. unsigned long newprio);
  479. extern int br_stp_set_path_cost(struct net_bridge_port *p,
  480. unsigned long path_cost);
  481. extern ssize_t br_show_bridge_id(char *buf, const struct bridge_id *id);
  482. /* br_stp_bpdu.c */
  483. struct stp_proto;
  484. extern void br_stp_rcv(const struct stp_proto *proto, struct sk_buff *skb,
  485. struct net_device *dev);
  486. /* br_stp_timer.c */
  487. extern void br_stp_timer_init(struct net_bridge *br);
  488. extern void br_stp_port_timer_init(struct net_bridge_port *p);
  489. extern unsigned long br_timer_value(const struct timer_list *timer);
  490. /* br.c */
  491. #if IS_ENABLED(CONFIG_ATM_LANE)
  492. extern int (*br_fdb_test_addr_hook)(struct net_device *dev, unsigned char *addr);
  493. #endif
  494. /* br_netlink.c */
  495. extern struct rtnl_link_ops br_link_ops;
  496. extern int br_netlink_init(void);
  497. extern void br_netlink_fini(void);
  498. extern void br_ifinfo_notify(int event, struct net_bridge_port *port);
  499. extern int br_setlink(struct net_device *dev, struct nlmsghdr *nlmsg);
  500. extern int br_getlink(struct sk_buff *skb, u32 pid, u32 seq,
  501. struct net_device *dev);
  502. #ifdef CONFIG_SYSFS
  503. /* br_sysfs_if.c */
  504. extern const struct sysfs_ops brport_sysfs_ops;
  505. extern int br_sysfs_addif(struct net_bridge_port *p);
  506. extern int br_sysfs_renameif(struct net_bridge_port *p);
  507. /* br_sysfs_br.c */
  508. extern int br_sysfs_addbr(struct net_device *dev);
  509. extern void br_sysfs_delbr(struct net_device *dev);
  510. #else
  511. static inline int br_sysfs_addif(struct net_bridge_port *p) { return 0; }
  512. static inline int br_sysfs_renameif(struct net_bridge_port *p) { return 0; }
  513. static inline int br_sysfs_addbr(struct net_device *dev) { return 0; }
  514. static inline void br_sysfs_delbr(struct net_device *dev) { return; }
  515. #endif /* CONFIG_SYSFS */
  516. #endif