2
0
mirror of https://github.com/openvswitch/ovs synced 2025-10-15 14:17:18 +00:00
Files
openvswitch/lib/lacp.c
Jarno Rajahalme 74ff3298c8 userspace: Define and use struct eth_addr.
Define struct eth_addr and use it instead of a uint8_t array for all
ethernet addresses in OVS userspace.  The struct is always the right
size, and it can be assigned without an explicit memcpy, which makes
code more readable.

"struct eth_addr" is a good type name for this as many utility
functions are already named accordingly.

struct eth_addr can be accessed as bytes as well as ovs_be16's, which
makes the struct 16-bit aligned.  All use seems to be 16-bit aligned,
so some algorithms on the ethernet addresses can be made a bit more
efficient making use of this fact.

As the struct fits into a register (in 64-bit systems) we pass it by
value when possible.

This patch also changes the few uses of Linux specific ETH_ALEN to
OVS's own ETH_ADDR_LEN, and removes the OFP_ETH_ALEN, as it is no
longer needed.

This work stemmed from a desire to make all struct flow members
assignable for unrelated exploration purposes.  However, I think this
might be a nice code readability improvement by itself.

Signed-off-by: Jarno Rajahalme <jrajahalme@nicira.com>
2015-08-28 14:55:11 -07:00

1039 lines
30 KiB
C
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

