2 * net/switchdev/switchdev.c - Switch device API
3 * Copyright (c) 2014-2015 Jiri Pirko <jiri@resnulli.us>
4 * Copyright (c) 2014-2015 Scott Feldman <sfeldma@gmail.com>
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by
8 * the Free Software Foundation; either version 2 of the License, or
9 * (at your option) any later version.
12 #include <linux/kernel.h>
13 #include <linux/types.h>
14 #include <linux/init.h>
15 #include <linux/mutex.h>
16 #include <linux/notifier.h>
17 #include <linux/netdevice.h>
18 #include <linux/etherdevice.h>
19 #include <linux/if_bridge.h>
20 #include <linux/list.h>
21 #include <linux/workqueue.h>
22 #include <linux/if_vlan.h>
23 #include <linux/rtnetlink.h>
24 #include <net/switchdev.h>
27 * switchdev_trans_item_enqueue - Enqueue data item to transaction queue
30 * @data: pointer to data being queued
31 * @destructor: data destructor
32 * @tritem: transaction item being queued
34 * Enqeueue data item to transaction queue. tritem is typically placed in
35 * cointainter pointed at by data pointer. Destructor is called on
36 * transaction abort and after successful commit phase in case
37 * the caller did not dequeue the item before.
39 void switchdev_trans_item_enqueue(struct switchdev_trans *trans,
40 void *data, void (*destructor)(void const *),
41 struct switchdev_trans_item *tritem)
44 tritem->destructor = destructor;
45 list_add_tail(&tritem->list, &trans->item_list);
47 EXPORT_SYMBOL_GPL(switchdev_trans_item_enqueue);
49 static struct switchdev_trans_item *
50 __switchdev_trans_item_dequeue(struct switchdev_trans *trans)
52 struct switchdev_trans_item *tritem;
54 if (list_empty(&trans->item_list))
56 tritem = list_first_entry(&trans->item_list,
57 struct switchdev_trans_item, list);
58 list_del(&tritem->list);
63 * switchdev_trans_item_dequeue - Dequeue data item from transaction queue
67 void *switchdev_trans_item_dequeue(struct switchdev_trans *trans)
69 struct switchdev_trans_item *tritem;
71 tritem = __switchdev_trans_item_dequeue(trans);
75 EXPORT_SYMBOL_GPL(switchdev_trans_item_dequeue);
77 static void switchdev_trans_init(struct switchdev_trans *trans)
79 INIT_LIST_HEAD(&trans->item_list);
82 static void switchdev_trans_items_destroy(struct switchdev_trans *trans)
84 struct switchdev_trans_item *tritem;
86 while ((tritem = __switchdev_trans_item_dequeue(trans)))
87 tritem->destructor(tritem->data);
90 static void switchdev_trans_items_warn_destroy(struct net_device *dev,
91 struct switchdev_trans *trans)
93 WARN(!list_empty(&trans->item_list), "%s: transaction item queue is not empty.\n",
95 switchdev_trans_items_destroy(trans);
98 static LIST_HEAD(deferred);
99 static DEFINE_SPINLOCK(deferred_lock);
101 typedef void switchdev_deferred_func_t(struct net_device *dev,
104 struct switchdev_deferred_item {
105 struct list_head list;
106 struct net_device *dev;
107 switchdev_deferred_func_t *func;
108 unsigned long data[0];
111 static struct switchdev_deferred_item *switchdev_deferred_dequeue(void)
113 struct switchdev_deferred_item *dfitem;
115 spin_lock_bh(&deferred_lock);
116 if (list_empty(&deferred)) {
120 dfitem = list_first_entry(&deferred,
121 struct switchdev_deferred_item, list);
122 list_del(&dfitem->list);
124 spin_unlock_bh(&deferred_lock);
129 * switchdev_deferred_process - Process ops in deferred queue
131 * Called to flush the ops currently queued in deferred ops queue.
132 * rtnl_lock must be held.
134 void switchdev_deferred_process(void)
136 struct switchdev_deferred_item *dfitem;
140 while ((dfitem = switchdev_deferred_dequeue())) {
141 dfitem->func(dfitem->dev, dfitem->data);
142 dev_put(dfitem->dev);
146 EXPORT_SYMBOL_GPL(switchdev_deferred_process);
148 static void switchdev_deferred_process_work(struct work_struct *work)
151 switchdev_deferred_process();
155 static DECLARE_WORK(deferred_process_work, switchdev_deferred_process_work);
157 static int switchdev_deferred_enqueue(struct net_device *dev,
158 const void *data, size_t data_len,
159 switchdev_deferred_func_t *func)
161 struct switchdev_deferred_item *dfitem;
163 dfitem = kmalloc(sizeof(*dfitem) + data_len, GFP_ATOMIC);
168 memcpy(dfitem->data, data, data_len);
170 spin_lock_bh(&deferred_lock);
171 list_add_tail(&dfitem->list, &deferred);
172 spin_unlock_bh(&deferred_lock);
173 schedule_work(&deferred_process_work);
178 * switchdev_port_attr_get - Get port attribute
181 * @attr: attribute to get
183 int switchdev_port_attr_get(struct net_device *dev, struct switchdev_attr *attr)
185 const struct switchdev_ops *ops = dev->switchdev_ops;
186 struct net_device *lower_dev;
187 struct list_head *iter;
188 struct switchdev_attr first = {
189 .id = SWITCHDEV_ATTR_ID_UNDEFINED
191 int err = -EOPNOTSUPP;
193 if (ops && ops->switchdev_port_attr_get)
194 return ops->switchdev_port_attr_get(dev, attr);
196 if (attr->flags & SWITCHDEV_F_NO_RECURSE)
199 /* Switch device port(s) may be stacked under
200 * bond/team/vlan dev, so recurse down to get attr on
201 * each port. Return -ENODATA if attr values don't
202 * compare across ports.
205 netdev_for_each_lower_dev(dev, lower_dev, iter) {
206 err = switchdev_port_attr_get(lower_dev, attr);
209 if (first.id == SWITCHDEV_ATTR_ID_UNDEFINED)
211 else if (memcmp(&first, attr, sizeof(*attr)))
217 EXPORT_SYMBOL_GPL(switchdev_port_attr_get);
219 static int __switchdev_port_attr_set(struct net_device *dev,
220 const struct switchdev_attr *attr,
221 struct switchdev_trans *trans)
223 const struct switchdev_ops *ops = dev->switchdev_ops;
224 struct net_device *lower_dev;
225 struct list_head *iter;
226 int err = -EOPNOTSUPP;
228 if (ops && ops->switchdev_port_attr_set) {
229 err = ops->switchdev_port_attr_set(dev, attr, trans);
233 if (attr->flags & SWITCHDEV_F_NO_RECURSE)
236 /* Switch device port(s) may be stacked under
237 * bond/team/vlan dev, so recurse down to set attr on
241 netdev_for_each_lower_dev(dev, lower_dev, iter) {
242 err = __switchdev_port_attr_set(lower_dev, attr, trans);
248 if (err == -EOPNOTSUPP && attr->flags & SWITCHDEV_F_SKIP_EOPNOTSUPP)
254 static int switchdev_port_attr_set_now(struct net_device *dev,
255 const struct switchdev_attr *attr)
257 struct switchdev_trans trans;
260 switchdev_trans_init(&trans);
262 /* Phase I: prepare for attr set. Driver/device should fail
263 * here if there are going to be issues in the commit phase,
264 * such as lack of resources or support. The driver/device
265 * should reserve resources needed for the commit phase here,
266 * but should not commit the attr.
269 trans.ph_prepare = true;
270 err = __switchdev_port_attr_set(dev, attr, &trans);
272 /* Prepare phase failed: abort the transaction. Any
273 * resources reserved in the prepare phase are
277 if (err != -EOPNOTSUPP)
278 switchdev_trans_items_destroy(&trans);
283 /* Phase II: commit attr set. This cannot fail as a fault
284 * of driver/device. If it does, it's a bug in the driver/device
285 * because the driver said everythings was OK in phase I.
288 trans.ph_prepare = false;
289 err = __switchdev_port_attr_set(dev, attr, &trans);
290 WARN(err, "%s: Commit of attribute (id=%d) failed.\n",
291 dev->name, attr->id);
292 switchdev_trans_items_warn_destroy(dev, &trans);
297 static void switchdev_port_attr_set_deferred(struct net_device *dev,
300 const struct switchdev_attr *attr = data;
303 err = switchdev_port_attr_set_now(dev, attr);
304 if (err && err != -EOPNOTSUPP)
305 netdev_err(dev, "failed (err=%d) to set attribute (id=%d)\n",
308 attr->complete(dev, err, attr->complete_priv);
311 static int switchdev_port_attr_set_defer(struct net_device *dev,
312 const struct switchdev_attr *attr)
314 return switchdev_deferred_enqueue(dev, attr, sizeof(*attr),
315 switchdev_port_attr_set_deferred);
319 * switchdev_port_attr_set - Set port attribute
322 * @attr: attribute to set
324 * Use a 2-phase prepare-commit transaction model to ensure
325 * system is not left in a partially updated state due to
326 * failure from driver/device.
328 * rtnl_lock must be held and must not be in atomic section,
329 * in case SWITCHDEV_F_DEFER flag is not set.
331 int switchdev_port_attr_set(struct net_device *dev,
332 const struct switchdev_attr *attr)
334 if (attr->flags & SWITCHDEV_F_DEFER)
335 return switchdev_port_attr_set_defer(dev, attr);
337 return switchdev_port_attr_set_now(dev, attr);
339 EXPORT_SYMBOL_GPL(switchdev_port_attr_set);
341 static size_t switchdev_obj_size(const struct switchdev_obj *obj)
344 case SWITCHDEV_OBJ_ID_PORT_VLAN:
345 return sizeof(struct switchdev_obj_port_vlan);
346 case SWITCHDEV_OBJ_ID_PORT_MDB:
347 return sizeof(struct switchdev_obj_port_mdb);
348 case SWITCHDEV_OBJ_ID_HOST_MDB:
349 return sizeof(struct switchdev_obj_port_mdb);
356 static int __switchdev_port_obj_add(struct net_device *dev,
357 const struct switchdev_obj *obj,
358 struct switchdev_trans *trans)
360 const struct switchdev_ops *ops = dev->switchdev_ops;
361 struct net_device *lower_dev;
362 struct list_head *iter;
363 int err = -EOPNOTSUPP;
365 if (ops && ops->switchdev_port_obj_add)
366 return ops->switchdev_port_obj_add(dev, obj, trans);
368 /* Switch device port(s) may be stacked under
369 * bond/team/vlan dev, so recurse down to add object on
373 netdev_for_each_lower_dev(dev, lower_dev, iter) {
374 err = __switchdev_port_obj_add(lower_dev, obj, trans);
382 static int switchdev_port_obj_add_now(struct net_device *dev,
383 const struct switchdev_obj *obj)
385 struct switchdev_trans trans;
390 switchdev_trans_init(&trans);
392 /* Phase I: prepare for obj add. Driver/device should fail
393 * here if there are going to be issues in the commit phase,
394 * such as lack of resources or support. The driver/device
395 * should reserve resources needed for the commit phase here,
396 * but should not commit the obj.
399 trans.ph_prepare = true;
400 err = __switchdev_port_obj_add(dev, obj, &trans);
402 /* Prepare phase failed: abort the transaction. Any
403 * resources reserved in the prepare phase are
407 if (err != -EOPNOTSUPP)
408 switchdev_trans_items_destroy(&trans);
413 /* Phase II: commit obj add. This cannot fail as a fault
414 * of driver/device. If it does, it's a bug in the driver/device
415 * because the driver said everythings was OK in phase I.
418 trans.ph_prepare = false;
419 err = __switchdev_port_obj_add(dev, obj, &trans);
420 WARN(err, "%s: Commit of object (id=%d) failed.\n", dev->name, obj->id);
421 switchdev_trans_items_warn_destroy(dev, &trans);
426 static void switchdev_port_obj_add_deferred(struct net_device *dev,
429 const struct switchdev_obj *obj = data;
432 err = switchdev_port_obj_add_now(dev, obj);
433 if (err && err != -EOPNOTSUPP)
434 netdev_err(dev, "failed (err=%d) to add object (id=%d)\n",
437 obj->complete(dev, err, obj->complete_priv);
440 static int switchdev_port_obj_add_defer(struct net_device *dev,
441 const struct switchdev_obj *obj)
443 return switchdev_deferred_enqueue(dev, obj, switchdev_obj_size(obj),
444 switchdev_port_obj_add_deferred);
448 * switchdev_port_obj_add - Add port object
452 * @obj: object to add
454 * Use a 2-phase prepare-commit transaction model to ensure
455 * system is not left in a partially updated state due to
456 * failure from driver/device.
458 * rtnl_lock must be held and must not be in atomic section,
459 * in case SWITCHDEV_F_DEFER flag is not set.
461 int switchdev_port_obj_add(struct net_device *dev,
462 const struct switchdev_obj *obj)
464 if (obj->flags & SWITCHDEV_F_DEFER)
465 return switchdev_port_obj_add_defer(dev, obj);
467 return switchdev_port_obj_add_now(dev, obj);
469 EXPORT_SYMBOL_GPL(switchdev_port_obj_add);
471 static int switchdev_port_obj_del_now(struct net_device *dev,
472 const struct switchdev_obj *obj)
474 const struct switchdev_ops *ops = dev->switchdev_ops;
475 struct net_device *lower_dev;
476 struct list_head *iter;
477 int err = -EOPNOTSUPP;
479 if (ops && ops->switchdev_port_obj_del)
480 return ops->switchdev_port_obj_del(dev, obj);
482 /* Switch device port(s) may be stacked under
483 * bond/team/vlan dev, so recurse down to delete object on
487 netdev_for_each_lower_dev(dev, lower_dev, iter) {
488 err = switchdev_port_obj_del_now(lower_dev, obj);
496 static void switchdev_port_obj_del_deferred(struct net_device *dev,
499 const struct switchdev_obj *obj = data;
502 err = switchdev_port_obj_del_now(dev, obj);
503 if (err && err != -EOPNOTSUPP)
504 netdev_err(dev, "failed (err=%d) to del object (id=%d)\n",
507 obj->complete(dev, err, obj->complete_priv);
510 static int switchdev_port_obj_del_defer(struct net_device *dev,
511 const struct switchdev_obj *obj)
513 return switchdev_deferred_enqueue(dev, obj, switchdev_obj_size(obj),
514 switchdev_port_obj_del_deferred);
518 * switchdev_port_obj_del - Delete port object
522 * @obj: object to delete
524 * rtnl_lock must be held and must not be in atomic section,
525 * in case SWITCHDEV_F_DEFER flag is not set.
527 int switchdev_port_obj_del(struct net_device *dev,
528 const struct switchdev_obj *obj)
530 if (obj->flags & SWITCHDEV_F_DEFER)
531 return switchdev_port_obj_del_defer(dev, obj);
533 return switchdev_port_obj_del_now(dev, obj);
535 EXPORT_SYMBOL_GPL(switchdev_port_obj_del);
537 static ATOMIC_NOTIFIER_HEAD(switchdev_notif_chain);
540 * register_switchdev_notifier - Register notifier
541 * @nb: notifier_block
543 * Register switch device notifier.
545 int register_switchdev_notifier(struct notifier_block *nb)
547 return atomic_notifier_chain_register(&switchdev_notif_chain, nb);
549 EXPORT_SYMBOL_GPL(register_switchdev_notifier);
552 * unregister_switchdev_notifier - Unregister notifier
553 * @nb: notifier_block
555 * Unregister switch device notifier.
557 int unregister_switchdev_notifier(struct notifier_block *nb)
559 return atomic_notifier_chain_unregister(&switchdev_notif_chain, nb);
561 EXPORT_SYMBOL_GPL(unregister_switchdev_notifier);
564 * call_switchdev_notifiers - Call notifiers
565 * @val: value passed unmodified to notifier function
567 * @info: notifier information data
569 * Call all network notifier blocks.
571 int call_switchdev_notifiers(unsigned long val, struct net_device *dev,
572 struct switchdev_notifier_info *info)
575 return atomic_notifier_call_chain(&switchdev_notif_chain, val, info);
577 EXPORT_SYMBOL_GPL(call_switchdev_notifiers);
579 bool switchdev_port_same_parent_id(struct net_device *a,
580 struct net_device *b)
582 struct switchdev_attr a_attr = {
584 .id = SWITCHDEV_ATTR_ID_PORT_PARENT_ID,
586 struct switchdev_attr b_attr = {
588 .id = SWITCHDEV_ATTR_ID_PORT_PARENT_ID,
591 if (switchdev_port_attr_get(a, &a_attr) ||
592 switchdev_port_attr_get(b, &b_attr))
595 return netdev_phys_item_id_same(&a_attr.u.ppid, &b_attr.u.ppid);
597 EXPORT_SYMBOL_GPL(switchdev_port_same_parent_id);