Linux Audio

Check our new training course

Loading...
v4.17
  1/*
  2 * net/core/dev_addr_lists.c - Functions for handling net device lists
  3 * Copyright (c) 2010 Jiri Pirko <jpirko@redhat.com>
  4 *
  5 * This file contains functions for working with unicast, multicast and device
  6 * addresses lists.
  7 *
  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.
 12 */
 13
 14#include <linux/netdevice.h>
 15#include <linux/rtnetlink.h>
 16#include <linux/export.h>
 17#include <linux/list.h>
 
 18
 19/*
 20 * General list handling functions
 21 */
 22
 23static int __hw_addr_create_ex(struct netdev_hw_addr_list *list,
 24			       const unsigned char *addr, int addr_len,
 25			       unsigned char addr_type, bool global,
 26			       bool sync)
 27{
 28	struct netdev_hw_addr *ha;
 29	int alloc_size;
 30
 31	alloc_size = sizeof(*ha);
 32	if (alloc_size < L1_CACHE_BYTES)
 33		alloc_size = L1_CACHE_BYTES;
 34	ha = kmalloc(alloc_size, GFP_ATOMIC);
 35	if (!ha)
 36		return -ENOMEM;
 37	memcpy(ha->addr, addr, addr_len);
 38	ha->type = addr_type;
 39	ha->refcount = 1;
 40	ha->global_use = global;
 41	ha->synced = sync ? 1 : 0;
 42	ha->sync_cnt = 0;
 43	list_add_tail_rcu(&ha->list, &list->list);
 44	list->count++;
 45
 46	return 0;
 47}
 48
 49static int __hw_addr_add_ex(struct netdev_hw_addr_list *list,
 50			    const unsigned char *addr, int addr_len,
 51			    unsigned char addr_type, bool global, bool sync,
 52			    int sync_count)
 53{
 54	struct netdev_hw_addr *ha;
 55
 56	if (addr_len > MAX_ADDR_LEN)
 57		return -EINVAL;
 58
 59	list_for_each_entry(ha, &list->list, list) {
 60		if (ha->type == addr_type &&
 61		    !memcmp(ha->addr, addr, addr_len)) {
 62			if (global) {
 63				/* check if addr is already used as global */
 64				if (ha->global_use)
 65					return 0;
 66				else
 67					ha->global_use = true;
 68			}
 69			if (sync) {
 70				if (ha->synced && sync_count)
 71					return -EEXIST;
 72				else
 73					ha->synced++;
 74			}
 75			ha->refcount++;
 76			return 0;
 77		}
 78	}
 79
 80	return __hw_addr_create_ex(list, addr, addr_len, addr_type, global,
 81				   sync);
 82}
 83
 84static int __hw_addr_add(struct netdev_hw_addr_list *list,
 85			 const unsigned char *addr, int addr_len,
 86			 unsigned char addr_type)
 87{
 88	return __hw_addr_add_ex(list, addr, addr_len, addr_type, false, false,
 89				0);
 90}
 91
 92static int __hw_addr_del_entry(struct netdev_hw_addr_list *list,
 93			       struct netdev_hw_addr *ha, bool global,
 94			       bool sync)
 95{
 96	if (global && !ha->global_use)
 97		return -ENOENT;
 98
 99	if (sync && !ha->synced)
100		return -ENOENT;
101
102	if (global)
103		ha->global_use = false;
104
105	if (sync)
106		ha->synced--;
107
108	if (--ha->refcount)
109		return 0;
110	list_del_rcu(&ha->list);
111	kfree_rcu(ha, rcu_head);
112	list->count--;
113	return 0;
114}
115
116static int __hw_addr_del_ex(struct netdev_hw_addr_list *list,
117			    const unsigned char *addr, int addr_len,
118			    unsigned char addr_type, bool global, bool sync)
119{
120	struct netdev_hw_addr *ha;
121
122	list_for_each_entry(ha, &list->list, list) {
123		if (!memcmp(ha->addr, addr, addr_len) &&
124		    (ha->type == addr_type || !addr_type))
125			return __hw_addr_del_entry(list, ha, global, sync);
 
 
 
 
 
 
 
 
 
 
 
 
126	}
127	return -ENOENT;
128}
129
130static int __hw_addr_del(struct netdev_hw_addr_list *list,
131			 const unsigned char *addr, int addr_len,
132			 unsigned char addr_type)
133{
134	return __hw_addr_del_ex(list, addr, addr_len, addr_type, false, false);
135}
136
137static int __hw_addr_sync_one(struct netdev_hw_addr_list *to_list,
138			       struct netdev_hw_addr *ha,
139			       int addr_len)
140{
141	int err;
 
 
142
143	err = __hw_addr_add_ex(to_list, ha->addr, addr_len, ha->type,
144			       false, true, ha->sync_cnt);
145	if (err && err != -EEXIST)
146		return err;
147
148	if (!err) {
149		ha->sync_cnt++;
150		ha->refcount++;
151	}
152
153	return 0;
154}
155
156static void __hw_addr_unsync_one(struct netdev_hw_addr_list *to_list,
157				 struct netdev_hw_addr_list *from_list,
158				 struct netdev_hw_addr *ha,
159				 int addr_len)
160{
161	int err;
162
163	err = __hw_addr_del_ex(to_list, ha->addr, addr_len, ha->type,
164			       false, true);
165	if (err)
166		return;
167	ha->sync_cnt--;
168	/* address on from list is not marked synced */
169	__hw_addr_del_entry(from_list, ha, false, false);
 
170}
 
171
172static int __hw_addr_sync_multiple(struct netdev_hw_addr_list *to_list,
173				   struct netdev_hw_addr_list *from_list,
174				   int addr_len)
175{
176	int err = 0;
177	struct netdev_hw_addr *ha, *tmp;
178
179	list_for_each_entry_safe(ha, tmp, &from_list->list, list) {
180		if (ha->sync_cnt == ha->refcount) {
181			__hw_addr_unsync_one(to_list, from_list, ha, addr_len);
182		} else {
183			err = __hw_addr_sync_one(to_list, ha, addr_len);
184			if (err)
185				break;
186		}
187	}
188	return err;
189}
 
