1 /* SPDX-License-Identifier: GPL-1.0+ */
3  * Bond several ethernet interfaces into a Cisco, running 'Etherchannel'.
5  * Portions are (c) Copyright 1995 Simon "Guru Aleph-Null" Janes
43 	netdev_info(bond_dev, "(slave %s): " fmt, (slave_dev)->name, ##__VA_ARGS__)
45 	netdev_warn(bond_dev, "(slave %s): " fmt, (slave_dev)->name, ##__VA_ARGS__)
47 	netdev_dbg(bond_dev, "(slave %s): " fmt, (slave_dev)->name, ##__VA_ARGS__)
49 	netdev_err(bond_dev, "(slave %s): " fmt, (slave_dev)->name, ##__VA_ARGS__)
51 #define BOND_MODE(bond) ((bond)->params.mode)  argument
54 #define bond_slave_list(bond) (&(bond)->dev->adj_list.lower)  argument
56 #define bond_has_slaves(bond) !list_empty(bond_slave_list(bond))  argument
59 #define bond_first_slave(bond) \  argument
60 	(bond_has_slaves(bond) ? \
61 		netdev_adjacent_get_private(bond_slave_list(bond)->next) : \
63 #define bond_last_slave(bond) \  argument
64 	(bond_has_slaves(bond) ? \
65 		netdev_adjacent_get_private(bond_slave_list(bond)->prev) : \
69 #define bond_first_slave_rcu(bond) \  argument
70 	netdev_lower_get_first_private_rcu(bond->dev)
72 #define bond_is_first_slave(bond, pos) (pos == bond_first_slave(bond))  argument
73 #define bond_is_last_slave(bond, pos) (pos == bond_last_slave(bond))  argument
76  * bond_for_each_slave - iterate over all slaves
77  * @bond:	the bond holding this list
83 #define bond_for_each_slave(bond, pos, iter) \  argument
84 	netdev_for_each_lower_private((bond)->dev, pos, iter)
87 #define bond_for_each_slave_rcu(bond, pos, iter) \  argument
88 	netdev_for_each_lower_private_rcu((bond)->dev, pos, iter)
136 	char primary[IFNAMSIZ];  member
157 	struct net_device *dev; /* first - useful for panic debug */
158 	struct bonding *bond; /* our master */  member
201  * Link pseudo-state only used internally by monitors
203 #define BOND_LINK_NOCHANGE -1
215 	struct   net_device *dev; /* first - useful for panic debug */
226 	/* mode_lock is used for mode-specific locking needs, currently used by:
227 	 * 3ad mode (4) - protect against running bond_3ad_unbind_slave() and
230 	 * TLB mode (5) - to sync the use and modifications of its hash table
231 	 * ALB mode (6) - to sync the use and modifications of its hash table
267 	((struct slave *) rcu_dereference(dev->rx_handler_data))
270 	((struct slave *) rtnl_dereference(dev->rx_handler_data))
281  * Returns NULL if the net_device does not belong to any of the bond's slaves
283  * Caller must hold bond lock for read
285 static inline struct slave *bond_get_slave_by_dev(struct bonding *bond,  in bond_get_slave_by_dev()  argument
288 	return netdev_lower_dev_get_private(bond->dev, slave_dev);  in bond_get_slave_by_dev()
293 	return slave->bond;  in bond_get_bond_by_slave()
296 static inline bool bond_should_override_tx_queue(struct bonding *bond)  in bond_should_override_tx_queue()  argument
298 	return BOND_MODE(bond) == BOND_MODE_ACTIVEBACKUP ||  in bond_should_override_tx_queue()
299 	       BOND_MODE(bond) == BOND_MODE_ROUNDROBIN;  in bond_should_override_tx_queue()
302 static inline bool bond_is_lb(const struct bonding *bond)  in bond_is_lb()  argument
304 	return BOND_MODE(bond) == BOND_MODE_TLB ||  in bond_is_lb()
305 	       BOND_MODE(bond) == BOND_MODE_ALB;  in bond_is_lb()
308 static inline bool bond_needs_speed_duplex(const struct bonding *bond)  in bond_needs_speed_duplex()  argument
310 	return BOND_MODE(bond) == BOND_MODE_8023AD || bond_is_lb(bond);  in bond_needs_speed_duplex()
313 static inline bool bond_is_nondyn_tlb(const struct bonding *bond)  in bond_is_nondyn_tlb()  argument
315 	return (bond_is_lb(bond) && bond->params.tlb_dynamic_lb == 0);  in bond_is_nondyn_tlb()
318 static inline bool bond_mode_can_use_xmit_hash(const struct bonding *bond)  in bond_mode_can_use_xmit_hash()  argument
320 	return (BOND_MODE(bond) == BOND_MODE_8023AD ||  in bond_mode_can_use_xmit_hash()
321 		BOND_MODE(bond) == BOND_MODE_XOR ||  in bond_mode_can_use_xmit_hash()
322 		BOND_MODE(bond) == BOND_MODE_TLB ||  in bond_mode_can_use_xmit_hash()
323 		BOND_MODE(bond) == BOND_MODE_ALB);  in bond_mode_can_use_xmit_hash()
326 static inline bool bond_mode_uses_xmit_hash(const struct bonding *bond)  in bond_mode_uses_xmit_hash()  argument
328 	return (BOND_MODE(bond) == BOND_MODE_8023AD ||  in bond_mode_uses_xmit_hash()
329 		BOND_MODE(bond) == BOND_MODE_XOR ||  in bond_mode_uses_xmit_hash()
330 		bond_is_nondyn_tlb(bond));  in bond_mode_uses_xmit_hash()
345 static inline bool bond_uses_primary(struct bonding *bond)  in bond_uses_primary()  argument
347 	return bond_mode_uses_primary(BOND_MODE(bond));  in bond_uses_primary()
350 static inline struct net_device *bond_option_active_slave_get_rcu(struct bonding *bond)  in bond_option_active_slave_get_rcu()  argument
352 	struct slave *slave = rcu_dereference_rtnl(bond->curr_active_slave);  in bond_option_active_slave_get_rcu()
354 	return bond_uses_primary(bond) && slave ? slave->dev : NULL;  in bond_option_active_slave_get_rcu()
359 	return netif_running(slave->dev) && netif_carrier_ok(slave->dev);  in bond_slave_is_up()
364 	if (slave->backup) {  in bond_set_active_slave()
365 		slave->backup = 0;  in bond_set_active_slave()
373 	if (!slave->backup) {  in bond_set_backup_slave()
374 		slave->backup = 1;  in bond_set_backup_slave()
383 	if (slave->backup == slave_state)  in bond_set_slave_state()
386 	slave->backup = slave_state;  in bond_set_slave_state()
390 		slave->should_notify = 0;  in bond_set_slave_state()
392 		if (slave->should_notify)  in bond_set_slave_state()
393 			slave->should_notify = 0;  in bond_set_slave_state()
395 			slave->should_notify = 1;  in bond_set_slave_state()
399 static inline void bond_slave_state_change(struct bonding *bond)  in bond_slave_state_change()  argument
404 	bond_for_each_slave(bond, tmp, iter) {  in bond_slave_state_change()
405 		if (tmp->link == BOND_LINK_UP)  in bond_slave_state_change()
407 		else if (tmp->link == BOND_LINK_DOWN)  in bond_slave_state_change()
412 static inline void bond_slave_state_notify(struct bonding *bond)  in bond_slave_state_notify()  argument
417 	bond_for_each_slave(bond, tmp, iter) {  in bond_slave_state_notify()
418 		if (tmp->should_notify) {  in bond_slave_state_notify()
420 			tmp->should_notify = 0;  in bond_slave_state_notify()
427 	return slave->backup;  in bond_slave_state()
437 	return bond_slave_is_up(slave) && slave->link == BOND_LINK_UP &&  in bond_slave_can_tx()
489 static inline int slave_do_arp_validate(struct bonding *bond,  in slave_do_arp_validate()  argument
492 	return bond->params.arp_validate & (1 << bond_slave_state(slave));  in slave_do_arp_validate()
495 static inline int slave_do_arp_validate_only(struct bonding *bond)  in slave_do_arp_validate_only()  argument
497 	return bond->params.arp_validate & BOND_ARP_FILTER;  in slave_do_arp_validate_only()
514 /* Get the oldest arp which we've received on this slave for bond's
517 static inline unsigned long slave_oldest_target_arp_rx(struct bonding *bond,  in slave_oldest_target_arp_rx()  argument
521 	unsigned long ret = slave->target_last_arp_rx[0];  in slave_oldest_target_arp_rx()
523 	for (; (i < BOND_MAX_ARP_TARGETS) && bond->params.arp_targets[i]; i++)  in slave_oldest_target_arp_rx()
524 		if (time_before(slave->target_last_arp_rx[i], ret))  in slave_oldest_target_arp_rx()
525 			ret = slave->target_last_arp_rx[i];  in slave_oldest_target_arp_rx()
530 static inline unsigned long slave_last_rx(struct bonding *bond,  in slave_last_rx()  argument
533 	if (bond->params.arp_all_targets == BOND_ARP_TARGETS_ALL)  in slave_last_rx()
534 		return slave_oldest_target_arp_rx(bond, slave);  in slave_last_rx()
536 	return slave->last_rx;  in slave_last_rx()
541 	WRITE_ONCE(slave->last_tx, jiffies);  in slave_update_last_tx()
546 	return READ_ONCE(slave->last_tx);  in slave_last_tx()
553 	return netpoll_send_skb(slave->np, skb);  in bond_netpoll_send_skb()
567 	if (!bond_is_lb(slave->bond))  in bond_set_slave_inactive_flags()
569 	if (!slave->bond->params.all_slaves_active)  in bond_set_slave_inactive_flags()
570 		slave->inactive = 1;  in bond_set_slave_inactive_flags()
577 	slave->inactive = 0;  in bond_set_slave_active_flags()
582 	return slave->inactive;  in bond_is_slave_inactive()
587 	slave->link_new_state = state;  in bond_propose_link_state()
592 	if (slave->link_new_state == BOND_LINK_NOCHANGE)  in bond_commit_link_state()
595 	slave->link = slave->link_new_state;  in bond_commit_link_state()
599 		slave->should_notify_link = 0;  in bond_commit_link_state()
601 		if (slave->should_notify_link)  in bond_commit_link_state()
602 			slave->should_notify_link = 0;  in bond_commit_link_state()
604 			slave->should_notify_link = 1;  in bond_commit_link_state()
615 static inline void bond_slave_link_notify(struct bonding *bond)  in bond_slave_link_notify()  argument
620 	bond_for_each_slave(bond, tmp, iter) {  in bond_slave_link_notify()
621 		if (tmp->should_notify_link) {  in bond_slave_link_notify()
624 			tmp->should_notify_link = 0;  in bond_slave_link_notify()
653 int bond_rcv_validate(const struct sk_buff *skb, struct bonding *bond, struct slave *slave);
654 netdev_tx_t bond_dev_queue_xmit(struct bonding *bond, struct sk_buff *skb, struct net_device *slave…
658 void bond_prepare_sysfs_group(struct bonding *bond);
665 u32 bond_xmit_hash(struct bonding *bond, struct sk_buff *skb);
666 int bond_set_carrier(struct bonding *bond);
667 void bond_select_active_slave(struct bonding *bond);
668 void bond_change_active_slave(struct bonding *bond, struct slave *new_active);
671 void bond_debug_register(struct bonding *bond);
672 void bond_debug_unregister(struct bonding *bond);
673 void bond_debug_reregister(struct bonding *bond);
679 struct net_device *bond_option_active_slave_get_rcu(struct bonding *bond);
684 int bond_update_slave_arr(struct bonding *bond, struct slave *skipslave);
685 void bond_slave_arr_work_rearm(struct bonding *bond, unsigned long delay);
686 void bond_work_init_all(struct bonding *bond);
689 void bond_create_proc_entry(struct bonding *bond);
690 void bond_remove_proc_entry(struct bonding *bond);
694 static inline void bond_create_proc_entry(struct bonding *bond)  in bond_create_proc_entry()  argument
698 static inline void bond_remove_proc_entry(struct bonding *bond)  in bond_remove_proc_entry()  argument
711 static inline struct slave *bond_slave_has_mac(struct bonding *bond,  in bond_slave_has_mac()  argument
717 	bond_for_each_slave(bond, tmp, iter)  in bond_slave_has_mac()
718 		if (ether_addr_equal_64bits(mac, tmp->dev->dev_addr))  in bond_slave_has_mac()
725 static inline bool bond_slave_has_mac_rcu(struct bonding *bond, const u8 *mac)  in bond_slave_has_mac_rcu()  argument
730 	bond_for_each_slave_rcu(bond, tmp, iter)  in bond_slave_has_mac_rcu()
731 		if (ether_addr_equal_64bits(mac, tmp->dev->dev_addr))  in bond_slave_has_mac_rcu()
737  * Returns -1 if not found, index if found
749 	return -1;  in bond_get_targets_ip()
767 	return -1;  in bond_get_targets_ip6()