Linux Audio

Check our new training course

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