2 * net/core/dev_addr_lists.c - Functions for handling net device lists
3 * Copyright (c) 2010 Jiri Pirko <jpirko@redhat.com>
5 * This file contains functions for working with unicast, multicast and device
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License as published by
10 * the Free Software Foundation; either version 2 of the License, or
11 * (at your option) any later version.
14 #include <linux/netdevice.h>
15 #include <linux/rtnetlink.h>
16 #include <linux/export.h>
17 #include <linux/list.h>
18 #include <linux/proc_fs.h>
21 * General list handling functions
24 static int __hw_addr_add_ex(struct netdev_hw_addr_list
*list
,
25 unsigned char *addr
, int addr_len
,
26 unsigned char addr_type
, bool global
)
28 struct netdev_hw_addr
*ha
;
31 if (addr_len
> MAX_ADDR_LEN
)
34 list_for_each_entry(ha
, &list
->list
, list
) {
35 if (!memcmp(ha
->addr
, addr
, addr_len
) &&
36 ha
->type
== addr_type
) {
38 /* check if addr is already used as global */
42 ha
->global_use
= true;
50 alloc_size
= sizeof(*ha
);
51 if (alloc_size
< L1_CACHE_BYTES
)
52 alloc_size
= L1_CACHE_BYTES
;
53 ha
= kmalloc(alloc_size
, GFP_ATOMIC
);
56 memcpy(ha
->addr
, addr
, addr_len
);
59 ha
->global_use
= global
;
61 list_add_tail_rcu(&ha
->list
, &list
->list
);
66 static int __hw_addr_add(struct netdev_hw_addr_list
*list
, unsigned char *addr
,
67 int addr_len
, unsigned char addr_type
)
69 return __hw_addr_add_ex(list
, addr
, addr_len
, addr_type
, false);
72 static int __hw_addr_del_ex(struct netdev_hw_addr_list
*list
,
73 unsigned char *addr
, int addr_len
,
74 unsigned char addr_type
, bool global
)
76 struct netdev_hw_addr
*ha
;
78 list_for_each_entry(ha
, &list
->list
, list
) {
79 if (!memcmp(ha
->addr
, addr
, addr_len
) &&
80 (ha
->type
== addr_type
|| !addr_type
)) {
85 ha
->global_use
= false;
89 list_del_rcu(&ha
->list
);
90 kfree_rcu(ha
, rcu_head
);
98 static int __hw_addr_del(struct netdev_hw_addr_list
*list
, unsigned char *addr
,
99 int addr_len
, unsigned char addr_type
)
101 return __hw_addr_del_ex(list
, addr
, addr_len
, addr_type
, false);
104 int __hw_addr_add_multiple(struct netdev_hw_addr_list
*to_list
,
105 struct netdev_hw_addr_list
*from_list
,
106 int addr_len
, unsigned char addr_type
)
109 struct netdev_hw_addr
*ha
, *ha2
;
112 list_for_each_entry(ha
, &from_list
->list
, list
) {
113 type
= addr_type
? addr_type
: ha
->type
;
114 err
= __hw_addr_add(to_list
, ha
->addr
, addr_len
, type
);
121 list_for_each_entry(ha2
, &from_list
->list
, list
) {
124 type
= addr_type
? addr_type
: ha2
->type
;
125 __hw_addr_del(to_list
, ha2
->addr
, addr_len
, type
);
129 EXPORT_SYMBOL(__hw_addr_add_multiple
);
131 void __hw_addr_del_multiple(struct netdev_hw_addr_list
*to_list
,
132 struct netdev_hw_addr_list
*from_list
,
133 int addr_len
, unsigned char addr_type
)
135 struct netdev_hw_addr
*ha
;
138 list_for_each_entry(ha
, &from_list
->list
, list
) {
139 type
= addr_type
? addr_type
: ha
->type
;
140 __hw_addr_del(to_list
, ha
->addr
, addr_len
, type
);
143 EXPORT_SYMBOL(__hw_addr_del_multiple
);
145 int __hw_addr_sync(struct netdev_hw_addr_list
*to_list
,
146 struct netdev_hw_addr_list
*from_list
,
150 struct netdev_hw_addr
*ha
, *tmp
;
152 list_for_each_entry_safe(ha
, tmp
, &from_list
->list
, list
) {
154 err
= __hw_addr_add(to_list
, ha
->addr
,
160 } else if (ha
->refcount
== 1) {
161 __hw_addr_del(to_list
, ha
->addr
, addr_len
, ha
->type
);
162 __hw_addr_del(from_list
, ha
->addr
, addr_len
, ha
->type
);
167 EXPORT_SYMBOL(__hw_addr_sync
);
169 void __hw_addr_unsync(struct netdev_hw_addr_list
*to_list
,
170 struct netdev_hw_addr_list
*from_list
,
173 struct netdev_hw_addr
*ha
, *tmp
;
175 list_for_each_entry_safe(ha
, tmp
, &from_list
->list
, list
) {
177 __hw_addr_del(to_list
, ha
->addr
,
180 __hw_addr_del(from_list
, ha
->addr
,
185 EXPORT_SYMBOL(__hw_addr_unsync
);
187 void __hw_addr_flush(struct netdev_hw_addr_list
*list
)
189 struct netdev_hw_addr
*ha
, *tmp
;
191 list_for_each_entry_safe(ha
, tmp
, &list
->list
, list
) {
192 list_del_rcu(&ha
->list
);
193 kfree_rcu(ha
, rcu_head
);
197 EXPORT_SYMBOL(__hw_addr_flush
);
199 void __hw_addr_init(struct netdev_hw_addr_list
*list
)
201 INIT_LIST_HEAD(&list
->list
);
204 EXPORT_SYMBOL(__hw_addr_init
);
207 * Device addresses handling functions
211 * dev_addr_flush - Flush device address list
214 * Flush device address list and reset ->dev_addr.
216 * The caller must hold the rtnl_mutex.
218 void dev_addr_flush(struct net_device
*dev
)
220 /* rtnl_mutex must be held here */
222 __hw_addr_flush(&dev
->dev_addrs
);
223 dev
->dev_addr
= NULL
;
225 EXPORT_SYMBOL(dev_addr_flush
);
228 * dev_addr_init - Init device address list
231 * Init device address list and create the first element,
232 * used by ->dev_addr.
234 * The caller must hold the rtnl_mutex.
236 int dev_addr_init(struct net_device
*dev
)
238 unsigned char addr
[MAX_ADDR_LEN
];
239 struct netdev_hw_addr
*ha
;
242 /* rtnl_mutex must be held here */
244 __hw_addr_init(&dev
->dev_addrs
);
245 memset(addr
, 0, sizeof(addr
));
246 err
= __hw_addr_add(&dev
->dev_addrs
, addr
, sizeof(addr
),
247 NETDEV_HW_ADDR_T_LAN
);
250 * Get the first (previously created) address from the list
251 * and set dev_addr pointer to this location.
253 ha
= list_first_entry(&dev
->dev_addrs
.list
,
254 struct netdev_hw_addr
, list
);
255 dev
->dev_addr
= ha
->addr
;
259 EXPORT_SYMBOL(dev_addr_init
);
262 * dev_addr_add - Add a device address
264 * @addr: address to add
265 * @addr_type: address type
267 * Add a device address to the device or increase the reference count if
270 * The caller must hold the rtnl_mutex.
272 int dev_addr_add(struct net_device
*dev
, unsigned char *addr
,
273 unsigned char addr_type
)
279 err
= __hw_addr_add(&dev
->dev_addrs
, addr
, dev
->addr_len
, addr_type
);
281 call_netdevice_notifiers(NETDEV_CHANGEADDR
, dev
);
284 EXPORT_SYMBOL(dev_addr_add
);
287 * dev_addr_del - Release a device address.
289 * @addr: address to delete
290 * @addr_type: address type
292 * Release reference to a device address and remove it from the device
293 * if the reference count drops to zero.
295 * The caller must hold the rtnl_mutex.
297 int dev_addr_del(struct net_device
*dev
, unsigned char *addr
,
298 unsigned char addr_type
)
301 struct netdev_hw_addr
*ha
;
306 * We can not remove the first address from the list because
307 * dev->dev_addr points to that.
309 ha
= list_first_entry(&dev
->dev_addrs
.list
,
310 struct netdev_hw_addr
, list
);
311 if (!memcmp(ha
->addr
, addr
, dev
->addr_len
) &&
312 ha
->type
== addr_type
&& ha
->refcount
== 1)
315 err
= __hw_addr_del(&dev
->dev_addrs
, addr
, dev
->addr_len
,
318 call_netdevice_notifiers(NETDEV_CHANGEADDR
, dev
);
321 EXPORT_SYMBOL(dev_addr_del
);
324 * dev_addr_add_multiple - Add device addresses from another device
325 * @to_dev: device to which addresses will be added
326 * @from_dev: device from which addresses will be added
327 * @addr_type: address type - 0 means type will be used from from_dev
329 * Add device addresses of the one device to another.
331 * The caller must hold the rtnl_mutex.
333 int dev_addr_add_multiple(struct net_device
*to_dev
,
334 struct net_device
*from_dev
,
335 unsigned char addr_type
)
341 if (from_dev
->addr_len
!= to_dev
->addr_len
)
343 err
= __hw_addr_add_multiple(&to_dev
->dev_addrs
, &from_dev
->dev_addrs
,
344 to_dev
->addr_len
, addr_type
);
346 call_netdevice_notifiers(NETDEV_CHANGEADDR
, to_dev
);
349 EXPORT_SYMBOL(dev_addr_add_multiple
);
352 * dev_addr_del_multiple - Delete device addresses by another device
353 * @to_dev: device where the addresses will be deleted
354 * @from_dev: device supplying the addresses to be deleted
355 * @addr_type: address type - 0 means type will be used from from_dev
357 * Deletes addresses in to device by the list of addresses in from device.
359 * The caller must hold the rtnl_mutex.
361 int dev_addr_del_multiple(struct net_device
*to_dev
,
362 struct net_device
*from_dev
,
363 unsigned char addr_type
)
367 if (from_dev
->addr_len
!= to_dev
->addr_len
)
369 __hw_addr_del_multiple(&to_dev
->dev_addrs
, &from_dev
->dev_addrs
,
370 to_dev
->addr_len
, addr_type
);
371 call_netdevice_notifiers(NETDEV_CHANGEADDR
, to_dev
);
374 EXPORT_SYMBOL(dev_addr_del_multiple
);
377 * Unicast list handling functions
381 * dev_uc_add - Add a secondary unicast address
383 * @addr: address to add
385 * Add a secondary unicast address to the device or increase
386 * the reference count if it already exists.
388 int dev_uc_add(struct net_device
*dev
, unsigned char *addr
)
392 netif_addr_lock_bh(dev
);
393 err
= __hw_addr_add(&dev
->uc
, addr
, dev
->addr_len
,
394 NETDEV_HW_ADDR_T_UNICAST
);
396 __dev_set_rx_mode(dev
);
397 netif_addr_unlock_bh(dev
);
400 EXPORT_SYMBOL(dev_uc_add
);
403 * dev_uc_del - Release secondary unicast address.
405 * @addr: address to delete
407 * Release reference to a secondary unicast address and remove it
408 * from the device if the reference count drops to zero.
410 int dev_uc_del(struct net_device
*dev
, unsigned char *addr
)
414 netif_addr_lock_bh(dev
);
415 err
= __hw_addr_del(&dev
->uc
, addr
, dev
->addr_len
,
416 NETDEV_HW_ADDR_T_UNICAST
);
418 __dev_set_rx_mode(dev
);
419 netif_addr_unlock_bh(dev
);
422 EXPORT_SYMBOL(dev_uc_del
);
425 * dev_uc_sync - Synchronize device's unicast list to another device
426 * @to: destination device
427 * @from: source device
429 * Add newly added addresses to the destination device and release
430 * addresses that have no users left. The source device must be
431 * locked by netif_addr_lock_bh.
433 * This function is intended to be called from the dev->set_rx_mode
434 * function of layered software devices.
436 int dev_uc_sync(struct net_device
*to
, struct net_device
*from
)
440 if (to
->addr_len
!= from
->addr_len
)
443 netif_addr_lock_nested(to
);
444 err
= __hw_addr_sync(&to
->uc
, &from
->uc
, to
->addr_len
);
446 __dev_set_rx_mode(to
);
447 netif_addr_unlock(to
);
450 EXPORT_SYMBOL(dev_uc_sync
);
453 * dev_uc_unsync - Remove synchronized addresses from the destination device
454 * @to: destination device
455 * @from: source device
457 * Remove all addresses that were added to the destination device by
458 * dev_uc_sync(). This function is intended to be called from the
459 * dev->stop function of layered software devices.
461 void dev_uc_unsync(struct net_device
*to
, struct net_device
*from
)
463 if (to
->addr_len
!= from
->addr_len
)
466 netif_addr_lock_bh(from
);
467 netif_addr_lock_nested(to
);
468 __hw_addr_unsync(&to
->uc
, &from
->uc
, to
->addr_len
);
469 __dev_set_rx_mode(to
);
470 netif_addr_unlock(to
);
471 netif_addr_unlock_bh(from
);
473 EXPORT_SYMBOL(dev_uc_unsync
);
476 * dev_uc_flush - Flush unicast addresses
479 * Flush unicast addresses.
481 void dev_uc_flush(struct net_device
*dev
)
483 netif_addr_lock_bh(dev
);
484 __hw_addr_flush(&dev
->uc
);
485 netif_addr_unlock_bh(dev
);
487 EXPORT_SYMBOL(dev_uc_flush
);
490 * dev_uc_flush - Init unicast address list
493 * Init unicast address list.
495 void dev_uc_init(struct net_device
*dev
)
497 __hw_addr_init(&dev
->uc
);
499 EXPORT_SYMBOL(dev_uc_init
);
502 * Multicast list handling functions
505 static int __dev_mc_add(struct net_device
*dev
, unsigned char *addr
,
510 netif_addr_lock_bh(dev
);
511 err
= __hw_addr_add_ex(&dev
->mc
, addr
, dev
->addr_len
,
512 NETDEV_HW_ADDR_T_MULTICAST
, global
);
514 __dev_set_rx_mode(dev
);
515 netif_addr_unlock_bh(dev
);
519 * dev_mc_add - Add a multicast address
521 * @addr: address to add
523 * Add a multicast address to the device or increase
524 * the reference count if it already exists.
526 int dev_mc_add(struct net_device
*dev
, unsigned char *addr
)
528 return __dev_mc_add(dev
, addr
, false);
530 EXPORT_SYMBOL(dev_mc_add
);
533 * dev_mc_add_global - Add a global multicast address
535 * @addr: address to add
537 * Add a global multicast address to the device.
539 int dev_mc_add_global(struct net_device
*dev
, unsigned char *addr
)
541 return __dev_mc_add(dev
, addr
, true);
543 EXPORT_SYMBOL(dev_mc_add_global
);
545 static int __dev_mc_del(struct net_device
*dev
, unsigned char *addr
,
550 netif_addr_lock_bh(dev
);
551 err
= __hw_addr_del_ex(&dev
->mc
, addr
, dev
->addr_len
,
552 NETDEV_HW_ADDR_T_MULTICAST
, global
);
554 __dev_set_rx_mode(dev
);
555 netif_addr_unlock_bh(dev
);
560 * dev_mc_del - Delete a multicast address.
562 * @addr: address to delete
564 * Release reference to a multicast address and remove it
565 * from the device if the reference count drops to zero.
567 int dev_mc_del(struct net_device
*dev
, unsigned char *addr
)
569 return __dev_mc_del(dev
, addr
, false);
571 EXPORT_SYMBOL(dev_mc_del
);
574 * dev_mc_del_global - Delete a global multicast address.
576 * @addr: address to delete
578 * Release reference to a multicast address and remove it
579 * from the device if the reference count drops to zero.
581 int dev_mc_del_global(struct net_device
*dev
, unsigned char *addr
)
583 return __dev_mc_del(dev
, addr
, true);
585 EXPORT_SYMBOL(dev_mc_del_global
);
588 * dev_mc_sync - Synchronize device's unicast list to another device
589 * @to: destination device
590 * @from: source device
592 * Add newly added addresses to the destination device and release
593 * addresses that have no users left. The source device must be
594 * locked by netif_addr_lock_bh.
596 * This function is intended to be called from the ndo_set_rx_mode
597 * function of layered software devices.
599 int dev_mc_sync(struct net_device
*to
, struct net_device
*from
)
603 if (to
->addr_len
!= from
->addr_len
)
606 netif_addr_lock_nested(to
);
607 err
= __hw_addr_sync(&to
->mc
, &from
->mc
, to
->addr_len
);
609 __dev_set_rx_mode(to
);
610 netif_addr_unlock(to
);
613 EXPORT_SYMBOL(dev_mc_sync
);
616 * dev_mc_unsync - Remove synchronized addresses from the destination device
617 * @to: destination device
618 * @from: source device
620 * Remove all addresses that were added to the destination device by
621 * dev_mc_sync(). This function is intended to be called from the
622 * dev->stop function of layered software devices.
624 void dev_mc_unsync(struct net_device
*to
, struct net_device
*from
)
626 if (to
->addr_len
!= from
->addr_len
)
629 netif_addr_lock_bh(from
);
630 netif_addr_lock_nested(to
);
631 __hw_addr_unsync(&to
->mc
, &from
->mc
, to
->addr_len
);
632 __dev_set_rx_mode(to
);
633 netif_addr_unlock(to
);
634 netif_addr_unlock_bh(from
);
636 EXPORT_SYMBOL(dev_mc_unsync
);
639 * dev_mc_flush - Flush multicast addresses
642 * Flush multicast addresses.
644 void dev_mc_flush(struct net_device
*dev
)
646 netif_addr_lock_bh(dev
);
647 __hw_addr_flush(&dev
->mc
);
648 netif_addr_unlock_bh(dev
);
650 EXPORT_SYMBOL(dev_mc_flush
);
653 * dev_mc_flush - Init multicast address list
656 * Init multicast address list.
658 void dev_mc_init(struct net_device
*dev
)
660 __hw_addr_init(&dev
->mc
);
662 EXPORT_SYMBOL(dev_mc_init
);
664 #ifdef CONFIG_PROC_FS
665 #include <linux/seq_file.h>
667 static int dev_mc_seq_show(struct seq_file
*seq
, void *v
)
669 struct netdev_hw_addr
*ha
;
670 struct net_device
*dev
= v
;
672 if (v
== SEQ_START_TOKEN
)
675 netif_addr_lock_bh(dev
);
676 netdev_for_each_mc_addr(ha
, dev
) {
679 seq_printf(seq
, "%-4d %-15s %-5d %-5d ", dev
->ifindex
,
680 dev
->name
, ha
->refcount
, ha
->global_use
);
682 for (i
= 0; i
< dev
->addr_len
; i
++)
683 seq_printf(seq
, "%02x", ha
->addr
[i
]);
687 netif_addr_unlock_bh(dev
);
691 static const struct seq_operations dev_mc_seq_ops
= {
692 .start
= dev_seq_start
,
693 .next
= dev_seq_next
,
694 .stop
= dev_seq_stop
,
695 .show
= dev_mc_seq_show
,
698 static int dev_mc_seq_open(struct inode
*inode
, struct file
*file
)
700 return seq_open_net(inode
, file
, &dev_mc_seq_ops
,
701 sizeof(struct seq_net_private
));
704 static const struct file_operations dev_mc_seq_fops
= {
705 .owner
= THIS_MODULE
,
706 .open
= dev_mc_seq_open
,
709 .release
= seq_release_net
,
714 static int __net_init
dev_mc_net_init(struct net
*net
)
716 if (!proc_net_fops_create(net
, "dev_mcast", 0, &dev_mc_seq_fops
))
721 static void __net_exit
dev_mc_net_exit(struct net
*net
)
723 proc_net_remove(net
, "dev_mcast");
726 static struct pernet_operations __net_initdata dev_mc_net_ops
= {
727 .init
= dev_mc_net_init
,
728 .exit
= dev_mc_net_exit
,
731 void __init
dev_mcast_init(void)
733 register_pernet_subsys(&dev_mc_net_ops
);