/* Copyright (c) 2011, 2012, 2013, 2014, 2015 Nicira, Inc.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at:
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
#include <config.h>
#include "lacp.h"
#include <stdlib.h>
#include "connectivity.h"
#include "dynamic-string.h"
#include "hash.h"
#include "hmap.h"
#include "dp-packet.h"
#include "ovs-atomic.h"
#include "packets.h"
#include "poll-loop.h"
#include "seq.h"
#include "shash.h"
#include "timer.h"
#include "timeval.h"
#include "unixctl.h"
#include "openvswitch/vlog.h"
VLOG_DEFINE_THIS_MODULE(lacp);
/* Masks for lacp_info state member. */
#define LACP_STATE_ACT 0x01 /* Activity. Active or passive? */
#define LACP_STATE_TIME 0x02 /* Timeout. Short or long timeout? */
#define LACP_STATE_AGG 0x04 /* Aggregation. Is the link is bondable? */
#define LACP_STATE_SYNC 0x08 /* Synchronization. Is the link in up to date? */
#define LACP_STATE_COL 0x10 /* Collecting. Is the link receiving frames? */
#define LACP_STATE_DIST 0x20 /* Distributing. Is the link sending frames? */
#define LACP_STATE_DEF 0x40 /* Defaulted. Using default partner info? */
#define LACP_STATE_EXP 0x80 /* Expired. Using expired partner info? */
#define LACP_FAST_TIME_TX 1000 /* Fast transmission rate. */
#define LACP_SLOW_TIME_TX 30000 /* Slow transmission rate. */
#define LACP_RX_MULTIPLIER 3 /* Multiply by TX rate to get RX rate. */
#define LACP_INFO_LEN 15
OVS_PACKED(
struct lacp_info {
ovs_be16 sys_priority; /* System priority. */
struct eth_addr sys_id; /* System ID. */
ovs_be16 key; /* Operational key. */
ovs_be16 port_priority; /* Port priority. */
ovs_be16 port_id; /* Port ID. */
uint8_t state; /* State mask. See LACP_STATE macros. */
});
BUILD_ASSERT_DECL(LACP_INFO_LEN == sizeof(struct lacp_info));
#define LACP_PDU_LEN 110
struct lacp_pdu {
uint8_t subtype; /* Always 1. */
uint8_t version; /* Always 1. */
uint8_t actor_type; /* Always 1. */
uint8_t actor_len; /* Always 20. */
struct lacp_info actor; /* LACP actor information. */
uint8_t z1[3]; /* Reserved. Always 0. */
uint8_t partner_type; /* Always 2. */
uint8_t partner_len; /* Always 20. */
struct lacp_info partner; /* LACP partner information. */
uint8_t z2[3]; /* Reserved. Always 0. */
uint8_t collector_type; /* Always 3. */
uint8_t collector_len; /* Always 16. */
ovs_be16 collector_delay; /* Maximum collector delay. Set to UINT16_MAX. */
uint8_t z3[64]; /* Combination of several fields. Always 0. */
};
BUILD_ASSERT_DECL(LACP_PDU_LEN == sizeof(struct lacp_pdu));
/* Implementation. */
enum slave_status {
LACP_CURRENT, /* Current State. Partner up to date. */
LACP_EXPIRED, /* Expired State. Partner out of date. */
LACP_DEFAULTED, /* Defaulted State. No partner. */
};
struct lacp {
struct ovs_list node; /* Node in all_lacps list. */
char *name; /* Name of this lacp object. */
struct eth_addr sys_id; /* System ID. */
uint16_t sys_priority; /* System Priority. */
bool active; /* Active or Passive. */
struct hmap slaves; /* Slaves this LACP object controls. */
struct slave *key_slave; /* Slave whose ID will be the aggregation key. */
bool fast; /* True if using fast probe interval. */
bool negotiated; /* True if LACP negotiations were successful. */
bool update; /* True if lacp_update() needs to be called. */
bool fallback_ab; /* True if fallback to active-backup on LACP failure. */
struct ovs_refcount ref_cnt;
};
struct slave {
void *aux; /* Handle used to identify this slave. */
struct hmap_node node; /* Node in master's slaves map. */
struct lacp *lacp; /* LACP object containing this slave. */
uint16_t port_id; /* Port ID. */
uint16_t port_priority; /* Port Priority. */
uint16_t key; /* Aggregation Key. 0 if default. */
char *name; /* Name of this slave. */
enum slave_status status; /* Slave status. */
bool attached; /* Attached. Traffic may flow. */
struct lacp_info partner; /* Partner information. */
struct lacp_info ntt_actor; /* Used to decide if we Need To Transmit. */
struct timer tx; /* Next message transmission timer. */
struct timer rx; /* Expected message receive timer. */
uint32_t count_rx_pdus; /* dot3adAggPortStatsLACPDUsRx */
uint32_t count_rx_pdus_bad; /* dot3adAggPortStatsIllegalRx */
uint32_t count_tx_pdus; /* dot3adAggPortStatsLACPDUsTx */
};
static struct ovs_mutex mutex;
static struct ovs_list all_lacps__ = OVS_LIST_INITIALIZER(&all_lacps__);
static struct ovs_list *const all_lacps OVS_GUARDED_BY(mutex) = &all_lacps__;
static void lacp_update_attached(struct lacp *) OVS_REQUIRES(mutex);
static void slave_destroy(struct slave *) OVS_REQUIRES(mutex);
static void slave_set_defaulted(struct slave *) OVS_REQUIRES(mutex);
static void slave_set_expired(struct slave *) OVS_REQUIRES(mutex);
static void slave_get_actor(struct slave *, struct lacp_info *actor)
OVS_REQUIRES(mutex);
static void slave_get_priority(struct slave *, struct lacp_info *priority)
OVS_REQUIRES(mutex);
static bool slave_may_tx(const struct slave *)
OVS_REQUIRES(mutex);
static struct slave *slave_lookup(const struct lacp *, const void *slave)
OVS_REQUIRES(mutex);
static bool info_tx_equal(struct lacp_info *, struct lacp_info *)
OVS_REQUIRES(mutex);
static unixctl_cb_func lacp_unixctl_show;
/* Populates 'pdu' with a LACP PDU comprised of 'actor' and 'partner'. */
static void
compose_lacp_pdu(const struct lacp_info *actor,
const struct lacp_info *partner, struct lacp_pdu *pdu)
{
memset(pdu, 0, sizeof *pdu);
pdu->subtype = 1;
pdu->version = 1;
pdu->actor_type = 1;
pdu->actor_len = 20;
pdu->actor = *actor;
pdu->partner_type = 2;
pdu->partner_len = 20;
pdu->partner = *partner;
pdu->collector_type = 3;
pdu->collector_len = 16;
pdu->collector_delay = htons(0);
}
/* Parses 'b' which represents a packet containing a LACP PDU. This function
* returns NULL if 'b' is malformed, or does not represent a LACP PDU format
* supported by OVS. Otherwise, it returns a pointer to the lacp_pdu contained
* within 'b'. */
static const struct lacp_pdu *
parse_lacp_packet(const struct dp_packet *p)
{
const struct lacp_pdu *pdu;
pdu = dp_packet_at(p, (uint8_t *)dp_packet_l3(p) - (uint8_t *)dp_packet_data(p),
LACP_PDU_LEN);
if (pdu && pdu->subtype == 1
&& pdu->actor_type == 1 && pdu->actor_len == 20
&& pdu->partner_type == 2 && pdu->partner_len == 20) {
return pdu;
} else {
return NULL;
}
}
/* LACP Protocol Implementation. */
/* Initializes the lacp module. */
void
lacp_init(void)
{
unixctl_command_register("lacp/show", "[port]", 0, 1,
lacp_unixctl_show, NULL);
}
static void
lacp_lock(void) OVS_ACQUIRES(mutex)
{
static struct ovsthread_once once = OVSTHREAD_ONCE_INITIALIZER;
if (ovsthread_once_start(&once)) {
ovs_mutex_init_recursive(&mutex);
ovsthread_once_done(&once);
}
ovs_mutex_lock(&mutex);
}
static void
lacp_unlock(void) OVS_RELEASES(mutex)
{
ovs_mutex_unlock(&mutex);
}
/* Creates a LACP object. */
struct lacp *
lacp_create(void) OVS_EXCLUDED(mutex)
{
struct lacp *lacp;
lacp = xzalloc(sizeof *lacp);
hmap_init(&lacp->slaves);
ovs_refcount_init(&lacp->ref_cnt);
lacp_lock();
list_push_back(all_lacps, &lacp->node);
lacp_unlock();
return lacp;
}
struct lacp *
lacp_ref(const struct lacp *lacp_)
{
struct lacp *lacp = CONST_CAST(struct lacp *, lacp_);
if (lacp) {
ovs_refcount_ref(&lacp->ref_cnt);
}
return lacp;
}
/* Destroys 'lacp' and its slaves. Does nothing if 'lacp' is NULL. */
void
lacp_unref(struct lacp *lacp) OVS_EXCLUDED(mutex)
{
if (lacp && ovs_refcount_unref_relaxed(&lacp->ref_cnt) == 1) {
struct slave *slave, *next;
lacp_lock();
HMAP_FOR_EACH_SAFE (slave, next, node, &lacp->slaves) {
slave_destroy(slave);
}
hmap_destroy(&lacp->slaves);
list_remove(&lacp->node);
free(lacp->name);
free(lacp);
lacp_unlock();
}
}
/* Configures 'lacp' with settings from 's'. */
void
lacp_configure(struct lacp *lacp, const struct lacp_settings *s)
OVS_EXCLUDED(mutex)
{
ovs_assert(!eth_addr_is_zero(s->id));
lacp_lock();
if (!lacp->name || strcmp(s->name, lacp->name)) {
free(lacp->name);
lacp->name = xstrdup(s->name);
}
if (!eth_addr_equals(lacp->sys_id, s->id)
|| lacp->sys_priority != s->priority) {
lacp->sys_id = s->id;
lacp->sys_priority = s->priority;
lacp->update = true;
}
lacp->active = s->active;
lacp->fast = s->fast;
if (lacp->fallback_ab != s->fallback_ab_cfg) {
lacp->fallback_ab = s->fallback_ab_cfg;
lacp->update = true;
}
lacp_unlock();
}
/* Returns true if 'lacp' is configured in active mode, false if 'lacp' is
* configured for passive mode. */
bool
lacp_is_active(const struct lacp *lacp) OVS_EXCLUDED(mutex)
{
bool ret;
lacp_lock();
ret = lacp->active;
lacp_unlock();
return ret;
}
/* Processes 'packet' which was received on 'slave_'. This function should be
* called on all packets received on 'slave_' with Ethernet Type ETH_TYPE_LACP.
*/
void
lacp_process_packet(struct lacp *lacp, const void *slave_,
const struct dp_packet *packet)
OVS_EXCLUDED(mutex)
{
static struct vlog_rate_limit rl = VLOG_RATE_LIMIT_INIT(1, 5);
const struct lacp_pdu *pdu;
long long int tx_rate;
struct slave *slave;
lacp_lock();
slave = slave_lookup(lacp, slave_);
if (!slave) {
goto out;
}
slave->count_rx_pdus++;
pdu = parse_lacp_packet(packet);
if (!pdu) {
slave->count_rx_pdus_bad++;
VLOG_WARN_RL(&rl, "%s: received an unparsable LACP PDU.", lacp->name);
goto out;
}
slave->status = LACP_CURRENT;
tx_rate = lacp->fast ? LACP_FAST_TIME_TX : LACP_SLOW_TIME_TX;
timer_set_duration(&slave->rx, LACP_RX_MULTIPLIER * tx_rate);
slave->ntt_actor = pdu->partner;
/* Update our information about our partner if it's out of date. This may
* cause priorities to change so re-calculate attached status of all
* slaves. */
if (memcmp(&slave->partner, &pdu->actor, sizeof pdu->actor)) {
lacp->update = true;
slave->partner = pdu->actor;
}
out:
lacp_unlock();
}
/* Returns the lacp_status of the given 'lacp' object (which may be NULL). */
enum lacp_status
lacp_status(const struct lacp *lacp) OVS_EXCLUDED(mutex)
{
if (lacp) {
enum lacp_status ret;
lacp_lock();
ret = lacp->negotiated ? LACP_NEGOTIATED : LACP_CONFIGURED;
lacp_unlock();
return ret;
} else {
/* Don't take 'mutex'. It might not even be initialized, since we
* don't know that any lacp object has been created. */
return LACP_DISABLED;
}
}
/* Registers 'slave_' as subordinate to 'lacp'. This should be called at least
* once per slave in a LACP managed bond. Should also be called whenever a
* slave's settings change. */
void
lacp_slave_register(struct lacp *lacp, void *slave_,
const struct lacp_slave_settings *s)
OVS_EXCLUDED(mutex)
{
struct slave *slave;
lacp_lock();
slave = slave_lookup(lacp, slave_);
if (!slave) {
slave = xzalloc(sizeof *slave);
slave->lacp = lacp;
slave->aux = slave_;
hmap_insert(&lacp->slaves, &slave->node, hash_pointer(slave_, 0));
slave_set_defaulted(slave);
if (!lacp->key_slave) {
lacp->key_slave = slave;
}
}
if (!slave->name || strcmp(s->name, slave->name)) {
free(slave->name);
slave->name = xstrdup(s->name);
}
if (slave->port_id != s->id
|| slave->port_priority != s->priority
|| slave->key != s->key) {
slave->port_id = s->id;
slave->port_priority = s->priority;
slave->key = s->key;
lacp->update = true;
if (lacp->active || lacp->negotiated) {
slave_set_expired(slave);
}
}
lacp_unlock();
}
/* Unregisters 'slave_' with 'lacp'. */
void
lacp_slave_unregister(struct lacp *lacp, const void *slave_)
OVS_EXCLUDED(mutex)
{
struct slave *slave;
lacp_lock();
slave = slave_lookup(lacp, slave_);
if (slave) {
slave_destroy(slave);
lacp->update = true;
}
lacp_unlock();
}
/* This function should be called whenever the carrier status of 'slave_' has
* changed. If 'lacp' is null, this function has no effect.*/
void
lacp_slave_carrier_changed(const struct lacp *lacp, const void *slave_)
OVS_EXCLUDED(mutex)
{
struct slave *slave;
if (!lacp) {
return;
}
lacp_lock();
slave = slave_lookup(lacp, slave_);
if (!slave) {
goto out;
}
if (slave->status == LACP_CURRENT || slave->lacp->active) {
slave_set_expired(slave);
}
out:
lacp_unlock();
}
static bool
slave_may_enable__(struct slave *slave) OVS_REQUIRES(mutex)
{
/* The slave may be enabled if it's attached to an aggregator and its
* partner is synchronized.*/
return slave->attached && (slave->partner.state & LACP_STATE_SYNC
|| (slave->lacp && slave->lacp->fallback_ab
&& slave->status == LACP_DEFAULTED));
}
/* This function should be called before enabling 'slave_' to send or receive
* traffic. If it returns false, 'slave_' should not enabled. As a
* convenience, returns true if 'lacp' is NULL. */
bool
lacp_slave_may_enable(const struct lacp *lacp, const void *slave_)
OVS_EXCLUDED(mutex)
{
if (lacp) {
struct slave *slave;
bool ret;
lacp_lock();
slave = slave_lookup(lacp, slave_);
ret = slave ? slave_may_enable__(slave) : false;
lacp_unlock();
return ret;
} else {
return true;
}
}
/* Returns true if partner information on 'slave_' is up to date. 'slave_'
* not being current, generally indicates a connectivity problem, or a
* misconfigured (or broken) partner. */
bool
lacp_slave_is_current(const struct lacp *lacp, const void *slave_)
OVS_EXCLUDED(mutex)
{
struct slave *slave;
bool ret;
lacp_lock();
slave = slave_lookup(lacp, slave_);
ret = slave ? slave->status != LACP_DEFAULTED : false;
lacp_unlock();
return ret;
}
/* This function should be called periodically to update 'lacp'. */
void
lacp_run(struct lacp *lacp, lacp_send_pdu *send_pdu) OVS_EXCLUDED(mutex)
{
struct slave *slave;
lacp_lock();
HMAP_FOR_EACH (slave, node, &lacp->slaves) {
if (timer_expired(&slave->rx)) {
enum slave_status old_status = slave->status;
if (slave->status == LACP_CURRENT) {
slave_set_expired(slave);
} else if (slave->status == LACP_EXPIRED) {
slave_set_defaulted(slave);
}
if (slave->status != old_status) {
seq_change(connectivity_seq_get());
}
}
}
if (lacp->update) {
lacp_update_attached(lacp);
}
HMAP_FOR_EACH (slave, node, &lacp->slaves) {
struct lacp_info actor;
if (!slave_may_tx(slave)) {
continue;
}
slave_get_actor(slave, &actor);
if (timer_expired(&slave->tx)
|| !info_tx_equal(&actor, &slave->ntt_actor)) {
long long int duration;
struct lacp_pdu pdu;
slave->ntt_actor = actor;
compose_lacp_pdu(&actor, &slave->partner, &pdu);
send_pdu(slave->aux, &pdu, sizeof pdu);
slave->count_tx_pdus++;
duration = (slave->partner.state & LACP_STATE_TIME
? LACP_FAST_TIME_TX
: LACP_SLOW_TIME_TX);
timer_set_duration(&slave->tx, duration);
seq_change(connectivity_seq_get());
}
}
lacp_unlock();
}
/* Causes poll_block() to wake up when lacp_run() needs to be called again. */
void
lacp_wait(struct lacp *lacp) OVS_EXCLUDED(mutex)
{
struct slave *slave;
lacp_lock();
HMAP_FOR_EACH (slave, node, &lacp->slaves) {
if (slave_may_tx(slave)) {
timer_wait(&slave->tx);
}
if (slave->status != LACP_DEFAULTED) {
timer_wait(&slave->rx);
}
}
lacp_unlock();
}
/* Static Helpers. */
/* Updates the attached status of all slaves controlled by 'lacp' and sets its
* negotiated parameter to true if any slaves are attachable. */
static void
lacp_update_attached(struct lacp *lacp) OVS_REQUIRES(mutex)
{
struct slave *lead, *slave;
struct lacp_info lead_pri;
static struct vlog_rate_limit rl = VLOG_RATE_LIMIT_INIT(1, 10);
lacp->update = false;
lead = NULL;
HMAP_FOR_EACH (slave, node, &lacp->slaves) {
struct lacp_info pri;
slave->attached = false;
/* XXX: In the future allow users to configure the expected system ID.
* For now just special case loopback. */
if (eth_addr_equals(slave->partner.sys_id, slave->lacp->sys_id)) {
VLOG_WARN_RL(&rl, "slave %s: Loopback detected. Slave is "
"connected to its own bond", slave->name);
continue;
}
if (slave->status == LACP_DEFAULTED) {
if (lacp->fallback_ab) {
slave->attached = true;
}
continue;
}
slave->attached = true;
slave_get_priority(slave, &pri);
if (!lead || memcmp(&pri, &lead_pri, sizeof pri) < 0) {
lead = slave;
lead_pri = pri;
}
}
lacp->negotiated = lead != NULL;
if (lead) {
HMAP_FOR_EACH (slave, node, &lacp->slaves) {
if ((lacp->fallback_ab && slave->status == LACP_DEFAULTED)
|| lead->partner.key != slave->partner.key
|| !eth_addr_equals(lead->partner.sys_id,
slave->partner.sys_id)) {
slave->attached = false;
}
}
}
}
static void
slave_destroy(struct slave *slave) OVS_REQUIRES(mutex)
{
if (slave) {
struct lacp *lacp = slave->lacp;
lacp->update = true;
hmap_remove(&lacp->slaves, &slave->node);
if (lacp->key_slave == slave) {
struct hmap_node *slave_node = hmap_first(&lacp->slaves);
if (slave_node) {
lacp->key_slave = CONTAINER_OF(slave_node, struct slave, node);
} else {
lacp->key_slave = NULL;
}
}
free(slave->name);
free(slave);
}
}
static void
slave_set_defaulted(struct slave *slave) OVS_REQUIRES(mutex)
{
memset(&slave->partner, 0, sizeof slave->partner);
slave->lacp->update = true;
slave->status = LACP_DEFAULTED;
}
static void
slave_set_expired(struct slave *slave) OVS_REQUIRES(mutex)
{
slave->status = LACP_EXPIRED;
slave->partner.state |= LACP_STATE_TIME;
slave->partner.state &= ~LACP_STATE_SYNC;
timer_set_duration(&slave->rx, LACP_RX_MULTIPLIER * LACP_FAST_TIME_TX);
}
static void
slave_get_actor(struct slave *slave, struct lacp_info *actor)
OVS_REQUIRES(mutex)
{
struct lacp *lacp = slave->lacp;
uint16_t key;
uint8_t state = 0;
if (lacp->active) {
state |= LACP_STATE_ACT;
}
if (lacp->fast) {
state |= LACP_STATE_TIME;
}
if (slave->attached) {
state |= LACP_STATE_SYNC;
}
if (slave->status == LACP_DEFAULTED) {
state |= LACP_STATE_DEF;
}
if (slave->status == LACP_EXPIRED) {
state |= LACP_STATE_EXP;
}
if (hmap_count(&lacp->slaves) > 1) {
state |= LACP_STATE_AGG;
}
if (slave->attached || !lacp->negotiated) {
state |= LACP_STATE_COL | LACP_STATE_DIST;
}
key = lacp->key_slave->key;
if (!key) {
key = lacp->key_slave->port_id;
}
actor->state = state;
actor->key = htons(key);
actor->port_priority = htons(slave->port_priority);
actor->port_id = htons(slave->port_id);
actor->sys_priority = htons(lacp->sys_priority);
actor->sys_id = lacp->sys_id;
}
/* Given 'slave', populates 'priority' with data representing its LACP link
* priority. If two priority objects populated by this function are compared
* using memcmp, the higher priority link will be less than the lower priority
* link. */
static void
slave_get_priority(struct slave *slave, struct lacp_info *priority)
OVS_REQUIRES(mutex)
{
uint16_t partner_priority, actor_priority;
/* Choose the lacp_info of the higher priority system by comparing their
* system priorities and mac addresses. */
actor_priority = slave->lacp->sys_priority;
partner_priority = ntohs(slave->partner.sys_priority);
if (actor_priority < partner_priority) {
slave_get_actor(slave, priority);
} else if (partner_priority < actor_priority) {
*priority = slave->partner;
} else if (eth_addr_compare_3way(slave->lacp->sys_id,
slave->partner.sys_id) < 0) {
slave_get_actor(slave, priority);
} else {
*priority = slave->partner;
}
/* Key and state are not used in priority comparisons. */
priority->key = 0;
priority->state = 0;
}
static bool
slave_may_tx(const struct slave *slave) OVS_REQUIRES(mutex)
{
return slave->lacp->active || slave->status != LACP_DEFAULTED;
}
static struct slave *
slave_lookup(const struct lacp *lacp, const void *slave_) OVS_REQUIRES(mutex)
{
struct slave *slave;
HMAP_FOR_EACH_IN_BUCKET (slave, node, hash_pointer(slave_, 0),
&lacp->slaves) {
if (slave->aux == slave_) {
return slave;
}
}
return NULL;
}
/* Two lacp_info structures are tx_equal if and only if they do not differ in
* ways which would require a lacp_pdu transmission. */
static bool
info_tx_equal(struct lacp_info *a, struct lacp_info *b)
{
/* LACP specification dictates that we transmit whenever the actor and
* remote_actor differ in the following fields: Port, Port Priority,
* System, System Priority, Aggregation Key, Activity State, Timeout State,
* Sync State, and Aggregation State. The state flags are most likely to
* change so are checked first. */
return !((a->state ^ b->state) & (LACP_STATE_ACT
| LACP_STATE_TIME
| LACP_STATE_SYNC
| LACP_STATE_AGG))
&& a->port_id == b->port_id
&& a->port_priority == b->port_priority
&& a->key == b->key
&& a->sys_priority == b->sys_priority
&& eth_addr_equals(a->sys_id, b->sys_id);
}
static struct lacp *
lacp_find(const char *name) OVS_REQUIRES(mutex)
{
struct lacp *lacp;
LIST_FOR_EACH (lacp, node, all_lacps) {
if (!strcmp(lacp->name, name)) {
return lacp;
}
}
return NULL;
}
static void
ds_put_lacp_state(struct ds *ds, uint8_t state)
{
if (state & LACP_STATE_ACT) {
ds_put_cstr(ds, " activity");
}
if (state & LACP_STATE_TIME) {
ds_put_cstr(ds, " timeout");
}
if (state & LACP_STATE_AGG) {
ds_put_cstr(ds, " aggregation");
}
if (state & LACP_STATE_SYNC) {
ds_put_cstr(ds, " synchronized");
}
if (state & LACP_STATE_COL) {
ds_put_cstr(ds, " collecting");
}
if (state & LACP_STATE_DIST) {
ds_put_cstr(ds, " distributing");
}
if (state & LACP_STATE_DEF) {
ds_put_cstr(ds, " defaulted");
}
if (state & LACP_STATE_EXP) {
ds_put_cstr(ds, " expired");
}
}
static void
lacp_print_details(struct ds *ds, struct lacp *lacp) OVS_REQUIRES(mutex)
{
struct shash slave_shash = SHASH_INITIALIZER(&slave_shash);
const struct shash_node **sorted_slaves = NULL;
struct slave *slave;
int i;
ds_put_format(ds, "---- %s ----\n", lacp->name);
ds_put_format(ds, "\tstatus: %s", lacp->active ? "active" : "passive");
if (lacp->negotiated) {
ds_put_cstr(ds, " negotiated");
}
ds_put_cstr(ds, "\n");
ds_put_format(ds, "\tsys_id: " ETH_ADDR_FMT "\n", ETH_ADDR_ARGS(lacp->sys_id));
ds_put_format(ds, "\tsys_priority: %u\n", lacp->sys_priority);
ds_put_cstr(ds, "\taggregation key: ");
if (lacp->key_slave) {
ds_put_format(ds, "%u", lacp->key_slave->key
? lacp->key_slave->key
: lacp->key_slave->port_id);
} else {
ds_put_cstr(ds, "none");
}
ds_put_cstr(ds, "\n");
ds_put_cstr(ds, "\tlacp_time: ");
if (lacp->fast) {
ds_put_cstr(ds, "fast\n");
} else {
ds_put_cstr(ds, "slow\n");
}
HMAP_FOR_EACH (slave, node, &lacp->slaves) {
shash_add(&slave_shash, slave->name, slave);
}
sorted_slaves = shash_sort(&slave_shash);
for (i = 0; i < shash_count(&slave_shash); i++) {
char *status;
struct lacp_info actor;
slave = sorted_slaves[i]->data;
slave_get_actor(slave, &actor);
switch (slave->status) {
case LACP_CURRENT:
status = "current";
break;
case LACP_EXPIRED:
status = "expired";
break;
case LACP_DEFAULTED:
status = "defaulted";
break;
default:
OVS_NOT_REACHED();
}
ds_put_format(ds, "\nslave: %s: %s %s\n", slave->name, status,
slave->attached ? "attached" : "detached");
ds_put_format(ds, "\tport_id: %u\n", slave->port_id);
ds_put_format(ds, "\tport_priority: %u\n", slave->port_priority);
ds_put_format(ds, "\tmay_enable: %s\n", (slave_may_enable__(slave)
? "true" : "false"));
ds_put_format(ds, "\n\tactor sys_id: " ETH_ADDR_FMT "\n",
ETH_ADDR_ARGS(actor.sys_id));
ds_put_format(ds, "\tactor sys_priority: %u\n",
ntohs(actor.sys_priority));
ds_put_format(ds, "\tactor port_id: %u\n",
ntohs(actor.port_id));
ds_put_format(ds, "\tactor port_priority: %u\n",
ntohs(actor.port_priority));
ds_put_format(ds, "\tactor key: %u\n",
ntohs(actor.key));
ds_put_cstr(ds, "\tactor state:");
ds_put_lacp_state(ds, actor.state);
ds_put_cstr(ds, "\n\n");
ds_put_format(ds, "\tpartner sys_id: " ETH_ADDR_FMT "\n",
ETH_ADDR_ARGS(slave->partner.sys_id));
ds_put_format(ds, "\tpartner sys_priority: %u\n",
ntohs(slave->partner.sys_priority));
ds_put_format(ds, "\tpartner port_id: %u\n",
ntohs(slave->partner.port_id));
ds_put_format(ds, "\tpartner port_priority: %u\n",
ntohs(slave->partner.port_priority));
ds_put_format(ds, "\tpartner key: %u\n",
ntohs(slave->partner.key));
ds_put_cstr(ds, "\tpartner state:");
ds_put_lacp_state(ds, slave->partner.state);
ds_put_cstr(ds, "\n");
}
shash_destroy(&slave_shash);
free(sorted_slaves);
}
static void
lacp_unixctl_show(struct unixctl_conn *conn, int argc, const char *argv[],
void *aux OVS_UNUSED) OVS_EXCLUDED(mutex)
{
struct ds ds = DS_EMPTY_INITIALIZER;
struct lacp *lacp;
lacp_lock();
if (argc > 1) {
lacp = lacp_find(argv[1]);
if (!lacp) {
unixctl_command_reply_error(conn, "no such lacp object");
goto out;
}
lacp_print_details(&ds, lacp);
} else {
LIST_FOR_EACH (lacp, node, all_lacps) {
lacp_print_details(&ds, lacp);
}
}
unixctl_command_reply(conn, ds_cstr(&ds));
ds_destroy(&ds);
out:
lacp_unlock();
}
/* Extract a snapshot of the current state and counters for a slave port.
Return false if the slave is not active. */
bool
lacp_get_slave_stats(const struct lacp *lacp, const void *slave_, struct lacp_slave_stats *stats)
OVS_EXCLUDED(mutex)
{
struct slave *slave;
struct lacp_info actor;
bool ret;
ovs_mutex_lock(&mutex);
slave = slave_lookup(lacp, slave_);
if (slave) {
ret = true;
slave_get_actor(slave, &actor);
stats->dot3adAggPortActorSystemID = actor.sys_id;
stats->dot3adAggPortPartnerOperSystemID = slave->partner.sys_id;
stats->dot3adAggPortAttachedAggID = (lacp->key_slave->key ?
lacp->key_slave->key :
lacp->key_slave->port_id);
/* Construct my admin-state. Assume aggregation is configured on. */
stats->dot3adAggPortActorAdminState = LACP_STATE_AGG;
if (lacp->active) {
stats->dot3adAggPortActorAdminState |= LACP_STATE_ACT;
}
if (lacp->fast) {
stats->dot3adAggPortActorAdminState |= LACP_STATE_TIME;
}
/* XXX Not sure how to know the partner admin state. It
* might have to be captured and remembered during the
* negotiation phase.
*/
stats->dot3adAggPortPartnerAdminState = 0;
stats->dot3adAggPortActorOperState = actor.state;
stats->dot3adAggPortPartnerOperState = slave->partner.state;
/* Read out the latest counters */
stats->dot3adAggPortStatsLACPDUsRx = slave->count_rx_pdus;
stats->dot3adAggPortStatsIllegalRx = slave->count_rx_pdus_bad;
stats->dot3adAggPortStatsLACPDUsTx = slave->count_tx_pdus;
} else {
ret = false;
}
ovs_mutex_unlock(&mutex);
return ret;
}