1 // SPDX-License-Identifier: GPL-2.0-or-later
4 * Linux ethernet bridge
7 * Lennert Buytenhek <buytenh@gnu.org>
10 #include <linux/module.h>
11 #include <linux/kernel.h>
12 #include <linux/netdevice.h>
13 #include <linux/etherdevice.h>
14 #include <linux/init.h>
15 #include <linux/llc.h>
18 #include <net/switchdev.h>
20 #include "br_private.h"
23 * Handle changes in state of network devices enslaved to a bridge.
25 * Note: don't care about up/down if bridge itself is down, because
26 * port state is checked when bridge is brought up.
28 static int br_device_event(struct notifier_block *unused, unsigned long event, void *ptr)
30 struct netlink_ext_ack *extack = netdev_notifier_info_to_extack(ptr);
31 struct netdev_notifier_pre_changeaddr_info *prechaddr_info;
32 struct net_device *dev = netdev_notifier_info_to_dev(ptr);
33 struct net_bridge_port *p;
34 struct net_bridge *br;
35 bool notified = false;
39 if (dev->priv_flags & IFF_EBRIDGE) {
40 err = br_vlan_bridge_event(dev, event, ptr);
42 return notifier_from_errno(err);
44 if (event == NETDEV_REGISTER) {
45 /* register of bridge completed, add sysfs entries */
46 err = br_sysfs_addbr(dev);
48 return notifier_from_errno(err);
54 /* not a port of a bridge */
55 p = br_port_get_rtnl(dev);
62 case NETDEV_CHANGEMTU:
63 br_mtu_auto_adjust(br);
66 case NETDEV_PRE_CHANGEADDR:
67 if (br->dev->addr_assign_type == NET_ADDR_SET)
70 err = dev_pre_changeaddr_notify(br->dev,
71 prechaddr_info->dev_addr,
74 return notifier_from_errno(err);
77 case NETDEV_CHANGEADDR:
78 spin_lock_bh(&br->lock);
79 br_fdb_changeaddr(p, dev->dev_addr);
80 changed_addr = br_stp_recalculate_bridge_id(br);
81 spin_unlock_bh(&br->lock);
84 call_netdevice_notifiers(NETDEV_CHANGEADDR, br->dev);
89 br_port_carrier_check(p, ¬ified);
92 case NETDEV_FEAT_CHANGE:
93 netdev_update_features(br->dev);
97 spin_lock_bh(&br->lock);
98 if (br->dev->flags & IFF_UP) {
99 br_stp_disable_port(p);
102 spin_unlock_bh(&br->lock);
106 if (netif_running(br->dev) && netif_oper_up(dev)) {
107 spin_lock_bh(&br->lock);
108 br_stp_enable_port(p);
110 spin_unlock_bh(&br->lock);
114 case NETDEV_UNREGISTER:
118 case NETDEV_CHANGENAME:
119 err = br_sysfs_renameif(p);
121 return notifier_from_errno(err);
124 case NETDEV_PRE_TYPE_CHANGE:
125 /* Forbid underlying device to change its type. */
128 case NETDEV_RESEND_IGMP:
129 /* Propagate to master device */
130 call_netdevice_notifiers(event, br->dev);
134 if (event != NETDEV_UNREGISTER)
135 br_vlan_port_event(p, event);
137 /* Events that may cause spanning tree to refresh */
138 if (!notified && (event == NETDEV_CHANGEADDR || event == NETDEV_UP ||
139 event == NETDEV_CHANGE || event == NETDEV_DOWN))
140 br_ifinfo_notify(RTM_NEWLINK, NULL, p);
145 static struct notifier_block br_device_notifier = {
146 .notifier_call = br_device_event
149 /* called with RTNL or RCU */
150 static int br_switchdev_event(struct notifier_block *unused,
151 unsigned long event, void *ptr)
153 struct net_device *dev = switchdev_notifier_info_to_dev(ptr);
154 struct net_bridge_port *p;
155 struct net_bridge *br;
156 struct switchdev_notifier_fdb_info *fdb_info;
157 int err = NOTIFY_DONE;
159 p = br_port_get_rtnl_rcu(dev);
166 case SWITCHDEV_FDB_ADD_TO_BRIDGE:
168 err = br_fdb_external_learn_add(br, p, fdb_info->addr,
169 fdb_info->vid, false);
171 err = notifier_from_errno(err);
174 br_fdb_offloaded_set(br, p, fdb_info->addr,
175 fdb_info->vid, true);
177 case SWITCHDEV_FDB_DEL_TO_BRIDGE:
179 err = br_fdb_external_learn_del(br, p, fdb_info->addr,
180 fdb_info->vid, false);
182 err = notifier_from_errno(err);
184 case SWITCHDEV_FDB_OFFLOADED:
186 br_fdb_offloaded_set(br, p, fdb_info->addr,
187 fdb_info->vid, fdb_info->offloaded);
189 case SWITCHDEV_FDB_FLUSH_TO_BRIDGE:
191 /* Don't delete static entries */
192 br_fdb_delete_by_port(br, p, fdb_info->vid, 0);
200 static struct notifier_block br_switchdev_notifier = {
201 .notifier_call = br_switchdev_event,
204 /* br_boolopt_toggle - change user-controlled boolean option
207 * @opt: id of the option to change
208 * @on: new option value
209 * @extack: extack for error messages
211 * Changes the value of the respective boolean option to @on taking care of
212 * any internal option value mapping and configuration.
214 int br_boolopt_toggle(struct net_bridge *br, enum br_boolopt_id opt, bool on,
215 struct netlink_ext_ack *extack)
218 case BR_BOOLOPT_NO_LL_LEARN:
219 br_opt_toggle(br, BROPT_NO_LL_LEARN, on);
222 /* shouldn't be called with unsupported options */
230 int br_boolopt_get(const struct net_bridge *br, enum br_boolopt_id opt)
233 case BR_BOOLOPT_NO_LL_LEARN:
234 return br_opt_get(br, BROPT_NO_LL_LEARN);
236 /* shouldn't be called with unsupported options */
244 int br_boolopt_multi_toggle(struct net_bridge *br,
245 struct br_boolopt_multi *bm,
246 struct netlink_ext_ack *extack)
248 unsigned long bitmap = bm->optmask;
252 for_each_set_bit(opt_id, &bitmap, BR_BOOLOPT_MAX) {
253 bool on = !!(bm->optval & BIT(opt_id));
255 err = br_boolopt_toggle(br, opt_id, on, extack);
257 br_debug(br, "boolopt multi-toggle error: option: %d current: %d new: %d error: %d\n",
258 opt_id, br_boolopt_get(br, opt_id), on, err);
266 void br_boolopt_multi_get(const struct net_bridge *br,
267 struct br_boolopt_multi *bm)
272 for (opt_id = 0; opt_id < BR_BOOLOPT_MAX; opt_id++)
273 optval |= (br_boolopt_get(br, opt_id) << opt_id);
276 bm->optmask = GENMASK((BR_BOOLOPT_MAX - 1), 0);
279 /* private bridge options, controlled by the kernel */
280 void br_opt_toggle(struct net_bridge *br, enum net_bridge_opts opt, bool on)
282 bool cur = !!br_opt_get(br, opt);
284 br_debug(br, "toggle option: %d state: %d -> %d\n",
291 set_bit(opt, &br->options);
293 clear_bit(opt, &br->options);
296 static void __net_exit br_net_exit(struct net *net)
298 struct net_device *dev;
302 for_each_netdev(net, dev)
303 if (dev->priv_flags & IFF_EBRIDGE)
304 br_dev_delete(dev, &list);
306 unregister_netdevice_many(&list);
311 static struct pernet_operations br_net_ops = {
315 static const struct stp_proto br_stp_proto = {
319 static int __init br_init(void)
323 BUILD_BUG_ON(sizeof(struct br_input_skb_cb) > sizeof_field(struct sk_buff, cb));
325 err = stp_proto_register(&br_stp_proto);
327 pr_err("bridge: can't register sap for STP\n");
335 err = register_pernet_subsys(&br_net_ops);
339 err = br_nf_core_init();
343 err = register_netdevice_notifier(&br_device_notifier);
347 err = register_switchdev_notifier(&br_switchdev_notifier);
351 err = br_netlink_init();
355 brioctl_set(br_ioctl_deviceless_stub);
357 #if IS_ENABLED(CONFIG_ATM_LANE)
358 br_fdb_test_addr_hook = br_fdb_test_addr;
361 #if IS_MODULE(CONFIG_BRIDGE_NETFILTER)
362 pr_info("bridge: filtering via arp/ip/ip6tables is no longer available "
363 "by default. Update your scripts to load br_netfilter if you "
370 unregister_switchdev_notifier(&br_switchdev_notifier);
372 unregister_netdevice_notifier(&br_device_notifier);
376 unregister_pernet_subsys(&br_net_ops);
380 stp_proto_unregister(&br_stp_proto);
384 static void __exit br_deinit(void)
386 stp_proto_unregister(&br_stp_proto);
388 unregister_switchdev_notifier(&br_switchdev_notifier);
389 unregister_netdevice_notifier(&br_device_notifier);
391 unregister_pernet_subsys(&br_net_ops);
393 rcu_barrier(); /* Wait for completion of call_rcu()'s */
396 #if IS_ENABLED(CONFIG_ATM_LANE)
397 br_fdb_test_addr_hook = NULL;
403 module_exit(br_deinit)
404 MODULE_LICENSE("GPL");
405 MODULE_VERSION(BR_VERSION);
406 MODULE_ALIAS_RTNL_LINK("bridge");