190
191/* This function only works where there is a strict 1-1 relationship
192 * between source and destionation of they synch. If you ever need to
193 * sync addresses to more then 1 destination, you need to use
194 * __hw_addr_sync_multiple().
195 */
196int __hw_addr_sync(struct netdev_hw_addr_list *to_list,
197		   struct netdev_hw_addr_list *from_list,
198		   int addr_len)
199{
200	int err = 0;
201	struct netdev_hw_addr *ha, *tmp;
202
203	list_for_each_entry_safe(ha, tmp, &from_list->list, list) {
204		if (!ha->sync_cnt) {
205			err = __hw_addr_sync_one(to_list, ha, addr_len);
 
206			if (err)
207				break;
208		} else if (ha->refcount == 1)
209			__hw_addr_unsync_one(to_list, from_list, ha, addr_len);
 
 
 
 
210	}
211	return err;
212}
213EXPORT_SYMBOL(__hw_addr_sync);
214
215void __hw_addr_unsync(struct netdev_hw_addr_list *to_list,
216		      struct netdev_hw_addr_list *from_list,
217		      int addr_len)
218{
219	struct netdev_hw_addr *ha, *tmp;
220
221	list_for_each_entry_safe(ha, tmp, &from_list->list, list) {
222		if (ha->sync_cnt)
223			__hw_addr_unsync_one(to_list, from_list, ha, addr_len);
 
 
 
 
 
224	}
225}
226EXPORT_SYMBOL(__hw_addr_unsync);
227
228/**
229 *  __hw_addr_sync_dev - Synchonize device's multicast list
230 *  @list: address list to syncronize
231 *  @dev:  device to sync
232 *  @sync: function to call if address should be added
233 *  @unsync: function to call if address should be removed
234 *
235 *  This funciton is intended to be called from the ndo_set_rx_mode
236 *  function of devices that require explicit address add/remove
237 *  notifications.  The unsync function may be NULL in which case
238 *  the addresses requiring removal will simply be removed without
239 *  any notification to the device.
240 **/
241int __hw_addr_sync_dev(struct netdev_hw_addr_list *list,
242		       struct net_device *dev,
243		       int (*sync)(struct net_device *, const unsigned char *),
244		       int (*unsync)(struct net_device *,
245				     const unsigned char *))
246{
247	struct netdev_hw_addr *ha, *tmp;
248	int err;
249
250	/* first go through and flush out any stale entries */
251	list_for_each_entry_safe(ha, tmp, &list->list, list) {
252		if (!ha->sync_cnt || ha->refcount != 1)
253			continue;
254
255		/* if unsync is defined and fails defer unsyncing address */
256		if (unsync && unsync(dev, ha->addr))
257			continue;
258
259		ha->sync_cnt--;
260		__hw_addr_del_entry(list, ha, false, false);
261	}
262
263	/* go through and sync new entries to the list */
264	list_for_each_entry_safe(ha, tmp, &list->list, list) {
265		if (ha->sync_cnt)
266			continue;
267
268		err = sync(dev, ha->addr);
269		if (err)
270			return err;
271
272		ha->sync_cnt++;
273		ha->refcount++;
274	}
275
276	return 0;
277}
278EXPORT_SYMBOL(__hw_addr_sync_dev);
279
280/**
281 *  __hw_addr_unsync_dev - Remove synchronized addresses from device
282 *  @list: address list to remove synchronized addresses from
283 *  @dev:  device to sync
284 *  @unsync: function to call if address should be removed
285 *
286 *  Remove all addresses that were added to the device by __hw_addr_sync_dev().
287 *  This function is intended to be called from the ndo_stop or ndo_open
288 *  functions on devices that require explicit address add/remove
289 *  notifications.  If the unsync function pointer is NULL then this function
290 *  can be used to just reset the sync_cnt for the addresses in the list.
291 **/
292void __hw_addr_unsync_dev(struct netdev_hw_addr_list *list,
293			  struct net_device *dev,
294			  int (*unsync)(struct net_device *,
295					const unsigned char *))
296{
297	struct netdev_hw_addr *ha, *tmp;
298
299	list_for_each_entry_safe(ha, tmp, &list->list, list) {
300		if (!ha->sync_cnt)
301			continue;
302
303		/* if unsync is defined and fails defer unsyncing address */
304		if (unsync && unsync(dev, ha->addr))
305			continue;
306
307		ha->sync_cnt--;
308		__hw_addr_del_entry(list, ha, false, false);
309	}
310}
311EXPORT_SYMBOL(__hw_addr_unsync_dev);
312
313static void __hw_addr_flush(struct netdev_hw_addr_list *list)
314{
315	struct netdev_hw_addr *ha, *tmp;
316
317	list_for_each_entry_safe(ha, tmp, &list->list, list) {
318		list_del_rcu(&ha->list);
319		kfree_rcu(ha, rcu_head);
320	}
321	list->count = 0;
322}
 
