]> asedeno.scripts.mit.edu Git - linux.git/blob - net/bridge/br_private.h
net: Add extack argument to ndo_fdb_add()
[linux.git] / net / bridge / br_private.h
1 /*
2  *      Linux ethernet bridge
3  *
4  *      Authors:
5  *      Lennert Buytenhek               <buytenh@gnu.org>
6  *
7  *      This program is free software; you can redistribute it and/or
8  *      modify it under the terms of the GNU General Public License
9  *      as published by the Free Software Foundation; either version
10  *      2 of the License, or (at your option) any later version.
11  */
12
13 #ifndef _BR_PRIVATE_H
14 #define _BR_PRIVATE_H
15
16 #include <linux/netdevice.h>
17 #include <linux/if_bridge.h>
18 #include <linux/netpoll.h>
19 #include <linux/u64_stats_sync.h>
20 #include <net/route.h>
21 #include <net/ip6_fib.h>
22 #include <linux/if_vlan.h>
23 #include <linux/rhashtable.h>
24 #include <linux/refcount.h>
25
26 #define BR_HASH_BITS 8
27 #define BR_HASH_SIZE (1 << BR_HASH_BITS)
28
29 #define BR_HOLD_TIME (1*HZ)
30
31 #define BR_PORT_BITS    10
32 #define BR_MAX_PORTS    (1<<BR_PORT_BITS)
33
34 #define BR_MULTICAST_DEFAULT_HASH_MAX 4096
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 typedef struct bridge_id bridge_id;
56 typedef struct mac_addr mac_addr;
57 typedef __u16 port_id;
58
59 struct bridge_id {
60         unsigned char   prio[2];
61         unsigned char   addr[ETH_ALEN];
62 };
63
64 struct mac_addr {
65         unsigned char   addr[ETH_ALEN];
66 };
67
68 #ifdef CONFIG_BRIDGE_IGMP_SNOOPING
69 /* our own querier */
70 struct bridge_mcast_own_query {
71         struct timer_list       timer;
72         u32                     startup_sent;
73 };
74
75 /* other querier */
76 struct bridge_mcast_other_query {
77         struct timer_list               timer;
78         unsigned long                   delay_time;
79 };
80
81 /* selected querier */
82 struct bridge_mcast_querier {
83         struct br_ip addr;
84         struct net_bridge_port __rcu    *port;
85 };
86
87 /* IGMP/MLD statistics */
88 struct bridge_mcast_stats {
89         struct br_mcast_stats mstats;
90         struct u64_stats_sync syncp;
91 };
92 #endif
93
94 struct br_vlan_stats {
95         u64 rx_bytes;
96         u64 rx_packets;
97         u64 tx_bytes;
98         u64 tx_packets;
99         struct u64_stats_sync syncp;
100 };
101
102 struct br_tunnel_info {
103         __be64                  tunnel_id;
104         struct metadata_dst     *tunnel_dst;
105 };
106
107 /* private vlan flags */
108 enum {
109         BR_VLFLAG_PER_PORT_STATS = BIT(0),
110         BR_VLFLAG_ADDED_BY_SWITCHDEV = BIT(1),
111 };
112
113 /**
114  * struct net_bridge_vlan - per-vlan entry
115  *
116  * @vnode: rhashtable member
117  * @vid: VLAN id
118  * @flags: bridge vlan flags
119  * @priv_flags: private (in-kernel) bridge vlan flags
120  * @stats: per-cpu VLAN statistics
121  * @br: if MASTER flag set, this points to a bridge struct
122  * @port: if MASTER flag unset, this points to a port struct
123  * @refcnt: if MASTER flag set, this is bumped for each port referencing it
124  * @brvlan: if MASTER flag unset, this points to the global per-VLAN context
125  *          for this VLAN entry
126  * @vlist: sorted list of VLAN entries
127  * @rcu: used for entry destruction
128  *
129  * This structure is shared between the global per-VLAN entries contained in
130  * the bridge rhashtable and the local per-port per-VLAN entries contained in
131  * the port's rhashtable. The union entries should be interpreted depending on
132  * the entry flags that are set.
133  */
134 struct net_bridge_vlan {
135         struct rhash_head               vnode;
136         struct rhash_head               tnode;
137         u16                             vid;
138         u16                             flags;
139         u16                             priv_flags;
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  *
165  * IMPORTANT: Be careful when checking if there're VLAN entries using list
166  *            primitives because the bridge can have entries in its list which
167  *            are just for global context but not for filtering, i.e. they have
168  *            the master flag set but not the brentry flag. If you have to check
169  *            if there're "real" entries in the bridge please test @num_vlans
170  */
171 struct net_bridge_vlan_group {
172         struct rhashtable               vlan_hash;
173         struct rhashtable               tunnel_hash;
174         struct list_head                vlan_list;
175         u16                             num_vlans;
176         u16                             pvid;
177 };
178
179 struct net_bridge_fdb_key {
180         mac_addr addr;
181         u16 vlan_id;
182 };
183
184 struct net_bridge_fdb_entry {
185         struct rhash_head               rhnode;
186         struct net_bridge_port          *dst;
187
188         struct net_bridge_fdb_key       key;
189         struct hlist_node               fdb_node;
190         unsigned char                   is_local:1,
191                                         is_static:1,
192                                         is_sticky:1,
193                                         added_by_user:1,
194                                         added_by_external_learn:1,
195                                         offloaded:1;
196
197         /* write-heavy members should not affect lookups */
198         unsigned long                   updated ____cacheline_aligned_in_smp;
199         unsigned long                   used;
200
201         struct rcu_head                 rcu;
202 };
203
204 #define MDB_PG_FLAGS_PERMANENT  BIT(0)
205 #define MDB_PG_FLAGS_OFFLOAD    BIT(1)
206
207 struct net_bridge_port_group {
208         struct net_bridge_port          *port;
209         struct net_bridge_port_group __rcu *next;
210         struct hlist_node               mglist;
211         struct rcu_head                 rcu;
212         struct timer_list               timer;
213         struct br_ip                    addr;
214         unsigned char                   flags;
215         unsigned char                   eth_addr[ETH_ALEN];
216 };
217
218 struct net_bridge_mdb_entry {
219         struct rhash_head               rhnode;
220         struct net_bridge               *br;
221         struct net_bridge_port_group __rcu *ports;
222         struct rcu_head                 rcu;
223         struct timer_list               timer;
224         struct br_ip                    addr;
225         bool                            host_joined;
226         struct hlist_node               mdb_node;
227 };
228
229 struct net_bridge_port {
230         struct net_bridge               *br;
231         struct net_device               *dev;
232         struct list_head                list;
233
234         unsigned long                   flags;
235 #ifdef CONFIG_BRIDGE_VLAN_FILTERING
236         struct net_bridge_vlan_group    __rcu *vlgrp;
237 #endif
238         struct net_bridge_port          __rcu *backup_port;
239
240         /* STP */
241         u8                              priority;
242         u8                              state;
243         u16                             port_no;
244         unsigned char                   topology_change_ack;
245         unsigned char                   config_pending;
246         port_id                         port_id;
247         port_id                         designated_port;
248         bridge_id                       designated_root;
249         bridge_id                       designated_bridge;
250         u32                             path_cost;
251         u32                             designated_cost;
252         unsigned long                   designated_age;
253
254         struct timer_list               forward_delay_timer;
255         struct timer_list               hold_timer;
256         struct timer_list               message_age_timer;
257         struct kobject                  kobj;
258         struct rcu_head                 rcu;
259
260 #ifdef CONFIG_BRIDGE_IGMP_SNOOPING
261         struct bridge_mcast_own_query   ip4_own_query;
262 #if IS_ENABLED(CONFIG_IPV6)
263         struct bridge_mcast_own_query   ip6_own_query;
264 #endif /* IS_ENABLED(CONFIG_IPV6) */
265         unsigned char                   multicast_router;
266         struct bridge_mcast_stats       __percpu *mcast_stats;
267         struct timer_list               multicast_router_timer;
268         struct hlist_head               mglist;
269         struct hlist_node               rlist;
270 #endif
271
272 #ifdef CONFIG_SYSFS
273         char                            sysfs_name[IFNAMSIZ];
274 #endif
275
276 #ifdef CONFIG_NET_POLL_CONTROLLER
277         struct netpoll                  *np;
278 #endif
279 #ifdef CONFIG_NET_SWITCHDEV
280         int                             offload_fwd_mark;
281 #endif
282         u16                             group_fwd_mask;
283         u16                             backup_redirected_cnt;
284 };
285
286 #define kobj_to_brport(obj)     container_of(obj, struct net_bridge_port, kobj)
287
288 #define br_auto_port(p) ((p)->flags & BR_AUTO_MASK)
289 #define br_promisc_port(p) ((p)->flags & BR_PROMISC)
290
291 #define br_port_exists(dev) (dev->priv_flags & IFF_BRIDGE_PORT)
292
293 static inline struct net_bridge_port *br_port_get_rcu(const struct net_device *dev)
294 {
295         return rcu_dereference(dev->rx_handler_data);
296 }
297
298 static inline struct net_bridge_port *br_port_get_rtnl(const struct net_device *dev)
299 {
300         return br_port_exists(dev) ?
301                 rtnl_dereference(dev->rx_handler_data) : NULL;
302 }
303
304 static inline struct net_bridge_port *br_port_get_rtnl_rcu(const struct net_device *dev)
305 {
306         return br_port_exists(dev) ?
307                 rcu_dereference_rtnl(dev->rx_handler_data) : NULL;
308 }
309
310 enum net_bridge_opts {
311         BROPT_VLAN_ENABLED,
312         BROPT_VLAN_STATS_ENABLED,
313         BROPT_NF_CALL_IPTABLES,
314         BROPT_NF_CALL_IP6TABLES,
315         BROPT_NF_CALL_ARPTABLES,
316         BROPT_GROUP_ADDR_SET,
317         BROPT_MULTICAST_ENABLED,
318         BROPT_MULTICAST_QUERIER,
319         BROPT_MULTICAST_QUERY_USE_IFADDR,
320         BROPT_MULTICAST_STATS_ENABLED,
321         BROPT_HAS_IPV6_ADDR,
322         BROPT_NEIGH_SUPPRESS_ENABLED,
323         BROPT_MTU_SET_BY_USER,
324         BROPT_VLAN_STATS_PER_PORT,
325         BROPT_NO_LL_LEARN,
326 };
327
328 struct net_bridge {
329         spinlock_t                      lock;
330         spinlock_t                      hash_lock;
331         struct list_head                port_list;
332         struct net_device               *dev;
333         struct pcpu_sw_netstats         __percpu *stats;
334         unsigned long                   options;
335         /* These fields are accessed on each packet */
336 #ifdef CONFIG_BRIDGE_VLAN_FILTERING
337         __be16                          vlan_proto;
338         u16                             default_pvid;
339         struct net_bridge_vlan_group    __rcu *vlgrp;
340 #endif
341
342         struct rhashtable               fdb_hash_tbl;
343 #if IS_ENABLED(CONFIG_BRIDGE_NETFILTER)
344         union {
345                 struct rtable           fake_rtable;
346                 struct rt6_info         fake_rt6_info;
347         };
348 #endif
349         u16                             group_fwd_mask;
350         u16                             group_fwd_mask_required;
351
352         /* STP */
353         bridge_id                       designated_root;
354         bridge_id                       bridge_id;
355         unsigned char                   topology_change;
356         unsigned char                   topology_change_detected;
357         u16                             root_port;
358         unsigned long                   max_age;
359         unsigned long                   hello_time;
360         unsigned long                   forward_delay;
361         unsigned long                   ageing_time;
362         unsigned long                   bridge_max_age;
363         unsigned long                   bridge_hello_time;
364         unsigned long                   bridge_forward_delay;
365         unsigned long                   bridge_ageing_time;
366         u32                             root_path_cost;
367
368         u8                              group_addr[ETH_ALEN];
369
370         enum {
371                 BR_NO_STP,              /* no spanning tree */
372                 BR_KERNEL_STP,          /* old STP in kernel */
373                 BR_USER_STP,            /* new RSTP in userspace */
374         } stp_enabled;
375
376 #ifdef CONFIG_BRIDGE_IGMP_SNOOPING
377
378         u32                             hash_max;
379
380         u32                             multicast_last_member_count;
381         u32                             multicast_startup_query_count;
382
383         u8                              multicast_igmp_version;
384         u8                              multicast_router;
385 #if IS_ENABLED(CONFIG_IPV6)
386         u8                              multicast_mld_version;
387 #endif
388         spinlock_t                      multicast_lock;
389         unsigned long                   multicast_last_member_interval;
390         unsigned long                   multicast_membership_interval;
391         unsigned long                   multicast_querier_interval;
392         unsigned long                   multicast_query_interval;
393         unsigned long                   multicast_query_response_interval;
394         unsigned long                   multicast_startup_query_interval;
395
396         struct rhashtable               mdb_hash_tbl;
397
398         struct hlist_head               mdb_list;
399         struct hlist_head               router_list;
400
401         struct timer_list               multicast_router_timer;
402         struct bridge_mcast_other_query ip4_other_query;
403         struct bridge_mcast_own_query   ip4_own_query;
404         struct bridge_mcast_querier     ip4_querier;
405         struct bridge_mcast_stats       __percpu *mcast_stats;
406 #if IS_ENABLED(CONFIG_IPV6)
407         struct bridge_mcast_other_query ip6_other_query;
408         struct bridge_mcast_own_query   ip6_own_query;
409         struct bridge_mcast_querier     ip6_querier;
410 #endif /* IS_ENABLED(CONFIG_IPV6) */
411 #endif
412
413         struct timer_list               hello_timer;
414         struct timer_list               tcn_timer;
415         struct timer_list               topology_change_timer;
416         struct delayed_work             gc_work;
417         struct kobject                  *ifobj;
418         u32                             auto_cnt;
419
420 #ifdef CONFIG_NET_SWITCHDEV
421         int offload_fwd_mark;
422 #endif
423         struct hlist_head               fdb_list;
424 };
425
426 struct br_input_skb_cb {
427         struct net_device *brdev;
428
429 #ifdef CONFIG_BRIDGE_IGMP_SNOOPING
430         int igmp;
431         int mrouters_only;
432 #endif
433
434         bool proxyarp_replied;
435         bool src_port_isolated;
436
437 #ifdef CONFIG_BRIDGE_VLAN_FILTERING
438         bool vlan_filtered;
439 #endif
440
441 #ifdef CONFIG_NET_SWITCHDEV
442         int offload_fwd_mark;
443 #endif
444 };
445
446 #define BR_INPUT_SKB_CB(__skb)  ((struct br_input_skb_cb *)(__skb)->cb)
447
448 #ifdef CONFIG_BRIDGE_IGMP_SNOOPING
449 # define BR_INPUT_SKB_CB_MROUTERS_ONLY(__skb)   (BR_INPUT_SKB_CB(__skb)->mrouters_only)
450 #else
451 # define BR_INPUT_SKB_CB_MROUTERS_ONLY(__skb)   (0)
452 #endif
453
454 #define br_printk(level, br, format, args...)   \
455         printk(level "%s: " format, (br)->dev->name, ##args)
456
457 #define br_err(__br, format, args...)                   \
458         br_printk(KERN_ERR, __br, format, ##args)
459 #define br_warn(__br, format, args...)                  \
460         br_printk(KERN_WARNING, __br, format, ##args)
461 #define br_notice(__br, format, args...)                \
462         br_printk(KERN_NOTICE, __br, format, ##args)
463 #define br_info(__br, format, args...)                  \
464         br_printk(KERN_INFO, __br, format, ##args)
465
466 #define br_debug(br, format, args...)                   \
467         pr_debug("%s: " format,  (br)->dev->name, ##args)
468
469 /* called under bridge lock */
470 static inline int br_is_root_bridge(const struct net_bridge *br)
471 {
472         return !memcmp(&br->bridge_id, &br->designated_root, 8);
473 }
474
475 /* check if a VLAN entry is global */
476 static inline bool br_vlan_is_master(const struct net_bridge_vlan *v)
477 {
478         return v->flags & BRIDGE_VLAN_INFO_MASTER;
479 }
480
481 /* check if a VLAN entry is used by the bridge */
482 static inline bool br_vlan_is_brentry(const struct net_bridge_vlan *v)
483 {
484         return v->flags & BRIDGE_VLAN_INFO_BRENTRY;
485 }
486
487 /* check if we should use the vlan entry, returns false if it's only context */
488 static inline bool br_vlan_should_use(const struct net_bridge_vlan *v)
489 {
490         if (br_vlan_is_master(v)) {
491                 if (br_vlan_is_brentry(v))
492                         return true;
493                 else
494                         return false;
495         }
496
497         return true;
498 }
499
500 static inline int br_opt_get(const struct net_bridge *br,
501                              enum net_bridge_opts opt)
502 {
503         return test_bit(opt, &br->options);
504 }
505
506 int br_boolopt_toggle(struct net_bridge *br, enum br_boolopt_id opt, bool on,
507                       struct netlink_ext_ack *extack);
508 int br_boolopt_get(const struct net_bridge *br, enum br_boolopt_id opt);
509 int br_boolopt_multi_toggle(struct net_bridge *br,
510                             struct br_boolopt_multi *bm,
511                             struct netlink_ext_ack *extack);
512 void br_boolopt_multi_get(const struct net_bridge *br,
513                           struct br_boolopt_multi *bm);
514 void br_opt_toggle(struct net_bridge *br, enum net_bridge_opts opt, bool on);
515
516 /* br_device.c */
517 void br_dev_setup(struct net_device *dev);
518 void br_dev_delete(struct net_device *dev, struct list_head *list);
519 netdev_tx_t br_dev_xmit(struct sk_buff *skb, struct net_device *dev);
520 #ifdef CONFIG_NET_POLL_CONTROLLER
521 static inline void br_netpoll_send_skb(const struct net_bridge_port *p,
522                                        struct sk_buff *skb)
523 {
524         struct netpoll *np = p->np;
525
526         if (np)
527                 netpoll_send_skb(np, skb);
528 }
529
530 int br_netpoll_enable(struct net_bridge_port *p);
531 void br_netpoll_disable(struct net_bridge_port *p);
532 #else
533 static inline void br_netpoll_send_skb(const struct net_bridge_port *p,
534                                        struct sk_buff *skb)
535 {
536 }
537
538 static inline int br_netpoll_enable(struct net_bridge_port *p)
539 {
540         return 0;
541 }
542
543 static inline void br_netpoll_disable(struct net_bridge_port *p)
544 {
545 }
546 #endif
547
548 /* br_fdb.c */
549 int br_fdb_init(void);
550 void br_fdb_fini(void);
551 int br_fdb_hash_init(struct net_bridge *br);
552 void br_fdb_hash_fini(struct net_bridge *br);
553 void br_fdb_flush(struct net_bridge *br);
554 void br_fdb_find_delete_local(struct net_bridge *br,
555                               const struct net_bridge_port *p,
556                               const unsigned char *addr, u16 vid);
557 void br_fdb_changeaddr(struct net_bridge_port *p, const unsigned char *newaddr);
558 void br_fdb_change_mac_address(struct net_bridge *br, const u8 *newaddr);
559 void br_fdb_cleanup(struct work_struct *work);
560 void br_fdb_delete_by_port(struct net_bridge *br,
561                            const struct net_bridge_port *p, u16 vid, int do_all);
562 struct net_bridge_fdb_entry *br_fdb_find_rcu(struct net_bridge *br,
563                                              const unsigned char *addr,
564                                              __u16 vid);
565 int br_fdb_test_addr(struct net_device *dev, unsigned char *addr);
566 int br_fdb_fillbuf(struct net_bridge *br, void *buf, unsigned long count,
567                    unsigned long off);
568 int br_fdb_insert(struct net_bridge *br, struct net_bridge_port *source,
569                   const unsigned char *addr, u16 vid);
570 void br_fdb_update(struct net_bridge *br, struct net_bridge_port *source,
571                    const unsigned char *addr, u16 vid, bool added_by_user);
572
573 int br_fdb_delete(struct ndmsg *ndm, struct nlattr *tb[],
574                   struct net_device *dev, const unsigned char *addr, u16 vid);
575 int br_fdb_add(struct ndmsg *nlh, struct nlattr *tb[], struct net_device *dev,
576                const unsigned char *addr, u16 vid, u16 nlh_flags,
577                struct netlink_ext_ack *extack);
578 int br_fdb_dump(struct sk_buff *skb, struct netlink_callback *cb,
579                 struct net_device *dev, struct net_device *fdev, int *idx);
580 int br_fdb_get(struct sk_buff *skb, struct nlattr *tb[], struct net_device *dev,
581                const unsigned char *addr, u16 vid, u32 portid, u32 seq,
582                struct netlink_ext_ack *extack);
583 int br_fdb_sync_static(struct net_bridge *br, struct net_bridge_port *p);
584 void br_fdb_unsync_static(struct net_bridge *br, struct net_bridge_port *p);
585 int br_fdb_external_learn_add(struct net_bridge *br, struct net_bridge_port *p,
586                               const unsigned char *addr, u16 vid,
587                               bool swdev_notify);
588 int br_fdb_external_learn_del(struct net_bridge *br, struct net_bridge_port *p,
589                               const unsigned char *addr, u16 vid,
590                               bool swdev_notify);
591 void br_fdb_offloaded_set(struct net_bridge *br, struct net_bridge_port *p,
592                           const unsigned char *addr, u16 vid, bool offloaded);
593
594 /* br_forward.c */
595 enum br_pkt_type {
596         BR_PKT_UNICAST,
597         BR_PKT_MULTICAST,
598         BR_PKT_BROADCAST
599 };
600 int br_dev_queue_push_xmit(struct net *net, struct sock *sk, struct sk_buff *skb);
601 void br_forward(const struct net_bridge_port *to, struct sk_buff *skb,
602                 bool local_rcv, bool local_orig);
603 int br_forward_finish(struct net *net, struct sock *sk, struct sk_buff *skb);
604 void br_flood(struct net_bridge *br, struct sk_buff *skb,
605               enum br_pkt_type pkt_type, bool local_rcv, bool local_orig);
606
607 /* return true if both source port and dest port are isolated */
608 static inline bool br_skb_isolated(const struct net_bridge_port *to,
609                                    const struct sk_buff *skb)
610 {
611         return BR_INPUT_SKB_CB(skb)->src_port_isolated &&
612                (to->flags & BR_ISOLATED);
613 }
614
615 /* br_if.c */
616 void br_port_carrier_check(struct net_bridge_port *p, bool *notified);
617 int br_add_bridge(struct net *net, const char *name);
618 int br_del_bridge(struct net *net, const char *name);
619 int br_add_if(struct net_bridge *br, struct net_device *dev,
620               struct netlink_ext_ack *extack);
621 int br_del_if(struct net_bridge *br, struct net_device *dev);
622 void br_mtu_auto_adjust(struct net_bridge *br);
623 netdev_features_t br_features_recompute(struct net_bridge *br,
624                                         netdev_features_t features);
625 void br_port_flags_change(struct net_bridge_port *port, unsigned long mask);
626 void br_manage_promisc(struct net_bridge *br);
627 int nbp_backup_change(struct net_bridge_port *p, struct net_device *backup_dev);
628
629 /* br_input.c */
630 int br_handle_frame_finish(struct net *net, struct sock *sk, struct sk_buff *skb);
631 rx_handler_result_t br_handle_frame(struct sk_buff **pskb);
632
633 static inline bool br_rx_handler_check_rcu(const struct net_device *dev)
634 {
635         return rcu_dereference(dev->rx_handler) == br_handle_frame;
636 }
637
638 static inline bool br_rx_handler_check_rtnl(const struct net_device *dev)
639 {
640         return rcu_dereference_rtnl(dev->rx_handler) == br_handle_frame;
641 }
642
643 static inline struct net_bridge_port *br_port_get_check_rcu(const struct net_device *dev)
644 {
645         return br_rx_handler_check_rcu(dev) ? br_port_get_rcu(dev) : NULL;
646 }
647
648 static inline struct net_bridge_port *
649 br_port_get_check_rtnl(const struct net_device *dev)
650 {
651         return br_rx_handler_check_rtnl(dev) ? br_port_get_rtnl_rcu(dev) : NULL;
652 }
653
654 /* br_ioctl.c */
655 int br_dev_ioctl(struct net_device *dev, struct ifreq *rq, int cmd);
656 int br_ioctl_deviceless_stub(struct net *net, unsigned int cmd,
657                              void __user *arg);
658
659 /* br_multicast.c */
660 #ifdef CONFIG_BRIDGE_IGMP_SNOOPING
661 int br_multicast_rcv(struct net_bridge *br, struct net_bridge_port *port,
662                      struct sk_buff *skb, u16 vid);
663 struct net_bridge_mdb_entry *br_mdb_get(struct net_bridge *br,
664                                         struct sk_buff *skb, u16 vid);
665 int br_multicast_add_port(struct net_bridge_port *port);
666 void br_multicast_del_port(struct net_bridge_port *port);
667 void br_multicast_enable_port(struct net_bridge_port *port);
668 void br_multicast_disable_port(struct net_bridge_port *port);
669 void br_multicast_init(struct net_bridge *br);
670 void br_multicast_open(struct net_bridge *br);
671 void br_multicast_stop(struct net_bridge *br);
672 void br_multicast_dev_del(struct net_bridge *br);
673 void br_multicast_flood(struct net_bridge_mdb_entry *mdst,
674                         struct sk_buff *skb, bool local_rcv, bool local_orig);
675 int br_multicast_set_router(struct net_bridge *br, unsigned long val);
676 int br_multicast_set_port_router(struct net_bridge_port *p, unsigned long val);
677 int br_multicast_toggle(struct net_bridge *br, unsigned long val);
678 int br_multicast_set_querier(struct net_bridge *br, unsigned long val);
679 int br_multicast_set_hash_max(struct net_bridge *br, unsigned long val);
680 int br_multicast_set_igmp_version(struct net_bridge *br, unsigned long val);
681 #if IS_ENABLED(CONFIG_IPV6)
682 int br_multicast_set_mld_version(struct net_bridge *br, unsigned long val);
683 #endif
684 struct net_bridge_mdb_entry *
685 br_mdb_ip_get(struct net_bridge *br, struct br_ip *dst);
686 struct net_bridge_mdb_entry *
687 br_multicast_new_group(struct net_bridge *br, struct br_ip *group);
688 struct net_bridge_port_group *
689 br_multicast_new_port_group(struct net_bridge_port *port, struct br_ip *group,
690                             struct net_bridge_port_group __rcu *next,
691                             unsigned char flags, const unsigned char *src);
692 int br_mdb_hash_init(struct net_bridge *br);
693 void br_mdb_hash_fini(struct net_bridge *br);
694 void br_mdb_notify(struct net_device *dev, struct net_bridge_port *port,
695                    struct br_ip *group, int type, u8 flags);
696 void br_rtr_notify(struct net_device *dev, struct net_bridge_port *port,
697                    int type);
698 void br_multicast_count(struct net_bridge *br, const struct net_bridge_port *p,
699                         const struct sk_buff *skb, u8 type, u8 dir);
700 int br_multicast_init_stats(struct net_bridge *br);
701 void br_multicast_uninit_stats(struct net_bridge *br);
702 void br_multicast_get_stats(const struct net_bridge *br,
703                             const struct net_bridge_port *p,
704                             struct br_mcast_stats *dest);
705 void br_mdb_init(void);
706 void br_mdb_uninit(void);
707
708 #define mlock_dereference(X, br) \
709         rcu_dereference_protected(X, lockdep_is_held(&br->multicast_lock))
710
711 static inline bool br_multicast_is_router(struct net_bridge *br)
712 {
713         return br->multicast_router == 2 ||
714                (br->multicast_router == 1 &&
715                 timer_pending(&br->multicast_router_timer));
716 }
717
718 static inline bool
719 __br_multicast_querier_exists(struct net_bridge *br,
720                                 struct bridge_mcast_other_query *querier,
721                                 const bool is_ipv6)
722 {
723         bool own_querier_enabled;
724
725         if (br_opt_get(br, BROPT_MULTICAST_QUERIER)) {
726                 if (is_ipv6 && !br_opt_get(br, BROPT_HAS_IPV6_ADDR))
727                         own_querier_enabled = false;
728                 else
729                         own_querier_enabled = true;
730         } else {
731                 own_querier_enabled = false;
732         }
733
734         return time_is_before_jiffies(querier->delay_time) &&
735                (own_querier_enabled || timer_pending(&querier->timer));
736 }
737
738 static inline bool br_multicast_querier_exists(struct net_bridge *br,
739                                                struct ethhdr *eth)
740 {
741         switch (eth->h_proto) {
742         case (htons(ETH_P_IP)):
743                 return __br_multicast_querier_exists(br,
744                         &br->ip4_other_query, false);
745 #if IS_ENABLED(CONFIG_IPV6)
746         case (htons(ETH_P_IPV6)):
747                 return __br_multicast_querier_exists(br,
748                         &br->ip6_other_query, true);
749 #endif
750         default:
751                 return false;
752         }
753 }
754
755 static inline int br_multicast_igmp_type(const struct sk_buff *skb)
756 {
757         return BR_INPUT_SKB_CB(skb)->igmp;
758 }
759 #else
760 static inline int br_multicast_rcv(struct net_bridge *br,
761                                    struct net_bridge_port *port,
762                                    struct sk_buff *skb,
763                                    u16 vid)
764 {
765         return 0;
766 }
767
768 static inline struct net_bridge_mdb_entry *br_mdb_get(struct net_bridge *br,
769                                                       struct sk_buff *skb, u16 vid)
770 {
771         return NULL;
772 }
773
774 static inline int br_multicast_add_port(struct net_bridge_port *port)
775 {
776         return 0;
777 }
778
779 static inline void br_multicast_del_port(struct net_bridge_port *port)
780 {
781 }
782
783 static inline void br_multicast_enable_port(struct net_bridge_port *port)
784 {
785 }
786
787 static inline void br_multicast_disable_port(struct net_bridge_port *port)
788 {
789 }
790
791 static inline void br_multicast_init(struct net_bridge *br)
792 {
793 }
794
795 static inline void br_multicast_open(struct net_bridge *br)
796 {
797 }
798
799 static inline void br_multicast_stop(struct net_bridge *br)
800 {
801 }
802
803 static inline void br_multicast_dev_del(struct net_bridge *br)
804 {
805 }
806
807 static inline void br_multicast_flood(struct net_bridge_mdb_entry *mdst,
808                                       struct sk_buff *skb,
809                                       bool local_rcv, bool local_orig)
810 {
811 }
812
813 static inline bool br_multicast_is_router(struct net_bridge *br)
814 {
815         return false;
816 }
817
818 static inline bool br_multicast_querier_exists(struct net_bridge *br,
819                                                struct ethhdr *eth)
820 {
821         return false;
822 }
823
824 static inline void br_mdb_init(void)
825 {
826 }
827
828 static inline void br_mdb_uninit(void)
829 {
830 }
831
832 static inline int br_mdb_hash_init(struct net_bridge *br)
833 {
834         return 0;
835 }
836
837 static inline void br_mdb_hash_fini(struct net_bridge *br)
838 {
839 }
840
841 static inline void br_multicast_count(struct net_bridge *br,
842                                       const struct net_bridge_port *p,
843                                       const struct sk_buff *skb,
844                                       u8 type, u8 dir)
845 {
846 }
847
848 static inline int br_multicast_init_stats(struct net_bridge *br)
849 {
850         return 0;
851 }
852
853 static inline void br_multicast_uninit_stats(struct net_bridge *br)
854 {
855 }
856
857 static inline int br_multicast_igmp_type(const struct sk_buff *skb)
858 {
859         return 0;
860 }
861 #endif
862
863 /* br_vlan.c */
864 #ifdef CONFIG_BRIDGE_VLAN_FILTERING
865 bool br_allowed_ingress(const struct net_bridge *br,
866                         struct net_bridge_vlan_group *vg, struct sk_buff *skb,
867                         u16 *vid);
868 bool br_allowed_egress(struct net_bridge_vlan_group *vg,
869                        const struct sk_buff *skb);
870 bool br_should_learn(struct net_bridge_port *p, struct sk_buff *skb, u16 *vid);
871 struct sk_buff *br_handle_vlan(struct net_bridge *br,
872                                const struct net_bridge_port *port,
873                                struct net_bridge_vlan_group *vg,
874                                struct sk_buff *skb);
875 int br_vlan_add(struct net_bridge *br, u16 vid, u16 flags,
876                 bool *changed, struct netlink_ext_ack *extack);
877 int br_vlan_delete(struct net_bridge *br, u16 vid);
878 void br_vlan_flush(struct net_bridge *br);
879 struct net_bridge_vlan *br_vlan_find(struct net_bridge_vlan_group *vg, u16 vid);
880 void br_recalculate_fwd_mask(struct net_bridge *br);
881 int __br_vlan_filter_toggle(struct net_bridge *br, unsigned long val);
882 int br_vlan_filter_toggle(struct net_bridge *br, unsigned long val);
883 int __br_vlan_set_proto(struct net_bridge *br, __be16 proto);
884 int br_vlan_set_proto(struct net_bridge *br, unsigned long val);
885 int br_vlan_set_stats(struct net_bridge *br, unsigned long val);
886 int br_vlan_set_stats_per_port(struct net_bridge *br, unsigned long val);
887 int br_vlan_init(struct net_bridge *br);
888 int br_vlan_set_default_pvid(struct net_bridge *br, unsigned long val);
889 int __br_vlan_set_default_pvid(struct net_bridge *br, u16 pvid,
890                                struct netlink_ext_ack *extack);
891 int nbp_vlan_add(struct net_bridge_port *port, u16 vid, u16 flags,
892                  bool *changed, struct netlink_ext_ack *extack);
893 int nbp_vlan_delete(struct net_bridge_port *port, u16 vid);
894 void nbp_vlan_flush(struct net_bridge_port *port);
895 int nbp_vlan_init(struct net_bridge_port *port, struct netlink_ext_ack *extack);
896 int nbp_get_num_vlan_infos(struct net_bridge_port *p, u32 filter_mask);
897 void br_vlan_get_stats(const struct net_bridge_vlan *v,
898                        struct br_vlan_stats *stats);
899
900 static inline struct net_bridge_vlan_group *br_vlan_group(
901                                         const struct net_bridge *br)
902 {
903         return rtnl_dereference(br->vlgrp);
904 }
905
906 static inline struct net_bridge_vlan_group *nbp_vlan_group(
907                                         const struct net_bridge_port *p)
908 {
909         return rtnl_dereference(p->vlgrp);
910 }
911
912 static inline struct net_bridge_vlan_group *br_vlan_group_rcu(
913                                         const struct net_bridge *br)
914 {
915         return rcu_dereference(br->vlgrp);
916 }
917
918 static inline struct net_bridge_vlan_group *nbp_vlan_group_rcu(
919                                         const struct net_bridge_port *p)
920 {
921         return rcu_dereference(p->vlgrp);
922 }
923
924 /* Since bridge now depends on 8021Q module, but the time bridge sees the
925  * skb, the vlan tag will always be present if the frame was tagged.
926  */
927 static inline int br_vlan_get_tag(const struct sk_buff *skb, u16 *vid)
928 {
929         int err = 0;
930
931         if (skb_vlan_tag_present(skb)) {
932                 *vid = skb_vlan_tag_get_id(skb);
933         } else {
934                 *vid = 0;
935                 err = -EINVAL;
936         }
937
938         return err;
939 }
940
941 static inline u16 br_get_pvid(const struct net_bridge_vlan_group *vg)
942 {
943         if (!vg)
944                 return 0;
945
946         smp_rmb();
947         return vg->pvid;
948 }
949
950 #else
951 static inline bool br_allowed_ingress(const struct net_bridge *br,
952                                       struct net_bridge_vlan_group *vg,
953                                       struct sk_buff *skb,
954                                       u16 *vid)
955 {
956         return true;
957 }
958
959 static inline bool br_allowed_egress(struct net_bridge_vlan_group *vg,
960                                      const struct sk_buff *skb)
961 {
962         return true;
963 }
964
965 static inline bool br_should_learn(struct net_bridge_port *p,
966                                    struct sk_buff *skb, u16 *vid)
967 {
968         return true;
969 }
970
971 static inline struct sk_buff *br_handle_vlan(struct net_bridge *br,
972                                              const struct net_bridge_port *port,
973                                              struct net_bridge_vlan_group *vg,
974                                              struct sk_buff *skb)
975 {
976         return skb;
977 }
978
979 static inline int br_vlan_add(struct net_bridge *br, u16 vid, u16 flags,
980                               bool *changed, struct netlink_ext_ack *extack)
981 {
982         *changed = false;
983         return -EOPNOTSUPP;
984 }
985
986 static inline int br_vlan_delete(struct net_bridge *br, u16 vid)
987 {
988         return -EOPNOTSUPP;
989 }
990
991 static inline void br_vlan_flush(struct net_bridge *br)
992 {
993 }
994
995 static inline void br_recalculate_fwd_mask(struct net_bridge *br)
996 {
997 }
998
999 static inline int br_vlan_init(struct net_bridge *br)
1000 {
1001         return 0;
1002 }
1003
1004 static inline int nbp_vlan_add(struct net_bridge_port *port, u16 vid, u16 flags,
1005                                bool *changed, struct netlink_ext_ack *extack)
1006 {
1007         *changed = false;
1008         return -EOPNOTSUPP;
1009 }
1010
1011 static inline int nbp_vlan_delete(struct net_bridge_port *port, u16 vid)
1012 {
1013         return -EOPNOTSUPP;
1014 }
1015
1016 static inline void nbp_vlan_flush(struct net_bridge_port *port)
1017 {
1018 }
1019
1020 static inline struct net_bridge_vlan *br_vlan_find(struct net_bridge_vlan_group *vg,
1021                                                    u16 vid)
1022 {
1023         return NULL;
1024 }
1025
1026 static inline int nbp_vlan_init(struct net_bridge_port *port,
1027                                 struct netlink_ext_ack *extack)
1028 {
1029         return 0;
1030 }
1031
1032 static inline u16 br_vlan_get_tag(const struct sk_buff *skb, u16 *tag)
1033 {
1034         return 0;
1035 }
1036
1037 static inline u16 br_get_pvid(const struct net_bridge_vlan_group *vg)
1038 {
1039         return 0;
1040 }
1041
1042 static inline int __br_vlan_filter_toggle(struct net_bridge *br,
1043                                           unsigned long val)
1044 {
1045         return -EOPNOTSUPP;
1046 }
1047
1048 static inline int nbp_get_num_vlan_infos(struct net_bridge_port *p,
1049                                          u32 filter_mask)
1050 {
1051         return 0;
1052 }
1053
1054 static inline struct net_bridge_vlan_group *br_vlan_group(
1055                                         const struct net_bridge *br)
1056 {
1057         return NULL;
1058 }
1059
1060 static inline struct net_bridge_vlan_group *nbp_vlan_group(
1061                                         const struct net_bridge_port *p)
1062 {
1063         return NULL;
1064 }
1065
1066 static inline struct net_bridge_vlan_group *br_vlan_group_rcu(
1067                                         const struct net_bridge *br)
1068 {
1069         return NULL;
1070 }
1071
1072 static inline struct net_bridge_vlan_group *nbp_vlan_group_rcu(
1073                                         const struct net_bridge_port *p)
1074 {
1075         return NULL;
1076 }
1077
1078 static inline void br_vlan_get_stats(const struct net_bridge_vlan *v,
1079                                      struct br_vlan_stats *stats)
1080 {
1081 }
1082 #endif
1083
1084 struct nf_br_ops {
1085         int (*br_dev_xmit_hook)(struct sk_buff *skb);
1086 };
1087 extern const struct nf_br_ops __rcu *nf_br_ops;
1088
1089 /* br_netfilter.c */
1090 #if IS_ENABLED(CONFIG_BRIDGE_NETFILTER)
1091 int br_nf_core_init(void);
1092 void br_nf_core_fini(void);
1093 void br_netfilter_rtable_init(struct net_bridge *);
1094 #else
1095 static inline int br_nf_core_init(void) { return 0; }
1096 static inline void br_nf_core_fini(void) {}
1097 #define br_netfilter_rtable_init(x)
1098 #endif
1099
1100 /* br_stp.c */
1101 void br_set_state(struct net_bridge_port *p, unsigned int state);
1102 struct net_bridge_port *br_get_port(struct net_bridge *br, u16 port_no);
1103 void br_init_port(struct net_bridge_port *p);
1104 void br_become_designated_port(struct net_bridge_port *p);
1105
1106 void __br_set_forward_delay(struct net_bridge *br, unsigned long t);
1107 int br_set_forward_delay(struct net_bridge *br, unsigned long x);
1108 int br_set_hello_time(struct net_bridge *br, unsigned long x);
1109 int br_set_max_age(struct net_bridge *br, unsigned long x);
1110 int __set_ageing_time(struct net_device *dev, unsigned long t);
1111 int br_set_ageing_time(struct net_bridge *br, clock_t ageing_time);
1112
1113
1114 /* br_stp_if.c */
1115 void br_stp_enable_bridge(struct net_bridge *br);
1116 void br_stp_disable_bridge(struct net_bridge *br);
1117 void br_stp_set_enabled(struct net_bridge *br, unsigned long val);
1118 void br_stp_enable_port(struct net_bridge_port *p);
1119 void br_stp_disable_port(struct net_bridge_port *p);
1120 bool br_stp_recalculate_bridge_id(struct net_bridge *br);
1121 void br_stp_change_bridge_id(struct net_bridge *br, const unsigned char *a);
1122 void br_stp_set_bridge_priority(struct net_bridge *br, u16 newprio);
1123 int br_stp_set_port_priority(struct net_bridge_port *p, unsigned long newprio);
1124 int br_stp_set_path_cost(struct net_bridge_port *p, unsigned long path_cost);
1125 ssize_t br_show_bridge_id(char *buf, const struct bridge_id *id);
1126
1127 /* br_stp_bpdu.c */
1128 struct stp_proto;
1129 void br_stp_rcv(const struct stp_proto *proto, struct sk_buff *skb,
1130                 struct net_device *dev);
1131
1132 /* br_stp_timer.c */
1133 void br_stp_timer_init(struct net_bridge *br);
1134 void br_stp_port_timer_init(struct net_bridge_port *p);
1135 unsigned long br_timer_value(const struct timer_list *timer);
1136
1137 /* br.c */
1138 #if IS_ENABLED(CONFIG_ATM_LANE)
1139 extern int (*br_fdb_test_addr_hook)(struct net_device *dev, unsigned char *addr);
1140 #endif
1141
1142 /* br_netlink.c */
1143 extern struct rtnl_link_ops br_link_ops;
1144 int br_netlink_init(void);
1145 void br_netlink_fini(void);
1146 void br_ifinfo_notify(int event, const struct net_bridge *br,
1147                       const struct net_bridge_port *port);
1148 int br_setlink(struct net_device *dev, struct nlmsghdr *nlmsg, u16 flags,
1149                struct netlink_ext_ack *extack);
1150 int br_dellink(struct net_device *dev, struct nlmsghdr *nlmsg, u16 flags);
1151 int br_getlink(struct sk_buff *skb, u32 pid, u32 seq, struct net_device *dev,
1152                u32 filter_mask, int nlflags);
1153
1154 #ifdef CONFIG_SYSFS
1155 /* br_sysfs_if.c */
1156 extern const struct sysfs_ops brport_sysfs_ops;
1157 int br_sysfs_addif(struct net_bridge_port *p);
1158 int br_sysfs_renameif(struct net_bridge_port *p);
1159
1160 /* br_sysfs_br.c */
1161 int br_sysfs_addbr(struct net_device *dev);
1162 void br_sysfs_delbr(struct net_device *dev);
1163
1164 #else
1165
1166 static inline int br_sysfs_addif(struct net_bridge_port *p) { return 0; }
1167 static inline int br_sysfs_renameif(struct net_bridge_port *p) { return 0; }
1168 static inline int br_sysfs_addbr(struct net_device *dev) { return 0; }
1169 static inline void br_sysfs_delbr(struct net_device *dev) { return; }
1170 #endif /* CONFIG_SYSFS */
1171
1172 /* br_switchdev.c */
1173 #ifdef CONFIG_NET_SWITCHDEV
1174 int nbp_switchdev_mark_set(struct net_bridge_port *p);
1175 void nbp_switchdev_frame_mark(const struct net_bridge_port *p,
1176                               struct sk_buff *skb);
1177 bool nbp_switchdev_allowed_egress(const struct net_bridge_port *p,
1178                                   const struct sk_buff *skb);
1179 int br_switchdev_set_port_flag(struct net_bridge_port *p,
1180                                unsigned long flags,
1181                                unsigned long mask);
1182 void br_switchdev_fdb_notify(const struct net_bridge_fdb_entry *fdb,
1183                              int type);
1184 int br_switchdev_port_vlan_add(struct net_device *dev, u16 vid, u16 flags,
1185                                struct netlink_ext_ack *extack);
1186 int br_switchdev_port_vlan_del(struct net_device *dev, u16 vid);
1187
1188 static inline void br_switchdev_frame_unmark(struct sk_buff *skb)
1189 {
1190         skb->offload_fwd_mark = 0;
1191 }
1192 #else
1193 static inline int nbp_switchdev_mark_set(struct net_bridge_port *p)
1194 {
1195         return 0;
1196 }
1197
1198 static inline void nbp_switchdev_frame_mark(const struct net_bridge_port *p,
1199                                             struct sk_buff *skb)
1200 {
1201 }
1202
1203 static inline bool nbp_switchdev_allowed_egress(const struct net_bridge_port *p,
1204                                                 const struct sk_buff *skb)
1205 {
1206         return true;
1207 }
1208
1209 static inline int br_switchdev_set_port_flag(struct net_bridge_port *p,
1210                                              unsigned long flags,
1211                                              unsigned long mask)
1212 {
1213         return 0;
1214 }
1215
1216 static inline int br_switchdev_port_vlan_add(struct net_device *dev,
1217                                              u16 vid, u16 flags,
1218                                              struct netlink_ext_ack *extack)
1219 {
1220         return -EOPNOTSUPP;
1221 }
1222
1223 static inline int br_switchdev_port_vlan_del(struct net_device *dev, u16 vid)
1224 {
1225         return -EOPNOTSUPP;
1226 }
1227
1228 static inline void
1229 br_switchdev_fdb_notify(const struct net_bridge_fdb_entry *fdb, int type)
1230 {
1231 }
1232
1233 static inline void br_switchdev_frame_unmark(struct sk_buff *skb)
1234 {
1235 }
1236 #endif /* CONFIG_NET_SWITCHDEV */
1237
1238 /* br_arp_nd_proxy.c */
1239 void br_recalculate_neigh_suppress_enabled(struct net_bridge *br);
1240 void br_do_proxy_suppress_arp(struct sk_buff *skb, struct net_bridge *br,
1241                               u16 vid, struct net_bridge_port *p);
1242 void br_do_suppress_nd(struct sk_buff *skb, struct net_bridge *br,
1243                        u16 vid, struct net_bridge_port *p, struct nd_msg *msg);
1244 struct nd_msg *br_is_nd_neigh_msg(struct sk_buff *skb, struct nd_msg *m);
1245 #endif