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/list.h>
17 #include <linux/proc_fs.h>
20 * General list handling functions
23 static int __hw_addr_add_ex(struct netdev_hw_addr_list
*list
,
24 unsigned char *addr
, int addr_len
,
25 unsigned char addr_type
, bool global
)
27 struct netdev_hw_addr
*ha
;
30 if (addr_len
> MAX_ADDR_LEN
)
33 list_for_each_entry(ha
, &list
->list
, list
) {
34 if (!memcmp(ha
->addr
, addr
, addr_len
) &&
35 ha
->type
== addr_type
) {
37 /* check if addr is already used as global */
41 ha
->global_use
= true;
49 alloc_size
= sizeof(*ha
);
50 if (alloc_size
< L1_CACHE_BYTES
)
51 alloc_size
= L1_CACHE_BYTES
;
52 ha
= kmalloc(alloc_size
, GFP_ATOMIC
);
55 memcpy(ha
->addr
, addr
, addr_len
);
58 ha
->global_use
= global
;
60 list_add_tail_rcu(&ha
->list
, &list
->list
);
65 static int __hw_addr_add(struct netdev_hw_addr_list
*list
, unsigned char *addr
,
66 int addr_len
, unsigned char addr_type
)
68 return __hw_addr_add_ex(list
, addr
, addr_len
, addr_type
, false);
71 static int __hw_addr_del_ex(struct netdev_hw_addr_list
*list
,
72 unsigned char *addr
, int addr_len
,
73 unsigned char addr_type
, bool global
)
75 struct netdev_hw_addr
*ha
;
77 list_for_each_entry(ha
, &list
->list
, list
) {
78 if (!memcmp(ha
->addr
, addr
, addr_len
) &&
79 (ha
->type
== addr_type
|| !addr_type
)) {
84 ha
->global_use
= false;
88 list_del_rcu(&ha
->list
);
89 kfree_rcu(ha
, rcu_head
);
97 static int __hw_addr_del(struct netdev_hw_addr_list
*list
, unsigned char *addr
,
98 int addr_len
, unsigned char addr_type
)
100 return __hw_addr_del_ex(list
, addr
, addr_len
, addr_type
, false);
103 int __hw_addr_add_multiple(struct netdev_hw_addr_list
*to_list
,
104 struct netdev_hw_addr_list
*from_list
,
105 int addr_len
, unsigned char addr_type
)
108 struct netdev_hw_addr
*ha
, *ha2
;
111 list_for_each_entry(ha
, &from_list
->list
, list
) {
112 type
= addr_type
? addr_type
: ha
->type
;
113 err
= __hw_addr_add(to_list
, ha
->addr
, addr_len
, type
);
120 list_for_each_entry(ha2
, &from_list
->list
, list
) {
123 type
= addr_type
? addr_type
: ha2
->type
;
124 __hw_addr_del(to_list
, ha2
->addr
, addr_len
, type
);
128 EXPORT_SYMBOL(__hw_addr_add_multiple
);
130 void __hw_addr_del_multiple(struct netdev_hw_addr_list
*to_list
,
131 struct netdev_hw_addr_list
*from_list
,
132 int addr_len
, unsigned char addr_type
)
134 struct netdev_hw_addr
*ha
;
137 list_for_each_entry(ha
, &from_list
->list
, list
) {
138 type
= addr_type
? addr_type
: ha
->type
;
139 __hw_addr_del(to_list
, ha
->addr
, addr_len
, type
);
142 EXPORT_SYMBOL(__hw_addr_del_multiple
);
144 int __hw_addr_sync(struct netdev_hw_addr_list
*to_list
,
145 struct netdev_hw_addr_list
*from_list
,
149 struct netdev_hw_addr
*ha
, *tmp
;
151 list_for_each_entry_safe(ha
, tmp
, &from_list
->list
, list
) {
153 err
= __hw_addr_add(to_list
, ha
->addr
,
159 } else if (ha
->refcount
== 1) {
160 __hw_addr_del(to_list
, ha
->addr
, addr_len
, ha
->type
);
161 __hw_addr_del(from_list
, ha
->addr
, addr_len
, ha
->type
);
166 EXPORT_SYMBOL(__hw_addr_sync
);
168 void __hw_addr_unsync(struct netdev_hw_addr_list
*to_list
,
169 struct netdev_hw_addr_list
*from_list
,
172 struct netdev_hw_addr
*ha
, *tmp
;
174 list_for_each_entry_safe(ha
, tmp
, &from_list
->list
, list
) {
176 __hw_addr_del(to_list
, ha
->addr
,
179 __hw_addr_del(from_list
, ha
->addr
,
184 EXPORT_SYMBOL(__hw_addr_unsync
);
186 void __hw_addr_flush(struct netdev_hw_addr_list
*list
)
188 struct netdev_hw_addr
*ha
, *tmp
;
190 list_for_each_entry_safe(ha
, tmp
, &list
->list
, list
) {
191 list_del_rcu(&ha
->list
);
192 kfree_rcu(ha
, rcu_head
);
196 EXPORT_SYMBOL(__hw_addr_flush
);
198 void __hw_addr_init(struct netdev_hw_addr_list
*list
)
200 INIT_LIST_HEAD(&list
->list
);
203 EXPORT_SYMBOL(__hw_addr_init
);
206 * Device addresses handling functions
210 * dev_addr_flush - Flush device address list
213 * Flush device address list and reset ->dev_addr.
215 * The caller must hold the rtnl_mutex.
217 void dev_addr_flush(struct net_device
*dev
)
219 /* rtnl_mutex must be held here */
221 __hw_addr_flush(&dev
->dev_addrs
);
222 dev
->dev_addr
= NULL
;
224 EXPORT_SYMBOL(dev_addr_flush
);
227 * dev_addr_init - Init device address list
230 * Init device address list and create the first element,
231 * used by ->dev_addr.
233 * The caller must hold the rtnl_mutex.
235 int dev_addr_init(struct net_device
*dev
)
237 unsigned char addr
[MAX_ADDR_LEN
];
238 struct netdev_hw_addr
*ha
;
241 /* rtnl_mutex must be held here */
243 __hw_addr_init(&dev
->dev_addrs
);
244 memset(addr
, 0, sizeof(addr
));
245 err
= __hw_addr_add(&dev
->dev_addrs
, addr
, sizeof(addr
),
246 NETDEV_HW_ADDR_T_LAN
);
249 * Get the first (previously created) address from the list
250 * and set dev_addr pointer to this location.
252 ha
= list_first_entry(&dev
->dev_addrs
.list
,
253 struct netdev_hw_addr
, list
);
254 dev
->dev_addr
= ha
->addr
;
258 EXPORT_SYMBOL(dev_addr_init
);
261 * dev_addr_add - Add a device address
263 * @addr: address to add
264 * @addr_type: address type
266 * Add a device address to the device or increase the reference count if
269 * The caller must hold the rtnl_mutex.
271 int dev_addr_add(struct net_device
*dev
, unsigned char *addr
,
272 unsigned char addr_type
)
278 err
= __hw_addr_add(&dev
->dev_addrs
, addr
, dev
->addr_len
, addr_type
);
280 call_netdevice_notifiers(NETDEV_CHANGEADDR
, dev
);
283 EXPORT_SYMBOL(dev_addr_add
);
286 * dev_addr_del - Release a device address.
288 * @addr: address to delete
289 * @addr_type: address type
291 * Release reference to a device address and remove it from the device
292 * if the reference count drops to zero.
294 * The caller must hold the rtnl_mutex.
296 int dev_addr_del(struct net_device
*dev
, unsigned char *addr
,
297 unsigned char addr_type
)
300 struct netdev_hw_addr
*ha
;
305 * We can not remove the first address from the list because
306 * dev->dev_addr points to that.
308 ha
= list_first_entry(&dev
->dev_addrs
.list
,
309 struct netdev_hw_addr
, list
);
310 if (ha
->addr
== dev
->dev_addr
&& ha
->refcount
== 1)
313 err
= __hw_addr_del(&dev
->dev_addrs
, addr
, dev
->addr_len
,
316 call_netdevice_notifiers(NETDEV_CHANGEADDR
, dev
);
319 EXPORT_SYMBOL(dev_addr_del
);
322 * dev_addr_add_multiple - Add device addresses from another device
323 * @to_dev: device to which addresses will be added
324 * @from_dev: device from which addresses will be added
325 * @addr_type: address type - 0 means type will be used from from_dev
327 * Add device addresses of the one device to another.
329 * The caller must hold the rtnl_mutex.
331 int dev_addr_add_multiple(struct net_device
*to_dev
,
332 struct net_device
*from_dev
,
333 unsigned char addr_type
)
339 if (from_dev
->addr_len
!= to_dev
->addr_len
)
341 err
= __hw_addr_add_multiple(&to_dev
->dev_addrs
, &from_dev
->dev_addrs
,
342 to_dev
->addr_len
, addr_type
);
344 call_netdevice_notifiers(NETDEV_CHANGEADDR
, to_dev
);
347 EXPORT_SYMBOL(dev_addr_add_multiple
);
350 * dev_addr_del_multiple - Delete device addresses by another device
351 * @to_dev: device where the addresses will be deleted
352 * @from_dev: device supplying the addresses to be deleted
353 * @addr_type: address type - 0 means type will be used from from_dev
355 * Deletes addresses in to device by the list of addresses in from device.
357 * The caller must hold the rtnl_mutex.
359 int dev_addr_del_multiple(struct net_device
*to_dev
,
360 struct net_device
*from_dev
,
361 unsigned char addr_type
)
365 if (from_dev
->addr_len
!= to_dev
->addr_len
)
367 __hw_addr_del_multiple(&to_dev
->dev_addrs
, &from_dev
->dev_addrs
,
368 to_dev
->addr_len
, addr_type
);
369 call_netdevice_notifiers(NETDEV_CHANGEADDR
, to_dev
);
372 EXPORT_SYMBOL(dev_addr_del_multiple
);
375 * Unicast list handling functions
379 * dev_uc_add - Add a secondary unicast address
381 * @addr: address to add
383 * Add a secondary unicast address to the device or increase
384 * the reference count if it already exists.
386 int dev_uc_add(struct net_device
*dev
, unsigned char *addr
)
390 netif_addr_lock_bh(dev
);
391 err
= __hw_addr_add(&dev
->uc
, addr
, dev
->addr_len
,
392 NETDEV_HW_ADDR_T_UNICAST
);
394 __dev_set_rx_mode(dev
);
395 netif_addr_unlock_bh(dev
);
398 EXPORT_SYMBOL(dev_uc_add
);
401 * dev_uc_del - Release secondary unicast address.
403 * @addr: address to delete
405 * Release reference to a secondary unicast address and remove it
406 * from the device if the reference count drops to zero.
408 int dev_uc_del(struct net_device
*dev
, unsigned char *addr
)
412 netif_addr_lock_bh(dev
);
413 err
= __hw_addr_del(&dev
->uc
, addr
, dev
->addr_len
,
414 NETDEV_HW_ADDR_T_UNICAST
);
416 __dev_set_rx_mode(dev
);
417 netif_addr_unlock_bh(dev
);
420 EXPORT_SYMBOL(dev_uc_del
);
423 * dev_uc_sync - Synchronize device's unicast list to another device
424 * @to: destination device
425 * @from: source device
427 * Add newly added addresses to the destination device and release
428 * addresses that have no users left. The source device must be
429 * locked by netif_tx_lock_bh.
431 * This function is intended to be called from the dev->set_rx_mode
432 * function of layered software devices.
434 int dev_uc_sync(struct net_device
*to
, struct net_device
*from
)
438 if (to
->addr_len
!= from
->addr_len
)
441 netif_addr_lock_bh(to
);
442 err
= __hw_addr_sync(&to
->uc
, &from
->uc
, to
->addr_len
);
444 __dev_set_rx_mode(to
);
445 netif_addr_unlock_bh(to
);
448 EXPORT_SYMBOL(dev_uc_sync
);
451 * dev_uc_unsync - Remove synchronized addresses from the destination device
452 * @to: destination device
453 * @from: source device
455 * Remove all addresses that were added to the destination device by
456 * dev_uc_sync(). This function is intended to be called from the
457 * dev->stop function of layered software devices.
459 void dev_uc_unsync(struct net_device
*to
, struct net_device
*from
)
461 if (to
->addr_len
!= from
->addr_len
)
464 netif_addr_lock_bh(from
);
466 __hw_addr_unsync(&to
->uc
, &from
->uc
, to
->addr_len
);
467 __dev_set_rx_mode(to
);
468 netif_addr_unlock(to
);
469 netif_addr_unlock_bh(from
);
471 EXPORT_SYMBOL(dev_uc_unsync
);
474 * dev_uc_flush - Flush unicast addresses
477 * Flush unicast addresses.
479 void dev_uc_flush(struct net_device
*dev
)
481 netif_addr_lock_bh(dev
);
482 __hw_addr_flush(&dev
->uc
);
483 netif_addr_unlock_bh(dev
);
485 EXPORT_SYMBOL(dev_uc_flush
);
488 * dev_uc_flush - Init unicast address list
491 * Init unicast address list.
493 void dev_uc_init(struct net_device
*dev
)
495 __hw_addr_init(&dev
->uc
);
497 EXPORT_SYMBOL(dev_uc_init
);
500 * Multicast list handling functions
503 static int __dev_mc_add(struct net_device
*dev
, unsigned char *addr
,
508 netif_addr_lock_bh(dev
);
509 err
= __hw_addr_add_ex(&dev
->mc
, addr
, dev
->addr_len
,
510 NETDEV_HW_ADDR_T_MULTICAST
, global
);
512 __dev_set_rx_mode(dev
);
513 netif_addr_unlock_bh(dev
);
517 * dev_mc_add - Add a multicast address
519 * @addr: address to add
521 * Add a multicast address to the device or increase
522 * the reference count if it already exists.
524 int dev_mc_add(struct net_device
*dev
, unsigned char *addr
)
526 return __dev_mc_add(dev
, addr
, false);
528 EXPORT_SYMBOL(dev_mc_add
);
531 * dev_mc_add_global - Add a global multicast address
533 * @addr: address to add
535 * Add a global multicast address to the device.
537 int dev_mc_add_global(struct net_device
*dev
, unsigned char *addr
)
539 return __dev_mc_add(dev
, addr
, true);
541 EXPORT_SYMBOL(dev_mc_add_global
);
543 static int __dev_mc_del(struct net_device
*dev
, unsigned char *addr
,
548 netif_addr_lock_bh(dev
);
549 err
= __hw_addr_del_ex(&dev
->mc
, addr
, dev
->addr_len
,
550 NETDEV_HW_ADDR_T_MULTICAST
, global
);
552 __dev_set_rx_mode(dev
);
553 netif_addr_unlock_bh(dev
);
558 * dev_mc_del - Delete a multicast address.
560 * @addr: address to delete
562 * Release reference to a multicast address and remove it
563 * from the device if the reference count drops to zero.
565 int dev_mc_del(struct net_device
*dev
, unsigned char *addr
)
567 return __dev_mc_del(dev
, addr
, false);
569 EXPORT_SYMBOL(dev_mc_del
);
572 * dev_mc_del_global - Delete a global multicast address.
574 * @addr: address to delete
576 * Release reference to a multicast address and remove it
577 * from the device if the reference count drops to zero.
579 int dev_mc_del_global(struct net_device
*dev
, unsigned char *addr
)
581 return __dev_mc_del(dev
, addr
, true);
583 EXPORT_SYMBOL(dev_mc_del_global
);
586 * dev_mc_sync - Synchronize device's unicast list to another device
587 * @to: destination device
588 * @from: source device
590 * Add newly added addresses to the destination device and release
591 * addresses that have no users left. The source device must be
592 * locked by netif_tx_lock_bh.
594 * This function is intended to be called from the dev->set_multicast_list
595 * or dev->set_rx_mode function of layered software devices.
597 int dev_mc_sync(struct net_device
*to
, struct net_device
*from
)
601 if (to
->addr_len
!= from
->addr_len
)
604 netif_addr_lock_bh(to
);
605 err
= __hw_addr_sync(&to
->mc
, &from
->mc
, to
->addr_len
);
607 __dev_set_rx_mode(to
);
608 netif_addr_unlock_bh(to
);
611 EXPORT_SYMBOL(dev_mc_sync
);
614 * dev_mc_unsync - Remove synchronized addresses from the destination device
615 * @to: destination device
616 * @from: source device
618 * Remove all addresses that were added to the destination device by
619 * dev_mc_sync(). This function is intended to be called from the
620 * dev->stop function of layered software devices.
622 void dev_mc_unsync(struct net_device
*to
, struct net_device
*from
)
624 if (to
->addr_len
!= from
->addr_len
)
627 netif_addr_lock_bh(from
);
629 __hw_addr_unsync(&to
->mc
, &from
->mc
, to
->addr_len
);
630 __dev_set_rx_mode(to
);
631 netif_addr_unlock(to
);
632 netif_addr_unlock_bh(from
);
634 EXPORT_SYMBOL(dev_mc_unsync
);
637 * dev_mc_flush - Flush multicast addresses
640 * Flush multicast addresses.
642 void dev_mc_flush(struct net_device
*dev
)
644 netif_addr_lock_bh(dev
);
645 __hw_addr_flush(&dev
->mc
);
646 netif_addr_unlock_bh(dev
);
648 EXPORT_SYMBOL(dev_mc_flush
);
651 * dev_mc_flush - Init multicast address list
654 * Init multicast address list.
656 void dev_mc_init(struct net_device
*dev
)
658 __hw_addr_init(&dev
->mc
);
660 EXPORT_SYMBOL(dev_mc_init
);
662 #ifdef CONFIG_PROC_FS
663 #include <linux/seq_file.h>
665 static int dev_mc_seq_show(struct seq_file
*seq
, void *v
)
667 struct netdev_hw_addr
*ha
;
668 struct net_device
*dev
= v
;
670 if (v
== SEQ_START_TOKEN
)
673 netif_addr_lock_bh(dev
);
674 netdev_for_each_mc_addr(ha
, dev
) {
677 seq_printf(seq
, "%-4d %-15s %-5d %-5d ", dev
->ifindex
,
678 dev
->name
, ha
->refcount
, ha
->global_use
);
680 for (i
= 0; i
< dev
->addr_len
; i
++)
681 seq_printf(seq
, "%02x", ha
->addr
[i
]);
685 netif_addr_unlock_bh(dev
);
689 static const struct seq_operations dev_mc_seq_ops
= {
690 .start
= dev_seq_start
,
691 .next
= dev_seq_next
,
692 .stop
= dev_seq_stop
,
693 .show
= dev_mc_seq_show
,
696 static int dev_mc_seq_open(struct inode
*inode
, struct file
*file
)
698 return seq_open_net(inode
, file
, &dev_mc_seq_ops
,
699 sizeof(struct seq_net_private
));
702 static const struct file_operations dev_mc_seq_fops
= {
703 .owner
= THIS_MODULE
,
704 .open
= dev_mc_seq_open
,
707 .release
= seq_release_net
,
712 static int __net_init
dev_mc_net_init(struct net
*net
)
714 if (!proc_net_fops_create(net
, "dev_mcast", 0, &dev_mc_seq_fops
))
719 static void __net_exit
dev_mc_net_exit(struct net
*net
)
721 proc_net_remove(net
, "dev_mcast");
724 static struct pernet_operations __net_initdata dev_mc_net_ops
= {
725 .init
= dev_mc_net_init
,
726 .exit
= dev_mc_net_exit
,
729 void __init
dev_mcast_init(void)
731 register_pernet_subsys(&dev_mc_net_ops
);