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
32#define BR_VERSION	"2.3"
33
34/* Control of forwarding link local multicast */
35#define BR_GROUPFWD_DEFAULT	0
36/* Don't allow forwarding of control protocols like STP, MAC PAUSE and LACP */
37enum {
38	BR_GROUPFWD_STP		= BIT(0),
39	BR_GROUPFWD_MACPAUSE	= BIT(1),
40	BR_GROUPFWD_LACP	= BIT(2),
41};
42
43#define BR_GROUPFWD_RESTRICTED (BR_GROUPFWD_STP | BR_GROUPFWD_MACPAUSE | \
44				BR_GROUPFWD_LACP)
45/* The Nearest Customer Bridge Group Address, 01-80-C2-00-00-[00,0B,0C,0D,0F] */
46#define BR_GROUPFWD_8021AD	0xB801u
47
48/* Path to usermode spanning tree program */
49#define BR_STP_PROG	"/sbin/bridge-stp"
50
51#define BR_FDB_NOTIFY_SETTABLE_BITS (FDB_NOTIFY_BIT | FDB_NOTIFY_INACTIVE_BIT)
52
53typedef struct bridge_id bridge_id;
54typedef struct mac_addr mac_addr;
55typedef __u16 port_id;
56
57struct bridge_id {
58	unsigned char	prio[2];
59	unsigned char	addr[ETH_ALEN];
60};
61
62struct mac_addr {
63	unsigned char	addr[ETH_ALEN];
64};
65
66#ifdef CONFIG_BRIDGE_IGMP_SNOOPING
67/* our own querier */
68struct bridge_mcast_own_query {
69	struct timer_list	timer;
70	u32			startup_sent;
71};
72
73/* other querier */
74struct bridge_mcast_other_query {
75	struct timer_list		timer;
76	unsigned long			delay_time;
77};
78
79/* selected querier */
80struct bridge_mcast_querier {
81	struct br_ip addr;
82	struct net_bridge_port __rcu	*port;
83};
84
85/* IGMP/MLD statistics */
86struct bridge_mcast_stats {
87	struct br_mcast_stats mstats;
88	struct u64_stats_sync syncp;
89};
90#endif
91
92struct br_vlan_stats {
93	u64 rx_bytes;
94	u64 rx_packets;
95	u64 tx_bytes;
96	u64 tx_packets;
97	struct u64_stats_sync syncp;
98};
99
100struct br_tunnel_info {
101	__be64				tunnel_id;
102	struct metadata_dst __rcu	*tunnel_dst;
103};
104
105/* private vlan flags */
106enum {
107	BR_VLFLAG_PER_PORT_STATS = BIT(0),
108	BR_VLFLAG_ADDED_BY_SWITCHDEV = BIT(1),
109};
110
111/**
112 * struct net_bridge_vlan - per-vlan entry
113 *
114 * @vnode: rhashtable member
115 * @vid: VLAN id
116 * @flags: bridge vlan flags
117 * @priv_flags: private (in-kernel) bridge vlan flags
118 * @state: STP state (e.g. blocking, learning, forwarding)
119 * @stats: per-cpu VLAN statistics
120 * @br: if MASTER flag set, this points to a bridge struct
121 * @port: if MASTER flag unset, this points to a port struct
122 * @refcnt: if MASTER flag set, this is bumped for each port referencing it
123 * @brvlan: if MASTER flag unset, this points to the global per-VLAN context
124 *          for this VLAN entry
125 * @vlist: sorted list of VLAN entries
126 * @rcu: used for entry destruction
127 *
128 * This structure is shared between the global per-VLAN entries contained in
129 * the bridge rhashtable and the local per-port per-VLAN entries contained in
130 * the port's rhashtable. The union entries should be interpreted depending on
131 * the entry flags that are set.
132 */
133struct net_bridge_vlan {
134	struct rhash_head		vnode;
135	struct rhash_head		tnode;
136	u16				vid;
137	u16				flags;
138	u16				priv_flags;
139	u8				state;
140	struct br_vlan_stats __percpu	*stats;
141	union {
142		struct net_bridge	*br;
143		struct net_bridge_port	*port;
144	};
145	union {
146		refcount_t		refcnt;
147		struct net_bridge_vlan	*brvlan;
148	};
149
150	struct br_tunnel_info		tinfo;
151
152	struct list_head		vlist;
153
154	struct rcu_head			rcu;
155};
156
157/**
158 * struct net_bridge_vlan_group
159 *
160 * @vlan_hash: VLAN entry rhashtable
161 * @vlan_list: sorted VLAN entry list
162 * @num_vlans: number of total VLAN entries
163 * @pvid: PVID VLAN id
164 * @pvid_state: PVID's STP state (e.g. forwarding, learning, blocking)
165 *
166 * IMPORTANT: Be careful when checking if there're VLAN entries using list
167 *            primitives because the bridge can have entries in its list which
168 *            are just for global context but not for filtering, i.e. they have
169 *            the master flag set but not the brentry flag. If you have to check
170 *            if there're "real" entries in the bridge please test @num_vlans
171 */
172struct net_bridge_vlan_group {
173	struct rhashtable		vlan_hash;
174	struct rhashtable		tunnel_hash;
175	struct list_head		vlan_list;
176	u16				num_vlans;
177	u16				pvid;
178	u8				pvid_state;
179};
180
181/* bridge fdb flags */
182enum {
183	BR_FDB_LOCAL,
184	BR_FDB_STATIC,
185	BR_FDB_STICKY,
186	BR_FDB_ADDED_BY_USER,
187	BR_FDB_ADDED_BY_EXT_LEARN,
188	BR_FDB_OFFLOADED,
189	BR_FDB_NOTIFY,
190	BR_FDB_NOTIFY_INACTIVE
191};
192
193struct net_bridge_fdb_key {
194	mac_addr addr;
195	u16 vlan_id;
196};
197
198struct net_bridge_fdb_entry {
199	struct rhash_head		rhnode;
200	struct net_bridge_port		*dst;
201
202	struct net_bridge_fdb_key	key;
203	struct hlist_node		fdb_node;
204	unsigned long			flags;
205
206	/* write-heavy members should not affect lookups */
207	unsigned long			updated ____cacheline_aligned_in_smp;
208	unsigned long			used;
209
210	struct rcu_head			rcu;
211};
212
213#define MDB_PG_FLAGS_PERMANENT	BIT(0)
214#define MDB_PG_FLAGS_OFFLOAD	BIT(1)
215#define MDB_PG_FLAGS_FAST_LEAVE	BIT(2)
216#define MDB_PG_FLAGS_STAR_EXCL	BIT(3)
217#define MDB_PG_FLAGS_BLOCKED	BIT(4)
218
219#define PG_SRC_ENT_LIMIT	32
220
221#define BR_SGRP_F_DELETE	BIT(0)
222#define BR_SGRP_F_SEND		BIT(1)
223#define BR_SGRP_F_INSTALLED	BIT(2)
224
225struct net_bridge_mcast_gc {
226	struct hlist_node		gc_node;
227	void				(*destroy)(struct net_bridge_mcast_gc *gc);
228};
229
230struct net_bridge_group_src {
231	struct hlist_node		node;
232
233	struct br_ip			addr;
234	struct net_bridge_port_group	*pg;
235	u8				flags;
236	u8				src_query_rexmit_cnt;
237	struct timer_list		timer;
238
239	struct net_bridge		*br;
240	struct net_bridge_mcast_gc	mcast_gc;
241	struct rcu_head			rcu;
242};
243
244struct net_bridge_port_group_sg_key {
245	struct net_bridge_port		*port;
246	struct br_ip			addr;
247};
248
249struct net_bridge_port_group {
250	struct net_bridge_port_group __rcu *next;
251	struct net_bridge_port_group_sg_key key;
252	unsigned char			eth_addr[ETH_ALEN] __aligned(2);
253	unsigned char			flags;
254	unsigned char			filter_mode;
255	unsigned char			grp_query_rexmit_cnt;
256	unsigned char			rt_protocol;
257
258	struct hlist_head		src_list;
259	unsigned int			src_ents;
260	struct timer_list		timer;
261	struct timer_list		rexmit_timer;
262	struct hlist_node		mglist;
263
264	struct rhash_head		rhnode;
265	struct net_bridge_mcast_gc	mcast_gc;
266	struct rcu_head			rcu;
267};
268
269struct net_bridge_mdb_entry {
270	struct rhash_head		rhnode;
271	struct net_bridge		*br;
272	struct net_bridge_port_group __rcu *ports;
273	struct br_ip			addr;
274	bool				host_joined;
275
276	struct timer_list		timer;
277	struct hlist_node		mdb_node;
278
279	struct net_bridge_mcast_gc	mcast_gc;
280	struct rcu_head			rcu;
281};
282
283struct net_bridge_port {
284	struct net_bridge		*br;
285	struct net_device		*dev;
286	struct list_head		list;
287
288	unsigned long			flags;
289#ifdef CONFIG_BRIDGE_VLAN_FILTERING
290	struct net_bridge_vlan_group	__rcu *vlgrp;
291#endif
292	struct net_bridge_port		__rcu *backup_port;
293
294	/* STP */
295	u8				priority;
296	u8				state;
297	u16				port_no;
298	unsigned char			topology_change_ack;
299	unsigned char			config_pending;
300	port_id				port_id;
301	port_id				designated_port;
302	bridge_id			designated_root;
303	bridge_id			designated_bridge;
304	u32				path_cost;
305	u32				designated_cost;
306	unsigned long			designated_age;
307
308	struct timer_list		forward_delay_timer;
309	struct timer_list		hold_timer;
310	struct timer_list		message_age_timer;
311	struct kobject			kobj;
312	struct rcu_head			rcu;
313
314#ifdef CONFIG_BRIDGE_IGMP_SNOOPING
315	struct bridge_mcast_own_query	ip4_own_query;
316#if IS_ENABLED(CONFIG_IPV6)
317	struct bridge_mcast_own_query	ip6_own_query;
318#endif /* IS_ENABLED(CONFIG_IPV6) */
319	unsigned char			multicast_router;
320	struct bridge_mcast_stats	__percpu *mcast_stats;
321	struct timer_list		multicast_router_timer;
322	struct hlist_head		mglist;
323	struct hlist_node		rlist;
324#endif
325
326#ifdef CONFIG_SYSFS
327	char				sysfs_name[IFNAMSIZ];
328#endif
329
330#ifdef CONFIG_NET_POLL_CONTROLLER
331	struct netpoll			*np;
332#endif
333#ifdef CONFIG_NET_SWITCHDEV
334	int				offload_fwd_mark;
335#endif
336	u16				group_fwd_mask;
337	u16				backup_redirected_cnt;
338
339	struct bridge_stp_xstats	stp_xstats;
340};
341
342#define kobj_to_brport(obj)	container_of(obj, struct net_bridge_port, kobj)
343
344#define br_auto_port(p) ((p)->flags & BR_AUTO_MASK)
345#define br_promisc_port(p) ((p)->flags & BR_PROMISC)
346
347static inline struct net_bridge_port *br_port_get_rcu(const struct net_device *dev)
348{
349	return rcu_dereference(dev->rx_handler_data);
350}
351
352static inline struct net_bridge_port *br_port_get_rtnl(const struct net_device *dev)
353{
354	return netif_is_bridge_port(dev) ?
355		rtnl_dereference(dev->rx_handler_data) : NULL;
356}
357
358static inline struct net_bridge_port *br_port_get_rtnl_rcu(const struct net_device *dev)
359{
360	return netif_is_bridge_port(dev) ?
361		rcu_dereference_rtnl(dev->rx_handler_data) : NULL;
362}
363
364enum net_bridge_opts {
365	BROPT_VLAN_ENABLED,
366	BROPT_VLAN_STATS_ENABLED,
367	BROPT_NF_CALL_IPTABLES,
368	BROPT_NF_CALL_IP6TABLES,
369	BROPT_NF_CALL_ARPTABLES,
370	BROPT_GROUP_ADDR_SET,
371	BROPT_MULTICAST_ENABLED,
372	BROPT_MULTICAST_QUERIER,
373	BROPT_MULTICAST_QUERY_USE_IFADDR,
374	BROPT_MULTICAST_STATS_ENABLED,
375	BROPT_HAS_IPV6_ADDR,
376	BROPT_NEIGH_SUPPRESS_ENABLED,
377	BROPT_MTU_SET_BY_USER,
378	BROPT_VLAN_STATS_PER_PORT,
379	BROPT_NO_LL_LEARN,
380	BROPT_VLAN_BRIDGE_BINDING,
381};
382
383struct net_bridge {
384	spinlock_t			lock;
385	spinlock_t			hash_lock;
386	struct list_head		port_list;
387	struct net_device		*dev;
388	struct pcpu_sw_netstats		__percpu *stats;
389	unsigned long			options;
390	/* These fields are accessed on each packet */
391#ifdef CONFIG_BRIDGE_VLAN_FILTERING
392	__be16				vlan_proto;
393	u16				default_pvid;
394	struct net_bridge_vlan_group	__rcu *vlgrp;
395#endif
396
397	struct rhashtable		fdb_hash_tbl;
398#if IS_ENABLED(CONFIG_BRIDGE_NETFILTER)
399	union {
400		struct rtable		fake_rtable;
401		struct rt6_info		fake_rt6_info;
402	};
403#endif
404	u16				group_fwd_mask;
405	u16				group_fwd_mask_required;
406
407	/* STP */
408	bridge_id			designated_root;
409	bridge_id			bridge_id;
410	unsigned char			topology_change;
411	unsigned char			topology_change_detected;
412	u16				root_port;
413	unsigned long			max_age;
414	unsigned long			hello_time;
415	unsigned long			forward_delay;
416	unsigned long			ageing_time;
417	unsigned long			bridge_max_age;
418	unsigned long			bridge_hello_time;
419	unsigned long			bridge_forward_delay;
420	unsigned long			bridge_ageing_time;
421	u32				root_path_cost;
422
423	u8				group_addr[ETH_ALEN];
424
425	enum {
426		BR_NO_STP, 		/* no spanning tree */
427		BR_KERNEL_STP,		/* old STP in kernel */
428		BR_USER_STP,		/* new RSTP in userspace */
429	} stp_enabled;
430
431#ifdef CONFIG_BRIDGE_IGMP_SNOOPING
432
433	u32				hash_max;
434
435	u32				multicast_last_member_count;
436	u32				multicast_startup_query_count;
437
438	u8				multicast_igmp_version;
439	u8				multicast_router;
440#if IS_ENABLED(CONFIG_IPV6)
441	u8				multicast_mld_version;
442#endif
443	spinlock_t			multicast_lock;
444	unsigned long			multicast_last_member_interval;
445	unsigned long			multicast_membership_interval;
446	unsigned long			multicast_querier_interval;
447	unsigned long			multicast_query_interval;
448	unsigned long			multicast_query_response_interval;
449	unsigned long			multicast_startup_query_interval;
450
451	struct rhashtable		mdb_hash_tbl;
452	struct rhashtable		sg_port_tbl;
453
454	struct hlist_head		mcast_gc_list;
455	struct hlist_head		mdb_list;
456	struct hlist_head		router_list;
457
458	struct timer_list		multicast_router_timer;
459	struct bridge_mcast_other_query	ip4_other_query;
460	struct bridge_mcast_own_query	ip4_own_query;
461	struct bridge_mcast_querier	ip4_querier;
462	struct bridge_mcast_stats	__percpu *mcast_stats;
463#if IS_ENABLED(CONFIG_IPV6)
464	struct bridge_mcast_other_query	ip6_other_query;
465	struct bridge_mcast_own_query	ip6_own_query;
466	struct bridge_mcast_querier	ip6_querier;
467#endif /* IS_ENABLED(CONFIG_IPV6) */
468	struct work_struct		mcast_gc_work;
469#endif
470
471	struct timer_list		hello_timer;
472	struct timer_list		tcn_timer;
473	struct timer_list		topology_change_timer;
474	struct delayed_work		gc_work;
475	struct kobject			*ifobj;
476	u32				auto_cnt;
477
478#ifdef CONFIG_NET_SWITCHDEV
479	int offload_fwd_mark;
480#endif
481	struct hlist_head		fdb_list;
482
483#if IS_ENABLED(CONFIG_BRIDGE_MRP)
484	struct list_head		mrp_list;
485#endif
486};
487
488struct br_input_skb_cb {
489	struct net_device *brdev;
490
491	u16 frag_max_size;
492#ifdef CONFIG_BRIDGE_IGMP_SNOOPING
493	u8 igmp;
494	u8 mrouters_only:1;
495#endif
496	u8 proxyarp_replied:1;
497	u8 src_port_isolated:1;
498#ifdef CONFIG_BRIDGE_VLAN_FILTERING
499	u8 vlan_filtered:1;
500#endif
501#ifdef CONFIG_NETFILTER_FAMILY_BRIDGE
502	u8 br_netfilter_broute:1;
503#endif
504
505#ifdef CONFIG_NET_SWITCHDEV
506	int offload_fwd_mark;
507#endif
508};
509
510#define BR_INPUT_SKB_CB(__skb)	((struct br_input_skb_cb *)(__skb)->cb)
511
512#ifdef CONFIG_BRIDGE_IGMP_SNOOPING
513# define BR_INPUT_SKB_CB_MROUTERS_ONLY(__skb)	(BR_INPUT_SKB_CB(__skb)->mrouters_only)
514#else
515# define BR_INPUT_SKB_CB_MROUTERS_ONLY(__skb)	(0)
516#endif
517
518#define br_printk(level, br, format, args...)	\
519	printk(level "%s: " format, (br)->dev->name, ##args)
520
521#define br_err(__br, format, args...)			\
522	br_printk(KERN_ERR, __br, format, ##args)
523#define br_warn(__br, format, args...)			\
524	br_printk(KERN_WARNING, __br, format, ##args)
525#define br_notice(__br, format, args...)		\
526	br_printk(KERN_NOTICE, __br, format, ##args)
527#define br_info(__br, format, args...)			\
528	br_printk(KERN_INFO, __br, format, ##args)
529
530#define br_debug(br, format, args...)			\
531	pr_debug("%s: " format,  (br)->dev->name, ##args)
532
533/* called under bridge lock */
534static inline int br_is_root_bridge(const struct net_bridge *br)
535{
536	return !memcmp(&br->bridge_id, &br->designated_root, 8);
537}
538
539/* check if a VLAN entry is global */
540static inline bool br_vlan_is_master(const struct net_bridge_vlan *v)
541{
542	return v->flags & BRIDGE_VLAN_INFO_MASTER;
543}
544
545/* check if a VLAN entry is used by the bridge */
546static inline bool br_vlan_is_brentry(const struct net_bridge_vlan *v)
547{
548	return v->flags & BRIDGE_VLAN_INFO_BRENTRY;
549}
550
551/* check if we should use the vlan entry, returns false if it's only context */
552static inline bool br_vlan_should_use(const struct net_bridge_vlan *v)
553{
554	if (br_vlan_is_master(v)) {
555		if (br_vlan_is_brentry(v))
556			return true;
557		else
558			return false;
559	}
560
561	return true;
562}
563
564static inline bool nbp_state_should_learn(const struct net_bridge_port *p)
565{
566	return p->state == BR_STATE_LEARNING || p->state == BR_STATE_FORWARDING;
567}
568
569static inline bool br_vlan_valid_id(u16 vid, struct netlink_ext_ack *extack)
570{
571	bool ret = vid > 0 && vid < VLAN_VID_MASK;
572
573	if (!ret)
574		NL_SET_ERR_MSG_MOD(extack, "Vlan id is invalid");
575
576	return ret;
577}
578
579static inline bool br_vlan_valid_range(const struct bridge_vlan_info *cur,
580				       const struct bridge_vlan_info *last,
581				       struct netlink_ext_ack *extack)
582{
583	/* pvid flag is not allowed in ranges */
584	if (cur->flags & BRIDGE_VLAN_INFO_PVID) {
585		NL_SET_ERR_MSG_MOD(extack, "Pvid isn't allowed in a range");
586		return false;
587	}
588
589	/* when cur is the range end, check if:
590	 *  - it has range start flag
591	 *  - range ids are invalid (end is equal to or before start)
592	 */
593	if (last) {
594		if (cur->flags & BRIDGE_VLAN_INFO_RANGE_BEGIN) {
595			NL_SET_ERR_MSG_MOD(extack, "Found a new vlan range start while processing one");
596			return false;
597		} else if (!(cur->flags & BRIDGE_VLAN_INFO_RANGE_END)) {
598			NL_SET_ERR_MSG_MOD(extack, "Vlan range end flag is missing");
599			return false;
600		} else if (cur->vid <= last->vid) {
601			NL_SET_ERR_MSG_MOD(extack, "End vlan id is less than or equal to start vlan id");
602			return false;
603		}
604	}
605
606	/* check for required range flags */
607	if (!(cur->flags & (BRIDGE_VLAN_INFO_RANGE_BEGIN |
608			    BRIDGE_VLAN_INFO_RANGE_END))) {
609		NL_SET_ERR_MSG_MOD(extack, "Both vlan range flags are missing");
610		return false;
611	}
612
613	return true;
614}
615
616static inline int br_afspec_cmd_to_rtm(int cmd)
617{
618	switch (cmd) {
619	case RTM_SETLINK:
620		return RTM_NEWVLAN;
621	case RTM_DELLINK:
622		return RTM_DELVLAN;
623	}
624
625	return 0;
626}
627
628static inline int br_opt_get(const struct net_bridge *br,
629			     enum net_bridge_opts opt)
630{
631	return test_bit(opt, &br->options);
632}
633
634int br_boolopt_toggle(struct net_bridge *br, enum br_boolopt_id opt, bool on,
635		      struct netlink_ext_ack *extack);
636int br_boolopt_get(const struct net_bridge *br, enum br_boolopt_id opt);
637int br_boolopt_multi_toggle(struct net_bridge *br,
638			    struct br_boolopt_multi *bm,
639			    struct netlink_ext_ack *extack);
640void br_boolopt_multi_get(const struct net_bridge *br,
641			  struct br_boolopt_multi *bm);
642void br_opt_toggle(struct net_bridge *br, enum net_bridge_opts opt, bool on);
643
644/* br_device.c */
645void br_dev_setup(struct net_device *dev);
646void br_dev_delete(struct net_device *dev, struct list_head *list);
647netdev_tx_t br_dev_xmit(struct sk_buff *skb, struct net_device *dev);
648#ifdef CONFIG_NET_POLL_CONTROLLER
649static inline void br_netpoll_send_skb(const struct net_bridge_port *p,
650				       struct sk_buff *skb)
651{
652	netpoll_send_skb(p->np, skb);
653}
654
655int br_netpoll_enable(struct net_bridge_port *p);
656void br_netpoll_disable(struct net_bridge_port *p);
657#else
658static inline void br_netpoll_send_skb(const struct net_bridge_port *p,
659				       struct sk_buff *skb)
660{
661}
662
663static inline int br_netpoll_enable(struct net_bridge_port *p)
664{
665	return 0;
666}
667
668static inline void br_netpoll_disable(struct net_bridge_port *p)
669{
670}
671#endif
672
673/* br_fdb.c */
674int br_fdb_init(void);
675void br_fdb_fini(void);
676int br_fdb_hash_init(struct net_bridge *br);
677void br_fdb_hash_fini(struct net_bridge *br);
678void br_fdb_flush(struct net_bridge *br);
679void br_fdb_find_delete_local(struct net_bridge *br,
680			      const struct net_bridge_port *p,
681			      const unsigned char *addr, u16 vid);
682void br_fdb_changeaddr(struct net_bridge_port *p, const unsigned char *newaddr);
683void br_fdb_change_mac_address(struct net_bridge *br, const u8 *newaddr);
684void br_fdb_cleanup(struct work_struct *work);
685void br_fdb_delete_by_port(struct net_bridge *br,
686			   const struct net_bridge_port *p, u16 vid, int do_all);
687struct net_bridge_fdb_entry *br_fdb_find_rcu(struct net_bridge *br,
688					     const unsigned char *addr,
689					     __u16 vid);
690int br_fdb_test_addr(struct net_device *dev, unsigned char *addr);
691int br_fdb_fillbuf(struct net_bridge *br, void *buf, unsigned long count,
692		   unsigned long off);
693int br_fdb_insert(struct net_bridge *br, struct net_bridge_port *source,
694		  const unsigned char *addr, u16 vid);
695void br_fdb_update(struct net_bridge *br, struct net_bridge_port *source,
696		   const unsigned char *addr, u16 vid, unsigned long flags);
697
698int br_fdb_delete(struct ndmsg *ndm, struct nlattr *tb[],
699		  struct net_device *dev, const unsigned char *addr, u16 vid);
700int br_fdb_add(struct ndmsg *nlh, struct nlattr *tb[], struct net_device *dev,
701	       const unsigned char *addr, u16 vid, u16 nlh_flags,
702	       struct netlink_ext_ack *extack);
703int br_fdb_dump(struct sk_buff *skb, struct netlink_callback *cb,
704		struct net_device *dev, struct net_device *fdev, int *idx);
705int br_fdb_get(struct sk_buff *skb, struct nlattr *tb[], struct net_device *dev,
706	       const unsigned char *addr, u16 vid, u32 portid, u32 seq,
707	       struct netlink_ext_ack *extack);
708int br_fdb_sync_static(struct net_bridge *br, struct net_bridge_port *p);
709void br_fdb_unsync_static(struct net_bridge *br, struct net_bridge_port *p);
710int br_fdb_external_learn_add(struct net_bridge *br, struct net_bridge_port *p,
711			      const unsigned char *addr, u16 vid,
712			      bool swdev_notify);
713int br_fdb_external_learn_del(struct net_bridge *br, struct net_bridge_port *p,
714			      const unsigned char *addr, u16 vid,
715			      bool swdev_notify);
716void br_fdb_offloaded_set(struct net_bridge *br, struct net_bridge_port *p,
717			  const unsigned char *addr, u16 vid, bool offloaded);
718
719/* br_forward.c */
720enum br_pkt_type {
721	BR_PKT_UNICAST,
722	BR_PKT_MULTICAST,
723	BR_PKT_BROADCAST
724};
725int br_dev_queue_push_xmit(struct net *net, struct sock *sk, struct sk_buff *skb);
726void br_forward(const struct net_bridge_port *to, struct sk_buff *skb,
727		bool local_rcv, bool local_orig);
728int br_forward_finish(struct net *net, struct sock *sk, struct sk_buff *skb);
729void br_flood(struct net_bridge *br, struct sk_buff *skb,
730	      enum br_pkt_type pkt_type, bool local_rcv, bool local_orig);
731
732/* return true if both source port and dest port are isolated */
733static inline bool br_skb_isolated(const struct net_bridge_port *to,
734				   const struct sk_buff *skb)
735{
736	return BR_INPUT_SKB_CB(skb)->src_port_isolated &&
737	       (to->flags & BR_ISOLATED);
738}
739
740/* br_if.c */
741void br_port_carrier_check(struct net_bridge_port *p, bool *notified);
742int br_add_bridge(struct net *net, const char *name);
743int br_del_bridge(struct net *net, const char *name);
744int br_add_if(struct net_bridge *br, struct net_device *dev,
745	      struct netlink_ext_ack *extack);
746int br_del_if(struct net_bridge *br, struct net_device *dev);
747void br_mtu_auto_adjust(struct net_bridge *br);
748netdev_features_t br_features_recompute(struct net_bridge *br,
749					netdev_features_t features);
750void br_port_flags_change(struct net_bridge_port *port, unsigned long mask);
751void br_manage_promisc(struct net_bridge *br);
752int nbp_backup_change(struct net_bridge_port *p, struct net_device *backup_dev);
753
754/* br_input.c */
755int br_handle_frame_finish(struct net *net, struct sock *sk, struct sk_buff *skb);
756rx_handler_func_t *br_get_rx_handler(const struct net_device *dev);
757
758static inline bool br_rx_handler_check_rcu(const struct net_device *dev)
759{
760	return rcu_dereference(dev->rx_handler) == br_get_rx_handler(dev);
761}
762
763static inline bool br_rx_handler_check_rtnl(const struct net_device *dev)
764{
765	return rcu_dereference_rtnl(dev->rx_handler) == br_get_rx_handler(dev);
766}
767
768static inline struct net_bridge_port *br_port_get_check_rcu(const struct net_device *dev)
769{
770	return br_rx_handler_check_rcu(dev) ? br_port_get_rcu(dev) : NULL;
771}
772
773static inline struct net_bridge_port *
774br_port_get_check_rtnl(const struct net_device *dev)
775{
776	return br_rx_handler_check_rtnl(dev) ? br_port_get_rtnl_rcu(dev) : NULL;
777}
778
779/* br_ioctl.c */
780int br_dev_ioctl(struct net_device *dev, struct ifreq *rq, int cmd);
781int br_ioctl_deviceless_stub(struct net *net, unsigned int cmd,
782			     void __user *arg);
783
784/* br_multicast.c */
785#ifdef CONFIG_BRIDGE_IGMP_SNOOPING
786int br_multicast_rcv(struct net_bridge *br, struct net_bridge_port *port,
787		     struct sk_buff *skb, u16 vid);
788struct net_bridge_mdb_entry *br_mdb_get(struct net_bridge *br,
789					struct sk_buff *skb, u16 vid);
790int br_multicast_add_port(struct net_bridge_port *port);
791void br_multicast_del_port(struct net_bridge_port *port);
792void br_multicast_enable_port(struct net_bridge_port *port);
793void br_multicast_disable_port(struct net_bridge_port *port);
794void br_multicast_init(struct net_bridge *br);
795void br_multicast_join_snoopers(struct net_bridge *br);
796void br_multicast_leave_snoopers(struct net_bridge *br);
797void br_multicast_open(struct net_bridge *br);
798void br_multicast_stop(struct net_bridge *br);
799void br_multicast_dev_del(struct net_bridge *br);
800void br_multicast_flood(struct net_bridge_mdb_entry *mdst,
801			struct sk_buff *skb, bool local_rcv, bool local_orig);
802int br_multicast_set_router(struct net_bridge *br, unsigned long val);
803int br_multicast_set_port_router(struct net_bridge_port *p, unsigned long val);
804int br_multicast_toggle(struct net_bridge *br, unsigned long val);
805int br_multicast_set_querier(struct net_bridge *br, unsigned long val);
806int br_multicast_set_hash_max(struct net_bridge *br, unsigned long val);
807int br_multicast_set_igmp_version(struct net_bridge *br, unsigned long val);
808#if IS_ENABLED(CONFIG_IPV6)
809int br_multicast_set_mld_version(struct net_bridge *br, unsigned long val);
810#endif
811struct net_bridge_mdb_entry *
812br_mdb_ip_get(struct net_bridge *br, struct br_ip *dst);
813struct net_bridge_mdb_entry *
814br_multicast_new_group(struct net_bridge *br, struct br_ip *group);
815struct net_bridge_port_group *
816br_multicast_new_port_group(struct net_bridge_port *port, struct br_ip *group,
817			    struct net_bridge_port_group __rcu *next,
818			    unsigned char flags, const unsigned char *src,
819			    u8 filter_mode, u8 rt_protocol);
820int br_mdb_hash_init(struct net_bridge *br);
821void br_mdb_hash_fini(struct net_bridge *br);
822void br_mdb_notify(struct net_device *dev, struct net_bridge_mdb_entry *mp,
823		   struct net_bridge_port_group *pg, int type);
824void br_rtr_notify(struct net_device *dev, struct net_bridge_port *port,
825		   int type);
826void br_multicast_del_pg(struct net_bridge_mdb_entry *mp,
827			 struct net_bridge_port_group *pg,
828			 struct net_bridge_port_group __rcu **pp);
829void br_multicast_count(struct net_bridge *br, const struct net_bridge_port *p,
830			const struct sk_buff *skb, u8 type, u8 dir);
831int br_multicast_init_stats(struct net_bridge *br);
832void br_multicast_uninit_stats(struct net_bridge *br);
833void br_multicast_get_stats(const struct net_bridge *br,
834			    const struct net_bridge_port *p,
835			    struct br_mcast_stats *dest);
836void br_mdb_init(void);
837void br_mdb_uninit(void);
838void br_multicast_host_join(struct net_bridge_mdb_entry *mp, bool notify);
839void br_multicast_host_leave(struct net_bridge_mdb_entry *mp, bool notify);
840void br_multicast_star_g_handle_mode(struct net_bridge_port_group *pg,
841				     u8 filter_mode);
842void br_multicast_sg_add_exclude_ports(struct net_bridge_mdb_entry *star_mp,
843				       struct net_bridge_port_group *sg);
844
845#define mlock_dereference(X, br) \
846	rcu_dereference_protected(X, lockdep_is_held(&br->multicast_lock))
847
848static inline bool br_multicast_is_router(struct net_bridge *br)
849{
850	return br->multicast_router == 2 ||
851	       (br->multicast_router == 1 &&
852		timer_pending(&br->multicast_router_timer));
853}
854
855static inline bool
856__br_multicast_querier_exists(struct net_bridge *br,
857				struct bridge_mcast_other_query *querier,
858				const bool is_ipv6)
859{
860	bool own_querier_enabled;
861
862	if (br_opt_get(br, BROPT_MULTICAST_QUERIER)) {
863		if (is_ipv6 && !br_opt_get(br, BROPT_HAS_IPV6_ADDR))
864			own_querier_enabled = false;
865		else
866			own_querier_enabled = true;
867	} else {
868		own_querier_enabled = false;
869	}
870
871	return time_is_before_jiffies(querier->delay_time) &&
872	       (own_querier_enabled || timer_pending(&querier->timer));
873}
874
875static inline bool br_multicast_querier_exists(struct net_bridge *br,
876					       struct ethhdr *eth)
877{
878	switch (eth->h_proto) {
879	case (htons(ETH_P_IP)):
880		return __br_multicast_querier_exists(br,
881			&br->ip4_other_query, false);
882#if IS_ENABLED(CONFIG_IPV6)
883	case (htons(ETH_P_IPV6)):
884		return __br_multicast_querier_exists(br,
885			&br->ip6_other_query, true);
886#endif
887	default:
888		return false;
889	}
890}
891
892static inline bool br_multicast_is_star_g(const struct br_ip *ip)
893{
894	switch (ip->proto) {
895	case htons(ETH_P_IP):
896		return ipv4_is_zeronet(ip->src.ip4);
897#if IS_ENABLED(CONFIG_IPV6)
898	case htons(ETH_P_IPV6):
899		return ipv6_addr_any(&ip->src.ip6);
900#endif
901	default:
902		return false;
903	}
904}
905
906static inline bool br_multicast_should_handle_mode(const struct net_bridge *br,
907						   __be16 proto)
908{
909	switch (proto) {
910	case htons(ETH_P_IP):
911		return !!(br->multicast_igmp_version == 3);
912#if IS_ENABLED(CONFIG_IPV6)
913	case htons(ETH_P_IPV6):
914		return !!(br->multicast_mld_version == 2);
915#endif
916	default:
917		return false;
918	}
919}
920
921static inline int br_multicast_igmp_type(const struct sk_buff *skb)
922{
923	return BR_INPUT_SKB_CB(skb)->igmp;
924}
925
926static inline unsigned long br_multicast_lmqt(const struct net_bridge *br)
927{
928	return br->multicast_last_member_interval *
929	       br->multicast_last_member_count;
930}
931
932static inline unsigned long br_multicast_gmi(const struct net_bridge *br)
933{
934	return br->multicast_membership_interval;
935}
936#else
937static inline int br_multicast_rcv(struct net_bridge *br,
938				   struct net_bridge_port *port,
939				   struct sk_buff *skb,
940				   u16 vid)
941{
942	return 0;
943}
944
945static inline struct net_bridge_mdb_entry *br_mdb_get(struct net_bridge *br,
946						      struct sk_buff *skb, u16 vid)
947{
948	return NULL;
949}
950
951static inline int br_multicast_add_port(struct net_bridge_port *port)
952{
953	return 0;
954}
955
956static inline void br_multicast_del_port(struct net_bridge_port *port)
957{
958}
959
960static inline void br_multicast_enable_port(struct net_bridge_port *port)
961{
962}
963
964static inline void br_multicast_disable_port(struct net_bridge_port *port)
965{
966}
967
968static inline void br_multicast_init(struct net_bridge *br)
969{
970}
971
972static inline void br_multicast_join_snoopers(struct net_bridge *br)
973{
974}
975
976static inline void br_multicast_leave_snoopers(struct net_bridge *br)
977{
978}
979
980static inline void br_multicast_open(struct net_bridge *br)
981{
982}
983
984static inline void br_multicast_stop(struct net_bridge *br)
985{
986}
987
988static inline void br_multicast_dev_del(struct net_bridge *br)
989{
990}
991
992static inline void br_multicast_flood(struct net_bridge_mdb_entry *mdst,
993				      struct sk_buff *skb,
994				      bool local_rcv, bool local_orig)
995{
996}
997
998static inline bool br_multicast_is_router(struct net_bridge *br)
999{
1000	return false;
1001}
1002
1003static inline bool br_multicast_querier_exists(struct net_bridge *br,
1004					       struct ethhdr *eth)
1005{
1006	return false;
1007}
1008
1009static inline void br_mdb_init(void)
1010{
1011}
1012
1013static inline void br_mdb_uninit(void)
1014{
1015}
1016
1017static inline int br_mdb_hash_init(struct net_bridge *br)
1018{
1019	return 0;
1020}
1021
1022static inline void br_mdb_hash_fini(struct net_bridge *br)
1023{
1024}
1025
1026static inline void br_multicast_count(struct net_bridge *br,
1027				      const struct net_bridge_port *p,
1028				      const struct sk_buff *skb,
1029				      u8 type, u8 dir)
1030{
1031}
1032
1033static inline int br_multicast_init_stats(struct net_bridge *br)
1034{
1035	return 0;
1036}
1037
1038static inline void br_multicast_uninit_stats(struct net_bridge *br)
1039{
1040}
1041
1042static inline int br_multicast_igmp_type(const struct sk_buff *skb)
1043{
1044	return 0;
1045}
1046#endif
1047
1048/* br_vlan.c */
1049#ifdef CONFIG_BRIDGE_VLAN_FILTERING
1050bool br_allowed_ingress(const struct net_bridge *br,
1051			struct net_bridge_vlan_group *vg, struct sk_buff *skb,
1052			u16 *vid, u8 *state);
1053bool br_allowed_egress(struct net_bridge_vlan_group *vg,
1054		       const struct sk_buff *skb);
1055bool br_should_learn(struct net_bridge_port *p, struct sk_buff *skb, u16 *vid);
1056struct sk_buff *br_handle_vlan(struct net_bridge *br,
1057			       const struct net_bridge_port *port,
1058			       struct net_bridge_vlan_group *vg,
1059			       struct sk_buff *skb);
1060int br_vlan_add(struct net_bridge *br, u16 vid, u16 flags,
1061		bool *changed, struct netlink_ext_ack *extack);
1062int br_vlan_delete(struct net_bridge *br, u16 vid);
1063void br_vlan_flush(struct net_bridge *br);
1064struct net_bridge_vlan *br_vlan_find(struct net_bridge_vlan_group *vg, u16 vid);
1065void br_recalculate_fwd_mask(struct net_bridge *br);
1066int __br_vlan_filter_toggle(struct net_bridge *br, unsigned long val);
1067int br_vlan_filter_toggle(struct net_bridge *br, unsigned long val);
1068int __br_vlan_set_proto(struct net_bridge *br, __be16 proto);
1069int br_vlan_set_proto(struct net_bridge *br, unsigned long val);
1070int br_vlan_set_stats(struct net_bridge *br, unsigned long val);
1071int br_vlan_set_stats_per_port(struct net_bridge *br, unsigned long val);
1072int br_vlan_init(struct net_bridge *br);
1073int br_vlan_set_default_pvid(struct net_bridge *br, unsigned long val);
1074int __br_vlan_set_default_pvid(struct net_bridge *br, u16 pvid,
1075			       struct netlink_ext_ack *extack);
1076int nbp_vlan_add(struct net_bridge_port *port, u16 vid, u16 flags,
1077		 bool *changed, struct netlink_ext_ack *extack);
1078int nbp_vlan_delete(struct net_bridge_port *port, u16 vid);
1079void nbp_vlan_flush(struct net_bridge_port *port);
1080int nbp_vlan_init(struct net_bridge_port *port, struct netlink_ext_ack *extack);
1081int nbp_get_num_vlan_infos(struct net_bridge_port *p, u32 filter_mask);
1082void br_vlan_get_stats(const struct net_bridge_vlan *v,
1083		       struct br_vlan_stats *stats);
1084void br_vlan_port_event(struct net_bridge_port *p, unsigned long event);
1085int br_vlan_bridge_event(struct net_device *dev, unsigned long event,
1086			 void *ptr);
1087void br_vlan_rtnl_init(void);
1088void br_vlan_rtnl_uninit(void);
1089void br_vlan_notify(const struct net_bridge *br,
1090		    const struct net_bridge_port *p,
1091		    u16 vid, u16 vid_range,
1092		    int cmd);
1093bool br_vlan_can_enter_range(const struct net_bridge_vlan *v_curr,
1094			     const struct net_bridge_vlan *range_end);
1095
1096static inline struct net_bridge_vlan_group *br_vlan_group(
1097					const struct net_bridge *br)
1098{
1099	return rtnl_dereference(br->vlgrp);
1100}
1101
1102static inline struct net_bridge_vlan_group *nbp_vlan_group(
1103					const struct net_bridge_port *p)
1104{
1105	return rtnl_dereference(p->vlgrp);
1106}
1107
1108static inline struct net_bridge_vlan_group *br_vlan_group_rcu(
1109					const struct net_bridge *br)
1110{
1111	return rcu_dereference(br->vlgrp);
1112}
1113
1114static inline struct net_bridge_vlan_group *nbp_vlan_group_rcu(
1115					const struct net_bridge_port *p)
1116{
1117	return rcu_dereference(p->vlgrp);
1118}
1119
1120/* Since bridge now depends on 8021Q module, but the time bridge sees the
1121 * skb, the vlan tag will always be present if the frame was tagged.
1122 */
1123static inline int br_vlan_get_tag(const struct sk_buff *skb, u16 *vid)
1124{
1125	int err = 0;
1126
1127	if (skb_vlan_tag_present(skb)) {
1128		*vid = skb_vlan_tag_get_id(skb);
1129	} else {
1130		*vid = 0;
1131		err = -EINVAL;
1132	}
1133
1134	return err;
1135}
1136
1137static inline u16 br_get_pvid(const struct net_bridge_vlan_group *vg)
1138{
1139	if (!vg)
1140		return 0;
1141
1142	smp_rmb();
1143	return vg->pvid;
1144}
1145
1146static inline u16 br_vlan_flags(const struct net_bridge_vlan *v, u16 pvid)
1147{
1148	return v->vid == pvid ? v->flags | BRIDGE_VLAN_INFO_PVID : v->flags;
1149}
1150#else
1151static inline bool br_allowed_ingress(const struct net_bridge *br,
1152				      struct net_bridge_vlan_group *vg,
1153				      struct sk_buff *skb,
1154				      u16 *vid, u8 *state)
1155{
1156	return true;
1157}
1158
1159static inline bool br_allowed_egress(struct net_bridge_vlan_group *vg,
1160				     const struct sk_buff *skb)
1161{
1162	return true;
1163}
1164
1165static inline bool br_should_learn(struct net_bridge_port *p,
1166				   struct sk_buff *skb, u16 *vid)
1167{
1168	return true;
1169}
1170
1171static inline struct sk_buff *br_handle_vlan(struct net_bridge *br,
1172					     const struct net_bridge_port *port,
1173					     struct net_bridge_vlan_group *vg,
1174					     struct sk_buff *skb)
1175{
1176	return skb;
1177}
1178
1179static inline int br_vlan_add(struct net_bridge *br, u16 vid, u16 flags,
1180			      bool *changed, struct netlink_ext_ack *extack)
1181{
1182	*changed = false;
1183	return -EOPNOTSUPP;
1184}
1185
1186static inline int br_vlan_delete(struct net_bridge *br, u16 vid)
1187{
1188	return -EOPNOTSUPP;
1189}
1190
1191static inline void br_vlan_flush(struct net_bridge *br)
1192{
1193}
1194
1195static inline void br_recalculate_fwd_mask(struct net_bridge *br)
1196{
1197}
1198
1199static inline int br_vlan_init(struct net_bridge *br)
1200{
1201	return 0;
1202}
1203
1204static inline int nbp_vlan_add(struct net_bridge_port *port, u16 vid, u16 flags,
1205			       bool *changed, struct netlink_ext_ack *extack)
1206{
1207	*changed = false;
1208	return -EOPNOTSUPP;
1209}
1210
1211static inline int nbp_vlan_delete(struct net_bridge_port *port, u16 vid)
1212{
1213	return -EOPNOTSUPP;
1214}
1215
1216static inline void nbp_vlan_flush(struct net_bridge_port *port)
1217{
1218}
1219
1220static inline struct net_bridge_vlan *br_vlan_find(struct net_bridge_vlan_group *vg,
1221						   u16 vid)
1222{
1223	return NULL;
1224}
1225
1226static inline int nbp_vlan_init(struct net_bridge_port *port,
1227				struct netlink_ext_ack *extack)
1228{
1229	return 0;
1230}
1231
1232static inline u16 br_vlan_get_tag(const struct sk_buff *skb, u16 *tag)
1233{
1234	return 0;
1235}
1236
1237static inline u16 br_get_pvid(const struct net_bridge_vlan_group *vg)
1238{
1239	return 0;
1240}
1241
1242static inline int __br_vlan_filter_toggle(struct net_bridge *br,
1243					  unsigned long val)
1244{
1245	return -EOPNOTSUPP;
1246}
1247
1248static inline int nbp_get_num_vlan_infos(struct net_bridge_port *p,
1249					 u32 filter_mask)
1250{
1251	return 0;
1252}
1253
1254static inline struct net_bridge_vlan_group *br_vlan_group(
1255					const struct net_bridge *br)
1256{
1257	return NULL;
1258}
1259
1260static inline struct net_bridge_vlan_group *nbp_vlan_group(
1261					const struct net_bridge_port *p)
1262{
1263	return NULL;
1264}
1265
1266static inline struct net_bridge_vlan_group *br_vlan_group_rcu(
1267					const struct net_bridge *br)
1268{
1269	return NULL;
1270}
1271
1272static inline struct net_bridge_vlan_group *nbp_vlan_group_rcu(
1273					const struct net_bridge_port *p)
1274{
1275	return NULL;
1276}
1277
1278static inline void br_vlan_get_stats(const struct net_bridge_vlan *v,
1279				     struct br_vlan_stats *stats)
1280{
1281}
1282
1283static inline void br_vlan_port_event(struct net_bridge_port *p,
1284				      unsigned long event)
1285{
1286}
1287
1288static inline int br_vlan_bridge_event(struct net_device *dev,
1289				       unsigned long event, void *ptr)
1290{
1291	return 0;
1292}
1293
1294static inline void br_vlan_rtnl_init(void)
1295{
1296}
1297
1298static inline void br_vlan_rtnl_uninit(void)
1299{
1300}
1301
1302static inline void br_vlan_notify(const struct net_bridge *br,
1303				  const struct net_bridge_port *p,
1304				  u16 vid, u16 vid_range,
1305				  int cmd)
1306{
1307}
1308
1309static inline bool br_vlan_can_enter_range(const struct net_bridge_vlan *v_curr,
1310					   const struct net_bridge_vlan *range_end)
1311{
1312	return true;
1313}
1314#endif
1315
1316/* br_vlan_options.c */
1317#ifdef CONFIG_BRIDGE_VLAN_FILTERING
1318bool br_vlan_opts_eq_range(const struct net_bridge_vlan *v_curr,
1319			   const struct net_bridge_vlan *range_end);
1320bool br_vlan_opts_fill(struct sk_buff *skb, const struct net_bridge_vlan *v);
1321size_t br_vlan_opts_nl_size(void);
1322int br_vlan_process_options(const struct net_bridge *br,
1323			    const struct net_bridge_port *p,
1324			    struct net_bridge_vlan *range_start,
1325			    struct net_bridge_vlan *range_end,
1326			    struct nlattr **tb,
1327			    struct netlink_ext_ack *extack);
1328
1329/* vlan state manipulation helpers using *_ONCE to annotate lock-free access */
1330static inline u8 br_vlan_get_state(const struct net_bridge_vlan *v)
1331{
1332	return READ_ONCE(v->state);
1333}
1334
1335static inline void br_vlan_set_state(struct net_bridge_vlan *v, u8 state)
1336{
1337	WRITE_ONCE(v->state, state);
1338}
1339
1340static inline u8 br_vlan_get_pvid_state(const struct net_bridge_vlan_group *vg)
1341{
1342	return READ_ONCE(vg->pvid_state);
1343}
1344
1345static inline void br_vlan_set_pvid_state(struct net_bridge_vlan_group *vg,
1346					  u8 state)
1347{
1348	WRITE_ONCE(vg->pvid_state, state);
1349}
1350
1351/* learn_allow is true at ingress and false at egress */
1352static inline bool br_vlan_state_allowed(u8 state, bool learn_allow)
1353{
1354	switch (state) {
1355	case BR_STATE_LEARNING:
1356		return learn_allow;
1357	case BR_STATE_FORWARDING:
1358		return true;
1359	default:
1360		return false;
1361	}
1362}
1363#endif
1364
1365struct nf_br_ops {
1366	int (*br_dev_xmit_hook)(struct sk_buff *skb);
1367};
1368extern const struct nf_br_ops __rcu *nf_br_ops;
1369
1370/* br_netfilter.c */
1371#if IS_ENABLED(CONFIG_BRIDGE_NETFILTER)
1372int br_nf_core_init(void);
1373void br_nf_core_fini(void);
1374void br_netfilter_rtable_init(struct net_bridge *);
1375#else
1376static inline int br_nf_core_init(void) { return 0; }
1377static inline void br_nf_core_fini(void) {}
1378#define br_netfilter_rtable_init(x)
1379#endif
1380
1381/* br_stp.c */
1382void br_set_state(struct net_bridge_port *p, unsigned int state);
1383struct net_bridge_port *br_get_port(struct net_bridge *br, u16 port_no);
1384void br_init_port(struct net_bridge_port *p);
1385void br_become_designated_port(struct net_bridge_port *p);
1386
1387void __br_set_forward_delay(struct net_bridge *br, unsigned long t);
1388int br_set_forward_delay(struct net_bridge *br, unsigned long x);
1389int br_set_hello_time(struct net_bridge *br, unsigned long x);
1390int br_set_max_age(struct net_bridge *br, unsigned long x);
1391int __set_ageing_time(struct net_device *dev, unsigned long t);
1392int br_set_ageing_time(struct net_bridge *br, clock_t ageing_time);
1393
1394
1395/* br_stp_if.c */
1396void br_stp_enable_bridge(struct net_bridge *br);
1397void br_stp_disable_bridge(struct net_bridge *br);
1398int br_stp_set_enabled(struct net_bridge *br, unsigned long val,
1399		       struct netlink_ext_ack *extack);
1400void br_stp_enable_port(struct net_bridge_port *p);
1401void br_stp_disable_port(struct net_bridge_port *p);
1402bool br_stp_recalculate_bridge_id(struct net_bridge *br);
1403void br_stp_change_bridge_id(struct net_bridge *br, const unsigned char *a);
1404void br_stp_set_bridge_priority(struct net_bridge *br, u16 newprio);
1405int br_stp_set_port_priority(struct net_bridge_port *p, unsigned long newprio);
1406int br_stp_set_path_cost(struct net_bridge_port *p, unsigned long path_cost);
1407ssize_t br_show_bridge_id(char *buf, const struct bridge_id *id);
1408
1409/* br_stp_bpdu.c */
1410struct stp_proto;
1411void br_stp_rcv(const struct stp_proto *proto, struct sk_buff *skb,
1412		struct net_device *dev);
1413
1414/* br_stp_timer.c */
1415void br_stp_timer_init(struct net_bridge *br);
1416void br_stp_port_timer_init(struct net_bridge_port *p);
1417unsigned long br_timer_value(const struct timer_list *timer);
1418
1419/* br.c */
1420#if IS_ENABLED(CONFIG_ATM_LANE)
1421extern int (*br_fdb_test_addr_hook)(struct net_device *dev, unsigned char *addr);
1422#endif
1423
1424/* br_mrp.c */
1425#if IS_ENABLED(CONFIG_BRIDGE_MRP)
1426int br_mrp_parse(struct net_bridge *br, struct net_bridge_port *p,
1427		 struct nlattr *attr, int cmd, struct netlink_ext_ack *extack);
1428int br_mrp_process(struct net_bridge_port *p, struct sk_buff *skb);
1429bool br_mrp_enabled(struct net_bridge *br);
1430void br_mrp_port_del(struct net_bridge *br, struct net_bridge_port *p);
1431int br_mrp_fill_info(struct sk_buff *skb, struct net_bridge *br);
1432#else
1433static inline int br_mrp_parse(struct net_bridge *br, struct net_bridge_port *p,
1434			       struct nlattr *attr, int cmd,
1435			       struct netlink_ext_ack *extack)
1436{
1437	return -EOPNOTSUPP;
1438}
1439
1440static inline int br_mrp_process(struct net_bridge_port *p, struct sk_buff *skb)
1441{
1442	return 0;
1443}
1444
1445static inline bool br_mrp_enabled(struct net_bridge *br)
1446{
1447	return false;
1448}
1449
1450static inline void br_mrp_port_del(struct net_bridge *br,
1451				   struct net_bridge_port *p)
1452{
1453}
1454
1455static inline int br_mrp_fill_info(struct sk_buff *skb, struct net_bridge *br)
1456{
1457	return 0;
1458}
1459
1460#endif
1461
1462/* br_netlink.c */
1463extern struct rtnl_link_ops br_link_ops;
1464int br_netlink_init(void);
1465void br_netlink_fini(void);
1466void br_ifinfo_notify(int event, const struct net_bridge *br,
1467		      const struct net_bridge_port *port);
1468int br_setlink(struct net_device *dev, struct nlmsghdr *nlmsg, u16 flags,
1469	       struct netlink_ext_ack *extack);
1470int br_dellink(struct net_device *dev, struct nlmsghdr *nlmsg, u16 flags);
1471int br_getlink(struct sk_buff *skb, u32 pid, u32 seq, struct net_device *dev,
1472	       u32 filter_mask, int nlflags);
1473int br_process_vlan_info(struct net_bridge *br,
1474			 struct net_bridge_port *p, int cmd,
1475			 struct bridge_vlan_info *vinfo_curr,
1476			 struct bridge_vlan_info **vinfo_last,
1477			 bool *changed,
1478			 struct netlink_ext_ack *extack);
1479
1480#ifdef CONFIG_SYSFS
1481/* br_sysfs_if.c */
1482extern const struct sysfs_ops brport_sysfs_ops;
1483int br_sysfs_addif(struct net_bridge_port *p);
1484int br_sysfs_renameif(struct net_bridge_port *p);
1485
1486/* br_sysfs_br.c */
1487int br_sysfs_addbr(struct net_device *dev);
1488void br_sysfs_delbr(struct net_device *dev);
1489
1490#else
1491
1492static inline int br_sysfs_addif(struct net_bridge_port *p) { return 0; }
1493static inline int br_sysfs_renameif(struct net_bridge_port *p) { return 0; }
1494static inline int br_sysfs_addbr(struct net_device *dev) { return 0; }
1495static inline void br_sysfs_delbr(struct net_device *dev) { return; }
1496#endif /* CONFIG_SYSFS */
1497
1498/* br_switchdev.c */
1499#ifdef CONFIG_NET_SWITCHDEV
1500int nbp_switchdev_mark_set(struct net_bridge_port *p);
1501void nbp_switchdev_frame_mark(const struct net_bridge_port *p,
1502			      struct sk_buff *skb);
1503bool nbp_switchdev_allowed_egress(const struct net_bridge_port *p,
1504				  const struct sk_buff *skb);
1505int br_switchdev_set_port_flag(struct net_bridge_port *p,
1506			       unsigned long flags,
1507			       unsigned long mask);
1508void br_switchdev_fdb_notify(const struct net_bridge_fdb_entry *fdb,
1509			     int type);
1510int br_switchdev_port_vlan_add(struct net_device *dev, u16 vid, u16 flags,
1511			       struct netlink_ext_ack *extack);
1512int br_switchdev_port_vlan_del(struct net_device *dev, u16 vid);
1513
1514static inline void br_switchdev_frame_unmark(struct sk_buff *skb)
1515{
1516	skb->offload_fwd_mark = 0;
1517}
1518#else
1519static inline int nbp_switchdev_mark_set(struct net_bridge_port *p)
1520{
1521	return 0;
1522}
1523
1524static inline void nbp_switchdev_frame_mark(const struct net_bridge_port *p,
1525					    struct sk_buff *skb)
1526{
1527}
1528
1529static inline bool nbp_switchdev_allowed_egress(const struct net_bridge_port *p,
1530						const struct sk_buff *skb)
1531{
1532	return true;
1533}
1534
1535static inline int br_switchdev_set_port_flag(struct net_bridge_port *p,
1536					     unsigned long flags,
1537					     unsigned long mask)
1538{
1539	return 0;
1540}
1541
1542static inline int br_switchdev_port_vlan_add(struct net_device *dev,
1543					     u16 vid, u16 flags,
1544					     struct netlink_ext_ack *extack)
1545{
1546	return -EOPNOTSUPP;
1547}
1548
1549static inline int br_switchdev_port_vlan_del(struct net_device *dev, u16 vid)
1550{
1551	return -EOPNOTSUPP;
1552}
1553
1554static inline void
1555br_switchdev_fdb_notify(const struct net_bridge_fdb_entry *fdb, int type)
1556{
1557}
1558
1559static inline void br_switchdev_frame_unmark(struct sk_buff *skb)
1560{
1561}
1562#endif /* CONFIG_NET_SWITCHDEV */
1563
1564/* br_arp_nd_proxy.c */
1565void br_recalculate_neigh_suppress_enabled(struct net_bridge *br);
1566void br_do_proxy_suppress_arp(struct sk_buff *skb, struct net_bridge *br,
1567			      u16 vid, struct net_bridge_port *p);
1568void br_do_suppress_nd(struct sk_buff *skb, struct net_bridge *br,
1569		       u16 vid, struct net_bridge_port *p, struct nd_msg *msg);
1570struct nd_msg *br_is_nd_neigh_msg(struct sk_buff *skb, struct nd_msg *m);
1571#endif
1572