2 * originally based on the dummy device.
4 * Copyright 1999, Thomas Davis, tadavis@lbl.gov.
5 * Licensed under the GPL. Based on dummy.c, and eql.c devices.
7 * bonding.c: an Ethernet Bonding driver
9 * This is useful to talk to a Cisco EtherChannel compatible equipment:
11 * Sun Trunking (Solaris)
12 * Alteon AceDirector Trunks
14 * and probably many L2 switches ...
17 * ifconfig bond0 ipaddress netmask up
18 * will setup a network device, with an ip address. No mac address
19 * will be assigned at this time. The hw mac address will come from
20 * the first slave bonded to the channel. All slaves will then use
21 * this hw mac address.
24 * will release all slaves, marking them as down.
26 * ifenslave bond0 eth0
27 * will attach eth0 to bond0 as a slave. eth0 hw mac address will either
28 * a: be used as initial mac address
29 * b: if a hw mac address already is there, eth0's hw mac address
30 * will then be set from bond0.
34 //#define BONDING_DEBUG 1
36 #include <linux/kernel.h>
37 #include <linux/module.h>
38 #include <linux/types.h>
39 #include <linux/fcntl.h>
40 #include <linux/interrupt.h>
41 #include <linux/ptrace.h>
42 #include <linux/ioport.h>
46 #include <linux/tcp.h>
47 #include <linux/udp.h>
48 #include <linux/slab.h>
49 #include <linux/string.h>
50 #include <linux/init.h>
51 #include <linux/timer.h>
52 #include <linux/socket.h>
53 #include <linux/ctype.h>
54 #include <linux/inet.h>
55 #include <linux/bitops.h>
56 #include <asm/system.h>
59 #include <asm/uaccess.h>
60 #include <linux/errno.h>
61 #include <linux/netdevice.h>
62 #include <linux/inetdevice.h>
63 #include <linux/igmp.h>
64 #include <linux/etherdevice.h>
65 #include <linux/skbuff.h>
67 #include <linux/rtnetlink.h>
68 #include <linux/proc_fs.h>
69 #include <linux/seq_file.h>
70 #include <linux/smp.h>
71 #include <linux/if_ether.h>
73 #include <linux/mii.h>
74 #include <linux/ethtool.h>
75 #include <linux/if_vlan.h>
76 #include <linux/if_bonding.h>
77 #include <linux/jiffies.h>
78 #include <net/route.h>
79 #include <net/net_namespace.h>
84 /*---------------------------- Module parameters ----------------------------*/
86 /* monitor all links that often (in milliseconds). <=0 disables monitoring */
87 #define BOND_LINK_MON_INTERV 0
88 #define BOND_LINK_ARP_INTERV 0
90 static int max_bonds = BOND_DEFAULT_MAX_BONDS;
91 static int miimon = BOND_LINK_MON_INTERV;
92 static int updelay = 0;
93 static int downdelay = 0;
94 static int use_carrier = 1;
95 static char *mode = NULL;
96 static char *primary = NULL;
97 static char *lacp_rate = NULL;
98 static char *xmit_hash_policy = NULL;
99 static int arp_interval = BOND_LINK_ARP_INTERV;
100 static char *arp_ip_target[BOND_MAX_ARP_TARGETS] = { NULL, };
101 static char *arp_validate = NULL;
102 static int fail_over_mac = 0;
103 struct bond_params bonding_defaults;
105 module_param(max_bonds, int, 0);
106 MODULE_PARM_DESC(max_bonds, "Max number of bonded devices");
107 module_param(miimon, int, 0);
108 MODULE_PARM_DESC(miimon, "Link check interval in milliseconds");
109 module_param(updelay, int, 0);
110 MODULE_PARM_DESC(updelay, "Delay before considering link up, in milliseconds");
111 module_param(downdelay, int, 0);
112 MODULE_PARM_DESC(downdelay, "Delay before considering link down, "
114 module_param(use_carrier, int, 0);
115 MODULE_PARM_DESC(use_carrier, "Use netif_carrier_ok (vs MII ioctls) in miimon; "
116 "0 for off, 1 for on (default)");
117 module_param(mode, charp, 0);
118 MODULE_PARM_DESC(mode, "Mode of operation : 0 for balance-rr, "
119 "1 for active-backup, 2 for balance-xor, "
120 "3 for broadcast, 4 for 802.3ad, 5 for balance-tlb, "
121 "6 for balance-alb");
122 module_param(primary, charp, 0);
123 MODULE_PARM_DESC(primary, "Primary network device to use");
124 module_param(lacp_rate, charp, 0);
125 MODULE_PARM_DESC(lacp_rate, "LACPDU tx rate to request from 802.3ad partner "
127 module_param(xmit_hash_policy, charp, 0);
128 MODULE_PARM_DESC(xmit_hash_policy, "XOR hashing method: 0 for layer 2 (default)"
129 ", 1 for layer 3+4");
130 module_param(arp_interval, int, 0);
131 MODULE_PARM_DESC(arp_interval, "arp interval in milliseconds");
132 module_param_array(arp_ip_target, charp, NULL, 0);
133 MODULE_PARM_DESC(arp_ip_target, "arp targets in n.n.n.n form");
134 module_param(arp_validate, charp, 0);
135 MODULE_PARM_DESC(arp_validate, "validate src/dst of ARP probes: none (default), active, backup or all");
136 module_param(fail_over_mac, int, 0);
137 MODULE_PARM_DESC(fail_over_mac, "For active-backup, do not set all slaves to the same MAC. 0 of off (default), 1 for on.");
139 /*----------------------------- Global variables ----------------------------*/
141 static const char * const version =
142 DRV_DESCRIPTION ": v" DRV_VERSION " (" DRV_RELDATE ")\n";
144 LIST_HEAD(bond_dev_list);
146 #ifdef CONFIG_PROC_FS
147 static struct proc_dir_entry *bond_proc_dir = NULL;
150 extern struct rw_semaphore bonding_rwsem;
151 static __be32 arp_target[BOND_MAX_ARP_TARGETS] = { 0, } ;
152 static int arp_ip_count = 0;
153 static int bond_mode = BOND_MODE_ROUNDROBIN;
154 static int xmit_hashtype= BOND_XMIT_POLICY_LAYER2;
155 static int lacp_fast = 0;
158 struct bond_parm_tbl bond_lacp_tbl[] = {
159 { "slow", AD_LACP_SLOW},
160 { "fast", AD_LACP_FAST},
164 struct bond_parm_tbl bond_mode_tbl[] = {
165 { "balance-rr", BOND_MODE_ROUNDROBIN},
166 { "active-backup", BOND_MODE_ACTIVEBACKUP},
167 { "balance-xor", BOND_MODE_XOR},
168 { "broadcast", BOND_MODE_BROADCAST},
169 { "802.3ad", BOND_MODE_8023AD},
170 { "balance-tlb", BOND_MODE_TLB},
171 { "balance-alb", BOND_MODE_ALB},
175 struct bond_parm_tbl xmit_hashtype_tbl[] = {
176 { "layer2", BOND_XMIT_POLICY_LAYER2},
177 { "layer3+4", BOND_XMIT_POLICY_LAYER34},
178 { "layer2+3", BOND_XMIT_POLICY_LAYER23},
182 struct bond_parm_tbl arp_validate_tbl[] = {
183 { "none", BOND_ARP_VALIDATE_NONE},
184 { "active", BOND_ARP_VALIDATE_ACTIVE},
185 { "backup", BOND_ARP_VALIDATE_BACKUP},
186 { "all", BOND_ARP_VALIDATE_ALL},
190 /*-------------------------- Forward declarations ---------------------------*/
192 static void bond_send_gratuitous_arp(struct bonding *bond);
193 static void bond_deinit(struct net_device *bond_dev);
195 /*---------------------------- General routines -----------------------------*/
197 static const char *bond_mode_name(int mode)
200 case BOND_MODE_ROUNDROBIN :
201 return "load balancing (round-robin)";
202 case BOND_MODE_ACTIVEBACKUP :
203 return "fault-tolerance (active-backup)";
205 return "load balancing (xor)";
206 case BOND_MODE_BROADCAST :
207 return "fault-tolerance (broadcast)";
208 case BOND_MODE_8023AD:
209 return "IEEE 802.3ad Dynamic link aggregation";
211 return "transmit load balancing";
213 return "adaptive load balancing";
219 /*---------------------------------- VLAN -----------------------------------*/
222 * bond_add_vlan - add a new vlan id on bond
223 * @bond: bond that got the notification
224 * @vlan_id: the vlan id to add
226 * Returns -ENOMEM if allocation failed.
228 static int bond_add_vlan(struct bonding *bond, unsigned short vlan_id)
230 struct vlan_entry *vlan;
232 dprintk("bond: %s, vlan id %d\n",
233 (bond ? bond->dev->name: "None"), vlan_id);
235 vlan = kmalloc(sizeof(struct vlan_entry), GFP_KERNEL);
240 INIT_LIST_HEAD(&vlan->vlan_list);
241 vlan->vlan_id = vlan_id;
244 write_lock_bh(&bond->lock);
246 list_add_tail(&vlan->vlan_list, &bond->vlan_list);
248 write_unlock_bh(&bond->lock);
250 dprintk("added VLAN ID %d on bond %s\n", vlan_id, bond->dev->name);
256 * bond_del_vlan - delete a vlan id from bond
257 * @bond: bond that got the notification
258 * @vlan_id: the vlan id to delete
260 * returns -ENODEV if @vlan_id was not found in @bond.
262 static int bond_del_vlan(struct bonding *bond, unsigned short vlan_id)
264 struct vlan_entry *vlan, *next;
267 dprintk("bond: %s, vlan id %d\n", bond->dev->name, vlan_id);
269 write_lock_bh(&bond->lock);
271 list_for_each_entry_safe(vlan, next, &bond->vlan_list, vlan_list) {
272 if (vlan->vlan_id == vlan_id) {
273 list_del(&vlan->vlan_list);
275 if ((bond->params.mode == BOND_MODE_TLB) ||
276 (bond->params.mode == BOND_MODE_ALB)) {
277 bond_alb_clear_vlan(bond, vlan_id);
280 dprintk("removed VLAN ID %d from bond %s\n", vlan_id,
285 if (list_empty(&bond->vlan_list) &&
286 (bond->slave_cnt == 0)) {
287 /* Last VLAN removed and no slaves, so
288 * restore block on adding VLANs. This will
289 * be removed once new slaves that are not
290 * VLAN challenged will be added.
292 bond->dev->features |= NETIF_F_VLAN_CHALLENGED;
300 dprintk("couldn't find VLAN ID %d in bond %s\n", vlan_id,
304 write_unlock_bh(&bond->lock);
309 * bond_has_challenged_slaves
310 * @bond: the bond we're working on
312 * Searches the slave list. Returns 1 if a vlan challenged slave
313 * was found, 0 otherwise.
315 * Assumes bond->lock is held.
317 static int bond_has_challenged_slaves(struct bonding *bond)
322 bond_for_each_slave(bond, slave, i) {
323 if (slave->dev->features & NETIF_F_VLAN_CHALLENGED) {
324 dprintk("found VLAN challenged slave - %s\n",
330 dprintk("no VLAN challenged slaves found\n");
335 * bond_next_vlan - safely skip to the next item in the vlans list.
336 * @bond: the bond we're working on
337 * @curr: item we're advancing from
339 * Returns %NULL if list is empty, bond->next_vlan if @curr is %NULL,
340 * or @curr->next otherwise (even if it is @curr itself again).
342 * Caller must hold bond->lock
344 struct vlan_entry *bond_next_vlan(struct bonding *bond, struct vlan_entry *curr)
346 struct vlan_entry *next, *last;
348 if (list_empty(&bond->vlan_list)) {
353 next = list_entry(bond->vlan_list.next,
354 struct vlan_entry, vlan_list);
356 last = list_entry(bond->vlan_list.prev,
357 struct vlan_entry, vlan_list);
359 next = list_entry(bond->vlan_list.next,
360 struct vlan_entry, vlan_list);
362 next = list_entry(curr->vlan_list.next,
363 struct vlan_entry, vlan_list);
371 * bond_dev_queue_xmit - Prepare skb for xmit.
373 * @bond: bond device that got this skb for tx.
374 * @skb: hw accel VLAN tagged skb to transmit
375 * @slave_dev: slave that is supposed to xmit this skbuff
377 * When the bond gets an skb to transmit that is
378 * already hardware accelerated VLAN tagged, and it
379 * needs to relay this skb to a slave that is not
380 * hw accel capable, the skb needs to be "unaccelerated",
381 * i.e. strip the hwaccel tag and re-insert it as part
384 int bond_dev_queue_xmit(struct bonding *bond, struct sk_buff *skb, struct net_device *slave_dev)
386 unsigned short uninitialized_var(vlan_id);
388 if (!list_empty(&bond->vlan_list) &&
389 !(slave_dev->features & NETIF_F_HW_VLAN_TX) &&
390 vlan_get_tag(skb, &vlan_id) == 0) {
391 skb->dev = slave_dev;
392 skb = vlan_put_tag(skb, vlan_id);
394 /* vlan_put_tag() frees the skb in case of error,
395 * so return success here so the calling functions
396 * won't attempt to free is again.
401 skb->dev = slave_dev;
411 * In the following 3 functions, bond_vlan_rx_register(), bond_vlan_rx_add_vid
412 * and bond_vlan_rx_kill_vid, We don't protect the slave list iteration with a
414 * a. This operation is performed in IOCTL context,
415 * b. The operation is protected by the RTNL semaphore in the 8021q code,
416 * c. Holding a lock with BH disabled while directly calling a base driver
417 * entry point is generally a BAD idea.
419 * The design of synchronization/protection for this operation in the 8021q
420 * module is good for one or more VLAN devices over a single physical device
421 * and cannot be extended for a teaming solution like bonding, so there is a
422 * potential race condition here where a net device from the vlan group might
423 * be referenced (either by a base driver or the 8021q code) while it is being
424 * removed from the system. However, it turns out we're not making matters
425 * worse, and if it works for regular VLAN usage it will work here too.
429 * bond_vlan_rx_register - Propagates registration to slaves
430 * @bond_dev: bonding net device that got called
431 * @grp: vlan group being registered
433 static void bond_vlan_rx_register(struct net_device *bond_dev, struct vlan_group *grp)
435 struct bonding *bond = bond_dev->priv;
441 bond_for_each_slave(bond, slave, i) {
442 struct net_device *slave_dev = slave->dev;
444 if ((slave_dev->features & NETIF_F_HW_VLAN_RX) &&
445 slave_dev->vlan_rx_register) {
446 slave_dev->vlan_rx_register(slave_dev, grp);
452 * bond_vlan_rx_add_vid - Propagates adding an id to slaves
453 * @bond_dev: bonding net device that got called
454 * @vid: vlan id being added
456 static void bond_vlan_rx_add_vid(struct net_device *bond_dev, uint16_t vid)
458 struct bonding *bond = bond_dev->priv;
462 bond_for_each_slave(bond, slave, i) {
463 struct net_device *slave_dev = slave->dev;
465 if ((slave_dev->features & NETIF_F_HW_VLAN_FILTER) &&
466 slave_dev->vlan_rx_add_vid) {
467 slave_dev->vlan_rx_add_vid(slave_dev, vid);
471 res = bond_add_vlan(bond, vid);
473 printk(KERN_ERR DRV_NAME
474 ": %s: Error: Failed to add vlan id %d\n",
475 bond_dev->name, vid);
480 * bond_vlan_rx_kill_vid - Propagates deleting an id to slaves
481 * @bond_dev: bonding net device that got called
482 * @vid: vlan id being removed
484 static void bond_vlan_rx_kill_vid(struct net_device *bond_dev, uint16_t vid)
486 struct bonding *bond = bond_dev->priv;
488 struct net_device *vlan_dev;
491 bond_for_each_slave(bond, slave, i) {
492 struct net_device *slave_dev = slave->dev;
494 if ((slave_dev->features & NETIF_F_HW_VLAN_FILTER) &&
495 slave_dev->vlan_rx_kill_vid) {
496 /* Save and then restore vlan_dev in the grp array,
497 * since the slave's driver might clear it.
499 vlan_dev = vlan_group_get_device(bond->vlgrp, vid);
500 slave_dev->vlan_rx_kill_vid(slave_dev, vid);
501 vlan_group_set_device(bond->vlgrp, vid, vlan_dev);
505 res = bond_del_vlan(bond, vid);
507 printk(KERN_ERR DRV_NAME
508 ": %s: Error: Failed to remove vlan id %d\n",
509 bond_dev->name, vid);
513 static void bond_add_vlans_on_slave(struct bonding *bond, struct net_device *slave_dev)
515 struct vlan_entry *vlan;
517 write_lock_bh(&bond->lock);
519 if (list_empty(&bond->vlan_list)) {
523 if ((slave_dev->features & NETIF_F_HW_VLAN_RX) &&
524 slave_dev->vlan_rx_register) {
525 slave_dev->vlan_rx_register(slave_dev, bond->vlgrp);
528 if (!(slave_dev->features & NETIF_F_HW_VLAN_FILTER) ||
529 !(slave_dev->vlan_rx_add_vid)) {
533 list_for_each_entry(vlan, &bond->vlan_list, vlan_list) {
534 slave_dev->vlan_rx_add_vid(slave_dev, vlan->vlan_id);
538 write_unlock_bh(&bond->lock);
541 static void bond_del_vlans_from_slave(struct bonding *bond, struct net_device *slave_dev)
543 struct vlan_entry *vlan;
544 struct net_device *vlan_dev;
546 write_lock_bh(&bond->lock);
548 if (list_empty(&bond->vlan_list)) {
552 if (!(slave_dev->features & NETIF_F_HW_VLAN_FILTER) ||
553 !(slave_dev->vlan_rx_kill_vid)) {
557 list_for_each_entry(vlan, &bond->vlan_list, vlan_list) {
558 /* Save and then restore vlan_dev in the grp array,
559 * since the slave's driver might clear it.
561 vlan_dev = vlan_group_get_device(bond->vlgrp, vlan->vlan_id);
562 slave_dev->vlan_rx_kill_vid(slave_dev, vlan->vlan_id);
563 vlan_group_set_device(bond->vlgrp, vlan->vlan_id, vlan_dev);
567 if ((slave_dev->features & NETIF_F_HW_VLAN_RX) &&
568 slave_dev->vlan_rx_register) {
569 slave_dev->vlan_rx_register(slave_dev, NULL);
573 write_unlock_bh(&bond->lock);
576 /*------------------------------- Link status -------------------------------*/
579 * Set the carrier state for the master according to the state of its
580 * slaves. If any slaves are up, the master is up. In 802.3ad mode,
581 * do special 802.3ad magic.
583 * Returns zero if carrier state does not change, nonzero if it does.
585 static int bond_set_carrier(struct bonding *bond)
590 if (bond->slave_cnt == 0)
593 if (bond->params.mode == BOND_MODE_8023AD)
594 return bond_3ad_set_carrier(bond);
596 bond_for_each_slave(bond, slave, i) {
597 if (slave->link == BOND_LINK_UP) {
598 if (!netif_carrier_ok(bond->dev)) {
599 netif_carrier_on(bond->dev);
607 if (netif_carrier_ok(bond->dev)) {
608 netif_carrier_off(bond->dev);
615 * Get link speed and duplex from the slave's base driver
616 * using ethtool. If for some reason the call fails or the
617 * values are invalid, fake speed and duplex to 100/Full
620 static int bond_update_speed_duplex(struct slave *slave)
622 struct net_device *slave_dev = slave->dev;
623 struct ethtool_cmd etool;
626 /* Fake speed and duplex */
627 slave->speed = SPEED_100;
628 slave->duplex = DUPLEX_FULL;
630 if (!slave_dev->ethtool_ops || !slave_dev->ethtool_ops->get_settings)
633 res = slave_dev->ethtool_ops->get_settings(slave_dev, &etool);
637 switch (etool.speed) {
647 switch (etool.duplex) {
655 slave->speed = etool.speed;
656 slave->duplex = etool.duplex;
662 * if <dev> supports MII link status reporting, check its link status.
664 * We either do MII/ETHTOOL ioctls, or check netif_carrier_ok(),
665 * depening upon the setting of the use_carrier parameter.
667 * Return either BMSR_LSTATUS, meaning that the link is up (or we
668 * can't tell and just pretend it is), or 0, meaning that the link is
671 * If reporting is non-zero, instead of faking link up, return -1 if
672 * both ETHTOOL and MII ioctls fail (meaning the device does not
673 * support them). If use_carrier is set, return whatever it says.
674 * It'd be nice if there was a good way to tell if a driver supports
675 * netif_carrier, but there really isn't.
677 static int bond_check_dev_link(struct bonding *bond, struct net_device *slave_dev, int reporting)
679 static int (* ioctl)(struct net_device *, struct ifreq *, int);
681 struct mii_ioctl_data *mii;
683 if (bond->params.use_carrier) {
684 return netif_carrier_ok(slave_dev) ? BMSR_LSTATUS : 0;
687 ioctl = slave_dev->do_ioctl;
689 /* TODO: set pointer to correct ioctl on a per team member */
690 /* bases to make this more efficient. that is, once */
691 /* we determine the correct ioctl, we will always */
692 /* call it and not the others for that team */
696 * We cannot assume that SIOCGMIIPHY will also read a
697 * register; not all network drivers (e.g., e100)
701 /* Yes, the mii is overlaid on the ifreq.ifr_ifru */
702 strncpy(ifr.ifr_name, slave_dev->name, IFNAMSIZ);
704 if (IOCTL(slave_dev, &ifr, SIOCGMIIPHY) == 0) {
705 mii->reg_num = MII_BMSR;
706 if (IOCTL(slave_dev, &ifr, SIOCGMIIREG) == 0) {
707 return (mii->val_out & BMSR_LSTATUS);
713 * Some drivers cache ETHTOOL_GLINK for a period of time so we only
714 * attempt to get link status from it if the above MII ioctls fail.
716 if (slave_dev->ethtool_ops) {
717 if (slave_dev->ethtool_ops->get_link) {
720 link = slave_dev->ethtool_ops->get_link(slave_dev);
722 return link ? BMSR_LSTATUS : 0;
727 * If reporting, report that either there's no dev->do_ioctl,
728 * or both SIOCGMIIREG and get_link failed (meaning that we
729 * cannot report link status). If not reporting, pretend
732 return (reporting ? -1 : BMSR_LSTATUS);
735 /*----------------------------- Multicast list ------------------------------*/
738 * Returns 0 if dmi1 and dmi2 are the same, non-0 otherwise
740 static inline int bond_is_dmi_same(struct dev_mc_list *dmi1, struct dev_mc_list *dmi2)
742 return memcmp(dmi1->dmi_addr, dmi2->dmi_addr, dmi1->dmi_addrlen) == 0 &&
743 dmi1->dmi_addrlen == dmi2->dmi_addrlen;
747 * returns dmi entry if found, NULL otherwise
749 static struct dev_mc_list *bond_mc_list_find_dmi(struct dev_mc_list *dmi, struct dev_mc_list *mc_list)
751 struct dev_mc_list *idmi;
753 for (idmi = mc_list; idmi; idmi = idmi->next) {
754 if (bond_is_dmi_same(dmi, idmi)) {
763 * Push the promiscuity flag down to appropriate slaves
765 static void bond_set_promiscuity(struct bonding *bond, int inc)
767 if (USES_PRIMARY(bond->params.mode)) {
768 /* write lock already acquired */
769 if (bond->curr_active_slave) {
770 dev_set_promiscuity(bond->curr_active_slave->dev, inc);
775 bond_for_each_slave(bond, slave, i) {
776 dev_set_promiscuity(slave->dev, inc);
782 * Push the allmulti flag down to all slaves
784 static void bond_set_allmulti(struct bonding *bond, int inc)
786 if (USES_PRIMARY(bond->params.mode)) {
787 /* write lock already acquired */
788 if (bond->curr_active_slave) {
789 dev_set_allmulti(bond->curr_active_slave->dev, inc);
794 bond_for_each_slave(bond, slave, i) {
795 dev_set_allmulti(slave->dev, inc);
801 * Add a Multicast address to slaves
804 static void bond_mc_add(struct bonding *bond, void *addr, int alen)
806 if (USES_PRIMARY(bond->params.mode)) {
807 /* write lock already acquired */
808 if (bond->curr_active_slave) {
809 dev_mc_add(bond->curr_active_slave->dev, addr, alen, 0);
814 bond_for_each_slave(bond, slave, i) {
815 dev_mc_add(slave->dev, addr, alen, 0);
821 * Remove a multicast address from slave
824 static void bond_mc_delete(struct bonding *bond, void *addr, int alen)
826 if (USES_PRIMARY(bond->params.mode)) {
827 /* write lock already acquired */
828 if (bond->curr_active_slave) {
829 dev_mc_delete(bond->curr_active_slave->dev, addr, alen, 0);
834 bond_for_each_slave(bond, slave, i) {
835 dev_mc_delete(slave->dev, addr, alen, 0);
842 * Retrieve the list of registered multicast addresses for the bonding
843 * device and retransmit an IGMP JOIN request to the current active
846 static void bond_resend_igmp_join_requests(struct bonding *bond)
848 struct in_device *in_dev;
849 struct ip_mc_list *im;
852 in_dev = __in_dev_get_rcu(bond->dev);
854 for (im = in_dev->mc_list; im; im = im->next) {
855 ip_mc_rejoin_group(im);
863 * Totally destroys the mc_list in bond
865 static void bond_mc_list_destroy(struct bonding *bond)
867 struct dev_mc_list *dmi;
871 bond->mc_list = dmi->next;
875 bond->mc_list = NULL;
879 * Copy all the Multicast addresses from src to the bonding device dst
881 static int bond_mc_list_copy(struct dev_mc_list *mc_list, struct bonding *bond,
884 struct dev_mc_list *dmi, *new_dmi;
886 for (dmi = mc_list; dmi; dmi = dmi->next) {
887 new_dmi = kmalloc(sizeof(struct dev_mc_list), gfp_flag);
890 /* FIXME: Potential memory leak !!! */
894 new_dmi->next = bond->mc_list;
895 bond->mc_list = new_dmi;
896 new_dmi->dmi_addrlen = dmi->dmi_addrlen;
897 memcpy(new_dmi->dmi_addr, dmi->dmi_addr, dmi->dmi_addrlen);
898 new_dmi->dmi_users = dmi->dmi_users;
899 new_dmi->dmi_gusers = dmi->dmi_gusers;
906 * flush all members of flush->mc_list from device dev->mc_list
908 static void bond_mc_list_flush(struct net_device *bond_dev, struct net_device *slave_dev)
910 struct bonding *bond = bond_dev->priv;
911 struct dev_mc_list *dmi;
913 for (dmi = bond_dev->mc_list; dmi; dmi = dmi->next) {
914 dev_mc_delete(slave_dev, dmi->dmi_addr, dmi->dmi_addrlen, 0);
917 if (bond->params.mode == BOND_MODE_8023AD) {
918 /* del lacpdu mc addr from mc list */
919 u8 lacpdu_multicast[ETH_ALEN] = MULTICAST_LACPDU_ADDR;
921 dev_mc_delete(slave_dev, lacpdu_multicast, ETH_ALEN, 0);
925 /*--------------------------- Active slave change ---------------------------*/
928 * Update the mc list and multicast-related flags for the new and
929 * old active slaves (if any) according to the multicast mode, and
930 * promiscuous flags unconditionally.
932 static void bond_mc_swap(struct bonding *bond, struct slave *new_active, struct slave *old_active)
934 struct dev_mc_list *dmi;
936 if (!USES_PRIMARY(bond->params.mode)) {
937 /* nothing to do - mc list is already up-to-date on
944 if (bond->dev->flags & IFF_PROMISC) {
945 dev_set_promiscuity(old_active->dev, -1);
948 if (bond->dev->flags & IFF_ALLMULTI) {
949 dev_set_allmulti(old_active->dev, -1);
952 for (dmi = bond->dev->mc_list; dmi; dmi = dmi->next) {
953 dev_mc_delete(old_active->dev, dmi->dmi_addr, dmi->dmi_addrlen, 0);
958 if (bond->dev->flags & IFF_PROMISC) {
959 dev_set_promiscuity(new_active->dev, 1);
962 if (bond->dev->flags & IFF_ALLMULTI) {
963 dev_set_allmulti(new_active->dev, 1);
966 for (dmi = bond->dev->mc_list; dmi; dmi = dmi->next) {
967 dev_mc_add(new_active->dev, dmi->dmi_addr, dmi->dmi_addrlen, 0);
969 bond_resend_igmp_join_requests(bond);
974 * find_best_interface - select the best available slave to be the active one
975 * @bond: our bonding struct
977 * Warning: Caller must hold curr_slave_lock for writing.
979 static struct slave *bond_find_best_slave(struct bonding *bond)
981 struct slave *new_active, *old_active;
982 struct slave *bestslave = NULL;
983 int mintime = bond->params.updelay;
986 new_active = old_active = bond->curr_active_slave;
988 if (!new_active) { /* there were no active slaves left */
989 if (bond->slave_cnt > 0) { /* found one slave */
990 new_active = bond->first_slave;
992 return NULL; /* still no slave, return NULL */
996 /* first try the primary link; if arping, a link must tx/rx traffic
997 * before it can be considered the curr_active_slave - also, we would skip
998 * slaves between the curr_active_slave and primary_slave that may be up
1001 if ((bond->primary_slave) &&
1002 (!bond->params.arp_interval) &&
1003 (IS_UP(bond->primary_slave->dev))) {
1004 new_active = bond->primary_slave;
1007 /* remember where to stop iterating over the slaves */
1008 old_active = new_active;
1010 bond_for_each_slave_from(bond, new_active, i, old_active) {
1011 if (IS_UP(new_active->dev)) {
1012 if (new_active->link == BOND_LINK_UP) {
1014 } else if (new_active->link == BOND_LINK_BACK) {
1015 /* link up, but waiting for stabilization */
1016 if (new_active->delay < mintime) {
1017 mintime = new_active->delay;
1018 bestslave = new_active;
1028 * change_active_interface - change the active slave into the specified one
1029 * @bond: our bonding struct
1030 * @new: the new slave to make the active one
1032 * Set the new slave to the bond's settings and unset them on the old
1033 * curr_active_slave.
1034 * Setting include flags, mc-list, promiscuity, allmulti, etc.
1036 * If @new's link state is %BOND_LINK_BACK we'll set it to %BOND_LINK_UP,
1037 * because it is apparently the best available slave we have, even though its
1038 * updelay hasn't timed out yet.
1040 * Warning: Caller must hold curr_slave_lock for writing.
1042 void bond_change_active_slave(struct bonding *bond, struct slave *new_active)
1044 struct slave *old_active = bond->curr_active_slave;
1046 if (old_active == new_active) {
1051 if (new_active->link == BOND_LINK_BACK) {
1052 if (USES_PRIMARY(bond->params.mode)) {
1053 printk(KERN_INFO DRV_NAME
1054 ": %s: making interface %s the new "
1055 "active one %d ms earlier.\n",
1056 bond->dev->name, new_active->dev->name,
1057 (bond->params.updelay - new_active->delay) * bond->params.miimon);
1060 new_active->delay = 0;
1061 new_active->link = BOND_LINK_UP;
1062 new_active->jiffies = jiffies;
1064 if (bond->params.mode == BOND_MODE_8023AD) {
1065 bond_3ad_handle_link_change(new_active, BOND_LINK_UP);
1068 if ((bond->params.mode == BOND_MODE_TLB) ||
1069 (bond->params.mode == BOND_MODE_ALB)) {
1070 bond_alb_handle_link_change(bond, new_active, BOND_LINK_UP);
1073 if (USES_PRIMARY(bond->params.mode)) {
1074 printk(KERN_INFO DRV_NAME
1075 ": %s: making interface %s the new "
1077 bond->dev->name, new_active->dev->name);
1082 if (USES_PRIMARY(bond->params.mode)) {
1083 bond_mc_swap(bond, new_active, old_active);
1086 if ((bond->params.mode == BOND_MODE_TLB) ||
1087 (bond->params.mode == BOND_MODE_ALB)) {
1088 bond_alb_handle_active_change(bond, new_active);
1090 bond_set_slave_inactive_flags(old_active);
1092 bond_set_slave_active_flags(new_active);
1094 bond->curr_active_slave = new_active;
1097 if (bond->params.mode == BOND_MODE_ACTIVEBACKUP) {
1099 bond_set_slave_inactive_flags(old_active);
1103 bond_set_slave_active_flags(new_active);
1106 /* when bonding does not set the slave MAC address, the bond MAC
1107 * address is the one of the active slave.
1109 if (new_active && bond->params.fail_over_mac)
1110 memcpy(bond->dev->dev_addr, new_active->dev->dev_addr,
1111 new_active->dev->addr_len);
1112 if (bond->curr_active_slave &&
1113 test_bit(__LINK_STATE_LINKWATCH_PENDING,
1114 &bond->curr_active_slave->dev->state)) {
1115 dprintk("delaying gratuitous arp on %s\n",
1116 bond->curr_active_slave->dev->name);
1117 bond->send_grat_arp = 1;
1119 bond_send_gratuitous_arp(bond);
1124 * bond_select_active_slave - select a new active slave, if needed
1125 * @bond: our bonding struct
1127 * This functions shoud be called when one of the following occurs:
1128 * - The old curr_active_slave has been released or lost its link.
1129 * - The primary_slave has got its link back.
1130 * - A slave has got its link back and there's no old curr_active_slave.
1132 * Warning: Caller must hold curr_slave_lock for writing.
1134 void bond_select_active_slave(struct bonding *bond)
1136 struct slave *best_slave;
1139 best_slave = bond_find_best_slave(bond);
1140 if (best_slave != bond->curr_active_slave) {
1141 bond_change_active_slave(bond, best_slave);
1142 rv = bond_set_carrier(bond);
1146 if (netif_carrier_ok(bond->dev)) {
1147 printk(KERN_INFO DRV_NAME
1148 ": %s: first active interface up!\n",
1151 printk(KERN_INFO DRV_NAME ": %s: "
1152 "now running without any active interface !\n",
1158 /*--------------------------- slave list handling ---------------------------*/
1161 * This function attaches the slave to the end of list.
1163 * bond->lock held for writing by caller.
1165 static void bond_attach_slave(struct bonding *bond, struct slave *new_slave)
1167 if (bond->first_slave == NULL) { /* attaching the first slave */
1168 new_slave->next = new_slave;
1169 new_slave->prev = new_slave;
1170 bond->first_slave = new_slave;
1172 new_slave->next = bond->first_slave;
1173 new_slave->prev = bond->first_slave->prev;
1174 new_slave->next->prev = new_slave;
1175 new_slave->prev->next = new_slave;
1182 * This function detaches the slave from the list.
1183 * WARNING: no check is made to verify if the slave effectively
1184 * belongs to <bond>.
1185 * Nothing is freed on return, structures are just unchained.
1186 * If any slave pointer in bond was pointing to <slave>,
1187 * it should be changed by the calling function.
1189 * bond->lock held for writing by caller.
1191 static void bond_detach_slave(struct bonding *bond, struct slave *slave)
1194 slave->next->prev = slave->prev;
1198 slave->prev->next = slave->next;
1201 if (bond->first_slave == slave) { /* slave is the first slave */
1202 if (bond->slave_cnt > 1) { /* there are more slave */
1203 bond->first_slave = slave->next;
1205 bond->first_slave = NULL; /* slave was the last one */
1214 /*---------------------------------- IOCTL ----------------------------------*/
1216 static int bond_sethwaddr(struct net_device *bond_dev,
1217 struct net_device *slave_dev)
1219 dprintk("bond_dev=%p\n", bond_dev);
1220 dprintk("slave_dev=%p\n", slave_dev);
1221 dprintk("slave_dev->addr_len=%d\n", slave_dev->addr_len);
1222 memcpy(bond_dev->dev_addr, slave_dev->dev_addr, slave_dev->addr_len);
1226 #define BOND_VLAN_FEATURES \
1227 (NETIF_F_VLAN_CHALLENGED | NETIF_F_HW_VLAN_RX | NETIF_F_HW_VLAN_TX | \
1228 NETIF_F_HW_VLAN_FILTER)
1231 * Compute the common dev->feature set available to all slaves. Some
1232 * feature bits are managed elsewhere, so preserve those feature bits
1233 * on the master device.
1235 static int bond_compute_features(struct bonding *bond)
1237 struct slave *slave;
1238 struct net_device *bond_dev = bond->dev;
1239 unsigned long features = bond_dev->features;
1240 unsigned short max_hard_header_len = max((u16)ETH_HLEN,
1241 bond_dev->hard_header_len);
1244 features &= ~(NETIF_F_ALL_CSUM | BOND_VLAN_FEATURES);
1245 features |= NETIF_F_SG | NETIF_F_FRAGLIST | NETIF_F_HIGHDMA |
1246 NETIF_F_GSO_MASK | NETIF_F_NO_CSUM;
1248 bond_for_each_slave(bond, slave, i) {
1249 features = netdev_compute_features(features,
1250 slave->dev->features);
1251 if (slave->dev->hard_header_len > max_hard_header_len)
1252 max_hard_header_len = slave->dev->hard_header_len;
1255 features |= (bond_dev->features & BOND_VLAN_FEATURES);
1256 bond_dev->features = features;
1257 bond_dev->hard_header_len = max_hard_header_len;
1263 static void bond_setup_by_slave(struct net_device *bond_dev,
1264 struct net_device *slave_dev)
1266 struct bonding *bond = bond_dev->priv;
1268 bond_dev->neigh_setup = slave_dev->neigh_setup;
1269 bond_dev->header_ops = slave_dev->header_ops;
1271 bond_dev->type = slave_dev->type;
1272 bond_dev->hard_header_len = slave_dev->hard_header_len;
1273 bond_dev->addr_len = slave_dev->addr_len;
1275 memcpy(bond_dev->broadcast, slave_dev->broadcast,
1276 slave_dev->addr_len);
1277 bond->setup_by_slave = 1;
1280 /* enslave device <slave> to bond device <master> */
1281 int bond_enslave(struct net_device *bond_dev, struct net_device *slave_dev)
1283 struct bonding *bond = bond_dev->priv;
1284 struct slave *new_slave = NULL;
1285 struct dev_mc_list *dmi;
1286 struct sockaddr addr;
1288 int old_features = bond_dev->features;
1291 if (!bond->params.use_carrier && slave_dev->ethtool_ops == NULL &&
1292 slave_dev->do_ioctl == NULL) {
1293 printk(KERN_WARNING DRV_NAME
1294 ": %s: Warning: no link monitoring support for %s\n",
1295 bond_dev->name, slave_dev->name);
1298 /* bond must be initialized by bond_open() before enslaving */
1299 if (!(bond_dev->flags & IFF_UP)) {
1300 printk(KERN_WARNING DRV_NAME
1301 " %s: master_dev is not up in bond_enslave\n",
1305 /* already enslaved */
1306 if (slave_dev->flags & IFF_SLAVE) {
1307 dprintk("Error, Device was already enslaved\n");
1311 /* vlan challenged mutual exclusion */
1312 /* no need to lock since we're protected by rtnl_lock */
1313 if (slave_dev->features & NETIF_F_VLAN_CHALLENGED) {
1314 dprintk("%s: NETIF_F_VLAN_CHALLENGED\n", slave_dev->name);
1315 if (!list_empty(&bond->vlan_list)) {
1316 printk(KERN_ERR DRV_NAME
1317 ": %s: Error: cannot enslave VLAN "
1318 "challenged slave %s on VLAN enabled "
1319 "bond %s\n", bond_dev->name, slave_dev->name,
1323 printk(KERN_WARNING DRV_NAME
1324 ": %s: Warning: enslaved VLAN challenged "
1325 "slave %s. Adding VLANs will be blocked as "
1326 "long as %s is part of bond %s\n",
1327 bond_dev->name, slave_dev->name, slave_dev->name,
1329 bond_dev->features |= NETIF_F_VLAN_CHALLENGED;
1332 dprintk("%s: ! NETIF_F_VLAN_CHALLENGED\n", slave_dev->name);
1333 if (bond->slave_cnt == 0) {
1334 /* First slave, and it is not VLAN challenged,
1335 * so remove the block of adding VLANs over the bond.
1337 bond_dev->features &= ~NETIF_F_VLAN_CHALLENGED;
1342 * Old ifenslave binaries are no longer supported. These can
1343 * be identified with moderate accurary by the state of the slave:
1344 * the current ifenslave will set the interface down prior to
1345 * enslaving it; the old ifenslave will not.
1347 if ((slave_dev->flags & IFF_UP)) {
1348 printk(KERN_ERR DRV_NAME ": %s is up. "
1349 "This may be due to an out of date ifenslave.\n",
1352 goto err_undo_flags;
1355 /* set bonding device ether type by slave - bonding netdevices are
1356 * created with ether_setup, so when the slave type is not ARPHRD_ETHER
1357 * there is a need to override some of the type dependent attribs/funcs.
1359 * bond ether type mutual exclusion - don't allow slaves of dissimilar
1360 * ether type (eg ARPHRD_ETHER and ARPHRD_INFINIBAND) share the same bond
1362 if (bond->slave_cnt == 0) {
1363 if (slave_dev->type != ARPHRD_ETHER)
1364 bond_setup_by_slave(bond_dev, slave_dev);
1365 } else if (bond_dev->type != slave_dev->type) {
1366 printk(KERN_ERR DRV_NAME ": %s ether type (%d) is different "
1367 "from other slaves (%d), can not enslave it.\n",
1369 slave_dev->type, bond_dev->type);
1371 goto err_undo_flags;
1374 if (slave_dev->set_mac_address == NULL) {
1375 if (bond->slave_cnt == 0) {
1376 printk(KERN_WARNING DRV_NAME
1377 ": %s: Warning: The first slave device "
1378 "specified does not support setting the MAC "
1379 "address. Enabling the fail_over_mac option.",
1381 bond->params.fail_over_mac = 1;
1382 } else if (!bond->params.fail_over_mac) {
1383 printk(KERN_ERR DRV_NAME
1384 ": %s: Error: The slave device specified "
1385 "does not support setting the MAC address, "
1386 "but fail_over_mac is not enabled.\n"
1389 goto err_undo_flags;
1393 new_slave = kzalloc(sizeof(struct slave), GFP_KERNEL);
1396 goto err_undo_flags;
1399 /* save slave's original flags before calling
1400 * netdev_set_master and dev_open
1402 new_slave->original_flags = slave_dev->flags;
1405 * Save slave's original ("permanent") mac address for modes
1406 * that need it, and for restoring it upon release, and then
1407 * set it to the master's address
1409 memcpy(new_slave->perm_hwaddr, slave_dev->dev_addr, ETH_ALEN);
1411 if (!bond->params.fail_over_mac) {
1413 * Set slave to master's mac address. The application already
1414 * set the master's mac address to that of the first slave
1416 memcpy(addr.sa_data, bond_dev->dev_addr, bond_dev->addr_len);
1417 addr.sa_family = slave_dev->type;
1418 res = dev_set_mac_address(slave_dev, &addr);
1420 dprintk("Error %d calling set_mac_address\n", res);
1425 res = netdev_set_master(slave_dev, bond_dev);
1427 dprintk("Error %d calling netdev_set_master\n", res);
1428 goto err_restore_mac;
1430 /* open the slave since the application closed it */
1431 res = dev_open(slave_dev);
1433 dprintk("Openning slave %s failed\n", slave_dev->name);
1434 goto err_unset_master;
1437 new_slave->dev = slave_dev;
1438 slave_dev->priv_flags |= IFF_BONDING;
1440 if ((bond->params.mode == BOND_MODE_TLB) ||
1441 (bond->params.mode == BOND_MODE_ALB)) {
1442 /* bond_alb_init_slave() must be called before all other stages since
1443 * it might fail and we do not want to have to undo everything
1445 res = bond_alb_init_slave(bond, new_slave);
1451 /* If the mode USES_PRIMARY, then the new slave gets the
1452 * master's promisc (and mc) settings only if it becomes the
1453 * curr_active_slave, and that is taken care of later when calling
1454 * bond_change_active()
1456 if (!USES_PRIMARY(bond->params.mode)) {
1457 /* set promiscuity level to new slave */
1458 if (bond_dev->flags & IFF_PROMISC) {
1459 dev_set_promiscuity(slave_dev, 1);
1462 /* set allmulti level to new slave */
1463 if (bond_dev->flags & IFF_ALLMULTI) {
1464 dev_set_allmulti(slave_dev, 1);
1467 netif_tx_lock_bh(bond_dev);
1468 /* upload master's mc_list to new slave */
1469 for (dmi = bond_dev->mc_list; dmi; dmi = dmi->next) {
1470 dev_mc_add (slave_dev, dmi->dmi_addr, dmi->dmi_addrlen, 0);
1472 netif_tx_unlock_bh(bond_dev);
1475 if (bond->params.mode == BOND_MODE_8023AD) {
1476 /* add lacpdu mc addr to mc list */
1477 u8 lacpdu_multicast[ETH_ALEN] = MULTICAST_LACPDU_ADDR;
1479 dev_mc_add(slave_dev, lacpdu_multicast, ETH_ALEN, 0);
1482 bond_add_vlans_on_slave(bond, slave_dev);
1484 write_lock_bh(&bond->lock);
1486 bond_attach_slave(bond, new_slave);
1488 new_slave->delay = 0;
1489 new_slave->link_failure_count = 0;
1491 bond_compute_features(bond);
1493 new_slave->last_arp_rx = jiffies;
1495 if (bond->params.miimon && !bond->params.use_carrier) {
1496 link_reporting = bond_check_dev_link(bond, slave_dev, 1);
1498 if ((link_reporting == -1) && !bond->params.arp_interval) {
1500 * miimon is set but a bonded network driver
1501 * does not support ETHTOOL/MII and
1502 * arp_interval is not set. Note: if
1503 * use_carrier is enabled, we will never go
1504 * here (because netif_carrier is always
1505 * supported); thus, we don't need to change
1506 * the messages for netif_carrier.
1508 printk(KERN_WARNING DRV_NAME
1509 ": %s: Warning: MII and ETHTOOL support not "
1510 "available for interface %s, and "
1511 "arp_interval/arp_ip_target module parameters "
1512 "not specified, thus bonding will not detect "
1513 "link failures! see bonding.txt for details.\n",
1514 bond_dev->name, slave_dev->name);
1515 } else if (link_reporting == -1) {
1516 /* unable get link status using mii/ethtool */
1517 printk(KERN_WARNING DRV_NAME
1518 ": %s: Warning: can't get link status from "
1519 "interface %s; the network driver associated "
1520 "with this interface does not support MII or "
1521 "ETHTOOL link status reporting, thus miimon "
1522 "has no effect on this interface.\n",
1523 bond_dev->name, slave_dev->name);
1527 /* check for initial state */
1528 if (!bond->params.miimon ||
1529 (bond_check_dev_link(bond, slave_dev, 0) == BMSR_LSTATUS)) {
1530 if (bond->params.updelay) {
1531 dprintk("Initial state of slave_dev is "
1532 "BOND_LINK_BACK\n");
1533 new_slave->link = BOND_LINK_BACK;
1534 new_slave->delay = bond->params.updelay;
1536 dprintk("Initial state of slave_dev is "
1538 new_slave->link = BOND_LINK_UP;
1540 new_slave->jiffies = jiffies;
1542 dprintk("Initial state of slave_dev is "
1543 "BOND_LINK_DOWN\n");
1544 new_slave->link = BOND_LINK_DOWN;
1547 if (bond_update_speed_duplex(new_slave) &&
1548 (new_slave->link != BOND_LINK_DOWN)) {
1549 printk(KERN_WARNING DRV_NAME
1550 ": %s: Warning: failed to get speed and duplex from %s, "
1551 "assumed to be 100Mb/sec and Full.\n",
1552 bond_dev->name, new_slave->dev->name);
1554 if (bond->params.mode == BOND_MODE_8023AD) {
1555 printk(KERN_WARNING DRV_NAME
1556 ": %s: Warning: Operation of 802.3ad mode requires ETHTOOL "
1557 "support in base driver for proper aggregator "
1558 "selection.\n", bond_dev->name);
1562 if (USES_PRIMARY(bond->params.mode) && bond->params.primary[0]) {
1563 /* if there is a primary slave, remember it */
1564 if (strcmp(bond->params.primary, new_slave->dev->name) == 0) {
1565 bond->primary_slave = new_slave;
1569 switch (bond->params.mode) {
1570 case BOND_MODE_ACTIVEBACKUP:
1571 bond_set_slave_inactive_flags(new_slave);
1572 bond_select_active_slave(bond);
1574 case BOND_MODE_8023AD:
1575 /* in 802.3ad mode, the internal mechanism
1576 * will activate the slaves in the selected
1579 bond_set_slave_inactive_flags(new_slave);
1580 /* if this is the first slave */
1581 if (bond->slave_cnt == 1) {
1582 SLAVE_AD_INFO(new_slave).id = 1;
1583 /* Initialize AD with the number of times that the AD timer is called in 1 second
1584 * can be called only after the mac address of the bond is set
1586 bond_3ad_initialize(bond, 1000/AD_TIMER_INTERVAL,
1587 bond->params.lacp_fast);
1589 SLAVE_AD_INFO(new_slave).id =
1590 SLAVE_AD_INFO(new_slave->prev).id + 1;
1593 bond_3ad_bind_slave(new_slave);
1597 new_slave->state = BOND_STATE_ACTIVE;
1598 bond_set_slave_inactive_flags(new_slave);
1601 dprintk("This slave is always active in trunk mode\n");
1603 /* always active in trunk mode */
1604 new_slave->state = BOND_STATE_ACTIVE;
1606 /* In trunking mode there is little meaning to curr_active_slave
1607 * anyway (it holds no special properties of the bond device),
1608 * so we can change it without calling change_active_interface()
1610 if (!bond->curr_active_slave) {
1611 bond->curr_active_slave = new_slave;
1614 } /* switch(bond_mode) */
1616 bond_set_carrier(bond);
1618 write_unlock_bh(&bond->lock);
1620 res = bond_create_slave_symlinks(bond_dev, slave_dev);
1624 printk(KERN_INFO DRV_NAME
1625 ": %s: enslaving %s as a%s interface with a%s link.\n",
1626 bond_dev->name, slave_dev->name,
1627 new_slave->state == BOND_STATE_ACTIVE ? "n active" : " backup",
1628 new_slave->link != BOND_LINK_DOWN ? "n up" : " down");
1630 /* enslave is successful */
1633 /* Undo stages on error */
1635 dev_close(slave_dev);
1638 netdev_set_master(slave_dev, NULL);
1641 if (!bond->params.fail_over_mac) {
1642 memcpy(addr.sa_data, new_slave->perm_hwaddr, ETH_ALEN);
1643 addr.sa_family = slave_dev->type;
1644 dev_set_mac_address(slave_dev, &addr);
1651 bond_dev->features = old_features;
1657 * Try to release the slave device <slave> from the bond device <master>
1658 * It is legal to access curr_active_slave without a lock because all the function
1661 * The rules for slave state should be:
1662 * for Active/Backup:
1663 * Active stays on all backups go down
1664 * for Bonded connections:
1665 * The first up interface should be left on and all others downed.
1667 int bond_release(struct net_device *bond_dev, struct net_device *slave_dev)
1669 struct bonding *bond = bond_dev->priv;
1670 struct slave *slave, *oldcurrent;
1671 struct sockaddr addr;
1672 int mac_addr_differ;
1673 DECLARE_MAC_BUF(mac);
1675 /* slave is not a slave or master is not master of this slave */
1676 if (!(slave_dev->flags & IFF_SLAVE) ||
1677 (slave_dev->master != bond_dev)) {
1678 printk(KERN_ERR DRV_NAME
1679 ": %s: Error: cannot release %s.\n",
1680 bond_dev->name, slave_dev->name);
1684 write_lock_bh(&bond->lock);
1686 slave = bond_get_slave_by_dev(bond, slave_dev);
1688 /* not a slave of this bond */
1689 printk(KERN_INFO DRV_NAME
1690 ": %s: %s not enslaved\n",
1691 bond_dev->name, slave_dev->name);
1692 write_unlock_bh(&bond->lock);
1696 mac_addr_differ = memcmp(bond_dev->dev_addr,
1699 if (!mac_addr_differ && (bond->slave_cnt > 1)) {
1700 printk(KERN_WARNING DRV_NAME
1701 ": %s: Warning: the permanent HWaddr of %s - "
1702 "%s - is still in use by %s. "
1703 "Set the HWaddr of %s to a different address "
1704 "to avoid conflicts.\n",
1707 print_mac(mac, slave->perm_hwaddr),
1712 /* Inform AD package of unbinding of slave. */
1713 if (bond->params.mode == BOND_MODE_8023AD) {
1714 /* must be called before the slave is
1715 * detached from the list
1717 bond_3ad_unbind_slave(slave);
1720 printk(KERN_INFO DRV_NAME
1721 ": %s: releasing %s interface %s\n",
1723 (slave->state == BOND_STATE_ACTIVE)
1724 ? "active" : "backup",
1727 oldcurrent = bond->curr_active_slave;
1729 bond->current_arp_slave = NULL;
1731 /* release the slave from its bond */
1732 bond_detach_slave(bond, slave);
1734 bond_compute_features(bond);
1736 if (bond->primary_slave == slave) {
1737 bond->primary_slave = NULL;
1740 if (oldcurrent == slave) {
1741 bond_change_active_slave(bond, NULL);
1744 if ((bond->params.mode == BOND_MODE_TLB) ||
1745 (bond->params.mode == BOND_MODE_ALB)) {
1746 /* Must be called only after the slave has been
1747 * detached from the list and the curr_active_slave
1748 * has been cleared (if our_slave == old_current),
1749 * but before a new active slave is selected.
1751 write_unlock_bh(&bond->lock);
1752 bond_alb_deinit_slave(bond, slave);
1753 write_lock_bh(&bond->lock);
1756 if (oldcurrent == slave) {
1758 * Note that we hold RTNL over this sequence, so there
1759 * is no concern that another slave add/remove event
1762 write_unlock_bh(&bond->lock);
1763 read_lock(&bond->lock);
1764 write_lock_bh(&bond->curr_slave_lock);
1766 bond_select_active_slave(bond);
1768 write_unlock_bh(&bond->curr_slave_lock);
1769 read_unlock(&bond->lock);
1770 write_lock_bh(&bond->lock);
1773 if (bond->slave_cnt == 0) {
1774 bond_set_carrier(bond);
1776 /* if the last slave was removed, zero the mac address
1777 * of the master so it will be set by the application
1778 * to the mac address of the first slave
1780 memset(bond_dev->dev_addr, 0, bond_dev->addr_len);
1782 if (list_empty(&bond->vlan_list)) {
1783 bond_dev->features |= NETIF_F_VLAN_CHALLENGED;
1785 printk(KERN_WARNING DRV_NAME
1786 ": %s: Warning: clearing HW address of %s while it "
1787 "still has VLANs.\n",
1788 bond_dev->name, bond_dev->name);
1789 printk(KERN_WARNING DRV_NAME
1790 ": %s: When re-adding slaves, make sure the bond's "
1791 "HW address matches its VLANs'.\n",
1794 } else if ((bond_dev->features & NETIF_F_VLAN_CHALLENGED) &&
1795 !bond_has_challenged_slaves(bond)) {
1796 printk(KERN_INFO DRV_NAME
1797 ": %s: last VLAN challenged slave %s "
1798 "left bond %s. VLAN blocking is removed\n",
1799 bond_dev->name, slave_dev->name, bond_dev->name);
1800 bond_dev->features &= ~NETIF_F_VLAN_CHALLENGED;
1803 write_unlock_bh(&bond->lock);
1805 /* must do this from outside any spinlocks */
1806 bond_destroy_slave_symlinks(bond_dev, slave_dev);
1808 bond_del_vlans_from_slave(bond, slave_dev);
1810 /* If the mode USES_PRIMARY, then we should only remove its
1811 * promisc and mc settings if it was the curr_active_slave, but that was
1812 * already taken care of above when we detached the slave
1814 if (!USES_PRIMARY(bond->params.mode)) {
1815 /* unset promiscuity level from slave */
1816 if (bond_dev->flags & IFF_PROMISC) {
1817 dev_set_promiscuity(slave_dev, -1);
1820 /* unset allmulti level from slave */
1821 if (bond_dev->flags & IFF_ALLMULTI) {
1822 dev_set_allmulti(slave_dev, -1);
1825 /* flush master's mc_list from slave */
1826 netif_tx_lock_bh(bond_dev);
1827 bond_mc_list_flush(bond_dev, slave_dev);
1828 netif_tx_unlock_bh(bond_dev);
1831 netdev_set_master(slave_dev, NULL);
1833 /* close slave before restoring its mac address */
1834 dev_close(slave_dev);
1836 if (!bond->params.fail_over_mac) {
1837 /* restore original ("permanent") mac address */
1838 memcpy(addr.sa_data, slave->perm_hwaddr, ETH_ALEN);
1839 addr.sa_family = slave_dev->type;
1840 dev_set_mac_address(slave_dev, &addr);
1843 slave_dev->priv_flags &= ~(IFF_MASTER_8023AD | IFF_MASTER_ALB |
1844 IFF_SLAVE_INACTIVE | IFF_BONDING |
1849 return 0; /* deletion OK */
1853 * Destroy a bonding device.
1854 * Must be under rtnl_lock when this function is called.
1856 void bond_destroy(struct bonding *bond)
1858 bond_deinit(bond->dev);
1859 bond_destroy_sysfs_entry(bond);
1860 unregister_netdevice(bond->dev);
1864 * First release a slave and than destroy the bond if no more slaves iare left.
1865 * Must be under rtnl_lock when this function is called.
1867 int bond_release_and_destroy(struct net_device *bond_dev, struct net_device *slave_dev)
1869 struct bonding *bond = bond_dev->priv;
1872 ret = bond_release(bond_dev, slave_dev);
1873 if ((ret == 0) && (bond->slave_cnt == 0)) {
1874 printk(KERN_INFO DRV_NAME ": %s: destroying bond %s.\n",
1875 bond_dev->name, bond_dev->name);
1882 * This function releases all slaves.
1884 static int bond_release_all(struct net_device *bond_dev)
1886 struct bonding *bond = bond_dev->priv;
1887 struct slave *slave;
1888 struct net_device *slave_dev;
1889 struct sockaddr addr;
1891 write_lock_bh(&bond->lock);
1893 netif_carrier_off(bond_dev);
1895 if (bond->slave_cnt == 0) {
1899 bond->current_arp_slave = NULL;
1900 bond->primary_slave = NULL;
1901 bond_change_active_slave(bond, NULL);
1903 while ((slave = bond->first_slave) != NULL) {
1904 /* Inform AD package of unbinding of slave
1905 * before slave is detached from the list.
1907 if (bond->params.mode == BOND_MODE_8023AD) {
1908 bond_3ad_unbind_slave(slave);
1911 slave_dev = slave->dev;
1912 bond_detach_slave(bond, slave);
1914 /* now that the slave is detached, unlock and perform
1915 * all the undo steps that should not be called from
1918 write_unlock_bh(&bond->lock);
1920 if ((bond->params.mode == BOND_MODE_TLB) ||
1921 (bond->params.mode == BOND_MODE_ALB)) {
1922 /* must be called only after the slave
1923 * has been detached from the list
1925 bond_alb_deinit_slave(bond, slave);
1928 bond_compute_features(bond);
1930 bond_destroy_slave_symlinks(bond_dev, slave_dev);
1931 bond_del_vlans_from_slave(bond, slave_dev);
1933 /* If the mode USES_PRIMARY, then we should only remove its
1934 * promisc and mc settings if it was the curr_active_slave, but that was
1935 * already taken care of above when we detached the slave
1937 if (!USES_PRIMARY(bond->params.mode)) {
1938 /* unset promiscuity level from slave */
1939 if (bond_dev->flags & IFF_PROMISC) {
1940 dev_set_promiscuity(slave_dev, -1);
1943 /* unset allmulti level from slave */
1944 if (bond_dev->flags & IFF_ALLMULTI) {
1945 dev_set_allmulti(slave_dev, -1);
1948 /* flush master's mc_list from slave */
1949 netif_tx_lock_bh(bond_dev);
1950 bond_mc_list_flush(bond_dev, slave_dev);
1951 netif_tx_unlock_bh(bond_dev);
1954 netdev_set_master(slave_dev, NULL);
1956 /* close slave before restoring its mac address */
1957 dev_close(slave_dev);
1959 if (!bond->params.fail_over_mac) {
1960 /* restore original ("permanent") mac address*/
1961 memcpy(addr.sa_data, slave->perm_hwaddr, ETH_ALEN);
1962 addr.sa_family = slave_dev->type;
1963 dev_set_mac_address(slave_dev, &addr);
1966 slave_dev->priv_flags &= ~(IFF_MASTER_8023AD | IFF_MASTER_ALB |
1967 IFF_SLAVE_INACTIVE);
1971 /* re-acquire the lock before getting the next slave */
1972 write_lock_bh(&bond->lock);
1975 /* zero the mac address of the master so it will be
1976 * set by the application to the mac address of the
1979 memset(bond_dev->dev_addr, 0, bond_dev->addr_len);
1981 if (list_empty(&bond->vlan_list)) {
1982 bond_dev->features |= NETIF_F_VLAN_CHALLENGED;
1984 printk(KERN_WARNING DRV_NAME
1985 ": %s: Warning: clearing HW address of %s while it "
1986 "still has VLANs.\n",
1987 bond_dev->name, bond_dev->name);
1988 printk(KERN_WARNING DRV_NAME
1989 ": %s: When re-adding slaves, make sure the bond's "
1990 "HW address matches its VLANs'.\n",
1994 printk(KERN_INFO DRV_NAME
1995 ": %s: released all slaves\n",
1999 write_unlock_bh(&bond->lock);
2005 * This function changes the active slave to slave <slave_dev>.
2006 * It returns -EINVAL in the following cases.
2007 * - <slave_dev> is not found in the list.
2008 * - There is not active slave now.
2009 * - <slave_dev> is already active.
2010 * - The link state of <slave_dev> is not BOND_LINK_UP.
2011 * - <slave_dev> is not running.
2012 * In these cases, this fuction does nothing.
2013 * In the other cases, currnt_slave pointer is changed and 0 is returned.
2015 static int bond_ioctl_change_active(struct net_device *bond_dev, struct net_device *slave_dev)
2017 struct bonding *bond = bond_dev->priv;
2018 struct slave *old_active = NULL;
2019 struct slave *new_active = NULL;
2022 if (!USES_PRIMARY(bond->params.mode)) {
2026 /* Verify that master_dev is indeed the master of slave_dev */
2027 if (!(slave_dev->flags & IFF_SLAVE) ||
2028 (slave_dev->master != bond_dev)) {
2032 read_lock(&bond->lock);
2034 read_lock(&bond->curr_slave_lock);
2035 old_active = bond->curr_active_slave;
2036 read_unlock(&bond->curr_slave_lock);
2038 new_active = bond_get_slave_by_dev(bond, slave_dev);
2041 * Changing to the current active: do nothing; return success.
2043 if (new_active && (new_active == old_active)) {
2044 read_unlock(&bond->lock);
2050 (new_active->link == BOND_LINK_UP) &&
2051 IS_UP(new_active->dev)) {
2052 write_lock_bh(&bond->curr_slave_lock);
2053 bond_change_active_slave(bond, new_active);
2054 write_unlock_bh(&bond->curr_slave_lock);
2059 read_unlock(&bond->lock);
2064 static int bond_info_query(struct net_device *bond_dev, struct ifbond *info)
2066 struct bonding *bond = bond_dev->priv;
2068 info->bond_mode = bond->params.mode;
2069 info->miimon = bond->params.miimon;
2071 read_lock(&bond->lock);
2072 info->num_slaves = bond->slave_cnt;
2073 read_unlock(&bond->lock);
2078 static int bond_slave_info_query(struct net_device *bond_dev, struct ifslave *info)
2080 struct bonding *bond = bond_dev->priv;
2081 struct slave *slave;
2084 if (info->slave_id < 0) {
2088 read_lock(&bond->lock);
2090 bond_for_each_slave(bond, slave, i) {
2091 if (i == (int)info->slave_id) {
2097 read_unlock(&bond->lock);
2100 strcpy(info->slave_name, slave->dev->name);
2101 info->link = slave->link;
2102 info->state = slave->state;
2103 info->link_failure_count = slave->link_failure_count;
2111 /*-------------------------------- Monitoring -------------------------------*/
2114 * if !have_locks, return nonzero if a failover is necessary. if
2115 * have_locks, do whatever failover activities are needed.
2117 * This is to separate the inspection and failover steps for locking
2118 * purposes; failover requires rtnl, but acquiring it for every
2119 * inspection is undesirable, so a wrapper first does inspection, and
2120 * the acquires the necessary locks and calls again to perform
2121 * failover if needed. Since all locks are dropped, a complete
2122 * restart is needed between calls.
2124 static int __bond_mii_monitor(struct bonding *bond, int have_locks)
2126 struct slave *slave, *oldcurrent;
2127 int do_failover = 0;
2130 if (bond->slave_cnt == 0)
2133 /* we will try to read the link status of each of our slaves, and
2134 * set their IFF_RUNNING flag appropriately. For each slave not
2135 * supporting MII status, we won't do anything so that a user-space
2136 * program could monitor the link itself if needed.
2139 if (bond->send_grat_arp) {
2140 if (bond->curr_active_slave && test_bit(__LINK_STATE_LINKWATCH_PENDING,
2141 &bond->curr_active_slave->dev->state))
2142 dprintk("Needs to send gratuitous arp but not yet\n");
2144 dprintk("sending delayed gratuitous arp on on %s\n",
2145 bond->curr_active_slave->dev->name);
2146 bond_send_gratuitous_arp(bond);
2147 bond->send_grat_arp = 0;
2150 read_lock(&bond->curr_slave_lock);
2151 oldcurrent = bond->curr_active_slave;
2152 read_unlock(&bond->curr_slave_lock);
2154 bond_for_each_slave(bond, slave, i) {
2155 struct net_device *slave_dev = slave->dev;
2157 u16 old_speed = slave->speed;
2158 u8 old_duplex = slave->duplex;
2160 link_state = bond_check_dev_link(bond, slave_dev, 0);
2162 switch (slave->link) {
2163 case BOND_LINK_UP: /* the link was up */
2164 if (link_state == BMSR_LSTATUS) {
2171 } else { /* link going down */
2172 slave->link = BOND_LINK_FAIL;
2173 slave->delay = bond->params.downdelay;
2175 if (slave->link_failure_count < UINT_MAX) {
2176 slave->link_failure_count++;
2179 if (bond->params.downdelay) {
2180 printk(KERN_INFO DRV_NAME
2181 ": %s: link status down for %s "
2182 "interface %s, disabling it in "
2186 ? ((bond->params.mode == BOND_MODE_ACTIVEBACKUP)
2187 ? ((slave == oldcurrent)
2188 ? "active " : "backup ")
2192 bond->params.downdelay * bond->params.miimon);
2195 /* no break ! fall through the BOND_LINK_FAIL test to
2196 ensure proper action to be taken
2198 case BOND_LINK_FAIL: /* the link has just gone down */
2199 if (link_state != BMSR_LSTATUS) {
2200 /* link stays down */
2201 if (slave->delay <= 0) {
2205 /* link down for too long time */
2206 slave->link = BOND_LINK_DOWN;
2208 /* in active/backup mode, we must
2209 * completely disable this interface
2211 if ((bond->params.mode == BOND_MODE_ACTIVEBACKUP) ||
2212 (bond->params.mode == BOND_MODE_8023AD)) {
2213 bond_set_slave_inactive_flags(slave);
2216 printk(KERN_INFO DRV_NAME
2217 ": %s: link status definitely "
2218 "down for interface %s, "
2223 /* notify ad that the link status has changed */
2224 if (bond->params.mode == BOND_MODE_8023AD) {
2225 bond_3ad_handle_link_change(slave, BOND_LINK_DOWN);
2228 if ((bond->params.mode == BOND_MODE_TLB) ||
2229 (bond->params.mode == BOND_MODE_ALB)) {
2230 bond_alb_handle_link_change(bond, slave, BOND_LINK_DOWN);
2233 if (slave == oldcurrent) {
2241 slave->link = BOND_LINK_UP;
2242 slave->jiffies = jiffies;
2243 printk(KERN_INFO DRV_NAME
2244 ": %s: link status up again after %d "
2245 "ms for interface %s.\n",
2247 (bond->params.downdelay - slave->delay) * bond->params.miimon,
2251 case BOND_LINK_DOWN: /* the link was down */
2252 if (link_state != BMSR_LSTATUS) {
2253 /* the link stays down, nothing more to do */
2255 } else { /* link going up */
2256 slave->link = BOND_LINK_BACK;
2257 slave->delay = bond->params.updelay;
2259 if (bond->params.updelay) {
2260 /* if updelay == 0, no need to
2261 advertise about a 0 ms delay */
2262 printk(KERN_INFO DRV_NAME
2263 ": %s: link status up for "
2264 "interface %s, enabling it "
2268 bond->params.updelay * bond->params.miimon);
2271 /* no break ! fall through the BOND_LINK_BACK state in
2272 case there's something to do.
2274 case BOND_LINK_BACK: /* the link has just come back */
2275 if (link_state != BMSR_LSTATUS) {
2276 /* link down again */
2277 slave->link = BOND_LINK_DOWN;
2279 printk(KERN_INFO DRV_NAME
2280 ": %s: link status down again after %d "
2281 "ms for interface %s.\n",
2283 (bond->params.updelay - slave->delay) * bond->params.miimon,
2287 if (slave->delay == 0) {
2291 /* now the link has been up for long time enough */
2292 slave->link = BOND_LINK_UP;
2293 slave->jiffies = jiffies;
2295 if (bond->params.mode == BOND_MODE_8023AD) {
2296 /* prevent it from being the active one */
2297 slave->state = BOND_STATE_BACKUP;
2298 } else if (bond->params.mode != BOND_MODE_ACTIVEBACKUP) {
2299 /* make it immediately active */
2300 slave->state = BOND_STATE_ACTIVE;
2301 } else if (slave != bond->primary_slave) {
2302 /* prevent it from being the active one */
2303 slave->state = BOND_STATE_BACKUP;
2306 printk(KERN_INFO DRV_NAME
2307 ": %s: link status definitely "
2308 "up for interface %s.\n",
2312 /* notify ad that the link status has changed */
2313 if (bond->params.mode == BOND_MODE_8023AD) {
2314 bond_3ad_handle_link_change(slave, BOND_LINK_UP);
2317 if ((bond->params.mode == BOND_MODE_TLB) ||
2318 (bond->params.mode == BOND_MODE_ALB)) {
2319 bond_alb_handle_link_change(bond, slave, BOND_LINK_UP);
2322 if ((!oldcurrent) ||
2323 (slave == bond->primary_slave)) {
2332 /* Should not happen */
2333 printk(KERN_ERR DRV_NAME
2334 ": %s: Error: %s Illegal value (link=%d)\n",
2339 } /* end of switch (slave->link) */
2341 bond_update_speed_duplex(slave);
2343 if (bond->params.mode == BOND_MODE_8023AD) {
2344 if (old_speed != slave->speed) {
2345 bond_3ad_adapter_speed_changed(slave);
2348 if (old_duplex != slave->duplex) {
2349 bond_3ad_adapter_duplex_changed(slave);
2358 write_lock_bh(&bond->curr_slave_lock);
2360 bond_select_active_slave(bond);
2362 write_unlock_bh(&bond->curr_slave_lock);
2365 bond_set_carrier(bond);
2374 * Really a wrapper that splits the mii monitor into two phases: an
2375 * inspection, then (if inspection indicates something needs to be
2376 * done) an acquisition of appropriate locks followed by another pass
2377 * to implement whatever link state changes are indicated.
2379 void bond_mii_monitor(struct work_struct *work)
2381 struct bonding *bond = container_of(work, struct bonding,
2383 unsigned long delay;
2385 read_lock(&bond->lock);
2386 if (bond->kill_timers) {
2387 read_unlock(&bond->lock);
2390 if (__bond_mii_monitor(bond, 0)) {
2391 read_unlock(&bond->lock);
2393 read_lock(&bond->lock);
2394 __bond_mii_monitor(bond, 1);
2395 read_unlock(&bond->lock);
2396 rtnl_unlock(); /* might sleep, hold no other locks */
2397 read_lock(&bond->lock);
2400 delay = ((bond->params.miimon * HZ) / 1000) ? : 1;
2401 read_unlock(&bond->lock);
2402 queue_delayed_work(bond->wq, &bond->mii_work, delay);
2405 static __be32 bond_glean_dev_ip(struct net_device *dev)
2407 struct in_device *idev;
2408 struct in_ifaddr *ifa;
2415 idev = __in_dev_get_rcu(dev);
2419 ifa = idev->ifa_list;
2423 addr = ifa->ifa_local;
2429 static int bond_has_ip(struct bonding *bond)
2431 struct vlan_entry *vlan, *vlan_next;
2433 if (bond->master_ip)
2436 if (list_empty(&bond->vlan_list))
2439 list_for_each_entry_safe(vlan, vlan_next, &bond->vlan_list,
2448 static int bond_has_this_ip(struct bonding *bond, __be32 ip)
2450 struct vlan_entry *vlan, *vlan_next;
2452 if (ip == bond->master_ip)
2455 if (list_empty(&bond->vlan_list))
2458 list_for_each_entry_safe(vlan, vlan_next, &bond->vlan_list,
2460 if (ip == vlan->vlan_ip)
2468 * We go to the (large) trouble of VLAN tagging ARP frames because
2469 * switches in VLAN mode (especially if ports are configured as
2470 * "native" to a VLAN) might not pass non-tagged frames.
2472 static void bond_arp_send(struct net_device *slave_dev, int arp_op, __be32 dest_ip, __be32 src_ip, unsigned short vlan_id)
2474 struct sk_buff *skb;
2476 dprintk("arp %d on slave %s: dst %x src %x vid %d\n", arp_op,
2477 slave_dev->name, dest_ip, src_ip, vlan_id);
2479 skb = arp_create(arp_op, ETH_P_ARP, dest_ip, slave_dev, src_ip,
2480 NULL, slave_dev->dev_addr, NULL);
2483 printk(KERN_ERR DRV_NAME ": ARP packet allocation failed\n");
2487 skb = vlan_put_tag(skb, vlan_id);
2489 printk(KERN_ERR DRV_NAME ": failed to insert VLAN tag\n");
2497 static void bond_arp_send_all(struct bonding *bond, struct slave *slave)
2500 __be32 *targets = bond->params.arp_targets;
2501 struct vlan_entry *vlan, *vlan_next;
2502 struct net_device *vlan_dev;
2506 for (i = 0; (i < BOND_MAX_ARP_TARGETS); i++) {
2509 dprintk("basa: target %x\n", targets[i]);
2510 if (list_empty(&bond->vlan_list)) {
2511 dprintk("basa: empty vlan: arp_send\n");
2512 bond_arp_send(slave->dev, ARPOP_REQUEST, targets[i],
2513 bond->master_ip, 0);
2518 * If VLANs are configured, we do a route lookup to
2519 * determine which VLAN interface would be used, so we
2520 * can tag the ARP with the proper VLAN tag.
2522 memset(&fl, 0, sizeof(fl));
2523 fl.fl4_dst = targets[i];
2524 fl.fl4_tos = RTO_ONLINK;
2526 rv = ip_route_output_key(&init_net, &rt, &fl);
2528 if (net_ratelimit()) {
2529 printk(KERN_WARNING DRV_NAME
2530 ": %s: no route to arp_ip_target %u.%u.%u.%u\n",
2531 bond->dev->name, NIPQUAD(fl.fl4_dst));
2537 * This target is not on a VLAN
2539 if (rt->u.dst.dev == bond->dev) {
2541 dprintk("basa: rtdev == bond->dev: arp_send\n");
2542 bond_arp_send(slave->dev, ARPOP_REQUEST, targets[i],
2543 bond->master_ip, 0);
2548 list_for_each_entry_safe(vlan, vlan_next, &bond->vlan_list,
2550 vlan_dev = vlan_group_get_device(bond->vlgrp, vlan->vlan_id);
2551 if (vlan_dev == rt->u.dst.dev) {
2552 vlan_id = vlan->vlan_id;
2553 dprintk("basa: vlan match on %s %d\n",
2554 vlan_dev->name, vlan_id);
2561 bond_arp_send(slave->dev, ARPOP_REQUEST, targets[i],
2562 vlan->vlan_ip, vlan_id);
2566 if (net_ratelimit()) {
2567 printk(KERN_WARNING DRV_NAME
2568 ": %s: no path to arp_ip_target %u.%u.%u.%u via rt.dev %s\n",
2569 bond->dev->name, NIPQUAD(fl.fl4_dst),
2570 rt->u.dst.dev ? rt->u.dst.dev->name : "NULL");
2577 * Kick out a gratuitous ARP for an IP on the bonding master plus one
2578 * for each VLAN above us.
2580 static void bond_send_gratuitous_arp(struct bonding *bond)
2582 struct slave *slave = bond->curr_active_slave;
2583 struct vlan_entry *vlan;
2584 struct net_device *vlan_dev;
2586 dprintk("bond_send_grat_arp: bond %s slave %s\n", bond->dev->name,
2587 slave ? slave->dev->name : "NULL");
2591 if (bond->master_ip) {
2592 bond_arp_send(slave->dev, ARPOP_REPLY, bond->master_ip,
2593 bond->master_ip, 0);
2596 list_for_each_entry(vlan, &bond->vlan_list, vlan_list) {
2597 vlan_dev = vlan_group_get_device(bond->vlgrp, vlan->vlan_id);
2598 if (vlan->vlan_ip) {
2599 bond_arp_send(slave->dev, ARPOP_REPLY, vlan->vlan_ip,
2600 vlan->vlan_ip, vlan->vlan_id);
2605 static void bond_validate_arp(struct bonding *bond, struct slave *slave, __be32 sip, __be32 tip)
2608 __be32 *targets = bond->params.arp_targets;
2610 targets = bond->params.arp_targets;
2611 for (i = 0; (i < BOND_MAX_ARP_TARGETS) && targets[i]; i++) {
2612 dprintk("bva: sip %u.%u.%u.%u tip %u.%u.%u.%u t[%d] "
2613 "%u.%u.%u.%u bhti(tip) %d\n",
2614 NIPQUAD(sip), NIPQUAD(tip), i, NIPQUAD(targets[i]),
2615 bond_has_this_ip(bond, tip));
2616 if (sip == targets[i]) {
2617 if (bond_has_this_ip(bond, tip))
2618 slave->last_arp_rx = jiffies;
2624 static int bond_arp_rcv(struct sk_buff *skb, struct net_device *dev, struct packet_type *pt, struct net_device *orig_dev)
2627 struct slave *slave;
2628 struct bonding *bond;
2629 unsigned char *arp_ptr;
2632 if (dev_net(dev) != &init_net)
2635 if (!(dev->priv_flags & IFF_BONDING) || !(dev->flags & IFF_MASTER))
2639 read_lock(&bond->lock);
2641 dprintk("bond_arp_rcv: bond %s skb->dev %s orig_dev %s\n",
2642 bond->dev->name, skb->dev ? skb->dev->name : "NULL",
2643 orig_dev ? orig_dev->name : "NULL");
2645 slave = bond_get_slave_by_dev(bond, orig_dev);
2646 if (!slave || !slave_do_arp_validate(bond, slave))
2649 if (!pskb_may_pull(skb, arp_hdr_len(dev)))
2653 if (arp->ar_hln != dev->addr_len ||
2654 skb->pkt_type == PACKET_OTHERHOST ||
2655 skb->pkt_type == PACKET_LOOPBACK ||
2656 arp->ar_hrd != htons(ARPHRD_ETHER) ||
2657 arp->ar_pro != htons(ETH_P_IP) ||
2661 arp_ptr = (unsigned char *)(arp + 1);
2662 arp_ptr += dev->addr_len;
2663 memcpy(&sip, arp_ptr, 4);
2664 arp_ptr += 4 + dev->addr_len;
2665 memcpy(&tip, arp_ptr, 4);
2667 dprintk("bond_arp_rcv: %s %s/%d av %d sv %d sip %u.%u.%u.%u"
2668 " tip %u.%u.%u.%u\n", bond->dev->name, slave->dev->name,
2669 slave->state, bond->params.arp_validate,
2670 slave_do_arp_validate(bond, slave), NIPQUAD(sip), NIPQUAD(tip));
2673 * Backup slaves won't see the ARP reply, but do come through
2674 * here for each ARP probe (so we swap the sip/tip to validate
2675 * the probe). In a "redundant switch, common router" type of
2676 * configuration, the ARP probe will (hopefully) travel from
2677 * the active, through one switch, the router, then the other
2678 * switch before reaching the backup.
2680 if (slave->state == BOND_STATE_ACTIVE)
2681 bond_validate_arp(bond, slave, sip, tip);
2683 bond_validate_arp(bond, slave, tip, sip);
2686 read_unlock(&bond->lock);
2689 return NET_RX_SUCCESS;
2693 * this function is called regularly to monitor each slave's link
2694 * ensuring that traffic is being sent and received when arp monitoring
2695 * is used in load-balancing mode. if the adapter has been dormant, then an
2696 * arp is transmitted to generate traffic. see activebackup_arp_monitor for
2697 * arp monitoring in active backup mode.
2699 void bond_loadbalance_arp_mon(struct work_struct *work)
2701 struct bonding *bond = container_of(work, struct bonding,
2703 struct slave *slave, *oldcurrent;
2704 int do_failover = 0;
2708 read_lock(&bond->lock);
2710 delta_in_ticks = (bond->params.arp_interval * HZ) / 1000;
2712 if (bond->kill_timers) {
2716 if (bond->slave_cnt == 0) {
2720 read_lock(&bond->curr_slave_lock);
2721 oldcurrent = bond->curr_active_slave;
2722 read_unlock(&bond->curr_slave_lock);
2724 /* see if any of the previous devices are up now (i.e. they have
2725 * xmt and rcv traffic). the curr_active_slave does not come into
2726 * the picture unless it is null. also, slave->jiffies is not needed
2727 * here because we send an arp on each slave and give a slave as
2728 * long as it needs to get the tx/rx within the delta.
2729 * TODO: what about up/down delay in arp mode? it wasn't here before
2732 bond_for_each_slave(bond, slave, i) {
2733 if (slave->link != BOND_LINK_UP) {
2734 if (time_before_eq(jiffies, slave->dev->trans_start + delta_in_ticks) &&
2735 time_before_eq(jiffies, slave->dev->last_rx + delta_in_ticks)) {
2737 slave->link = BOND_LINK_UP;
2738 slave->state = BOND_STATE_ACTIVE;
2740 /* primary_slave has no meaning in round-robin
2741 * mode. the window of a slave being up and
2742 * curr_active_slave being null after enslaving
2746 printk(KERN_INFO DRV_NAME
2747 ": %s: link status definitely "
2748 "up for interface %s, ",
2753 printk(KERN_INFO DRV_NAME
2754 ": %s: interface %s is now up\n",
2760 /* slave->link == BOND_LINK_UP */
2762 /* not all switches will respond to an arp request
2763 * when the source ip is 0, so don't take the link down
2764 * if we don't know our ip yet
2766 if (time_after_eq(jiffies, slave->dev->trans_start + 2*delta_in_ticks) ||
2767 (time_after_eq(jiffies, slave->dev->last_rx + 2*delta_in_ticks) &&
2768 bond_has_ip(bond))) {
2770 slave->link = BOND_LINK_DOWN;
2771 slave->state = BOND_STATE_BACKUP;
2773 if (slave->link_failure_count < UINT_MAX) {
2774 slave->link_failure_count++;
2777 printk(KERN_INFO DRV_NAME
2778 ": %s: interface %s is now down.\n",
2782 if (slave == oldcurrent) {
2788 /* note: if switch is in round-robin mode, all links
2789 * must tx arp to ensure all links rx an arp - otherwise
2790 * links may oscillate or not come up at all; if switch is
2791 * in something like xor mode, there is nothing we can
2792 * do - all replies will be rx'ed on same link causing slaves
2793 * to be unstable during low/no traffic periods
2795 if (IS_UP(slave->dev)) {
2796 bond_arp_send_all(bond, slave);
2801 write_lock_bh(&bond->curr_slave_lock);
2803 bond_select_active_slave(bond);
2805 write_unlock_bh(&bond->curr_slave_lock);
2809 if (bond->params.arp_interval)
2810 queue_delayed_work(bond->wq, &bond->arp_work, delta_in_ticks);
2812 read_unlock(&bond->lock);
2816 * When using arp monitoring in active-backup mode, this function is
2817 * called to determine if any backup slaves have went down or a new
2818 * current slave needs to be found.
2819 * The backup slaves never generate traffic, they are considered up by merely
2820 * receiving traffic. If the current slave goes down, each backup slave will
2821 * be given the opportunity to tx/rx an arp before being taken down - this
2822 * prevents all slaves from being taken down due to the current slave not
2823 * sending any traffic for the backups to receive. The arps are not necessarily
2824 * necessary, any tx and rx traffic will keep the current slave up. While any
2825 * rx traffic will keep the backup slaves up, the current slave is responsible
2826 * for generating traffic to keep them up regardless of any other traffic they
2827 * may have received.
2828 * see loadbalance_arp_monitor for arp monitoring in load balancing mode
2830 void bond_activebackup_arp_mon(struct work_struct *work)
2832 struct bonding *bond = container_of(work, struct bonding,
2834 struct slave *slave;
2838 read_lock(&bond->lock);
2840 delta_in_ticks = (bond->params.arp_interval * HZ) / 1000;
2842 if (bond->kill_timers) {
2846 if (bond->slave_cnt == 0) {
2850 /* determine if any slave has come up or any backup slave has
2852 * TODO: what about up/down delay in arp mode? it wasn't here before
2855 bond_for_each_slave(bond, slave, i) {
2856 if (slave->link != BOND_LINK_UP) {
2857 if (time_before_eq(jiffies,
2858 slave_last_rx(bond, slave) + delta_in_ticks)) {
2860 slave->link = BOND_LINK_UP;
2862 write_lock_bh(&bond->curr_slave_lock);
2864 if ((!bond->curr_active_slave) &&
2865 time_before_eq(jiffies, slave->dev->trans_start + delta_in_ticks)) {
2866 bond_change_active_slave(bond, slave);
2867 bond->current_arp_slave = NULL;
2868 } else if (bond->curr_active_slave != slave) {
2869 /* this slave has just come up but we
2870 * already have a current slave; this
2871 * can also happen if bond_enslave adds
2872 * a new slave that is up while we are
2873 * searching for a new slave
2875 bond_set_slave_inactive_flags(slave);
2876 bond->current_arp_slave = NULL;
2879 bond_set_carrier(bond);
2881 if (slave == bond->curr_active_slave) {
2882 printk(KERN_INFO DRV_NAME
2883 ": %s: %s is up and now the "
2884 "active interface\n",
2887 netif_carrier_on(bond->dev);
2889 printk(KERN_INFO DRV_NAME
2890 ": %s: backup interface %s is "
2896 write_unlock_bh(&bond->curr_slave_lock);
2899 read_lock(&bond->curr_slave_lock);
2901 if ((slave != bond->curr_active_slave) &&
2902 (!bond->current_arp_slave) &&
2903 (time_after_eq(jiffies, slave_last_rx(bond, slave) + 3*delta_in_ticks) &&
2904 bond_has_ip(bond))) {
2905 /* a backup slave has gone down; three times
2906 * the delta allows the current slave to be
2907 * taken out before the backup slave.
2908 * note: a non-null current_arp_slave indicates
2909 * the curr_active_slave went down and we are
2910 * searching for a new one; under this
2911 * condition we only take the curr_active_slave
2912 * down - this gives each slave a chance to
2913 * tx/rx traffic before being taken out
2916 read_unlock(&bond->curr_slave_lock);
2918 slave->link = BOND_LINK_DOWN;
2920 if (slave->link_failure_count < UINT_MAX) {
2921 slave->link_failure_count++;
2924 bond_set_slave_inactive_flags(slave);
2926 printk(KERN_INFO DRV_NAME
2927 ": %s: backup interface %s is now down\n",
2931 read_unlock(&bond->curr_slave_lock);
2936 read_lock(&bond->curr_slave_lock);
2937 slave = bond->curr_active_slave;
2938 read_unlock(&bond->curr_slave_lock);
2941 /* if we have sent traffic in the past 2*arp_intervals but
2942 * haven't xmit and rx traffic in that time interval, select
2943 * a different slave. slave->jiffies is only updated when
2944 * a slave first becomes the curr_active_slave - not necessarily
2945 * after every arp; this ensures the slave has a full 2*delta
2946 * before being taken out. if a primary is being used, check
2947 * if it is up and needs to take over as the curr_active_slave
2949 if ((time_after_eq(jiffies, slave->dev->trans_start + 2*delta_in_ticks) ||
2950 (time_after_eq(jiffies, slave_last_rx(bond, slave) + 2*delta_in_ticks) &&
2951 bond_has_ip(bond))) &&
2952 time_after_eq(jiffies, slave->jiffies + 2*delta_in_ticks)) {
2954 slave->link = BOND_LINK_DOWN;
2956 if (slave->link_failure_count < UINT_MAX) {
2957 slave->link_failure_count++;
2960 printk(KERN_INFO DRV_NAME
2961 ": %s: link status down for active interface "
2962 "%s, disabling it\n",
2966 write_lock_bh(&bond->curr_slave_lock);
2968 bond_select_active_slave(bond);
2969 slave = bond->curr_active_slave;
2971 write_unlock_bh(&bond->curr_slave_lock);
2973 bond->current_arp_slave = slave;
2976 slave->jiffies = jiffies;
2978 } else if ((bond->primary_slave) &&
2979 (bond->primary_slave != slave) &&
2980 (bond->primary_slave->link == BOND_LINK_UP)) {
2981 /* at this point, slave is the curr_active_slave */
2982 printk(KERN_INFO DRV_NAME
2983 ": %s: changing from interface %s to primary "
2987 bond->primary_slave->dev->name);
2989 /* primary is up so switch to it */
2990 write_lock_bh(&bond->curr_slave_lock);
2991 bond_change_active_slave(bond, bond->primary_slave);
2992 write_unlock_bh(&bond->curr_slave_lock);
2994 slave = bond->primary_slave;
2995 slave->jiffies = jiffies;
2997 bond->current_arp_slave = NULL;
3000 /* the current slave must tx an arp to ensure backup slaves
3003 if (slave && bond_has_ip(bond)) {
3004 bond_arp_send_all(bond, slave);
3008 /* if we don't have a curr_active_slave, search for the next available
3009 * backup slave from the current_arp_slave and make it the candidate
3010 * for becoming the curr_active_slave
3013 if (!bond->current_arp_slave) {
3014 bond->current_arp_slave = bond->first_slave;
3017 if (bond->current_arp_slave) {
3018 bond_set_slave_inactive_flags(bond->current_arp_slave);
3020 /* search for next candidate */
3021 bond_for_each_slave_from(bond, slave, i, bond->current_arp_slave->next) {
3022 if (IS_UP(slave->dev)) {
3023 slave->link = BOND_LINK_BACK;
3024 bond_set_slave_active_flags(slave);
3025 bond_arp_send_all(bond, slave);
3026 slave->jiffies = jiffies;
3027 bond->current_arp_slave = slave;
3031 /* if the link state is up at this point, we
3032 * mark it down - this can happen if we have
3033 * simultaneous link failures and
3034 * reselect_active_interface doesn't make this
3035 * one the current slave so it is still marked
3036 * up when it is actually down
3038 if (slave->link == BOND_LINK_UP) {
3039 slave->link = BOND_LINK_DOWN;
3040 if (slave->link_failure_count < UINT_MAX) {
3041 slave->link_failure_count++;
3044 bond_set_slave_inactive_flags(slave);
3046 printk(KERN_INFO DRV_NAME
3047 ": %s: backup interface %s is "
3057 if (bond->params.arp_interval) {
3058 queue_delayed_work(bond->wq, &bond->arp_work, delta_in_ticks);
3061 read_unlock(&bond->lock);
3064 /*------------------------------ proc/seq_file-------------------------------*/
3066 #ifdef CONFIG_PROC_FS
3068 static void *bond_info_seq_start(struct seq_file *seq, loff_t *pos)
3070 struct bonding *bond = seq->private;
3072 struct slave *slave;
3075 /* make sure the bond won't be taken away */
3076 read_lock(&dev_base_lock);
3077 read_lock(&bond->lock);
3080 return SEQ_START_TOKEN;
3083 bond_for_each_slave(bond, slave, i) {
3084 if (++off == *pos) {
3092 static void *bond_info_seq_next(struct seq_file *seq, void *v, loff_t *pos)
3094 struct bonding *bond = seq->private;
3095 struct slave *slave = v;
3098 if (v == SEQ_START_TOKEN) {
3099 return bond->first_slave;
3102 slave = slave->next;
3104 return (slave == bond->first_slave) ? NULL : slave;
3107 static void bond_info_seq_stop(struct seq_file *seq, void *v)
3109 struct bonding *bond = seq->private;
3111 read_unlock(&bond->lock);
3112 read_unlock(&dev_base_lock);
3115 static void bond_info_show_master(struct seq_file *seq)
3117 struct bonding *bond = seq->private;
3122 read_lock(&bond->curr_slave_lock);
3123 curr = bond->curr_active_slave;
3124 read_unlock(&bond->curr_slave_lock);
3126 seq_printf(seq, "Bonding Mode: %s",
3127 bond_mode_name(bond->params.mode));
3129 if (bond->params.mode == BOND_MODE_ACTIVEBACKUP &&
3130 bond->params.fail_over_mac)
3131 seq_printf(seq, " (fail_over_mac)");
3133 seq_printf(seq, "\n");
3135 if (bond->params.mode == BOND_MODE_XOR ||
3136 bond->params.mode == BOND_MODE_8023AD) {
3137 seq_printf(seq, "Transmit Hash Policy: %s (%d)\n",
3138 xmit_hashtype_tbl[bond->params.xmit_policy].modename,
3139 bond->params.xmit_policy);
3142 if (USES_PRIMARY(bond->params.mode)) {
3143 seq_printf(seq, "Primary Slave: %s\n",
3144 (bond->primary_slave) ?
3145 bond->primary_slave->dev->name : "None");
3147 seq_printf(seq, "Currently Active Slave: %s\n",
3148 (curr) ? curr->dev->name : "None");
3151 seq_printf(seq, "MII Status: %s\n", netif_carrier_ok(bond->dev) ?
3153 seq_printf(seq, "MII Polling Interval (ms): %d\n", bond->params.miimon);
3154 seq_printf(seq, "Up Delay (ms): %d\n",
3155 bond->params.updelay * bond->params.miimon);
3156 seq_printf(seq, "Down Delay (ms): %d\n",
3157 bond->params.downdelay * bond->params.miimon);
3160 /* ARP information */
3161 if(bond->params.arp_interval > 0) {
3163 seq_printf(seq, "ARP Polling Interval (ms): %d\n",
3164 bond->params.arp_interval);
3166 seq_printf(seq, "ARP IP target/s (n.n.n.n form):");
3168 for(i = 0; (i < BOND_MAX_ARP_TARGETS) ;i++) {
3169 if (!bond->params.arp_targets[i])
3172 seq_printf(seq, ",");
3173 target = ntohl(bond->params.arp_targets[i]);
3174 seq_printf(seq, " %d.%d.%d.%d", HIPQUAD(target));
3177 seq_printf(seq, "\n");
3180 if (bond->params.mode == BOND_MODE_8023AD) {
3181 struct ad_info ad_info;
3182 DECLARE_MAC_BUF(mac);
3184 seq_puts(seq, "\n802.3ad info\n");
3185 seq_printf(seq, "LACP rate: %s\n",
3186 (bond->params.lacp_fast) ? "fast" : "slow");
3188 if (bond_3ad_get_active_agg_info(bond, &ad_info)) {
3189 seq_printf(seq, "bond %s has no active aggregator\n",
3192 seq_printf(seq, "Active Aggregator Info:\n");
3194 seq_printf(seq, "\tAggregator ID: %d\n",
3195 ad_info.aggregator_id);
3196 seq_printf(seq, "\tNumber of ports: %d\n",
3198 seq_printf(seq, "\tActor Key: %d\n",
3200 seq_printf(seq, "\tPartner Key: %d\n",
3201 ad_info.partner_key);
3202 seq_printf(seq, "\tPartner Mac Address: %s\n",
3203 print_mac(mac, ad_info.partner_system));
3208 static void bond_info_show_slave(struct seq_file *seq, const struct slave *slave)
3210 struct bonding *bond = seq->private;
3211 DECLARE_MAC_BUF(mac);
3213 seq_printf(seq, "\nSlave Interface: %s\n", slave->dev->name);
3214 seq_printf(seq, "MII Status: %s\n",
3215 (slave->link == BOND_LINK_UP) ? "up" : "down");
3216 seq_printf(seq, "Link Failure Count: %u\n",
3217 slave->link_failure_count);
3220 "Permanent HW addr: %s\n",
3221 print_mac(mac, slave->perm_hwaddr));
3223 if (bond->params.mode == BOND_MODE_8023AD) {
3224 const struct aggregator *agg
3225 = SLAVE_AD_INFO(slave).port.aggregator;
3228 seq_printf(seq, "Aggregator ID: %d\n",
3229 agg->aggregator_identifier);
3231 seq_puts(seq, "Aggregator ID: N/A\n");
3236 static int bond_info_seq_show(struct seq_file *seq, void *v)
3238 if (v == SEQ_START_TOKEN) {
3239 seq_printf(seq, "%s\n", version);
3240 bond_info_show_master(seq);
3242 bond_info_show_slave(seq, v);
3248 static struct seq_operations bond_info_seq_ops = {
3249 .start = bond_info_seq_start,
3250 .next = bond_info_seq_next,
3251 .stop = bond_info_seq_stop,
3252 .show = bond_info_seq_show,
3255 static int bond_info_open(struct inode *inode, struct file *file)
3257 struct seq_file *seq;
3258 struct proc_dir_entry *proc;
3261 res = seq_open(file, &bond_info_seq_ops);
3263 /* recover the pointer buried in proc_dir_entry data */
3264 seq = file->private_data;
3266 seq->private = proc->data;
3272 static const struct file_operations bond_info_fops = {
3273 .owner = THIS_MODULE,
3274 .open = bond_info_open,
3276 .llseek = seq_lseek,
3277 .release = seq_release,
3280 static int bond_create_proc_entry(struct bonding *bond)
3282 struct net_device *bond_dev = bond->dev;
3284 if (bond_proc_dir) {
3285 bond->proc_entry = proc_create_data(bond_dev->name,
3286 S_IRUGO, bond_proc_dir,
3287 &bond_info_fops, bond);
3288 if (bond->proc_entry == NULL) {
3289 printk(KERN_WARNING DRV_NAME
3290 ": Warning: Cannot create /proc/net/%s/%s\n",
3291 DRV_NAME, bond_dev->name);
3293 memcpy(bond->proc_file_name, bond_dev->name, IFNAMSIZ);
3300 static void bond_remove_proc_entry(struct bonding *bond)
3302 if (bond_proc_dir && bond->proc_entry) {
3303 remove_proc_entry(bond->proc_file_name, bond_proc_dir);
3304 memset(bond->proc_file_name, 0, IFNAMSIZ);
3305 bond->proc_entry = NULL;
3309 /* Create the bonding directory under /proc/net, if doesn't exist yet.
3310 * Caller must hold rtnl_lock.
3312 static void bond_create_proc_dir(void)
3314 int len = strlen(DRV_NAME);
3316 for (bond_proc_dir = init_net.proc_net->subdir; bond_proc_dir;
3317 bond_proc_dir = bond_proc_dir->next) {
3318 if ((bond_proc_dir->namelen == len) &&
3319 !memcmp(bond_proc_dir->name, DRV_NAME, len)) {
3324 if (!bond_proc_dir) {
3325 bond_proc_dir = proc_mkdir(DRV_NAME, init_net.proc_net);
3326 if (bond_proc_dir) {
3327 bond_proc_dir->owner = THIS_MODULE;
3329 printk(KERN_WARNING DRV_NAME
3330 ": Warning: cannot create /proc/net/%s\n",
3336 /* Destroy the bonding directory under /proc/net, if empty.
3337 * Caller must hold rtnl_lock.
3339 static void bond_destroy_proc_dir(void)
3341 struct proc_dir_entry *de;
3343 if (!bond_proc_dir) {
3347 /* verify that the /proc dir is empty */
3348 for (de = bond_proc_dir->subdir; de; de = de->next) {
3349 /* ignore . and .. */
3350 if (*(de->name) != '.') {
3356 if (bond_proc_dir->owner == THIS_MODULE) {
3357 bond_proc_dir->owner = NULL;
3360 remove_proc_entry(DRV_NAME, init_net.proc_net);
3361 bond_proc_dir = NULL;
3364 #endif /* CONFIG_PROC_FS */
3366 /*-------------------------- netdev event handling --------------------------*/
3369 * Change device name
3371 static int bond_event_changename(struct bonding *bond)
3373 #ifdef CONFIG_PROC_FS
3374 bond_remove_proc_entry(bond);
3375 bond_create_proc_entry(bond);
3377 down_write(&(bonding_rwsem));
3378 bond_destroy_sysfs_entry(bond);
3379 bond_create_sysfs_entry(bond);
3380 up_write(&(bonding_rwsem));
3384 static int bond_master_netdev_event(unsigned long event, struct net_device *bond_dev)
3386 struct bonding *event_bond = bond_dev->priv;
3389 case NETDEV_CHANGENAME:
3390 return bond_event_changename(event_bond);
3391 case NETDEV_UNREGISTER:
3392 bond_release_all(event_bond->dev);
3401 static int bond_slave_netdev_event(unsigned long event, struct net_device *slave_dev)
3403 struct net_device *bond_dev = slave_dev->master;
3404 struct bonding *bond = bond_dev->priv;
3407 case NETDEV_UNREGISTER:
3409 if (bond->setup_by_slave)
3410 bond_release_and_destroy(bond_dev, slave_dev);
3412 bond_release(bond_dev, slave_dev);
3417 * TODO: is this what we get if somebody
3418 * sets up a hierarchical bond, then rmmod's
3419 * one of the slave bonding devices?
3424 * ... Or is it this?
3427 case NETDEV_CHANGEMTU:
3429 * TODO: Should slaves be allowed to
3430 * independently alter their MTU? For
3431 * an active-backup bond, slaves need
3432 * not be the same type of device, so
3433 * MTUs may vary. For other modes,
3434 * slaves arguably should have the
3435 * same MTUs. To do this, we'd need to
3436 * take over the slave's change_mtu
3437 * function for the duration of their
3441 case NETDEV_CHANGENAME:
3443 * TODO: handle changing the primary's name
3446 case NETDEV_FEAT_CHANGE:
3447 bond_compute_features(bond);
3457 * bond_netdev_event: handle netdev notifier chain events.
3459 * This function receives events for the netdev chain. The caller (an
3460 * ioctl handler calling blocking_notifier_call_chain) holds the necessary
3461 * locks for us to safely manipulate the slave devices (RTNL lock,
3464 static int bond_netdev_event(struct notifier_block *this, unsigned long event, void *ptr)
3466 struct net_device *event_dev = (struct net_device *)ptr;
3468 if (dev_net(event_dev) != &init_net)
3471 dprintk("event_dev: %s, event: %lx\n",
3472 (event_dev ? event_dev->name : "None"),
3475 if (!(event_dev->priv_flags & IFF_BONDING))
3478 if (event_dev->flags & IFF_MASTER) {
3479 dprintk("IFF_MASTER\n");
3480 return bond_master_netdev_event(event, event_dev);
3483 if (event_dev->flags & IFF_SLAVE) {
3484 dprintk("IFF_SLAVE\n");
3485 return bond_slave_netdev_event(event, event_dev);
3492 * bond_inetaddr_event: handle inetaddr notifier chain events.
3494 * We keep track of device IPs primarily to use as source addresses in
3495 * ARP monitor probes (rather than spewing out broadcasts all the time).
3497 * We track one IP for the main device (if it has one), plus one per VLAN.
3499 static int bond_inetaddr_event(struct notifier_block *this, unsigned long event, void *ptr)
3501 struct in_ifaddr *ifa = ptr;
3502 struct net_device *vlan_dev, *event_dev = ifa->ifa_dev->dev;
3503 struct bonding *bond, *bond_next;
3504 struct vlan_entry *vlan, *vlan_next;
3506 if (dev_net(ifa->ifa_dev->dev) != &init_net)
3509 list_for_each_entry_safe(bond, bond_next, &bond_dev_list, bond_list) {
3510 if (bond->dev == event_dev) {
3513 bond->master_ip = ifa->ifa_local;
3516 bond->master_ip = bond_glean_dev_ip(bond->dev);
3523 if (list_empty(&bond->vlan_list))
3526 list_for_each_entry_safe(vlan, vlan_next, &bond->vlan_list,
3528 vlan_dev = vlan_group_get_device(bond->vlgrp, vlan->vlan_id);
3529 if (vlan_dev == event_dev) {
3532 vlan->vlan_ip = ifa->ifa_local;
3536 bond_glean_dev_ip(vlan_dev);
3547 static struct notifier_block bond_netdev_notifier = {
3548 .notifier_call = bond_netdev_event,
3551 static struct notifier_block bond_inetaddr_notifier = {
3552 .notifier_call = bond_inetaddr_event,
3555 /*-------------------------- Packet type handling ---------------------------*/
3557 /* register to receive lacpdus on a bond */
3558 static void bond_register_lacpdu(struct bonding *bond)
3560 struct packet_type *pk_type = &(BOND_AD_INFO(bond).ad_pkt_type);
3562 /* initialize packet type */
3563 pk_type->type = PKT_TYPE_LACPDU;
3564 pk_type->dev = bond->dev;
3565 pk_type->func = bond_3ad_lacpdu_recv;
3567 dev_add_pack(pk_type);
3570 /* unregister to receive lacpdus on a bond */
3571 static void bond_unregister_lacpdu(struct bonding *bond)
3573 dev_remove_pack(&(BOND_AD_INFO(bond).ad_pkt_type));
3576 void bond_register_arp(struct bonding *bond)
3578 struct packet_type *pt = &bond->arp_mon_pt;
3583 pt->type = htons(ETH_P_ARP);
3584 pt->dev = bond->dev;
3585 pt->func = bond_arp_rcv;
3589 void bond_unregister_arp(struct bonding *bond)
3591 struct packet_type *pt = &bond->arp_mon_pt;
3593 dev_remove_pack(pt);
3597 /*---------------------------- Hashing Policies -----------------------------*/
3600 * Hash for the output device based upon layer 2 and layer 3 data. If
3601 * the packet is not IP mimic bond_xmit_hash_policy_l2()
3603 static int bond_xmit_hash_policy_l23(struct sk_buff *skb,
3604 struct net_device *bond_dev, int count)
3606 struct ethhdr *data = (struct ethhdr *)skb->data;
3607 struct iphdr *iph = ip_hdr(skb);
3609 if (skb->protocol == __constant_htons(ETH_P_IP)) {
3610 return ((ntohl(iph->saddr ^ iph->daddr) & 0xffff) ^
3611 (data->h_dest[5] ^ bond_dev->dev_addr[5])) % count;
3614 return (data->h_dest[5] ^ bond_dev->dev_addr[5]) % count;
3618 * Hash for the output device based upon layer 3 and layer 4 data. If
3619 * the packet is a frag or not TCP or UDP, just use layer 3 data. If it is
3620 * altogether not IP, mimic bond_xmit_hash_policy_l2()
3622 static int bond_xmit_hash_policy_l34(struct sk_buff *skb,
3623 struct net_device *bond_dev, int count)
3625 struct ethhdr *data = (struct ethhdr *)skb->data;
3626 struct iphdr *iph = ip_hdr(skb);
3627 __be16 *layer4hdr = (__be16 *)((u32 *)iph + iph->ihl);
3630 if (skb->protocol == __constant_htons(ETH_P_IP)) {
3631 if (!(iph->frag_off & __constant_htons(IP_MF|IP_OFFSET)) &&
3632 (iph->protocol == IPPROTO_TCP ||
3633 iph->protocol == IPPROTO_UDP)) {
3634 layer4_xor = ntohs((*layer4hdr ^ *(layer4hdr + 1)));
3636 return (layer4_xor ^
3637 ((ntohl(iph->saddr ^ iph->daddr)) & 0xffff)) % count;
3641 return (data->h_dest[5] ^ bond_dev->dev_addr[5]) % count;
3645 * Hash for the output device based upon layer 2 data
3647 static int bond_xmit_hash_policy_l2(struct sk_buff *skb,
3648 struct net_device *bond_dev, int count)
3650 struct ethhdr *data = (struct ethhdr *)skb->data;
3652 return (data->h_dest[5] ^ bond_dev->dev_addr[5]) % count;
3655 /*-------------------------- Device entry points ----------------------------*/
3657 static int bond_open(struct net_device *bond_dev)
3659 struct bonding *bond = bond_dev->priv;
3661 bond->kill_timers = 0;
3663 if ((bond->params.mode == BOND_MODE_TLB) ||
3664 (bond->params.mode == BOND_MODE_ALB)) {
3665 /* bond_alb_initialize must be called before the timer
3668 if (bond_alb_initialize(bond, (bond->params.mode == BOND_MODE_ALB))) {
3669 /* something went wrong - fail the open operation */
3673 INIT_DELAYED_WORK(&bond->alb_work, bond_alb_monitor);
3674 queue_delayed_work(bond->wq, &bond->alb_work, 0);
3677 if (bond->params.miimon) { /* link check interval, in milliseconds. */
3678 INIT_DELAYED_WORK(&bond->mii_work, bond_mii_monitor);
3679 queue_delayed_work(bond->wq, &bond->mii_work, 0);
3682 if (bond->params.arp_interval) { /* arp interval, in milliseconds. */
3683 if (bond->params.mode == BOND_MODE_ACTIVEBACKUP)
3684 INIT_DELAYED_WORK(&bond->arp_work,
3685 bond_activebackup_arp_mon);
3687 INIT_DELAYED_WORK(&bond->arp_work,
3688 bond_loadbalance_arp_mon);
3690 queue_delayed_work(bond->wq, &bond->arp_work, 0);
3691 if (bond->params.arp_validate)
3692 bond_register_arp(bond);
3695 if (bond->params.mode == BOND_MODE_8023AD) {
3696 INIT_DELAYED_WORK(&bond->ad_work, bond_3ad_state_machine_handler);
3697 queue_delayed_work(bond->wq, &bond->ad_work, 0);
3698 /* register to receive LACPDUs */
3699 bond_register_lacpdu(bond);
3705 static int bond_close(struct net_device *bond_dev)
3707 struct bonding *bond = bond_dev->priv;
3709 if (bond->params.mode == BOND_MODE_8023AD) {
3710 /* Unregister the receive of LACPDUs */
3711 bond_unregister_lacpdu(bond);
3714 if (bond->params.arp_validate)
3715 bond_unregister_arp(bond);
3717 write_lock_bh(&bond->lock);
3720 /* signal timers not to re-arm */
3721 bond->kill_timers = 1;
3723 write_unlock_bh(&bond->lock);
3725 if (bond->params.miimon) { /* link check interval, in milliseconds. */
3726 cancel_delayed_work(&bond->mii_work);
3729 if (bond->params.arp_interval) { /* arp interval, in milliseconds. */
3730 cancel_delayed_work(&bond->arp_work);
3733 switch (bond->params.mode) {
3734 case BOND_MODE_8023AD:
3735 cancel_delayed_work(&bond->ad_work);
3739 cancel_delayed_work(&bond->alb_work);
3746 if ((bond->params.mode == BOND_MODE_TLB) ||
3747 (bond->params.mode == BOND_MODE_ALB)) {
3748 /* Must be called only after all
3749 * slaves have been released
3751 bond_alb_deinitialize(bond);
3757 static struct net_device_stats *bond_get_stats(struct net_device *bond_dev)
3759 struct bonding *bond = bond_dev->priv;
3760 struct net_device_stats *stats = &(bond->stats), *sstats;
3761 struct net_device_stats local_stats;
3762 struct slave *slave;
3765 memset(&local_stats, 0, sizeof(struct net_device_stats));
3767 read_lock_bh(&bond->lock);
3769 bond_for_each_slave(bond, slave, i) {
3770 sstats = slave->dev->get_stats(slave->dev);
3771 local_stats.rx_packets += sstats->rx_packets;
3772 local_stats.rx_bytes += sstats->rx_bytes;
3773 local_stats.rx_errors += sstats->rx_errors;
3774 local_stats.rx_dropped += sstats->rx_dropped;
3776 local_stats.tx_packets += sstats->tx_packets;
3777 local_stats.tx_bytes += sstats->tx_bytes;
3778 local_stats.tx_errors += sstats->tx_errors;
3779 local_stats.tx_dropped += sstats->tx_dropped;
3781 local_stats.multicast += sstats->multicast;
3782 local_stats.collisions += sstats->collisions;
3784 local_stats.rx_length_errors += sstats->rx_length_errors;
3785 local_stats.rx_over_errors += sstats->rx_over_errors;
3786 local_stats.rx_crc_errors += sstats->rx_crc_errors;
3787 local_stats.rx_frame_errors += sstats->rx_frame_errors;
3788 local_stats.rx_fifo_errors += sstats->rx_fifo_errors;
3789 local_stats.rx_missed_errors += sstats->rx_missed_errors;
3791 local_stats.tx_aborted_errors += sstats->tx_aborted_errors;
3792 local_stats.tx_carrier_errors += sstats->tx_carrier_errors;
3793 local_stats.tx_fifo_errors += sstats->tx_fifo_errors;
3794 local_stats.tx_heartbeat_errors += sstats->tx_heartbeat_errors;
3795 local_stats.tx_window_errors += sstats->tx_window_errors;
3798 memcpy(stats, &local_stats, sizeof(struct net_device_stats));
3800 read_unlock_bh(&bond->lock);
3805 static int bond_do_ioctl(struct net_device *bond_dev, struct ifreq *ifr, int cmd)
3807 struct net_device *slave_dev = NULL;
3808 struct ifbond k_binfo;
3809 struct ifbond __user *u_binfo = NULL;
3810 struct ifslave k_sinfo;
3811 struct ifslave __user *u_sinfo = NULL;
3812 struct mii_ioctl_data *mii = NULL;
3815 dprintk("bond_ioctl: master=%s, cmd=%d\n",
3816 bond_dev->name, cmd);
3828 * We do this again just in case we were called by SIOCGMIIREG
3829 * instead of SIOCGMIIPHY.
3836 if (mii->reg_num == 1) {
3837 struct bonding *bond = bond_dev->priv;
3839 read_lock(&bond->lock);
3840 read_lock(&bond->curr_slave_lock);
3841 if (netif_carrier_ok(bond->dev)) {
3842 mii->val_out = BMSR_LSTATUS;
3844 read_unlock(&bond->curr_slave_lock);
3845 read_unlock(&bond->lock);
3849 case BOND_INFO_QUERY_OLD:
3850 case SIOCBONDINFOQUERY:
3851 u_binfo = (struct ifbond __user *)ifr->ifr_data;
3853 if (copy_from_user(&k_binfo, u_binfo, sizeof(ifbond))) {
3857 res = bond_info_query(bond_dev, &k_binfo);
3859 if (copy_to_user(u_binfo, &k_binfo, sizeof(ifbond))) {
3865 case BOND_SLAVE_INFO_QUERY_OLD:
3866 case SIOCBONDSLAVEINFOQUERY:
3867 u_sinfo = (struct ifslave __user *)ifr->ifr_data;
3869 if (copy_from_user(&k_sinfo, u_sinfo, sizeof(ifslave))) {
3873 res = bond_slave_info_query(bond_dev, &k_sinfo);
3875 if (copy_to_user(u_sinfo, &k_sinfo, sizeof(ifslave))) {
3886 if (!capable(CAP_NET_ADMIN)) {
3890 down_write(&(bonding_rwsem));
3891 slave_dev = dev_get_by_name(&init_net, ifr->ifr_slave);
3893 dprintk("slave_dev=%p: \n", slave_dev);
3898 dprintk("slave_dev->name=%s: \n", slave_dev->name);
3900 case BOND_ENSLAVE_OLD:
3901 case SIOCBONDENSLAVE:
3902 res = bond_enslave(bond_dev, slave_dev);
3904 case BOND_RELEASE_OLD:
3905 case SIOCBONDRELEASE:
3906 res = bond_release(bond_dev, slave_dev);
3908 case BOND_SETHWADDR_OLD:
3909 case SIOCBONDSETHWADDR:
3910 res = bond_sethwaddr(bond_dev, slave_dev);
3912 case BOND_CHANGE_ACTIVE_OLD:
3913 case SIOCBONDCHANGEACTIVE:
3914 res = bond_ioctl_change_active(bond_dev, slave_dev);
3923 up_write(&(bonding_rwsem));
3927 static void bond_set_multicast_list(struct net_device *bond_dev)
3929 struct bonding *bond = bond_dev->priv;
3930 struct dev_mc_list *dmi;
3933 * Do promisc before checking multicast_mode
3935 if ((bond_dev->flags & IFF_PROMISC) && !(bond->flags & IFF_PROMISC)) {
3936 bond_set_promiscuity(bond, 1);
3939 if (!(bond_dev->flags & IFF_PROMISC) && (bond->flags & IFF_PROMISC)) {
3940 bond_set_promiscuity(bond, -1);
3943 /* set allmulti flag to slaves */
3944 if ((bond_dev->flags & IFF_ALLMULTI) && !(bond->flags & IFF_ALLMULTI)) {
3945 bond_set_allmulti(bond, 1);
3948 if (!(bond_dev->flags & IFF_ALLMULTI) && (bond->flags & IFF_ALLMULTI)) {
3949 bond_set_allmulti(bond, -1);
3952 read_lock(&bond->lock);
3954 bond->flags = bond_dev->flags;
3956 /* looking for addresses to add to slaves' mc list */
3957 for (dmi = bond_dev->mc_list; dmi; dmi = dmi->next) {
3958 if (!bond_mc_list_find_dmi(dmi, bond->mc_list)) {
3959 bond_mc_add(bond, dmi->dmi_addr, dmi->dmi_addrlen);
3963 /* looking for addresses to delete from slaves' list */
3964 for (dmi = bond->mc_list; dmi; dmi = dmi->next) {
3965 if (!bond_mc_list_find_dmi(dmi, bond_dev->mc_list)) {
3966 bond_mc_delete(bond, dmi->dmi_addr, dmi->dmi_addrlen);
3970 /* save master's multicast list */
3971 bond_mc_list_destroy(bond);
3972 bond_mc_list_copy(bond_dev->mc_list, bond, GFP_ATOMIC);
3974 read_unlock(&bond->lock);
3978 * Change the MTU of all of a master's slaves to match the master
3980 static int bond_change_mtu(struct net_device *bond_dev, int new_mtu)
3982 struct bonding *bond = bond_dev->priv;
3983 struct slave *slave, *stop_at;
3987 dprintk("bond=%p, name=%s, new_mtu=%d\n", bond,
3988 (bond_dev ? bond_dev->name : "None"), new_mtu);
3990 /* Can't hold bond->lock with bh disabled here since
3991 * some base drivers panic. On the other hand we can't
3992 * hold bond->lock without bh disabled because we'll
3993 * deadlock. The only solution is to rely on the fact
3994 * that we're under rtnl_lock here, and the slaves
3995 * list won't change. This doesn't solve the problem
3996 * of setting the slave's MTU while it is
3997 * transmitting, but the assumption is that the base
3998 * driver can handle that.
4000 * TODO: figure out a way to safely iterate the slaves
4001 * list, but without holding a lock around the actual
4002 * call to the base driver.
4005 bond_for_each_slave(bond, slave, i) {
4006 dprintk("s %p s->p %p c_m %p\n", slave,
4007 slave->prev, slave->dev->change_mtu);
4009 res = dev_set_mtu(slave->dev, new_mtu);
4012 /* If we failed to set the slave's mtu to the new value
4013 * we must abort the operation even in ACTIVE_BACKUP
4014 * mode, because if we allow the backup slaves to have
4015 * different mtu values than the active slave we'll
4016 * need to change their mtu when doing a failover. That
4017 * means changing their mtu from timer context, which
4018 * is probably not a good idea.
4020 dprintk("err %d %s\n", res, slave->dev->name);
4025 bond_dev->mtu = new_mtu;
4030 /* unwind from head to the slave that failed */
4032 bond_for_each_slave_from_to(bond, slave, i, bond->first_slave, stop_at) {
4035 tmp_res = dev_set_mtu(slave->dev, bond_dev->mtu);
4037 dprintk("unwind err %d dev %s\n", tmp_res,
4048 * Note that many devices must be down to change the HW address, and
4049 * downing the master releases all slaves. We can make bonds full of
4050 * bonding devices to test this, however.
4052 static int bond_set_mac_address(struct net_device *bond_dev, void *addr)
4054 struct bonding *bond = bond_dev->priv;
4055 struct sockaddr *sa = addr, tmp_sa;
4056 struct slave *slave, *stop_at;
4060 dprintk("bond=%p, name=%s\n", bond, (bond_dev ? bond_dev->name : "None"));
4063 * If fail_over_mac is enabled, do nothing and return success.
4064 * Returning an error causes ifenslave to fail.
4066 if (bond->params.fail_over_mac)
4069 if (!is_valid_ether_addr(sa->sa_data)) {
4070 return -EADDRNOTAVAIL;
4073 /* Can't hold bond->lock with bh disabled here since
4074 * some base drivers panic. On the other hand we can't
4075 * hold bond->lock without bh disabled because we'll
4076 * deadlock. The only solution is to rely on the fact
4077 * that we're under rtnl_lock here, and the slaves
4078 * list won't change. This doesn't solve the problem
4079 * of setting the slave's hw address while it is
4080 * transmitting, but the assumption is that the base
4081 * driver can handle that.
4083 * TODO: figure out a way to safely iterate the slaves
4084 * list, but without holding a lock around the actual
4085 * call to the base driver.
4088 bond_for_each_slave(bond, slave, i) {
4089 dprintk("slave %p %s\n", slave, slave->dev->name);
4091 if (slave->dev->set_mac_address == NULL) {
4093 dprintk("EOPNOTSUPP %s\n", slave->dev->name);
4097 res = dev_set_mac_address(slave->dev, addr);
4099 /* TODO: consider downing the slave
4101 * User should expect communications
4102 * breakage anyway until ARP finish
4105 dprintk("err %d %s\n", res, slave->dev->name);
4111 memcpy(bond_dev->dev_addr, sa->sa_data, bond_dev->addr_len);
4115 memcpy(tmp_sa.sa_data, bond_dev->dev_addr, bond_dev->addr_len);
4116 tmp_sa.sa_family = bond_dev->type;
4118 /* unwind from head to the slave that failed */
4120 bond_for_each_slave_from_to(bond, slave, i, bond->first_slave, stop_at) {
4123 tmp_res = dev_set_mac_address(slave->dev, &tmp_sa);
4125 dprintk("unwind err %d dev %s\n", tmp_res,
4133 static int bond_xmit_roundrobin(struct sk_buff *skb, struct net_device *bond_dev)
4135 struct bonding *bond = bond_dev->priv;
4136 struct slave *slave, *start_at;
4137 int i, slave_no, res = 1;
4139 read_lock(&bond->lock);
4141 if (!BOND_IS_OK(bond)) {
4146 * Concurrent TX may collide on rr_tx_counter; we accept that
4147 * as being rare enough not to justify using an atomic op here
4149 slave_no = bond->rr_tx_counter++ % bond->slave_cnt;
4151 bond_for_each_slave(bond, slave, i) {
4159 bond_for_each_slave_from(bond, slave, i, start_at) {
4160 if (IS_UP(slave->dev) &&
4161 (slave->link == BOND_LINK_UP) &&
4162 (slave->state == BOND_STATE_ACTIVE)) {
4163 res = bond_dev_queue_xmit(bond, skb, slave->dev);
4170 /* no suitable interface, frame not sent */
4173 read_unlock(&bond->lock);
4179 * in active-backup mode, we know that bond->curr_active_slave is always valid if
4180 * the bond has a usable interface.
4182 static int bond_xmit_activebackup(struct sk_buff *skb, struct net_device *bond_dev)
4184 struct bonding *bond = bond_dev->priv;
4187 read_lock(&bond->lock);
4188 read_lock(&bond->curr_slave_lock);
4190 if (!BOND_IS_OK(bond)) {
4194 if (!bond->curr_active_slave)
4197 res = bond_dev_queue_xmit(bond, skb, bond->curr_active_slave->dev);
4201 /* no suitable interface, frame not sent */
4204 read_unlock(&bond->curr_slave_lock);
4205 read_unlock(&bond->lock);
4210 * In bond_xmit_xor() , we determine the output device by using a pre-
4211 * determined xmit_hash_policy(), If the selected device is not enabled,
4212 * find the next active slave.
4214 static int bond_xmit_xor(struct sk_buff *skb, struct net_device *bond_dev)
4216 struct bonding *bond = bond_dev->priv;
4217 struct slave *slave, *start_at;
4222 read_lock(&bond->lock);
4224 if (!BOND_IS_OK(bond)) {
4228 slave_no = bond->xmit_hash_policy(skb, bond_dev, bond->slave_cnt);
4230 bond_for_each_slave(bond, slave, i) {
4239 bond_for_each_slave_from(bond, slave, i, start_at) {
4240 if (IS_UP(slave->dev) &&
4241 (slave->link == BOND_LINK_UP) &&
4242 (slave->state == BOND_STATE_ACTIVE)) {
4243 res = bond_dev_queue_xmit(bond, skb, slave->dev);
4250 /* no suitable interface, frame not sent */
4253 read_unlock(&bond->lock);
4258 * in broadcast mode, we send everything to all usable interfaces.
4260 static int bond_xmit_broadcast(struct sk_buff *skb, struct net_device *bond_dev)
4262 struct bonding *bond = bond_dev->priv;
4263 struct slave *slave, *start_at;
4264 struct net_device *tx_dev = NULL;
4268 read_lock(&bond->lock);
4270 if (!BOND_IS_OK(bond)) {
4274 read_lock(&bond->curr_slave_lock);
4275 start_at = bond->curr_active_slave;
4276 read_unlock(&bond->curr_slave_lock);
4282 bond_for_each_slave_from(bond, slave, i, start_at) {
4283 if (IS_UP(slave->dev) &&
4284 (slave->link == BOND_LINK_UP) &&
4285 (slave->state == BOND_STATE_ACTIVE)) {
4287 struct sk_buff *skb2 = skb_clone(skb, GFP_ATOMIC);
4289 printk(KERN_ERR DRV_NAME
4290 ": %s: Error: bond_xmit_broadcast(): "
4291 "skb_clone() failed\n",
4296 res = bond_dev_queue_xmit(bond, skb2, tx_dev);
4298 dev_kfree_skb(skb2);
4302 tx_dev = slave->dev;
4307 res = bond_dev_queue_xmit(bond, skb, tx_dev);
4312 /* no suitable interface, frame not sent */
4315 /* frame sent to all suitable interfaces */
4316 read_unlock(&bond->lock);
4320 /*------------------------- Device initialization ---------------------------*/
4322 static void bond_set_xmit_hash_policy(struct bonding *bond)
4324 switch (bond->params.xmit_policy) {
4325 case BOND_XMIT_POLICY_LAYER23:
4326 bond->xmit_hash_policy = bond_xmit_hash_policy_l23;
4328 case BOND_XMIT_POLICY_LAYER34:
4329 bond->xmit_hash_policy = bond_xmit_hash_policy_l34;
4331 case BOND_XMIT_POLICY_LAYER2:
4333 bond->xmit_hash_policy = bond_xmit_hash_policy_l2;
4339 * set bond mode specific net device operations
4341 void bond_set_mode_ops(struct bonding *bond, int mode)
4343 struct net_device *bond_dev = bond->dev;
4346 case BOND_MODE_ROUNDROBIN:
4347 bond_dev->hard_start_xmit = bond_xmit_roundrobin;
4349 case BOND_MODE_ACTIVEBACKUP:
4350 bond_dev->hard_start_xmit = bond_xmit_activebackup;
4353 bond_dev->hard_start_xmit = bond_xmit_xor;
4354 bond_set_xmit_hash_policy(bond);
4356 case BOND_MODE_BROADCAST:
4357 bond_dev->hard_start_xmit = bond_xmit_broadcast;
4359 case BOND_MODE_8023AD:
4360 bond_set_master_3ad_flags(bond);
4361 bond_dev->hard_start_xmit = bond_3ad_xmit_xor;
4362 bond_set_xmit_hash_policy(bond);
4365 bond_set_master_alb_flags(bond);
4368 bond_dev->hard_start_xmit = bond_alb_xmit;
4369 bond_dev->set_mac_address = bond_alb_set_mac_address;
4372 /* Should never happen, mode already checked */
4373 printk(KERN_ERR DRV_NAME
4374 ": %s: Error: Unknown bonding mode %d\n",
4381 static void bond_ethtool_get_drvinfo(struct net_device *bond_dev,
4382 struct ethtool_drvinfo *drvinfo)
4384 strncpy(drvinfo->driver, DRV_NAME, 32);
4385 strncpy(drvinfo->version, DRV_VERSION, 32);
4386 snprintf(drvinfo->fw_version, 32, "%d", BOND_ABI_VERSION);
4389 static const struct ethtool_ops bond_ethtool_ops = {
4390 .get_drvinfo = bond_ethtool_get_drvinfo,
4394 * Does not allocate but creates a /proc entry.
4397 static int bond_init(struct net_device *bond_dev, struct bond_params *params)
4399 struct bonding *bond = bond_dev->priv;
4401 dprintk("Begin bond_init for %s\n", bond_dev->name);
4403 /* initialize rwlocks */
4404 rwlock_init(&bond->lock);
4405 rwlock_init(&bond->curr_slave_lock);
4407 bond->params = *params; /* copy params struct */
4409 bond->wq = create_singlethread_workqueue(bond_dev->name);
4413 /* Initialize pointers */
4414 bond->first_slave = NULL;
4415 bond->curr_active_slave = NULL;
4416 bond->current_arp_slave = NULL;
4417 bond->primary_slave = NULL;
4418 bond->dev = bond_dev;
4419 bond->send_grat_arp = 0;
4420 bond->setup_by_slave = 0;
4421 INIT_LIST_HEAD(&bond->vlan_list);
4423 /* Initialize the device entry points */
4424 bond_dev->open = bond_open;
4425 bond_dev->stop = bond_close;
4426 bond_dev->get_stats = bond_get_stats;
4427 bond_dev->do_ioctl = bond_do_ioctl;
4428 bond_dev->ethtool_ops = &bond_ethtool_ops;
4429 bond_dev->set_multicast_list = bond_set_multicast_list;
4430 bond_dev->change_mtu = bond_change_mtu;
4431 bond_dev->set_mac_address = bond_set_mac_address;
4432 bond_dev->validate_addr = NULL;
4434 bond_set_mode_ops(bond, bond->params.mode);
4436 bond_dev->destructor = free_netdev;
4438 /* Initialize the device options */
4439 bond_dev->tx_queue_len = 0;
4440 bond_dev->flags |= IFF_MASTER|IFF_MULTICAST;
4441 bond_dev->priv_flags |= IFF_BONDING;
4443 /* At first, we block adding VLANs. That's the only way to
4444 * prevent problems that occur when adding VLANs over an
4445 * empty bond. The block will be removed once non-challenged
4446 * slaves are enslaved.
4448 bond_dev->features |= NETIF_F_VLAN_CHALLENGED;
4450 /* don't acquire bond device's netif_tx_lock when
4452 bond_dev->features |= NETIF_F_LLTX;
4454 /* By default, we declare the bond to be fully
4455 * VLAN hardware accelerated capable. Special
4456 * care is taken in the various xmit functions
4457 * when there are slaves that are not hw accel
4460 bond_dev->vlan_rx_register = bond_vlan_rx_register;
4461 bond_dev->vlan_rx_add_vid = bond_vlan_rx_add_vid;
4462 bond_dev->vlan_rx_kill_vid = bond_vlan_rx_kill_vid;
4463 bond_dev->features |= (NETIF_F_HW_VLAN_TX |
4464 NETIF_F_HW_VLAN_RX |
4465 NETIF_F_HW_VLAN_FILTER);
4467 #ifdef CONFIG_PROC_FS
4468 bond_create_proc_entry(bond);
4470 list_add_tail(&bond->bond_list, &bond_dev_list);
4475 /* De-initialize device specific data.
4476 * Caller must hold rtnl_lock.
4478 static void bond_deinit(struct net_device *bond_dev)
4480 struct bonding *bond = bond_dev->priv;
4482 list_del(&bond->bond_list);
4484 #ifdef CONFIG_PROC_FS
4485 bond_remove_proc_entry(bond);
4489 static void bond_work_cancel_all(struct bonding *bond)
4491 write_lock_bh(&bond->lock);
4492 bond->kill_timers = 1;
4493 write_unlock_bh(&bond->lock);
4495 if (bond->params.miimon && delayed_work_pending(&bond->mii_work))
4496 cancel_delayed_work(&bond->mii_work);
4498 if (bond->params.arp_interval && delayed_work_pending(&bond->arp_work))
4499 cancel_delayed_work(&bond->arp_work);
4501 if (bond->params.mode == BOND_MODE_ALB &&
4502 delayed_work_pending(&bond->alb_work))
4503 cancel_delayed_work(&bond->alb_work);
4505 if (bond->params.mode == BOND_MODE_8023AD &&
4506 delayed_work_pending(&bond->ad_work))
4507 cancel_delayed_work(&bond->ad_work);
4510 /* Unregister and free all bond devices.
4511 * Caller must hold rtnl_lock.
4513 static void bond_free_all(void)
4515 struct bonding *bond, *nxt;
4517 list_for_each_entry_safe(bond, nxt, &bond_dev_list, bond_list) {
4518 struct net_device *bond_dev = bond->dev;
4520 bond_work_cancel_all(bond);
4521 netif_tx_lock_bh(bond_dev);
4522 bond_mc_list_destroy(bond);
4523 netif_tx_unlock_bh(bond_dev);
4524 /* Release the bonded slaves */
4525 bond_release_all(bond_dev);
4529 #ifdef CONFIG_PROC_FS
4530 bond_destroy_proc_dir();
4534 /*------------------------- Module initialization ---------------------------*/
4537 * Convert string input module parms. Accept either the
4538 * number of the mode or its string name. A bit complicated because
4539 * some mode names are substrings of other names, and calls from sysfs
4540 * may have whitespace in the name (trailing newlines, for example).
4542 int bond_parse_parm(const char *buf, struct bond_parm_tbl *tbl)
4544 int mode = -1, i, rv;
4545 char *p, modestr[BOND_MAX_MODENAME_LEN + 1] = { 0, };
4547 for (p = (char *)buf; *p; p++)
4548 if (!(isdigit(*p) || isspace(*p)))
4552 rv = sscanf(buf, "%20s", modestr);
4554 rv = sscanf(buf, "%d", &mode);
4559 for (i = 0; tbl[i].modename; i++) {
4560 if (mode == tbl[i].mode)
4562 if (strcmp(modestr, tbl[i].modename) == 0)
4569 static int bond_check_params(struct bond_params *params)
4571 int arp_validate_value;
4574 * Convert string parameters.
4577 bond_mode = bond_parse_parm(mode, bond_mode_tbl);
4578 if (bond_mode == -1) {
4579 printk(KERN_ERR DRV_NAME
4580 ": Error: Invalid bonding mode \"%s\"\n",
4581 mode == NULL ? "NULL" : mode);
4586 if (xmit_hash_policy) {
4587 if ((bond_mode != BOND_MODE_XOR) &&
4588 (bond_mode != BOND_MODE_8023AD)) {
4589 printk(KERN_INFO DRV_NAME
4590 ": xor_mode param is irrelevant in mode %s\n",
4591 bond_mode_name(bond_mode));
4593 xmit_hashtype = bond_parse_parm(xmit_hash_policy,
4595 if (xmit_hashtype == -1) {
4596 printk(KERN_ERR DRV_NAME
4597 ": Error: Invalid xmit_hash_policy \"%s\"\n",
4598 xmit_hash_policy == NULL ? "NULL" :
4606 if (bond_mode != BOND_MODE_8023AD) {
4607 printk(KERN_INFO DRV_NAME
4608 ": lacp_rate param is irrelevant in mode %s\n",
4609 bond_mode_name(bond_mode));
4611 lacp_fast = bond_parse_parm(lacp_rate, bond_lacp_tbl);
4612 if (lacp_fast == -1) {
4613 printk(KERN_ERR DRV_NAME
4614 ": Error: Invalid lacp rate \"%s\"\n",
4615 lacp_rate == NULL ? "NULL" : lacp_rate);
4621 if (max_bonds < 1 || max_bonds > INT_MAX) {
4622 printk(KERN_WARNING DRV_NAME
4623 ": Warning: max_bonds (%d) not in range %d-%d, so it "
4624 "was reset to BOND_DEFAULT_MAX_BONDS (%d)\n",
4625 max_bonds, 1, INT_MAX, BOND_DEFAULT_MAX_BONDS);
4626 max_bonds = BOND_DEFAULT_MAX_BONDS;
4630 printk(KERN_WARNING DRV_NAME
4631 ": Warning: miimon module parameter (%d), "
4632 "not in range 0-%d, so it was reset to %d\n",
4633 miimon, INT_MAX, BOND_LINK_MON_INTERV);
4634 miimon = BOND_LINK_MON_INTERV;
4638 printk(KERN_WARNING DRV_NAME
4639 ": Warning: updelay module parameter (%d), "
4640 "not in range 0-%d, so it was reset to 0\n",
4645 if (downdelay < 0) {
4646 printk(KERN_WARNING DRV_NAME
4647 ": Warning: downdelay module parameter (%d), "
4648 "not in range 0-%d, so it was reset to 0\n",
4649 downdelay, INT_MAX);
4653 if ((use_carrier != 0) && (use_carrier != 1)) {
4654 printk(KERN_WARNING DRV_NAME
4655 ": Warning: use_carrier module parameter (%d), "
4656 "not of valid value (0/1), so it was set to 1\n",
4661 /* reset values for 802.3ad */
4662 if (bond_mode == BOND_MODE_8023AD) {
4664 printk(KERN_WARNING DRV_NAME
4665 ": Warning: miimon must be specified, "
4666 "otherwise bonding will not detect link "
4667 "failure, speed and duplex which are "
4668 "essential for 802.3ad operation\n");
4669 printk(KERN_WARNING "Forcing miimon to 100msec\n");
4674 /* reset values for TLB/ALB */
4675 if ((bond_mode == BOND_MODE_TLB) ||
4676 (bond_mode == BOND_MODE_ALB)) {
4678 printk(KERN_WARNING DRV_NAME
4679 ": Warning: miimon must be specified, "
4680 "otherwise bonding will not detect link "
4681 "failure and link speed which are essential "
4682 "for TLB/ALB load balancing\n");
4683 printk(KERN_WARNING "Forcing miimon to 100msec\n");
4688 if (bond_mode == BOND_MODE_ALB) {
4689 printk(KERN_NOTICE DRV_NAME
4690 ": In ALB mode you might experience client "
4691 "disconnections upon reconnection of a link if the "
4692 "bonding module updelay parameter (%d msec) is "
4693 "incompatible with the forwarding delay time of the "
4699 if (updelay || downdelay) {
4700 /* just warn the user the up/down delay will have
4701 * no effect since miimon is zero...
4703 printk(KERN_WARNING DRV_NAME
4704 ": Warning: miimon module parameter not set "
4705 "and updelay (%d) or downdelay (%d) module "
4706 "parameter is set; updelay and downdelay have "
4707 "no effect unless miimon is set\n",
4708 updelay, downdelay);
4711 /* don't allow arp monitoring */
4713 printk(KERN_WARNING DRV_NAME
4714 ": Warning: miimon (%d) and arp_interval (%d) "
4715 "can't be used simultaneously, disabling ARP "
4717 miimon, arp_interval);
4721 if ((updelay % miimon) != 0) {
4722 printk(KERN_WARNING DRV_NAME
4723 ": Warning: updelay (%d) is not a multiple "
4724 "of miimon (%d), updelay rounded to %d ms\n",
4725 updelay, miimon, (updelay / miimon) * miimon);
4730 if ((downdelay % miimon) != 0) {
4731 printk(KERN_WARNING DRV_NAME
4732 ": Warning: downdelay (%d) is not a multiple "
4733 "of miimon (%d), downdelay rounded to %d ms\n",
4735 (downdelay / miimon) * miimon);
4738 downdelay /= miimon;
4741 if (arp_interval < 0) {
4742 printk(KERN_WARNING DRV_NAME
4743 ": Warning: arp_interval module parameter (%d) "
4744 ", not in range 0-%d, so it was reset to %d\n",
4745 arp_interval, INT_MAX, BOND_LINK_ARP_INTERV);
4746 arp_interval = BOND_LINK_ARP_INTERV;
4749 for (arp_ip_count = 0;
4750 (arp_ip_count < BOND_MAX_ARP_TARGETS) && arp_ip_target[arp_ip_count];
4752 /* not complete check, but should be good enough to
4754 if (!isdigit(arp_ip_target[arp_ip_count][0])) {
4755 printk(KERN_WARNING DRV_NAME
4756 ": Warning: bad arp_ip_target module parameter "
4757 "(%s), ARP monitoring will not be performed\n",
4758 arp_ip_target[arp_ip_count]);
4761 __be32 ip = in_aton(arp_ip_target[arp_ip_count]);
4762 arp_target[arp_ip_count] = ip;
4766 if (arp_interval && !arp_ip_count) {
4767 /* don't allow arping if no arp_ip_target given... */
4768 printk(KERN_WARNING DRV_NAME
4769 ": Warning: arp_interval module parameter (%d) "
4770 "specified without providing an arp_ip_target "
4771 "parameter, arp_interval was reset to 0\n",
4777 if (bond_mode != BOND_MODE_ACTIVEBACKUP) {
4778 printk(KERN_ERR DRV_NAME
4779 ": arp_validate only supported in active-backup mode\n");
4782 if (!arp_interval) {
4783 printk(KERN_ERR DRV_NAME
4784 ": arp_validate requires arp_interval\n");
4788 arp_validate_value = bond_parse_parm(arp_validate,
4790 if (arp_validate_value == -1) {
4791 printk(KERN_ERR DRV_NAME
4792 ": Error: invalid arp_validate \"%s\"\n",
4793 arp_validate == NULL ? "NULL" : arp_validate);
4797 arp_validate_value = 0;
4800 printk(KERN_INFO DRV_NAME
4801 ": MII link monitoring set to %d ms\n",
4803 } else if (arp_interval) {
4806 printk(KERN_INFO DRV_NAME
4807 ": ARP monitoring set to %d ms, validate %s, with %d target(s):",
4809 arp_validate_tbl[arp_validate_value].modename,
4812 for (i = 0; i < arp_ip_count; i++)
4813 printk (" %s", arp_ip_target[i]);
4818 /* miimon and arp_interval not set, we need one so things
4819 * work as expected, see bonding.txt for details
4821 printk(KERN_WARNING DRV_NAME
4822 ": Warning: either miimon or arp_interval and "
4823 "arp_ip_target module parameters must be specified, "
4824 "otherwise bonding will not detect link failures! see "
4825 "bonding.txt for details.\n");
4828 if (primary && !USES_PRIMARY(bond_mode)) {
4829 /* currently, using a primary only makes sense
4830 * in active backup, TLB or ALB modes
4832 printk(KERN_WARNING DRV_NAME
4833 ": Warning: %s primary device specified but has no "
4834 "effect in %s mode\n",
4835 primary, bond_mode_name(bond_mode));
4839 if (fail_over_mac && (bond_mode != BOND_MODE_ACTIVEBACKUP))
4840 printk(KERN_WARNING DRV_NAME
4841 ": Warning: fail_over_mac only affects "
4842 "active-backup mode.\n");
4844 /* fill params struct with the proper values */
4845 params->mode = bond_mode;
4846 params->xmit_policy = xmit_hashtype;
4847 params->miimon = miimon;
4848 params->arp_interval = arp_interval;
4849 params->arp_validate = arp_validate_value;
4850 params->updelay = updelay;
4851 params->downdelay = downdelay;
4852 params->use_carrier = use_carrier;
4853 params->lacp_fast = lacp_fast;
4854 params->primary[0] = 0;
4855 params->fail_over_mac = fail_over_mac;
4858 strncpy(params->primary, primary, IFNAMSIZ);
4859 params->primary[IFNAMSIZ - 1] = 0;
4862 memcpy(params->arp_targets, arp_target, sizeof(arp_target));
4867 static struct lock_class_key bonding_netdev_xmit_lock_key;
4869 /* Create a new bond based on the specified name and bonding parameters.
4870 * If name is NULL, obtain a suitable "bond%d" name for us.
4871 * Caller must NOT hold rtnl_lock; we need to release it here before we
4872 * set up our sysfs entries.
4874 int bond_create(char *name, struct bond_params *params, struct bonding **newbond)
4876 struct net_device *bond_dev;
4877 struct bonding *bond, *nxt;
4881 down_write(&bonding_rwsem);
4883 /* Check to see if the bond already exists. */
4885 list_for_each_entry_safe(bond, nxt, &bond_dev_list, bond_list)
4886 if (strnicmp(bond->dev->name, name, IFNAMSIZ) == 0) {
4887 printk(KERN_ERR DRV_NAME
4888 ": cannot add bond %s; it already exists\n",
4895 bond_dev = alloc_netdev(sizeof(struct bonding), name ? name : "",
4898 printk(KERN_ERR DRV_NAME
4899 ": %s: eek! can't alloc netdev!\n",
4906 res = dev_alloc_name(bond_dev, "bond%d");
4911 /* bond_init() must be called after dev_alloc_name() (for the
4912 * /proc files), but before register_netdevice(), because we
4913 * need to set function pointers.
4916 res = bond_init(bond_dev, params);
4921 res = register_netdevice(bond_dev);
4926 lockdep_set_class(&bond_dev->_xmit_lock, &bonding_netdev_xmit_lock_key);
4929 *newbond = bond_dev->priv;
4931 netif_carrier_off(bond_dev);
4933 up_write(&bonding_rwsem);
4934 rtnl_unlock(); /* allows sysfs registration of net device */
4935 res = bond_create_sysfs_entry(bond_dev->priv);
4938 down_write(&bonding_rwsem);
4939 bond_deinit(bond_dev);
4940 unregister_netdevice(bond_dev);
4947 bond_deinit(bond_dev);
4949 free_netdev(bond_dev);
4951 up_write(&bonding_rwsem);
4956 static int __init bonding_init(void)
4960 struct bonding *bond, *nxt;
4962 printk(KERN_INFO "%s", version);
4964 res = bond_check_params(&bonding_defaults);
4969 #ifdef CONFIG_PROC_FS
4970 bond_create_proc_dir();
4973 init_rwsem(&bonding_rwsem);
4975 for (i = 0; i < max_bonds; i++) {
4976 res = bond_create(NULL, &bonding_defaults, NULL);
4981 res = bond_create_sysfs();
4985 register_netdevice_notifier(&bond_netdev_notifier);
4986 register_inetaddr_notifier(&bond_inetaddr_notifier);
4990 list_for_each_entry_safe(bond, nxt, &bond_dev_list, bond_list) {
4991 bond_work_cancel_all(bond);
4992 destroy_workqueue(bond->wq);
4995 bond_destroy_sysfs();
5005 static void __exit bonding_exit(void)
5007 unregister_netdevice_notifier(&bond_netdev_notifier);
5008 unregister_inetaddr_notifier(&bond_inetaddr_notifier);
5010 bond_destroy_sysfs();
5017 module_init(bonding_init);
5018 module_exit(bonding_exit);
5019 MODULE_LICENSE("GPL");
5020 MODULE_VERSION(DRV_VERSION);
5021 MODULE_DESCRIPTION(DRV_DESCRIPTION ", v" DRV_VERSION);
5022 MODULE_AUTHOR("Thomas Davis, tadavis@lbl.gov and many others");
5023 MODULE_SUPPORTED_DEVICE("most ethernet devices");