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
);
354 static int __switchdev_port_obj_add(struct net_device
*dev
,
355 const struct switchdev_obj
*obj
,
356 struct switchdev_trans
*trans
)
358 const struct switchdev_ops
*ops
= dev
->switchdev_ops
;
359 struct net_device
*lower_dev
;
360 struct list_head
*iter
;
361 int err
= -EOPNOTSUPP
;
363 if (ops
&& ops
->switchdev_port_obj_add
)
364 return ops
->switchdev_port_obj_add(dev
, obj
, trans
);
366 /* Switch device port(s) may be stacked under
367 * bond/team/vlan dev, so recurse down to add object on
371 netdev_for_each_lower_dev(dev
, lower_dev
, iter
) {
372 err
= __switchdev_port_obj_add(lower_dev
, obj
, trans
);
380 static int switchdev_port_obj_add_now(struct net_device
*dev
,
381 const struct switchdev_obj
*obj
)
383 struct switchdev_trans trans
;
388 switchdev_trans_init(&trans
);
390 /* Phase I: prepare for obj add. Driver/device should fail
391 * here if there are going to be issues in the commit phase,
392 * such as lack of resources or support. The driver/device
393 * should reserve resources needed for the commit phase here,
394 * but should not commit the obj.
397 trans
.ph_prepare
= true;
398 err
= __switchdev_port_obj_add(dev
, obj
, &trans
);
400 /* Prepare phase failed: abort the transaction. Any
401 * resources reserved in the prepare phase are
405 if (err
!= -EOPNOTSUPP
)
406 switchdev_trans_items_destroy(&trans
);
411 /* Phase II: commit obj add. This cannot fail as a fault
412 * of driver/device. If it does, it's a bug in the driver/device
413 * because the driver said everythings was OK in phase I.
416 trans
.ph_prepare
= false;
417 err
= __switchdev_port_obj_add(dev
, obj
, &trans
);
418 WARN(err
, "%s: Commit of object (id=%d) failed.\n", dev
->name
, obj
->id
);
419 switchdev_trans_items_warn_destroy(dev
, &trans
);
424 static void switchdev_port_obj_add_deferred(struct net_device
*dev
,
427 const struct switchdev_obj
*obj
= data
;
430 err
= switchdev_port_obj_add_now(dev
, obj
);
431 if (err
&& err
!= -EOPNOTSUPP
)
432 netdev_err(dev
, "failed (err=%d) to add object (id=%d)\n",
435 obj
->complete(dev
, err
, obj
->complete_priv
);
438 static int switchdev_port_obj_add_defer(struct net_device
*dev
,
439 const struct switchdev_obj
*obj
)
441 return switchdev_deferred_enqueue(dev
, obj
, switchdev_obj_size(obj
),
442 switchdev_port_obj_add_deferred
);
446 * switchdev_port_obj_add - Add port object
450 * @obj: object to add
452 * Use a 2-phase prepare-commit transaction model to ensure
453 * system is not left in a partially updated state due to
454 * failure from driver/device.
456 * rtnl_lock must be held and must not be in atomic section,
457 * in case SWITCHDEV_F_DEFER flag is not set.
459 int switchdev_port_obj_add(struct net_device
*dev
,
460 const struct switchdev_obj
*obj
)
462 if (obj
->flags
& SWITCHDEV_F_DEFER
)
463 return switchdev_port_obj_add_defer(dev
, obj
);
465 return switchdev_port_obj_add_now(dev
, obj
);
467 EXPORT_SYMBOL_GPL(switchdev_port_obj_add
);
469 static int switchdev_port_obj_del_now(struct net_device
*dev
,
470 const struct switchdev_obj
*obj
)
472 const struct switchdev_ops
*ops
= dev
->switchdev_ops
;
473 struct net_device
*lower_dev
;
474 struct list_head
*iter
;
475 int err
= -EOPNOTSUPP
;
477 if (ops
&& ops
->switchdev_port_obj_del
)
478 return ops
->switchdev_port_obj_del(dev
, obj
);
480 /* Switch device port(s) may be stacked under
481 * bond/team/vlan dev, so recurse down to delete object on
485 netdev_for_each_lower_dev(dev
, lower_dev
, iter
) {
486 err
= switchdev_port_obj_del_now(lower_dev
, obj
);
494 static void switchdev_port_obj_del_deferred(struct net_device
*dev
,
497 const struct switchdev_obj
*obj
= data
;
500 err
= switchdev_port_obj_del_now(dev
, obj
);
501 if (err
&& err
!= -EOPNOTSUPP
)
502 netdev_err(dev
, "failed (err=%d) to del object (id=%d)\n",
505 obj
->complete(dev
, err
, obj
->complete_priv
);
508 static int switchdev_port_obj_del_defer(struct net_device
*dev
,
509 const struct switchdev_obj
*obj
)
511 return switchdev_deferred_enqueue(dev
, obj
, switchdev_obj_size(obj
),
512 switchdev_port_obj_del_deferred
);
516 * switchdev_port_obj_del - Delete port object
520 * @obj: object to delete
522 * rtnl_lock must be held and must not be in atomic section,
523 * in case SWITCHDEV_F_DEFER flag is not set.
525 int switchdev_port_obj_del(struct net_device
*dev
,
526 const struct switchdev_obj
*obj
)
528 if (obj
->flags
& SWITCHDEV_F_DEFER
)
529 return switchdev_port_obj_del_defer(dev
, obj
);
531 return switchdev_port_obj_del_now(dev
, obj
);
533 EXPORT_SYMBOL_GPL(switchdev_port_obj_del
);
535 static ATOMIC_NOTIFIER_HEAD(switchdev_notif_chain
);
538 * register_switchdev_notifier - Register notifier
539 * @nb: notifier_block
541 * Register switch device notifier.
543 int register_switchdev_notifier(struct notifier_block
*nb
)
545 return atomic_notifier_chain_register(&switchdev_notif_chain
, nb
);
547 EXPORT_SYMBOL_GPL(register_switchdev_notifier
);
550 * unregister_switchdev_notifier - Unregister notifier
551 * @nb: notifier_block
553 * Unregister switch device notifier.
555 int unregister_switchdev_notifier(struct notifier_block
*nb
)
557 return atomic_notifier_chain_unregister(&switchdev_notif_chain
, nb
);
559 EXPORT_SYMBOL_GPL(unregister_switchdev_notifier
);
562 * call_switchdev_notifiers - Call notifiers
563 * @val: value passed unmodified to notifier function
565 * @info: notifier information data
567 * Call all network notifier blocks.
569 int call_switchdev_notifiers(unsigned long val
, struct net_device
*dev
,
570 struct switchdev_notifier_info
*info
)
573 return atomic_notifier_call_chain(&switchdev_notif_chain
, val
, info
);
575 EXPORT_SYMBOL_GPL(call_switchdev_notifiers
);
577 bool switchdev_port_same_parent_id(struct net_device
*a
,
578 struct net_device
*b
)
580 struct switchdev_attr a_attr
= {
582 .id
= SWITCHDEV_ATTR_ID_PORT_PARENT_ID
,
584 struct switchdev_attr b_attr
= {
586 .id
= SWITCHDEV_ATTR_ID_PORT_PARENT_ID
,
589 if (switchdev_port_attr_get(a
, &a_attr
) ||
590 switchdev_port_attr_get(b
, &b_attr
))
593 return netdev_phys_item_id_same(&a_attr
.u
.ppid
, &b_attr
.u
.ppid
);
595 EXPORT_SYMBOL_GPL(switchdev_port_same_parent_id
);