323
324void __hw_addr_init(struct netdev_hw_addr_list *list)
325{
326	INIT_LIST_HEAD(&list->list);
327	list->count = 0;
328}
329EXPORT_SYMBOL(__hw_addr_init);
330
331/*
332 * Device addresses handling functions
333 */
334
335/**
336 *	dev_addr_flush - Flush device address list
337 *	@dev: device
338 *
339 *	Flush device address list and reset ->dev_addr.
340 *
341 *	The caller must hold the rtnl_mutex.
342 */
343void dev_addr_flush(struct net_device *dev)
344{
345	/* rtnl_mutex must be held here */
346
347	__hw_addr_flush(&dev->dev_addrs);
348	dev->dev_addr = NULL;
349}
350EXPORT_SYMBOL(dev_addr_flush);
351
352/**
353 *	dev_addr_init - Init device address list
354 *	@dev: device
355 *
356 *	Init device address list and create the first element,
357 *	used by ->dev_addr.
358 *
359 *	The caller must hold the rtnl_mutex.
360 */
361int dev_addr_init(struct net_device *dev)
362{
363	unsigned char addr[MAX_ADDR_LEN];
364	struct netdev_hw_addr *ha;
365	int err;
366
367	/* rtnl_mutex must be held here */
368
369	__hw_addr_init(&dev->dev_addrs);
370	memset(addr, 0, sizeof(addr));
371	err = __hw_addr_add(&dev->dev_addrs, addr, sizeof(addr),
372			    NETDEV_HW_ADDR_T_LAN);
373	if (!err) {
374		/*
375		 * Get the first (previously created) address from the list
376		 * and set dev_addr pointer to this location.
377		 */
378		ha = list_first_entry(&dev->dev_addrs.list,
379				      struct netdev_hw_addr, list);
380		dev->dev_addr = ha->addr;
381	}
382	return err;
383}
384EXPORT_SYMBOL(dev_addr_init);
385
386/**
387 *	dev_addr_add - Add a device address
388 *	@dev: device
389 *	@addr: address to add
390 *	@addr_type: address type
391 *
392 *	Add a device address to the device or increase the reference count if
393 *	it already exists.
394 *
395 *	The caller must hold the rtnl_mutex.
396 */
397int dev_addr_add(struct net_device *dev, const unsigned char *addr,
398		 unsigned char addr_type)
399{
400	int err;
401
402	ASSERT_RTNL();
403
404	err = __hw_addr_add(&dev->dev_addrs, addr, dev->addr_len, addr_type);
405	if (!err)
406		call_netdevice_notifiers(NETDEV_CHANGEADDR, dev);
407	return err;
408}
409EXPORT_SYMBOL(dev_addr_add);
410
411/**
412 *	dev_addr_del - Release a device address.
413 *	@dev: device
414 *	@addr: address to delete
415 *	@addr_type: address type
416 *
417 *	Release reference to a device address and remove it from the device
418 *	if the reference count drops to zero.
419 *
420 *	The caller must hold the rtnl_mutex.
421 */
422int dev_addr_del(struct net_device *dev, const unsigned char *addr,
423		 unsigned char addr_type)
424{
425	int err;
426	struct netdev_hw_addr *ha;
427
428	ASSERT_RTNL();
429
430	/*
431	 * We can not remove the first address from the list because
432	 * dev->dev_addr points to that.
433	 */
434	ha = list_first_entry(&dev->dev_addrs.list,
435			      struct netdev_hw_addr, list);
436	if (!memcmp(ha->addr, addr, dev->addr_len) &&
437	    ha->type == addr_type && ha->refcount == 1)
438		return -ENOENT;
439
440	err = __hw_addr_del(&dev->dev_addrs, addr, dev->addr_len,
441			    addr_type);
442	if (!err)
443		call_netdevice_notifiers(NETDEV_CHANGEADDR, dev);
444	return err;
445}
446EXPORT_SYMBOL(dev_addr_del);
447
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
448/*
449 * Unicast list handling functions
450 */
451
452/**
453 *	dev_uc_add_excl - Add a global secondary unicast address
454 *	@dev: device
455 *	@addr: address to add
456 */
457int dev_uc_add_excl(struct net_device *dev, const unsigned char *addr)
458{
459	struct netdev_hw_addr *ha;
460	int err;
461
462	netif_addr_lock_bh(dev);
463	list_for_each_entry(ha, &dev->uc.list, list) {
464		if (!memcmp(ha->addr, addr, dev->addr_len) &&
465		    ha->type == NETDEV_HW_ADDR_T_UNICAST) {
466			err = -EEXIST;
467			goto out;
468		}
469	}
470	err = __hw_addr_create_ex(&dev->uc, addr, dev->addr_len,
471				  NETDEV_HW_ADDR_T_UNICAST, true, false);
472	if (!err)
473		__dev_set_rx_mode(dev);
474out:
475	netif_addr_unlock_bh(dev);
476	return err;
477}
478EXPORT_SYMBOL(dev_uc_add_excl);
479
480/**
481 *	dev_uc_add - Add a secondary unicast address
482 *	@dev: device
483 *	@addr: address to add
484 *
485 *	Add a secondary unicast address to the device or increase
486 *	the reference count if it already exists.
487 */
488int dev_uc_add(struct net_device *dev, const unsigned char *addr)
489{
490	int err;
491
492	netif_addr_lock_bh(dev);
493	err = __hw_addr_add(&dev->uc, addr, dev->addr_len,
494			    NETDEV_HW_ADDR_T_UNICAST);
495	if (!err)
496		__dev_set_rx_mode(dev);
497	netif_addr_unlock_bh(dev);
498	return err;
499}
500EXPORT_SYMBOL(dev_uc_add);
501
502/**
503 *	dev_uc_del - Release secondary unicast address.
504 *	@dev: device
505 *	@addr: address to delete
506 *
507 *	Release reference to a secondary unicast address and remove it
508 *	from the device if the reference count drops to zero.
509 */
510int dev_uc_del(struct net_device *dev, const unsigned char *addr)
511{
512	int err;
513
514	netif_addr_lock_bh(dev);
515	err = __hw_addr_del(&dev->uc, addr, dev->addr_len,
516			    NETDEV_HW_ADDR_T_UNICAST);
517	if (!err)
518		__dev_set_rx_mode(dev);
519	netif_addr_unlock_bh(dev);
520	return err;
521}
522EXPORT_SYMBOL(dev_uc_del);
523
524/**
525 *	dev_uc_sync - Synchronize device's unicast list to another device
526 *	@to: destination device
527 *	@from: source device
528 *
529 *	Add newly added addresses to the destination device and release
530 *	addresses that have no users left. The source device must be
531 *	locked by netif_addr_lock_bh.
532 *
533 *	This function is intended to be called from the dev->set_rx_mode
534 *	function of layered software devices.  This function assumes that
535 *	addresses will only ever be synced to the @to devices and no other.
536 */
537int dev_uc_sync(struct net_device *to, struct net_device *from)
538{
539	int err = 0;
540
541	if (to->addr_len != from->addr_len)
542		return -EINVAL;
543
544	netif_addr_lock_nested(to);
545	err = __hw_addr_sync(&to->uc, &from->uc, to->addr_len);
546	if (!err)
547		__dev_set_rx_mode(to);
548	netif_addr_unlock(to);
549	return err;
550}
551EXPORT_SYMBOL(dev_uc_sync);
552
553/**
554 *	dev_uc_sync_multiple - Synchronize device's unicast list to another
555 *	device, but allow for multiple calls to sync to multiple devices.
556 *	@to: destination device
557 *	@from: source device
558 *
559 *	Add newly added addresses to the destination device and release
560 *	addresses that have been deleted from the source. The source device
561 *	must be locked by netif_addr_lock_bh.
562 *
563 *	This function is intended to be called from the dev->set_rx_mode
564 *	function of layered software devices.  It allows for a single source
565 *	device to be synced to multiple destination devices.
566 */
567int dev_uc_sync_multiple(struct net_device *to, struct net_device *from)
568{
569	int err = 0;
570
571	if (to->addr_len != from->addr_len)
572		return -EINVAL;
573
574	netif_addr_lock_nested(to);
575	err = __hw_addr_sync_multiple(&to->uc, &from->uc, to->addr_len);
576	if (!err)
577		__dev_set_rx_mode(to);
578	netif_addr_unlock(to);
579	return err;
580}
581EXPORT_SYMBOL(dev_uc_sync_multiple);
582
583/**
584 *	dev_uc_unsync - Remove synchronized addresses from the destination device
585 *	@to: destination device
586 *	@from: source device
587 *
588 *	Remove all addresses that were added to the destination device by
589 *	dev_uc_sync(). This function is intended to be called from the
590 *	dev->stop function of layered software devices.
591 */
592void dev_uc_unsync(struct net_device *to, struct net_device *from)
593{
594	if (to->addr_len != from->addr_len)
595		return;
596
597	netif_addr_lock_bh(from);
598	netif_addr_lock_nested(to);
599	__hw_addr_unsync(&to->uc, &from->uc, to->addr_len);
600	__dev_set_rx_mode(to);
601	netif_addr_unlock(to);
602	netif_addr_unlock_bh(from);
603}
604EXPORT_SYMBOL(dev_uc_unsync);
605
606/**
607 *	dev_uc_flush - Flush unicast addresses
608 *	@dev: device
609 *
610 *	Flush unicast addresses.
611 */
612void dev_uc_flush(struct net_device *dev)
613{
614	netif_addr_lock_bh(dev);
615	__hw_addr_flush(&dev->uc);
616	netif_addr_unlock_bh(dev);
617}
618EXPORT_SYMBOL(dev_uc_flush);
619
620/**
621 *	dev_uc_flush - Init unicast address list
622 *	@dev: device
623 *
624 *	Init unicast address list.
625 */
626void dev_uc_init(struct net_device *dev)
627{
628	__hw_addr_init(&dev->uc);
629}
630EXPORT_SYMBOL(dev_uc_init);
631
632/*
633 * Multicast list handling functions
634 */
635
636/**
637 *	dev_mc_add_excl - Add a global secondary multicast address
638 *	@dev: device
639 *	@addr: address to add
640 */
641int dev_mc_add_excl(struct net_device *dev, const unsigned char *addr)
642{
643	struct netdev_hw_addr *ha;
644	int err;
645
646	netif_addr_lock_bh(dev);
647	list_for_each_entry(ha, &dev->mc.list, list) {
648		if (!memcmp(ha->addr, addr, dev->addr_len) &&
649		    ha->type == NETDEV_HW_ADDR_T_MULTICAST) {
650			err = -EEXIST;
651			goto out;
652		}
653	}
654	err = __hw_addr_create_ex(&dev->mc, addr, dev->addr_len,
655				  NETDEV_HW_ADDR_T_MULTICAST, true, false);
656	if (!err)
657		__dev_set_rx_mode(dev);
658out:
659	netif_addr_unlock_bh(dev);
660	return err;
661}
662EXPORT_SYMBOL(dev_mc_add_excl);
663
664static int __dev_mc_add(struct net_device *dev, const unsigned char *addr,
665			bool global)
666{
667	int err;
668
669	netif_addr_lock_bh(dev);
670	err = __hw_addr_add_ex(&dev->mc, addr, dev->addr_len,
671			       NETDEV_HW_ADDR_T_MULTICAST, global, false, 0);
672	if (!err)
673		__dev_set_rx_mode(dev);
674	netif_addr_unlock_bh(dev);
675	return err;
676}
677/**
678 *	dev_mc_add - Add a multicast address
679 *	@dev: device
680 *	@addr: address to add
681 *
682 *	Add a multicast address to the device or increase
683 *	the reference count if it already exists.
684 */
685int dev_mc_add(struct net_device *dev, const unsigned char *addr)
686{
687	return __dev_mc_add(dev, addr, false);
688}
689EXPORT_SYMBOL(dev_mc_add);
690
691/**
692 *	dev_mc_add_global - Add a global multicast address
693 *	@dev: device
694 *	@addr: address to add
695 *
696 *	Add a global multicast address to the device.
697 */
698int dev_mc_add_global(struct net_device *dev, const unsigned char *addr)
699{
700	return __dev_mc_add(dev, addr, true);
701}
702EXPORT_SYMBOL(dev_mc_add_global);
703
704static int __dev_mc_del(struct net_device *dev, const unsigned char *addr,
705			bool global)
706{
707	int err;
708
709	netif_addr_lock_bh(dev);
710	err = __hw_addr_del_ex(&dev->mc, addr, dev->addr_len,
711			       NETDEV_HW_ADDR_T_MULTICAST, global, false);
712	if (!err)
713		__dev_set_rx_mode(dev);
714	netif_addr_unlock_bh(dev);
715	return err;
716}
717
718/**
719 *	dev_mc_del - Delete a multicast address.
720 *	@dev: device
721 *	@addr: address to delete
722 *
723 *	Release reference to a multicast address and remove it
724 *	from the device if the reference count drops to zero.
725 */
726int dev_mc_del(struct net_device *dev, const unsigned char *addr)
727{
728	return __dev_mc_del(dev, addr, false);
729}
730EXPORT_SYMBOL(dev_mc_del);
731
732/**
733 *	dev_mc_del_global - Delete a global multicast address.
734 *	@dev: device
735 *	@addr: address to delete
736 *
737 *	Release reference to a multicast address and remove it
738 *	from the device if the reference count drops to zero.
739 */
740int dev_mc_del_global(struct net_device *dev, const unsigned char *addr)
741{
742	return __dev_mc_del(dev, addr, true);
743}
744EXPORT_SYMBOL(dev_mc_del_global);
745
746/**
747 *	dev_mc_sync - Synchronize device's multicast list to another device
748 *	@to: destination device
749 *	@from: source device
750 *
751 *	Add newly added addresses to the destination device and release
752 *	addresses that have no users left. The source device must be
753 *	locked by netif_addr_lock_bh.
754 *
755 *	This function is intended to be called from the ndo_set_rx_mode
756 *	function of layered software devices.
757 */
758int dev_mc_sync(struct net_device *to, struct net_device *from)
759{
760	int err = 0;
761
762	if (to->addr_len != from->addr_len)
763		return -EINVAL;
764
765	netif_addr_lock_nested(to);
766	err = __hw_addr_sync(&to->mc, &from->mc, to->addr_len);
767	if (!err)
768		__dev_set_rx_mode(to);
769	netif_addr_unlock(to);
770	return err;
771}
772EXPORT_SYMBOL(dev_mc_sync);
773
774/**
775 *	dev_mc_sync_multiple - Synchronize device's multicast list to another
776 *	device, but allow for multiple calls to sync to multiple devices.
777 *	@to: destination device
778 *	@from: source device
779 *
780 *	Add newly added addresses to the destination device and release
781 *	addresses that have no users left. The source device must be
782 *	locked by netif_addr_lock_bh.
783 *
784 *	This function is intended to be called from the ndo_set_rx_mode
785 *	function of layered software devices.  It allows for a single
786 *	source device to be synced to multiple destination devices.
787 */
788int dev_mc_sync_multiple(struct net_device *to, struct net_device *from)
789{
790	int err = 0;
791
792	if (to->addr_len != from->addr_len)
793		return -EINVAL;
794
795	netif_addr_lock_nested(to);
796	err = __hw_addr_sync_multiple(&to->mc, &from->mc, to->addr_len);
797	if (!err)
798		__dev_set_rx_mode(to);
799	netif_addr_unlock(to);
800	return err;
801}
802EXPORT_SYMBOL(dev_mc_sync_multiple);
803
804/**
805 *	dev_mc_unsync - Remove synchronized addresses from the destination device
806 *	@to: destination device
807 *	@from: source device
808 *
809 *	Remove all addresses that were added to the destination device by
810 *	dev_mc_sync(). This function is intended to be called from the
811 *	dev->stop function of layered software devices.
812 */
813void dev_mc_unsync(struct net_device *to, struct net_device *from)
814{
815	if (to->addr_len != from->addr_len)
816		return;
817
818	netif_addr_lock_bh(from);
819	netif_addr_lock_nested(to);
820	__hw_addr_unsync(&to->mc, &from->mc, to->addr_len);
821	__dev_set_rx_mode(to);
822	netif_addr_unlock(to);
823	netif_addr_unlock_bh(from);
824}
825EXPORT_SYMBOL(dev_mc_unsync);
826
827/**
828 *	dev_mc_flush - Flush multicast addresses
829 *	@dev: device
830 *
831 *	Flush multicast addresses.
832 */
833void dev_mc_flush(struct net_device *dev)
834{
835	netif_addr_lock_bh(dev);
836	__hw_addr_flush(&dev->mc);
837	netif_addr_unlock_bh(dev);
838}
839EXPORT_SYMBOL(dev_mc_flush);
840
841/**
842 *	dev_mc_init - Init multicast address list
843 *	@dev: device
844 *
845 *	Init multicast address list.
846 */
847void dev_mc_init(struct net_device *dev)
848{
849	__hw_addr_init(&dev->mc);
850}
851EXPORT_SYMBOL(dev_mc_init);
v3.5.6
  1/*
  2 * net/core/dev_addr_lists.c - Functions for handling net device lists
  3 * Copyright (c) 2010 Jiri Pirko <jpirko@redhat.com>
  4 *
  5 * This file contains functions for working with unicast, multicast and device
  6 * addresses lists.
  7 *
  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.
 12 */
 13
 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>
 19
 20/*
 21 * General list handling functions
 22 */
 23
 24static int __hw_addr_create_ex(struct netdev_hw_addr_list *list,
 25			       unsigned char *addr, int addr_len,
 26			       unsigned char addr_type, bool global)
 
 27{
 28	struct netdev_hw_addr *ha;
 29	int alloc_size;
 30
 31	alloc_size = sizeof(*ha);
 32	if (alloc_size < L1_CACHE_BYTES)
 33		alloc_size = L1_CACHE_BYTES;
 34	ha = kmalloc(alloc_size, GFP_ATOMIC);
 35	if (!ha)
 36		return -ENOMEM;
 37	memcpy(ha->addr, addr, addr_len);
 38	ha->type = addr_type;
 39	ha->refcount = 1;
 40	ha->global_use = global;
 41	ha->synced = false;
 
 42	list_add_tail_rcu(&ha->list, &list->list);
 43	list->count++;
 44
 45	return 0;
 46}
 47
 48static int __hw_addr_add_ex(struct netdev_hw_addr_list *list,
 49			    unsigned char *addr, int addr_len,
 50			    unsigned char addr_type, bool global)
 
 51{
 52	struct netdev_hw_addr *ha;
 53
 54	if (addr_len > MAX_ADDR_LEN)
 55		return -EINVAL;
 56
 57	list_for_each_entry(ha, &list->list, list) {
 58		if (!memcmp(ha->addr, addr, addr_len) &&
 59		    ha->type == addr_type) {
 60			if (global) {
 61				/* check if addr is already used as global */
 62				if (ha->global_use)
 63					return 0;
 64				else
 65					ha->global_use = true;
 66			}
 
 
 
 
 
 
 67			ha->refcount++;
 68			return 0;
 69		}
 70	}
 71
 72	return __hw_addr_create_ex(list, addr, addr_len, addr_type, global);
 
 
 
 
 
 
 
 
 
 73}
 74
 75static int __hw_addr_add(struct netdev_hw_addr_list *list, unsigned char *addr,
 76			 int addr_len, unsigned char addr_type)
 
 77{
 78	return __hw_addr_add_ex(list, addr, addr_len, addr_type, false);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 79}
 80
 81static int __hw_addr_del_ex(struct netdev_hw_addr_list *list,
 82			    unsigned char *addr, int addr_len,
 83			    unsigned char addr_type, bool global)
 84{
 85	struct netdev_hw_addr *ha;
 86
 87	list_for_each_entry(ha, &list->list, list) {
 88		if (!memcmp(ha->addr, addr, addr_len) &&
 89		    (ha->type == addr_type || !addr_type)) {
 90			if (global) {
 91				if (!ha->global_use)
 92					break;
 93				else
 94					ha->global_use = false;
 95			}
 96			if (--ha->refcount)
 97				return 0;
 98			list_del_rcu(&ha->list);
 99			kfree_rcu(ha, rcu_head);
100			list->count--;
101			return 0;
102		}
103	}
104	return -ENOENT;
105}
106
107static int __hw_addr_del(struct netdev_hw_addr_list *list, unsigned char *addr,
108			 int addr_len, unsigned char addr_type)
 
