mirror of
https://github.com/openvswitch/ovs
synced 2025-10-25 15:07:05 +00:00
74ff3298c8
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>
127 lines
4.6 KiB
C
127 lines
4.6 KiB
C
/*
|
|
* Copyright (c) 2008, 2009, 2010, 2011, 2014 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.
|
|
*/
|
|
|
|
#ifndef BOND_H
|
|
#define BOND_H 1
|
|
|
|
#include <stdbool.h>
|
|
#include <stdint.h>
|
|
#include "ofproto-provider.h"
|
|
#include "packets.h"
|
|
|
|
struct flow;
|
|
struct netdev;
|
|
struct ofpbuf;
|
|
struct ofproto_dpif;
|
|
enum lacp_status;
|
|
|
|
/* How flows are balanced among bond slaves. */
|
|
enum bond_mode {
|
|
BM_TCP, /* Transport Layer Load Balance. */
|
|
BM_SLB, /* Source Load Balance. */
|
|
BM_AB /* Active Backup. */
|
|
};
|
|
|
|
bool bond_mode_from_string(enum bond_mode *, const char *);
|
|
const char *bond_mode_to_string(enum bond_mode);
|
|
|
|
/* Configuration for a bond as a whole. */
|
|
struct bond_settings {
|
|
char *name; /* Bond's name, for log messages. */
|
|
uint32_t basis; /* Flow hashing basis. */
|
|
|
|
/* Balancing configuration. */
|
|
enum bond_mode balance;
|
|
int rebalance_interval; /* Milliseconds between rebalances.
|
|
Zero to disable rebalancing. */
|
|
|
|
/* Link status detection. */
|
|
int up_delay; /* ms before enabling an up slave. */
|
|
int down_delay; /* ms before disabling a down slave. */
|
|
|
|
bool lacp_fallback_ab_cfg; /* Fallback to active-backup on LACP failure. */
|
|
|
|
struct eth_addr active_slave_mac;
|
|
/* The MAC address of the interface
|
|
that was active during the last
|
|
ovs run. */
|
|
};
|
|
|
|
/* Program startup. */
|
|
void bond_init(void);
|
|
|
|
/* Basics. */
|
|
struct bond *bond_create(const struct bond_settings *,
|
|
struct ofproto_dpif *ofproto);
|
|
void bond_unref(struct bond *);
|
|
struct bond *bond_ref(const struct bond *);
|
|
|
|
bool bond_reconfigure(struct bond *, const struct bond_settings *);
|
|
void bond_slave_register(struct bond *, void *slave_, ofp_port_t ofport, struct netdev *);
|
|
void bond_slave_set_netdev(struct bond *, void *slave_, struct netdev *);
|
|
void bond_slave_unregister(struct bond *, const void *slave);
|
|
|
|
bool bond_run(struct bond *, enum lacp_status);
|
|
void bond_wait(struct bond *);
|
|
|
|
void bond_slave_set_may_enable(struct bond *, void *slave_, bool may_enable);
|
|
|
|
/* Special MAC learning support for SLB bonding. */
|
|
bool bond_should_send_learning_packets(struct bond *);
|
|
struct dp_packet *bond_compose_learning_packet(struct bond *,
|
|
const struct eth_addr eth_src,
|
|
uint16_t vlan, void **port_aux);
|
|
bool bond_get_changed_active_slave(const char *name, struct eth_addr *mac,
|
|
bool force);
|
|
|
|
/* Packet processing. */
|
|
enum bond_verdict {
|
|
BV_ACCEPT, /* Accept this packet. */
|
|
BV_DROP, /* Drop this packet. */
|
|
BV_DROP_IF_MOVED /* Drop if we've learned a different port. */
|
|
};
|
|
enum bond_verdict bond_check_admissibility(struct bond *, const void *slave_,
|
|
const struct eth_addr dst);
|
|
void *bond_choose_output_slave(struct bond *, const struct flow *,
|
|
struct flow_wildcards *, uint16_t vlan);
|
|
|
|
/* Rebalancing. */
|
|
void bond_account(struct bond *, const struct flow *, uint16_t vlan,
|
|
uint64_t n_bytes);
|
|
void bond_rebalance(struct bond *);
|
|
|
|
/* Recirculation
|
|
*
|
|
* Only balance_tcp mode uses recirculation.
|
|
*
|
|
* When recirculation is used, each bond port is assigned with a unique
|
|
* recirc_id. The output action to the bond port will be replaced by
|
|
* a Hash action, followed by a RECIRC action.
|
|
*
|
|
* ... actions= ... HASH(hash(L4)), RECIRC(recirc_id) ....
|
|
*
|
|
* On handling first output packet, 256 post recirculation flows are installed:
|
|
*
|
|
* recirc_id=<bond_recirc_id>, dp_hash=<[0..255]>/0xff, actions: output<slave>
|
|
*
|
|
* Bond module pulls stats from those post recirculation rules. If rebalancing
|
|
* is needed, those rules are updated with new output actions.
|
|
*/
|
|
void bond_update_post_recirc_rules(struct bond *, const bool force);
|
|
bool bond_may_recirc(const struct bond *, uint32_t *recirc_id,
|
|
uint32_t *hash_bias);
|
|
#endif /* bond.h */
|