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 <net/route.h>
78 #include <net/net_namespace.h>
83 /*---------------------------- Module parameters ----------------------------*/
85 /* monitor all links that often (in milliseconds). <=0 disables monitoring */
86 #define BOND_LINK_MON_INTERV 0
87 #define BOND_LINK_ARP_INTERV 0
89 static int max_bonds = BOND_DEFAULT_MAX_BONDS;
90 static int miimon = BOND_LINK_MON_INTERV;
91 static int updelay = 0;
92 static int downdelay = 0;
93 static int use_carrier = 1;
94 static char *mode = NULL;
95 static char *primary = NULL;
96 static char *lacp_rate = NULL;
97 static char *xmit_hash_policy = NULL;
98 static int arp_interval = BOND_LINK_ARP_INTERV;
99 static char *arp_ip_target[BOND_MAX_ARP_TARGETS] = { NULL, };
100 static char *arp_validate = NULL;
101 struct bond_params bonding_defaults;
103 module_param(max_bonds, int, 0);
104 MODULE_PARM_DESC(max_bonds, "Max number of bonded devices");
105 module_param(miimon, int, 0);
106 MODULE_PARM_DESC(miimon, "Link check interval in milliseconds");
107 module_param(updelay, int, 0);
108 MODULE_PARM_DESC(updelay, "Delay before considering link up, in milliseconds");
109 module_param(downdelay, int, 0);
110 MODULE_PARM_DESC(downdelay, "Delay before considering link down, "
112 module_param(use_carrier, int, 0);
113 MODULE_PARM_DESC(use_carrier, "Use netif_carrier_ok (vs MII ioctls) in miimon; "
114 "0 for off, 1 for on (default)");
115 module_param(mode, charp, 0);
116 MODULE_PARM_DESC(mode, "Mode of operation : 0 for balance-rr, "
117 "1 for active-backup, 2 for balance-xor, "
118 "3 for broadcast, 4 for 802.3ad, 5 for balance-tlb, "
119 "6 for balance-alb");
120 module_param(primary, charp, 0);
121 MODULE_PARM_DESC(primary, "Primary network device to use");
122 module_param(lacp_rate, charp, 0);
123 MODULE_PARM_DESC(lacp_rate, "LACPDU tx rate to request from 802.3ad partner "
125 module_param(xmit_hash_policy, charp, 0);
126 MODULE_PARM_DESC(xmit_hash_policy, "XOR hashing method: 0 for layer 2 (default)"
127 ", 1 for layer 3+4");
128 module_param(arp_interval, int, 0);
129 MODULE_PARM_DESC(arp_interval, "arp interval in milliseconds");
130 module_param_array(arp_ip_target, charp, NULL, 0);
131 MODULE_PARM_DESC(arp_ip_target, "arp targets in n.n.n.n form");
132 module_param(arp_validate, charp, 0);
133 MODULE_PARM_DESC(arp_validate, "validate src/dst of ARP probes: none (default), active, backup or all");
135 /*----------------------------- Global variables ----------------------------*/
137 static const char * const version =
138 DRV_DESCRIPTION ": v" DRV_VERSION " (" DRV_RELDATE ")\n";
140 LIST_HEAD(bond_dev_list);
142 #ifdef CONFIG_PROC_FS
143 static struct proc_dir_entry *bond_proc_dir = NULL;
146 extern struct rw_semaphore bonding_rwsem;
147 static __be32 arp_target[BOND_MAX_ARP_TARGETS] = { 0, } ;
148 static int arp_ip_count = 0;
149 static int bond_mode = BOND_MODE_ROUNDROBIN;
150 static int xmit_hashtype= BOND_XMIT_POLICY_LAYER2;
151 static int lacp_fast = 0;
154 struct bond_parm_tbl bond_lacp_tbl[] = {
155 { "slow", AD_LACP_SLOW},
156 { "fast", AD_LACP_FAST},
160 struct bond_parm_tbl bond_mode_tbl[] = {
161 { "balance-rr", BOND_MODE_ROUNDROBIN},
162 { "active-backup", BOND_MODE_ACTIVEBACKUP},
163 { "balance-xor", BOND_MODE_XOR},
164 { "broadcast", BOND_MODE_BROADCAST},
165 { "802.3ad", BOND_MODE_8023AD},
166 { "balance-tlb", BOND_MODE_TLB},
167 { "balance-alb", BOND_MODE_ALB},
171 struct bond_parm_tbl xmit_hashtype_tbl[] = {
172 { "layer2", BOND_XMIT_POLICY_LAYER2},
173 { "layer3+4", BOND_XMIT_POLICY_LAYER34},
177 struct bond_parm_tbl arp_validate_tbl[] = {
178 { "none", BOND_ARP_VALIDATE_NONE},
179 { "active", BOND_ARP_VALIDATE_ACTIVE},
180 { "backup", BOND_ARP_VALIDATE_BACKUP},
181 { "all", BOND_ARP_VALIDATE_ALL},
185 /*-------------------------- Forward declarations ---------------------------*/
187 static void bond_send_gratuitous_arp(struct bonding *bond);
189 /*---------------------------- General routines -----------------------------*/
191 static const char *bond_mode_name(int mode)
194 case BOND_MODE_ROUNDROBIN :
195 return "load balancing (round-robin)";
196 case BOND_MODE_ACTIVEBACKUP :
197 return "fault-tolerance (active-backup)";
199 return "load balancing (xor)";
200 case BOND_MODE_BROADCAST :
201 return "fault-tolerance (broadcast)";
202 case BOND_MODE_8023AD:
203 return "IEEE 802.3ad Dynamic link aggregation";
205 return "transmit load balancing";
207 return "adaptive load balancing";
213 /*---------------------------------- VLAN -----------------------------------*/
216 * bond_add_vlan - add a new vlan id on bond
217 * @bond: bond that got the notification
218 * @vlan_id: the vlan id to add
220 * Returns -ENOMEM if allocation failed.
222 static int bond_add_vlan(struct bonding *bond, unsigned short vlan_id)
224 struct vlan_entry *vlan;
226 dprintk("bond: %s, vlan id %d\n",
227 (bond ? bond->dev->name: "None"), vlan_id);
229 vlan = kmalloc(sizeof(struct vlan_entry), GFP_KERNEL);
234 INIT_LIST_HEAD(&vlan->vlan_list);
235 vlan->vlan_id = vlan_id;
238 write_lock_bh(&bond->lock);
240 list_add_tail(&vlan->vlan_list, &bond->vlan_list);
242 write_unlock_bh(&bond->lock);
244 dprintk("added VLAN ID %d on bond %s\n", vlan_id, bond->dev->name);
250 * bond_del_vlan - delete a vlan id from bond
251 * @bond: bond that got the notification
252 * @vlan_id: the vlan id to delete
254 * returns -ENODEV if @vlan_id was not found in @bond.
256 static int bond_del_vlan(struct bonding *bond, unsigned short vlan_id)
258 struct vlan_entry *vlan, *next;
261 dprintk("bond: %s, vlan id %d\n", bond->dev->name, vlan_id);
263 write_lock_bh(&bond->lock);
265 list_for_each_entry_safe(vlan, next, &bond->vlan_list, vlan_list) {
266 if (vlan->vlan_id == vlan_id) {
267 list_del(&vlan->vlan_list);
269 if ((bond->params.mode == BOND_MODE_TLB) ||
270 (bond->params.mode == BOND_MODE_ALB)) {
271 bond_alb_clear_vlan(bond, vlan_id);
274 dprintk("removed VLAN ID %d from bond %s\n", vlan_id,
279 if (list_empty(&bond->vlan_list) &&
280 (bond->slave_cnt == 0)) {
281 /* Last VLAN removed and no slaves, so
282 * restore block on adding VLANs. This will
283 * be removed once new slaves that are not
284 * VLAN challenged will be added.
286 bond->dev->features |= NETIF_F_VLAN_CHALLENGED;
294 dprintk("couldn't find VLAN ID %d in bond %s\n", vlan_id,
298 write_unlock_bh(&bond->lock);
303 * bond_has_challenged_slaves
304 * @bond: the bond we're working on
306 * Searches the slave list. Returns 1 if a vlan challenged slave
307 * was found, 0 otherwise.
309 * Assumes bond->lock is held.
311 static int bond_has_challenged_slaves(struct bonding *bond)
316 bond_for_each_slave(bond, slave, i) {
317 if (slave->dev->features & NETIF_F_VLAN_CHALLENGED) {
318 dprintk("found VLAN challenged slave - %s\n",
324 dprintk("no VLAN challenged slaves found\n");
329 * bond_next_vlan - safely skip to the next item in the vlans list.
330 * @bond: the bond we're working on
331 * @curr: item we're advancing from
333 * Returns %NULL if list is empty, bond->next_vlan if @curr is %NULL,
334 * or @curr->next otherwise (even if it is @curr itself again).
336 * Caller must hold bond->lock
338 struct vlan_entry *bond_next_vlan(struct bonding *bond, struct vlan_entry *curr)
340 struct vlan_entry *next, *last;
342 if (list_empty(&bond->vlan_list)) {
347 next = list_entry(bond->vlan_list.next,
348 struct vlan_entry, vlan_list);
350 last = list_entry(bond->vlan_list.prev,
351 struct vlan_entry, vlan_list);
353 next = list_entry(bond->vlan_list.next,
354 struct vlan_entry, vlan_list);
356 next = list_entry(curr->vlan_list.next,
357 struct vlan_entry, vlan_list);
365 * bond_dev_queue_xmit - Prepare skb for xmit.
367 * @bond: bond device that got this skb for tx.
368 * @skb: hw accel VLAN tagged skb to transmit
369 * @slave_dev: slave that is supposed to xmit this skbuff
371 * When the bond gets an skb to transmit that is
372 * already hardware accelerated VLAN tagged, and it
373 * needs to relay this skb to a slave that is not
374 * hw accel capable, the skb needs to be "unaccelerated",
375 * i.e. strip the hwaccel tag and re-insert it as part
378 int bond_dev_queue_xmit(struct bonding *bond, struct sk_buff *skb, struct net_device *slave_dev)
380 unsigned short vlan_id;
382 if (!list_empty(&bond->vlan_list) &&
383 !(slave_dev->features & NETIF_F_HW_VLAN_TX) &&
384 vlan_get_tag(skb, &vlan_id) == 0) {
385 skb->dev = slave_dev;
386 skb = vlan_put_tag(skb, vlan_id);
388 /* vlan_put_tag() frees the skb in case of error,
389 * so return success here so the calling functions
390 * won't attempt to free is again.
395 skb->dev = slave_dev;
405 * In the following 3 functions, bond_vlan_rx_register(), bond_vlan_rx_add_vid
406 * and bond_vlan_rx_kill_vid, We don't protect the slave list iteration with a
408 * a. This operation is performed in IOCTL context,
409 * b. The operation is protected by the RTNL semaphore in the 8021q code,
410 * c. Holding a lock with BH disabled while directly calling a base driver
411 * entry point is generally a BAD idea.
413 * The design of synchronization/protection for this operation in the 8021q
414 * module is good for one or more VLAN devices over a single physical device
415 * and cannot be extended for a teaming solution like bonding, so there is a
416 * potential race condition here where a net device from the vlan group might
417 * be referenced (either by a base driver or the 8021q code) while it is being
418 * removed from the system. However, it turns out we're not making matters
419 * worse, and if it works for regular VLAN usage it will work here too.
423 * bond_vlan_rx_register - Propagates registration to slaves
424 * @bond_dev: bonding net device that got called
425 * @grp: vlan group being registered
427 static void bond_vlan_rx_register(struct net_device *bond_dev, struct vlan_group *grp)
429 struct bonding *bond = bond_dev->priv;
435 bond_for_each_slave(bond, slave, i) {
436 struct net_device *slave_dev = slave->dev;
438 if ((slave_dev->features & NETIF_F_HW_VLAN_RX) &&
439 slave_dev->vlan_rx_register) {
440 slave_dev->vlan_rx_register(slave_dev, grp);
446 * bond_vlan_rx_add_vid - Propagates adding an id to slaves
447 * @bond_dev: bonding net device that got called
448 * @vid: vlan id being added
450 static void bond_vlan_rx_add_vid(struct net_device *bond_dev, uint16_t vid)
452 struct bonding *bond = bond_dev->priv;
456 bond_for_each_slave(bond, slave, i) {
457 struct net_device *slave_dev = slave->dev;
459 if ((slave_dev->features & NETIF_F_HW_VLAN_FILTER) &&
460 slave_dev->vlan_rx_add_vid) {
461 slave_dev->vlan_rx_add_vid(slave_dev, vid);
465 res = bond_add_vlan(bond, vid);
467 printk(KERN_ERR DRV_NAME
468 ": %s: Error: Failed to add vlan id %d\n",
469 bond_dev->name, vid);
474 * bond_vlan_rx_kill_vid - Propagates deleting an id to slaves
475 * @bond_dev: bonding net device that got called
476 * @vid: vlan id being removed
478 static void bond_vlan_rx_kill_vid(struct net_device *bond_dev, uint16_t vid)
480 struct bonding *bond = bond_dev->priv;
482 struct net_device *vlan_dev;
485 bond_for_each_slave(bond, slave, i) {
486 struct net_device *slave_dev = slave->dev;
488 if ((slave_dev->features & NETIF_F_HW_VLAN_FILTER) &&
489 slave_dev->vlan_rx_kill_vid) {
490 /* Save and then restore vlan_dev in the grp array,
491 * since the slave's driver might clear it.
493 vlan_dev = vlan_group_get_device(bond->vlgrp, vid);
494 slave_dev->vlan_rx_kill_vid(slave_dev, vid);
495 vlan_group_set_device(bond->vlgrp, vid, vlan_dev);
499 res = bond_del_vlan(bond, vid);
501 printk(KERN_ERR DRV_NAME
502 ": %s: Error: Failed to remove vlan id %d\n",
503 bond_dev->name, vid);
507 static void bond_add_vlans_on_slave(struct bonding *bond, struct net_device *slave_dev)
509 struct vlan_entry *vlan;
511 write_lock_bh(&bond->lock);
513 if (list_empty(&bond->vlan_list)) {
517 if ((slave_dev->features & NETIF_F_HW_VLAN_RX) &&
518 slave_dev->vlan_rx_register) {
519 slave_dev->vlan_rx_register(slave_dev, bond->vlgrp);
522 if (!(slave_dev->features & NETIF_F_HW_VLAN_FILTER) ||
523 !(slave_dev->vlan_rx_add_vid)) {
527 list_for_each_entry(vlan, &bond->vlan_list, vlan_list) {
528 slave_dev->vlan_rx_add_vid(slave_dev, vlan->vlan_id);
532 write_unlock_bh(&bond->lock);
535 static void bond_del_vlans_from_slave(struct bonding *bond, struct net_device *slave_dev)
537 struct vlan_entry *vlan;
538 struct net_device *vlan_dev;
540 write_lock_bh(&bond->lock);
542 if (list_empty(&bond->vlan_list)) {
546 if (!(slave_dev->features & NETIF_F_HW_VLAN_FILTER) ||
547 !(slave_dev->vlan_rx_kill_vid)) {
551 list_for_each_entry(vlan, &bond->vlan_list, vlan_list) {
552 /* Save and then restore vlan_dev in the grp array,
553 * since the slave's driver might clear it.
555 vlan_dev = vlan_group_get_device(bond->vlgrp, vlan->vlan_id);
556 slave_dev->vlan_rx_kill_vid(slave_dev, vlan->vlan_id);
557 vlan_group_set_device(bond->vlgrp, vlan->vlan_id, vlan_dev);
561 if ((slave_dev->features & NETIF_F_HW_VLAN_RX) &&
562 slave_dev->vlan_rx_register) {
563 slave_dev->vlan_rx_register(slave_dev, NULL);
567 write_unlock_bh(&bond->lock);
570 /*------------------------------- Link status -------------------------------*/
573 * Set the carrier state for the master according to the state of its
574 * slaves. If any slaves are up, the master is up. In 802.3ad mode,
575 * do special 802.3ad magic.
577 * Returns zero if carrier state does not change, nonzero if it does.
579 static int bond_set_carrier(struct bonding *bond)
584 if (bond->slave_cnt == 0)
587 if (bond->params.mode == BOND_MODE_8023AD)
588 return bond_3ad_set_carrier(bond);
590 bond_for_each_slave(bond, slave, i) {
591 if (slave->link == BOND_LINK_UP) {
592 if (!netif_carrier_ok(bond->dev)) {
593 netif_carrier_on(bond->dev);
601 if (netif_carrier_ok(bond->dev)) {
602 netif_carrier_off(bond->dev);
609 * Get link speed and duplex from the slave's base driver
610 * using ethtool. If for some reason the call fails or the
611 * values are invalid, fake speed and duplex to 100/Full
614 static int bond_update_speed_duplex(struct slave *slave)
616 struct net_device *slave_dev = slave->dev;
617 struct ethtool_cmd etool;
620 /* Fake speed and duplex */
621 slave->speed = SPEED_100;
622 slave->duplex = DUPLEX_FULL;
624 if (!slave_dev->ethtool_ops || !slave_dev->ethtool_ops->get_settings)
627 res = slave_dev->ethtool_ops->get_settings(slave_dev, &etool);
631 switch (etool.speed) {
641 switch (etool.duplex) {
649 slave->speed = etool.speed;
650 slave->duplex = etool.duplex;
656 * if <dev> supports MII link status reporting, check its link status.
658 * We either do MII/ETHTOOL ioctls, or check netif_carrier_ok(),
659 * depening upon the setting of the use_carrier parameter.
661 * Return either BMSR_LSTATUS, meaning that the link is up (or we
662 * can't tell and just pretend it is), or 0, meaning that the link is
665 * If reporting is non-zero, instead of faking link up, return -1 if
666 * both ETHTOOL and MII ioctls fail (meaning the device does not
667 * support them). If use_carrier is set, return whatever it says.
668 * It'd be nice if there was a good way to tell if a driver supports
669 * netif_carrier, but there really isn't.
671 static int bond_check_dev_link(struct bonding *bond, struct net_device *slave_dev, int reporting)
673 static int (* ioctl)(struct net_device *, struct ifreq *, int);
675 struct mii_ioctl_data *mii;
677 if (bond->params.use_carrier) {
678 return netif_carrier_ok(slave_dev) ? BMSR_LSTATUS : 0;
681 ioctl = slave_dev->do_ioctl;
683 /* TODO: set pointer to correct ioctl on a per team member */
684 /* bases to make this more efficient. that is, once */
685 /* we determine the correct ioctl, we will always */
686 /* call it and not the others for that team */
690 * We cannot assume that SIOCGMIIPHY will also read a
691 * register; not all network drivers (e.g., e100)
695 /* Yes, the mii is overlaid on the ifreq.ifr_ifru */
696 strncpy(ifr.ifr_name, slave_dev->name, IFNAMSIZ);
698 if (IOCTL(slave_dev, &ifr, SIOCGMIIPHY) == 0) {
699 mii->reg_num = MII_BMSR;
700 if (IOCTL(slave_dev, &ifr, SIOCGMIIREG) == 0) {
701 return (mii->val_out & BMSR_LSTATUS);
707 * Some drivers cache ETHTOOL_GLINK for a period of time so we only
708 * attempt to get link status from it if the above MII ioctls fail.
710 if (slave_dev->ethtool_ops) {
711 if (slave_dev->ethtool_ops->get_link) {
714 link = slave_dev->ethtool_ops->get_link(slave_dev);
716 return link ? BMSR_LSTATUS : 0;
721 * If reporting, report that either there's no dev->do_ioctl,
722 * or both SIOCGMIIREG and get_link failed (meaning that we
723 * cannot report link status). If not reporting, pretend
726 return (reporting ? -1 : BMSR_LSTATUS);
729 /*----------------------------- Multicast list ------------------------------*/
732 * Returns 0 if dmi1 and dmi2 are the same, non-0 otherwise
734 static inline int bond_is_dmi_same(struct dev_mc_list *dmi1, struct dev_mc_list *dmi2)
736 return memcmp(dmi1->dmi_addr, dmi2->dmi_addr, dmi1->dmi_addrlen) == 0 &&
737 dmi1->dmi_addrlen == dmi2->dmi_addrlen;
741 * returns dmi entry if found, NULL otherwise
743 static struct dev_mc_list *bond_mc_list_find_dmi(struct dev_mc_list *dmi, struct dev_mc_list *mc_list)
745 struct dev_mc_list *idmi;
747 for (idmi = mc_list; idmi; idmi = idmi->next) {
748 if (bond_is_dmi_same(dmi, idmi)) {
757 * Push the promiscuity flag down to appropriate slaves
759 static void bond_set_promiscuity(struct bonding *bond, int inc)
761 if (USES_PRIMARY(bond->params.mode)) {
762 /* write lock already acquired */
763 if (bond->curr_active_slave) {
764 dev_set_promiscuity(bond->curr_active_slave->dev, inc);
769 bond_for_each_slave(bond, slave, i) {
770 dev_set_promiscuity(slave->dev, inc);
776 * Push the allmulti flag down to all slaves
778 static void bond_set_allmulti(struct bonding *bond, int inc)
780 if (USES_PRIMARY(bond->params.mode)) {
781 /* write lock already acquired */
782 if (bond->curr_active_slave) {
783 dev_set_allmulti(bond->curr_active_slave->dev, inc);
788 bond_for_each_slave(bond, slave, i) {
789 dev_set_allmulti(slave->dev, inc);
795 * Add a Multicast address to slaves
798 static void bond_mc_add(struct bonding *bond, void *addr, int alen)
800 if (USES_PRIMARY(bond->params.mode)) {
801 /* write lock already acquired */
802 if (bond->curr_active_slave) {
803 dev_mc_add(bond->curr_active_slave->dev, addr, alen, 0);
808 bond_for_each_slave(bond, slave, i) {
809 dev_mc_add(slave->dev, addr, alen, 0);
815 * Remove a multicast address from slave
818 static void bond_mc_delete(struct bonding *bond, void *addr, int alen)
820 if (USES_PRIMARY(bond->params.mode)) {
821 /* write lock already acquired */
822 if (bond->curr_active_slave) {
823 dev_mc_delete(bond->curr_active_slave->dev, addr, alen, 0);
828 bond_for_each_slave(bond, slave, i) {
829 dev_mc_delete(slave->dev, addr, alen, 0);
836 * Retrieve the list of registered multicast addresses for the bonding
837 * device and retransmit an IGMP JOIN request to the current active
840 static void bond_resend_igmp_join_requests(struct bonding *bond)
842 struct in_device *in_dev;
843 struct ip_mc_list *im;
846 in_dev = __in_dev_get_rcu(bond->dev);
848 for (im = in_dev->mc_list; im; im = im->next) {
849 ip_mc_rejoin_group(im);
857 * Totally destroys the mc_list in bond
859 static void bond_mc_list_destroy(struct bonding *bond)
861 struct dev_mc_list *dmi;
865 bond->mc_list = dmi->next;
869 bond->mc_list = NULL;
873 * Copy all the Multicast addresses from src to the bonding device dst
875 static int bond_mc_list_copy(struct dev_mc_list *mc_list, struct bonding *bond,
878 struct dev_mc_list *dmi, *new_dmi;
880 for (dmi = mc_list; dmi; dmi = dmi->next) {
881 new_dmi = kmalloc(sizeof(struct dev_mc_list), gfp_flag);
884 /* FIXME: Potential memory leak !!! */
888 new_dmi->next = bond->mc_list;
889 bond->mc_list = new_dmi;
890 new_dmi->dmi_addrlen = dmi->dmi_addrlen;
891 memcpy(new_dmi->dmi_addr, dmi->dmi_addr, dmi->dmi_addrlen);
892 new_dmi->dmi_users = dmi->dmi_users;
893 new_dmi->dmi_gusers = dmi->dmi_gusers;
900 * flush all members of flush->mc_list from device dev->mc_list
902 static void bond_mc_list_flush(struct net_device *bond_dev, struct net_device *slave_dev)
904 struct bonding *bond = bond_dev->priv;
905 struct dev_mc_list *dmi;
907 for (dmi = bond_dev->mc_list; dmi; dmi = dmi->next) {
908 dev_mc_delete(slave_dev, dmi->dmi_addr, dmi->dmi_addrlen, 0);
911 if (bond->params.mode == BOND_MODE_8023AD) {
912 /* del lacpdu mc addr from mc list */
913 u8 lacpdu_multicast[ETH_ALEN] = MULTICAST_LACPDU_ADDR;
915 dev_mc_delete(slave_dev, lacpdu_multicast, ETH_ALEN, 0);
919 /*--------------------------- Active slave change ---------------------------*/
922 * Update the mc list and multicast-related flags for the new and
923 * old active slaves (if any) according to the multicast mode, and
924 * promiscuous flags unconditionally.
926 static void bond_mc_swap(struct bonding *bond, struct slave *new_active, struct slave *old_active)
928 struct dev_mc_list *dmi;
930 if (!USES_PRIMARY(bond->params.mode)) {
931 /* nothing to do - mc list is already up-to-date on
938 if (bond->dev->flags & IFF_PROMISC) {
939 dev_set_promiscuity(old_active->dev, -1);
942 if (bond->dev->flags & IFF_ALLMULTI) {
943 dev_set_allmulti(old_active->dev, -1);
946 for (dmi = bond->dev->mc_list; dmi; dmi = dmi->next) {
947 dev_mc_delete(old_active->dev, dmi->dmi_addr, dmi->dmi_addrlen, 0);
952 if (bond->dev->flags & IFF_PROMISC) {
953 dev_set_promiscuity(new_active->dev, 1);
956 if (bond->dev->flags & IFF_ALLMULTI) {
957 dev_set_allmulti(new_active->dev, 1);
960 for (dmi = bond->dev->mc_list; dmi; dmi = dmi->next) {
961 dev_mc_add(new_active->dev, dmi->dmi_addr, dmi->dmi_addrlen, 0);
963 bond_resend_igmp_join_requests(bond);
968 * find_best_interface - select the best available slave to be the active one
969 * @bond: our bonding struct
971 * Warning: Caller must hold curr_slave_lock for writing.
973 static struct slave *bond_find_best_slave(struct bonding *bond)
975 struct slave *new_active, *old_active;
976 struct slave *bestslave = NULL;
977 int mintime = bond->params.updelay;
980 new_active = old_active = bond->curr_active_slave;
982 if (!new_active) { /* there were no active slaves left */
983 if (bond->slave_cnt > 0) { /* found one slave */
984 new_active = bond->first_slave;
986 return NULL; /* still no slave, return NULL */
990 /* first try the primary link; if arping, a link must tx/rx traffic
991 * before it can be considered the curr_active_slave - also, we would skip
992 * slaves between the curr_active_slave and primary_slave that may be up
995 if ((bond->primary_slave) &&
996 (!bond->params.arp_interval) &&
997 (IS_UP(bond->primary_slave->dev))) {
998 new_active = bond->primary_slave;
1001 /* remember where to stop iterating over the slaves */
1002 old_active = new_active;
1004 bond_for_each_slave_from(bond, new_active, i, old_active) {
1005 if (IS_UP(new_active->dev)) {
1006 if (new_active->link == BOND_LINK_UP) {
1008 } else if (new_active->link == BOND_LINK_BACK) {
1009 /* link up, but waiting for stabilization */
1010 if (new_active->delay < mintime) {
1011 mintime = new_active->delay;
1012 bestslave = new_active;
1022 * change_active_interface - change the active slave into the specified one
1023 * @bond: our bonding struct
1024 * @new: the new slave to make the active one
1026 * Set the new slave to the bond's settings and unset them on the old
1027 * curr_active_slave.
1028 * Setting include flags, mc-list, promiscuity, allmulti, etc.
1030 * If @new's link state is %BOND_LINK_BACK we'll set it to %BOND_LINK_UP,
1031 * because it is apparently the best available slave we have, even though its
1032 * updelay hasn't timed out yet.
1034 * Warning: Caller must hold curr_slave_lock for writing.
1036 void bond_change_active_slave(struct bonding *bond, struct slave *new_active)
1038 struct slave *old_active = bond->curr_active_slave;
1040 if (old_active == new_active) {
1045 if (new_active->link == BOND_LINK_BACK) {
1046 if (USES_PRIMARY(bond->params.mode)) {
1047 printk(KERN_INFO DRV_NAME
1048 ": %s: making interface %s the new "
1049 "active one %d ms earlier.\n",
1050 bond->dev->name, new_active->dev->name,
1051 (bond->params.updelay - new_active->delay) * bond->params.miimon);
1054 new_active->delay = 0;
1055 new_active->link = BOND_LINK_UP;
1056 new_active->jiffies = jiffies;
1058 if (bond->params.mode == BOND_MODE_8023AD) {
1059 bond_3ad_handle_link_change(new_active, BOND_LINK_UP);
1062 if ((bond->params.mode == BOND_MODE_TLB) ||
1063 (bond->params.mode == BOND_MODE_ALB)) {
1064 bond_alb_handle_link_change(bond, new_active, BOND_LINK_UP);
1067 if (USES_PRIMARY(bond->params.mode)) {
1068 printk(KERN_INFO DRV_NAME
1069 ": %s: making interface %s the new "
1071 bond->dev->name, new_active->dev->name);
1076 if (USES_PRIMARY(bond->params.mode)) {
1077 bond_mc_swap(bond, new_active, old_active);
1080 if ((bond->params.mode == BOND_MODE_TLB) ||
1081 (bond->params.mode == BOND_MODE_ALB)) {
1082 bond_alb_handle_active_change(bond, new_active);
1084 bond_set_slave_inactive_flags(old_active);
1086 bond_set_slave_active_flags(new_active);
1088 bond->curr_active_slave = new_active;
1091 if (bond->params.mode == BOND_MODE_ACTIVEBACKUP) {
1093 bond_set_slave_inactive_flags(old_active);
1097 bond_set_slave_active_flags(new_active);
1100 /* when bonding does not set the slave MAC address, the bond MAC
1101 * address is the one of the active slave.
1103 if (new_active && !bond->do_set_mac_addr)
1104 memcpy(bond->dev->dev_addr, new_active->dev->dev_addr,
1105 new_active->dev->addr_len);
1107 bond_send_gratuitous_arp(bond);
1112 * bond_select_active_slave - select a new active slave, if needed
1113 * @bond: our bonding struct
1115 * This functions shoud be called when one of the following occurs:
1116 * - The old curr_active_slave has been released or lost its link.
1117 * - The primary_slave has got its link back.
1118 * - A slave has got its link back and there's no old curr_active_slave.
1120 * Warning: Caller must hold curr_slave_lock for writing.
1122 void bond_select_active_slave(struct bonding *bond)
1124 struct slave *best_slave;
1127 best_slave = bond_find_best_slave(bond);
1128 if (best_slave != bond->curr_active_slave) {
1129 bond_change_active_slave(bond, best_slave);
1130 rv = bond_set_carrier(bond);
1134 if (netif_carrier_ok(bond->dev)) {
1135 printk(KERN_INFO DRV_NAME
1136 ": %s: first active interface up!\n",
1139 printk(KERN_INFO DRV_NAME ": %s: "
1140 "now running without any active interface !\n",
1146 /*--------------------------- slave list handling ---------------------------*/
1149 * This function attaches the slave to the end of list.
1151 * bond->lock held for writing by caller.
1153 static void bond_attach_slave(struct bonding *bond, struct slave *new_slave)
1155 if (bond->first_slave == NULL) { /* attaching the first slave */
1156 new_slave->next = new_slave;
1157 new_slave->prev = new_slave;
1158 bond->first_slave = new_slave;
1160 new_slave->next = bond->first_slave;
1161 new_slave->prev = bond->first_slave->prev;
1162 new_slave->next->prev = new_slave;
1163 new_slave->prev->next = new_slave;
1170 * This function detaches the slave from the list.
1171 * WARNING: no check is made to verify if the slave effectively
1172 * belongs to <bond>.
1173 * Nothing is freed on return, structures are just unchained.
1174 * If any slave pointer in bond was pointing to <slave>,
1175 * it should be changed by the calling function.
1177 * bond->lock held for writing by caller.
1179 static void bond_detach_slave(struct bonding *bond, struct slave *slave)
1182 slave->next->prev = slave->prev;
1186 slave->prev->next = slave->next;
1189 if (bond->first_slave == slave) { /* slave is the first slave */
1190 if (bond->slave_cnt > 1) { /* there are more slave */
1191 bond->first_slave = slave->next;
1193 bond->first_slave = NULL; /* slave was the last one */
1202 /*---------------------------------- IOCTL ----------------------------------*/
1204 static int bond_sethwaddr(struct net_device *bond_dev,
1205 struct net_device *slave_dev)
1207 dprintk("bond_dev=%p\n", bond_dev);
1208 dprintk("slave_dev=%p\n", slave_dev);
1209 dprintk("slave_dev->addr_len=%d\n", slave_dev->addr_len);
1210 memcpy(bond_dev->dev_addr, slave_dev->dev_addr, slave_dev->addr_len);
1214 #define BOND_VLAN_FEATURES \
1215 (NETIF_F_VLAN_CHALLENGED | NETIF_F_HW_VLAN_RX | NETIF_F_HW_VLAN_TX | \
1216 NETIF_F_HW_VLAN_FILTER)
1219 * Compute the common dev->feature set available to all slaves. Some
1220 * feature bits are managed elsewhere, so preserve those feature bits
1221 * on the master device.
1223 static int bond_compute_features(struct bonding *bond)
1225 struct slave *slave;
1226 struct net_device *bond_dev = bond->dev;
1227 unsigned long features = bond_dev->features;
1228 unsigned short max_hard_header_len = ETH_HLEN;
1231 features &= ~(NETIF_F_ALL_CSUM | BOND_VLAN_FEATURES);
1232 features |= NETIF_F_SG | NETIF_F_FRAGLIST | NETIF_F_HIGHDMA |
1233 NETIF_F_GSO_MASK | NETIF_F_NO_CSUM;
1235 bond_for_each_slave(bond, slave, i) {
1236 features = netdev_compute_features(features,
1237 slave->dev->features);
1238 if (slave->dev->hard_header_len > max_hard_header_len)
1239 max_hard_header_len = slave->dev->hard_header_len;
1242 features |= (bond_dev->features & BOND_VLAN_FEATURES);
1243 bond_dev->features = features;
1244 bond_dev->hard_header_len = max_hard_header_len;
1250 static void bond_setup_by_slave(struct net_device *bond_dev,
1251 struct net_device *slave_dev)
1253 bond_dev->neigh_setup = slave_dev->neigh_setup;
1255 bond_dev->type = slave_dev->type;
1256 bond_dev->hard_header_len = slave_dev->hard_header_len;
1257 bond_dev->addr_len = slave_dev->addr_len;
1259 memcpy(bond_dev->broadcast, slave_dev->broadcast,
1260 slave_dev->addr_len);
1263 /* enslave device <slave> to bond device <master> */
1264 int bond_enslave(struct net_device *bond_dev, struct net_device *slave_dev)
1266 struct bonding *bond = bond_dev->priv;
1267 struct slave *new_slave = NULL;
1268 struct dev_mc_list *dmi;
1269 struct sockaddr addr;
1271 int old_features = bond_dev->features;
1274 if (!bond->params.use_carrier && slave_dev->ethtool_ops == NULL &&
1275 slave_dev->do_ioctl == NULL) {
1276 printk(KERN_WARNING DRV_NAME
1277 ": %s: Warning: no link monitoring support for %s\n",
1278 bond_dev->name, slave_dev->name);
1281 /* bond must be initialized by bond_open() before enslaving */
1282 if (!(bond_dev->flags & IFF_UP)) {
1283 dprintk("Error, master_dev is not up\n");
1287 /* already enslaved */
1288 if (slave_dev->flags & IFF_SLAVE) {
1289 dprintk("Error, Device was already enslaved\n");
1293 /* vlan challenged mutual exclusion */
1294 /* no need to lock since we're protected by rtnl_lock */
1295 if (slave_dev->features & NETIF_F_VLAN_CHALLENGED) {
1296 dprintk("%s: NETIF_F_VLAN_CHALLENGED\n", slave_dev->name);
1297 if (!list_empty(&bond->vlan_list)) {
1298 printk(KERN_ERR DRV_NAME
1299 ": %s: Error: cannot enslave VLAN "
1300 "challenged slave %s on VLAN enabled "
1301 "bond %s\n", bond_dev->name, slave_dev->name,
1305 printk(KERN_WARNING DRV_NAME
1306 ": %s: Warning: enslaved VLAN challenged "
1307 "slave %s. Adding VLANs will be blocked as "
1308 "long as %s is part of bond %s\n",
1309 bond_dev->name, slave_dev->name, slave_dev->name,
1311 bond_dev->features |= NETIF_F_VLAN_CHALLENGED;
1314 dprintk("%s: ! NETIF_F_VLAN_CHALLENGED\n", slave_dev->name);
1315 if (bond->slave_cnt == 0) {
1316 /* First slave, and it is not VLAN challenged,
1317 * so remove the block of adding VLANs over the bond.
1319 bond_dev->features &= ~NETIF_F_VLAN_CHALLENGED;
1324 * Old ifenslave binaries are no longer supported. These can
1325 * be identified with moderate accurary by the state of the slave:
1326 * the current ifenslave will set the interface down prior to
1327 * enslaving it; the old ifenslave will not.
1329 if ((slave_dev->flags & IFF_UP)) {
1330 printk(KERN_ERR DRV_NAME ": %s is up. "
1331 "This may be due to an out of date ifenslave.\n",
1334 goto err_undo_flags;
1337 /* set bonding device ether type by slave - bonding netdevices are
1338 * created with ether_setup, so when the slave type is not ARPHRD_ETHER
1339 * there is a need to override some of the type dependent attribs/funcs.
1341 * bond ether type mutual exclusion - don't allow slaves of dissimilar
1342 * ether type (eg ARPHRD_ETHER and ARPHRD_INFINIBAND) share the same bond
1344 if (bond->slave_cnt == 0) {
1345 if (slave_dev->type != ARPHRD_ETHER)
1346 bond_setup_by_slave(bond_dev, slave_dev);
1347 } else if (bond_dev->type != slave_dev->type) {
1348 printk(KERN_ERR DRV_NAME ": %s ether type (%d) is different "
1349 "from other slaves (%d), can not enslave it.\n",
1351 slave_dev->type, bond_dev->type);
1353 goto err_undo_flags;
1356 if (slave_dev->set_mac_address == NULL) {
1357 if (bond->slave_cnt == 0) {
1358 printk(KERN_WARNING DRV_NAME
1359 ": %s: Warning: The first slave device you "
1360 "specified does not support setting the MAC "
1361 "address. This bond MAC address would be that "
1362 "of the active slave.\n", bond_dev->name);
1363 bond->do_set_mac_addr = 0;
1364 } else if (bond->do_set_mac_addr) {
1365 printk(KERN_ERR DRV_NAME
1366 ": %s: Error: The slave device you specified "
1367 "does not support setting the MAC addres,."
1368 "but this bond uses this practice. \n"
1371 goto err_undo_flags;
1375 new_slave = kzalloc(sizeof(struct slave), GFP_KERNEL);
1378 goto err_undo_flags;
1381 /* save slave's original flags before calling
1382 * netdev_set_master and dev_open
1384 new_slave->original_flags = slave_dev->flags;
1387 * Save slave's original ("permanent") mac address for modes
1388 * that need it, and for restoring it upon release, and then
1389 * set it to the master's address
1391 memcpy(new_slave->perm_hwaddr, slave_dev->dev_addr, ETH_ALEN);
1393 if (bond->do_set_mac_addr) {
1395 * Set slave to master's mac address. The application already
1396 * set the master's mac address to that of the first slave
1398 memcpy(addr.sa_data, bond_dev->dev_addr, bond_dev->addr_len);
1399 addr.sa_family = slave_dev->type;
1400 res = dev_set_mac_address(slave_dev, &addr);
1402 dprintk("Error %d calling set_mac_address\n", res);
1407 res = netdev_set_master(slave_dev, bond_dev);
1409 dprintk("Error %d calling netdev_set_master\n", res);
1412 /* open the slave since the application closed it */
1413 res = dev_open(slave_dev);
1415 dprintk("Openning slave %s failed\n", slave_dev->name);
1416 goto err_restore_mac;
1419 new_slave->dev = slave_dev;
1420 slave_dev->priv_flags |= IFF_BONDING;
1422 if ((bond->params.mode == BOND_MODE_TLB) ||
1423 (bond->params.mode == BOND_MODE_ALB)) {
1424 /* bond_alb_init_slave() must be called before all other stages since
1425 * it might fail and we do not want to have to undo everything
1427 res = bond_alb_init_slave(bond, new_slave);
1429 goto err_unset_master;
1433 /* If the mode USES_PRIMARY, then the new slave gets the
1434 * master's promisc (and mc) settings only if it becomes the
1435 * curr_active_slave, and that is taken care of later when calling
1436 * bond_change_active()
1438 if (!USES_PRIMARY(bond->params.mode)) {
1439 /* set promiscuity level to new slave */
1440 if (bond_dev->flags & IFF_PROMISC) {
1441 dev_set_promiscuity(slave_dev, 1);
1444 /* set allmulti level to new slave */
1445 if (bond_dev->flags & IFF_ALLMULTI) {
1446 dev_set_allmulti(slave_dev, 1);
1449 /* upload master's mc_list to new slave */
1450 for (dmi = bond_dev->mc_list; dmi; dmi = dmi->next) {
1451 dev_mc_add (slave_dev, dmi->dmi_addr, dmi->dmi_addrlen, 0);
1455 if (bond->params.mode == BOND_MODE_8023AD) {
1456 /* add lacpdu mc addr to mc list */
1457 u8 lacpdu_multicast[ETH_ALEN] = MULTICAST_LACPDU_ADDR;
1459 dev_mc_add(slave_dev, lacpdu_multicast, ETH_ALEN, 0);
1462 bond_add_vlans_on_slave(bond, slave_dev);
1464 write_lock_bh(&bond->lock);
1466 bond_attach_slave(bond, new_slave);
1468 new_slave->delay = 0;
1469 new_slave->link_failure_count = 0;
1471 bond_compute_features(bond);
1473 new_slave->last_arp_rx = jiffies;
1475 if (bond->params.miimon && !bond->params.use_carrier) {
1476 link_reporting = bond_check_dev_link(bond, slave_dev, 1);
1478 if ((link_reporting == -1) && !bond->params.arp_interval) {
1480 * miimon is set but a bonded network driver
1481 * does not support ETHTOOL/MII and
1482 * arp_interval is not set. Note: if
1483 * use_carrier is enabled, we will never go
1484 * here (because netif_carrier is always
1485 * supported); thus, we don't need to change
1486 * the messages for netif_carrier.
1488 printk(KERN_WARNING DRV_NAME
1489 ": %s: Warning: MII and ETHTOOL support not "
1490 "available for interface %s, and "
1491 "arp_interval/arp_ip_target module parameters "
1492 "not specified, thus bonding will not detect "
1493 "link failures! see bonding.txt for details.\n",
1494 bond_dev->name, slave_dev->name);
1495 } else if (link_reporting == -1) {
1496 /* unable get link status using mii/ethtool */
1497 printk(KERN_WARNING DRV_NAME
1498 ": %s: Warning: can't get link status from "
1499 "interface %s; the network driver associated "
1500 "with this interface does not support MII or "
1501 "ETHTOOL link status reporting, thus miimon "
1502 "has no effect on this interface.\n",
1503 bond_dev->name, slave_dev->name);
1507 /* check for initial state */
1508 if (!bond->params.miimon ||
1509 (bond_check_dev_link(bond, slave_dev, 0) == BMSR_LSTATUS)) {
1510 if (bond->params.updelay) {
1511 dprintk("Initial state of slave_dev is "
1512 "BOND_LINK_BACK\n");
1513 new_slave->link = BOND_LINK_BACK;
1514 new_slave->delay = bond->params.updelay;
1516 dprintk("Initial state of slave_dev is "
1518 new_slave->link = BOND_LINK_UP;
1520 new_slave->jiffies = jiffies;
1522 dprintk("Initial state of slave_dev is "
1523 "BOND_LINK_DOWN\n");
1524 new_slave->link = BOND_LINK_DOWN;
1527 if (bond_update_speed_duplex(new_slave) &&
1528 (new_slave->link != BOND_LINK_DOWN)) {
1529 printk(KERN_WARNING DRV_NAME
1530 ": %s: Warning: failed to get speed and duplex from %s, "
1531 "assumed to be 100Mb/sec and Full.\n",
1532 bond_dev->name, new_slave->dev->name);
1534 if (bond->params.mode == BOND_MODE_8023AD) {
1535 printk(KERN_WARNING DRV_NAME
1536 ": %s: Warning: Operation of 802.3ad mode requires ETHTOOL "
1537 "support in base driver for proper aggregator "
1538 "selection.\n", bond_dev->name);
1542 if (USES_PRIMARY(bond->params.mode) && bond->params.primary[0]) {
1543 /* if there is a primary slave, remember it */
1544 if (strcmp(bond->params.primary, new_slave->dev->name) == 0) {
1545 bond->primary_slave = new_slave;
1549 switch (bond->params.mode) {
1550 case BOND_MODE_ACTIVEBACKUP:
1551 bond_set_slave_inactive_flags(new_slave);
1552 bond_select_active_slave(bond);
1554 case BOND_MODE_8023AD:
1555 /* in 802.3ad mode, the internal mechanism
1556 * will activate the slaves in the selected
1559 bond_set_slave_inactive_flags(new_slave);
1560 /* if this is the first slave */
1561 if (bond->slave_cnt == 1) {
1562 SLAVE_AD_INFO(new_slave).id = 1;
1563 /* Initialize AD with the number of times that the AD timer is called in 1 second
1564 * can be called only after the mac address of the bond is set
1566 bond_3ad_initialize(bond, 1000/AD_TIMER_INTERVAL,
1567 bond->params.lacp_fast);
1569 SLAVE_AD_INFO(new_slave).id =
1570 SLAVE_AD_INFO(new_slave->prev).id + 1;
1573 bond_3ad_bind_slave(new_slave);
1577 new_slave->state = BOND_STATE_ACTIVE;
1578 if ((!bond->curr_active_slave) &&
1579 (new_slave->link != BOND_LINK_DOWN)) {
1580 /* first slave or no active slave yet, and this link
1581 * is OK, so make this interface the active one
1583 bond_change_active_slave(bond, new_slave);
1585 bond_set_slave_inactive_flags(new_slave);
1589 dprintk("This slave is always active in trunk mode\n");
1591 /* always active in trunk mode */
1592 new_slave->state = BOND_STATE_ACTIVE;
1594 /* In trunking mode there is little meaning to curr_active_slave
1595 * anyway (it holds no special properties of the bond device),
1596 * so we can change it without calling change_active_interface()
1598 if (!bond->curr_active_slave) {
1599 bond->curr_active_slave = new_slave;
1602 } /* switch(bond_mode) */
1604 bond_set_carrier(bond);
1606 write_unlock_bh(&bond->lock);
1608 res = bond_create_slave_symlinks(bond_dev, slave_dev);
1610 goto err_unset_master;
1612 printk(KERN_INFO DRV_NAME
1613 ": %s: enslaving %s as a%s interface with a%s link.\n",
1614 bond_dev->name, slave_dev->name,
1615 new_slave->state == BOND_STATE_ACTIVE ? "n active" : " backup",
1616 new_slave->link != BOND_LINK_DOWN ? "n up" : " down");
1618 /* enslave is successful */
1621 /* Undo stages on error */
1623 netdev_set_master(slave_dev, NULL);
1626 dev_close(slave_dev);
1629 if (bond->do_set_mac_addr) {
1630 memcpy(addr.sa_data, new_slave->perm_hwaddr, ETH_ALEN);
1631 addr.sa_family = slave_dev->type;
1632 dev_set_mac_address(slave_dev, &addr);
1639 bond_dev->features = old_features;
1645 * Try to release the slave device <slave> from the bond device <master>
1646 * It is legal to access curr_active_slave without a lock because all the function
1649 * The rules for slave state should be:
1650 * for Active/Backup:
1651 * Active stays on all backups go down
1652 * for Bonded connections:
1653 * The first up interface should be left on and all others downed.
1655 int bond_release(struct net_device *bond_dev, struct net_device *slave_dev)
1657 struct bonding *bond = bond_dev->priv;
1658 struct slave *slave, *oldcurrent;
1659 struct sockaddr addr;
1660 int mac_addr_differ;
1661 DECLARE_MAC_BUF(mac);
1663 /* slave is not a slave or master is not master of this slave */
1664 if (!(slave_dev->flags & IFF_SLAVE) ||
1665 (slave_dev->master != bond_dev)) {
1666 printk(KERN_ERR DRV_NAME
1667 ": %s: Error: cannot release %s.\n",
1668 bond_dev->name, slave_dev->name);
1672 write_lock_bh(&bond->lock);
1674 slave = bond_get_slave_by_dev(bond, slave_dev);
1676 /* not a slave of this bond */
1677 printk(KERN_INFO DRV_NAME
1678 ": %s: %s not enslaved\n",
1679 bond_dev->name, slave_dev->name);
1680 write_unlock_bh(&bond->lock);
1684 mac_addr_differ = memcmp(bond_dev->dev_addr,
1687 if (!mac_addr_differ && (bond->slave_cnt > 1)) {
1688 printk(KERN_WARNING DRV_NAME
1689 ": %s: Warning: the permanent HWaddr of %s - "
1690 "%s - is still in use by %s. "
1691 "Set the HWaddr of %s to a different address "
1692 "to avoid conflicts.\n",
1695 print_mac(mac, slave->perm_hwaddr),
1700 /* Inform AD package of unbinding of slave. */
1701 if (bond->params.mode == BOND_MODE_8023AD) {
1702 /* must be called before the slave is
1703 * detached from the list
1705 bond_3ad_unbind_slave(slave);
1708 printk(KERN_INFO DRV_NAME
1709 ": %s: releasing %s interface %s\n",
1711 (slave->state == BOND_STATE_ACTIVE)
1712 ? "active" : "backup",
1715 oldcurrent = bond->curr_active_slave;
1717 bond->current_arp_slave = NULL;
1719 /* release the slave from its bond */
1720 bond_detach_slave(bond, slave);
1722 bond_compute_features(bond);
1724 if (bond->primary_slave == slave) {
1725 bond->primary_slave = NULL;
1728 if (oldcurrent == slave) {
1729 bond_change_active_slave(bond, NULL);
1732 if ((bond->params.mode == BOND_MODE_TLB) ||
1733 (bond->params.mode == BOND_MODE_ALB)) {
1734 /* Must be called only after the slave has been
1735 * detached from the list and the curr_active_slave
1736 * has been cleared (if our_slave == old_current),
1737 * but before a new active slave is selected.
1739 bond_alb_deinit_slave(bond, slave);
1742 if (oldcurrent == slave)
1743 bond_select_active_slave(bond);
1745 if (bond->slave_cnt == 0) {
1746 bond_set_carrier(bond);
1748 /* if the last slave was removed, zero the mac address
1749 * of the master so it will be set by the application
1750 * to the mac address of the first slave
1752 memset(bond_dev->dev_addr, 0, bond_dev->addr_len);
1754 if (list_empty(&bond->vlan_list)) {
1755 bond_dev->features |= NETIF_F_VLAN_CHALLENGED;
1757 printk(KERN_WARNING DRV_NAME
1758 ": %s: Warning: clearing HW address of %s while it "
1759 "still has VLANs.\n",
1760 bond_dev->name, bond_dev->name);
1761 printk(KERN_WARNING DRV_NAME
1762 ": %s: When re-adding slaves, make sure the bond's "
1763 "HW address matches its VLANs'.\n",
1766 } else if ((bond_dev->features & NETIF_F_VLAN_CHALLENGED) &&
1767 !bond_has_challenged_slaves(bond)) {
1768 printk(KERN_INFO DRV_NAME
1769 ": %s: last VLAN challenged slave %s "
1770 "left bond %s. VLAN blocking is removed\n",
1771 bond_dev->name, slave_dev->name, bond_dev->name);
1772 bond_dev->features &= ~NETIF_F_VLAN_CHALLENGED;
1775 write_unlock_bh(&bond->lock);
1777 /* must do this from outside any spinlocks */
1778 bond_destroy_slave_symlinks(bond_dev, slave_dev);
1780 bond_del_vlans_from_slave(bond, slave_dev);
1782 /* If the mode USES_PRIMARY, then we should only remove its
1783 * promisc and mc settings if it was the curr_active_slave, but that was
1784 * already taken care of above when we detached the slave
1786 if (!USES_PRIMARY(bond->params.mode)) {
1787 /* unset promiscuity level from slave */
1788 if (bond_dev->flags & IFF_PROMISC) {
1789 dev_set_promiscuity(slave_dev, -1);
1792 /* unset allmulti level from slave */
1793 if (bond_dev->flags & IFF_ALLMULTI) {
1794 dev_set_allmulti(slave_dev, -1);
1797 /* flush master's mc_list from slave */
1798 bond_mc_list_flush(bond_dev, slave_dev);
1801 netdev_set_master(slave_dev, NULL);
1803 /* close slave before restoring its mac address */
1804 dev_close(slave_dev);
1806 if (bond->do_set_mac_addr) {
1807 /* restore original ("permanent") mac address */
1808 memcpy(addr.sa_data, slave->perm_hwaddr, ETH_ALEN);
1809 addr.sa_family = slave_dev->type;
1810 dev_set_mac_address(slave_dev, &addr);
1813 slave_dev->priv_flags &= ~(IFF_MASTER_8023AD | IFF_MASTER_ALB |
1814 IFF_SLAVE_INACTIVE | IFF_BONDING |
1819 return 0; /* deletion OK */
1823 * This function releases all slaves.
1825 static int bond_release_all(struct net_device *bond_dev)
1827 struct bonding *bond = bond_dev->priv;
1828 struct slave *slave;
1829 struct net_device *slave_dev;
1830 struct sockaddr addr;
1832 write_lock_bh(&bond->lock);
1834 netif_carrier_off(bond_dev);
1836 if (bond->slave_cnt == 0) {
1840 bond->current_arp_slave = NULL;
1841 bond->primary_slave = NULL;
1842 bond_change_active_slave(bond, NULL);
1844 while ((slave = bond->first_slave) != NULL) {
1845 /* Inform AD package of unbinding of slave
1846 * before slave is detached from the list.
1848 if (bond->params.mode == BOND_MODE_8023AD) {
1849 bond_3ad_unbind_slave(slave);
1852 slave_dev = slave->dev;
1853 bond_detach_slave(bond, slave);
1855 if ((bond->params.mode == BOND_MODE_TLB) ||
1856 (bond->params.mode == BOND_MODE_ALB)) {
1857 /* must be called only after the slave
1858 * has been detached from the list
1860 bond_alb_deinit_slave(bond, slave);
1863 bond_compute_features(bond);
1865 /* now that the slave is detached, unlock and perform
1866 * all the undo steps that should not be called from
1869 write_unlock_bh(&bond->lock);
1871 bond_destroy_slave_symlinks(bond_dev, slave_dev);
1872 bond_del_vlans_from_slave(bond, slave_dev);
1874 /* If the mode USES_PRIMARY, then we should only remove its
1875 * promisc and mc settings if it was the curr_active_slave, but that was
1876 * already taken care of above when we detached the slave
1878 if (!USES_PRIMARY(bond->params.mode)) {
1879 /* unset promiscuity level from slave */
1880 if (bond_dev->flags & IFF_PROMISC) {
1881 dev_set_promiscuity(slave_dev, -1);
1884 /* unset allmulti level from slave */
1885 if (bond_dev->flags & IFF_ALLMULTI) {
1886 dev_set_allmulti(slave_dev, -1);
1889 /* flush master's mc_list from slave */
1890 bond_mc_list_flush(bond_dev, slave_dev);
1893 netdev_set_master(slave_dev, NULL);
1895 /* close slave before restoring its mac address */
1896 dev_close(slave_dev);
1898 if (bond->do_set_mac_addr) {
1899 /* restore original ("permanent") mac address*/
1900 memcpy(addr.sa_data, slave->perm_hwaddr, ETH_ALEN);
1901 addr.sa_family = slave_dev->type;
1902 dev_set_mac_address(slave_dev, &addr);
1905 slave_dev->priv_flags &= ~(IFF_MASTER_8023AD | IFF_MASTER_ALB |
1906 IFF_SLAVE_INACTIVE);
1910 /* re-acquire the lock before getting the next slave */
1911 write_lock_bh(&bond->lock);
1914 /* zero the mac address of the master so it will be
1915 * set by the application to the mac address of the
1918 memset(bond_dev->dev_addr, 0, bond_dev->addr_len);
1920 if (list_empty(&bond->vlan_list)) {
1921 bond_dev->features |= NETIF_F_VLAN_CHALLENGED;
1923 printk(KERN_WARNING DRV_NAME
1924 ": %s: Warning: clearing HW address of %s while it "
1925 "still has VLANs.\n",
1926 bond_dev->name, bond_dev->name);
1927 printk(KERN_WARNING DRV_NAME
1928 ": %s: When re-adding slaves, make sure the bond's "
1929 "HW address matches its VLANs'.\n",
1933 printk(KERN_INFO DRV_NAME
1934 ": %s: released all slaves\n",
1938 write_unlock_bh(&bond->lock);
1944 * This function changes the active slave to slave <slave_dev>.
1945 * It returns -EINVAL in the following cases.
1946 * - <slave_dev> is not found in the list.
1947 * - There is not active slave now.
1948 * - <slave_dev> is already active.
1949 * - The link state of <slave_dev> is not BOND_LINK_UP.
1950 * - <slave_dev> is not running.
1951 * In these cases, this fuction does nothing.
1952 * In the other cases, currnt_slave pointer is changed and 0 is returned.
1954 static int bond_ioctl_change_active(struct net_device *bond_dev, struct net_device *slave_dev)
1956 struct bonding *bond = bond_dev->priv;
1957 struct slave *old_active = NULL;
1958 struct slave *new_active = NULL;
1961 if (!USES_PRIMARY(bond->params.mode)) {
1965 /* Verify that master_dev is indeed the master of slave_dev */
1966 if (!(slave_dev->flags & IFF_SLAVE) ||
1967 (slave_dev->master != bond_dev)) {
1971 write_lock_bh(&bond->lock);
1973 old_active = bond->curr_active_slave;
1974 new_active = bond_get_slave_by_dev(bond, slave_dev);
1977 * Changing to the current active: do nothing; return success.
1979 if (new_active && (new_active == old_active)) {
1980 write_unlock_bh(&bond->lock);
1986 (new_active->link == BOND_LINK_UP) &&
1987 IS_UP(new_active->dev)) {
1988 bond_change_active_slave(bond, new_active);
1993 write_unlock_bh(&bond->lock);
1998 static int bond_info_query(struct net_device *bond_dev, struct ifbond *info)
2000 struct bonding *bond = bond_dev->priv;
2002 info->bond_mode = bond->params.mode;
2003 info->miimon = bond->params.miimon;
2005 read_lock_bh(&bond->lock);
2006 info->num_slaves = bond->slave_cnt;
2007 read_unlock_bh(&bond->lock);
2012 static int bond_slave_info_query(struct net_device *bond_dev, struct ifslave *info)
2014 struct bonding *bond = bond_dev->priv;
2015 struct slave *slave;
2018 if (info->slave_id < 0) {
2022 read_lock_bh(&bond->lock);
2024 bond_for_each_slave(bond, slave, i) {
2025 if (i == (int)info->slave_id) {
2031 read_unlock_bh(&bond->lock);
2034 strcpy(info->slave_name, slave->dev->name);
2035 info->link = slave->link;
2036 info->state = slave->state;
2037 info->link_failure_count = slave->link_failure_count;
2045 /*-------------------------------- Monitoring -------------------------------*/
2047 /* this function is called regularly to monitor each slave's link. */
2048 void bond_mii_monitor(struct net_device *bond_dev)
2050 struct bonding *bond = bond_dev->priv;
2051 struct slave *slave, *oldcurrent;
2052 int do_failover = 0;
2056 read_lock(&bond->lock);
2058 delta_in_ticks = (bond->params.miimon * HZ) / 1000;
2060 if (bond->kill_timers) {
2064 if (bond->slave_cnt == 0) {
2068 /* we will try to read the link status of each of our slaves, and
2069 * set their IFF_RUNNING flag appropriately. For each slave not
2070 * supporting MII status, we won't do anything so that a user-space
2071 * program could monitor the link itself if needed.
2074 read_lock(&bond->curr_slave_lock);
2075 oldcurrent = bond->curr_active_slave;
2076 read_unlock(&bond->curr_slave_lock);
2078 bond_for_each_slave(bond, slave, i) {
2079 struct net_device *slave_dev = slave->dev;
2081 u16 old_speed = slave->speed;
2082 u8 old_duplex = slave->duplex;
2084 link_state = bond_check_dev_link(bond, slave_dev, 0);
2086 switch (slave->link) {
2087 case BOND_LINK_UP: /* the link was up */
2088 if (link_state == BMSR_LSTATUS) {
2089 /* link stays up, nothing more to do */
2091 } else { /* link going down */
2092 slave->link = BOND_LINK_FAIL;
2093 slave->delay = bond->params.downdelay;
2095 if (slave->link_failure_count < UINT_MAX) {
2096 slave->link_failure_count++;
2099 if (bond->params.downdelay) {
2100 printk(KERN_INFO DRV_NAME
2101 ": %s: link status down for %s "
2102 "interface %s, disabling it in "
2106 ? ((bond->params.mode == BOND_MODE_ACTIVEBACKUP)
2107 ? ((slave == oldcurrent)
2108 ? "active " : "backup ")
2112 bond->params.downdelay * bond->params.miimon);
2115 /* no break ! fall through the BOND_LINK_FAIL test to
2116 ensure proper action to be taken
2118 case BOND_LINK_FAIL: /* the link has just gone down */
2119 if (link_state != BMSR_LSTATUS) {
2120 /* link stays down */
2121 if (slave->delay <= 0) {
2122 /* link down for too long time */
2123 slave->link = BOND_LINK_DOWN;
2125 /* in active/backup mode, we must
2126 * completely disable this interface
2128 if ((bond->params.mode == BOND_MODE_ACTIVEBACKUP) ||
2129 (bond->params.mode == BOND_MODE_8023AD)) {
2130 bond_set_slave_inactive_flags(slave);
2133 printk(KERN_INFO DRV_NAME
2134 ": %s: link status definitely "
2135 "down for interface %s, "
2140 /* notify ad that the link status has changed */
2141 if (bond->params.mode == BOND_MODE_8023AD) {
2142 bond_3ad_handle_link_change(slave, BOND_LINK_DOWN);
2145 if ((bond->params.mode == BOND_MODE_TLB) ||
2146 (bond->params.mode == BOND_MODE_ALB)) {
2147 bond_alb_handle_link_change(bond, slave, BOND_LINK_DOWN);
2150 if (slave == oldcurrent) {
2158 slave->link = BOND_LINK_UP;
2159 slave->jiffies = jiffies;
2160 printk(KERN_INFO DRV_NAME
2161 ": %s: link status up again after %d "
2162 "ms for interface %s.\n",
2164 (bond->params.downdelay - slave->delay) * bond->params.miimon,
2168 case BOND_LINK_DOWN: /* the link was down */
2169 if (link_state != BMSR_LSTATUS) {
2170 /* the link stays down, nothing more to do */
2172 } else { /* link going up */
2173 slave->link = BOND_LINK_BACK;
2174 slave->delay = bond->params.updelay;
2176 if (bond->params.updelay) {
2177 /* if updelay == 0, no need to
2178 advertise about a 0 ms delay */
2179 printk(KERN_INFO DRV_NAME
2180 ": %s: link status up for "
2181 "interface %s, enabling it "
2185 bond->params.updelay * bond->params.miimon);
2188 /* no break ! fall through the BOND_LINK_BACK state in
2189 case there's something to do.
2191 case BOND_LINK_BACK: /* the link has just come back */
2192 if (link_state != BMSR_LSTATUS) {
2193 /* link down again */
2194 slave->link = BOND_LINK_DOWN;
2196 printk(KERN_INFO DRV_NAME
2197 ": %s: link status down again after %d "
2198 "ms for interface %s.\n",
2200 (bond->params.updelay - slave->delay) * bond->params.miimon,
2204 if (slave->delay == 0) {
2205 /* now the link has been up for long time enough */
2206 slave->link = BOND_LINK_UP;
2207 slave->jiffies = jiffies;
2209 if (bond->params.mode == BOND_MODE_8023AD) {
2210 /* prevent it from being the active one */
2211 slave->state = BOND_STATE_BACKUP;
2212 } else if (bond->params.mode != BOND_MODE_ACTIVEBACKUP) {
2213 /* make it immediately active */
2214 slave->state = BOND_STATE_ACTIVE;
2215 } else if (slave != bond->primary_slave) {
2216 /* prevent it from being the active one */
2217 slave->state = BOND_STATE_BACKUP;
2220 printk(KERN_INFO DRV_NAME
2221 ": %s: link status definitely "
2222 "up for interface %s.\n",
2226 /* notify ad that the link status has changed */
2227 if (bond->params.mode == BOND_MODE_8023AD) {
2228 bond_3ad_handle_link_change(slave, BOND_LINK_UP);
2231 if ((bond->params.mode == BOND_MODE_TLB) ||
2232 (bond->params.mode == BOND_MODE_ALB)) {
2233 bond_alb_handle_link_change(bond, slave, BOND_LINK_UP);
2236 if ((!oldcurrent) ||
2237 (slave == bond->primary_slave)) {
2246 /* Should not happen */
2247 printk(KERN_ERR DRV_NAME
2248 ": %s: Error: %s Illegal value (link=%d)\n",
2253 } /* end of switch (slave->link) */
2255 bond_update_speed_duplex(slave);
2257 if (bond->params.mode == BOND_MODE_8023AD) {
2258 if (old_speed != slave->speed) {
2259 bond_3ad_adapter_speed_changed(slave);
2262 if (old_duplex != slave->duplex) {
2263 bond_3ad_adapter_duplex_changed(slave);
2270 write_lock(&bond->curr_slave_lock);
2272 bond_select_active_slave(bond);
2274 write_unlock(&bond->curr_slave_lock);
2276 bond_set_carrier(bond);
2279 if (bond->params.miimon) {
2280 mod_timer(&bond->mii_timer, jiffies + delta_in_ticks);
2283 read_unlock(&bond->lock);
2287 static __be32 bond_glean_dev_ip(struct net_device *dev)
2289 struct in_device *idev;
2290 struct in_ifaddr *ifa;
2297 idev = __in_dev_get_rcu(dev);
2301 ifa = idev->ifa_list;
2305 addr = ifa->ifa_local;
2311 static int bond_has_ip(struct bonding *bond)
2313 struct vlan_entry *vlan, *vlan_next;
2315 if (bond->master_ip)
2318 if (list_empty(&bond->vlan_list))
2321 list_for_each_entry_safe(vlan, vlan_next, &bond->vlan_list,
2330 static int bond_has_this_ip(struct bonding *bond, __be32 ip)
2332 struct vlan_entry *vlan, *vlan_next;
2334 if (ip == bond->master_ip)
2337 if (list_empty(&bond->vlan_list))
2340 list_for_each_entry_safe(vlan, vlan_next, &bond->vlan_list,
2342 if (ip == vlan->vlan_ip)
2350 * We go to the (large) trouble of VLAN tagging ARP frames because
2351 * switches in VLAN mode (especially if ports are configured as
2352 * "native" to a VLAN) might not pass non-tagged frames.
2354 static void bond_arp_send(struct net_device *slave_dev, int arp_op, __be32 dest_ip, __be32 src_ip, unsigned short vlan_id)
2356 struct sk_buff *skb;
2358 dprintk("arp %d on slave %s: dst %x src %x vid %d\n", arp_op,
2359 slave_dev->name, dest_ip, src_ip, vlan_id);
2361 skb = arp_create(arp_op, ETH_P_ARP, dest_ip, slave_dev, src_ip,
2362 NULL, slave_dev->dev_addr, NULL);
2365 printk(KERN_ERR DRV_NAME ": ARP packet allocation failed\n");
2369 skb = vlan_put_tag(skb, vlan_id);
2371 printk(KERN_ERR DRV_NAME ": failed to insert VLAN tag\n");
2379 static void bond_arp_send_all(struct bonding *bond, struct slave *slave)
2382 __be32 *targets = bond->params.arp_targets;
2383 struct vlan_entry *vlan, *vlan_next;
2384 struct net_device *vlan_dev;
2388 for (i = 0; (i < BOND_MAX_ARP_TARGETS); i++) {
2391 dprintk("basa: target %x\n", targets[i]);
2392 if (list_empty(&bond->vlan_list)) {
2393 dprintk("basa: empty vlan: arp_send\n");
2394 bond_arp_send(slave->dev, ARPOP_REQUEST, targets[i],
2395 bond->master_ip, 0);
2400 * If VLANs are configured, we do a route lookup to
2401 * determine which VLAN interface would be used, so we
2402 * can tag the ARP with the proper VLAN tag.
2404 memset(&fl, 0, sizeof(fl));
2405 fl.fl4_dst = targets[i];
2406 fl.fl4_tos = RTO_ONLINK;
2408 rv = ip_route_output_key(&rt, &fl);
2410 if (net_ratelimit()) {
2411 printk(KERN_WARNING DRV_NAME
2412 ": %s: no route to arp_ip_target %u.%u.%u.%u\n",
2413 bond->dev->name, NIPQUAD(fl.fl4_dst));
2419 * This target is not on a VLAN
2421 if (rt->u.dst.dev == bond->dev) {
2423 dprintk("basa: rtdev == bond->dev: arp_send\n");
2424 bond_arp_send(slave->dev, ARPOP_REQUEST, targets[i],
2425 bond->master_ip, 0);
2430 list_for_each_entry_safe(vlan, vlan_next, &bond->vlan_list,
2432 vlan_dev = vlan_group_get_device(bond->vlgrp, vlan->vlan_id);
2433 if (vlan_dev == rt->u.dst.dev) {
2434 vlan_id = vlan->vlan_id;
2435 dprintk("basa: vlan match on %s %d\n",
2436 vlan_dev->name, vlan_id);
2443 bond_arp_send(slave->dev, ARPOP_REQUEST, targets[i],
2444 vlan->vlan_ip, vlan_id);
2448 if (net_ratelimit()) {
2449 printk(KERN_WARNING DRV_NAME
2450 ": %s: no path to arp_ip_target %u.%u.%u.%u via rt.dev %s\n",
2451 bond->dev->name, NIPQUAD(fl.fl4_dst),
2452 rt->u.dst.dev ? rt->u.dst.dev->name : "NULL");
2459 * Kick out a gratuitous ARP for an IP on the bonding master plus one
2460 * for each VLAN above us.
2462 static void bond_send_gratuitous_arp(struct bonding *bond)
2464 struct slave *slave = bond->curr_active_slave;
2465 struct vlan_entry *vlan;
2466 struct net_device *vlan_dev;
2468 dprintk("bond_send_grat_arp: bond %s slave %s\n", bond->dev->name,
2469 slave ? slave->dev->name : "NULL");
2473 if (bond->master_ip) {
2474 bond_arp_send(slave->dev, ARPOP_REPLY, bond->master_ip,
2475 bond->master_ip, 0);
2478 list_for_each_entry(vlan, &bond->vlan_list, vlan_list) {
2479 vlan_dev = vlan_group_get_device(bond->vlgrp, vlan->vlan_id);
2480 if (vlan->vlan_ip) {
2481 bond_arp_send(slave->dev, ARPOP_REPLY, vlan->vlan_ip,
2482 vlan->vlan_ip, vlan->vlan_id);
2487 static void bond_validate_arp(struct bonding *bond, struct slave *slave, __be32 sip, __be32 tip)
2490 __be32 *targets = bond->params.arp_targets;
2492 targets = bond->params.arp_targets;
2493 for (i = 0; (i < BOND_MAX_ARP_TARGETS) && targets[i]; i++) {
2494 dprintk("bva: sip %u.%u.%u.%u tip %u.%u.%u.%u t[%d] "
2495 "%u.%u.%u.%u bhti(tip) %d\n",
2496 NIPQUAD(sip), NIPQUAD(tip), i, NIPQUAD(targets[i]),
2497 bond_has_this_ip(bond, tip));
2498 if (sip == targets[i]) {
2499 if (bond_has_this_ip(bond, tip))
2500 slave->last_arp_rx = jiffies;
2506 static int bond_arp_rcv(struct sk_buff *skb, struct net_device *dev, struct packet_type *pt, struct net_device *orig_dev)
2509 struct slave *slave;
2510 struct bonding *bond;
2511 unsigned char *arp_ptr;
2514 if (dev->nd_net != &init_net)
2517 if (!(dev->priv_flags & IFF_BONDING) || !(dev->flags & IFF_MASTER))
2521 read_lock(&bond->lock);
2523 dprintk("bond_arp_rcv: bond %s skb->dev %s orig_dev %s\n",
2524 bond->dev->name, skb->dev ? skb->dev->name : "NULL",
2525 orig_dev ? orig_dev->name : "NULL");
2527 slave = bond_get_slave_by_dev(bond, orig_dev);
2528 if (!slave || !slave_do_arp_validate(bond, slave))
2531 /* ARP header, plus 2 device addresses, plus 2 IP addresses. */
2532 if (!pskb_may_pull(skb, (sizeof(struct arphdr) +
2533 (2 * dev->addr_len) +
2534 (2 * sizeof(u32)))))
2538 if (arp->ar_hln != dev->addr_len ||
2539 skb->pkt_type == PACKET_OTHERHOST ||
2540 skb->pkt_type == PACKET_LOOPBACK ||
2541 arp->ar_hrd != htons(ARPHRD_ETHER) ||
2542 arp->ar_pro != htons(ETH_P_IP) ||
2546 arp_ptr = (unsigned char *)(arp + 1);
2547 arp_ptr += dev->addr_len;
2548 memcpy(&sip, arp_ptr, 4);
2549 arp_ptr += 4 + dev->addr_len;
2550 memcpy(&tip, arp_ptr, 4);
2552 dprintk("bond_arp_rcv: %s %s/%d av %d sv %d sip %u.%u.%u.%u"
2553 " tip %u.%u.%u.%u\n", bond->dev->name, slave->dev->name,
2554 slave->state, bond->params.arp_validate,
2555 slave_do_arp_validate(bond, slave), NIPQUAD(sip), NIPQUAD(tip));
2558 * Backup slaves won't see the ARP reply, but do come through
2559 * here for each ARP probe (so we swap the sip/tip to validate
2560 * the probe). In a "redundant switch, common router" type of
2561 * configuration, the ARP probe will (hopefully) travel from
2562 * the active, through one switch, the router, then the other
2563 * switch before reaching the backup.
2565 if (slave->state == BOND_STATE_ACTIVE)
2566 bond_validate_arp(bond, slave, sip, tip);
2568 bond_validate_arp(bond, slave, tip, sip);
2571 read_unlock(&bond->lock);
2574 return NET_RX_SUCCESS;
2578 * this function is called regularly to monitor each slave's link
2579 * ensuring that traffic is being sent and received when arp monitoring
2580 * is used in load-balancing mode. if the adapter has been dormant, then an
2581 * arp is transmitted to generate traffic. see activebackup_arp_monitor for
2582 * arp monitoring in active backup mode.
2584 void bond_loadbalance_arp_mon(struct net_device *bond_dev)
2586 struct bonding *bond = bond_dev->priv;
2587 struct slave *slave, *oldcurrent;
2588 int do_failover = 0;
2592 read_lock(&bond->lock);
2594 delta_in_ticks = (bond->params.arp_interval * HZ) / 1000;
2596 if (bond->kill_timers) {
2600 if (bond->slave_cnt == 0) {
2604 read_lock(&bond->curr_slave_lock);
2605 oldcurrent = bond->curr_active_slave;
2606 read_unlock(&bond->curr_slave_lock);
2608 /* see if any of the previous devices are up now (i.e. they have
2609 * xmt and rcv traffic). the curr_active_slave does not come into
2610 * the picture unless it is null. also, slave->jiffies is not needed
2611 * here because we send an arp on each slave and give a slave as
2612 * long as it needs to get the tx/rx within the delta.
2613 * TODO: what about up/down delay in arp mode? it wasn't here before
2616 bond_for_each_slave(bond, slave, i) {
2617 if (slave->link != BOND_LINK_UP) {
2618 if (((jiffies - slave->dev->trans_start) <= delta_in_ticks) &&
2619 ((jiffies - slave->dev->last_rx) <= delta_in_ticks)) {
2621 slave->link = BOND_LINK_UP;
2622 slave->state = BOND_STATE_ACTIVE;
2624 /* primary_slave has no meaning in round-robin
2625 * mode. the window of a slave being up and
2626 * curr_active_slave being null after enslaving
2630 printk(KERN_INFO DRV_NAME
2631 ": %s: link status definitely "
2632 "up for interface %s, ",
2637 printk(KERN_INFO DRV_NAME
2638 ": %s: interface %s is now up\n",
2644 /* slave->link == BOND_LINK_UP */
2646 /* not all switches will respond to an arp request
2647 * when the source ip is 0, so don't take the link down
2648 * if we don't know our ip yet
2650 if (((jiffies - slave->dev->trans_start) >= (2*delta_in_ticks)) ||
2651 (((jiffies - slave->dev->last_rx) >= (2*delta_in_ticks)) &&
2652 bond_has_ip(bond))) {
2654 slave->link = BOND_LINK_DOWN;
2655 slave->state = BOND_STATE_BACKUP;
2657 if (slave->link_failure_count < UINT_MAX) {
2658 slave->link_failure_count++;
2661 printk(KERN_INFO DRV_NAME
2662 ": %s: interface %s is now down.\n",
2666 if (slave == oldcurrent) {
2672 /* note: if switch is in round-robin mode, all links
2673 * must tx arp to ensure all links rx an arp - otherwise
2674 * links may oscillate or not come up at all; if switch is
2675 * in something like xor mode, there is nothing we can
2676 * do - all replies will be rx'ed on same link causing slaves
2677 * to be unstable during low/no traffic periods
2679 if (IS_UP(slave->dev)) {
2680 bond_arp_send_all(bond, slave);
2685 write_lock(&bond->curr_slave_lock);
2687 bond_select_active_slave(bond);
2689 write_unlock(&bond->curr_slave_lock);
2693 if (bond->params.arp_interval) {
2694 mod_timer(&bond->arp_timer, jiffies + delta_in_ticks);
2697 read_unlock(&bond->lock);
2701 * When using arp monitoring in active-backup mode, this function is
2702 * called to determine if any backup slaves have went down or a new
2703 * current slave needs to be found.
2704 * The backup slaves never generate traffic, they are considered up by merely
2705 * receiving traffic. If the current slave goes down, each backup slave will
2706 * be given the opportunity to tx/rx an arp before being taken down - this
2707 * prevents all slaves from being taken down due to the current slave not
2708 * sending any traffic for the backups to receive. The arps are not necessarily
2709 * necessary, any tx and rx traffic will keep the current slave up. While any
2710 * rx traffic will keep the backup slaves up, the current slave is responsible
2711 * for generating traffic to keep them up regardless of any other traffic they
2712 * may have received.
2713 * see loadbalance_arp_monitor for arp monitoring in load balancing mode
2715 void bond_activebackup_arp_mon(struct net_device *bond_dev)
2717 struct bonding *bond = bond_dev->priv;
2718 struct slave *slave;
2722 read_lock(&bond->lock);
2724 delta_in_ticks = (bond->params.arp_interval * HZ) / 1000;
2726 if (bond->kill_timers) {
2730 if (bond->slave_cnt == 0) {
2734 /* determine if any slave has come up or any backup slave has
2736 * TODO: what about up/down delay in arp mode? it wasn't here before
2739 bond_for_each_slave(bond, slave, i) {
2740 if (slave->link != BOND_LINK_UP) {
2741 if ((jiffies - slave_last_rx(bond, slave)) <=
2744 slave->link = BOND_LINK_UP;
2746 write_lock(&bond->curr_slave_lock);
2748 if ((!bond->curr_active_slave) &&
2749 ((jiffies - slave->dev->trans_start) <= delta_in_ticks)) {
2750 bond_change_active_slave(bond, slave);
2751 bond->current_arp_slave = NULL;
2752 } else if (bond->curr_active_slave != slave) {
2753 /* this slave has just come up but we
2754 * already have a current slave; this
2755 * can also happen if bond_enslave adds
2756 * a new slave that is up while we are
2757 * searching for a new slave
2759 bond_set_slave_inactive_flags(slave);
2760 bond->current_arp_slave = NULL;
2763 bond_set_carrier(bond);
2765 if (slave == bond->curr_active_slave) {
2766 printk(KERN_INFO DRV_NAME
2767 ": %s: %s is up and now the "
2768 "active interface\n",
2771 netif_carrier_on(bond->dev);
2773 printk(KERN_INFO DRV_NAME
2774 ": %s: backup interface %s is "
2780 write_unlock(&bond->curr_slave_lock);
2783 read_lock(&bond->curr_slave_lock);
2785 if ((slave != bond->curr_active_slave) &&
2786 (!bond->current_arp_slave) &&
2787 (((jiffies - slave_last_rx(bond, slave)) >= 3*delta_in_ticks) &&
2788 bond_has_ip(bond))) {
2789 /* a backup slave has gone down; three times
2790 * the delta allows the current slave to be
2791 * taken out before the backup slave.
2792 * note: a non-null current_arp_slave indicates
2793 * the curr_active_slave went down and we are
2794 * searching for a new one; under this
2795 * condition we only take the curr_active_slave
2796 * down - this gives each slave a chance to
2797 * tx/rx traffic before being taken out
2800 read_unlock(&bond->curr_slave_lock);
2802 slave->link = BOND_LINK_DOWN;
2804 if (slave->link_failure_count < UINT_MAX) {
2805 slave->link_failure_count++;
2808 bond_set_slave_inactive_flags(slave);
2810 printk(KERN_INFO DRV_NAME
2811 ": %s: backup interface %s is now down\n",
2815 read_unlock(&bond->curr_slave_lock);
2820 read_lock(&bond->curr_slave_lock);
2821 slave = bond->curr_active_slave;
2822 read_unlock(&bond->curr_slave_lock);
2825 /* if we have sent traffic in the past 2*arp_intervals but
2826 * haven't xmit and rx traffic in that time interval, select
2827 * a different slave. slave->jiffies is only updated when
2828 * a slave first becomes the curr_active_slave - not necessarily
2829 * after every arp; this ensures the slave has a full 2*delta
2830 * before being taken out. if a primary is being used, check
2831 * if it is up and needs to take over as the curr_active_slave
2833 if ((((jiffies - slave->dev->trans_start) >= (2*delta_in_ticks)) ||
2834 (((jiffies - slave_last_rx(bond, slave)) >= (2*delta_in_ticks)) &&
2835 bond_has_ip(bond))) &&
2836 ((jiffies - slave->jiffies) >= 2*delta_in_ticks)) {
2838 slave->link = BOND_LINK_DOWN;
2840 if (slave->link_failure_count < UINT_MAX) {
2841 slave->link_failure_count++;
2844 printk(KERN_INFO DRV_NAME
2845 ": %s: link status down for active interface "
2846 "%s, disabling it\n",
2850 write_lock(&bond->curr_slave_lock);
2852 bond_select_active_slave(bond);
2853 slave = bond->curr_active_slave;
2855 write_unlock(&bond->curr_slave_lock);
2857 bond->current_arp_slave = slave;
2860 slave->jiffies = jiffies;
2862 } else if ((bond->primary_slave) &&
2863 (bond->primary_slave != slave) &&
2864 (bond->primary_slave->link == BOND_LINK_UP)) {
2865 /* at this point, slave is the curr_active_slave */
2866 printk(KERN_INFO DRV_NAME
2867 ": %s: changing from interface %s to primary "
2871 bond->primary_slave->dev->name);
2873 /* primary is up so switch to it */
2874 write_lock(&bond->curr_slave_lock);
2875 bond_change_active_slave(bond, bond->primary_slave);
2876 write_unlock(&bond->curr_slave_lock);
2878 slave = bond->primary_slave;
2879 slave->jiffies = jiffies;
2881 bond->current_arp_slave = NULL;
2884 /* the current slave must tx an arp to ensure backup slaves
2887 if (slave && bond_has_ip(bond)) {
2888 bond_arp_send_all(bond, slave);
2892 /* if we don't have a curr_active_slave, search for the next available
2893 * backup slave from the current_arp_slave and make it the candidate
2894 * for becoming the curr_active_slave
2897 if (!bond->current_arp_slave) {
2898 bond->current_arp_slave = bond->first_slave;
2901 if (bond->current_arp_slave) {
2902 bond_set_slave_inactive_flags(bond->current_arp_slave);
2904 /* search for next candidate */
2905 bond_for_each_slave_from(bond, slave, i, bond->current_arp_slave->next) {
2906 if (IS_UP(slave->dev)) {
2907 slave->link = BOND_LINK_BACK;
2908 bond_set_slave_active_flags(slave);
2909 bond_arp_send_all(bond, slave);
2910 slave->jiffies = jiffies;
2911 bond->current_arp_slave = slave;
2915 /* if the link state is up at this point, we
2916 * mark it down - this can happen if we have
2917 * simultaneous link failures and
2918 * reselect_active_interface doesn't make this
2919 * one the current slave so it is still marked
2920 * up when it is actually down
2922 if (slave->link == BOND_LINK_UP) {
2923 slave->link = BOND_LINK_DOWN;
2924 if (slave->link_failure_count < UINT_MAX) {
2925 slave->link_failure_count++;
2928 bond_set_slave_inactive_flags(slave);
2930 printk(KERN_INFO DRV_NAME
2931 ": %s: backup interface %s is "
2941 if (bond->params.arp_interval) {
2942 mod_timer(&bond->arp_timer, jiffies + delta_in_ticks);
2945 read_unlock(&bond->lock);
2948 /*------------------------------ proc/seq_file-------------------------------*/
2950 #ifdef CONFIG_PROC_FS
2952 #define SEQ_START_TOKEN ((void *)1)
2954 static void *bond_info_seq_start(struct seq_file *seq, loff_t *pos)
2956 struct bonding *bond = seq->private;
2958 struct slave *slave;
2961 /* make sure the bond won't be taken away */
2962 read_lock(&dev_base_lock);
2963 read_lock_bh(&bond->lock);
2966 return SEQ_START_TOKEN;
2969 bond_for_each_slave(bond, slave, i) {
2970 if (++off == *pos) {
2978 static void *bond_info_seq_next(struct seq_file *seq, void *v, loff_t *pos)
2980 struct bonding *bond = seq->private;
2981 struct slave *slave = v;
2984 if (v == SEQ_START_TOKEN) {
2985 return bond->first_slave;
2988 slave = slave->next;
2990 return (slave == bond->first_slave) ? NULL : slave;
2993 static void bond_info_seq_stop(struct seq_file *seq, void *v)
2995 struct bonding *bond = seq->private;
2997 read_unlock_bh(&bond->lock);
2998 read_unlock(&dev_base_lock);
3001 static void bond_info_show_master(struct seq_file *seq)
3003 struct bonding *bond = seq->private;
3008 read_lock(&bond->curr_slave_lock);
3009 curr = bond->curr_active_slave;
3010 read_unlock(&bond->curr_slave_lock);
3012 seq_printf(seq, "Bonding Mode: %s\n",
3013 bond_mode_name(bond->params.mode));
3015 if (bond->params.mode == BOND_MODE_XOR ||
3016 bond->params.mode == BOND_MODE_8023AD) {
3017 seq_printf(seq, "Transmit Hash Policy: %s (%d)\n",
3018 xmit_hashtype_tbl[bond->params.xmit_policy].modename,
3019 bond->params.xmit_policy);
3022 if (USES_PRIMARY(bond->params.mode)) {
3023 seq_printf(seq, "Primary Slave: %s\n",
3024 (bond->primary_slave) ?
3025 bond->primary_slave->dev->name : "None");
3027 seq_printf(seq, "Currently Active Slave: %s\n",
3028 (curr) ? curr->dev->name : "None");
3031 seq_printf(seq, "MII Status: %s\n", netif_carrier_ok(bond->dev) ?
3033 seq_printf(seq, "MII Polling Interval (ms): %d\n", bond->params.miimon);
3034 seq_printf(seq, "Up Delay (ms): %d\n",
3035 bond->params.updelay * bond->params.miimon);
3036 seq_printf(seq, "Down Delay (ms): %d\n",
3037 bond->params.downdelay * bond->params.miimon);
3040 /* ARP information */
3041 if(bond->params.arp_interval > 0) {
3043 seq_printf(seq, "ARP Polling Interval (ms): %d\n",
3044 bond->params.arp_interval);
3046 seq_printf(seq, "ARP IP target/s (n.n.n.n form):");
3048 for(i = 0; (i < BOND_MAX_ARP_TARGETS) ;i++) {
3049 if (!bond->params.arp_targets[i])
3052 seq_printf(seq, ",");
3053 target = ntohl(bond->params.arp_targets[i]);
3054 seq_printf(seq, " %d.%d.%d.%d", HIPQUAD(target));
3057 seq_printf(seq, "\n");
3060 if (bond->params.mode == BOND_MODE_8023AD) {
3061 struct ad_info ad_info;
3062 DECLARE_MAC_BUF(mac);
3064 seq_puts(seq, "\n802.3ad info\n");
3065 seq_printf(seq, "LACP rate: %s\n",
3066 (bond->params.lacp_fast) ? "fast" : "slow");
3068 if (bond_3ad_get_active_agg_info(bond, &ad_info)) {
3069 seq_printf(seq, "bond %s has no active aggregator\n",
3072 seq_printf(seq, "Active Aggregator Info:\n");
3074 seq_printf(seq, "\tAggregator ID: %d\n",
3075 ad_info.aggregator_id);
3076 seq_printf(seq, "\tNumber of ports: %d\n",
3078 seq_printf(seq, "\tActor Key: %d\n",
3080 seq_printf(seq, "\tPartner Key: %d\n",
3081 ad_info.partner_key);
3082 seq_printf(seq, "\tPartner Mac Address: %s\n",
3083 print_mac(mac, ad_info.partner_system));
3088 static void bond_info_show_slave(struct seq_file *seq, const struct slave *slave)
3090 struct bonding *bond = seq->private;
3091 DECLARE_MAC_BUF(mac);
3093 seq_printf(seq, "\nSlave Interface: %s\n", slave->dev->name);
3094 seq_printf(seq, "MII Status: %s\n",
3095 (slave->link == BOND_LINK_UP) ? "up" : "down");
3096 seq_printf(seq, "Link Failure Count: %u\n",
3097 slave->link_failure_count);
3100 "Permanent HW addr: %s\n",
3101 print_mac(mac, slave->perm_hwaddr));
3103 if (bond->params.mode == BOND_MODE_8023AD) {
3104 const struct aggregator *agg
3105 = SLAVE_AD_INFO(slave).port.aggregator;
3108 seq_printf(seq, "Aggregator ID: %d\n",
3109 agg->aggregator_identifier);
3111 seq_puts(seq, "Aggregator ID: N/A\n");
3116 static int bond_info_seq_show(struct seq_file *seq, void *v)
3118 if (v == SEQ_START_TOKEN) {
3119 seq_printf(seq, "%s\n", version);
3120 bond_info_show_master(seq);
3122 bond_info_show_slave(seq, v);
3128 static struct seq_operations bond_info_seq_ops = {
3129 .start = bond_info_seq_start,
3130 .next = bond_info_seq_next,
3131 .stop = bond_info_seq_stop,
3132 .show = bond_info_seq_show,
3135 static int bond_info_open(struct inode *inode, struct file *file)
3137 struct seq_file *seq;
3138 struct proc_dir_entry *proc;
3141 res = seq_open(file, &bond_info_seq_ops);
3143 /* recover the pointer buried in proc_dir_entry data */
3144 seq = file->private_data;
3146 seq->private = proc->data;
3152 static const struct file_operations bond_info_fops = {
3153 .owner = THIS_MODULE,
3154 .open = bond_info_open,
3156 .llseek = seq_lseek,
3157 .release = seq_release,
3160 static int bond_create_proc_entry(struct bonding *bond)
3162 struct net_device *bond_dev = bond->dev;
3164 if (bond_proc_dir) {
3165 bond->proc_entry = create_proc_entry(bond_dev->name,
3168 if (bond->proc_entry == NULL) {
3169 printk(KERN_WARNING DRV_NAME
3170 ": Warning: Cannot create /proc/net/%s/%s\n",
3171 DRV_NAME, bond_dev->name);
3173 bond->proc_entry->data = bond;
3174 bond->proc_entry->proc_fops = &bond_info_fops;
3175 bond->proc_entry->owner = THIS_MODULE;
3176 memcpy(bond->proc_file_name, bond_dev->name, IFNAMSIZ);
3183 static void bond_remove_proc_entry(struct bonding *bond)
3185 if (bond_proc_dir && bond->proc_entry) {
3186 remove_proc_entry(bond->proc_file_name, bond_proc_dir);
3187 memset(bond->proc_file_name, 0, IFNAMSIZ);
3188 bond->proc_entry = NULL;
3192 /* Create the bonding directory under /proc/net, if doesn't exist yet.
3193 * Caller must hold rtnl_lock.
3195 static void bond_create_proc_dir(void)
3197 int len = strlen(DRV_NAME);
3199 for (bond_proc_dir = init_net.proc_net->subdir; bond_proc_dir;
3200 bond_proc_dir = bond_proc_dir->next) {
3201 if ((bond_proc_dir->namelen == len) &&
3202 !memcmp(bond_proc_dir->name, DRV_NAME, len)) {
3207 if (!bond_proc_dir) {
3208 bond_proc_dir = proc_mkdir(DRV_NAME, init_net.proc_net);
3209 if (bond_proc_dir) {
3210 bond_proc_dir->owner = THIS_MODULE;
3212 printk(KERN_WARNING DRV_NAME
3213 ": Warning: cannot create /proc/net/%s\n",
3219 /* Destroy the bonding directory under /proc/net, if empty.
3220 * Caller must hold rtnl_lock.
3222 static void bond_destroy_proc_dir(void)
3224 struct proc_dir_entry *de;
3226 if (!bond_proc_dir) {
3230 /* verify that the /proc dir is empty */
3231 for (de = bond_proc_dir->subdir; de; de = de->next) {
3232 /* ignore . and .. */
3233 if (*(de->name) != '.') {
3239 if (bond_proc_dir->owner == THIS_MODULE) {
3240 bond_proc_dir->owner = NULL;
3243 remove_proc_entry(DRV_NAME, init_net.proc_net);
3244 bond_proc_dir = NULL;
3247 #endif /* CONFIG_PROC_FS */
3249 /*-------------------------- netdev event handling --------------------------*/
3252 * Change device name
3254 static int bond_event_changename(struct bonding *bond)
3256 #ifdef CONFIG_PROC_FS
3257 bond_remove_proc_entry(bond);
3258 bond_create_proc_entry(bond);
3260 down_write(&(bonding_rwsem));
3261 bond_destroy_sysfs_entry(bond);
3262 bond_create_sysfs_entry(bond);
3263 up_write(&(bonding_rwsem));
3267 static int bond_master_netdev_event(unsigned long event, struct net_device *bond_dev)
3269 struct bonding *event_bond = bond_dev->priv;
3272 case NETDEV_CHANGENAME:
3273 return bond_event_changename(event_bond);
3274 case NETDEV_UNREGISTER:
3276 * TODO: remove a bond from the list?
3286 static int bond_slave_netdev_event(unsigned long event, struct net_device *slave_dev)
3288 struct net_device *bond_dev = slave_dev->master;
3289 struct bonding *bond = bond_dev->priv;
3292 case NETDEV_UNREGISTER:
3294 bond_release(bond_dev, slave_dev);
3299 * TODO: is this what we get if somebody
3300 * sets up a hierarchical bond, then rmmod's
3301 * one of the slave bonding devices?
3306 * ... Or is it this?
3309 case NETDEV_CHANGEMTU:
3311 * TODO: Should slaves be allowed to
3312 * independently alter their MTU? For
3313 * an active-backup bond, slaves need
3314 * not be the same type of device, so
3315 * MTUs may vary. For other modes,
3316 * slaves arguably should have the
3317 * same MTUs. To do this, we'd need to
3318 * take over the slave's change_mtu
3319 * function for the duration of their
3323 case NETDEV_CHANGENAME:
3325 * TODO: handle changing the primary's name
3328 case NETDEV_FEAT_CHANGE:
3329 bond_compute_features(bond);
3339 * bond_netdev_event: handle netdev notifier chain events.
3341 * This function receives events for the netdev chain. The caller (an
3342 * ioctl handler calling blocking_notifier_call_chain) holds the necessary
3343 * locks for us to safely manipulate the slave devices (RTNL lock,
3346 static int bond_netdev_event(struct notifier_block *this, unsigned long event, void *ptr)
3348 struct net_device *event_dev = (struct net_device *)ptr;
3350 if (event_dev->nd_net != &init_net)
3353 dprintk("event_dev: %s, event: %lx\n",
3354 (event_dev ? event_dev->name : "None"),
3357 if (!(event_dev->priv_flags & IFF_BONDING))
3360 if (event_dev->flags & IFF_MASTER) {
3361 dprintk("IFF_MASTER\n");
3362 return bond_master_netdev_event(event, event_dev);
3365 if (event_dev->flags & IFF_SLAVE) {
3366 dprintk("IFF_SLAVE\n");
3367 return bond_slave_netdev_event(event, event_dev);
3374 * bond_inetaddr_event: handle inetaddr notifier chain events.
3376 * We keep track of device IPs primarily to use as source addresses in
3377 * ARP monitor probes (rather than spewing out broadcasts all the time).
3379 * We track one IP for the main device (if it has one), plus one per VLAN.
3381 static int bond_inetaddr_event(struct notifier_block *this, unsigned long event, void *ptr)
3383 struct in_ifaddr *ifa = ptr;
3384 struct net_device *vlan_dev, *event_dev = ifa->ifa_dev->dev;
3385 struct bonding *bond, *bond_next;
3386 struct vlan_entry *vlan, *vlan_next;
3388 list_for_each_entry_safe(bond, bond_next, &bond_dev_list, bond_list) {
3389 if (bond->dev == event_dev) {
3392 bond->master_ip = ifa->ifa_local;
3395 bond->master_ip = bond_glean_dev_ip(bond->dev);
3402 if (list_empty(&bond->vlan_list))
3405 list_for_each_entry_safe(vlan, vlan_next, &bond->vlan_list,
3407 vlan_dev = vlan_group_get_device(bond->vlgrp, vlan->vlan_id);
3408 if (vlan_dev == event_dev) {
3411 vlan->vlan_ip = ifa->ifa_local;
3415 bond_glean_dev_ip(vlan_dev);
3426 static struct notifier_block bond_netdev_notifier = {
3427 .notifier_call = bond_netdev_event,
3430 static struct notifier_block bond_inetaddr_notifier = {
3431 .notifier_call = bond_inetaddr_event,
3434 /*-------------------------- Packet type handling ---------------------------*/
3436 /* register to receive lacpdus on a bond */
3437 static void bond_register_lacpdu(struct bonding *bond)
3439 struct packet_type *pk_type = &(BOND_AD_INFO(bond).ad_pkt_type);
3441 /* initialize packet type */
3442 pk_type->type = PKT_TYPE_LACPDU;
3443 pk_type->dev = bond->dev;
3444 pk_type->func = bond_3ad_lacpdu_recv;
3446 dev_add_pack(pk_type);
3449 /* unregister to receive lacpdus on a bond */
3450 static void bond_unregister_lacpdu(struct bonding *bond)
3452 dev_remove_pack(&(BOND_AD_INFO(bond).ad_pkt_type));
3455 void bond_register_arp(struct bonding *bond)
3457 struct packet_type *pt = &bond->arp_mon_pt;
3462 pt->type = htons(ETH_P_ARP);
3463 pt->dev = bond->dev;
3464 pt->func = bond_arp_rcv;
3468 void bond_unregister_arp(struct bonding *bond)
3470 struct packet_type *pt = &bond->arp_mon_pt;
3472 dev_remove_pack(pt);
3476 /*---------------------------- Hashing Policies -----------------------------*/
3479 * Hash for the output device based upon layer 3 and layer 4 data. If
3480 * the packet is a frag or not TCP or UDP, just use layer 3 data. If it is
3481 * altogether not IP, mimic bond_xmit_hash_policy_l2()
3483 static int bond_xmit_hash_policy_l34(struct sk_buff *skb,
3484 struct net_device *bond_dev, int count)
3486 struct ethhdr *data = (struct ethhdr *)skb->data;
3487 struct iphdr *iph = ip_hdr(skb);
3488 __be16 *layer4hdr = (__be16 *)((u32 *)iph + iph->ihl);
3491 if (skb->protocol == __constant_htons(ETH_P_IP)) {
3492 if (!(iph->frag_off & __constant_htons(IP_MF|IP_OFFSET)) &&
3493 (iph->protocol == IPPROTO_TCP ||
3494 iph->protocol == IPPROTO_UDP)) {
3495 layer4_xor = ntohs((*layer4hdr ^ *(layer4hdr + 1)));
3497 return (layer4_xor ^
3498 ((ntohl(iph->saddr ^ iph->daddr)) & 0xffff)) % count;
3502 return (data->h_dest[5] ^ bond_dev->dev_addr[5]) % count;
3506 * Hash for the output device based upon layer 2 data
3508 static int bond_xmit_hash_policy_l2(struct sk_buff *skb,
3509 struct net_device *bond_dev, int count)
3511 struct ethhdr *data = (struct ethhdr *)skb->data;
3513 return (data->h_dest[5] ^ bond_dev->dev_addr[5]) % count;
3516 /*-------------------------- Device entry points ----------------------------*/
3518 static int bond_open(struct net_device *bond_dev)
3520 struct bonding *bond = bond_dev->priv;
3521 struct timer_list *mii_timer = &bond->mii_timer;
3522 struct timer_list *arp_timer = &bond->arp_timer;
3524 bond->kill_timers = 0;
3526 if ((bond->params.mode == BOND_MODE_TLB) ||
3527 (bond->params.mode == BOND_MODE_ALB)) {
3528 struct timer_list *alb_timer = &(BOND_ALB_INFO(bond).alb_timer);
3530 /* bond_alb_initialize must be called before the timer
3533 if (bond_alb_initialize(bond, (bond->params.mode == BOND_MODE_ALB))) {
3534 /* something went wrong - fail the open operation */
3538 init_timer(alb_timer);
3539 alb_timer->expires = jiffies + 1;
3540 alb_timer->data = (unsigned long)bond;
3541 alb_timer->function = (void *)&bond_alb_monitor;
3542 add_timer(alb_timer);
3545 if (bond->params.miimon) { /* link check interval, in milliseconds. */
3546 init_timer(mii_timer);
3547 mii_timer->expires = jiffies + 1;
3548 mii_timer->data = (unsigned long)bond_dev;
3549 mii_timer->function = (void *)&bond_mii_monitor;
3550 add_timer(mii_timer);
3553 if (bond->params.arp_interval) { /* arp interval, in milliseconds. */
3554 init_timer(arp_timer);
3555 arp_timer->expires = jiffies + 1;
3556 arp_timer->data = (unsigned long)bond_dev;
3557 if (bond->params.mode == BOND_MODE_ACTIVEBACKUP) {
3558 arp_timer->function = (void *)&bond_activebackup_arp_mon;
3560 arp_timer->function = (void *)&bond_loadbalance_arp_mon;
3562 if (bond->params.arp_validate)
3563 bond_register_arp(bond);
3565 add_timer(arp_timer);
3568 if (bond->params.mode == BOND_MODE_8023AD) {
3569 struct timer_list *ad_timer = &(BOND_AD_INFO(bond).ad_timer);
3570 init_timer(ad_timer);
3571 ad_timer->expires = jiffies + 1;
3572 ad_timer->data = (unsigned long)bond;
3573 ad_timer->function = (void *)&bond_3ad_state_machine_handler;
3574 add_timer(ad_timer);
3576 /* register to receive LACPDUs */
3577 bond_register_lacpdu(bond);
3583 static int bond_close(struct net_device *bond_dev)
3585 struct bonding *bond = bond_dev->priv;
3587 if (bond->params.mode == BOND_MODE_8023AD) {
3588 /* Unregister the receive of LACPDUs */
3589 bond_unregister_lacpdu(bond);
3592 if (bond->params.arp_validate)
3593 bond_unregister_arp(bond);
3595 write_lock_bh(&bond->lock);
3598 /* signal timers not to re-arm */
3599 bond->kill_timers = 1;
3601 write_unlock_bh(&bond->lock);
3603 /* del_timer_sync must run without holding the bond->lock
3604 * because a running timer might be trying to hold it too
3607 if (bond->params.miimon) { /* link check interval, in milliseconds. */
3608 del_timer_sync(&bond->mii_timer);
3611 if (bond->params.arp_interval) { /* arp interval, in milliseconds. */
3612 del_timer_sync(&bond->arp_timer);
3615 switch (bond->params.mode) {
3616 case BOND_MODE_8023AD:
3617 del_timer_sync(&(BOND_AD_INFO(bond).ad_timer));
3621 del_timer_sync(&(BOND_ALB_INFO(bond).alb_timer));
3628 if ((bond->params.mode == BOND_MODE_TLB) ||
3629 (bond->params.mode == BOND_MODE_ALB)) {
3630 /* Must be called only after all
3631 * slaves have been released
3633 bond_alb_deinitialize(bond);
3639 static struct net_device_stats *bond_get_stats(struct net_device *bond_dev)
3641 struct bonding *bond = bond_dev->priv;
3642 struct net_device_stats *stats = &(bond->stats), *sstats;
3643 struct slave *slave;
3646 memset(stats, 0, sizeof(struct net_device_stats));
3648 read_lock_bh(&bond->lock);
3650 bond_for_each_slave(bond, slave, i) {
3651 sstats = slave->dev->get_stats(slave->dev);
3652 stats->rx_packets += sstats->rx_packets;
3653 stats->rx_bytes += sstats->rx_bytes;
3654 stats->rx_errors += sstats->rx_errors;
3655 stats->rx_dropped += sstats->rx_dropped;
3657 stats->tx_packets += sstats->tx_packets;
3658 stats->tx_bytes += sstats->tx_bytes;
3659 stats->tx_errors += sstats->tx_errors;
3660 stats->tx_dropped += sstats->tx_dropped;
3662 stats->multicast += sstats->multicast;
3663 stats->collisions += sstats->collisions;
3665 stats->rx_length_errors += sstats->rx_length_errors;
3666 stats->rx_over_errors += sstats->rx_over_errors;
3667 stats->rx_crc_errors += sstats->rx_crc_errors;
3668 stats->rx_frame_errors += sstats->rx_frame_errors;
3669 stats->rx_fifo_errors += sstats->rx_fifo_errors;
3670 stats->rx_missed_errors += sstats->rx_missed_errors;
3672 stats->tx_aborted_errors += sstats->tx_aborted_errors;
3673 stats->tx_carrier_errors += sstats->tx_carrier_errors;
3674 stats->tx_fifo_errors += sstats->tx_fifo_errors;
3675 stats->tx_heartbeat_errors += sstats->tx_heartbeat_errors;
3676 stats->tx_window_errors += sstats->tx_window_errors;
3679 read_unlock_bh(&bond->lock);
3684 static int bond_do_ioctl(struct net_device *bond_dev, struct ifreq *ifr, int cmd)
3686 struct net_device *slave_dev = NULL;
3687 struct ifbond k_binfo;
3688 struct ifbond __user *u_binfo = NULL;
3689 struct ifslave k_sinfo;
3690 struct ifslave __user *u_sinfo = NULL;
3691 struct mii_ioctl_data *mii = NULL;
3694 dprintk("bond_ioctl: master=%s, cmd=%d\n",
3695 bond_dev->name, cmd);
3707 * We do this again just in case we were called by SIOCGMIIREG
3708 * instead of SIOCGMIIPHY.
3715 if (mii->reg_num == 1) {
3716 struct bonding *bond = bond_dev->priv;
3718 read_lock_bh(&bond->lock);
3719 read_lock(&bond->curr_slave_lock);
3720 if (netif_carrier_ok(bond->dev)) {
3721 mii->val_out = BMSR_LSTATUS;
3723 read_unlock(&bond->curr_slave_lock);
3724 read_unlock_bh(&bond->lock);
3728 case BOND_INFO_QUERY_OLD:
3729 case SIOCBONDINFOQUERY:
3730 u_binfo = (struct ifbond __user *)ifr->ifr_data;
3732 if (copy_from_user(&k_binfo, u_binfo, sizeof(ifbond))) {
3736 res = bond_info_query(bond_dev, &k_binfo);
3738 if (copy_to_user(u_binfo, &k_binfo, sizeof(ifbond))) {
3744 case BOND_SLAVE_INFO_QUERY_OLD:
3745 case SIOCBONDSLAVEINFOQUERY:
3746 u_sinfo = (struct ifslave __user *)ifr->ifr_data;
3748 if (copy_from_user(&k_sinfo, u_sinfo, sizeof(ifslave))) {
3752 res = bond_slave_info_query(bond_dev, &k_sinfo);
3754 if (copy_to_user(u_sinfo, &k_sinfo, sizeof(ifslave))) {
3765 if (!capable(CAP_NET_ADMIN)) {
3769 down_write(&(bonding_rwsem));
3770 slave_dev = dev_get_by_name(&init_net, ifr->ifr_slave);
3772 dprintk("slave_dev=%p: \n", slave_dev);
3777 dprintk("slave_dev->name=%s: \n", slave_dev->name);
3779 case BOND_ENSLAVE_OLD:
3780 case SIOCBONDENSLAVE:
3781 res = bond_enslave(bond_dev, slave_dev);
3783 case BOND_RELEASE_OLD:
3784 case SIOCBONDRELEASE:
3785 res = bond_release(bond_dev, slave_dev);
3787 case BOND_SETHWADDR_OLD:
3788 case SIOCBONDSETHWADDR:
3789 res = bond_sethwaddr(bond_dev, slave_dev);
3791 case BOND_CHANGE_ACTIVE_OLD:
3792 case SIOCBONDCHANGEACTIVE:
3793 res = bond_ioctl_change_active(bond_dev, slave_dev);
3802 up_write(&(bonding_rwsem));
3806 static void bond_set_multicast_list(struct net_device *bond_dev)
3808 struct bonding *bond = bond_dev->priv;
3809 struct dev_mc_list *dmi;
3811 write_lock_bh(&bond->lock);
3814 * Do promisc before checking multicast_mode
3816 if ((bond_dev->flags & IFF_PROMISC) && !(bond->flags & IFF_PROMISC)) {
3817 bond_set_promiscuity(bond, 1);
3820 if (!(bond_dev->flags & IFF_PROMISC) && (bond->flags & IFF_PROMISC)) {
3821 bond_set_promiscuity(bond, -1);
3824 /* set allmulti flag to slaves */
3825 if ((bond_dev->flags & IFF_ALLMULTI) && !(bond->flags & IFF_ALLMULTI)) {
3826 bond_set_allmulti(bond, 1);
3829 if (!(bond_dev->flags & IFF_ALLMULTI) && (bond->flags & IFF_ALLMULTI)) {
3830 bond_set_allmulti(bond, -1);
3833 bond->flags = bond_dev->flags;
3835 /* looking for addresses to add to slaves' mc list */
3836 for (dmi = bond_dev->mc_list; dmi; dmi = dmi->next) {
3837 if (!bond_mc_list_find_dmi(dmi, bond->mc_list)) {
3838 bond_mc_add(bond, dmi->dmi_addr, dmi->dmi_addrlen);
3842 /* looking for addresses to delete from slaves' list */
3843 for (dmi = bond->mc_list; dmi; dmi = dmi->next) {
3844 if (!bond_mc_list_find_dmi(dmi, bond_dev->mc_list)) {
3845 bond_mc_delete(bond, dmi->dmi_addr, dmi->dmi_addrlen);
3849 /* save master's multicast list */
3850 bond_mc_list_destroy(bond);
3851 bond_mc_list_copy(bond_dev->mc_list, bond, GFP_ATOMIC);
3853 write_unlock_bh(&bond->lock);
3857 * Change the MTU of all of a master's slaves to match the master
3859 static int bond_change_mtu(struct net_device *bond_dev, int new_mtu)
3861 struct bonding *bond = bond_dev->priv;
3862 struct slave *slave, *stop_at;
3866 dprintk("bond=%p, name=%s, new_mtu=%d\n", bond,
3867 (bond_dev ? bond_dev->name : "None"), new_mtu);
3869 /* Can't hold bond->lock with bh disabled here since
3870 * some base drivers panic. On the other hand we can't
3871 * hold bond->lock without bh disabled because we'll
3872 * deadlock. The only solution is to rely on the fact
3873 * that we're under rtnl_lock here, and the slaves
3874 * list won't change. This doesn't solve the problem
3875 * of setting the slave's MTU while it is
3876 * transmitting, but the assumption is that the base
3877 * driver can handle that.
3879 * TODO: figure out a way to safely iterate the slaves
3880 * list, but without holding a lock around the actual
3881 * call to the base driver.
3884 bond_for_each_slave(bond, slave, i) {
3885 dprintk("s %p s->p %p c_m %p\n", slave,
3886 slave->prev, slave->dev->change_mtu);
3888 res = dev_set_mtu(slave->dev, new_mtu);
3891 /* If we failed to set the slave's mtu to the new value
3892 * we must abort the operation even in ACTIVE_BACKUP
3893 * mode, because if we allow the backup slaves to have
3894 * different mtu values than the active slave we'll
3895 * need to change their mtu when doing a failover. That
3896 * means changing their mtu from timer context, which
3897 * is probably not a good idea.
3899 dprintk("err %d %s\n", res, slave->dev->name);
3904 bond_dev->mtu = new_mtu;
3909 /* unwind from head to the slave that failed */
3911 bond_for_each_slave_from_to(bond, slave, i, bond->first_slave, stop_at) {
3914 tmp_res = dev_set_mtu(slave->dev, bond_dev->mtu);
3916 dprintk("unwind err %d dev %s\n", tmp_res,
3927 * Note that many devices must be down to change the HW address, and
3928 * downing the master releases all slaves. We can make bonds full of
3929 * bonding devices to test this, however.
3931 static int bond_set_mac_address(struct net_device *bond_dev, void *addr)
3933 struct bonding *bond = bond_dev->priv;
3934 struct sockaddr *sa = addr, tmp_sa;
3935 struct slave *slave, *stop_at;
3939 dprintk("bond=%p, name=%s\n", bond, (bond_dev ? bond_dev->name : "None"));
3941 if (!bond->do_set_mac_addr)
3944 if (!is_valid_ether_addr(sa->sa_data)) {
3945 return -EADDRNOTAVAIL;
3948 /* Can't hold bond->lock with bh disabled here since
3949 * some base drivers panic. On the other hand we can't
3950 * hold bond->lock without bh disabled because we'll
3951 * deadlock. The only solution is to rely on the fact
3952 * that we're under rtnl_lock here, and the slaves
3953 * list won't change. This doesn't solve the problem
3954 * of setting the slave's hw address while it is
3955 * transmitting, but the assumption is that the base
3956 * driver can handle that.
3958 * TODO: figure out a way to safely iterate the slaves
3959 * list, but without holding a lock around the actual
3960 * call to the base driver.
3963 bond_for_each_slave(bond, slave, i) {
3964 dprintk("slave %p %s\n", slave, slave->dev->name);
3966 if (slave->dev->set_mac_address == NULL) {
3968 dprintk("EOPNOTSUPP %s\n", slave->dev->name);
3972 res = dev_set_mac_address(slave->dev, addr);
3974 /* TODO: consider downing the slave
3976 * User should expect communications
3977 * breakage anyway until ARP finish
3980 dprintk("err %d %s\n", res, slave->dev->name);
3986 memcpy(bond_dev->dev_addr, sa->sa_data, bond_dev->addr_len);
3990 memcpy(tmp_sa.sa_data, bond_dev->dev_addr, bond_dev->addr_len);
3991 tmp_sa.sa_family = bond_dev->type;
3993 /* unwind from head to the slave that failed */
3995 bond_for_each_slave_from_to(bond, slave, i, bond->first_slave, stop_at) {
3998 tmp_res = dev_set_mac_address(slave->dev, &tmp_sa);
4000 dprintk("unwind err %d dev %s\n", tmp_res,
4008 static int bond_xmit_roundrobin(struct sk_buff *skb, struct net_device *bond_dev)
4010 struct bonding *bond = bond_dev->priv;
4011 struct slave *slave, *start_at;
4015 read_lock(&bond->lock);
4017 if (!BOND_IS_OK(bond)) {
4021 read_lock(&bond->curr_slave_lock);
4022 slave = start_at = bond->curr_active_slave;
4023 read_unlock(&bond->curr_slave_lock);
4029 bond_for_each_slave_from(bond, slave, i, start_at) {
4030 if (IS_UP(slave->dev) &&
4031 (slave->link == BOND_LINK_UP) &&
4032 (slave->state == BOND_STATE_ACTIVE)) {
4033 res = bond_dev_queue_xmit(bond, skb, slave->dev);
4035 write_lock(&bond->curr_slave_lock);
4036 bond->curr_active_slave = slave->next;
4037 write_unlock(&bond->curr_slave_lock);
4046 /* no suitable interface, frame not sent */
4049 read_unlock(&bond->lock);
4055 * in active-backup mode, we know that bond->curr_active_slave is always valid if
4056 * the bond has a usable interface.
4058 static int bond_xmit_activebackup(struct sk_buff *skb, struct net_device *bond_dev)
4060 struct bonding *bond = bond_dev->priv;
4063 read_lock(&bond->lock);
4064 read_lock(&bond->curr_slave_lock);
4066 if (!BOND_IS_OK(bond)) {
4070 if (!bond->curr_active_slave)
4073 res = bond_dev_queue_xmit(bond, skb, bond->curr_active_slave->dev);
4077 /* no suitable interface, frame not sent */
4080 read_unlock(&bond->curr_slave_lock);
4081 read_unlock(&bond->lock);
4086 * In bond_xmit_xor() , we determine the output device by using a pre-
4087 * determined xmit_hash_policy(), If the selected device is not enabled,
4088 * find the next active slave.
4090 static int bond_xmit_xor(struct sk_buff *skb, struct net_device *bond_dev)
4092 struct bonding *bond = bond_dev->priv;
4093 struct slave *slave, *start_at;
4098 read_lock(&bond->lock);
4100 if (!BOND_IS_OK(bond)) {
4104 slave_no = bond->xmit_hash_policy(skb, bond_dev, bond->slave_cnt);
4106 bond_for_each_slave(bond, slave, i) {
4115 bond_for_each_slave_from(bond, slave, i, start_at) {
4116 if (IS_UP(slave->dev) &&
4117 (slave->link == BOND_LINK_UP) &&
4118 (slave->state == BOND_STATE_ACTIVE)) {
4119 res = bond_dev_queue_xmit(bond, skb, slave->dev);
4126 /* no suitable interface, frame not sent */
4129 read_unlock(&bond->lock);
4134 * in broadcast mode, we send everything to all usable interfaces.
4136 static int bond_xmit_broadcast(struct sk_buff *skb, struct net_device *bond_dev)
4138 struct bonding *bond = bond_dev->priv;
4139 struct slave *slave, *start_at;
4140 struct net_device *tx_dev = NULL;
4144 read_lock(&bond->lock);
4146 if (!BOND_IS_OK(bond)) {
4150 read_lock(&bond->curr_slave_lock);
4151 start_at = bond->curr_active_slave;
4152 read_unlock(&bond->curr_slave_lock);
4158 bond_for_each_slave_from(bond, slave, i, start_at) {
4159 if (IS_UP(slave->dev) &&
4160 (slave->link == BOND_LINK_UP) &&
4161 (slave->state == BOND_STATE_ACTIVE)) {
4163 struct sk_buff *skb2 = skb_clone(skb, GFP_ATOMIC);
4165 printk(KERN_ERR DRV_NAME
4166 ": %s: Error: bond_xmit_broadcast(): "
4167 "skb_clone() failed\n",
4172 res = bond_dev_queue_xmit(bond, skb2, tx_dev);
4174 dev_kfree_skb(skb2);
4178 tx_dev = slave->dev;
4183 res = bond_dev_queue_xmit(bond, skb, tx_dev);
4188 /* no suitable interface, frame not sent */
4191 /* frame sent to all suitable interfaces */
4192 read_unlock(&bond->lock);
4196 /*------------------------- Device initialization ---------------------------*/
4199 * set bond mode specific net device operations
4201 void bond_set_mode_ops(struct bonding *bond, int mode)
4203 struct net_device *bond_dev = bond->dev;
4206 case BOND_MODE_ROUNDROBIN:
4207 bond_dev->hard_start_xmit = bond_xmit_roundrobin;
4209 case BOND_MODE_ACTIVEBACKUP:
4210 bond_dev->hard_start_xmit = bond_xmit_activebackup;
4213 bond_dev->hard_start_xmit = bond_xmit_xor;
4214 if (bond->params.xmit_policy == BOND_XMIT_POLICY_LAYER34)
4215 bond->xmit_hash_policy = bond_xmit_hash_policy_l34;
4217 bond->xmit_hash_policy = bond_xmit_hash_policy_l2;
4219 case BOND_MODE_BROADCAST:
4220 bond_dev->hard_start_xmit = bond_xmit_broadcast;
4222 case BOND_MODE_8023AD:
4223 bond_set_master_3ad_flags(bond);
4224 bond_dev->hard_start_xmit = bond_3ad_xmit_xor;
4225 if (bond->params.xmit_policy == BOND_XMIT_POLICY_LAYER34)
4226 bond->xmit_hash_policy = bond_xmit_hash_policy_l34;
4228 bond->xmit_hash_policy = bond_xmit_hash_policy_l2;
4231 bond_set_master_alb_flags(bond);
4234 bond_dev->hard_start_xmit = bond_alb_xmit;
4235 bond_dev->set_mac_address = bond_alb_set_mac_address;
4238 /* Should never happen, mode already checked */
4239 printk(KERN_ERR DRV_NAME
4240 ": %s: Error: Unknown bonding mode %d\n",
4247 static void bond_ethtool_get_drvinfo(struct net_device *bond_dev,
4248 struct ethtool_drvinfo *drvinfo)
4250 strncpy(drvinfo->driver, DRV_NAME, 32);
4251 strncpy(drvinfo->version, DRV_VERSION, 32);
4252 snprintf(drvinfo->fw_version, 32, "%d", BOND_ABI_VERSION);
4255 static const struct ethtool_ops bond_ethtool_ops = {
4256 .get_drvinfo = bond_ethtool_get_drvinfo,
4260 * Does not allocate but creates a /proc entry.
4263 static int bond_init(struct net_device *bond_dev, struct bond_params *params)
4265 struct bonding *bond = bond_dev->priv;
4267 dprintk("Begin bond_init for %s\n", bond_dev->name);
4269 /* initialize rwlocks */
4270 rwlock_init(&bond->lock);
4271 rwlock_init(&bond->curr_slave_lock);
4273 bond->params = *params; /* copy params struct */
4275 /* Initialize pointers */
4276 bond->first_slave = NULL;
4277 bond->curr_active_slave = NULL;
4278 bond->current_arp_slave = NULL;
4279 bond->primary_slave = NULL;
4280 bond->dev = bond_dev;
4281 INIT_LIST_HEAD(&bond->vlan_list);
4283 /* Initialize the device entry points */
4284 bond_dev->open = bond_open;
4285 bond_dev->stop = bond_close;
4286 bond_dev->get_stats = bond_get_stats;
4287 bond_dev->do_ioctl = bond_do_ioctl;
4288 bond_dev->ethtool_ops = &bond_ethtool_ops;
4289 bond_dev->set_multicast_list = bond_set_multicast_list;
4290 bond_dev->change_mtu = bond_change_mtu;
4291 bond_dev->set_mac_address = bond_set_mac_address;
4293 bond_set_mode_ops(bond, bond->params.mode);
4295 bond_dev->destructor = free_netdev;
4297 /* Initialize the device options */
4298 bond_dev->tx_queue_len = 0;
4299 bond_dev->flags |= IFF_MASTER|IFF_MULTICAST;
4300 bond_dev->priv_flags |= IFF_BONDING;
4302 /* At first, we block adding VLANs. That's the only way to
4303 * prevent problems that occur when adding VLANs over an
4304 * empty bond. The block will be removed once non-challenged
4305 * slaves are enslaved.
4307 bond_dev->features |= NETIF_F_VLAN_CHALLENGED;
4309 /* don't acquire bond device's netif_tx_lock when
4311 bond_dev->features |= NETIF_F_LLTX;
4313 /* By default, we declare the bond to be fully
4314 * VLAN hardware accelerated capable. Special
4315 * care is taken in the various xmit functions
4316 * when there are slaves that are not hw accel
4319 bond_dev->vlan_rx_register = bond_vlan_rx_register;
4320 bond_dev->vlan_rx_add_vid = bond_vlan_rx_add_vid;
4321 bond_dev->vlan_rx_kill_vid = bond_vlan_rx_kill_vid;
4322 bond_dev->features |= (NETIF_F_HW_VLAN_TX |
4323 NETIF_F_HW_VLAN_RX |
4324 NETIF_F_HW_VLAN_FILTER);
4326 #ifdef CONFIG_PROC_FS
4327 bond_create_proc_entry(bond);
4330 /* set do_set_mac_addr to true on startup */
4331 bond->do_set_mac_addr = 1;
4333 list_add_tail(&bond->bond_list, &bond_dev_list);
4338 /* De-initialize device specific data.
4339 * Caller must hold rtnl_lock.
4341 void bond_deinit(struct net_device *bond_dev)
4343 struct bonding *bond = bond_dev->priv;
4345 list_del(&bond->bond_list);
4347 #ifdef CONFIG_PROC_FS
4348 bond_remove_proc_entry(bond);
4352 /* Unregister and free all bond devices.
4353 * Caller must hold rtnl_lock.
4355 static void bond_free_all(void)
4357 struct bonding *bond, *nxt;
4359 list_for_each_entry_safe(bond, nxt, &bond_dev_list, bond_list) {
4360 struct net_device *bond_dev = bond->dev;
4362 bond_mc_list_destroy(bond);
4363 /* Release the bonded slaves */
4364 bond_release_all(bond_dev);
4365 bond_deinit(bond_dev);
4366 unregister_netdevice(bond_dev);
4369 #ifdef CONFIG_PROC_FS
4370 bond_destroy_proc_dir();
4374 /*------------------------- Module initialization ---------------------------*/
4377 * Convert string input module parms. Accept either the
4378 * number of the mode or its string name.
4380 int bond_parse_parm(char *mode_arg, struct bond_parm_tbl *tbl)
4384 for (i = 0; tbl[i].modename; i++) {
4385 if ((isdigit(*mode_arg) &&
4386 tbl[i].mode == simple_strtol(mode_arg, NULL, 0)) ||
4387 (strncmp(mode_arg, tbl[i].modename,
4388 strlen(tbl[i].modename)) == 0)) {
4396 static int bond_check_params(struct bond_params *params)
4398 int arp_validate_value;
4401 * Convert string parameters.
4404 bond_mode = bond_parse_parm(mode, bond_mode_tbl);
4405 if (bond_mode == -1) {
4406 printk(KERN_ERR DRV_NAME
4407 ": Error: Invalid bonding mode \"%s\"\n",
4408 mode == NULL ? "NULL" : mode);
4413 if (xmit_hash_policy) {
4414 if ((bond_mode != BOND_MODE_XOR) &&
4415 (bond_mode != BOND_MODE_8023AD)) {
4416 printk(KERN_INFO DRV_NAME
4417 ": xor_mode param is irrelevant in mode %s\n",
4418 bond_mode_name(bond_mode));
4420 xmit_hashtype = bond_parse_parm(xmit_hash_policy,
4422 if (xmit_hashtype == -1) {
4423 printk(KERN_ERR DRV_NAME
4424 ": Error: Invalid xmit_hash_policy \"%s\"\n",
4425 xmit_hash_policy == NULL ? "NULL" :
4433 if (bond_mode != BOND_MODE_8023AD) {
4434 printk(KERN_INFO DRV_NAME
4435 ": lacp_rate param is irrelevant in mode %s\n",
4436 bond_mode_name(bond_mode));
4438 lacp_fast = bond_parse_parm(lacp_rate, bond_lacp_tbl);
4439 if (lacp_fast == -1) {
4440 printk(KERN_ERR DRV_NAME
4441 ": Error: Invalid lacp rate \"%s\"\n",
4442 lacp_rate == NULL ? "NULL" : lacp_rate);
4448 if (max_bonds < 1 || max_bonds > INT_MAX) {
4449 printk(KERN_WARNING DRV_NAME
4450 ": Warning: max_bonds (%d) not in range %d-%d, so it "
4451 "was reset to BOND_DEFAULT_MAX_BONDS (%d)\n",
4452 max_bonds, 1, INT_MAX, BOND_DEFAULT_MAX_BONDS);
4453 max_bonds = BOND_DEFAULT_MAX_BONDS;
4457 printk(KERN_WARNING DRV_NAME
4458 ": Warning: miimon module parameter (%d), "
4459 "not in range 0-%d, so it was reset to %d\n",
4460 miimon, INT_MAX, BOND_LINK_MON_INTERV);
4461 miimon = BOND_LINK_MON_INTERV;
4465 printk(KERN_WARNING DRV_NAME
4466 ": Warning: updelay module parameter (%d), "
4467 "not in range 0-%d, so it was reset to 0\n",
4472 if (downdelay < 0) {
4473 printk(KERN_WARNING DRV_NAME
4474 ": Warning: downdelay module parameter (%d), "
4475 "not in range 0-%d, so it was reset to 0\n",
4476 downdelay, INT_MAX);
4480 if ((use_carrier != 0) && (use_carrier != 1)) {
4481 printk(KERN_WARNING DRV_NAME
4482 ": Warning: use_carrier module parameter (%d), "
4483 "not of valid value (0/1), so it was set to 1\n",
4488 /* reset values for 802.3ad */
4489 if (bond_mode == BOND_MODE_8023AD) {
4491 printk(KERN_WARNING DRV_NAME
4492 ": Warning: miimon must be specified, "
4493 "otherwise bonding will not detect link "
4494 "failure, speed and duplex which are "
4495 "essential for 802.3ad operation\n");
4496 printk(KERN_WARNING "Forcing miimon to 100msec\n");
4501 /* reset values for TLB/ALB */
4502 if ((bond_mode == BOND_MODE_TLB) ||
4503 (bond_mode == BOND_MODE_ALB)) {
4505 printk(KERN_WARNING DRV_NAME
4506 ": Warning: miimon must be specified, "
4507 "otherwise bonding will not detect link "
4508 "failure and link speed which are essential "
4509 "for TLB/ALB load balancing\n");
4510 printk(KERN_WARNING "Forcing miimon to 100msec\n");
4515 if (bond_mode == BOND_MODE_ALB) {
4516 printk(KERN_NOTICE DRV_NAME
4517 ": In ALB mode you might experience client "
4518 "disconnections upon reconnection of a link if the "
4519 "bonding module updelay parameter (%d msec) is "
4520 "incompatible with the forwarding delay time of the "
4526 if (updelay || downdelay) {
4527 /* just warn the user the up/down delay will have
4528 * no effect since miimon is zero...
4530 printk(KERN_WARNING DRV_NAME
4531 ": Warning: miimon module parameter not set "
4532 "and updelay (%d) or downdelay (%d) module "
4533 "parameter is set; updelay and downdelay have "
4534 "no effect unless miimon is set\n",
4535 updelay, downdelay);
4538 /* don't allow arp monitoring */
4540 printk(KERN_WARNING DRV_NAME
4541 ": Warning: miimon (%d) and arp_interval (%d) "
4542 "can't be used simultaneously, disabling ARP "
4544 miimon, arp_interval);
4548 if ((updelay % miimon) != 0) {
4549 printk(KERN_WARNING DRV_NAME
4550 ": Warning: updelay (%d) is not a multiple "
4551 "of miimon (%d), updelay rounded to %d ms\n",
4552 updelay, miimon, (updelay / miimon) * miimon);
4557 if ((downdelay % miimon) != 0) {
4558 printk(KERN_WARNING DRV_NAME
4559 ": Warning: downdelay (%d) is not a multiple "
4560 "of miimon (%d), downdelay rounded to %d ms\n",
4562 (downdelay / miimon) * miimon);
4565 downdelay /= miimon;
4568 if (arp_interval < 0) {
4569 printk(KERN_WARNING DRV_NAME
4570 ": Warning: arp_interval module parameter (%d) "
4571 ", not in range 0-%d, so it was reset to %d\n",
4572 arp_interval, INT_MAX, BOND_LINK_ARP_INTERV);
4573 arp_interval = BOND_LINK_ARP_INTERV;
4576 for (arp_ip_count = 0;
4577 (arp_ip_count < BOND_MAX_ARP_TARGETS) && arp_ip_target[arp_ip_count];
4579 /* not complete check, but should be good enough to
4581 if (!isdigit(arp_ip_target[arp_ip_count][0])) {
4582 printk(KERN_WARNING DRV_NAME
4583 ": Warning: bad arp_ip_target module parameter "
4584 "(%s), ARP monitoring will not be performed\n",
4585 arp_ip_target[arp_ip_count]);
4588 __be32 ip = in_aton(arp_ip_target[arp_ip_count]);
4589 arp_target[arp_ip_count] = ip;
4593 if (arp_interval && !arp_ip_count) {
4594 /* don't allow arping if no arp_ip_target given... */
4595 printk(KERN_WARNING DRV_NAME
4596 ": Warning: arp_interval module parameter (%d) "
4597 "specified without providing an arp_ip_target "
4598 "parameter, arp_interval was reset to 0\n",
4604 if (bond_mode != BOND_MODE_ACTIVEBACKUP) {
4605 printk(KERN_ERR DRV_NAME
4606 ": arp_validate only supported in active-backup mode\n");
4609 if (!arp_interval) {
4610 printk(KERN_ERR DRV_NAME
4611 ": arp_validate requires arp_interval\n");
4615 arp_validate_value = bond_parse_parm(arp_validate,
4617 if (arp_validate_value == -1) {
4618 printk(KERN_ERR DRV_NAME
4619 ": Error: invalid arp_validate \"%s\"\n",
4620 arp_validate == NULL ? "NULL" : arp_validate);
4624 arp_validate_value = 0;
4627 printk(KERN_INFO DRV_NAME
4628 ": MII link monitoring set to %d ms\n",
4630 } else if (arp_interval) {
4633 printk(KERN_INFO DRV_NAME
4634 ": ARP monitoring set to %d ms, validate %s, with %d target(s):",
4636 arp_validate_tbl[arp_validate_value].modename,
4639 for (i = 0; i < arp_ip_count; i++)
4640 printk (" %s", arp_ip_target[i]);
4645 /* miimon and arp_interval not set, we need one so things
4646 * work as expected, see bonding.txt for details
4648 printk(KERN_WARNING DRV_NAME
4649 ": Warning: either miimon or arp_interval and "
4650 "arp_ip_target module parameters must be specified, "
4651 "otherwise bonding will not detect link failures! see "
4652 "bonding.txt for details.\n");
4655 if (primary && !USES_PRIMARY(bond_mode)) {
4656 /* currently, using a primary only makes sense
4657 * in active backup, TLB or ALB modes
4659 printk(KERN_WARNING DRV_NAME
4660 ": Warning: %s primary device specified but has no "
4661 "effect in %s mode\n",
4662 primary, bond_mode_name(bond_mode));
4666 /* fill params struct with the proper values */
4667 params->mode = bond_mode;
4668 params->xmit_policy = xmit_hashtype;
4669 params->miimon = miimon;
4670 params->arp_interval = arp_interval;
4671 params->arp_validate = arp_validate_value;
4672 params->updelay = updelay;
4673 params->downdelay = downdelay;
4674 params->use_carrier = use_carrier;
4675 params->lacp_fast = lacp_fast;
4676 params->primary[0] = 0;
4679 strncpy(params->primary, primary, IFNAMSIZ);
4680 params->primary[IFNAMSIZ - 1] = 0;
4683 memcpy(params->arp_targets, arp_target, sizeof(arp_target));
4688 static struct lock_class_key bonding_netdev_xmit_lock_key;
4690 /* Create a new bond based on the specified name and bonding parameters.
4691 * If name is NULL, obtain a suitable "bond%d" name for us.
4692 * Caller must NOT hold rtnl_lock; we need to release it here before we
4693 * set up our sysfs entries.
4695 int bond_create(char *name, struct bond_params *params, struct bonding **newbond)
4697 struct net_device *bond_dev;
4701 bond_dev = alloc_netdev(sizeof(struct bonding), name ? name : "",
4704 printk(KERN_ERR DRV_NAME
4705 ": %s: eek! can't alloc netdev!\n",
4712 res = dev_alloc_name(bond_dev, "bond%d");
4717 /* bond_init() must be called after dev_alloc_name() (for the
4718 * /proc files), but before register_netdevice(), because we
4719 * need to set function pointers.
4722 res = bond_init(bond_dev, params);
4727 res = register_netdevice(bond_dev);
4732 lockdep_set_class(&bond_dev->_xmit_lock, &bonding_netdev_xmit_lock_key);
4735 *newbond = bond_dev->priv;
4737 netif_carrier_off(bond_dev);
4739 rtnl_unlock(); /* allows sysfs registration of net device */
4740 res = bond_create_sysfs_entry(bond_dev->priv);
4749 bond_deinit(bond_dev);
4751 free_netdev(bond_dev);
4757 static int __init bonding_init(void)
4762 printk(KERN_INFO "%s", version);
4764 res = bond_check_params(&bonding_defaults);
4769 #ifdef CONFIG_PROC_FS
4770 bond_create_proc_dir();
4772 for (i = 0; i < max_bonds; i++) {
4773 res = bond_create(NULL, &bonding_defaults, NULL);
4778 res = bond_create_sysfs();
4782 register_netdevice_notifier(&bond_netdev_notifier);
4783 register_inetaddr_notifier(&bond_inetaddr_notifier);
4789 bond_destroy_sysfs();
4796 static void __exit bonding_exit(void)
4798 unregister_netdevice_notifier(&bond_netdev_notifier);
4799 unregister_inetaddr_notifier(&bond_inetaddr_notifier);
4803 bond_destroy_sysfs();
4807 module_init(bonding_init);
4808 module_exit(bonding_exit);
4809 MODULE_LICENSE("GPL");
4810 MODULE_VERSION(DRV_VERSION);
4811 MODULE_DESCRIPTION(DRV_DESCRIPTION ", v" DRV_VERSION);
4812 MODULE_AUTHOR("Thomas Davis, tadavis@lbl.gov and many others");
4813 MODULE_SUPPORTED_DEVICE("most ethernet devices");