109{
110	return __hw_addr_del_ex(list, addr, addr_len, addr_type, false);
111}
112
113int __hw_addr_add_multiple(struct netdev_hw_addr_list *to_list,
114			   struct netdev_hw_addr_list *from_list,
115			   int addr_len, unsigned char addr_type)
116{
117	int err;
118	struct netdev_hw_addr *ha, *ha2;
119	unsigned char type;
120
121	list_for_each_entry(ha, &from_list->list, list) {
122		type = addr_type ? addr_type : ha->type;
123		err = __hw_addr_add(to_list, ha->addr, addr_len, type);
124		if (err)
125			goto unroll;
 
 
 
126	}
 
127	return 0;
 
 
 
 
 
 
 
 
128
129unroll:
130	list_for_each_entry(ha2, &from_list->list, list) {
131		if (ha2 == ha)
132			break;
133		type = addr_type ? addr_type : ha2->type;
134		__hw_addr_del(to_list, ha2->addr, addr_len, type);
135	}
136	return err;
137}
138EXPORT_SYMBOL(__hw_addr_add_multiple);
139
140void __hw_addr_del_multiple(struct netdev_hw_addr_list *to_list,
141			    struct netdev_hw_addr_list *from_list,
142			    int addr_len, unsigned char addr_type)
143{
144	struct netdev_hw_addr *ha;
145	unsigned char type;
146
147	list_for_each_entry(ha, &from_list->list, list) {
148		type = addr_type ? addr_type : ha->type;
149		__hw_addr_del(to_list, ha->addr, addr_len, type);
 
 
 
 
 
150	}
 
151}
152EXPORT_SYMBOL(__hw_addr_del_multiple);
153
 
 
 
 
 
