Linux Audio

Check our new training course

Open-source upstreaming

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