Linux Audio

Check our new training course

Yocto / OpenEmbedded training

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