154int __hw_addr_sync(struct netdev_hw_addr_list *to_list,
155		   struct netdev_hw_addr_list *from_list,
156		   int addr_len)
157{
158	int err = 0;
159	struct netdev_hw_addr *ha, *tmp;
160
161	list_for_each_entry_safe(ha, tmp, &from_list->list, list) {
162		if (!ha->synced) {
163			err = __hw_addr_add(to_list, ha->addr,
164					    addr_len, ha->type);
165			if (err)
166				break;
167			ha->synced = true;
168			ha->refcount++;
169		} else if (ha->refcount == 1) {
170			__hw_addr_del(to_list, ha->addr, addr_len, ha->type);
171			__hw_addr_del(from_list, ha->addr, addr_len, ha->type);
172		}
173	}
174	return err;
175}
176EXPORT_SYMBOL(__hw_addr_sync);
177
178void __hw_addr_unsync(struct netdev_hw_addr_list *to_list,
179		      struct netdev_hw_addr_list *from_list,
180		      int addr_len)
181{
182	struct netdev_hw_addr *ha, *tmp;
183
184	list_for_each_entry_safe(ha, tmp, &from_list->list, list) {
185		if (ha->synced) {
186			__hw_addr_del(to_list, ha->addr,
187				      addr_len, ha->type);
188			ha->synced = false;
189			__hw_addr_del(from_list, ha->addr,
190				      addr_len, ha->type);
191		}
192	}
193}
194EXPORT_SYMBOL(__hw_addr_unsync);
195
196void __hw_addr_flush(struct netdev_hw_addr_list *list)
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
197{
198	struct netdev_hw_addr *ha, *tmp;
199
200	list_for_each_entry_safe(ha, tmp, &list->list, list) {
201		list_del_rcu(&ha->list);
202		kfree_rcu(ha, rcu_head);
203	}
204	list->count = 0;
205}
206EXPORT_SYMBOL(__hw_addr_flush);
207
208void __hw_addr_init(struct netdev_hw_addr_list *list)
209{
210	INIT_LIST_HEAD(&list->list);
211	list->count = 0;
212}
213EXPORT_SYMBOL(__hw_addr_init);
214
215/*
216 * Device addresses handling functions
217 */
218
219/**
220 *	dev_addr_flush - Flush device address list
221 *	@dev: device
222 *
223 *	Flush device address list and reset ->dev_addr.
224 *
225 *	The caller must hold the rtnl_mutex.
226 */
227void dev_addr_flush(struct net_device *dev)
228{
229	/* rtnl_mutex must be held here */
230
231	__hw_addr_flush(&dev->dev_addrs);
232	dev->dev_addr = NULL;
233}
234EXPORT_SYMBOL(dev_addr_flush);
235
236/**
237 *	dev_addr_init - Init device address list
238 *	@dev: device
239 *
240 *	Init device address list and create the first element,
241 *	used by ->dev_addr.
242 *
243 *	The caller must hold the rtnl_mutex.
244 */
245int dev_addr_init(struct net_device *dev)
246{
247	unsigned char addr[MAX_ADDR_LEN];
248	struct netdev_hw_addr *ha;
249	int err;
250
251	/* rtnl_mutex must be held here */
252
253	__hw_addr_init(&dev->dev_addrs);
254	memset(addr, 0, sizeof(addr));
255	err = __hw_addr_add(&dev->dev_addrs, addr, sizeof(addr),
256			    NETDEV_HW_ADDR_T_LAN);
257	if (!err) {
258		/*
259		 * Get the first (previously created) address from the list
260		 * and set dev_addr pointer to this location.
261		 */
262		ha = list_first_entry(&dev->dev_addrs.list,
263				      struct netdev_hw_addr, list);
264		dev->dev_addr = ha->addr;
265	}
266	return err;
267}
268EXPORT_SYMBOL(dev_addr_init);
269
270/**
271 *	dev_addr_add - Add a device address
272 *	@dev: device
273 *	@addr: address to add
274 *	@addr_type: address type
275 *
276 *	Add a device address to the device or increase the reference count if
277 *	it already exists.
278 *
279 *	The caller must hold the rtnl_mutex.
280 */
281int dev_addr_add(struct net_device *dev, unsigned char *addr,
282		 unsigned char addr_type)
283{
284	int err;
285
286	ASSERT_RTNL();
287
288	err = __hw_addr_add(&dev->dev_addrs, addr, dev->addr_len, addr_type);
289	if (!err)
290		call_netdevice_notifiers(NETDEV_CHANGEADDR, dev);
291	return err;
292}
293EXPORT_SYMBOL(dev_addr_add);
294
295/**
296 *	dev_addr_del - Release a device address.
297 *	@dev: device
298 *	@addr: address to delete
299 *	@addr_type: address type
300 *
301 *	Release reference to a device address and remove it from the device
302 *	if the reference count drops to zero.
303 *
304 *	The caller must hold the rtnl_mutex.
305 */
306int dev_addr_del(struct net_device *dev, unsigned char *addr,
307		 unsigned char addr_type)
308{
309	int err;
310	struct netdev_hw_addr *ha;
311
312	ASSERT_RTNL();
313
314	/*
315	 * We can not remove the first address from the list because
316	 * dev->dev_addr points to that.
317	 */
318	ha = list_first_entry(&dev->dev_addrs.list,
319			      struct netdev_hw_addr, list);
320	if (ha->addr == dev->dev_addr && ha->refcount == 1)
 
321		return -ENOENT;
322
323	err = __hw_addr_del(&dev->dev_addrs, addr, dev->addr_len,
324			    addr_type);
325	if (!err)
326		call_netdevice_notifiers(NETDEV_CHANGEADDR, dev);
327	return err;
328}
329EXPORT_SYMBOL(dev_addr_del);
330
331/**
332 *	dev_addr_add_multiple - Add device addresses from another device
333 *	@to_dev: device to which addresses will be added
334 *	@from_dev: device from which addresses will be added
335 *	@addr_type: address type - 0 means type will be used from from_dev
336 *
337 *	Add device addresses of the one device to another.
338 **
339 *	The caller must hold the rtnl_mutex.
340 */
341int dev_addr_add_multiple(struct net_device *to_dev,
342			  struct net_device *from_dev,
343			  unsigned char addr_type)
344{
345	int err;
346
347	ASSERT_RTNL();
348
349	if (from_dev->addr_len != to_dev->addr_len)
350		return -EINVAL;
351	err = __hw_addr_add_multiple(&to_dev->dev_addrs, &from_dev->dev_addrs,
352				     to_dev->addr_len, addr_type);
353	if (!err)
354		call_netdevice_notifiers(NETDEV_CHANGEADDR, to_dev);
355	return err;
356}
357EXPORT_SYMBOL(dev_addr_add_multiple);
358
359/**
360 *	dev_addr_del_multiple - Delete device addresses by another device
361 *	@to_dev: device where the addresses will be deleted
362 *	@from_dev: device supplying the addresses to be deleted
363 *	@addr_type: address type - 0 means type will be used from from_dev
364 *
365 *	Deletes addresses in to device by the list of addresses in from device.
366 *
367 *	The caller must hold the rtnl_mutex.
368 */
369int dev_addr_del_multiple(struct net_device *to_dev,
370			  struct net_device *from_dev,
371			  unsigned char addr_type)
372{
373	ASSERT_RTNL();
374
375	if (from_dev->addr_len != to_dev->addr_len)
376		return -EINVAL;
377	__hw_addr_del_multiple(&to_dev->dev_addrs, &from_dev->dev_addrs,
378			       to_dev->addr_len, addr_type);
379	call_netdevice_notifiers(NETDEV_CHANGEADDR, to_dev);
380	return 0;
381}
382EXPORT_SYMBOL(dev_addr_del_multiple);
383
384/*
385 * Unicast list handling functions
386 */
387
388/**
389 *	dev_uc_add_excl - Add a global secondary unicast address
390 *	@dev: device
391 *	@addr: address to add
392 */
393int dev_uc_add_excl(struct net_device *dev, unsigned char *addr)
394{
395	struct netdev_hw_addr *ha;
396	int err;
397
398	netif_addr_lock_bh(dev);
399	list_for_each_entry(ha, &dev->uc.list, list) {
400		if (!memcmp(ha->addr, addr, dev->addr_len) &&
401		    ha->type == NETDEV_HW_ADDR_T_UNICAST) {
402			err = -EEXIST;
403			goto out;
404		}
405	}
406	err = __hw_addr_create_ex(&dev->uc, addr, dev->addr_len,
407				  NETDEV_HW_ADDR_T_UNICAST, true);
408	if (!err)
409		__dev_set_rx_mode(dev);
410out:
411	netif_addr_unlock_bh(dev);
412	return err;
413}
414EXPORT_SYMBOL(dev_uc_add_excl);
415
416/**
417 *	dev_uc_add - Add a secondary unicast address
418 *	@dev: device
419 *	@addr: address to add
420 *
421 *	Add a secondary unicast address to the device or increase
422 *	the reference count if it already exists.
423 */
424int dev_uc_add(struct net_device *dev, unsigned char *addr)
425{
426	int err;
427
428	netif_addr_lock_bh(dev);
429	err = __hw_addr_add(&dev->uc, addr, dev->addr_len,
430			    NETDEV_HW_ADDR_T_UNICAST);
431	if (!err)
432		__dev_set_rx_mode(dev);
433	netif_addr_unlock_bh(dev);
434	return err;
435}
436EXPORT_SYMBOL(dev_uc_add);
437
438/**
439 *	dev_uc_del - Release secondary unicast address.
440 *	@dev: device
441 *	@addr: address to delete
442 *
443 *	Release reference to a secondary unicast address and remove it
444 *	from the device if the reference count drops to zero.
445 */
446int dev_uc_del(struct net_device *dev, unsigned char *addr)
447{
448	int err;
449
450	netif_addr_lock_bh(dev);
451	err = __hw_addr_del(&dev->uc, addr, dev->addr_len,
452			    NETDEV_HW_ADDR_T_UNICAST);
453	if (!err)
454		__dev_set_rx_mode(dev);
455	netif_addr_unlock_bh(dev);
456	return err;
457}
458EXPORT_SYMBOL(dev_uc_del);
459
460/**
461 *	dev_uc_sync - Synchronize device's unicast list to another device
462 *	@to: destination device
463 *	@from: source device
464 *
465 *	Add newly added addresses to the destination device and release
466 *	addresses that have no users left. The source device must be
467 *	locked by netif_addr_lock_bh.
468 *
469 *	This function is intended to be called from the dev->set_rx_mode
470 *	function of layered software devices.
 
471 */
472int dev_uc_sync(struct net_device *to, struct net_device *from)
473{
474	int err = 0;
475
476	if (to->addr_len != from->addr_len)
477		return -EINVAL;
478
479	netif_addr_lock_nested(to);
480	err = __hw_addr_sync(&to->uc, &from->uc, to->addr_len);
481	if (!err)
482		__dev_set_rx_mode(to);
483	netif_addr_unlock(to);
484	return err;
485}
486EXPORT_SYMBOL(dev_uc_sync);
487
488/**
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
489 *	dev_uc_unsync - Remove synchronized addresses from the destination device
490 *	@to: destination device
491 *	@from: source device
492 *
493 *	Remove all addresses that were added to the destination device by
494 *	dev_uc_sync(). This function is intended to be called from the
495 *	dev->stop function of layered software devices.
496 */
497void dev_uc_unsync(struct net_device *to, struct net_device *from)
498{
499	if (to->addr_len != from->addr_len)
500		return;
501
502	netif_addr_lock_bh(from);
503	netif_addr_lock_nested(to);
504	__hw_addr_unsync(&to->uc, &from->uc, to->addr_len);
505	__dev_set_rx_mode(to);
506	netif_addr_unlock(to);
507	netif_addr_unlock_bh(from);
508}
509EXPORT_SYMBOL(dev_uc_unsync);
510
511/**
512 *	dev_uc_flush - Flush unicast addresses
513 *	@dev: device
514 *
515 *	Flush unicast addresses.
516 */
517void dev_uc_flush(struct net_device *dev)
518{
519	netif_addr_lock_bh(dev);
520	__hw_addr_flush(&dev->uc);
521	netif_addr_unlock_bh(dev);
522}
523EXPORT_SYMBOL(dev_uc_flush);
524
525/**
526 *	dev_uc_flush - Init unicast address list
527 *	@dev: device
528 *
529 *	Init unicast address list.
530 */
531void dev_uc_init(struct net_device *dev)
532{
533	__hw_addr_init(&dev->uc);
534}
535EXPORT_SYMBOL(dev_uc_init);
536
537/*
538 * Multicast list handling functions
539 */
540
541/**
542 *	dev_mc_add_excl - Add a global secondary multicast address
543 *	@dev: device
544 *	@addr: address to add
545 */
546int dev_mc_add_excl(struct net_device *dev, unsigned char *addr)
547{
548	struct netdev_hw_addr *ha;
549	int err;
550
551	netif_addr_lock_bh(dev);
552	list_for_each_entry(ha, &dev->mc.list, list) {
553		if (!memcmp(ha->addr, addr, dev->addr_len) &&
554		    ha->type == NETDEV_HW_ADDR_T_MULTICAST) {
555			err = -EEXIST;
556			goto out;
557		}
558	}
559	err = __hw_addr_create_ex(&dev->mc, addr, dev->addr_len,
560				  NETDEV_HW_ADDR_T_MULTICAST, true);
561	if (!err)
562		__dev_set_rx_mode(dev);
563out:
564	netif_addr_unlock_bh(dev);
565	return err;
566}
567EXPORT_SYMBOL(dev_mc_add_excl);
568
569static int __dev_mc_add(struct net_device *dev, unsigned char *addr,
570			bool global)
571{
572	int err;
573
574	netif_addr_lock_bh(dev);
575	err = __hw_addr_add_ex(&dev->mc, addr, dev->addr_len,
576			       NETDEV_HW_ADDR_T_MULTICAST, global);
577	if (!err)
578		__dev_set_rx_mode(dev);
579	netif_addr_unlock_bh(dev);
580	return err;
581}
582/**
583 *	dev_mc_add - Add a multicast address
584 *	@dev: device
585 *	@addr: address to add
586 *
587 *	Add a multicast address to the device or increase
588 *	the reference count if it already exists.
589 */
590int dev_mc_add(struct net_device *dev, unsigned char *addr)
591{
592	return __dev_mc_add(dev, addr, false);
593}
594EXPORT_SYMBOL(dev_mc_add);
595
596/**
597 *	dev_mc_add_global - Add a global multicast address
598 *	@dev: device
599 *	@addr: address to add
600 *
601 *	Add a global multicast address to the device.
602 */
603int dev_mc_add_global(struct net_device *dev, unsigned char *addr)
604{
605	return __dev_mc_add(dev, addr, true);
606}
607EXPORT_SYMBOL(dev_mc_add_global);
608
609static int __dev_mc_del(struct net_device *dev, unsigned char *addr,
610			bool global)
611{
612	int err;
613
614	netif_addr_lock_bh(dev);
615	err = __hw_addr_del_ex(&dev->mc, addr, dev->addr_len,
616			       NETDEV_HW_ADDR_T_MULTICAST, global);
617	if (!err)
618		__dev_set_rx_mode(dev);
619	netif_addr_unlock_bh(dev);
620	return err;
621}
622
623/**
624 *	dev_mc_del - Delete a multicast address.
625 *	@dev: device
626 *	@addr: address to delete
627 *
628 *	Release reference to a multicast address and remove it
629 *	from the device if the reference count drops to zero.
630 */
631int dev_mc_del(struct net_device *dev, unsigned char *addr)
632{
633	return __dev_mc_del(dev, addr, false);
634}
635EXPORT_SYMBOL(dev_mc_del);
636
637/**
638 *	dev_mc_del_global - Delete a global multicast address.
639 *	@dev: device
640 *	@addr: address to delete
641 *
642 *	Release reference to a multicast address and remove it
643 *	from the device if the reference count drops to zero.
644 */
645int dev_mc_del_global(struct net_device *dev, unsigned char *addr)
646{
647	return __dev_mc_del(dev, addr, true);
648}
649EXPORT_SYMBOL(dev_mc_del_global);
650
651/**
652 *	dev_mc_sync - Synchronize device's unicast list to another device
653 *	@to: destination device
654 *	@from: source device
655 *
656 *	Add newly added addresses to the destination device and release
657 *	addresses that have no users left. The source device must be
658 *	locked by netif_addr_lock_bh.
659 *
660 *	This function is intended to be called from the ndo_set_rx_mode
661 *	function of layered software devices.
662 */
663int dev_mc_sync(struct net_device *to, struct net_device *from)
664{
665	int err = 0;
666
667	if (to->addr_len != from->addr_len)
668		return -EINVAL;
669
670	netif_addr_lock_nested(to);
671	err = __hw_addr_sync(&to->mc, &from->mc, to->addr_len);
672	if (!err)
673		__dev_set_rx_mode(to);
674	netif_addr_unlock(to);
675	return err;
676}
677EXPORT_SYMBOL(dev_mc_sync);
678
679/**
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
680 *	dev_mc_unsync - Remove synchronized addresses from the destination device
681 *	@to: destination device
682 *	@from: source device
683 *
684 *	Remove all addresses that were added to the destination device by
685 *	dev_mc_sync(). This function is intended to be called from the
686 *	dev->stop function of layered software devices.
687 */
688void dev_mc_unsync(struct net_device *to, struct net_device *from)
689{
690	if (to->addr_len != from->addr_len)
691		return;
692
693	netif_addr_lock_bh(from);
694	netif_addr_lock_nested(to);
695	__hw_addr_unsync(&to->mc, &from->mc, to->addr_len);
696	__dev_set_rx_mode(to);
697	netif_addr_unlock(to);
698	netif_addr_unlock_bh(from);
699}
700EXPORT_SYMBOL(dev_mc_unsync);
701
702/**
703 *	dev_mc_flush - Flush multicast addresses
704 *	@dev: device
705 *
706 *	Flush multicast addresses.
707 */
708void dev_mc_flush(struct net_device *dev)
709{
710	netif_addr_lock_bh(dev);
711	__hw_addr_flush(&dev->mc);
712	netif_addr_unlock_bh(dev);
713}
714EXPORT_SYMBOL(dev_mc_flush);
715
716/**
717 *	dev_mc_flush - Init multicast address list
718 *	@dev: device
719 *
720 *	Init multicast address list.
721 */
722void dev_mc_init(struct net_device *dev)
723{
724	__hw_addr_init(&dev->mc);
725}
726EXPORT_SYMBOL(dev_mc_init);
727
728#ifdef CONFIG_PROC_FS
729#include <linux/seq_file.h>
730
731static int dev_mc_seq_show(struct seq_file *seq, void *v)
732{
733	struct netdev_hw_addr *ha;
734	struct net_device *dev = v;
735
736	if (v == SEQ_START_TOKEN)
737		return 0;
738
739	netif_addr_lock_bh(dev);
740	netdev_for_each_mc_addr(ha, dev) {
741		int i;
742
743		seq_printf(seq, "%-4d %-15s %-5d %-5d ", dev->ifindex,
744			   dev->name, ha->refcount, ha->global_use);
745
746		for (i = 0; i < dev->addr_len; i++)
747			seq_printf(seq, "%02x", ha->addr[i]);
748
749		seq_putc(seq, '\n');
750	}
751	netif_addr_unlock_bh(dev);
752	return 0;
753}
754
755static const struct seq_operations dev_mc_seq_ops = {
756	.start = dev_seq_start,
757	.next  = dev_seq_next,
758	.stop  = dev_seq_stop,
759	.show  = dev_mc_seq_show,
760};
761
762static int dev_mc_seq_open(struct inode *inode, struct file *file)
763{
764	return seq_open_net(inode, file, &dev_mc_seq_ops,
765			    sizeof(struct seq_net_private));
766}
767
768static const struct file_operations dev_mc_seq_fops = {
769	.owner	 = THIS_MODULE,
770	.open    = dev_mc_seq_open,
771	.read    = seq_read,
772	.llseek  = seq_lseek,
773	.release = seq_release_net,
774};
775
776#endif
777
778static int __net_init dev_mc_net_init(struct net *net)
779{
780	if (!proc_net_fops_create(net, "dev_mcast", 0, &dev_mc_seq_fops))
781		return -ENOMEM;
782	return 0;
783}
784
785static void __net_exit dev_mc_net_exit(struct net *net)
786{
787	proc_net_remove(net, "dev_mcast");
788}
789
790static struct pernet_operations __net_initdata dev_mc_net_ops = {
791	.init = dev_mc_net_init,
792	.exit = dev_mc_net_exit,
793};
794
795void __init dev_mcast_init(void)
796{
797	register_pernet_subsys(&dev_mc_net_ops);
798}
799