xref: /openbmc/linux/drivers/net/bonding/bond_3ad.c (revision a8da474e)
1 /*
2  * Copyright(c) 1999 - 2004 Intel Corporation. All rights reserved.
3  *
4  * This program is free software; you can redistribute it and/or modify it
5  * under the terms of the GNU General Public License as published by the Free
6  * Software Foundation; either version 2 of the License, or (at your option)
7  * any later version.
8  *
9  * This program is distributed in the hope that it will be useful, but WITHOUT
10  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
11  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
12  * more details.
13  *
14  * You should have received a copy of the GNU General Public License along with
15  * this program; if not, write to the Free Software Foundation, Inc., 59
16  * Temple Place - Suite 330, Boston, MA  02111-1307, USA.
17  *
18  * The full GNU General Public License is included in this distribution in the
19  * file called LICENSE.
20  *
21  */
22 
23 #include <linux/skbuff.h>
24 #include <linux/if_ether.h>
25 #include <linux/netdevice.h>
26 #include <linux/spinlock.h>
27 #include <linux/ethtool.h>
28 #include <linux/etherdevice.h>
29 #include <linux/if_bonding.h>
30 #include <linux/pkt_sched.h>
31 #include <net/net_namespace.h>
32 #include <net/bonding.h>
33 #include <net/bond_3ad.h>
34 
35 /* General definitions */
36 #define AD_SHORT_TIMEOUT           1
37 #define AD_LONG_TIMEOUT            0
38 #define AD_STANDBY                 0x2
39 #define AD_MAX_TX_IN_SECOND        3
40 #define AD_COLLECTOR_MAX_DELAY     0
41 
42 /* Timer definitions (43.4.4 in the 802.3ad standard) */
43 #define AD_FAST_PERIODIC_TIME      1
44 #define AD_SLOW_PERIODIC_TIME      30
45 #define AD_SHORT_TIMEOUT_TIME      (3*AD_FAST_PERIODIC_TIME)
46 #define AD_LONG_TIMEOUT_TIME       (3*AD_SLOW_PERIODIC_TIME)
47 #define AD_CHURN_DETECTION_TIME    60
48 #define AD_AGGREGATE_WAIT_TIME     2
49 
50 /* Port state definitions (43.4.2.2 in the 802.3ad standard) */
51 #define AD_STATE_LACP_ACTIVITY   0x1
52 #define AD_STATE_LACP_TIMEOUT    0x2
53 #define AD_STATE_AGGREGATION     0x4
54 #define AD_STATE_SYNCHRONIZATION 0x8
55 #define AD_STATE_COLLECTING      0x10
56 #define AD_STATE_DISTRIBUTING    0x20
57 #define AD_STATE_DEFAULTED       0x40
58 #define AD_STATE_EXPIRED         0x80
59 
60 /* Port Variables definitions used by the State Machines (43.4.7 in the
61  * 802.3ad standard)
62  */
63 #define AD_PORT_BEGIN           0x1
64 #define AD_PORT_LACP_ENABLED    0x2
65 #define AD_PORT_ACTOR_CHURN     0x4
66 #define AD_PORT_PARTNER_CHURN   0x8
67 #define AD_PORT_READY           0x10
68 #define AD_PORT_READY_N         0x20
69 #define AD_PORT_MATCHED         0x40
70 #define AD_PORT_STANDBY         0x80
71 #define AD_PORT_SELECTED        0x100
72 #define AD_PORT_MOVED           0x200
73 #define AD_PORT_CHURNED         (AD_PORT_ACTOR_CHURN | AD_PORT_PARTNER_CHURN)
74 
75 /* Port Key definitions
76  * key is determined according to the link speed, duplex and
77  * user key (which is yet not supported)
78  *           --------------------------------------------------------------
79  * Port key  | User key (10 bits)           | Speed (5 bits)      | Duplex|
80  *           --------------------------------------------------------------
81  *           |15                           6|5                   1|0
82  */
83 #define  AD_DUPLEX_KEY_MASKS    0x1
84 #define  AD_SPEED_KEY_MASKS     0x3E
85 #define  AD_USER_KEY_MASKS      0xFFC0
86 
87 enum ad_link_speed_type {
88 	AD_LINK_SPEED_1MBPS = 1,
89 	AD_LINK_SPEED_10MBPS,
90 	AD_LINK_SPEED_100MBPS,
91 	AD_LINK_SPEED_1000MBPS,
92 	AD_LINK_SPEED_2500MBPS,
93 	AD_LINK_SPEED_10000MBPS,
94 	AD_LINK_SPEED_20000MBPS,
95 	AD_LINK_SPEED_40000MBPS,
96 	AD_LINK_SPEED_56000MBPS
97 };
98 
99 /* compare MAC addresses */
100 #define MAC_ADDRESS_EQUAL(A, B)	\
101 	ether_addr_equal_64bits((const u8 *)A, (const u8 *)B)
102 
103 static struct mac_addr null_mac_addr = { { 0, 0, 0, 0, 0, 0 } };
104 static u16 ad_ticks_per_sec;
105 static const int ad_delta_in_ticks = (AD_TIMER_INTERVAL * HZ) / 1000;
106 
107 static const u8 lacpdu_mcast_addr[ETH_ALEN] = MULTICAST_LACPDU_ADDR;
108 
109 /* ================= main 802.3ad protocol functions ================== */
110 static int ad_lacpdu_send(struct port *port);
111 static int ad_marker_send(struct port *port, struct bond_marker *marker);
112 static void ad_mux_machine(struct port *port, bool *update_slave_arr);
113 static void ad_rx_machine(struct lacpdu *lacpdu, struct port *port);
114 static void ad_tx_machine(struct port *port);
115 static void ad_periodic_machine(struct port *port);
116 static void ad_port_selection_logic(struct port *port, bool *update_slave_arr);
117 static void ad_agg_selection_logic(struct aggregator *aggregator,
118 				   bool *update_slave_arr);
119 static void ad_clear_agg(struct aggregator *aggregator);
120 static void ad_initialize_agg(struct aggregator *aggregator);
121 static void ad_initialize_port(struct port *port, int lacp_fast);
122 static void ad_enable_collecting_distributing(struct port *port,
123 					      bool *update_slave_arr);
124 static void ad_disable_collecting_distributing(struct port *port,
125 					       bool *update_slave_arr);
126 static void ad_marker_info_received(struct bond_marker *marker_info,
127 				    struct port *port);
128 static void ad_marker_response_received(struct bond_marker *marker,
129 					struct port *port);
130 static void ad_update_actor_keys(struct port *port, bool reset);
131 
132 
133 /* ================= api to bonding and kernel code ================== */
134 
135 /**
136  * __get_bond_by_port - get the port's bonding struct
137  * @port: the port we're looking at
138  *
139  * Return @port's bonding struct, or %NULL if it can't be found.
140  */
141 static inline struct bonding *__get_bond_by_port(struct port *port)
142 {
143 	if (port->slave == NULL)
144 		return NULL;
145 
146 	return bond_get_bond_by_slave(port->slave);
147 }
148 
149 /**
150  * __get_first_agg - get the first aggregator in the bond
151  * @bond: the bond we're looking at
152  *
153  * Return the aggregator of the first slave in @bond, or %NULL if it can't be
154  * found.
155  * The caller must hold RCU or RTNL lock.
156  */
157 static inline struct aggregator *__get_first_agg(struct port *port)
158 {
159 	struct bonding *bond = __get_bond_by_port(port);
160 	struct slave *first_slave;
161 	struct aggregator *agg;
162 
163 	/* If there's no bond for this port, or bond has no slaves */
164 	if (bond == NULL)
165 		return NULL;
166 
167 	rcu_read_lock();
168 	first_slave = bond_first_slave_rcu(bond);
169 	agg = first_slave ? &(SLAVE_AD_INFO(first_slave)->aggregator) : NULL;
170 	rcu_read_unlock();
171 
172 	return agg;
173 }
174 
175 /**
176  * __agg_has_partner - see if we have a partner
177  * @agg: the agregator we're looking at
178  *
179  * Return nonzero if aggregator has a partner (denoted by a non-zero ether
180  * address for the partner). Return 0 if not.
181  */
182 static inline int __agg_has_partner(struct aggregator *agg)
183 {
184 	return !is_zero_ether_addr(agg->partner_system.mac_addr_value);
185 }
186 
187 /**
188  * __disable_port - disable the port's slave
189  * @port: the port we're looking at
190  */
191 static inline void __disable_port(struct port *port)
192 {
193 	bond_set_slave_inactive_flags(port->slave, BOND_SLAVE_NOTIFY_LATER);
194 }
195 
196 /**
197  * __enable_port - enable the port's slave, if it's up
198  * @port: the port we're looking at
199  */
200 static inline void __enable_port(struct port *port)
201 {
202 	struct slave *slave = port->slave;
203 
204 	if ((slave->link == BOND_LINK_UP) && bond_slave_is_up(slave))
205 		bond_set_slave_active_flags(slave, BOND_SLAVE_NOTIFY_LATER);
206 }
207 
208 /**
209  * __port_is_enabled - check if the port's slave is in active state
210  * @port: the port we're looking at
211  */
212 static inline int __port_is_enabled(struct port *port)
213 {
214 	return bond_is_active_slave(port->slave);
215 }
216 
217 /**
218  * __get_agg_selection_mode - get the aggregator selection mode
219  * @port: the port we're looking at
220  *
221  * Get the aggregator selection mode. Can be %STABLE, %BANDWIDTH or %COUNT.
222  */
223 static inline u32 __get_agg_selection_mode(struct port *port)
224 {
225 	struct bonding *bond = __get_bond_by_port(port);
226 
227 	if (bond == NULL)
228 		return BOND_AD_STABLE;
229 
230 	return bond->params.ad_select;
231 }
232 
233 /**
234  * __check_agg_selection_timer - check if the selection timer has expired
235  * @port: the port we're looking at
236  */
237 static inline int __check_agg_selection_timer(struct port *port)
238 {
239 	struct bonding *bond = __get_bond_by_port(port);
240 
241 	if (bond == NULL)
242 		return 0;
243 
244 	return BOND_AD_INFO(bond).agg_select_timer ? 1 : 0;
245 }
246 
247 /**
248  * __get_link_speed - get a port's speed
249  * @port: the port we're looking at
250  *
251  * Return @port's speed in 802.3ad enum format. i.e. one of:
252  *     0,
253  *     %AD_LINK_SPEED_10MBPS,
254  *     %AD_LINK_SPEED_100MBPS,
255  *     %AD_LINK_SPEED_1000MBPS,
256  *     %AD_LINK_SPEED_2500MBPS,
257  *     %AD_LINK_SPEED_10000MBPS
258  *     %AD_LINK_SPEED_20000MBPS
259  *     %AD_LINK_SPEED_40000MBPS
260  *     %AD_LINK_SPEED_56000MBPS
261  */
262 static u16 __get_link_speed(struct port *port)
263 {
264 	struct slave *slave = port->slave;
265 	u16 speed;
266 
267 	/* this if covers only a special case: when the configuration starts
268 	 * with link down, it sets the speed to 0.
269 	 * This is done in spite of the fact that the e100 driver reports 0
270 	 * to be compatible with MVT in the future.
271 	 */
272 	if (slave->link != BOND_LINK_UP)
273 		speed = 0;
274 	else {
275 		switch (slave->speed) {
276 		case SPEED_10:
277 			speed = AD_LINK_SPEED_10MBPS;
278 			break;
279 
280 		case SPEED_100:
281 			speed = AD_LINK_SPEED_100MBPS;
282 			break;
283 
284 		case SPEED_1000:
285 			speed = AD_LINK_SPEED_1000MBPS;
286 			break;
287 
288 		case SPEED_2500:
289 			speed = AD_LINK_SPEED_2500MBPS;
290 			break;
291 
292 		case SPEED_10000:
293 			speed = AD_LINK_SPEED_10000MBPS;
294 			break;
295 
296 		case SPEED_20000:
297 			speed = AD_LINK_SPEED_20000MBPS;
298 			break;
299 
300 		case SPEED_40000:
301 			speed = AD_LINK_SPEED_40000MBPS;
302 			break;
303 
304 		case SPEED_56000:
305 			speed = AD_LINK_SPEED_56000MBPS;
306 			break;
307 
308 		default:
309 			/* unknown speed value from ethtool. shouldn't happen */
310 			speed = 0;
311 			break;
312 		}
313 	}
314 
315 	netdev_dbg(slave->bond->dev, "Port %d Received link speed %d update from adapter\n",
316 		   port->actor_port_number, speed);
317 	return speed;
318 }
319 
320 /**
321  * __get_duplex - get a port's duplex
322  * @port: the port we're looking at
323  *
324  * Return @port's duplex in 802.3ad bitmask format. i.e.:
325  *     0x01 if in full duplex
326  *     0x00 otherwise
327  */
328 static u8 __get_duplex(struct port *port)
329 {
330 	struct slave *slave = port->slave;
331 	u8 retval = 0x0;
332 
333 	/* handling a special case: when the configuration starts with
334 	 * link down, it sets the duplex to 0.
335 	 */
336 	if (slave->link == BOND_LINK_UP) {
337 		switch (slave->duplex) {
338 		case DUPLEX_FULL:
339 			retval = 0x1;
340 			netdev_dbg(slave->bond->dev, "Port %d Received status full duplex update from adapter\n",
341 				   port->actor_port_number);
342 			break;
343 		case DUPLEX_HALF:
344 		default:
345 			retval = 0x0;
346 			netdev_dbg(slave->bond->dev, "Port %d Received status NOT full duplex update from adapter\n",
347 				   port->actor_port_number);
348 			break;
349 		}
350 	}
351 	return retval;
352 }
353 
354 /* Conversions */
355 
356 /**
357  * __ad_timer_to_ticks - convert a given timer type to AD module ticks
358  * @timer_type:	which timer to operate
359  * @par: timer parameter. see below
360  *
361  * If @timer_type is %current_while_timer, @par indicates long/short timer.
362  * If @timer_type is %periodic_timer, @par is one of %FAST_PERIODIC_TIME,
363  *						     %SLOW_PERIODIC_TIME.
364  */
365 static u16 __ad_timer_to_ticks(u16 timer_type, u16 par)
366 {
367 	u16 retval = 0; /* to silence the compiler */
368 
369 	switch (timer_type) {
370 	case AD_CURRENT_WHILE_TIMER:	/* for rx machine usage */
371 		if (par)
372 			retval = (AD_SHORT_TIMEOUT_TIME*ad_ticks_per_sec);
373 		else
374 			retval = (AD_LONG_TIMEOUT_TIME*ad_ticks_per_sec);
375 		break;
376 	case AD_ACTOR_CHURN_TIMER:	/* for local churn machine */
377 		retval = (AD_CHURN_DETECTION_TIME*ad_ticks_per_sec);
378 		break;
379 	case AD_PERIODIC_TIMER:		/* for periodic machine */
380 		retval = (par*ad_ticks_per_sec); /* long timeout */
381 		break;
382 	case AD_PARTNER_CHURN_TIMER:	/* for remote churn machine */
383 		retval = (AD_CHURN_DETECTION_TIME*ad_ticks_per_sec);
384 		break;
385 	case AD_WAIT_WHILE_TIMER:	/* for selection machine */
386 		retval = (AD_AGGREGATE_WAIT_TIME*ad_ticks_per_sec);
387 		break;
388 	}
389 
390 	return retval;
391 }
392 
393 
394 /* ================= ad_rx_machine helper functions ================== */
395 
396 /**
397  * __choose_matched - update a port's matched variable from a received lacpdu
398  * @lacpdu: the lacpdu we've received
399  * @port: the port we're looking at
400  *
401  * Update the value of the matched variable, using parameter values from a
402  * newly received lacpdu. Parameter values for the partner carried in the
403  * received PDU are compared with the corresponding operational parameter
404  * values for the actor. Matched is set to TRUE if all of these parameters
405  * match and the PDU parameter partner_state.aggregation has the same value as
406  * actor_oper_port_state.aggregation and lacp will actively maintain the link
407  * in the aggregation. Matched is also set to TRUE if the value of
408  * actor_state.aggregation in the received PDU is set to FALSE, i.e., indicates
409  * an individual link and lacp will actively maintain the link. Otherwise,
410  * matched is set to FALSE. LACP is considered to be actively maintaining the
411  * link if either the PDU's actor_state.lacp_activity variable is TRUE or both
412  * the actor's actor_oper_port_state.lacp_activity and the PDU's
413  * partner_state.lacp_activity variables are TRUE.
414  *
415  * Note: the AD_PORT_MATCHED "variable" is not specified by 802.3ad; it is
416  * used here to implement the language from 802.3ad 43.4.9 that requires
417  * recordPDU to "match" the LACPDU parameters to the stored values.
418  */
419 static void __choose_matched(struct lacpdu *lacpdu, struct port *port)
420 {
421 	/* check if all parameters are alike
422 	 * or this is individual link(aggregation == FALSE)
423 	 * then update the state machine Matched variable.
424 	 */
425 	if (((ntohs(lacpdu->partner_port) == port->actor_port_number) &&
426 	     (ntohs(lacpdu->partner_port_priority) == port->actor_port_priority) &&
427 	     MAC_ADDRESS_EQUAL(&(lacpdu->partner_system), &(port->actor_system)) &&
428 	     (ntohs(lacpdu->partner_system_priority) == port->actor_system_priority) &&
429 	     (ntohs(lacpdu->partner_key) == port->actor_oper_port_key) &&
430 	     ((lacpdu->partner_state & AD_STATE_AGGREGATION) == (port->actor_oper_port_state & AD_STATE_AGGREGATION))) ||
431 	    ((lacpdu->actor_state & AD_STATE_AGGREGATION) == 0)
432 		) {
433 		port->sm_vars |= AD_PORT_MATCHED;
434 	} else {
435 		port->sm_vars &= ~AD_PORT_MATCHED;
436 	}
437 }
438 
439 /**
440  * __record_pdu - record parameters from a received lacpdu
441  * @lacpdu: the lacpdu we've received
442  * @port: the port we're looking at
443  *
444  * Record the parameter values for the Actor carried in a received lacpdu as
445  * the current partner operational parameter values and sets
446  * actor_oper_port_state.defaulted to FALSE.
447  */
448 static void __record_pdu(struct lacpdu *lacpdu, struct port *port)
449 {
450 	if (lacpdu && port) {
451 		struct port_params *partner = &port->partner_oper;
452 
453 		__choose_matched(lacpdu, port);
454 		/* record the new parameter values for the partner
455 		 * operational
456 		 */
457 		partner->port_number = ntohs(lacpdu->actor_port);
458 		partner->port_priority = ntohs(lacpdu->actor_port_priority);
459 		partner->system = lacpdu->actor_system;
460 		partner->system_priority = ntohs(lacpdu->actor_system_priority);
461 		partner->key = ntohs(lacpdu->actor_key);
462 		partner->port_state = lacpdu->actor_state;
463 
464 		/* set actor_oper_port_state.defaulted to FALSE */
465 		port->actor_oper_port_state &= ~AD_STATE_DEFAULTED;
466 
467 		/* set the partner sync. to on if the partner is sync,
468 		 * and the port is matched
469 		 */
470 		if ((port->sm_vars & AD_PORT_MATCHED) &&
471 		    (lacpdu->actor_state & AD_STATE_SYNCHRONIZATION)) {
472 			partner->port_state |= AD_STATE_SYNCHRONIZATION;
473 			pr_debug("%s partner sync=1\n", port->slave->dev->name);
474 		} else {
475 			partner->port_state &= ~AD_STATE_SYNCHRONIZATION;
476 			pr_debug("%s partner sync=0\n", port->slave->dev->name);
477 		}
478 	}
479 }
480 
481 /**
482  * __record_default - record default parameters
483  * @port: the port we're looking at
484  *
485  * This function records the default parameter values for the partner carried
486  * in the Partner Admin parameters as the current partner operational parameter
487  * values and sets actor_oper_port_state.defaulted to TRUE.
488  */
489 static void __record_default(struct port *port)
490 {
491 	if (port) {
492 		/* record the partner admin parameters */
493 		memcpy(&port->partner_oper, &port->partner_admin,
494 		       sizeof(struct port_params));
495 
496 		/* set actor_oper_port_state.defaulted to true */
497 		port->actor_oper_port_state |= AD_STATE_DEFAULTED;
498 	}
499 }
500 
501 /**
502  * __update_selected - update a port's Selected variable from a received lacpdu
503  * @lacpdu: the lacpdu we've received
504  * @port: the port we're looking at
505  *
506  * Update the value of the selected variable, using parameter values from a
507  * newly received lacpdu. The parameter values for the Actor carried in the
508  * received PDU are compared with the corresponding operational parameter
509  * values for the ports partner. If one or more of the comparisons shows that
510  * the value(s) received in the PDU differ from the current operational values,
511  * then selected is set to FALSE and actor_oper_port_state.synchronization is
512  * set to out_of_sync. Otherwise, selected remains unchanged.
513  */
514 static void __update_selected(struct lacpdu *lacpdu, struct port *port)
515 {
516 	if (lacpdu && port) {
517 		const struct port_params *partner = &port->partner_oper;
518 
519 		/* check if any parameter is different then
520 		 * update the state machine selected variable.
521 		 */
522 		if (ntohs(lacpdu->actor_port) != partner->port_number ||
523 		    ntohs(lacpdu->actor_port_priority) != partner->port_priority ||
524 		    !MAC_ADDRESS_EQUAL(&lacpdu->actor_system, &partner->system) ||
525 		    ntohs(lacpdu->actor_system_priority) != partner->system_priority ||
526 		    ntohs(lacpdu->actor_key) != partner->key ||
527 		    (lacpdu->actor_state & AD_STATE_AGGREGATION) != (partner->port_state & AD_STATE_AGGREGATION)) {
528 			port->sm_vars &= ~AD_PORT_SELECTED;
529 		}
530 	}
531 }
532 
533 /**
534  * __update_default_selected - update a port's Selected variable from Partner
535  * @port: the port we're looking at
536  *
537  * This function updates the value of the selected variable, using the partner
538  * administrative parameter values. The administrative values are compared with
539  * the corresponding operational parameter values for the partner. If one or
540  * more of the comparisons shows that the administrative value(s) differ from
541  * the current operational values, then Selected is set to FALSE and
542  * actor_oper_port_state.synchronization is set to OUT_OF_SYNC. Otherwise,
543  * Selected remains unchanged.
544  */
545 static void __update_default_selected(struct port *port)
546 {
547 	if (port) {
548 		const struct port_params *admin = &port->partner_admin;
549 		const struct port_params *oper = &port->partner_oper;
550 
551 		/* check if any parameter is different then
552 		 * update the state machine selected variable.
553 		 */
554 		if (admin->port_number != oper->port_number ||
555 		    admin->port_priority != oper->port_priority ||
556 		    !MAC_ADDRESS_EQUAL(&admin->system, &oper->system) ||
557 		    admin->system_priority != oper->system_priority ||
558 		    admin->key != oper->key ||
559 		    (admin->port_state & AD_STATE_AGGREGATION)
560 			!= (oper->port_state & AD_STATE_AGGREGATION)) {
561 			port->sm_vars &= ~AD_PORT_SELECTED;
562 		}
563 	}
564 }
565 
566 /**
567  * __update_ntt - update a port's ntt variable from a received lacpdu
568  * @lacpdu: the lacpdu we've received
569  * @port: the port we're looking at
570  *
571  * Updates the value of the ntt variable, using parameter values from a newly
572  * received lacpdu. The parameter values for the partner carried in the
573  * received PDU are compared with the corresponding operational parameter
574  * values for the Actor. If one or more of the comparisons shows that the
575  * value(s) received in the PDU differ from the current operational values,
576  * then ntt is set to TRUE. Otherwise, ntt remains unchanged.
577  */
578 static void __update_ntt(struct lacpdu *lacpdu, struct port *port)
579 {
580 	/* validate lacpdu and port */
581 	if (lacpdu && port) {
582 		/* check if any parameter is different then
583 		 * update the port->ntt.
584 		 */
585 		if ((ntohs(lacpdu->partner_port) != port->actor_port_number) ||
586 		    (ntohs(lacpdu->partner_port_priority) != port->actor_port_priority) ||
587 		    !MAC_ADDRESS_EQUAL(&(lacpdu->partner_system), &(port->actor_system)) ||
588 		    (ntohs(lacpdu->partner_system_priority) != port->actor_system_priority) ||
589 		    (ntohs(lacpdu->partner_key) != port->actor_oper_port_key) ||
590 		    ((lacpdu->partner_state & AD_STATE_LACP_ACTIVITY) != (port->actor_oper_port_state & AD_STATE_LACP_ACTIVITY)) ||
591 		    ((lacpdu->partner_state & AD_STATE_LACP_TIMEOUT) != (port->actor_oper_port_state & AD_STATE_LACP_TIMEOUT)) ||
592 		    ((lacpdu->partner_state & AD_STATE_SYNCHRONIZATION) != (port->actor_oper_port_state & AD_STATE_SYNCHRONIZATION)) ||
593 		    ((lacpdu->partner_state & AD_STATE_AGGREGATION) != (port->actor_oper_port_state & AD_STATE_AGGREGATION))
594 		   ) {
595 			port->ntt = true;
596 		}
597 	}
598 }
599 
600 /**
601  * __agg_ports_are_ready - check if all ports in an aggregator are ready
602  * @aggregator: the aggregator we're looking at
603  *
604  */
605 static int __agg_ports_are_ready(struct aggregator *aggregator)
606 {
607 	struct port *port;
608 	int retval = 1;
609 
610 	if (aggregator) {
611 		/* scan all ports in this aggregator to verfy if they are
612 		 * all ready.
613 		 */
614 		for (port = aggregator->lag_ports;
615 		     port;
616 		     port = port->next_port_in_aggregator) {
617 			if (!(port->sm_vars & AD_PORT_READY_N)) {
618 				retval = 0;
619 				break;
620 			}
621 		}
622 	}
623 
624 	return retval;
625 }
626 
627 /**
628  * __set_agg_ports_ready - set value of Ready bit in all ports of an aggregator
629  * @aggregator: the aggregator we're looking at
630  * @val: Should the ports' ready bit be set on or off
631  *
632  */
633 static void __set_agg_ports_ready(struct aggregator *aggregator, int val)
634 {
635 	struct port *port;
636 
637 	for (port = aggregator->lag_ports; port;
638 	     port = port->next_port_in_aggregator) {
639 		if (val)
640 			port->sm_vars |= AD_PORT_READY;
641 		else
642 			port->sm_vars &= ~AD_PORT_READY;
643 	}
644 }
645 
646 /**
647  * __get_agg_bandwidth - get the total bandwidth of an aggregator
648  * @aggregator: the aggregator we're looking at
649  *
650  */
651 static u32 __get_agg_bandwidth(struct aggregator *aggregator)
652 {
653 	u32 bandwidth = 0;
654 
655 	if (aggregator->num_of_ports) {
656 		switch (__get_link_speed(aggregator->lag_ports)) {
657 		case AD_LINK_SPEED_1MBPS:
658 			bandwidth = aggregator->num_of_ports;
659 			break;
660 		case AD_LINK_SPEED_10MBPS:
661 			bandwidth = aggregator->num_of_ports * 10;
662 			break;
663 		case AD_LINK_SPEED_100MBPS:
664 			bandwidth = aggregator->num_of_ports * 100;
665 			break;
666 		case AD_LINK_SPEED_1000MBPS:
667 			bandwidth = aggregator->num_of_ports * 1000;
668 			break;
669 		case AD_LINK_SPEED_2500MBPS:
670 			bandwidth = aggregator->num_of_ports * 2500;
671 			break;
672 		case AD_LINK_SPEED_10000MBPS:
673 			bandwidth = aggregator->num_of_ports * 10000;
674 			break;
675 		case AD_LINK_SPEED_20000MBPS:
676 			bandwidth = aggregator->num_of_ports * 20000;
677 			break;
678 		case AD_LINK_SPEED_40000MBPS:
679 			bandwidth = aggregator->num_of_ports * 40000;
680 			break;
681 		case AD_LINK_SPEED_56000MBPS:
682 			bandwidth = aggregator->num_of_ports * 56000;
683 			break;
684 		default:
685 			bandwidth = 0; /* to silence the compiler */
686 		}
687 	}
688 	return bandwidth;
689 }
690 
691 /**
692  * __get_active_agg - get the current active aggregator
693  * @aggregator: the aggregator we're looking at
694  *
695  * Caller must hold RCU lock.
696  */
697 static struct aggregator *__get_active_agg(struct aggregator *aggregator)
698 {
699 	struct bonding *bond = aggregator->slave->bond;
700 	struct list_head *iter;
701 	struct slave *slave;
702 
703 	bond_for_each_slave_rcu(bond, slave, iter)
704 		if (SLAVE_AD_INFO(slave)->aggregator.is_active)
705 			return &(SLAVE_AD_INFO(slave)->aggregator);
706 
707 	return NULL;
708 }
709 
710 /**
711  * __update_lacpdu_from_port - update a port's lacpdu fields
712  * @port: the port we're looking at
713  */
714 static inline void __update_lacpdu_from_port(struct port *port)
715 {
716 	struct lacpdu *lacpdu = &port->lacpdu;
717 	const struct port_params *partner = &port->partner_oper;
718 
719 	/* update current actual Actor parameters
720 	 * lacpdu->subtype                   initialized
721 	 * lacpdu->version_number            initialized
722 	 * lacpdu->tlv_type_actor_info       initialized
723 	 * lacpdu->actor_information_length  initialized
724 	 */
725 
726 	lacpdu->actor_system_priority = htons(port->actor_system_priority);
727 	lacpdu->actor_system = port->actor_system;
728 	lacpdu->actor_key = htons(port->actor_oper_port_key);
729 	lacpdu->actor_port_priority = htons(port->actor_port_priority);
730 	lacpdu->actor_port = htons(port->actor_port_number);
731 	lacpdu->actor_state = port->actor_oper_port_state;
732 	pr_debug("update lacpdu: %s, actor port state %x\n",
733 		 port->slave->dev->name, port->actor_oper_port_state);
734 
735 	/* lacpdu->reserved_3_1              initialized
736 	 * lacpdu->tlv_type_partner_info     initialized
737 	 * lacpdu->partner_information_length initialized
738 	 */
739 
740 	lacpdu->partner_system_priority = htons(partner->system_priority);
741 	lacpdu->partner_system = partner->system;
742 	lacpdu->partner_key = htons(partner->key);
743 	lacpdu->partner_port_priority = htons(partner->port_priority);
744 	lacpdu->partner_port = htons(partner->port_number);
745 	lacpdu->partner_state = partner->port_state;
746 
747 	/* lacpdu->reserved_3_2              initialized
748 	 * lacpdu->tlv_type_collector_info   initialized
749 	 * lacpdu->collector_information_length initialized
750 	 * collector_max_delay                initialized
751 	 * reserved_12[12]                   initialized
752 	 * tlv_type_terminator               initialized
753 	 * terminator_length                 initialized
754 	 * reserved_50[50]                   initialized
755 	 */
756 }
757 
758 /* ================= main 802.3ad protocol code ========================= */
759 
760 /**
761  * ad_lacpdu_send - send out a lacpdu packet on a given port
762  * @port: the port we're looking at
763  *
764  * Returns:   0 on success
765  *          < 0 on error
766  */
767 static int ad_lacpdu_send(struct port *port)
768 {
769 	struct slave *slave = port->slave;
770 	struct sk_buff *skb;
771 	struct lacpdu_header *lacpdu_header;
772 	int length = sizeof(struct lacpdu_header);
773 
774 	skb = dev_alloc_skb(length);
775 	if (!skb)
776 		return -ENOMEM;
777 
778 	skb->dev = slave->dev;
779 	skb_reset_mac_header(skb);
780 	skb->network_header = skb->mac_header + ETH_HLEN;
781 	skb->protocol = PKT_TYPE_LACPDU;
782 	skb->priority = TC_PRIO_CONTROL;
783 
784 	lacpdu_header = (struct lacpdu_header *)skb_put(skb, length);
785 
786 	ether_addr_copy(lacpdu_header->hdr.h_dest, lacpdu_mcast_addr);
787 	/* Note: source address is set to be the member's PERMANENT address,
788 	 * because we use it to identify loopback lacpdus in receive.
789 	 */
790 	ether_addr_copy(lacpdu_header->hdr.h_source, slave->perm_hwaddr);
791 	lacpdu_header->hdr.h_proto = PKT_TYPE_LACPDU;
792 
793 	lacpdu_header->lacpdu = port->lacpdu;
794 
795 	dev_queue_xmit(skb);
796 
797 	return 0;
798 }
799 
800 /**
801  * ad_marker_send - send marker information/response on a given port
802  * @port: the port we're looking at
803  * @marker: marker data to send
804  *
805  * Returns:   0 on success
806  *          < 0 on error
807  */
808 static int ad_marker_send(struct port *port, struct bond_marker *marker)
809 {
810 	struct slave *slave = port->slave;
811 	struct sk_buff *skb;
812 	struct bond_marker_header *marker_header;
813 	int length = sizeof(struct bond_marker_header);
814 
815 	skb = dev_alloc_skb(length + 16);
816 	if (!skb)
817 		return -ENOMEM;
818 
819 	skb_reserve(skb, 16);
820 
821 	skb->dev = slave->dev;
822 	skb_reset_mac_header(skb);
823 	skb->network_header = skb->mac_header + ETH_HLEN;
824 	skb->protocol = PKT_TYPE_LACPDU;
825 
826 	marker_header = (struct bond_marker_header *)skb_put(skb, length);
827 
828 	ether_addr_copy(marker_header->hdr.h_dest, lacpdu_mcast_addr);
829 	/* Note: source address is set to be the member's PERMANENT address,
830 	 * because we use it to identify loopback MARKERs in receive.
831 	 */
832 	ether_addr_copy(marker_header->hdr.h_source, slave->perm_hwaddr);
833 	marker_header->hdr.h_proto = PKT_TYPE_LACPDU;
834 
835 	marker_header->marker = *marker;
836 
837 	dev_queue_xmit(skb);
838 
839 	return 0;
840 }
841 
842 /**
843  * ad_mux_machine - handle a port's mux state machine
844  * @port: the port we're looking at
845  * @update_slave_arr: Does slave array need update?
846  */
847 static void ad_mux_machine(struct port *port, bool *update_slave_arr)
848 {
849 	mux_states_t last_state;
850 
851 	/* keep current State Machine state to compare later if it was
852 	 * changed
853 	 */
854 	last_state = port->sm_mux_state;
855 
856 	if (port->sm_vars & AD_PORT_BEGIN) {
857 		port->sm_mux_state = AD_MUX_DETACHED;
858 	} else {
859 		switch (port->sm_mux_state) {
860 		case AD_MUX_DETACHED:
861 			if ((port->sm_vars & AD_PORT_SELECTED)
862 			    || (port->sm_vars & AD_PORT_STANDBY))
863 				/* if SELECTED or STANDBY */
864 				port->sm_mux_state = AD_MUX_WAITING;
865 			break;
866 		case AD_MUX_WAITING:
867 			/* if SELECTED == FALSE return to DETACH state */
868 			if (!(port->sm_vars & AD_PORT_SELECTED)) {
869 				port->sm_vars &= ~AD_PORT_READY_N;
870 				/* in order to withhold the Selection Logic to
871 				 * check all ports READY_N value every callback
872 				 * cycle to update ready variable, we check
873 				 * READY_N and update READY here
874 				 */
875 				__set_agg_ports_ready(port->aggregator, __agg_ports_are_ready(port->aggregator));
876 				port->sm_mux_state = AD_MUX_DETACHED;
877 				break;
878 			}
879 
880 			/* check if the wait_while_timer expired */
881 			if (port->sm_mux_timer_counter
882 			    && !(--port->sm_mux_timer_counter))
883 				port->sm_vars |= AD_PORT_READY_N;
884 
885 			/* in order to withhold the selection logic to check
886 			 * all ports READY_N value every callback cycle to
887 			 * update ready variable, we check READY_N and update
888 			 * READY here
889 			 */
890 			__set_agg_ports_ready(port->aggregator, __agg_ports_are_ready(port->aggregator));
891 
892 			/* if the wait_while_timer expired, and the port is
893 			 * in READY state, move to ATTACHED state
894 			 */
895 			if ((port->sm_vars & AD_PORT_READY)
896 			    && !port->sm_mux_timer_counter)
897 				port->sm_mux_state = AD_MUX_ATTACHED;
898 			break;
899 		case AD_MUX_ATTACHED:
900 			/* check also if agg_select_timer expired (so the
901 			 * edable port will take place only after this timer)
902 			 */
903 			if ((port->sm_vars & AD_PORT_SELECTED) &&
904 			    (port->partner_oper.port_state & AD_STATE_SYNCHRONIZATION) &&
905 			    !__check_agg_selection_timer(port)) {
906 				if (port->aggregator->is_active)
907 					port->sm_mux_state =
908 					    AD_MUX_COLLECTING_DISTRIBUTING;
909 			} else if (!(port->sm_vars & AD_PORT_SELECTED) ||
910 				   (port->sm_vars & AD_PORT_STANDBY)) {
911 				/* if UNSELECTED or STANDBY */
912 				port->sm_vars &= ~AD_PORT_READY_N;
913 				/* in order to withhold the selection logic to
914 				 * check all ports READY_N value every callback
915 				 * cycle to update ready variable, we check
916 				 * READY_N and update READY here
917 				 */
918 				__set_agg_ports_ready(port->aggregator, __agg_ports_are_ready(port->aggregator));
919 				port->sm_mux_state = AD_MUX_DETACHED;
920 			} else if (port->aggregator->is_active) {
921 				port->actor_oper_port_state |=
922 				    AD_STATE_SYNCHRONIZATION;
923 			}
924 			break;
925 		case AD_MUX_COLLECTING_DISTRIBUTING:
926 			if (!(port->sm_vars & AD_PORT_SELECTED) ||
927 			    (port->sm_vars & AD_PORT_STANDBY) ||
928 			    !(port->partner_oper.port_state & AD_STATE_SYNCHRONIZATION) ||
929 			    !(port->actor_oper_port_state & AD_STATE_SYNCHRONIZATION)) {
930 				port->sm_mux_state = AD_MUX_ATTACHED;
931 			} else {
932 				/* if port state hasn't changed make
933 				 * sure that a collecting distributing
934 				 * port in an active aggregator is enabled
935 				 */
936 				if (port->aggregator &&
937 				    port->aggregator->is_active &&
938 				    !__port_is_enabled(port)) {
939 
940 					__enable_port(port);
941 				}
942 			}
943 			break;
944 		default:
945 			break;
946 		}
947 	}
948 
949 	/* check if the state machine was changed */
950 	if (port->sm_mux_state != last_state) {
951 		pr_debug("Mux Machine: Port=%d (%s), Last State=%d, Curr State=%d\n",
952 			 port->actor_port_number,
953 			 port->slave->dev->name,
954 			 last_state,
955 			 port->sm_mux_state);
956 		switch (port->sm_mux_state) {
957 		case AD_MUX_DETACHED:
958 			port->actor_oper_port_state &= ~AD_STATE_SYNCHRONIZATION;
959 			ad_disable_collecting_distributing(port,
960 							   update_slave_arr);
961 			port->actor_oper_port_state &= ~AD_STATE_COLLECTING;
962 			port->actor_oper_port_state &= ~AD_STATE_DISTRIBUTING;
963 			port->ntt = true;
964 			break;
965 		case AD_MUX_WAITING:
966 			port->sm_mux_timer_counter = __ad_timer_to_ticks(AD_WAIT_WHILE_TIMER, 0);
967 			break;
968 		case AD_MUX_ATTACHED:
969 			if (port->aggregator->is_active)
970 				port->actor_oper_port_state |=
971 				    AD_STATE_SYNCHRONIZATION;
972 			else
973 				port->actor_oper_port_state &=
974 				    ~AD_STATE_SYNCHRONIZATION;
975 			port->actor_oper_port_state &= ~AD_STATE_COLLECTING;
976 			port->actor_oper_port_state &= ~AD_STATE_DISTRIBUTING;
977 			ad_disable_collecting_distributing(port,
978 							   update_slave_arr);
979 			port->ntt = true;
980 			break;
981 		case AD_MUX_COLLECTING_DISTRIBUTING:
982 			port->actor_oper_port_state |= AD_STATE_COLLECTING;
983 			port->actor_oper_port_state |= AD_STATE_DISTRIBUTING;
984 			port->actor_oper_port_state |= AD_STATE_SYNCHRONIZATION;
985 			ad_enable_collecting_distributing(port,
986 							  update_slave_arr);
987 			port->ntt = true;
988 			break;
989 		default:
990 			break;
991 		}
992 	}
993 }
994 
995 /**
996  * ad_rx_machine - handle a port's rx State Machine
997  * @lacpdu: the lacpdu we've received
998  * @port: the port we're looking at
999  *
1000  * If lacpdu arrived, stop previous timer (if exists) and set the next state as
1001  * CURRENT. If timer expired set the state machine in the proper state.
1002  * In other cases, this function checks if we need to switch to other state.
1003  */
1004 static void ad_rx_machine(struct lacpdu *lacpdu, struct port *port)
1005 {
1006 	rx_states_t last_state;
1007 
1008 	/* keep current State Machine state to compare later if it was
1009 	 * changed
1010 	 */
1011 	last_state = port->sm_rx_state;
1012 
1013 	/* check if state machine should change state */
1014 
1015 	/* first, check if port was reinitialized */
1016 	if (port->sm_vars & AD_PORT_BEGIN) {
1017 		port->sm_rx_state = AD_RX_INITIALIZE;
1018 		port->sm_vars |= AD_PORT_CHURNED;
1019 	/* check if port is not enabled */
1020 	} else if (!(port->sm_vars & AD_PORT_BEGIN)
1021 		 && !port->is_enabled && !(port->sm_vars & AD_PORT_MOVED))
1022 		port->sm_rx_state = AD_RX_PORT_DISABLED;
1023 	/* check if new lacpdu arrived */
1024 	else if (lacpdu && ((port->sm_rx_state == AD_RX_EXPIRED) ||
1025 		 (port->sm_rx_state == AD_RX_DEFAULTED) ||
1026 		 (port->sm_rx_state == AD_RX_CURRENT))) {
1027 		if (port->sm_rx_state != AD_RX_CURRENT)
1028 			port->sm_vars |= AD_PORT_CHURNED;
1029 		port->sm_rx_timer_counter = 0;
1030 		port->sm_rx_state = AD_RX_CURRENT;
1031 	} else {
1032 		/* if timer is on, and if it is expired */
1033 		if (port->sm_rx_timer_counter &&
1034 		    !(--port->sm_rx_timer_counter)) {
1035 			switch (port->sm_rx_state) {
1036 			case AD_RX_EXPIRED:
1037 				port->sm_rx_state = AD_RX_DEFAULTED;
1038 				break;
1039 			case AD_RX_CURRENT:
1040 				port->sm_rx_state = AD_RX_EXPIRED;
1041 				break;
1042 			default:
1043 				break;
1044 			}
1045 		} else {
1046 			/* if no lacpdu arrived and no timer is on */
1047 			switch (port->sm_rx_state) {
1048 			case AD_RX_PORT_DISABLED:
1049 				if (port->sm_vars & AD_PORT_MOVED)
1050 					port->sm_rx_state = AD_RX_INITIALIZE;
1051 				else if (port->is_enabled
1052 					 && (port->sm_vars
1053 					     & AD_PORT_LACP_ENABLED))
1054 					port->sm_rx_state = AD_RX_EXPIRED;
1055 				else if (port->is_enabled
1056 					 && ((port->sm_vars
1057 					      & AD_PORT_LACP_ENABLED) == 0))
1058 					port->sm_rx_state = AD_RX_LACP_DISABLED;
1059 				break;
1060 			default:
1061 				break;
1062 
1063 			}
1064 		}
1065 	}
1066 
1067 	/* check if the State machine was changed or new lacpdu arrived */
1068 	if ((port->sm_rx_state != last_state) || (lacpdu)) {
1069 		pr_debug("Rx Machine: Port=%d (%s), Last State=%d, Curr State=%d\n",
1070 			 port->actor_port_number,
1071 			 port->slave->dev->name,
1072 			 last_state,
1073 			 port->sm_rx_state);
1074 		switch (port->sm_rx_state) {
1075 		case AD_RX_INITIALIZE:
1076 			if (!(port->actor_oper_port_key & AD_DUPLEX_KEY_MASKS))
1077 				port->sm_vars &= ~AD_PORT_LACP_ENABLED;
1078 			else
1079 				port->sm_vars |= AD_PORT_LACP_ENABLED;
1080 			port->sm_vars &= ~AD_PORT_SELECTED;
1081 			__record_default(port);
1082 			port->actor_oper_port_state &= ~AD_STATE_EXPIRED;
1083 			port->sm_vars &= ~AD_PORT_MOVED;
1084 			port->sm_rx_state = AD_RX_PORT_DISABLED;
1085 
1086 			/* Fall Through */
1087 		case AD_RX_PORT_DISABLED:
1088 			port->sm_vars &= ~AD_PORT_MATCHED;
1089 			break;
1090 		case AD_RX_LACP_DISABLED:
1091 			port->sm_vars &= ~AD_PORT_SELECTED;
1092 			__record_default(port);
1093 			port->partner_oper.port_state &= ~AD_STATE_AGGREGATION;
1094 			port->sm_vars |= AD_PORT_MATCHED;
1095 			port->actor_oper_port_state &= ~AD_STATE_EXPIRED;
1096 			break;
1097 		case AD_RX_EXPIRED:
1098 			/* Reset of the Synchronization flag (Standard 43.4.12)
1099 			 * This reset cause to disable this port in the
1100 			 * COLLECTING_DISTRIBUTING state of the mux machine in
1101 			 * case of EXPIRED even if LINK_DOWN didn't arrive for
1102 			 * the port.
1103 			 */
1104 			port->partner_oper.port_state &= ~AD_STATE_SYNCHRONIZATION;
1105 			port->sm_vars &= ~AD_PORT_MATCHED;
1106 			port->partner_oper.port_state |= AD_STATE_LACP_TIMEOUT;
1107 			port->partner_oper.port_state |= AD_STATE_LACP_ACTIVITY;
1108 			port->sm_rx_timer_counter = __ad_timer_to_ticks(AD_CURRENT_WHILE_TIMER, (u16)(AD_SHORT_TIMEOUT));
1109 			port->actor_oper_port_state |= AD_STATE_EXPIRED;
1110 			port->sm_vars |= AD_PORT_CHURNED;
1111 			break;
1112 		case AD_RX_DEFAULTED:
1113 			__update_default_selected(port);
1114 			__record_default(port);
1115 			port->sm_vars |= AD_PORT_MATCHED;
1116 			port->actor_oper_port_state &= ~AD_STATE_EXPIRED;
1117 			break;
1118 		case AD_RX_CURRENT:
1119 			/* detect loopback situation */
1120 			if (MAC_ADDRESS_EQUAL(&(lacpdu->actor_system),
1121 					      &(port->actor_system))) {
1122 				netdev_err(port->slave->bond->dev, "An illegal loopback occurred on adapter (%s)\n"
1123 				       "Check the configuration to verify that all adapters are connected to 802.3ad compliant switch ports\n",
1124 				       port->slave->dev->name);
1125 				return;
1126 			}
1127 			__update_selected(lacpdu, port);
1128 			__update_ntt(lacpdu, port);
1129 			__record_pdu(lacpdu, port);
1130 			port->sm_rx_timer_counter = __ad_timer_to_ticks(AD_CURRENT_WHILE_TIMER, (u16)(port->actor_oper_port_state & AD_STATE_LACP_TIMEOUT));
1131 			port->actor_oper_port_state &= ~AD_STATE_EXPIRED;
1132 			break;
1133 		default:
1134 			break;
1135 		}
1136 	}
1137 }
1138 
1139 /**
1140  * ad_churn_machine - handle port churn's state machine
1141  * @port: the port we're looking at
1142  *
1143  */
1144 static void ad_churn_machine(struct port *port)
1145 {
1146 	if (port->sm_vars & AD_PORT_CHURNED) {
1147 		port->sm_vars &= ~AD_PORT_CHURNED;
1148 		port->sm_churn_actor_state = AD_CHURN_MONITOR;
1149 		port->sm_churn_partner_state = AD_CHURN_MONITOR;
1150 		port->sm_churn_actor_timer_counter =
1151 			__ad_timer_to_ticks(AD_ACTOR_CHURN_TIMER, 0);
1152 		 port->sm_churn_partner_timer_counter =
1153 			 __ad_timer_to_ticks(AD_PARTNER_CHURN_TIMER, 0);
1154 		return;
1155 	}
1156 	if (port->sm_churn_actor_timer_counter &&
1157 	    !(--port->sm_churn_actor_timer_counter) &&
1158 	    port->sm_churn_actor_state == AD_CHURN_MONITOR) {
1159 		if (port->actor_oper_port_state & AD_STATE_SYNCHRONIZATION) {
1160 			port->sm_churn_actor_state = AD_NO_CHURN;
1161 		} else {
1162 			port->churn_actor_count++;
1163 			port->sm_churn_actor_state = AD_CHURN;
1164 		}
1165 	}
1166 	if (port->sm_churn_partner_timer_counter &&
1167 	    !(--port->sm_churn_partner_timer_counter) &&
1168 	    port->sm_churn_partner_state == AD_CHURN_MONITOR) {
1169 		if (port->partner_oper.port_state & AD_STATE_SYNCHRONIZATION) {
1170 			port->sm_churn_partner_state = AD_NO_CHURN;
1171 		} else {
1172 			port->churn_partner_count++;
1173 			port->sm_churn_partner_state = AD_CHURN;
1174 		}
1175 	}
1176 }
1177 
1178 /**
1179  * ad_tx_machine - handle a port's tx state machine
1180  * @port: the port we're looking at
1181  */
1182 static void ad_tx_machine(struct port *port)
1183 {
1184 	/* check if tx timer expired, to verify that we do not send more than
1185 	 * 3 packets per second
1186 	 */
1187 	if (port->sm_tx_timer_counter && !(--port->sm_tx_timer_counter)) {
1188 		/* check if there is something to send */
1189 		if (port->ntt && (port->sm_vars & AD_PORT_LACP_ENABLED)) {
1190 			__update_lacpdu_from_port(port);
1191 
1192 			if (ad_lacpdu_send(port) >= 0) {
1193 				pr_debug("Sent LACPDU on port %d\n",
1194 					 port->actor_port_number);
1195 
1196 				/* mark ntt as false, so it will not be sent
1197 				 * again until demanded
1198 				 */
1199 				port->ntt = false;
1200 			}
1201 		}
1202 		/* restart tx timer(to verify that we will not exceed
1203 		 * AD_MAX_TX_IN_SECOND
1204 		 */
1205 		port->sm_tx_timer_counter = ad_ticks_per_sec/AD_MAX_TX_IN_SECOND;
1206 	}
1207 }
1208 
1209 /**
1210  * ad_periodic_machine - handle a port's periodic state machine
1211  * @port: the port we're looking at
1212  *
1213  * Turn ntt flag on priodically to perform periodic transmission of lacpdu's.
1214  */
1215 static void ad_periodic_machine(struct port *port)
1216 {
1217 	periodic_states_t last_state;
1218 
1219 	/* keep current state machine state to compare later if it was changed */
1220 	last_state = port->sm_periodic_state;
1221 
1222 	/* check if port was reinitialized */
1223 	if (((port->sm_vars & AD_PORT_BEGIN) || !(port->sm_vars & AD_PORT_LACP_ENABLED) || !port->is_enabled) ||
1224 	    (!(port->actor_oper_port_state & AD_STATE_LACP_ACTIVITY) && !(port->partner_oper.port_state & AD_STATE_LACP_ACTIVITY))
1225 	   ) {
1226 		port->sm_periodic_state = AD_NO_PERIODIC;
1227 	}
1228 	/* check if state machine should change state */
1229 	else if (port->sm_periodic_timer_counter) {
1230 		/* check if periodic state machine expired */
1231 		if (!(--port->sm_periodic_timer_counter)) {
1232 			/* if expired then do tx */
1233 			port->sm_periodic_state = AD_PERIODIC_TX;
1234 		} else {
1235 			/* If not expired, check if there is some new timeout
1236 			 * parameter from the partner state
1237 			 */
1238 			switch (port->sm_periodic_state) {
1239 			case AD_FAST_PERIODIC:
1240 				if (!(port->partner_oper.port_state
1241 				      & AD_STATE_LACP_TIMEOUT))
1242 					port->sm_periodic_state = AD_SLOW_PERIODIC;
1243 				break;
1244 			case AD_SLOW_PERIODIC:
1245 				if ((port->partner_oper.port_state & AD_STATE_LACP_TIMEOUT)) {
1246 					port->sm_periodic_timer_counter = 0;
1247 					port->sm_periodic_state = AD_PERIODIC_TX;
1248 				}
1249 				break;
1250 			default:
1251 				break;
1252 			}
1253 		}
1254 	} else {
1255 		switch (port->sm_periodic_state) {
1256 		case AD_NO_PERIODIC:
1257 			port->sm_periodic_state = AD_FAST_PERIODIC;
1258 			break;
1259 		case AD_PERIODIC_TX:
1260 			if (!(port->partner_oper.port_state &
1261 			    AD_STATE_LACP_TIMEOUT))
1262 				port->sm_periodic_state = AD_SLOW_PERIODIC;
1263 			else
1264 				port->sm_periodic_state = AD_FAST_PERIODIC;
1265 			break;
1266 		default:
1267 			break;
1268 		}
1269 	}
1270 
1271 	/* check if the state machine was changed */
1272 	if (port->sm_periodic_state != last_state) {
1273 		pr_debug("Periodic Machine: Port=%d, Last State=%d, Curr State=%d\n",
1274 			 port->actor_port_number, last_state,
1275 			 port->sm_periodic_state);
1276 		switch (port->sm_periodic_state) {
1277 		case AD_NO_PERIODIC:
1278 			port->sm_periodic_timer_counter = 0;
1279 			break;
1280 		case AD_FAST_PERIODIC:
1281 			/* decrement 1 tick we lost in the PERIODIC_TX cycle */
1282 			port->sm_periodic_timer_counter = __ad_timer_to_ticks(AD_PERIODIC_TIMER, (u16)(AD_FAST_PERIODIC_TIME))-1;
1283 			break;
1284 		case AD_SLOW_PERIODIC:
1285 			/* decrement 1 tick we lost in the PERIODIC_TX cycle */
1286 			port->sm_periodic_timer_counter = __ad_timer_to_ticks(AD_PERIODIC_TIMER, (u16)(AD_SLOW_PERIODIC_TIME))-1;
1287 			break;
1288 		case AD_PERIODIC_TX:
1289 			port->ntt = true;
1290 			break;
1291 		default:
1292 			break;
1293 		}
1294 	}
1295 }
1296 
1297 /**
1298  * ad_port_selection_logic - select aggregation groups
1299  * @port: the port we're looking at
1300  * @update_slave_arr: Does slave array need update?
1301  *
1302  * Select aggregation groups, and assign each port for it's aggregetor. The
1303  * selection logic is called in the inititalization (after all the handshkes),
1304  * and after every lacpdu receive (if selected is off).
1305  */
1306 static void ad_port_selection_logic(struct port *port, bool *update_slave_arr)
1307 {
1308 	struct aggregator *aggregator, *free_aggregator = NULL, *temp_aggregator;
1309 	struct port *last_port = NULL, *curr_port;
1310 	struct list_head *iter;
1311 	struct bonding *bond;
1312 	struct slave *slave;
1313 	int found = 0;
1314 
1315 	/* if the port is already Selected, do nothing */
1316 	if (port->sm_vars & AD_PORT_SELECTED)
1317 		return;
1318 
1319 	bond = __get_bond_by_port(port);
1320 
1321 	/* if the port is connected to other aggregator, detach it */
1322 	if (port->aggregator) {
1323 		/* detach the port from its former aggregator */
1324 		temp_aggregator = port->aggregator;
1325 		for (curr_port = temp_aggregator->lag_ports; curr_port;
1326 		     last_port = curr_port,
1327 		     curr_port = curr_port->next_port_in_aggregator) {
1328 			if (curr_port == port) {
1329 				temp_aggregator->num_of_ports--;
1330 				/* if it is the first port attached to the
1331 				 * aggregator
1332 				 */
1333 				if (!last_port) {
1334 					temp_aggregator->lag_ports =
1335 						port->next_port_in_aggregator;
1336 				} else {
1337 					/* not the first port attached to the
1338 					 * aggregator
1339 					 */
1340 					last_port->next_port_in_aggregator =
1341 						port->next_port_in_aggregator;
1342 				}
1343 
1344 				/* clear the port's relations to this
1345 				 * aggregator
1346 				 */
1347 				port->aggregator = NULL;
1348 				port->next_port_in_aggregator = NULL;
1349 				port->actor_port_aggregator_identifier = 0;
1350 
1351 				netdev_dbg(bond->dev, "Port %d left LAG %d\n",
1352 					   port->actor_port_number,
1353 					   temp_aggregator->aggregator_identifier);
1354 				/* if the aggregator is empty, clear its
1355 				 * parameters, and set it ready to be attached
1356 				 */
1357 				if (!temp_aggregator->lag_ports)
1358 					ad_clear_agg(temp_aggregator);
1359 				break;
1360 			}
1361 		}
1362 		if (!curr_port) {
1363 			/* meaning: the port was related to an aggregator
1364 			 * but was not on the aggregator port list
1365 			 */
1366 			net_warn_ratelimited("%s: Warning: Port %d (on %s) was related to aggregator %d but was not on its port list\n",
1367 					     port->slave->bond->dev->name,
1368 					     port->actor_port_number,
1369 					     port->slave->dev->name,
1370 					     port->aggregator->aggregator_identifier);
1371 		}
1372 	}
1373 	/* search on all aggregators for a suitable aggregator for this port */
1374 	bond_for_each_slave(bond, slave, iter) {
1375 		aggregator = &(SLAVE_AD_INFO(slave)->aggregator);
1376 
1377 		/* keep a free aggregator for later use(if needed) */
1378 		if (!aggregator->lag_ports) {
1379 			if (!free_aggregator)
1380 				free_aggregator = aggregator;
1381 			continue;
1382 		}
1383 		/* check if current aggregator suits us */
1384 		if (((aggregator->actor_oper_aggregator_key == port->actor_oper_port_key) && /* if all parameters match AND */
1385 		     MAC_ADDRESS_EQUAL(&(aggregator->partner_system), &(port->partner_oper.system)) &&
1386 		     (aggregator->partner_system_priority == port->partner_oper.system_priority) &&
1387 		     (aggregator->partner_oper_aggregator_key == port->partner_oper.key)
1388 		    ) &&
1389 		    ((!MAC_ADDRESS_EQUAL(&(port->partner_oper.system), &(null_mac_addr)) && /* partner answers */
1390 		      !aggregator->is_individual)  /* but is not individual OR */
1391 		    )
1392 		   ) {
1393 			/* attach to the founded aggregator */
1394 			port->aggregator = aggregator;
1395 			port->actor_port_aggregator_identifier =
1396 				port->aggregator->aggregator_identifier;
1397 			port->next_port_in_aggregator = aggregator->lag_ports;
1398 			port->aggregator->num_of_ports++;
1399 			aggregator->lag_ports = port;
1400 			netdev_dbg(bond->dev, "Port %d joined LAG %d(existing LAG)\n",
1401 				   port->actor_port_number,
1402 				   port->aggregator->aggregator_identifier);
1403 
1404 			/* mark this port as selected */
1405 			port->sm_vars |= AD_PORT_SELECTED;
1406 			found = 1;
1407 			break;
1408 		}
1409 	}
1410 
1411 	/* the port couldn't find an aggregator - attach it to a new
1412 	 * aggregator
1413 	 */
1414 	if (!found) {
1415 		if (free_aggregator) {
1416 			/* assign port a new aggregator */
1417 			port->aggregator = free_aggregator;
1418 			port->actor_port_aggregator_identifier =
1419 				port->aggregator->aggregator_identifier;
1420 
1421 			/* update the new aggregator's parameters
1422 			 * if port was responsed from the end-user
1423 			 */
1424 			if (port->actor_oper_port_key & AD_DUPLEX_KEY_MASKS)
1425 				/* if port is full duplex */
1426 				port->aggregator->is_individual = false;
1427 			else
1428 				port->aggregator->is_individual = true;
1429 
1430 			port->aggregator->actor_admin_aggregator_key =
1431 				port->actor_admin_port_key;
1432 			port->aggregator->actor_oper_aggregator_key =
1433 				port->actor_oper_port_key;
1434 			port->aggregator->partner_system =
1435 				port->partner_oper.system;
1436 			port->aggregator->partner_system_priority =
1437 				port->partner_oper.system_priority;
1438 			port->aggregator->partner_oper_aggregator_key = port->partner_oper.key;
1439 			port->aggregator->receive_state = 1;
1440 			port->aggregator->transmit_state = 1;
1441 			port->aggregator->lag_ports = port;
1442 			port->aggregator->num_of_ports++;
1443 
1444 			/* mark this port as selected */
1445 			port->sm_vars |= AD_PORT_SELECTED;
1446 
1447 			netdev_dbg(bond->dev, "Port %d joined LAG %d(new LAG)\n",
1448 				   port->actor_port_number,
1449 				   port->aggregator->aggregator_identifier);
1450 		} else {
1451 			netdev_err(bond->dev, "Port %d (on %s) did not find a suitable aggregator\n",
1452 			       port->actor_port_number, port->slave->dev->name);
1453 		}
1454 	}
1455 	/* if all aggregator's ports are READY_N == TRUE, set ready=TRUE
1456 	 * in all aggregator's ports, else set ready=FALSE in all
1457 	 * aggregator's ports
1458 	 */
1459 	__set_agg_ports_ready(port->aggregator,
1460 			      __agg_ports_are_ready(port->aggregator));
1461 
1462 	aggregator = __get_first_agg(port);
1463 	ad_agg_selection_logic(aggregator, update_slave_arr);
1464 
1465 	if (!port->aggregator->is_active)
1466 		port->actor_oper_port_state &= ~AD_STATE_SYNCHRONIZATION;
1467 }
1468 
1469 /* Decide if "agg" is a better choice for the new active aggregator that
1470  * the current best, according to the ad_select policy.
1471  */
1472 static struct aggregator *ad_agg_selection_test(struct aggregator *best,
1473 						struct aggregator *curr)
1474 {
1475 	/* 0. If no best, select current.
1476 	 *
1477 	 * 1. If the current agg is not individual, and the best is
1478 	 *    individual, select current.
1479 	 *
1480 	 * 2. If current agg is individual and the best is not, keep best.
1481 	 *
1482 	 * 3. Therefore, current and best are both individual or both not
1483 	 *    individual, so:
1484 	 *
1485 	 * 3a. If current agg partner replied, and best agg partner did not,
1486 	 *     select current.
1487 	 *
1488 	 * 3b. If current agg partner did not reply and best agg partner
1489 	 *     did reply, keep best.
1490 	 *
1491 	 * 4.  Therefore, current and best both have partner replies or
1492 	 *     both do not, so perform selection policy:
1493 	 *
1494 	 * BOND_AD_COUNT: Select by count of ports.  If count is equal,
1495 	 *     select by bandwidth.
1496 	 *
1497 	 * BOND_AD_STABLE, BOND_AD_BANDWIDTH: Select by bandwidth.
1498 	 */
1499 	if (!best)
1500 		return curr;
1501 
1502 	if (!curr->is_individual && best->is_individual)
1503 		return curr;
1504 
1505 	if (curr->is_individual && !best->is_individual)
1506 		return best;
1507 
1508 	if (__agg_has_partner(curr) && !__agg_has_partner(best))
1509 		return curr;
1510 
1511 	if (!__agg_has_partner(curr) && __agg_has_partner(best))
1512 		return best;
1513 
1514 	switch (__get_agg_selection_mode(curr->lag_ports)) {
1515 	case BOND_AD_COUNT:
1516 		if (curr->num_of_ports > best->num_of_ports)
1517 			return curr;
1518 
1519 		if (curr->num_of_ports < best->num_of_ports)
1520 			return best;
1521 
1522 		/*FALLTHROUGH*/
1523 	case BOND_AD_STABLE:
1524 	case BOND_AD_BANDWIDTH:
1525 		if (__get_agg_bandwidth(curr) > __get_agg_bandwidth(best))
1526 			return curr;
1527 
1528 		break;
1529 
1530 	default:
1531 		net_warn_ratelimited("%s: Impossible agg select mode %d\n",
1532 				     curr->slave->bond->dev->name,
1533 				     __get_agg_selection_mode(curr->lag_ports));
1534 		break;
1535 	}
1536 
1537 	return best;
1538 }
1539 
1540 static int agg_device_up(const struct aggregator *agg)
1541 {
1542 	struct port *port = agg->lag_ports;
1543 
1544 	if (!port)
1545 		return 0;
1546 
1547 	return netif_running(port->slave->dev) &&
1548 	       netif_carrier_ok(port->slave->dev);
1549 }
1550 
1551 /**
1552  * ad_agg_selection_logic - select an aggregation group for a team
1553  * @aggregator: the aggregator we're looking at
1554  * @update_slave_arr: Does slave array need update?
1555  *
1556  * It is assumed that only one aggregator may be selected for a team.
1557  *
1558  * The logic of this function is to select the aggregator according to
1559  * the ad_select policy:
1560  *
1561  * BOND_AD_STABLE: select the aggregator with the most ports attached to
1562  * it, and to reselect the active aggregator only if the previous
1563  * aggregator has no more ports related to it.
1564  *
1565  * BOND_AD_BANDWIDTH: select the aggregator with the highest total
1566  * bandwidth, and reselect whenever a link state change takes place or the
1567  * set of slaves in the bond changes.
1568  *
1569  * BOND_AD_COUNT: select the aggregator with largest number of ports
1570  * (slaves), and reselect whenever a link state change takes place or the
1571  * set of slaves in the bond changes.
1572  *
1573  * FIXME: this function MUST be called with the first agg in the bond, or
1574  * __get_active_agg() won't work correctly. This function should be better
1575  * called with the bond itself, and retrieve the first agg from it.
1576  */
1577 static void ad_agg_selection_logic(struct aggregator *agg,
1578 				   bool *update_slave_arr)
1579 {
1580 	struct aggregator *best, *active, *origin;
1581 	struct bonding *bond = agg->slave->bond;
1582 	struct list_head *iter;
1583 	struct slave *slave;
1584 	struct port *port;
1585 
1586 	rcu_read_lock();
1587 	origin = agg;
1588 	active = __get_active_agg(agg);
1589 	best = (active && agg_device_up(active)) ? active : NULL;
1590 
1591 	bond_for_each_slave_rcu(bond, slave, iter) {
1592 		agg = &(SLAVE_AD_INFO(slave)->aggregator);
1593 
1594 		agg->is_active = 0;
1595 
1596 		if (agg->num_of_ports && agg_device_up(agg))
1597 			best = ad_agg_selection_test(best, agg);
1598 	}
1599 
1600 	if (best &&
1601 	    __get_agg_selection_mode(best->lag_ports) == BOND_AD_STABLE) {
1602 		/* For the STABLE policy, don't replace the old active
1603 		 * aggregator if it's still active (it has an answering
1604 		 * partner) or if both the best and active don't have an
1605 		 * answering partner.
1606 		 */
1607 		if (active && active->lag_ports &&
1608 		    active->lag_ports->is_enabled &&
1609 		    (__agg_has_partner(active) ||
1610 		     (!__agg_has_partner(active) &&
1611 		     !__agg_has_partner(best)))) {
1612 			if (!(!active->actor_oper_aggregator_key &&
1613 			      best->actor_oper_aggregator_key)) {
1614 				best = NULL;
1615 				active->is_active = 1;
1616 			}
1617 		}
1618 	}
1619 
1620 	if (best && (best == active)) {
1621 		best = NULL;
1622 		active->is_active = 1;
1623 	}
1624 
1625 	/* if there is new best aggregator, activate it */
1626 	if (best) {
1627 		netdev_dbg(bond->dev, "best Agg=%d; P=%d; a k=%d; p k=%d; Ind=%d; Act=%d\n",
1628 			   best->aggregator_identifier, best->num_of_ports,
1629 			   best->actor_oper_aggregator_key,
1630 			   best->partner_oper_aggregator_key,
1631 			   best->is_individual, best->is_active);
1632 		netdev_dbg(bond->dev, "best ports %p slave %p %s\n",
1633 			   best->lag_ports, best->slave,
1634 			   best->slave ? best->slave->dev->name : "NULL");
1635 
1636 		bond_for_each_slave_rcu(bond, slave, iter) {
1637 			agg = &(SLAVE_AD_INFO(slave)->aggregator);
1638 
1639 			netdev_dbg(bond->dev, "Agg=%d; P=%d; a k=%d; p k=%d; Ind=%d; Act=%d\n",
1640 				   agg->aggregator_identifier, agg->num_of_ports,
1641 				   agg->actor_oper_aggregator_key,
1642 				   agg->partner_oper_aggregator_key,
1643 				   agg->is_individual, agg->is_active);
1644 		}
1645 
1646 		/* check if any partner replys */
1647 		if (best->is_individual) {
1648 			net_warn_ratelimited("%s: Warning: No 802.3ad response from the link partner for any adapters in the bond\n",
1649 					     best->slave ?
1650 					     best->slave->bond->dev->name : "NULL");
1651 		}
1652 
1653 		best->is_active = 1;
1654 		netdev_dbg(bond->dev, "LAG %d chosen as the active LAG\n",
1655 			   best->aggregator_identifier);
1656 		netdev_dbg(bond->dev, "Agg=%d; P=%d; a k=%d; p k=%d; Ind=%d; Act=%d\n",
1657 			   best->aggregator_identifier, best->num_of_ports,
1658 			   best->actor_oper_aggregator_key,
1659 			   best->partner_oper_aggregator_key,
1660 			   best->is_individual, best->is_active);
1661 
1662 		/* disable the ports that were related to the former
1663 		 * active_aggregator
1664 		 */
1665 		if (active) {
1666 			for (port = active->lag_ports; port;
1667 			     port = port->next_port_in_aggregator) {
1668 				__disable_port(port);
1669 			}
1670 		}
1671 		/* Slave array needs update. */
1672 		*update_slave_arr = true;
1673 	}
1674 
1675 	/* if the selected aggregator is of join individuals
1676 	 * (partner_system is NULL), enable their ports
1677 	 */
1678 	active = __get_active_agg(origin);
1679 
1680 	if (active) {
1681 		if (!__agg_has_partner(active)) {
1682 			for (port = active->lag_ports; port;
1683 			     port = port->next_port_in_aggregator) {
1684 				__enable_port(port);
1685 			}
1686 		}
1687 	}
1688 
1689 	rcu_read_unlock();
1690 
1691 	bond_3ad_set_carrier(bond);
1692 }
1693 
1694 /**
1695  * ad_clear_agg - clear a given aggregator's parameters
1696  * @aggregator: the aggregator we're looking at
1697  */
1698 static void ad_clear_agg(struct aggregator *aggregator)
1699 {
1700 	if (aggregator) {
1701 		aggregator->is_individual = false;
1702 		aggregator->actor_admin_aggregator_key = 0;
1703 		aggregator->actor_oper_aggregator_key = 0;
1704 		aggregator->partner_system = null_mac_addr;
1705 		aggregator->partner_system_priority = 0;
1706 		aggregator->partner_oper_aggregator_key = 0;
1707 		aggregator->receive_state = 0;
1708 		aggregator->transmit_state = 0;
1709 		aggregator->lag_ports = NULL;
1710 		aggregator->is_active = 0;
1711 		aggregator->num_of_ports = 0;
1712 		pr_debug("LAG %d was cleared\n",
1713 			 aggregator->aggregator_identifier);
1714 	}
1715 }
1716 
1717 /**
1718  * ad_initialize_agg - initialize a given aggregator's parameters
1719  * @aggregator: the aggregator we're looking at
1720  */
1721 static void ad_initialize_agg(struct aggregator *aggregator)
1722 {
1723 	if (aggregator) {
1724 		ad_clear_agg(aggregator);
1725 
1726 		aggregator->aggregator_mac_address = null_mac_addr;
1727 		aggregator->aggregator_identifier = 0;
1728 		aggregator->slave = NULL;
1729 	}
1730 }
1731 
1732 /**
1733  * ad_initialize_port - initialize a given port's parameters
1734  * @aggregator: the aggregator we're looking at
1735  * @lacp_fast: boolean. whether fast periodic should be used
1736  */
1737 static void ad_initialize_port(struct port *port, int lacp_fast)
1738 {
1739 	static const struct port_params tmpl = {
1740 		.system_priority = 0xffff,
1741 		.key             = 1,
1742 		.port_number     = 1,
1743 		.port_priority   = 0xff,
1744 		.port_state      = 1,
1745 	};
1746 	static const struct lacpdu lacpdu = {
1747 		.subtype		= 0x01,
1748 		.version_number = 0x01,
1749 		.tlv_type_actor_info = 0x01,
1750 		.actor_information_length = 0x14,
1751 		.tlv_type_partner_info = 0x02,
1752 		.partner_information_length = 0x14,
1753 		.tlv_type_collector_info = 0x03,
1754 		.collector_information_length = 0x10,
1755 		.collector_max_delay = htons(AD_COLLECTOR_MAX_DELAY),
1756 	};
1757 
1758 	if (port) {
1759 		port->actor_port_priority = 0xff;
1760 		port->actor_port_aggregator_identifier = 0;
1761 		port->ntt = false;
1762 		port->actor_admin_port_state = AD_STATE_AGGREGATION |
1763 					       AD_STATE_LACP_ACTIVITY;
1764 		port->actor_oper_port_state  = AD_STATE_AGGREGATION |
1765 					       AD_STATE_LACP_ACTIVITY;
1766 
1767 		if (lacp_fast)
1768 			port->actor_oper_port_state |= AD_STATE_LACP_TIMEOUT;
1769 
1770 		memcpy(&port->partner_admin, &tmpl, sizeof(tmpl));
1771 		memcpy(&port->partner_oper, &tmpl, sizeof(tmpl));
1772 
1773 		port->is_enabled = true;
1774 		/* private parameters */
1775 		port->sm_vars = AD_PORT_BEGIN | AD_PORT_LACP_ENABLED;
1776 		port->sm_rx_state = 0;
1777 		port->sm_rx_timer_counter = 0;
1778 		port->sm_periodic_state = 0;
1779 		port->sm_periodic_timer_counter = 0;
1780 		port->sm_mux_state = 0;
1781 		port->sm_mux_timer_counter = 0;
1782 		port->sm_tx_state = 0;
1783 		port->aggregator = NULL;
1784 		port->next_port_in_aggregator = NULL;
1785 		port->transaction_id = 0;
1786 
1787 		port->sm_churn_actor_timer_counter = 0;
1788 		port->sm_churn_actor_state = 0;
1789 		port->churn_actor_count = 0;
1790 		port->sm_churn_partner_timer_counter = 0;
1791 		port->sm_churn_partner_state = 0;
1792 		port->churn_partner_count = 0;
1793 
1794 		memcpy(&port->lacpdu, &lacpdu, sizeof(lacpdu));
1795 	}
1796 }
1797 
1798 /**
1799  * ad_enable_collecting_distributing - enable a port's transmit/receive
1800  * @port: the port we're looking at
1801  * @update_slave_arr: Does slave array need update?
1802  *
1803  * Enable @port if it's in an active aggregator
1804  */
1805 static void ad_enable_collecting_distributing(struct port *port,
1806 					      bool *update_slave_arr)
1807 {
1808 	if (port->aggregator->is_active) {
1809 		pr_debug("Enabling port %d(LAG %d)\n",
1810 			 port->actor_port_number,
1811 			 port->aggregator->aggregator_identifier);
1812 		__enable_port(port);
1813 		/* Slave array needs update */
1814 		*update_slave_arr = true;
1815 	}
1816 }
1817 
1818 /**
1819  * ad_disable_collecting_distributing - disable a port's transmit/receive
1820  * @port: the port we're looking at
1821  * @update_slave_arr: Does slave array need update?
1822  */
1823 static void ad_disable_collecting_distributing(struct port *port,
1824 					       bool *update_slave_arr)
1825 {
1826 	if (port->aggregator &&
1827 	    !MAC_ADDRESS_EQUAL(&(port->aggregator->partner_system),
1828 			       &(null_mac_addr))) {
1829 		pr_debug("Disabling port %d(LAG %d)\n",
1830 			 port->actor_port_number,
1831 			 port->aggregator->aggregator_identifier);
1832 		__disable_port(port);
1833 		/* Slave array needs an update */
1834 		*update_slave_arr = true;
1835 	}
1836 }
1837 
1838 /**
1839  * ad_marker_info_received - handle receive of a Marker information frame
1840  * @marker_info: Marker info received
1841  * @port: the port we're looking at
1842  */
1843 static void ad_marker_info_received(struct bond_marker *marker_info,
1844 	struct port *port)
1845 {
1846 	struct bond_marker marker;
1847 
1848 	/* copy the received marker data to the response marker */
1849 	memcpy(&marker, marker_info, sizeof(struct bond_marker));
1850 	/* change the marker subtype to marker response */
1851 	marker.tlv_type = AD_MARKER_RESPONSE_SUBTYPE;
1852 
1853 	/* send the marker response */
1854 	if (ad_marker_send(port, &marker) >= 0) {
1855 		pr_debug("Sent Marker Response on port %d\n",
1856 			 port->actor_port_number);
1857 	}
1858 }
1859 
1860 /**
1861  * ad_marker_response_received - handle receive of a marker response frame
1862  * @marker: marker PDU received
1863  * @port: the port we're looking at
1864  *
1865  * This function does nothing since we decided not to implement send and handle
1866  * response for marker PDU's, in this stage, but only to respond to marker
1867  * information.
1868  */
1869 static void ad_marker_response_received(struct bond_marker *marker,
1870 					struct port *port)
1871 {
1872 	/* DO NOTHING, SINCE WE DECIDED NOT TO IMPLEMENT THIS FEATURE FOR NOW */
1873 }
1874 
1875 /* ========= AD exported functions to the main bonding code ========= */
1876 
1877 /* Check aggregators status in team every T seconds */
1878 #define AD_AGGREGATOR_SELECTION_TIMER  8
1879 
1880 /**
1881  * bond_3ad_initiate_agg_selection - initate aggregator selection
1882  * @bond: bonding struct
1883  *
1884  * Set the aggregation selection timer, to initiate an agg selection in
1885  * the very near future.  Called during first initialization, and during
1886  * any down to up transitions of the bond.
1887  */
1888 void bond_3ad_initiate_agg_selection(struct bonding *bond, int timeout)
1889 {
1890 	BOND_AD_INFO(bond).agg_select_timer = timeout;
1891 }
1892 
1893 /**
1894  * bond_3ad_initialize - initialize a bond's 802.3ad parameters and structures
1895  * @bond: bonding struct to work on
1896  * @tick_resolution: tick duration (millisecond resolution)
1897  *
1898  * Can be called only after the mac address of the bond is set.
1899  */
1900 void bond_3ad_initialize(struct bonding *bond, u16 tick_resolution)
1901 {
1902 	/* check that the bond is not initialized yet */
1903 	if (!MAC_ADDRESS_EQUAL(&(BOND_AD_INFO(bond).system.sys_mac_addr),
1904 				bond->dev->dev_addr)) {
1905 
1906 		BOND_AD_INFO(bond).aggregator_identifier = 0;
1907 
1908 		BOND_AD_INFO(bond).system.sys_priority =
1909 			bond->params.ad_actor_sys_prio;
1910 		if (is_zero_ether_addr(bond->params.ad_actor_system))
1911 			BOND_AD_INFO(bond).system.sys_mac_addr =
1912 			    *((struct mac_addr *)bond->dev->dev_addr);
1913 		else
1914 			BOND_AD_INFO(bond).system.sys_mac_addr =
1915 			    *((struct mac_addr *)bond->params.ad_actor_system);
1916 
1917 		/* initialize how many times this module is called in one
1918 		 * second (should be about every 100ms)
1919 		 */
1920 		ad_ticks_per_sec = tick_resolution;
1921 
1922 		bond_3ad_initiate_agg_selection(bond,
1923 						AD_AGGREGATOR_SELECTION_TIMER *
1924 						ad_ticks_per_sec);
1925 	}
1926 }
1927 
1928 /**
1929  * bond_3ad_bind_slave - initialize a slave's port
1930  * @slave: slave struct to work on
1931  *
1932  * Returns:   0 on success
1933  *          < 0 on error
1934  */
1935 void bond_3ad_bind_slave(struct slave *slave)
1936 {
1937 	struct bonding *bond = bond_get_bond_by_slave(slave);
1938 	struct port *port;
1939 	struct aggregator *aggregator;
1940 
1941 	/* check that the slave has not been initialized yet. */
1942 	if (SLAVE_AD_INFO(slave)->port.slave != slave) {
1943 
1944 		/* port initialization */
1945 		port = &(SLAVE_AD_INFO(slave)->port);
1946 
1947 		ad_initialize_port(port, bond->params.lacp_fast);
1948 
1949 		port->slave = slave;
1950 		port->actor_port_number = SLAVE_AD_INFO(slave)->id;
1951 		/* key is determined according to the link speed, duplex and
1952 		 * user key
1953 		 */
1954 		port->actor_admin_port_key = bond->params.ad_user_port_key << 6;
1955 		ad_update_actor_keys(port, false);
1956 		/* actor system is the bond's system */
1957 		port->actor_system = BOND_AD_INFO(bond).system.sys_mac_addr;
1958 		port->actor_system_priority =
1959 		    BOND_AD_INFO(bond).system.sys_priority;
1960 		/* tx timer(to verify that no more than MAX_TX_IN_SECOND
1961 		 * lacpdu's are sent in one second)
1962 		 */
1963 		port->sm_tx_timer_counter = ad_ticks_per_sec/AD_MAX_TX_IN_SECOND;
1964 
1965 		__disable_port(port);
1966 
1967 		/* aggregator initialization */
1968 		aggregator = &(SLAVE_AD_INFO(slave)->aggregator);
1969 
1970 		ad_initialize_agg(aggregator);
1971 
1972 		aggregator->aggregator_mac_address = *((struct mac_addr *)bond->dev->dev_addr);
1973 		aggregator->aggregator_identifier = ++BOND_AD_INFO(bond).aggregator_identifier;
1974 		aggregator->slave = slave;
1975 		aggregator->is_active = 0;
1976 		aggregator->num_of_ports = 0;
1977 	}
1978 }
1979 
1980 /**
1981  * bond_3ad_unbind_slave - deinitialize a slave's port
1982  * @slave: slave struct to work on
1983  *
1984  * Search for the aggregator that is related to this port, remove the
1985  * aggregator and assign another aggregator for other port related to it
1986  * (if any), and remove the port.
1987  */
1988 void bond_3ad_unbind_slave(struct slave *slave)
1989 {
1990 	struct port *port, *prev_port, *temp_port;
1991 	struct aggregator *aggregator, *new_aggregator, *temp_aggregator;
1992 	int select_new_active_agg = 0;
1993 	struct bonding *bond = slave->bond;
1994 	struct slave *slave_iter;
1995 	struct list_head *iter;
1996 	bool dummy_slave_update; /* Ignore this value as caller updates array */
1997 
1998 	/* Sync against bond_3ad_state_machine_handler() */
1999 	spin_lock_bh(&bond->mode_lock);
2000 	aggregator = &(SLAVE_AD_INFO(slave)->aggregator);
2001 	port = &(SLAVE_AD_INFO(slave)->port);
2002 
2003 	/* if slave is null, the whole port is not initialized */
2004 	if (!port->slave) {
2005 		netdev_warn(bond->dev, "Trying to unbind an uninitialized port on %s\n",
2006 			    slave->dev->name);
2007 		goto out;
2008 	}
2009 
2010 	netdev_dbg(bond->dev, "Unbinding Link Aggregation Group %d\n",
2011 		   aggregator->aggregator_identifier);
2012 
2013 	/* Tell the partner that this port is not suitable for aggregation */
2014 	port->actor_oper_port_state &= ~AD_STATE_AGGREGATION;
2015 	__update_lacpdu_from_port(port);
2016 	ad_lacpdu_send(port);
2017 
2018 	/* check if this aggregator is occupied */
2019 	if (aggregator->lag_ports) {
2020 		/* check if there are other ports related to this aggregator
2021 		 * except the port related to this slave(thats ensure us that
2022 		 * there is a reason to search for new aggregator, and that we
2023 		 * will find one
2024 		 */
2025 		if ((aggregator->lag_ports != port) ||
2026 		    (aggregator->lag_ports->next_port_in_aggregator)) {
2027 			/* find new aggregator for the related port(s) */
2028 			bond_for_each_slave(bond, slave_iter, iter) {
2029 				new_aggregator = &(SLAVE_AD_INFO(slave_iter)->aggregator);
2030 				/* if the new aggregator is empty, or it is
2031 				 * connected to our port only
2032 				 */
2033 				if (!new_aggregator->lag_ports ||
2034 				    ((new_aggregator->lag_ports == port) &&
2035 				     !new_aggregator->lag_ports->next_port_in_aggregator))
2036 					break;
2037 			}
2038 			if (!slave_iter)
2039 				new_aggregator = NULL;
2040 
2041 			/* if new aggregator found, copy the aggregator's
2042 			 * parameters and connect the related lag_ports to the
2043 			 * new aggregator
2044 			 */
2045 			if ((new_aggregator) && ((!new_aggregator->lag_ports) || ((new_aggregator->lag_ports == port) && !new_aggregator->lag_ports->next_port_in_aggregator))) {
2046 				netdev_dbg(bond->dev, "Some port(s) related to LAG %d - replacing with LAG %d\n",
2047 					   aggregator->aggregator_identifier,
2048 					   new_aggregator->aggregator_identifier);
2049 
2050 				if ((new_aggregator->lag_ports == port) &&
2051 				    new_aggregator->is_active) {
2052 					netdev_info(bond->dev, "Removing an active aggregator\n");
2053 					 select_new_active_agg = 1;
2054 				}
2055 
2056 				new_aggregator->is_individual = aggregator->is_individual;
2057 				new_aggregator->actor_admin_aggregator_key = aggregator->actor_admin_aggregator_key;
2058 				new_aggregator->actor_oper_aggregator_key = aggregator->actor_oper_aggregator_key;
2059 				new_aggregator->partner_system = aggregator->partner_system;
2060 				new_aggregator->partner_system_priority = aggregator->partner_system_priority;
2061 				new_aggregator->partner_oper_aggregator_key = aggregator->partner_oper_aggregator_key;
2062 				new_aggregator->receive_state = aggregator->receive_state;
2063 				new_aggregator->transmit_state = aggregator->transmit_state;
2064 				new_aggregator->lag_ports = aggregator->lag_ports;
2065 				new_aggregator->is_active = aggregator->is_active;
2066 				new_aggregator->num_of_ports = aggregator->num_of_ports;
2067 
2068 				/* update the information that is written on
2069 				 * the ports about the aggregator
2070 				 */
2071 				for (temp_port = aggregator->lag_ports; temp_port;
2072 				     temp_port = temp_port->next_port_in_aggregator) {
2073 					temp_port->aggregator = new_aggregator;
2074 					temp_port->actor_port_aggregator_identifier = new_aggregator->aggregator_identifier;
2075 				}
2076 
2077 				ad_clear_agg(aggregator);
2078 
2079 				if (select_new_active_agg)
2080 					ad_agg_selection_logic(__get_first_agg(port),
2081 							       &dummy_slave_update);
2082 			} else {
2083 				netdev_warn(bond->dev, "unbinding aggregator, and could not find a new aggregator for its ports\n");
2084 			}
2085 		} else {
2086 			/* in case that the only port related to this
2087 			 * aggregator is the one we want to remove
2088 			 */
2089 			select_new_active_agg = aggregator->is_active;
2090 			ad_clear_agg(aggregator);
2091 			if (select_new_active_agg) {
2092 				netdev_info(bond->dev, "Removing an active aggregator\n");
2093 				/* select new active aggregator */
2094 				temp_aggregator = __get_first_agg(port);
2095 				if (temp_aggregator)
2096 					ad_agg_selection_logic(temp_aggregator,
2097 							       &dummy_slave_update);
2098 			}
2099 		}
2100 	}
2101 
2102 	netdev_dbg(bond->dev, "Unbinding port %d\n", port->actor_port_number);
2103 
2104 	/* find the aggregator that this port is connected to */
2105 	bond_for_each_slave(bond, slave_iter, iter) {
2106 		temp_aggregator = &(SLAVE_AD_INFO(slave_iter)->aggregator);
2107 		prev_port = NULL;
2108 		/* search the port in the aggregator's related ports */
2109 		for (temp_port = temp_aggregator->lag_ports; temp_port;
2110 		     prev_port = temp_port,
2111 		     temp_port = temp_port->next_port_in_aggregator) {
2112 			if (temp_port == port) {
2113 				/* the aggregator found - detach the port from
2114 				 * this aggregator
2115 				 */
2116 				if (prev_port)
2117 					prev_port->next_port_in_aggregator = temp_port->next_port_in_aggregator;
2118 				else
2119 					temp_aggregator->lag_ports = temp_port->next_port_in_aggregator;
2120 				temp_aggregator->num_of_ports--;
2121 				if (temp_aggregator->num_of_ports == 0) {
2122 					select_new_active_agg = temp_aggregator->is_active;
2123 					ad_clear_agg(temp_aggregator);
2124 					if (select_new_active_agg) {
2125 						netdev_info(bond->dev, "Removing an active aggregator\n");
2126 						/* select new active aggregator */
2127 						ad_agg_selection_logic(__get_first_agg(port),
2128 							               &dummy_slave_update);
2129 					}
2130 				}
2131 				break;
2132 			}
2133 		}
2134 	}
2135 	port->slave = NULL;
2136 
2137 out:
2138 	spin_unlock_bh(&bond->mode_lock);
2139 }
2140 
2141 /**
2142  * bond_3ad_state_machine_handler - handle state machines timeout
2143  * @bond: bonding struct to work on
2144  *
2145  * The state machine handling concept in this module is to check every tick
2146  * which state machine should operate any function. The execution order is
2147  * round robin, so when we have an interaction between state machines, the
2148  * reply of one to each other might be delayed until next tick.
2149  *
2150  * This function also complete the initialization when the agg_select_timer
2151  * times out, and it selects an aggregator for the ports that are yet not
2152  * related to any aggregator, and selects the active aggregator for a bond.
2153  */
2154 void bond_3ad_state_machine_handler(struct work_struct *work)
2155 {
2156 	struct bonding *bond = container_of(work, struct bonding,
2157 					    ad_work.work);
2158 	struct aggregator *aggregator;
2159 	struct list_head *iter;
2160 	struct slave *slave;
2161 	struct port *port;
2162 	bool should_notify_rtnl = BOND_SLAVE_NOTIFY_LATER;
2163 	bool update_slave_arr = false;
2164 
2165 	/* Lock to protect data accessed by all (e.g., port->sm_vars) and
2166 	 * against running with bond_3ad_unbind_slave. ad_rx_machine may run
2167 	 * concurrently due to incoming LACPDU as well.
2168 	 */
2169 	spin_lock_bh(&bond->mode_lock);
2170 	rcu_read_lock();
2171 
2172 	/* check if there are any slaves */
2173 	if (!bond_has_slaves(bond))
2174 		goto re_arm;
2175 
2176 	/* check if agg_select_timer timer after initialize is timed out */
2177 	if (BOND_AD_INFO(bond).agg_select_timer &&
2178 	    !(--BOND_AD_INFO(bond).agg_select_timer)) {
2179 		slave = bond_first_slave_rcu(bond);
2180 		port = slave ? &(SLAVE_AD_INFO(slave)->port) : NULL;
2181 
2182 		/* select the active aggregator for the bond */
2183 		if (port) {
2184 			if (!port->slave) {
2185 				net_warn_ratelimited("%s: Warning: bond's first port is uninitialized\n",
2186 						     bond->dev->name);
2187 				goto re_arm;
2188 			}
2189 
2190 			aggregator = __get_first_agg(port);
2191 			ad_agg_selection_logic(aggregator, &update_slave_arr);
2192 		}
2193 		bond_3ad_set_carrier(bond);
2194 	}
2195 
2196 	/* for each port run the state machines */
2197 	bond_for_each_slave_rcu(bond, slave, iter) {
2198 		port = &(SLAVE_AD_INFO(slave)->port);
2199 		if (!port->slave) {
2200 			net_warn_ratelimited("%s: Warning: Found an uninitialized port\n",
2201 					    bond->dev->name);
2202 			goto re_arm;
2203 		}
2204 
2205 		ad_rx_machine(NULL, port);
2206 		ad_periodic_machine(port);
2207 		ad_port_selection_logic(port, &update_slave_arr);
2208 		ad_mux_machine(port, &update_slave_arr);
2209 		ad_tx_machine(port);
2210 		ad_churn_machine(port);
2211 
2212 		/* turn off the BEGIN bit, since we already handled it */
2213 		if (port->sm_vars & AD_PORT_BEGIN)
2214 			port->sm_vars &= ~AD_PORT_BEGIN;
2215 	}
2216 
2217 re_arm:
2218 	bond_for_each_slave_rcu(bond, slave, iter) {
2219 		if (slave->should_notify) {
2220 			should_notify_rtnl = BOND_SLAVE_NOTIFY_NOW;
2221 			break;
2222 		}
2223 	}
2224 	rcu_read_unlock();
2225 	spin_unlock_bh(&bond->mode_lock);
2226 
2227 	if (update_slave_arr)
2228 		bond_slave_arr_work_rearm(bond, 0);
2229 
2230 	if (should_notify_rtnl && rtnl_trylock()) {
2231 		bond_slave_state_notify(bond);
2232 		rtnl_unlock();
2233 	}
2234 	queue_delayed_work(bond->wq, &bond->ad_work, ad_delta_in_ticks);
2235 }
2236 
2237 /**
2238  * bond_3ad_rx_indication - handle a received frame
2239  * @lacpdu: received lacpdu
2240  * @slave: slave struct to work on
2241  * @length: length of the data received
2242  *
2243  * It is assumed that frames that were sent on this NIC don't returned as new
2244  * received frames (loopback). Since only the payload is given to this
2245  * function, it check for loopback.
2246  */
2247 static int bond_3ad_rx_indication(struct lacpdu *lacpdu, struct slave *slave,
2248 				  u16 length)
2249 {
2250 	struct port *port;
2251 	int ret = RX_HANDLER_ANOTHER;
2252 
2253 	if (length >= sizeof(struct lacpdu)) {
2254 
2255 		port = &(SLAVE_AD_INFO(slave)->port);
2256 
2257 		if (!port->slave) {
2258 			net_warn_ratelimited("%s: Warning: port of slave %s is uninitialized\n",
2259 					     slave->dev->name, slave->bond->dev->name);
2260 			return ret;
2261 		}
2262 
2263 		switch (lacpdu->subtype) {
2264 		case AD_TYPE_LACPDU:
2265 			ret = RX_HANDLER_CONSUMED;
2266 			netdev_dbg(slave->bond->dev,
2267 				   "Received LACPDU on port %d slave %s\n",
2268 				   port->actor_port_number,
2269 				   slave->dev->name);
2270 			/* Protect against concurrent state machines */
2271 			spin_lock(&slave->bond->mode_lock);
2272 			ad_rx_machine(lacpdu, port);
2273 			spin_unlock(&slave->bond->mode_lock);
2274 			break;
2275 
2276 		case AD_TYPE_MARKER:
2277 			ret = RX_HANDLER_CONSUMED;
2278 			/* No need to convert fields to Little Endian since we
2279 			 * don't use the marker's fields.
2280 			 */
2281 
2282 			switch (((struct bond_marker *)lacpdu)->tlv_type) {
2283 			case AD_MARKER_INFORMATION_SUBTYPE:
2284 				netdev_dbg(slave->bond->dev, "Received Marker Information on port %d\n",
2285 					   port->actor_port_number);
2286 				ad_marker_info_received((struct bond_marker *)lacpdu, port);
2287 				break;
2288 
2289 			case AD_MARKER_RESPONSE_SUBTYPE:
2290 				netdev_dbg(slave->bond->dev, "Received Marker Response on port %d\n",
2291 					   port->actor_port_number);
2292 				ad_marker_response_received((struct bond_marker *)lacpdu, port);
2293 				break;
2294 
2295 			default:
2296 				netdev_dbg(slave->bond->dev, "Received an unknown Marker subtype on slot %d\n",
2297 					   port->actor_port_number);
2298 			}
2299 		}
2300 	}
2301 	return ret;
2302 }
2303 
2304 /**
2305  * ad_update_actor_keys - Update the oper / admin keys for a port based on
2306  * its current speed and duplex settings.
2307  *
2308  * @port: the port we'are looking at
2309  * @reset: Boolean to just reset the speed and the duplex part of the key
2310  *
2311  * The logic to change the oper / admin keys is:
2312  * (a) A full duplex port can participate in LACP with partner.
2313  * (b) When the speed is changed, LACP need to be reinitiated.
2314  */
2315 static void ad_update_actor_keys(struct port *port, bool reset)
2316 {
2317 	u8 duplex = 0;
2318 	u16 ospeed = 0, speed = 0;
2319 	u16 old_oper_key = port->actor_oper_port_key;
2320 
2321 	port->actor_admin_port_key &= ~(AD_SPEED_KEY_MASKS|AD_DUPLEX_KEY_MASKS);
2322 	if (!reset) {
2323 		speed = __get_link_speed(port);
2324 		ospeed = (old_oper_key & AD_SPEED_KEY_MASKS) >> 1;
2325 		duplex = __get_duplex(port);
2326 		port->actor_admin_port_key |= (speed << 1) | duplex;
2327 	}
2328 	port->actor_oper_port_key = port->actor_admin_port_key;
2329 
2330 	if (old_oper_key != port->actor_oper_port_key) {
2331 		/* Only 'duplex' port participates in LACP */
2332 		if (duplex)
2333 			port->sm_vars |= AD_PORT_LACP_ENABLED;
2334 		else
2335 			port->sm_vars &= ~AD_PORT_LACP_ENABLED;
2336 
2337 		if (!reset) {
2338 			if (!speed) {
2339 				netdev_err(port->slave->dev,
2340 					   "speed changed to 0 for port %s",
2341 					   port->slave->dev->name);
2342 			} else if (duplex && ospeed != speed) {
2343 				/* Speed change restarts LACP state-machine */
2344 				port->sm_vars |= AD_PORT_BEGIN;
2345 			}
2346 		}
2347 	}
2348 }
2349 
2350 /**
2351  * bond_3ad_adapter_speed_duplex_changed - handle a slave's speed / duplex
2352  * change indication
2353  *
2354  * @slave: slave struct to work on
2355  *
2356  * Handle reselection of aggregator (if needed) for this port.
2357  */
2358 void bond_3ad_adapter_speed_duplex_changed(struct slave *slave)
2359 {
2360 	struct port *port;
2361 
2362 	port = &(SLAVE_AD_INFO(slave)->port);
2363 
2364 	/* if slave is null, the whole port is not initialized */
2365 	if (!port->slave) {
2366 		netdev_warn(slave->bond->dev,
2367 			    "speed/duplex changed for uninitialized port %s\n",
2368 			    slave->dev->name);
2369 		return;
2370 	}
2371 
2372 	spin_lock_bh(&slave->bond->mode_lock);
2373 	ad_update_actor_keys(port, false);
2374 	netdev_dbg(slave->bond->dev, "Port %d slave %s changed speed/duplex\n",
2375 		   port->actor_port_number, slave->dev->name);
2376 	spin_unlock_bh(&slave->bond->mode_lock);
2377 }
2378 
2379 /**
2380  * bond_3ad_handle_link_change - handle a slave's link status change indication
2381  * @slave: slave struct to work on
2382  * @status: whether the link is now up or down
2383  *
2384  * Handle reselection of aggregator (if needed) for this port.
2385  */
2386 void bond_3ad_handle_link_change(struct slave *slave, char link)
2387 {
2388 	struct port *port;
2389 
2390 	port = &(SLAVE_AD_INFO(slave)->port);
2391 
2392 	/* if slave is null, the whole port is not initialized */
2393 	if (!port->slave) {
2394 		netdev_warn(slave->bond->dev, "link status changed for uninitialized port on %s\n",
2395 			    slave->dev->name);
2396 		return;
2397 	}
2398 
2399 	spin_lock_bh(&slave->bond->mode_lock);
2400 	/* on link down we are zeroing duplex and speed since
2401 	 * some of the adaptors(ce1000.lan) report full duplex/speed
2402 	 * instead of N/A(duplex) / 0(speed).
2403 	 *
2404 	 * on link up we are forcing recheck on the duplex and speed since
2405 	 * some of he adaptors(ce1000.lan) report.
2406 	 */
2407 	if (link == BOND_LINK_UP) {
2408 		port->is_enabled = true;
2409 		ad_update_actor_keys(port, false);
2410 	} else {
2411 		/* link has failed */
2412 		port->is_enabled = false;
2413 		ad_update_actor_keys(port, true);
2414 	}
2415 	netdev_dbg(slave->bond->dev, "Port %d changed link status to %s\n",
2416 		   port->actor_port_number,
2417 		   link == BOND_LINK_UP ? "UP" : "DOWN");
2418 
2419 	spin_unlock_bh(&slave->bond->mode_lock);
2420 
2421 	/* RTNL is held and mode_lock is released so it's safe
2422 	 * to update slave_array here.
2423 	 */
2424 	bond_update_slave_arr(slave->bond, NULL);
2425 }
2426 
2427 /**
2428  * bond_3ad_set_carrier - set link state for bonding master
2429  * @bond - bonding structure
2430  *
2431  * if we have an active aggregator, we're up, if not, we're down.
2432  * Presumes that we cannot have an active aggregator if there are
2433  * no slaves with link up.
2434  *
2435  * This behavior complies with IEEE 802.3 section 43.3.9.
2436  *
2437  * Called by bond_set_carrier(). Return zero if carrier state does not
2438  * change, nonzero if it does.
2439  */
2440 int bond_3ad_set_carrier(struct bonding *bond)
2441 {
2442 	struct aggregator *active;
2443 	struct slave *first_slave;
2444 	int ret = 1;
2445 
2446 	rcu_read_lock();
2447 	first_slave = bond_first_slave_rcu(bond);
2448 	if (!first_slave) {
2449 		ret = 0;
2450 		goto out;
2451 	}
2452 	active = __get_active_agg(&(SLAVE_AD_INFO(first_slave)->aggregator));
2453 	if (active) {
2454 		/* are enough slaves available to consider link up? */
2455 		if (active->num_of_ports < bond->params.min_links) {
2456 			if (netif_carrier_ok(bond->dev)) {
2457 				netif_carrier_off(bond->dev);
2458 				goto out;
2459 			}
2460 		} else if (!netif_carrier_ok(bond->dev)) {
2461 			netif_carrier_on(bond->dev);
2462 			goto out;
2463 		}
2464 	} else if (netif_carrier_ok(bond->dev)) {
2465 		netif_carrier_off(bond->dev);
2466 	}
2467 out:
2468 	rcu_read_unlock();
2469 	return ret;
2470 }
2471 
2472 /**
2473  * __bond_3ad_get_active_agg_info - get information of the active aggregator
2474  * @bond: bonding struct to work on
2475  * @ad_info: ad_info struct to fill with the bond's info
2476  *
2477  * Returns:   0 on success
2478  *          < 0 on error
2479  */
2480 int __bond_3ad_get_active_agg_info(struct bonding *bond,
2481 				   struct ad_info *ad_info)
2482 {
2483 	struct aggregator *aggregator = NULL;
2484 	struct list_head *iter;
2485 	struct slave *slave;
2486 	struct port *port;
2487 
2488 	bond_for_each_slave_rcu(bond, slave, iter) {
2489 		port = &(SLAVE_AD_INFO(slave)->port);
2490 		if (port->aggregator && port->aggregator->is_active) {
2491 			aggregator = port->aggregator;
2492 			break;
2493 		}
2494 	}
2495 
2496 	if (!aggregator)
2497 		return -1;
2498 
2499 	ad_info->aggregator_id = aggregator->aggregator_identifier;
2500 	ad_info->ports = aggregator->num_of_ports;
2501 	ad_info->actor_key = aggregator->actor_oper_aggregator_key;
2502 	ad_info->partner_key = aggregator->partner_oper_aggregator_key;
2503 	ether_addr_copy(ad_info->partner_system,
2504 			aggregator->partner_system.mac_addr_value);
2505 	return 0;
2506 }
2507 
2508 int bond_3ad_get_active_agg_info(struct bonding *bond, struct ad_info *ad_info)
2509 {
2510 	int ret;
2511 
2512 	rcu_read_lock();
2513 	ret = __bond_3ad_get_active_agg_info(bond, ad_info);
2514 	rcu_read_unlock();
2515 
2516 	return ret;
2517 }
2518 
2519 int bond_3ad_lacpdu_recv(const struct sk_buff *skb, struct bonding *bond,
2520 			 struct slave *slave)
2521 {
2522 	struct lacpdu *lacpdu, _lacpdu;
2523 
2524 	if (skb->protocol != PKT_TYPE_LACPDU)
2525 		return RX_HANDLER_ANOTHER;
2526 
2527 	if (!MAC_ADDRESS_EQUAL(eth_hdr(skb)->h_dest, lacpdu_mcast_addr))
2528 		return RX_HANDLER_ANOTHER;
2529 
2530 	lacpdu = skb_header_pointer(skb, 0, sizeof(_lacpdu), &_lacpdu);
2531 	if (!lacpdu)
2532 		return RX_HANDLER_ANOTHER;
2533 
2534 	return bond_3ad_rx_indication(lacpdu, slave, skb->len);
2535 }
2536 
2537 /**
2538  * bond_3ad_update_lacp_rate - change the lacp rate
2539  * @bond - bonding struct
2540  *
2541  * When modify lacp_rate parameter via sysfs,
2542  * update actor_oper_port_state of each port.
2543  *
2544  * Hold bond->mode_lock,
2545  * so we can modify port->actor_oper_port_state,
2546  * no matter bond is up or down.
2547  */
2548 void bond_3ad_update_lacp_rate(struct bonding *bond)
2549 {
2550 	struct port *port = NULL;
2551 	struct list_head *iter;
2552 	struct slave *slave;
2553 	int lacp_fast;
2554 
2555 	lacp_fast = bond->params.lacp_fast;
2556 	spin_lock_bh(&bond->mode_lock);
2557 	bond_for_each_slave(bond, slave, iter) {
2558 		port = &(SLAVE_AD_INFO(slave)->port);
2559 		if (lacp_fast)
2560 			port->actor_oper_port_state |= AD_STATE_LACP_TIMEOUT;
2561 		else
2562 			port->actor_oper_port_state &= ~AD_STATE_LACP_TIMEOUT;
2563 	}
2564 	spin_unlock_bh(&bond->mode_lock);
2565 }
2566