xref: /openbmc/linux/net/bridge/br_private.h (revision e408336a)
1 /* SPDX-License-Identifier: GPL-2.0-or-later */
2 /*
3  *	Linux ethernet bridge
4  *
5  *	Authors:
6  *	Lennert Buytenhek		<buytenh@gnu.org>
7  */
8 
9 #ifndef _BR_PRIVATE_H
10 #define _BR_PRIVATE_H
11 
12 #include <linux/netdevice.h>
13 #include <linux/if_bridge.h>
14 #include <linux/netpoll.h>
15 #include <linux/u64_stats_sync.h>
16 #include <net/route.h>
17 #include <net/ip6_fib.h>
18 #include <linux/if_vlan.h>
19 #include <linux/rhashtable.h>
20 #include <linux/refcount.h>
21 
22 #define BR_HASH_BITS 8
23 #define BR_HASH_SIZE (1 << BR_HASH_BITS)
24 
25 #define BR_HOLD_TIME (1*HZ)
26 
27 #define BR_PORT_BITS	10
28 #define BR_MAX_PORTS	(1<<BR_PORT_BITS)
29 
30 #define BR_MULTICAST_DEFAULT_HASH_MAX 4096
31 #define BR_MULTICAST_QUERY_INTVL_MIN msecs_to_jiffies(1000)
32 #define BR_MULTICAST_STARTUP_QUERY_INTVL_MIN BR_MULTICAST_QUERY_INTVL_MIN
33 
34 #define BR_HWDOM_MAX BITS_PER_LONG
35 
36 #define BR_VERSION	"2.3"
37 
38 /* Control of forwarding link local multicast */
39 #define BR_GROUPFWD_DEFAULT	0
40 /* Don't allow forwarding of control protocols like STP, MAC PAUSE and LACP */
41 enum {
42 	BR_GROUPFWD_STP		= BIT(0),
43 	BR_GROUPFWD_MACPAUSE	= BIT(1),
44 	BR_GROUPFWD_LACP	= BIT(2),
45 };
46 
47 #define BR_GROUPFWD_RESTRICTED (BR_GROUPFWD_STP | BR_GROUPFWD_MACPAUSE | \
48 				BR_GROUPFWD_LACP)
49 /* The Nearest Customer Bridge Group Address, 01-80-C2-00-00-[00,0B,0C,0D,0F] */
50 #define BR_GROUPFWD_8021AD	0xB801u
51 
52 /* Path to usermode spanning tree program */
53 #define BR_STP_PROG	"/sbin/bridge-stp"
54 
55 #define BR_FDB_NOTIFY_SETTABLE_BITS (FDB_NOTIFY_BIT | FDB_NOTIFY_INACTIVE_BIT)
56 
57 typedef struct bridge_id bridge_id;
58 typedef struct mac_addr mac_addr;
59 typedef __u16 port_id;
60 
61 struct bridge_id {
62 	unsigned char	prio[2];
63 	unsigned char	addr[ETH_ALEN];
64 };
65 
66 struct mac_addr {
67 	unsigned char	addr[ETH_ALEN];
68 };
69 
70 #ifdef CONFIG_BRIDGE_IGMP_SNOOPING
71 /* our own querier */
72 struct bridge_mcast_own_query {
73 	struct timer_list	timer;
74 	u32			startup_sent;
75 };
76 
77 /* other querier */
78 struct bridge_mcast_other_query {
79 	struct timer_list		timer;
80 	unsigned long			delay_time;
81 };
82 
83 /* selected querier */
84 struct bridge_mcast_querier {
85 	struct br_ip addr;
86 	int port_ifidx;
87 	seqcount_spinlock_t seq;
88 };
89 
90 /* IGMP/MLD statistics */
91 struct bridge_mcast_stats {
92 	struct br_mcast_stats mstats;
93 	struct u64_stats_sync syncp;
94 };
95 
96 struct br_mdb_src_entry {
97 	struct br_ip			addr;
98 };
99 
100 struct br_mdb_config {
101 	struct net_bridge		*br;
102 	struct net_bridge_port		*p;
103 	struct br_mdb_entry		*entry;
104 	struct br_ip			group;
105 	bool				src_entry;
106 	u8				filter_mode;
107 	u16				nlflags;
108 	struct br_mdb_src_entry		*src_entries;
109 	int				num_src_entries;
110 	u8				rt_protocol;
111 };
112 #endif
113 
114 /* net_bridge_mcast_port must be always defined due to forwarding stubs */
115 struct net_bridge_mcast_port {
116 #ifdef CONFIG_BRIDGE_IGMP_SNOOPING
117 	struct net_bridge_port		*port;
118 	struct net_bridge_vlan		*vlan;
119 
120 	struct bridge_mcast_own_query	ip4_own_query;
121 	struct timer_list		ip4_mc_router_timer;
122 	struct hlist_node		ip4_rlist;
123 #if IS_ENABLED(CONFIG_IPV6)
124 	struct bridge_mcast_own_query	ip6_own_query;
125 	struct timer_list		ip6_mc_router_timer;
126 	struct hlist_node		ip6_rlist;
127 #endif /* IS_ENABLED(CONFIG_IPV6) */
128 	unsigned char			multicast_router;
129 	u32				mdb_n_entries;
130 	u32				mdb_max_entries;
131 #endif /* CONFIG_BRIDGE_IGMP_SNOOPING */
132 };
133 
134 /* net_bridge_mcast must be always defined due to forwarding stubs */
135 struct net_bridge_mcast {
136 #ifdef CONFIG_BRIDGE_IGMP_SNOOPING
137 	struct net_bridge		*br;
138 	struct net_bridge_vlan		*vlan;
139 
140 	u32				multicast_last_member_count;
141 	u32				multicast_startup_query_count;
142 
143 	u8				multicast_querier;
144 	u8				multicast_igmp_version;
145 	u8				multicast_router;
146 #if IS_ENABLED(CONFIG_IPV6)
147 	u8				multicast_mld_version;
148 #endif
149 	unsigned long			multicast_last_member_interval;
150 	unsigned long			multicast_membership_interval;
151 	unsigned long			multicast_querier_interval;
152 	unsigned long			multicast_query_interval;
153 	unsigned long			multicast_query_response_interval;
154 	unsigned long			multicast_startup_query_interval;
155 	struct hlist_head		ip4_mc_router_list;
156 	struct timer_list		ip4_mc_router_timer;
157 	struct bridge_mcast_other_query	ip4_other_query;
158 	struct bridge_mcast_own_query	ip4_own_query;
159 	struct bridge_mcast_querier	ip4_querier;
160 #if IS_ENABLED(CONFIG_IPV6)
161 	struct hlist_head		ip6_mc_router_list;
162 	struct timer_list		ip6_mc_router_timer;
163 	struct bridge_mcast_other_query	ip6_other_query;
164 	struct bridge_mcast_own_query	ip6_own_query;
165 	struct bridge_mcast_querier	ip6_querier;
166 #endif /* IS_ENABLED(CONFIG_IPV6) */
167 #endif /* CONFIG_BRIDGE_IGMP_SNOOPING */
168 };
169 
170 struct br_tunnel_info {
171 	__be64				tunnel_id;
172 	struct metadata_dst __rcu	*tunnel_dst;
173 };
174 
175 /* private vlan flags */
176 enum {
177 	BR_VLFLAG_PER_PORT_STATS = BIT(0),
178 	BR_VLFLAG_ADDED_BY_SWITCHDEV = BIT(1),
179 	BR_VLFLAG_MCAST_ENABLED = BIT(2),
180 	BR_VLFLAG_GLOBAL_MCAST_ENABLED = BIT(3),
181 };
182 
183 /**
184  * struct net_bridge_vlan - per-vlan entry
185  *
186  * @vnode: rhashtable member
187  * @vid: VLAN id
188  * @flags: bridge vlan flags
189  * @priv_flags: private (in-kernel) bridge vlan flags
190  * @state: STP state (e.g. blocking, learning, forwarding)
191  * @stats: per-cpu VLAN statistics
192  * @br: if MASTER flag set, this points to a bridge struct
193  * @port: if MASTER flag unset, this points to a port struct
194  * @refcnt: if MASTER flag set, this is bumped for each port referencing it
195  * @brvlan: if MASTER flag unset, this points to the global per-VLAN context
196  *          for this VLAN entry
197  * @br_mcast_ctx: if MASTER flag set, this is the global vlan multicast context
198  * @port_mcast_ctx: if MASTER flag unset, this is the per-port/vlan multicast
199  *                  context
200  * @msti: if MASTER flag set, this holds the VLANs MST instance
201  * @vlist: sorted list of VLAN entries
202  * @rcu: used for entry destruction
203  *
204  * This structure is shared between the global per-VLAN entries contained in
205  * the bridge rhashtable and the local per-port per-VLAN entries contained in
206  * the port's rhashtable. The union entries should be interpreted depending on
207  * the entry flags that are set.
208  */
209 struct net_bridge_vlan {
210 	struct rhash_head		vnode;
211 	struct rhash_head		tnode;
212 	u16				vid;
213 	u16				flags;
214 	u16				priv_flags;
215 	u8				state;
216 	struct pcpu_sw_netstats __percpu *stats;
217 	union {
218 		struct net_bridge	*br;
219 		struct net_bridge_port	*port;
220 	};
221 	union {
222 		refcount_t		refcnt;
223 		struct net_bridge_vlan	*brvlan;
224 	};
225 
226 	struct br_tunnel_info		tinfo;
227 
228 	union {
229 		struct net_bridge_mcast		br_mcast_ctx;
230 		struct net_bridge_mcast_port	port_mcast_ctx;
231 	};
232 
233 	u16				msti;
234 
235 	struct list_head		vlist;
236 
237 	struct rcu_head			rcu;
238 };
239 
240 /**
241  * struct net_bridge_vlan_group
242  *
243  * @vlan_hash: VLAN entry rhashtable
244  * @vlan_list: sorted VLAN entry list
245  * @num_vlans: number of total VLAN entries
246  * @pvid: PVID VLAN id
247  * @pvid_state: PVID's STP state (e.g. forwarding, learning, blocking)
248  *
249  * IMPORTANT: Be careful when checking if there're VLAN entries using list
250  *            primitives because the bridge can have entries in its list which
251  *            are just for global context but not for filtering, i.e. they have
252  *            the master flag set but not the brentry flag. If you have to check
253  *            if there're "real" entries in the bridge please test @num_vlans
254  */
255 struct net_bridge_vlan_group {
256 	struct rhashtable		vlan_hash;
257 	struct rhashtable		tunnel_hash;
258 	struct list_head		vlan_list;
259 	u16				num_vlans;
260 	u16				pvid;
261 	u8				pvid_state;
262 };
263 
264 /* bridge fdb flags */
265 enum {
266 	BR_FDB_LOCAL,
267 	BR_FDB_STATIC,
268 	BR_FDB_STICKY,
269 	BR_FDB_ADDED_BY_USER,
270 	BR_FDB_ADDED_BY_EXT_LEARN,
271 	BR_FDB_OFFLOADED,
272 	BR_FDB_NOTIFY,
273 	BR_FDB_NOTIFY_INACTIVE,
274 	BR_FDB_LOCKED,
275 };
276 
277 struct net_bridge_fdb_key {
278 	mac_addr addr;
279 	u16 vlan_id;
280 };
281 
282 struct net_bridge_fdb_entry {
283 	struct rhash_head		rhnode;
284 	struct net_bridge_port		*dst;
285 
286 	struct net_bridge_fdb_key	key;
287 	struct hlist_node		fdb_node;
288 	unsigned long			flags;
289 
290 	/* write-heavy members should not affect lookups */
291 	unsigned long			updated ____cacheline_aligned_in_smp;
292 	unsigned long			used;
293 
294 	struct rcu_head			rcu;
295 };
296 
297 struct net_bridge_fdb_flush_desc {
298 	unsigned long			flags;
299 	unsigned long			flags_mask;
300 	int				port_ifindex;
301 	u16				vlan_id;
302 };
303 
304 #define MDB_PG_FLAGS_PERMANENT	BIT(0)
305 #define MDB_PG_FLAGS_OFFLOAD	BIT(1)
306 #define MDB_PG_FLAGS_FAST_LEAVE	BIT(2)
307 #define MDB_PG_FLAGS_STAR_EXCL	BIT(3)
308 #define MDB_PG_FLAGS_BLOCKED	BIT(4)
309 
310 #define PG_SRC_ENT_LIMIT	32
311 
312 #define BR_SGRP_F_DELETE	BIT(0)
313 #define BR_SGRP_F_SEND		BIT(1)
314 #define BR_SGRP_F_INSTALLED	BIT(2)
315 #define BR_SGRP_F_USER_ADDED	BIT(3)
316 
317 struct net_bridge_mcast_gc {
318 	struct hlist_node		gc_node;
319 	void				(*destroy)(struct net_bridge_mcast_gc *gc);
320 };
321 
322 struct net_bridge_group_src {
323 	struct hlist_node		node;
324 
325 	struct br_ip			addr;
326 	struct net_bridge_port_group	*pg;
327 	u8				flags;
328 	u8				src_query_rexmit_cnt;
329 	struct timer_list		timer;
330 
331 	struct net_bridge		*br;
332 	struct net_bridge_mcast_gc	mcast_gc;
333 	struct rcu_head			rcu;
334 };
335 
336 struct net_bridge_port_group_sg_key {
337 	struct net_bridge_port		*port;
338 	struct br_ip			addr;
339 };
340 
341 struct net_bridge_port_group {
342 	struct net_bridge_port_group __rcu *next;
343 	struct net_bridge_port_group_sg_key key;
344 	unsigned char			eth_addr[ETH_ALEN] __aligned(2);
345 	unsigned char			flags;
346 	unsigned char			filter_mode;
347 	unsigned char			grp_query_rexmit_cnt;
348 	unsigned char			rt_protocol;
349 
350 	struct hlist_head		src_list;
351 	unsigned int			src_ents;
352 	struct timer_list		timer;
353 	struct timer_list		rexmit_timer;
354 	struct hlist_node		mglist;
355 	struct rb_root			eht_set_tree;
356 	struct rb_root			eht_host_tree;
357 
358 	struct rhash_head		rhnode;
359 	struct net_bridge_mcast_gc	mcast_gc;
360 	struct rcu_head			rcu;
361 };
362 
363 struct net_bridge_mdb_entry {
364 	struct rhash_head		rhnode;
365 	struct net_bridge		*br;
366 	struct net_bridge_port_group __rcu *ports;
367 	struct br_ip			addr;
368 	bool				host_joined;
369 
370 	struct timer_list		timer;
371 	struct hlist_node		mdb_node;
372 
373 	struct net_bridge_mcast_gc	mcast_gc;
374 	struct rcu_head			rcu;
375 };
376 
377 struct net_bridge_port {
378 	struct net_bridge		*br;
379 	struct net_device		*dev;
380 	netdevice_tracker		dev_tracker;
381 	struct list_head		list;
382 
383 	unsigned long			flags;
384 #ifdef CONFIG_BRIDGE_VLAN_FILTERING
385 	struct net_bridge_vlan_group	__rcu *vlgrp;
386 #endif
387 	struct net_bridge_port		__rcu *backup_port;
388 
389 	/* STP */
390 	u8				priority;
391 	u8				state;
392 	u16				port_no;
393 	unsigned char			topology_change_ack;
394 	unsigned char			config_pending;
395 	port_id				port_id;
396 	port_id				designated_port;
397 	bridge_id			designated_root;
398 	bridge_id			designated_bridge;
399 	u32				path_cost;
400 	u32				designated_cost;
401 	unsigned long			designated_age;
402 
403 	struct timer_list		forward_delay_timer;
404 	struct timer_list		hold_timer;
405 	struct timer_list		message_age_timer;
406 	struct kobject			kobj;
407 	struct rcu_head			rcu;
408 
409 	struct net_bridge_mcast_port	multicast_ctx;
410 
411 #ifdef CONFIG_BRIDGE_IGMP_SNOOPING
412 	struct bridge_mcast_stats	__percpu *mcast_stats;
413 
414 	u32				multicast_eht_hosts_limit;
415 	u32				multicast_eht_hosts_cnt;
416 	struct hlist_head		mglist;
417 #endif
418 
419 #ifdef CONFIG_SYSFS
420 	char				sysfs_name[IFNAMSIZ];
421 #endif
422 
423 #ifdef CONFIG_NET_POLL_CONTROLLER
424 	struct netpoll			*np;
425 #endif
426 #ifdef CONFIG_NET_SWITCHDEV
427 	/* Identifier used to group ports that share the same switchdev
428 	 * hardware domain.
429 	 */
430 	int				hwdom;
431 	int				offload_count;
432 	struct netdev_phys_item_id	ppid;
433 #endif
434 	u16				group_fwd_mask;
435 	u16				backup_redirected_cnt;
436 
437 	struct bridge_stp_xstats	stp_xstats;
438 };
439 
440 #define kobj_to_brport(obj)	container_of(obj, struct net_bridge_port, kobj)
441 
442 #define br_auto_port(p) ((p)->flags & BR_AUTO_MASK)
443 #define br_promisc_port(p) ((p)->flags & BR_PROMISC)
444 
445 static inline struct net_bridge_port *br_port_get_rcu(const struct net_device *dev)
446 {
447 	return rcu_dereference(dev->rx_handler_data);
448 }
449 
450 static inline struct net_bridge_port *br_port_get_rtnl(const struct net_device *dev)
451 {
452 	return netif_is_bridge_port(dev) ?
453 		rtnl_dereference(dev->rx_handler_data) : NULL;
454 }
455 
456 static inline struct net_bridge_port *br_port_get_rtnl_rcu(const struct net_device *dev)
457 {
458 	return netif_is_bridge_port(dev) ?
459 		rcu_dereference_rtnl(dev->rx_handler_data) : NULL;
460 }
461 
462 enum net_bridge_opts {
463 	BROPT_VLAN_ENABLED,
464 	BROPT_VLAN_STATS_ENABLED,
465 	BROPT_NF_CALL_IPTABLES,
466 	BROPT_NF_CALL_IP6TABLES,
467 	BROPT_NF_CALL_ARPTABLES,
468 	BROPT_GROUP_ADDR_SET,
469 	BROPT_MULTICAST_ENABLED,
470 	BROPT_MULTICAST_QUERY_USE_IFADDR,
471 	BROPT_MULTICAST_STATS_ENABLED,
472 	BROPT_HAS_IPV6_ADDR,
473 	BROPT_NEIGH_SUPPRESS_ENABLED,
474 	BROPT_MTU_SET_BY_USER,
475 	BROPT_VLAN_STATS_PER_PORT,
476 	BROPT_NO_LL_LEARN,
477 	BROPT_VLAN_BRIDGE_BINDING,
478 	BROPT_MCAST_VLAN_SNOOPING_ENABLED,
479 	BROPT_MST_ENABLED,
480 };
481 
482 struct net_bridge {
483 	spinlock_t			lock;
484 	spinlock_t			hash_lock;
485 	struct hlist_head		frame_type_list;
486 	struct net_device		*dev;
487 	unsigned long			options;
488 	/* These fields are accessed on each packet */
489 #ifdef CONFIG_BRIDGE_VLAN_FILTERING
490 	__be16				vlan_proto;
491 	u16				default_pvid;
492 	struct net_bridge_vlan_group	__rcu *vlgrp;
493 #endif
494 
495 	struct rhashtable		fdb_hash_tbl;
496 	struct list_head		port_list;
497 #if IS_ENABLED(CONFIG_BRIDGE_NETFILTER)
498 	union {
499 		struct rtable		fake_rtable;
500 		struct rt6_info		fake_rt6_info;
501 	};
502 #endif
503 	u16				group_fwd_mask;
504 	u16				group_fwd_mask_required;
505 
506 	/* STP */
507 	bridge_id			designated_root;
508 	bridge_id			bridge_id;
509 	unsigned char			topology_change;
510 	unsigned char			topology_change_detected;
511 	u16				root_port;
512 	unsigned long			max_age;
513 	unsigned long			hello_time;
514 	unsigned long			forward_delay;
515 	unsigned long			ageing_time;
516 	unsigned long			bridge_max_age;
517 	unsigned long			bridge_hello_time;
518 	unsigned long			bridge_forward_delay;
519 	unsigned long			bridge_ageing_time;
520 	u32				root_path_cost;
521 
522 	u8				group_addr[ETH_ALEN];
523 
524 	enum {
525 		BR_NO_STP, 		/* no spanning tree */
526 		BR_KERNEL_STP,		/* old STP in kernel */
527 		BR_USER_STP,		/* new RSTP in userspace */
528 	} stp_enabled;
529 
530 	struct net_bridge_mcast		multicast_ctx;
531 
532 #ifdef CONFIG_BRIDGE_IGMP_SNOOPING
533 	struct bridge_mcast_stats	__percpu *mcast_stats;
534 
535 	u32				hash_max;
536 
537 	spinlock_t			multicast_lock;
538 
539 	struct rhashtable		mdb_hash_tbl;
540 	struct rhashtable		sg_port_tbl;
541 
542 	struct hlist_head		mcast_gc_list;
543 	struct hlist_head		mdb_list;
544 
545 	struct work_struct		mcast_gc_work;
546 #endif
547 
548 	struct timer_list		hello_timer;
549 	struct timer_list		tcn_timer;
550 	struct timer_list		topology_change_timer;
551 	struct delayed_work		gc_work;
552 	struct kobject			*ifobj;
553 	u32				auto_cnt;
554 
555 #ifdef CONFIG_NET_SWITCHDEV
556 	/* Counter used to make sure that hardware domains get unique
557 	 * identifiers in case a bridge spans multiple switchdev instances.
558 	 */
559 	int				last_hwdom;
560 	/* Bit mask of hardware domain numbers in use */
561 	unsigned long			busy_hwdoms;
562 #endif
563 	struct hlist_head		fdb_list;
564 
565 #if IS_ENABLED(CONFIG_BRIDGE_MRP)
566 	struct hlist_head		mrp_list;
567 #endif
568 #if IS_ENABLED(CONFIG_BRIDGE_CFM)
569 	struct hlist_head		mep_list;
570 #endif
571 };
572 
573 struct br_input_skb_cb {
574 	struct net_device *brdev;
575 
576 	u16 frag_max_size;
577 #ifdef CONFIG_BRIDGE_IGMP_SNOOPING
578 	u8 igmp;
579 	u8 mrouters_only:1;
580 #endif
581 	u8 proxyarp_replied:1;
582 	u8 src_port_isolated:1;
583 #ifdef CONFIG_BRIDGE_VLAN_FILTERING
584 	u8 vlan_filtered:1;
585 #endif
586 #ifdef CONFIG_NETFILTER_FAMILY_BRIDGE
587 	u8 br_netfilter_broute:1;
588 #endif
589 
590 #ifdef CONFIG_NET_SWITCHDEV
591 	/* Set if TX data plane offloading is used towards at least one
592 	 * hardware domain.
593 	 */
594 	u8 tx_fwd_offload:1;
595 	/* The switchdev hardware domain from which this packet was received.
596 	 * If skb->offload_fwd_mark was set, then this packet was already
597 	 * forwarded by hardware to the other ports in the source hardware
598 	 * domain, otherwise it wasn't.
599 	 */
600 	int src_hwdom;
601 	/* Bit mask of hardware domains towards this packet has already been
602 	 * transmitted using the TX data plane offload.
603 	 */
604 	unsigned long fwd_hwdoms;
605 #endif
606 };
607 
608 #define BR_INPUT_SKB_CB(__skb)	((struct br_input_skb_cb *)(__skb)->cb)
609 
610 #ifdef CONFIG_BRIDGE_IGMP_SNOOPING
611 # define BR_INPUT_SKB_CB_MROUTERS_ONLY(__skb)	(BR_INPUT_SKB_CB(__skb)->mrouters_only)
612 #else
613 # define BR_INPUT_SKB_CB_MROUTERS_ONLY(__skb)	(0)
614 #endif
615 
616 #define br_printk(level, br, format, args...)	\
617 	printk(level "%s: " format, (br)->dev->name, ##args)
618 
619 #define br_err(__br, format, args...)			\
620 	br_printk(KERN_ERR, __br, format, ##args)
621 #define br_warn(__br, format, args...)			\
622 	br_printk(KERN_WARNING, __br, format, ##args)
623 #define br_notice(__br, format, args...)		\
624 	br_printk(KERN_NOTICE, __br, format, ##args)
625 #define br_info(__br, format, args...)			\
626 	br_printk(KERN_INFO, __br, format, ##args)
627 
628 #define br_debug(br, format, args...)			\
629 	pr_debug("%s: " format,  (br)->dev->name, ##args)
630 
631 /* called under bridge lock */
632 static inline int br_is_root_bridge(const struct net_bridge *br)
633 {
634 	return !memcmp(&br->bridge_id, &br->designated_root, 8);
635 }
636 
637 /* check if a VLAN entry is global */
638 static inline bool br_vlan_is_master(const struct net_bridge_vlan *v)
639 {
640 	return v->flags & BRIDGE_VLAN_INFO_MASTER;
641 }
642 
643 /* check if a VLAN entry is used by the bridge */
644 static inline bool br_vlan_is_brentry(const struct net_bridge_vlan *v)
645 {
646 	return v->flags & BRIDGE_VLAN_INFO_BRENTRY;
647 }
648 
649 /* check if we should use the vlan entry, returns false if it's only context */
650 static inline bool br_vlan_should_use(const struct net_bridge_vlan *v)
651 {
652 	if (br_vlan_is_master(v)) {
653 		if (br_vlan_is_brentry(v))
654 			return true;
655 		else
656 			return false;
657 	}
658 
659 	return true;
660 }
661 
662 static inline bool nbp_state_should_learn(const struct net_bridge_port *p)
663 {
664 	return p->state == BR_STATE_LEARNING || p->state == BR_STATE_FORWARDING;
665 }
666 
667 static inline bool br_vlan_valid_id(u16 vid, struct netlink_ext_ack *extack)
668 {
669 	bool ret = vid > 0 && vid < VLAN_VID_MASK;
670 
671 	if (!ret)
672 		NL_SET_ERR_MSG_MOD(extack, "Vlan id is invalid");
673 
674 	return ret;
675 }
676 
677 static inline bool br_vlan_valid_range(const struct bridge_vlan_info *cur,
678 				       const struct bridge_vlan_info *last,
679 				       struct netlink_ext_ack *extack)
680 {
681 	/* pvid flag is not allowed in ranges */
682 	if (cur->flags & BRIDGE_VLAN_INFO_PVID) {
683 		NL_SET_ERR_MSG_MOD(extack, "Pvid isn't allowed in a range");
684 		return false;
685 	}
686 
687 	/* when cur is the range end, check if:
688 	 *  - it has range start flag
689 	 *  - range ids are invalid (end is equal to or before start)
690 	 */
691 	if (last) {
692 		if (cur->flags & BRIDGE_VLAN_INFO_RANGE_BEGIN) {
693 			NL_SET_ERR_MSG_MOD(extack, "Found a new vlan range start while processing one");
694 			return false;
695 		} else if (!(cur->flags & BRIDGE_VLAN_INFO_RANGE_END)) {
696 			NL_SET_ERR_MSG_MOD(extack, "Vlan range end flag is missing");
697 			return false;
698 		} else if (cur->vid <= last->vid) {
699 			NL_SET_ERR_MSG_MOD(extack, "End vlan id is less than or equal to start vlan id");
700 			return false;
701 		}
702 	}
703 
704 	/* check for required range flags */
705 	if (!(cur->flags & (BRIDGE_VLAN_INFO_RANGE_BEGIN |
706 			    BRIDGE_VLAN_INFO_RANGE_END))) {
707 		NL_SET_ERR_MSG_MOD(extack, "Both vlan range flags are missing");
708 		return false;
709 	}
710 
711 	return true;
712 }
713 
714 static inline u8 br_vlan_multicast_router(const struct net_bridge_vlan *v)
715 {
716 	u8 mcast_router = MDB_RTR_TYPE_DISABLED;
717 
718 #ifdef CONFIG_BRIDGE_IGMP_SNOOPING
719 	if (!br_vlan_is_master(v))
720 		mcast_router = v->port_mcast_ctx.multicast_router;
721 	else
722 		mcast_router = v->br_mcast_ctx.multicast_router;
723 #endif
724 
725 	return mcast_router;
726 }
727 
728 static inline int br_afspec_cmd_to_rtm(int cmd)
729 {
730 	switch (cmd) {
731 	case RTM_SETLINK:
732 		return RTM_NEWVLAN;
733 	case RTM_DELLINK:
734 		return RTM_DELVLAN;
735 	}
736 
737 	return 0;
738 }
739 
740 static inline int br_opt_get(const struct net_bridge *br,
741 			     enum net_bridge_opts opt)
742 {
743 	return test_bit(opt, &br->options);
744 }
745 
746 int br_boolopt_toggle(struct net_bridge *br, enum br_boolopt_id opt, bool on,
747 		      struct netlink_ext_ack *extack);
748 int br_boolopt_get(const struct net_bridge *br, enum br_boolopt_id opt);
749 int br_boolopt_multi_toggle(struct net_bridge *br,
750 			    struct br_boolopt_multi *bm,
751 			    struct netlink_ext_ack *extack);
752 void br_boolopt_multi_get(const struct net_bridge *br,
753 			  struct br_boolopt_multi *bm);
754 void br_opt_toggle(struct net_bridge *br, enum net_bridge_opts opt, bool on);
755 
756 /* br_device.c */
757 void br_dev_setup(struct net_device *dev);
758 void br_dev_delete(struct net_device *dev, struct list_head *list);
759 netdev_tx_t br_dev_xmit(struct sk_buff *skb, struct net_device *dev);
760 #ifdef CONFIG_NET_POLL_CONTROLLER
761 static inline void br_netpoll_send_skb(const struct net_bridge_port *p,
762 				       struct sk_buff *skb)
763 {
764 	netpoll_send_skb(p->np, skb);
765 }
766 
767 int br_netpoll_enable(struct net_bridge_port *p);
768 void br_netpoll_disable(struct net_bridge_port *p);
769 #else
770 static inline void br_netpoll_send_skb(const struct net_bridge_port *p,
771 				       struct sk_buff *skb)
772 {
773 }
774 
775 static inline int br_netpoll_enable(struct net_bridge_port *p)
776 {
777 	return 0;
778 }
779 
780 static inline void br_netpoll_disable(struct net_bridge_port *p)
781 {
782 }
783 #endif
784 
785 /* br_fdb.c */
786 #define FDB_FLUSH_IGNORED_NDM_FLAGS (NTF_MASTER | NTF_SELF)
787 #define FDB_FLUSH_ALLOWED_NDM_STATES (NUD_PERMANENT | NUD_NOARP)
788 #define FDB_FLUSH_ALLOWED_NDM_FLAGS (NTF_USE | NTF_EXT_LEARNED | \
789 				     NTF_STICKY | NTF_OFFLOADED)
790 
791 int br_fdb_init(void);
792 void br_fdb_fini(void);
793 int br_fdb_hash_init(struct net_bridge *br);
794 void br_fdb_hash_fini(struct net_bridge *br);
795 void br_fdb_flush(struct net_bridge *br,
796 		  const struct net_bridge_fdb_flush_desc *desc);
797 void br_fdb_find_delete_local(struct net_bridge *br,
798 			      const struct net_bridge_port *p,
799 			      const unsigned char *addr, u16 vid);
800 void br_fdb_changeaddr(struct net_bridge_port *p, const unsigned char *newaddr);
801 void br_fdb_change_mac_address(struct net_bridge *br, const u8 *newaddr);
802 void br_fdb_cleanup(struct work_struct *work);
803 void br_fdb_delete_by_port(struct net_bridge *br,
804 			   const struct net_bridge_port *p, u16 vid, int do_all);
805 struct net_bridge_fdb_entry *br_fdb_find_rcu(struct net_bridge *br,
806 					     const unsigned char *addr,
807 					     __u16 vid);
808 int br_fdb_test_addr(struct net_device *dev, unsigned char *addr);
809 int br_fdb_fillbuf(struct net_bridge *br, void *buf, unsigned long count,
810 		   unsigned long off);
811 int br_fdb_add_local(struct net_bridge *br, struct net_bridge_port *source,
812 		     const unsigned char *addr, u16 vid);
813 void br_fdb_update(struct net_bridge *br, struct net_bridge_port *source,
814 		   const unsigned char *addr, u16 vid, unsigned long flags);
815 
816 int br_fdb_delete(struct ndmsg *ndm, struct nlattr *tb[],
817 		  struct net_device *dev, const unsigned char *addr, u16 vid,
818 		  struct netlink_ext_ack *extack);
819 int br_fdb_delete_bulk(struct ndmsg *ndm, struct nlattr *tb[],
820 		       struct net_device *dev, u16 vid,
821 		       struct netlink_ext_ack *extack);
822 int br_fdb_add(struct ndmsg *nlh, struct nlattr *tb[], struct net_device *dev,
823 	       const unsigned char *addr, u16 vid, u16 nlh_flags,
824 	       struct netlink_ext_ack *extack);
825 int br_fdb_dump(struct sk_buff *skb, struct netlink_callback *cb,
826 		struct net_device *dev, struct net_device *fdev, int *idx);
827 int br_fdb_get(struct sk_buff *skb, struct nlattr *tb[], struct net_device *dev,
828 	       const unsigned char *addr, u16 vid, u32 portid, u32 seq,
829 	       struct netlink_ext_ack *extack);
830 int br_fdb_sync_static(struct net_bridge *br, struct net_bridge_port *p);
831 void br_fdb_unsync_static(struct net_bridge *br, struct net_bridge_port *p);
832 int br_fdb_external_learn_add(struct net_bridge *br, struct net_bridge_port *p,
833 			      const unsigned char *addr, u16 vid,
834 			      bool locked, bool swdev_notify);
835 int br_fdb_external_learn_del(struct net_bridge *br, struct net_bridge_port *p,
836 			      const unsigned char *addr, u16 vid,
837 			      bool swdev_notify);
838 void br_fdb_offloaded_set(struct net_bridge *br, struct net_bridge_port *p,
839 			  const unsigned char *addr, u16 vid, bool offloaded);
840 
841 /* br_forward.c */
842 enum br_pkt_type {
843 	BR_PKT_UNICAST,
844 	BR_PKT_MULTICAST,
845 	BR_PKT_BROADCAST
846 };
847 int br_dev_queue_push_xmit(struct net *net, struct sock *sk, struct sk_buff *skb);
848 void br_forward(const struct net_bridge_port *to, struct sk_buff *skb,
849 		bool local_rcv, bool local_orig);
850 int br_forward_finish(struct net *net, struct sock *sk, struct sk_buff *skb);
851 void br_flood(struct net_bridge *br, struct sk_buff *skb,
852 	      enum br_pkt_type pkt_type, bool local_rcv, bool local_orig,
853 	      u16 vid);
854 
855 /* return true if both source port and dest port are isolated */
856 static inline bool br_skb_isolated(const struct net_bridge_port *to,
857 				   const struct sk_buff *skb)
858 {
859 	return BR_INPUT_SKB_CB(skb)->src_port_isolated &&
860 	       (to->flags & BR_ISOLATED);
861 }
862 
863 /* br_if.c */
864 void br_port_carrier_check(struct net_bridge_port *p, bool *notified);
865 int br_add_bridge(struct net *net, const char *name);
866 int br_del_bridge(struct net *net, const char *name);
867 int br_add_if(struct net_bridge *br, struct net_device *dev,
868 	      struct netlink_ext_ack *extack);
869 int br_del_if(struct net_bridge *br, struct net_device *dev);
870 void br_mtu_auto_adjust(struct net_bridge *br);
871 netdev_features_t br_features_recompute(struct net_bridge *br,
872 					netdev_features_t features);
873 void br_port_flags_change(struct net_bridge_port *port, unsigned long mask);
874 void br_manage_promisc(struct net_bridge *br);
875 int nbp_backup_change(struct net_bridge_port *p, struct net_device *backup_dev);
876 
877 /* br_input.c */
878 int br_handle_frame_finish(struct net *net, struct sock *sk, struct sk_buff *skb);
879 rx_handler_func_t *br_get_rx_handler(const struct net_device *dev);
880 
881 struct br_frame_type {
882 	__be16			type;
883 	int			(*frame_handler)(struct net_bridge_port *port,
884 						 struct sk_buff *skb);
885 	struct hlist_node	list;
886 };
887 
888 void br_add_frame(struct net_bridge *br, struct br_frame_type *ft);
889 void br_del_frame(struct net_bridge *br, struct br_frame_type *ft);
890 
891 static inline bool br_rx_handler_check_rcu(const struct net_device *dev)
892 {
893 	return rcu_dereference(dev->rx_handler) == br_get_rx_handler(dev);
894 }
895 
896 static inline bool br_rx_handler_check_rtnl(const struct net_device *dev)
897 {
898 	return rcu_dereference_rtnl(dev->rx_handler) == br_get_rx_handler(dev);
899 }
900 
901 static inline struct net_bridge_port *br_port_get_check_rcu(const struct net_device *dev)
902 {
903 	return br_rx_handler_check_rcu(dev) ? br_port_get_rcu(dev) : NULL;
904 }
905 
906 static inline struct net_bridge_port *
907 br_port_get_check_rtnl(const struct net_device *dev)
908 {
909 	return br_rx_handler_check_rtnl(dev) ? br_port_get_rtnl_rcu(dev) : NULL;
910 }
911 
912 /* br_ioctl.c */
913 int br_dev_siocdevprivate(struct net_device *dev, struct ifreq *rq,
914 			  void __user *data, int cmd);
915 int br_ioctl_stub(struct net *net, struct net_bridge *br, unsigned int cmd,
916 		  struct ifreq *ifr, void __user *uarg);
917 
918 /* br_multicast.c */
919 #ifdef CONFIG_BRIDGE_IGMP_SNOOPING
920 int br_multicast_rcv(struct net_bridge_mcast **brmctx,
921 		     struct net_bridge_mcast_port **pmctx,
922 		     struct net_bridge_vlan *vlan,
923 		     struct sk_buff *skb, u16 vid);
924 struct net_bridge_mdb_entry *br_mdb_get(struct net_bridge_mcast *brmctx,
925 					struct sk_buff *skb, u16 vid);
926 int br_multicast_add_port(struct net_bridge_port *port);
927 void br_multicast_del_port(struct net_bridge_port *port);
928 void br_multicast_enable_port(struct net_bridge_port *port);
929 void br_multicast_disable_port(struct net_bridge_port *port);
930 void br_multicast_init(struct net_bridge *br);
931 void br_multicast_join_snoopers(struct net_bridge *br);
932 void br_multicast_leave_snoopers(struct net_bridge *br);
933 void br_multicast_open(struct net_bridge *br);
934 void br_multicast_stop(struct net_bridge *br);
935 void br_multicast_dev_del(struct net_bridge *br);
936 void br_multicast_flood(struct net_bridge_mdb_entry *mdst, struct sk_buff *skb,
937 			struct net_bridge_mcast *brmctx,
938 			bool local_rcv, bool local_orig);
939 int br_multicast_set_router(struct net_bridge_mcast *brmctx, unsigned long val);
940 int br_multicast_set_port_router(struct net_bridge_mcast_port *pmctx,
941 				 unsigned long val);
942 int br_multicast_set_vlan_router(struct net_bridge_vlan *v, u8 mcast_router);
943 int br_multicast_toggle(struct net_bridge *br, unsigned long val,
944 			struct netlink_ext_ack *extack);
945 int br_multicast_set_querier(struct net_bridge_mcast *brmctx, unsigned long val);
946 int br_multicast_set_hash_max(struct net_bridge *br, unsigned long val);
947 int br_multicast_set_igmp_version(struct net_bridge_mcast *brmctx,
948 				  unsigned long val);
949 #if IS_ENABLED(CONFIG_IPV6)
950 int br_multicast_set_mld_version(struct net_bridge_mcast *brmctx,
951 				 unsigned long val);
952 #endif
953 struct net_bridge_mdb_entry *
954 br_mdb_ip_get(struct net_bridge *br, struct br_ip *dst);
955 struct net_bridge_mdb_entry *
956 br_multicast_new_group(struct net_bridge *br, struct br_ip *group);
957 struct net_bridge_port_group *
958 br_multicast_new_port_group(struct net_bridge_port *port,
959 			    const struct br_ip *group,
960 			    struct net_bridge_port_group __rcu *next,
961 			    unsigned char flags, const unsigned char *src,
962 			    u8 filter_mode, u8 rt_protocol,
963 			    struct netlink_ext_ack *extack);
964 void br_multicast_del_port_group(struct net_bridge_port_group *p);
965 int br_mdb_hash_init(struct net_bridge *br);
966 void br_mdb_hash_fini(struct net_bridge *br);
967 void br_mdb_notify(struct net_device *dev, struct net_bridge_mdb_entry *mp,
968 		   struct net_bridge_port_group *pg, int type);
969 void br_rtr_notify(struct net_device *dev, struct net_bridge_mcast_port *pmctx,
970 		   int type);
971 void br_multicast_del_pg(struct net_bridge_mdb_entry *mp,
972 			 struct net_bridge_port_group *pg,
973 			 struct net_bridge_port_group __rcu **pp);
974 void br_multicast_count(struct net_bridge *br,
975 			const struct net_bridge_port *p,
976 			const struct sk_buff *skb, u8 type, u8 dir);
977 int br_multicast_init_stats(struct net_bridge *br);
978 void br_multicast_uninit_stats(struct net_bridge *br);
979 void br_multicast_get_stats(const struct net_bridge *br,
980 			    const struct net_bridge_port *p,
981 			    struct br_mcast_stats *dest);
982 u32 br_multicast_ngroups_get(const struct net_bridge_mcast_port *pmctx);
983 void br_multicast_ngroups_set_max(struct net_bridge_mcast_port *pmctx, u32 max);
984 u32 br_multicast_ngroups_get_max(const struct net_bridge_mcast_port *pmctx);
985 int br_mdb_add(struct net_device *dev, struct nlattr *tb[], u16 nlmsg_flags,
986 	       struct netlink_ext_ack *extack);
987 int br_mdb_del(struct net_device *dev, struct nlattr *tb[],
988 	       struct netlink_ext_ack *extack);
989 int br_mdb_dump(struct net_device *dev, struct sk_buff *skb,
990 		struct netlink_callback *cb);
991 void br_multicast_host_join(const struct net_bridge_mcast *brmctx,
992 			    struct net_bridge_mdb_entry *mp, bool notify);
993 void br_multicast_host_leave(struct net_bridge_mdb_entry *mp, bool notify);
994 void br_multicast_star_g_handle_mode(struct net_bridge_port_group *pg,
995 				     u8 filter_mode);
996 void br_multicast_sg_add_exclude_ports(struct net_bridge_mdb_entry *star_mp,
997 				       struct net_bridge_port_group *sg);
998 struct net_bridge_group_src *
999 br_multicast_find_group_src(struct net_bridge_port_group *pg, struct br_ip *ip);
1000 struct net_bridge_group_src *
1001 br_multicast_new_group_src(struct net_bridge_port_group *pg,
1002 			   struct br_ip *src_ip);
1003 void __br_multicast_del_group_src(struct net_bridge_group_src *src);
1004 void br_multicast_del_group_src(struct net_bridge_group_src *src,
1005 				bool fastleave);
1006 void br_multicast_ctx_init(struct net_bridge *br,
1007 			   struct net_bridge_vlan *vlan,
1008 			   struct net_bridge_mcast *brmctx);
1009 void br_multicast_ctx_deinit(struct net_bridge_mcast *brmctx);
1010 void br_multicast_port_ctx_init(struct net_bridge_port *port,
1011 				struct net_bridge_vlan *vlan,
1012 				struct net_bridge_mcast_port *pmctx);
1013 void br_multicast_port_ctx_deinit(struct net_bridge_mcast_port *pmctx);
1014 void br_multicast_toggle_one_vlan(struct net_bridge_vlan *vlan, bool on);
1015 int br_multicast_toggle_vlan_snooping(struct net_bridge *br, bool on,
1016 				      struct netlink_ext_ack *extack);
1017 bool br_multicast_toggle_global_vlan(struct net_bridge_vlan *vlan, bool on);
1018 
1019 int br_rports_fill_info(struct sk_buff *skb,
1020 			const struct net_bridge_mcast *brmctx);
1021 int br_multicast_dump_querier_state(struct sk_buff *skb,
1022 				    const struct net_bridge_mcast *brmctx,
1023 				    int nest_attr);
1024 size_t br_multicast_querier_state_size(void);
1025 size_t br_rports_size(const struct net_bridge_mcast *brmctx);
1026 void br_multicast_set_query_intvl(struct net_bridge_mcast *brmctx,
1027 				  unsigned long val);
1028 void br_multicast_set_startup_query_intvl(struct net_bridge_mcast *brmctx,
1029 					  unsigned long val);
1030 
1031 static inline bool br_group_is_l2(const struct br_ip *group)
1032 {
1033 	return group->proto == 0;
1034 }
1035 
1036 #define mlock_dereference(X, br) \
1037 	rcu_dereference_protected(X, lockdep_is_held(&br->multicast_lock))
1038 
1039 static inline struct hlist_node *
1040 br_multicast_get_first_rport_node(struct net_bridge_mcast *brmctx,
1041 				  struct sk_buff *skb)
1042 {
1043 #if IS_ENABLED(CONFIG_IPV6)
1044 	if (skb->protocol == htons(ETH_P_IPV6))
1045 		return rcu_dereference(hlist_first_rcu(&brmctx->ip6_mc_router_list));
1046 #endif
1047 	return rcu_dereference(hlist_first_rcu(&brmctx->ip4_mc_router_list));
1048 }
1049 
1050 static inline struct net_bridge_port *
1051 br_multicast_rport_from_node_skb(struct hlist_node *rp, struct sk_buff *skb)
1052 {
1053 	struct net_bridge_mcast_port *mctx;
1054 
1055 #if IS_ENABLED(CONFIG_IPV6)
1056 	if (skb->protocol == htons(ETH_P_IPV6))
1057 		mctx = hlist_entry_safe(rp, struct net_bridge_mcast_port,
1058 					ip6_rlist);
1059 	else
1060 #endif
1061 		mctx = hlist_entry_safe(rp, struct net_bridge_mcast_port,
1062 					ip4_rlist);
1063 
1064 	if (mctx)
1065 		return mctx->port;
1066 	else
1067 		return NULL;
1068 }
1069 
1070 static inline bool br_ip4_multicast_is_router(struct net_bridge_mcast *brmctx)
1071 {
1072 	return timer_pending(&brmctx->ip4_mc_router_timer);
1073 }
1074 
1075 static inline bool br_ip6_multicast_is_router(struct net_bridge_mcast *brmctx)
1076 {
1077 #if IS_ENABLED(CONFIG_IPV6)
1078 	return timer_pending(&brmctx->ip6_mc_router_timer);
1079 #else
1080 	return false;
1081 #endif
1082 }
1083 
1084 static inline bool
1085 br_multicast_is_router(struct net_bridge_mcast *brmctx, struct sk_buff *skb)
1086 {
1087 	switch (brmctx->multicast_router) {
1088 	case MDB_RTR_TYPE_PERM:
1089 		return true;
1090 	case MDB_RTR_TYPE_TEMP_QUERY:
1091 		if (skb) {
1092 			if (skb->protocol == htons(ETH_P_IP))
1093 				return br_ip4_multicast_is_router(brmctx);
1094 			else if (skb->protocol == htons(ETH_P_IPV6))
1095 				return br_ip6_multicast_is_router(brmctx);
1096 		} else {
1097 			return br_ip4_multicast_is_router(brmctx) ||
1098 			       br_ip6_multicast_is_router(brmctx);
1099 		}
1100 		fallthrough;
1101 	default:
1102 		return false;
1103 	}
1104 }
1105 
1106 static inline bool
1107 __br_multicast_querier_exists(struct net_bridge_mcast *brmctx,
1108 			      struct bridge_mcast_other_query *querier,
1109 			      const bool is_ipv6)
1110 {
1111 	bool own_querier_enabled;
1112 
1113 	if (brmctx->multicast_querier) {
1114 		if (is_ipv6 && !br_opt_get(brmctx->br, BROPT_HAS_IPV6_ADDR))
1115 			own_querier_enabled = false;
1116 		else
1117 			own_querier_enabled = true;
1118 	} else {
1119 		own_querier_enabled = false;
1120 	}
1121 
1122 	return time_is_before_jiffies(querier->delay_time) &&
1123 	       (own_querier_enabled || timer_pending(&querier->timer));
1124 }
1125 
1126 static inline bool br_multicast_querier_exists(struct net_bridge_mcast *brmctx,
1127 					       struct ethhdr *eth,
1128 					       const struct net_bridge_mdb_entry *mdb)
1129 {
1130 	switch (eth->h_proto) {
1131 	case (htons(ETH_P_IP)):
1132 		return __br_multicast_querier_exists(brmctx,
1133 			&brmctx->ip4_other_query, false);
1134 #if IS_ENABLED(CONFIG_IPV6)
1135 	case (htons(ETH_P_IPV6)):
1136 		return __br_multicast_querier_exists(brmctx,
1137 			&brmctx->ip6_other_query, true);
1138 #endif
1139 	default:
1140 		return !!mdb && br_group_is_l2(&mdb->addr);
1141 	}
1142 }
1143 
1144 static inline bool br_multicast_is_star_g(const struct br_ip *ip)
1145 {
1146 	switch (ip->proto) {
1147 	case htons(ETH_P_IP):
1148 		return ipv4_is_zeronet(ip->src.ip4);
1149 #if IS_ENABLED(CONFIG_IPV6)
1150 	case htons(ETH_P_IPV6):
1151 		return ipv6_addr_any(&ip->src.ip6);
1152 #endif
1153 	default:
1154 		return false;
1155 	}
1156 }
1157 
1158 static inline bool
1159 br_multicast_should_handle_mode(const struct net_bridge_mcast *brmctx,
1160 				__be16 proto)
1161 {
1162 	switch (proto) {
1163 	case htons(ETH_P_IP):
1164 		return !!(brmctx->multicast_igmp_version == 3);
1165 #if IS_ENABLED(CONFIG_IPV6)
1166 	case htons(ETH_P_IPV6):
1167 		return !!(brmctx->multicast_mld_version == 2);
1168 #endif
1169 	default:
1170 		return false;
1171 	}
1172 }
1173 
1174 static inline int br_multicast_igmp_type(const struct sk_buff *skb)
1175 {
1176 	return BR_INPUT_SKB_CB(skb)->igmp;
1177 }
1178 
1179 static inline unsigned long br_multicast_lmqt(const struct net_bridge_mcast *brmctx)
1180 {
1181 	return brmctx->multicast_last_member_interval *
1182 	       brmctx->multicast_last_member_count;
1183 }
1184 
1185 static inline unsigned long br_multicast_gmi(const struct net_bridge_mcast *brmctx)
1186 {
1187 	return brmctx->multicast_membership_interval;
1188 }
1189 
1190 static inline bool
1191 br_multicast_ctx_is_vlan(const struct net_bridge_mcast *brmctx)
1192 {
1193 	return !!brmctx->vlan;
1194 }
1195 
1196 static inline bool
1197 br_multicast_port_ctx_is_vlan(const struct net_bridge_mcast_port *pmctx)
1198 {
1199 	return !!pmctx->vlan;
1200 }
1201 
1202 static inline struct net_bridge_mcast *
1203 br_multicast_port_ctx_get_global(const struct net_bridge_mcast_port *pmctx)
1204 {
1205 	if (!br_multicast_port_ctx_is_vlan(pmctx))
1206 		return &pmctx->port->br->multicast_ctx;
1207 	else
1208 		return &pmctx->vlan->brvlan->br_mcast_ctx;
1209 }
1210 
1211 static inline bool
1212 br_multicast_ctx_vlan_global_disabled(const struct net_bridge_mcast *brmctx)
1213 {
1214 	return br_multicast_ctx_is_vlan(brmctx) &&
1215 	       (!br_opt_get(brmctx->br, BROPT_MCAST_VLAN_SNOOPING_ENABLED) ||
1216 		!(brmctx->vlan->priv_flags & BR_VLFLAG_GLOBAL_MCAST_ENABLED));
1217 }
1218 
1219 static inline bool
1220 br_multicast_ctx_vlan_disabled(const struct net_bridge_mcast *brmctx)
1221 {
1222 	return br_multicast_ctx_is_vlan(brmctx) &&
1223 	       !(brmctx->vlan->priv_flags & BR_VLFLAG_MCAST_ENABLED);
1224 }
1225 
1226 static inline bool
1227 br_multicast_port_ctx_vlan_disabled(const struct net_bridge_mcast_port *pmctx)
1228 {
1229 	return br_multicast_port_ctx_is_vlan(pmctx) &&
1230 	       !(pmctx->vlan->priv_flags & BR_VLFLAG_MCAST_ENABLED);
1231 }
1232 
1233 static inline bool
1234 br_multicast_port_ctx_state_disabled(const struct net_bridge_mcast_port *pmctx)
1235 {
1236 	return pmctx->port->state == BR_STATE_DISABLED ||
1237 	       (br_multicast_port_ctx_is_vlan(pmctx) &&
1238 		(br_multicast_port_ctx_vlan_disabled(pmctx) ||
1239 		 pmctx->vlan->state == BR_STATE_DISABLED));
1240 }
1241 
1242 static inline bool
1243 br_multicast_port_ctx_state_stopped(const struct net_bridge_mcast_port *pmctx)
1244 {
1245 	return br_multicast_port_ctx_state_disabled(pmctx) ||
1246 	       pmctx->port->state == BR_STATE_BLOCKING ||
1247 	       (br_multicast_port_ctx_is_vlan(pmctx) &&
1248 		pmctx->vlan->state == BR_STATE_BLOCKING);
1249 }
1250 
1251 static inline bool
1252 br_rports_have_mc_router(const struct net_bridge_mcast *brmctx)
1253 {
1254 #if IS_ENABLED(CONFIG_IPV6)
1255 	return !hlist_empty(&brmctx->ip4_mc_router_list) ||
1256 	       !hlist_empty(&brmctx->ip6_mc_router_list);
1257 #else
1258 	return !hlist_empty(&brmctx->ip4_mc_router_list);
1259 #endif
1260 }
1261 
1262 static inline bool
1263 br_multicast_ctx_options_equal(const struct net_bridge_mcast *brmctx1,
1264 			       const struct net_bridge_mcast *brmctx2)
1265 {
1266 	return brmctx1->multicast_igmp_version ==
1267 	       brmctx2->multicast_igmp_version &&
1268 	       brmctx1->multicast_last_member_count ==
1269 	       brmctx2->multicast_last_member_count &&
1270 	       brmctx1->multicast_startup_query_count ==
1271 	       brmctx2->multicast_startup_query_count &&
1272 	       brmctx1->multicast_last_member_interval ==
1273 	       brmctx2->multicast_last_member_interval &&
1274 	       brmctx1->multicast_membership_interval ==
1275 	       brmctx2->multicast_membership_interval &&
1276 	       brmctx1->multicast_querier_interval ==
1277 	       brmctx2->multicast_querier_interval &&
1278 	       brmctx1->multicast_query_interval ==
1279 	       brmctx2->multicast_query_interval &&
1280 	       brmctx1->multicast_query_response_interval ==
1281 	       brmctx2->multicast_query_response_interval &&
1282 	       brmctx1->multicast_startup_query_interval ==
1283 	       brmctx2->multicast_startup_query_interval &&
1284 	       brmctx1->multicast_querier == brmctx2->multicast_querier &&
1285 	       brmctx1->multicast_router == brmctx2->multicast_router &&
1286 	       !br_rports_have_mc_router(brmctx1) &&
1287 	       !br_rports_have_mc_router(brmctx2) &&
1288 #if IS_ENABLED(CONFIG_IPV6)
1289 	       brmctx1->multicast_mld_version ==
1290 	       brmctx2->multicast_mld_version &&
1291 #endif
1292 	       true;
1293 }
1294 
1295 static inline bool
1296 br_multicast_ctx_matches_vlan_snooping(const struct net_bridge_mcast *brmctx)
1297 {
1298 	bool vlan_snooping_enabled;
1299 
1300 	vlan_snooping_enabled = !!br_opt_get(brmctx->br,
1301 					     BROPT_MCAST_VLAN_SNOOPING_ENABLED);
1302 
1303 	return !!(vlan_snooping_enabled == br_multicast_ctx_is_vlan(brmctx));
1304 }
1305 #else
1306 static inline int br_multicast_rcv(struct net_bridge_mcast **brmctx,
1307 				   struct net_bridge_mcast_port **pmctx,
1308 				   struct net_bridge_vlan *vlan,
1309 				   struct sk_buff *skb,
1310 				   u16 vid)
1311 {
1312 	return 0;
1313 }
1314 
1315 static inline struct net_bridge_mdb_entry *br_mdb_get(struct net_bridge_mcast *brmctx,
1316 						      struct sk_buff *skb, u16 vid)
1317 {
1318 	return NULL;
1319 }
1320 
1321 static inline int br_multicast_add_port(struct net_bridge_port *port)
1322 {
1323 	return 0;
1324 }
1325 
1326 static inline void br_multicast_del_port(struct net_bridge_port *port)
1327 {
1328 }
1329 
1330 static inline void br_multicast_enable_port(struct net_bridge_port *port)
1331 {
1332 }
1333 
1334 static inline void br_multicast_disable_port(struct net_bridge_port *port)
1335 {
1336 }
1337 
1338 static inline void br_multicast_init(struct net_bridge *br)
1339 {
1340 }
1341 
1342 static inline void br_multicast_join_snoopers(struct net_bridge *br)
1343 {
1344 }
1345 
1346 static inline void br_multicast_leave_snoopers(struct net_bridge *br)
1347 {
1348 }
1349 
1350 static inline void br_multicast_open(struct net_bridge *br)
1351 {
1352 }
1353 
1354 static inline void br_multicast_stop(struct net_bridge *br)
1355 {
1356 }
1357 
1358 static inline void br_multicast_dev_del(struct net_bridge *br)
1359 {
1360 }
1361 
1362 static inline void br_multicast_flood(struct net_bridge_mdb_entry *mdst,
1363 				      struct sk_buff *skb,
1364 				      struct net_bridge_mcast *brmctx,
1365 				      bool local_rcv, bool local_orig)
1366 {
1367 }
1368 
1369 static inline bool br_multicast_is_router(struct net_bridge_mcast *brmctx,
1370 					  struct sk_buff *skb)
1371 {
1372 	return false;
1373 }
1374 
1375 static inline bool br_multicast_querier_exists(struct net_bridge_mcast *brmctx,
1376 					       struct ethhdr *eth,
1377 					       const struct net_bridge_mdb_entry *mdb)
1378 {
1379 	return false;
1380 }
1381 
1382 static inline int br_mdb_add(struct net_device *dev, struct nlattr *tb[],
1383 			     u16 nlmsg_flags, struct netlink_ext_ack *extack)
1384 {
1385 	return -EOPNOTSUPP;
1386 }
1387 
1388 static inline int br_mdb_del(struct net_device *dev, struct nlattr *tb[],
1389 			     struct netlink_ext_ack *extack)
1390 {
1391 	return -EOPNOTSUPP;
1392 }
1393 
1394 static inline int br_mdb_dump(struct net_device *dev, struct sk_buff *skb,
1395 			      struct netlink_callback *cb)
1396 {
1397 	return 0;
1398 }
1399 
1400 static inline int br_mdb_hash_init(struct net_bridge *br)
1401 {
1402 	return 0;
1403 }
1404 
1405 static inline void br_mdb_hash_fini(struct net_bridge *br)
1406 {
1407 }
1408 
1409 static inline void br_multicast_count(struct net_bridge *br,
1410 				      const struct net_bridge_port *p,
1411 				      const struct sk_buff *skb,
1412 				      u8 type, u8 dir)
1413 {
1414 }
1415 
1416 static inline int br_multicast_init_stats(struct net_bridge *br)
1417 {
1418 	return 0;
1419 }
1420 
1421 static inline void br_multicast_uninit_stats(struct net_bridge *br)
1422 {
1423 }
1424 
1425 static inline int br_multicast_igmp_type(const struct sk_buff *skb)
1426 {
1427 	return 0;
1428 }
1429 
1430 static inline void br_multicast_ctx_init(struct net_bridge *br,
1431 					 struct net_bridge_vlan *vlan,
1432 					 struct net_bridge_mcast *brmctx)
1433 {
1434 }
1435 
1436 static inline void br_multicast_ctx_deinit(struct net_bridge_mcast *brmctx)
1437 {
1438 }
1439 
1440 static inline void br_multicast_port_ctx_init(struct net_bridge_port *port,
1441 					      struct net_bridge_vlan *vlan,
1442 					      struct net_bridge_mcast_port *pmctx)
1443 {
1444 }
1445 
1446 static inline void br_multicast_port_ctx_deinit(struct net_bridge_mcast_port *pmctx)
1447 {
1448 }
1449 
1450 static inline void br_multicast_toggle_one_vlan(struct net_bridge_vlan *vlan,
1451 						bool on)
1452 {
1453 }
1454 
1455 static inline int br_multicast_toggle_vlan_snooping(struct net_bridge *br,
1456 						    bool on,
1457 						    struct netlink_ext_ack *extack)
1458 {
1459 	return -EOPNOTSUPP;
1460 }
1461 
1462 static inline bool br_multicast_toggle_global_vlan(struct net_bridge_vlan *vlan,
1463 						   bool on)
1464 {
1465 	return false;
1466 }
1467 
1468 static inline bool
1469 br_multicast_ctx_options_equal(const struct net_bridge_mcast *brmctx1,
1470 			       const struct net_bridge_mcast *brmctx2)
1471 {
1472 	return true;
1473 }
1474 #endif
1475 
1476 /* br_vlan.c */
1477 #ifdef CONFIG_BRIDGE_VLAN_FILTERING
1478 bool br_allowed_ingress(const struct net_bridge *br,
1479 			struct net_bridge_vlan_group *vg, struct sk_buff *skb,
1480 			u16 *vid, u8 *state,
1481 			struct net_bridge_vlan **vlan);
1482 bool br_allowed_egress(struct net_bridge_vlan_group *vg,
1483 		       const struct sk_buff *skb);
1484 bool br_should_learn(struct net_bridge_port *p, struct sk_buff *skb, u16 *vid);
1485 struct sk_buff *br_handle_vlan(struct net_bridge *br,
1486 			       const struct net_bridge_port *port,
1487 			       struct net_bridge_vlan_group *vg,
1488 			       struct sk_buff *skb);
1489 int br_vlan_add(struct net_bridge *br, u16 vid, u16 flags,
1490 		bool *changed, struct netlink_ext_ack *extack);
1491 int br_vlan_delete(struct net_bridge *br, u16 vid);
1492 void br_vlan_flush(struct net_bridge *br);
1493 struct net_bridge_vlan *br_vlan_find(struct net_bridge_vlan_group *vg, u16 vid);
1494 void br_recalculate_fwd_mask(struct net_bridge *br);
1495 int br_vlan_filter_toggle(struct net_bridge *br, unsigned long val,
1496 			  struct netlink_ext_ack *extack);
1497 int __br_vlan_set_proto(struct net_bridge *br, __be16 proto,
1498 			struct netlink_ext_ack *extack);
1499 int br_vlan_set_proto(struct net_bridge *br, unsigned long val,
1500 		      struct netlink_ext_ack *extack);
1501 int br_vlan_set_stats(struct net_bridge *br, unsigned long val);
1502 int br_vlan_set_stats_per_port(struct net_bridge *br, unsigned long val);
1503 int br_vlan_init(struct net_bridge *br);
1504 int br_vlan_set_default_pvid(struct net_bridge *br, unsigned long val,
1505 			     struct netlink_ext_ack *extack);
1506 int __br_vlan_set_default_pvid(struct net_bridge *br, u16 pvid,
1507 			       struct netlink_ext_ack *extack);
1508 int nbp_vlan_add(struct net_bridge_port *port, u16 vid, u16 flags,
1509 		 bool *changed, struct netlink_ext_ack *extack);
1510 int nbp_vlan_delete(struct net_bridge_port *port, u16 vid);
1511 void nbp_vlan_flush(struct net_bridge_port *port);
1512 int nbp_vlan_init(struct net_bridge_port *port, struct netlink_ext_ack *extack);
1513 int nbp_get_num_vlan_infos(struct net_bridge_port *p, u32 filter_mask);
1514 void br_vlan_get_stats(const struct net_bridge_vlan *v,
1515 		       struct pcpu_sw_netstats *stats);
1516 void br_vlan_port_event(struct net_bridge_port *p, unsigned long event);
1517 int br_vlan_bridge_event(struct net_device *dev, unsigned long event,
1518 			 void *ptr);
1519 void br_vlan_rtnl_init(void);
1520 void br_vlan_rtnl_uninit(void);
1521 void br_vlan_notify(const struct net_bridge *br,
1522 		    const struct net_bridge_port *p,
1523 		    u16 vid, u16 vid_range,
1524 		    int cmd);
1525 bool br_vlan_can_enter_range(const struct net_bridge_vlan *v_curr,
1526 			     const struct net_bridge_vlan *range_end);
1527 
1528 void br_vlan_fill_forward_path_pvid(struct net_bridge *br,
1529 				    struct net_device_path_ctx *ctx,
1530 				    struct net_device_path *path);
1531 int br_vlan_fill_forward_path_mode(struct net_bridge *br,
1532 				   struct net_bridge_port *dst,
1533 				   struct net_device_path *path);
1534 
1535 static inline struct net_bridge_vlan_group *br_vlan_group(
1536 					const struct net_bridge *br)
1537 {
1538 	return rtnl_dereference(br->vlgrp);
1539 }
1540 
1541 static inline struct net_bridge_vlan_group *nbp_vlan_group(
1542 					const struct net_bridge_port *p)
1543 {
1544 	return rtnl_dereference(p->vlgrp);
1545 }
1546 
1547 static inline struct net_bridge_vlan_group *br_vlan_group_rcu(
1548 					const struct net_bridge *br)
1549 {
1550 	return rcu_dereference(br->vlgrp);
1551 }
1552 
1553 static inline struct net_bridge_vlan_group *nbp_vlan_group_rcu(
1554 					const struct net_bridge_port *p)
1555 {
1556 	return rcu_dereference(p->vlgrp);
1557 }
1558 
1559 /* Since bridge now depends on 8021Q module, but the time bridge sees the
1560  * skb, the vlan tag will always be present if the frame was tagged.
1561  */
1562 static inline int br_vlan_get_tag(const struct sk_buff *skb, u16 *vid)
1563 {
1564 	int err = 0;
1565 
1566 	if (skb_vlan_tag_present(skb)) {
1567 		*vid = skb_vlan_tag_get_id(skb);
1568 	} else {
1569 		*vid = 0;
1570 		err = -EINVAL;
1571 	}
1572 
1573 	return err;
1574 }
1575 
1576 static inline u16 br_get_pvid(const struct net_bridge_vlan_group *vg)
1577 {
1578 	if (!vg)
1579 		return 0;
1580 
1581 	smp_rmb();
1582 	return vg->pvid;
1583 }
1584 
1585 static inline u16 br_vlan_flags(const struct net_bridge_vlan *v, u16 pvid)
1586 {
1587 	return v->vid == pvid ? v->flags | BRIDGE_VLAN_INFO_PVID : v->flags;
1588 }
1589 #else
1590 static inline bool br_allowed_ingress(const struct net_bridge *br,
1591 				      struct net_bridge_vlan_group *vg,
1592 				      struct sk_buff *skb,
1593 				      u16 *vid, u8 *state,
1594 				      struct net_bridge_vlan **vlan)
1595 
1596 {
1597 	*vlan = NULL;
1598 	return true;
1599 }
1600 
1601 static inline bool br_allowed_egress(struct net_bridge_vlan_group *vg,
1602 				     const struct sk_buff *skb)
1603 {
1604 	return true;
1605 }
1606 
1607 static inline bool br_should_learn(struct net_bridge_port *p,
1608 				   struct sk_buff *skb, u16 *vid)
1609 {
1610 	return true;
1611 }
1612 
1613 static inline struct sk_buff *br_handle_vlan(struct net_bridge *br,
1614 					     const struct net_bridge_port *port,
1615 					     struct net_bridge_vlan_group *vg,
1616 					     struct sk_buff *skb)
1617 {
1618 	return skb;
1619 }
1620 
1621 static inline int br_vlan_add(struct net_bridge *br, u16 vid, u16 flags,
1622 			      bool *changed, struct netlink_ext_ack *extack)
1623 {
1624 	*changed = false;
1625 	return -EOPNOTSUPP;
1626 }
1627 
1628 static inline int br_vlan_delete(struct net_bridge *br, u16 vid)
1629 {
1630 	return -EOPNOTSUPP;
1631 }
1632 
1633 static inline void br_vlan_flush(struct net_bridge *br)
1634 {
1635 }
1636 
1637 static inline void br_recalculate_fwd_mask(struct net_bridge *br)
1638 {
1639 }
1640 
1641 static inline int br_vlan_init(struct net_bridge *br)
1642 {
1643 	return 0;
1644 }
1645 
1646 static inline int nbp_vlan_add(struct net_bridge_port *port, u16 vid, u16 flags,
1647 			       bool *changed, struct netlink_ext_ack *extack)
1648 {
1649 	*changed = false;
1650 	return -EOPNOTSUPP;
1651 }
1652 
1653 static inline int nbp_vlan_delete(struct net_bridge_port *port, u16 vid)
1654 {
1655 	return -EOPNOTSUPP;
1656 }
1657 
1658 static inline void nbp_vlan_flush(struct net_bridge_port *port)
1659 {
1660 }
1661 
1662 static inline struct net_bridge_vlan *br_vlan_find(struct net_bridge_vlan_group *vg,
1663 						   u16 vid)
1664 {
1665 	return NULL;
1666 }
1667 
1668 static inline int nbp_vlan_init(struct net_bridge_port *port,
1669 				struct netlink_ext_ack *extack)
1670 {
1671 	return 0;
1672 }
1673 
1674 static inline u16 br_vlan_get_tag(const struct sk_buff *skb, u16 *tag)
1675 {
1676 	return 0;
1677 }
1678 
1679 static inline u16 br_get_pvid(const struct net_bridge_vlan_group *vg)
1680 {
1681 	return 0;
1682 }
1683 
1684 static inline int br_vlan_filter_toggle(struct net_bridge *br,
1685 					unsigned long val,
1686 					struct netlink_ext_ack *extack)
1687 {
1688 	return -EOPNOTSUPP;
1689 }
1690 
1691 static inline int nbp_get_num_vlan_infos(struct net_bridge_port *p,
1692 					 u32 filter_mask)
1693 {
1694 	return 0;
1695 }
1696 
1697 static inline void br_vlan_fill_forward_path_pvid(struct net_bridge *br,
1698 						  struct net_device_path_ctx *ctx,
1699 						  struct net_device_path *path)
1700 {
1701 }
1702 
1703 static inline int br_vlan_fill_forward_path_mode(struct net_bridge *br,
1704 						 struct net_bridge_port *dst,
1705 						 struct net_device_path *path)
1706 {
1707 	return 0;
1708 }
1709 
1710 static inline struct net_bridge_vlan_group *br_vlan_group(
1711 					const struct net_bridge *br)
1712 {
1713 	return NULL;
1714 }
1715 
1716 static inline struct net_bridge_vlan_group *nbp_vlan_group(
1717 					const struct net_bridge_port *p)
1718 {
1719 	return NULL;
1720 }
1721 
1722 static inline struct net_bridge_vlan_group *br_vlan_group_rcu(
1723 					const struct net_bridge *br)
1724 {
1725 	return NULL;
1726 }
1727 
1728 static inline struct net_bridge_vlan_group *nbp_vlan_group_rcu(
1729 					const struct net_bridge_port *p)
1730 {
1731 	return NULL;
1732 }
1733 
1734 static inline void br_vlan_get_stats(const struct net_bridge_vlan *v,
1735 				     struct pcpu_sw_netstats *stats)
1736 {
1737 }
1738 
1739 static inline void br_vlan_port_event(struct net_bridge_port *p,
1740 				      unsigned long event)
1741 {
1742 }
1743 
1744 static inline int br_vlan_bridge_event(struct net_device *dev,
1745 				       unsigned long event, void *ptr)
1746 {
1747 	return 0;
1748 }
1749 
1750 static inline void br_vlan_rtnl_init(void)
1751 {
1752 }
1753 
1754 static inline void br_vlan_rtnl_uninit(void)
1755 {
1756 }
1757 
1758 static inline void br_vlan_notify(const struct net_bridge *br,
1759 				  const struct net_bridge_port *p,
1760 				  u16 vid, u16 vid_range,
1761 				  int cmd)
1762 {
1763 }
1764 
1765 static inline bool br_vlan_can_enter_range(const struct net_bridge_vlan *v_curr,
1766 					   const struct net_bridge_vlan *range_end)
1767 {
1768 	return true;
1769 }
1770 
1771 static inline u16 br_vlan_flags(const struct net_bridge_vlan *v, u16 pvid)
1772 {
1773 	return 0;
1774 }
1775 
1776 #endif
1777 
1778 /* br_vlan_options.c */
1779 #ifdef CONFIG_BRIDGE_VLAN_FILTERING
1780 bool br_vlan_opts_eq_range(const struct net_bridge_vlan *v_curr,
1781 			   const struct net_bridge_vlan *range_end);
1782 bool br_vlan_opts_fill(struct sk_buff *skb, const struct net_bridge_vlan *v,
1783 		       const struct net_bridge_port *p);
1784 size_t br_vlan_opts_nl_size(void);
1785 int br_vlan_process_options(const struct net_bridge *br,
1786 			    const struct net_bridge_port *p,
1787 			    struct net_bridge_vlan *range_start,
1788 			    struct net_bridge_vlan *range_end,
1789 			    struct nlattr **tb,
1790 			    struct netlink_ext_ack *extack);
1791 int br_vlan_rtm_process_global_options(struct net_device *dev,
1792 				       const struct nlattr *attr,
1793 				       int cmd,
1794 				       struct netlink_ext_ack *extack);
1795 bool br_vlan_global_opts_can_enter_range(const struct net_bridge_vlan *v_curr,
1796 					 const struct net_bridge_vlan *r_end);
1797 bool br_vlan_global_opts_fill(struct sk_buff *skb, u16 vid, u16 vid_range,
1798 			      const struct net_bridge_vlan *v_opts);
1799 
1800 /* vlan state manipulation helpers using *_ONCE to annotate lock-free access */
1801 static inline u8 br_vlan_get_state(const struct net_bridge_vlan *v)
1802 {
1803 	return READ_ONCE(v->state);
1804 }
1805 
1806 static inline void br_vlan_set_state(struct net_bridge_vlan *v, u8 state)
1807 {
1808 	WRITE_ONCE(v->state, state);
1809 }
1810 
1811 static inline u8 br_vlan_get_pvid_state(const struct net_bridge_vlan_group *vg)
1812 {
1813 	return READ_ONCE(vg->pvid_state);
1814 }
1815 
1816 static inline void br_vlan_set_pvid_state(struct net_bridge_vlan_group *vg,
1817 					  u8 state)
1818 {
1819 	WRITE_ONCE(vg->pvid_state, state);
1820 }
1821 
1822 /* learn_allow is true at ingress and false at egress */
1823 static inline bool br_vlan_state_allowed(u8 state, bool learn_allow)
1824 {
1825 	switch (state) {
1826 	case BR_STATE_LEARNING:
1827 		return learn_allow;
1828 	case BR_STATE_FORWARDING:
1829 		return true;
1830 	default:
1831 		return false;
1832 	}
1833 }
1834 #endif
1835 
1836 /* br_mst.c */
1837 #ifdef CONFIG_BRIDGE_VLAN_FILTERING
1838 DECLARE_STATIC_KEY_FALSE(br_mst_used);
1839 static inline bool br_mst_is_enabled(struct net_bridge *br)
1840 {
1841 	return static_branch_unlikely(&br_mst_used) &&
1842 		br_opt_get(br, BROPT_MST_ENABLED);
1843 }
1844 
1845 int br_mst_set_state(struct net_bridge_port *p, u16 msti, u8 state,
1846 		     struct netlink_ext_ack *extack);
1847 int br_mst_vlan_set_msti(struct net_bridge_vlan *v, u16 msti);
1848 void br_mst_vlan_init_state(struct net_bridge_vlan *v);
1849 int br_mst_set_enabled(struct net_bridge *br, bool on,
1850 		       struct netlink_ext_ack *extack);
1851 size_t br_mst_info_size(const struct net_bridge_vlan_group *vg);
1852 int br_mst_fill_info(struct sk_buff *skb,
1853 		     const struct net_bridge_vlan_group *vg);
1854 int br_mst_process(struct net_bridge_port *p, const struct nlattr *mst_attr,
1855 		   struct netlink_ext_ack *extack);
1856 #else
1857 static inline bool br_mst_is_enabled(struct net_bridge *br)
1858 {
1859 	return false;
1860 }
1861 
1862 static inline int br_mst_set_state(struct net_bridge_port *p, u16 msti,
1863 				   u8 state, struct netlink_ext_ack *extack)
1864 {
1865 	return -EOPNOTSUPP;
1866 }
1867 
1868 static inline int br_mst_set_enabled(struct net_bridge *br, bool on,
1869 				     struct netlink_ext_ack *extack)
1870 {
1871 	return -EOPNOTSUPP;
1872 }
1873 
1874 static inline size_t br_mst_info_size(const struct net_bridge_vlan_group *vg)
1875 {
1876 	return 0;
1877 }
1878 
1879 static inline int br_mst_fill_info(struct sk_buff *skb,
1880 				   const struct net_bridge_vlan_group *vg)
1881 {
1882 	return -EOPNOTSUPP;
1883 }
1884 
1885 static inline int br_mst_process(struct net_bridge_port *p,
1886 				 const struct nlattr *mst_attr,
1887 				 struct netlink_ext_ack *extack)
1888 {
1889 	return -EOPNOTSUPP;
1890 }
1891 #endif
1892 
1893 struct nf_br_ops {
1894 	int (*br_dev_xmit_hook)(struct sk_buff *skb);
1895 };
1896 extern const struct nf_br_ops __rcu *nf_br_ops;
1897 
1898 /* br_netfilter.c */
1899 #if IS_ENABLED(CONFIG_BRIDGE_NETFILTER)
1900 int br_nf_core_init(void);
1901 void br_nf_core_fini(void);
1902 void br_netfilter_rtable_init(struct net_bridge *);
1903 #else
1904 static inline int br_nf_core_init(void) { return 0; }
1905 static inline void br_nf_core_fini(void) {}
1906 #define br_netfilter_rtable_init(x)
1907 #endif
1908 
1909 /* br_stp.c */
1910 void br_set_state(struct net_bridge_port *p, unsigned int state);
1911 struct net_bridge_port *br_get_port(struct net_bridge *br, u16 port_no);
1912 void br_init_port(struct net_bridge_port *p);
1913 void br_become_designated_port(struct net_bridge_port *p);
1914 
1915 void __br_set_forward_delay(struct net_bridge *br, unsigned long t);
1916 int br_set_forward_delay(struct net_bridge *br, unsigned long x);
1917 int br_set_hello_time(struct net_bridge *br, unsigned long x);
1918 int br_set_max_age(struct net_bridge *br, unsigned long x);
1919 int __set_ageing_time(struct net_device *dev, unsigned long t);
1920 int br_set_ageing_time(struct net_bridge *br, clock_t ageing_time);
1921 
1922 
1923 /* br_stp_if.c */
1924 void br_stp_enable_bridge(struct net_bridge *br);
1925 void br_stp_disable_bridge(struct net_bridge *br);
1926 int br_stp_set_enabled(struct net_bridge *br, unsigned long val,
1927 		       struct netlink_ext_ack *extack);
1928 void br_stp_enable_port(struct net_bridge_port *p);
1929 void br_stp_disable_port(struct net_bridge_port *p);
1930 bool br_stp_recalculate_bridge_id(struct net_bridge *br);
1931 void br_stp_change_bridge_id(struct net_bridge *br, const unsigned char *a);
1932 void br_stp_set_bridge_priority(struct net_bridge *br, u16 newprio);
1933 int br_stp_set_port_priority(struct net_bridge_port *p, unsigned long newprio);
1934 int br_stp_set_path_cost(struct net_bridge_port *p, unsigned long path_cost);
1935 ssize_t br_show_bridge_id(char *buf, const struct bridge_id *id);
1936 
1937 /* br_stp_bpdu.c */
1938 struct stp_proto;
1939 void br_stp_rcv(const struct stp_proto *proto, struct sk_buff *skb,
1940 		struct net_device *dev);
1941 
1942 /* br_stp_timer.c */
1943 void br_stp_timer_init(struct net_bridge *br);
1944 void br_stp_port_timer_init(struct net_bridge_port *p);
1945 unsigned long br_timer_value(const struct timer_list *timer);
1946 
1947 /* br.c */
1948 #if IS_ENABLED(CONFIG_ATM_LANE)
1949 extern int (*br_fdb_test_addr_hook)(struct net_device *dev, unsigned char *addr);
1950 #endif
1951 
1952 /* br_mrp.c */
1953 #if IS_ENABLED(CONFIG_BRIDGE_MRP)
1954 int br_mrp_parse(struct net_bridge *br, struct net_bridge_port *p,
1955 		 struct nlattr *attr, int cmd, struct netlink_ext_ack *extack);
1956 bool br_mrp_enabled(struct net_bridge *br);
1957 void br_mrp_port_del(struct net_bridge *br, struct net_bridge_port *p);
1958 int br_mrp_fill_info(struct sk_buff *skb, struct net_bridge *br);
1959 #else
1960 static inline int br_mrp_parse(struct net_bridge *br, struct net_bridge_port *p,
1961 			       struct nlattr *attr, int cmd,
1962 			       struct netlink_ext_ack *extack)
1963 {
1964 	return -EOPNOTSUPP;
1965 }
1966 
1967 static inline bool br_mrp_enabled(struct net_bridge *br)
1968 {
1969 	return false;
1970 }
1971 
1972 static inline void br_mrp_port_del(struct net_bridge *br,
1973 				   struct net_bridge_port *p)
1974 {
1975 }
1976 
1977 static inline int br_mrp_fill_info(struct sk_buff *skb, struct net_bridge *br)
1978 {
1979 	return 0;
1980 }
1981 
1982 #endif
1983 
1984 /* br_cfm.c */
1985 #if IS_ENABLED(CONFIG_BRIDGE_CFM)
1986 int br_cfm_parse(struct net_bridge *br, struct net_bridge_port *p,
1987 		 struct nlattr *attr, int cmd, struct netlink_ext_ack *extack);
1988 bool br_cfm_created(struct net_bridge *br);
1989 void br_cfm_port_del(struct net_bridge *br, struct net_bridge_port *p);
1990 int br_cfm_config_fill_info(struct sk_buff *skb, struct net_bridge *br);
1991 int br_cfm_status_fill_info(struct sk_buff *skb,
1992 			    struct net_bridge *br,
1993 			    bool getlink);
1994 int br_cfm_mep_count(struct net_bridge *br, u32 *count);
1995 int br_cfm_peer_mep_count(struct net_bridge *br, u32 *count);
1996 #else
1997 static inline int br_cfm_parse(struct net_bridge *br, struct net_bridge_port *p,
1998 			       struct nlattr *attr, int cmd,
1999 			       struct netlink_ext_ack *extack)
2000 {
2001 	return -EOPNOTSUPP;
2002 }
2003 
2004 static inline bool br_cfm_created(struct net_bridge *br)
2005 {
2006 	return false;
2007 }
2008 
2009 static inline void br_cfm_port_del(struct net_bridge *br,
2010 				   struct net_bridge_port *p)
2011 {
2012 }
2013 
2014 static inline int br_cfm_config_fill_info(struct sk_buff *skb, struct net_bridge *br)
2015 {
2016 	return -EOPNOTSUPP;
2017 }
2018 
2019 static inline int br_cfm_status_fill_info(struct sk_buff *skb,
2020 					  struct net_bridge *br,
2021 					  bool getlink)
2022 {
2023 	return -EOPNOTSUPP;
2024 }
2025 
2026 static inline int br_cfm_mep_count(struct net_bridge *br, u32 *count)
2027 {
2028 	*count = 0;
2029 	return -EOPNOTSUPP;
2030 }
2031 
2032 static inline int br_cfm_peer_mep_count(struct net_bridge *br, u32 *count)
2033 {
2034 	*count = 0;
2035 	return -EOPNOTSUPP;
2036 }
2037 #endif
2038 
2039 /* br_netlink.c */
2040 extern struct rtnl_link_ops br_link_ops;
2041 int br_netlink_init(void);
2042 void br_netlink_fini(void);
2043 void br_ifinfo_notify(int event, const struct net_bridge *br,
2044 		      const struct net_bridge_port *port);
2045 void br_info_notify(int event, const struct net_bridge *br,
2046 		    const struct net_bridge_port *port, u32 filter);
2047 int br_setlink(struct net_device *dev, struct nlmsghdr *nlmsg, u16 flags,
2048 	       struct netlink_ext_ack *extack);
2049 int br_dellink(struct net_device *dev, struct nlmsghdr *nlmsg, u16 flags);
2050 int br_getlink(struct sk_buff *skb, u32 pid, u32 seq, struct net_device *dev,
2051 	       u32 filter_mask, int nlflags);
2052 int br_process_vlan_info(struct net_bridge *br,
2053 			 struct net_bridge_port *p, int cmd,
2054 			 struct bridge_vlan_info *vinfo_curr,
2055 			 struct bridge_vlan_info **vinfo_last,
2056 			 bool *changed,
2057 			 struct netlink_ext_ack *extack);
2058 
2059 #ifdef CONFIG_SYSFS
2060 /* br_sysfs_if.c */
2061 extern const struct sysfs_ops brport_sysfs_ops;
2062 int br_sysfs_addif(struct net_bridge_port *p);
2063 int br_sysfs_renameif(struct net_bridge_port *p);
2064 
2065 /* br_sysfs_br.c */
2066 int br_sysfs_addbr(struct net_device *dev);
2067 void br_sysfs_delbr(struct net_device *dev);
2068 
2069 #else
2070 
2071 static inline int br_sysfs_addif(struct net_bridge_port *p) { return 0; }
2072 static inline int br_sysfs_renameif(struct net_bridge_port *p) { return 0; }
2073 static inline int br_sysfs_addbr(struct net_device *dev) { return 0; }
2074 static inline void br_sysfs_delbr(struct net_device *dev) { return; }
2075 #endif /* CONFIG_SYSFS */
2076 
2077 /* br_switchdev.c */
2078 #ifdef CONFIG_NET_SWITCHDEV
2079 int br_switchdev_port_offload(struct net_bridge_port *p,
2080 			      struct net_device *dev, const void *ctx,
2081 			      struct notifier_block *atomic_nb,
2082 			      struct notifier_block *blocking_nb,
2083 			      bool tx_fwd_offload,
2084 			      struct netlink_ext_ack *extack);
2085 
2086 void br_switchdev_port_unoffload(struct net_bridge_port *p, const void *ctx,
2087 				 struct notifier_block *atomic_nb,
2088 				 struct notifier_block *blocking_nb);
2089 
2090 bool br_switchdev_frame_uses_tx_fwd_offload(struct sk_buff *skb);
2091 
2092 void br_switchdev_frame_set_offload_fwd_mark(struct sk_buff *skb);
2093 
2094 void nbp_switchdev_frame_mark_tx_fwd_offload(const struct net_bridge_port *p,
2095 					     struct sk_buff *skb);
2096 void nbp_switchdev_frame_mark_tx_fwd_to_hwdom(const struct net_bridge_port *p,
2097 					      struct sk_buff *skb);
2098 void nbp_switchdev_frame_mark(const struct net_bridge_port *p,
2099 			      struct sk_buff *skb);
2100 bool nbp_switchdev_allowed_egress(const struct net_bridge_port *p,
2101 				  const struct sk_buff *skb);
2102 int br_switchdev_set_port_flag(struct net_bridge_port *p,
2103 			       unsigned long flags,
2104 			       unsigned long mask,
2105 			       struct netlink_ext_ack *extack);
2106 void br_switchdev_fdb_notify(struct net_bridge *br,
2107 			     const struct net_bridge_fdb_entry *fdb, int type);
2108 void br_switchdev_mdb_notify(struct net_device *dev,
2109 			     struct net_bridge_mdb_entry *mp,
2110 			     struct net_bridge_port_group *pg,
2111 			     int type);
2112 int br_switchdev_port_vlan_add(struct net_device *dev, u16 vid, u16 flags,
2113 			       bool changed, struct netlink_ext_ack *extack);
2114 int br_switchdev_port_vlan_del(struct net_device *dev, u16 vid);
2115 void br_switchdev_init(struct net_bridge *br);
2116 
2117 static inline void br_switchdev_frame_unmark(struct sk_buff *skb)
2118 {
2119 	skb->offload_fwd_mark = 0;
2120 }
2121 #else
2122 static inline int
2123 br_switchdev_port_offload(struct net_bridge_port *p,
2124 			  struct net_device *dev, const void *ctx,
2125 			  struct notifier_block *atomic_nb,
2126 			  struct notifier_block *blocking_nb,
2127 			  bool tx_fwd_offload,
2128 			  struct netlink_ext_ack *extack)
2129 {
2130 	return -EOPNOTSUPP;
2131 }
2132 
2133 static inline void
2134 br_switchdev_port_unoffload(struct net_bridge_port *p, const void *ctx,
2135 			    struct notifier_block *atomic_nb,
2136 			    struct notifier_block *blocking_nb)
2137 {
2138 }
2139 
2140 static inline bool br_switchdev_frame_uses_tx_fwd_offload(struct sk_buff *skb)
2141 {
2142 	return false;
2143 }
2144 
2145 static inline void br_switchdev_frame_set_offload_fwd_mark(struct sk_buff *skb)
2146 {
2147 }
2148 
2149 static inline void
2150 nbp_switchdev_frame_mark_tx_fwd_offload(const struct net_bridge_port *p,
2151 					struct sk_buff *skb)
2152 {
2153 }
2154 
2155 static inline void
2156 nbp_switchdev_frame_mark_tx_fwd_to_hwdom(const struct net_bridge_port *p,
2157 					 struct sk_buff *skb)
2158 {
2159 }
2160 
2161 static inline void nbp_switchdev_frame_mark(const struct net_bridge_port *p,
2162 					    struct sk_buff *skb)
2163 {
2164 }
2165 
2166 static inline bool nbp_switchdev_allowed_egress(const struct net_bridge_port *p,
2167 						const struct sk_buff *skb)
2168 {
2169 	return true;
2170 }
2171 
2172 static inline int br_switchdev_set_port_flag(struct net_bridge_port *p,
2173 					     unsigned long flags,
2174 					     unsigned long mask,
2175 					     struct netlink_ext_ack *extack)
2176 {
2177 	return 0;
2178 }
2179 
2180 static inline int br_switchdev_port_vlan_add(struct net_device *dev, u16 vid,
2181 					     u16 flags, bool changed,
2182 					     struct netlink_ext_ack *extack)
2183 {
2184 	return -EOPNOTSUPP;
2185 }
2186 
2187 static inline int br_switchdev_port_vlan_del(struct net_device *dev, u16 vid)
2188 {
2189 	return -EOPNOTSUPP;
2190 }
2191 
2192 static inline void
2193 br_switchdev_fdb_notify(struct net_bridge *br,
2194 			const struct net_bridge_fdb_entry *fdb, int type)
2195 {
2196 }
2197 
2198 static inline void br_switchdev_mdb_notify(struct net_device *dev,
2199 					   struct net_bridge_mdb_entry *mp,
2200 					   struct net_bridge_port_group *pg,
2201 					   int type)
2202 {
2203 }
2204 
2205 static inline void br_switchdev_frame_unmark(struct sk_buff *skb)
2206 {
2207 }
2208 
2209 static inline void br_switchdev_init(struct net_bridge *br)
2210 {
2211 }
2212 
2213 #endif /* CONFIG_NET_SWITCHDEV */
2214 
2215 /* br_arp_nd_proxy.c */
2216 void br_recalculate_neigh_suppress_enabled(struct net_bridge *br);
2217 void br_do_proxy_suppress_arp(struct sk_buff *skb, struct net_bridge *br,
2218 			      u16 vid, struct net_bridge_port *p);
2219 void br_do_suppress_nd(struct sk_buff *skb, struct net_bridge *br,
2220 		       u16 vid, struct net_bridge_port *p, struct nd_msg *msg);
2221 struct nd_msg *br_is_nd_neigh_msg(struct sk_buff *skb, struct nd_msg *m);
2222 #endif
2223