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 (ha->addr == dev->dev_addr && ha->refcount == 1)
314
err = __hw_addr_del(&dev->dev_addrs, addr, dev->addr_len,
317
call_netdevice_notifiers(NETDEV_CHANGEADDR, dev);
320
EXPORT_SYMBOL(dev_addr_del);
323
* dev_addr_add_multiple - Add device addresses from another device
324
* @to_dev: device to which addresses will be added
325
* @from_dev: device from which addresses will be added
326
* @addr_type: address type - 0 means type will be used from from_dev
328
* Add device addresses of the one device to another.
330
* The caller must hold the rtnl_mutex.
332
int dev_addr_add_multiple(struct net_device *to_dev,
333
struct net_device *from_dev,
334
unsigned char addr_type)
340
if (from_dev->addr_len != to_dev->addr_len)
342
err = __hw_addr_add_multiple(&to_dev->dev_addrs, &from_dev->dev_addrs,
343
to_dev->addr_len, addr_type);
345
call_netdevice_notifiers(NETDEV_CHANGEADDR, to_dev);
348
EXPORT_SYMBOL(dev_addr_add_multiple);
351
* dev_addr_del_multiple - Delete device addresses by another device
352
* @to_dev: device where the addresses will be deleted
353
* @from_dev: device supplying the addresses to be deleted
354
* @addr_type: address type - 0 means type will be used from from_dev
356
* Deletes addresses in to device by the list of addresses in from device.
358
* The caller must hold the rtnl_mutex.
360
int dev_addr_del_multiple(struct net_device *to_dev,
361
struct net_device *from_dev,
362
unsigned char addr_type)
366
if (from_dev->addr_len != to_dev->addr_len)
368
__hw_addr_del_multiple(&to_dev->dev_addrs, &from_dev->dev_addrs,
369
to_dev->addr_len, addr_type);
370
call_netdevice_notifiers(NETDEV_CHANGEADDR, to_dev);
373
EXPORT_SYMBOL(dev_addr_del_multiple);
376
* Unicast list handling functions
380
* dev_uc_add - Add a secondary unicast address
382
* @addr: address to add
384
* Add a secondary unicast address to the device or increase
385
* the reference count if it already exists.
387
int dev_uc_add(struct net_device *dev, unsigned char *addr)
391
netif_addr_lock_bh(dev);
392
err = __hw_addr_add(&dev->uc, addr, dev->addr_len,
393
NETDEV_HW_ADDR_T_UNICAST);
395
__dev_set_rx_mode(dev);
396
netif_addr_unlock_bh(dev);
399
EXPORT_SYMBOL(dev_uc_add);
402
* dev_uc_del - Release secondary unicast address.
404
* @addr: address to delete
406
* Release reference to a secondary unicast address and remove it
407
* from the device if the reference count drops to zero.
409
int dev_uc_del(struct net_device *dev, unsigned char *addr)
413
netif_addr_lock_bh(dev);
414
err = __hw_addr_del(&dev->uc, addr, dev->addr_len,
415
NETDEV_HW_ADDR_T_UNICAST);
417
__dev_set_rx_mode(dev);
418
netif_addr_unlock_bh(dev);
421
EXPORT_SYMBOL(dev_uc_del);
424
* dev_uc_sync - Synchronize device's unicast list to another device
425
* @to: destination device
426
* @from: source device
428
* Add newly added addresses to the destination device and release
429
* addresses that have no users left. The source device must be
430
* locked by netif_tx_lock_bh.
432
* This function is intended to be called from the dev->set_rx_mode
433
* function of layered software devices.
435
int dev_uc_sync(struct net_device *to, struct net_device *from)
439
if (to->addr_len != from->addr_len)
442
netif_addr_lock_bh(to);
443
err = __hw_addr_sync(&to->uc, &from->uc, to->addr_len);
445
__dev_set_rx_mode(to);
446
netif_addr_unlock_bh(to);
449
EXPORT_SYMBOL(dev_uc_sync);
452
* dev_uc_unsync - Remove synchronized addresses from the destination device
453
* @to: destination device
454
* @from: source device
456
* Remove all addresses that were added to the destination device by
457
* dev_uc_sync(). This function is intended to be called from the
458
* dev->stop function of layered software devices.
460
void dev_uc_unsync(struct net_device *to, struct net_device *from)
462
if (to->addr_len != from->addr_len)
465
netif_addr_lock_bh(from);
467
__hw_addr_unsync(&to->uc, &from->uc, to->addr_len);
468
__dev_set_rx_mode(to);
469
netif_addr_unlock(to);
470
netif_addr_unlock_bh(from);
472
EXPORT_SYMBOL(dev_uc_unsync);
475
* dev_uc_flush - Flush unicast addresses
478
* Flush unicast addresses.
480
void dev_uc_flush(struct net_device *dev)
482
netif_addr_lock_bh(dev);
483
__hw_addr_flush(&dev->uc);
484
netif_addr_unlock_bh(dev);
486
EXPORT_SYMBOL(dev_uc_flush);
489
* dev_uc_flush - Init unicast address list
492
* Init unicast address list.
494
void dev_uc_init(struct net_device *dev)
496
__hw_addr_init(&dev->uc);
498
EXPORT_SYMBOL(dev_uc_init);
501
* Multicast list handling functions
504
static int __dev_mc_add(struct net_device *dev, unsigned char *addr,
509
netif_addr_lock_bh(dev);
510
err = __hw_addr_add_ex(&dev->mc, addr, dev->addr_len,
511
NETDEV_HW_ADDR_T_MULTICAST, global);
513
__dev_set_rx_mode(dev);
514
netif_addr_unlock_bh(dev);
518
* dev_mc_add - Add a multicast address
520
* @addr: address to add
522
* Add a multicast address to the device or increase
523
* the reference count if it already exists.
525
int dev_mc_add(struct net_device *dev, unsigned char *addr)
527
return __dev_mc_add(dev, addr, false);
529
EXPORT_SYMBOL(dev_mc_add);
532
* dev_mc_add_global - Add a global multicast address
534
* @addr: address to add
536
* Add a global multicast address to the device.
538
int dev_mc_add_global(struct net_device *dev, unsigned char *addr)
540
return __dev_mc_add(dev, addr, true);
542
EXPORT_SYMBOL(dev_mc_add_global);
544
static int __dev_mc_del(struct net_device *dev, unsigned char *addr,
549
netif_addr_lock_bh(dev);
550
err = __hw_addr_del_ex(&dev->mc, addr, dev->addr_len,
551
NETDEV_HW_ADDR_T_MULTICAST, global);
553
__dev_set_rx_mode(dev);
554
netif_addr_unlock_bh(dev);
559
* dev_mc_del - Delete a multicast address.
561
* @addr: address to delete
563
* Release reference to a multicast address and remove it
564
* from the device if the reference count drops to zero.
566
int dev_mc_del(struct net_device *dev, unsigned char *addr)
568
return __dev_mc_del(dev, addr, false);
570
EXPORT_SYMBOL(dev_mc_del);
573
* dev_mc_del_global - Delete a global multicast address.
575
* @addr: address to delete
577
* Release reference to a multicast address and remove it
578
* from the device if the reference count drops to zero.
580
int dev_mc_del_global(struct net_device *dev, unsigned char *addr)
582
return __dev_mc_del(dev, addr, true);
584
EXPORT_SYMBOL(dev_mc_del_global);
587
* dev_mc_sync - Synchronize device's unicast list to another device
588
* @to: destination device
589
* @from: source device
591
* Add newly added addresses to the destination device and release
592
* addresses that have no users left. The source device must be
593
* locked by netif_tx_lock_bh.
595
* This function is intended to be called from the ndo_set_rx_mode
596
* function of layered software devices.
598
int dev_mc_sync(struct net_device *to, struct net_device *from)
602
if (to->addr_len != from->addr_len)
605
netif_addr_lock_bh(to);
606
err = __hw_addr_sync(&to->mc, &from->mc, to->addr_len);
608
__dev_set_rx_mode(to);
609
netif_addr_unlock_bh(to);
612
EXPORT_SYMBOL(dev_mc_sync);
615
* dev_mc_unsync - Remove synchronized addresses from the destination device
616
* @to: destination device
617
* @from: source device
619
* Remove all addresses that were added to the destination device by
620
* dev_mc_sync(). This function is intended to be called from the
621
* dev->stop function of layered software devices.
623
void dev_mc_unsync(struct net_device *to, struct net_device *from)
625
if (to->addr_len != from->addr_len)
628
netif_addr_lock_bh(from);
630
__hw_addr_unsync(&to->mc, &from->mc, to->addr_len);
631
__dev_set_rx_mode(to);
632
netif_addr_unlock(to);
633
netif_addr_unlock_bh(from);
635
EXPORT_SYMBOL(dev_mc_unsync);
638
* dev_mc_flush - Flush multicast addresses
641
* Flush multicast addresses.
643
void dev_mc_flush(struct net_device *dev)
645
netif_addr_lock_bh(dev);
646
__hw_addr_flush(&dev->mc);
647
netif_addr_unlock_bh(dev);
649
EXPORT_SYMBOL(dev_mc_flush);
652
* dev_mc_flush - Init multicast address list
655
* Init multicast address list.
657
void dev_mc_init(struct net_device *dev)
659
__hw_addr_init(&dev->mc);
661
EXPORT_SYMBOL(dev_mc_init);
663
#ifdef CONFIG_PROC_FS
664
#include <linux/seq_file.h>
666
static int dev_mc_seq_show(struct seq_file *seq, void *v)
668
struct netdev_hw_addr *ha;
669
struct net_device *dev = v;
671
if (v == SEQ_START_TOKEN)
674
netif_addr_lock_bh(dev);
675
netdev_for_each_mc_addr(ha, dev) {
678
seq_printf(seq, "%-4d %-15s %-5d %-5d ", dev->ifindex,
679
dev->name, ha->refcount, ha->global_use);
681
for (i = 0; i < dev->addr_len; i++)
682
seq_printf(seq, "%02x", ha->addr[i]);
686
netif_addr_unlock_bh(dev);
690
static const struct seq_operations dev_mc_seq_ops = {
691
.start = dev_seq_start,
692
.next = dev_seq_next,
693
.stop = dev_seq_stop,
694
.show = dev_mc_seq_show,
697
static int dev_mc_seq_open(struct inode *inode, struct file *file)
699
return dev_seq_open_ops(inode, file, &dev_mc_seq_ops);
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);