include/net/bond_alb.h

   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
   6  * Free Software Foundation; either version 2 of the License, or
   7  * (at your option) any later version.
   8  *
   9  * This program is distributed in the hope that it will be useful, but
  10  * WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
  11  * or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  12  * for more details.
  13  *
  14  * You should have received a copy of the GNU General Public License along
  15  * with this program; if not, see <http://www.gnu.org/licenses/>.
  16  *
  17  * The full GNU General Public License is included in this distribution in the
  18  * file called LICENSE.
  19  *
  20  */
  21
  22 #ifndef _NET_BOND_ALB_H
  23 #define _NET_BOND_ALB_H
  24
  25 #include <linux/if_ether.h>
  26
  27 struct bonding;
  28 struct slave;
  29
  30 #define BOND_ALB_INFO(bond)   ((bond)->alb_info)
  31 #define SLAVE_TLB_INFO(slave) ((slave)->tlb_info)
  32
  33 #define ALB_TIMER_TICKS_PER_SEC     10  /* should be a divisor of HZ */
  34 #define BOND_TLB_REBALANCE_INTERVAL 10  /* In seconds, periodic re-balancing.
  35                                          * Used for division - never set
  36                                          * to zero !!!
  37                                          */
  38 #define BOND_ALB_DEFAULT_LP_INTERVAL 1
  39 #define BOND_ALB_LP_INTERVAL(bond) (bond->params.lp_interval)   /* In seconds, periodic send of
  40                                                                  * learning packets to the switch
  41                                                                  */
  42
  43 #define BOND_TLB_REBALANCE_TICKS (BOND_TLB_REBALANCE_INTERVAL \
  44                                   * ALB_TIMER_TICKS_PER_SEC)
  45
  46 #define BOND_ALB_LP_TICKS(bond) (BOND_ALB_LP_INTERVAL(bond) \
  47                            * ALB_TIMER_TICKS_PER_SEC)
  48
  49 #define TLB_HASH_TABLE_SIZE 256 /* The size of the clients hash table.
  50                                  * Note that this value MUST NOT be smaller
  51                                  * because the key hash table is BYTE wide !
  52                                  */
  53
  54
  55 #define TLB_NULL_INDEX          0xffffffff
  56
  57 /* rlb defs */
  58 #define RLB_HASH_TABLE_SIZE     256
  59 #define RLB_NULL_INDEX          0xffffffff
  60 #define RLB_UPDATE_DELAY        (2*ALB_TIMER_TICKS_PER_SEC) /* 2 seconds */
  61 #define RLB_ARP_BURST_SIZE      2
  62 #define RLB_UPDATE_RETRY        3 /* 3-ticks - must be smaller than the rlb
  63                                    * rebalance interval (5 min).
  64                                    */
  65 /* RLB_PROMISC_TIMEOUT = 10 sec equals the time that the current slave is
  66  * promiscuous after failover
  67  */
  68 #define RLB_PROMISC_TIMEOUT     (10*ALB_TIMER_TICKS_PER_SEC)
  69
  70
  71 struct tlb_client_info {
  72         struct slave *tx_slave; /* A pointer to slave used for transmiting
  73                                  * packets to a Client that the Hash function
  74                                  * gave this entry index.
  75                                  */
  76         u32 tx_bytes;           /* Each Client accumulates the BytesTx that
  77                                  * were transmitted to it, and after each
  78                                  * CallBack the LoadHistory is divided
  79                                  * by the balance interval
  80                                  */
  81         u32 load_history;       /* This field contains the amount of Bytes
  82                                  * that were transmitted to this client by
  83                                  * the server on the previous balance
  84                                  * interval in Bps.
  85                                  */
  86         u32 next;               /* The next Hash table entry index, assigned
  87                                  * to use the same adapter for transmit.
  88                                  */
  89         u32 prev;               /* The previous Hash table entry index,
  90                                  * assigned to use the same
  91                                  */
  92 };
  93
  94 /* -------------------------------------------------------------------------
  95  * struct rlb_client_info contains all info related to a specific rx client
  96  * connection. This is the Clients Hash Table entry struct.
  97  * Note that this is not a proper hash table; if a new client's IP address
  98  * hash collides with an existing client entry, the old entry is replaced.
  99  *
 100  * There is a linked list (linked by the used_next and used_prev members)
 101  * linking all the used entries of the hash table. This allows updating
 102  * all the clients without walking over all the unused elements of the table.
 103  *
 104  * There are also linked lists of entries with identical hash(ip_src). These
 105  * allow cleaning up the table from ip_src<->mac_src associations that have
 106  * become outdated and would cause sending out invalid ARP updates to the
 107  * network. These are linked by the (src_next and src_prev members).
 108  * -------------------------------------------------------------------------
 109  */
 110 struct rlb_client_info {
 111         __be32 ip_src;          /* the server IP address */
 112         __be32 ip_dst;          /* the client IP address */
 113         u8  mac_src[ETH_ALEN];  /* the server MAC address */
 114         u8  mac_dst[ETH_ALEN];  /* the client MAC address */
 115
 116         /* list of used hash table entries, starting at rx_hashtbl_used_head */
 117         u32 used_next;
 118         u32 used_prev;
 119
 120         /* ip_src based hashing */
 121         u32 src_next;   /* next entry with same hash(ip_src) */
 122         u32 src_prev;   /* prev entry with same hash(ip_src) */
 123         u32 src_first;  /* first entry with hash(ip_src) == this entry's index */
 124
 125         u8  assigned;           /* checking whether this entry is assigned */
 126         u8  ntt;                /* flag - need to transmit client info */
 127         struct slave *slave;    /* the slave assigned to this client */
 128         unsigned short vlan_id; /* VLAN tag associated with IP address */
 129 };
 130
 131 struct tlb_slave_info {
 132         u32 head;       /* Index to the head of the bi-directional clients
 133                          * hash table entries list. The entries in the list
 134                          * are the entries that were assigned to use this
 135                          * slave for transmit.
 136                          */
 137         u32 load;       /* Each slave sums the loadHistory of all clients
 138                          * assigned to it
 139                          */
 140 };
 141
 142 struct alb_bond_info {
 143         struct tlb_client_info  *tx_hashtbl; /* Dynamically allocated */
 144         u32                     unbalanced_load;
 145         int                     tx_rebalance_counter;
 146         int                     lp_counter;
 147         /* -------- rlb parameters -------- */
 148         int rlb_enabled;
 149         struct rlb_client_info  *rx_hashtbl;    /* Receive hash table */
 150         u32                     rx_hashtbl_used_head;
 151         u8                      rx_ntt; /* flag - need to transmit
 152                                          * to all rx clients
 153                                          */
 154         struct slave            *rx_slave;/* last slave to xmit from */
 155         u8                      primary_is_promisc;        /* boolean */
 156         u32                     rlb_promisc_timeout_counter;/* counts primary
 157                                                              * promiscuity time
 158                                                              */
 159         u32                     rlb_update_delay_counter;
 160         u32                     rlb_update_retry_counter;/* counter of retries
 161                                                           * of client update
 162                                                           */
 163         u8                      rlb_rebalance;  /* flag - indicates that the
 164                                                  * rx traffic should be
 165                                                  * rebalanced
 166                                                  */
 167 };
 168
 169 int bond_alb_initialize(struct bonding *bond, int rlb_enabled);
 170 void bond_alb_deinitialize(struct bonding *bond);
 171 int bond_alb_init_slave(struct bonding *bond, struct slave *slave);
 172 void bond_alb_deinit_slave(struct bonding *bond, struct slave *slave);
 173 void bond_alb_handle_link_change(struct bonding *bond, struct slave *slave, char link);
 174 void bond_alb_handle_active_change(struct bonding *bond, struct slave *new_slave);
 175 int bond_alb_xmit(struct sk_buff *skb, struct net_device *bond_dev);
 176 int bond_tlb_xmit(struct sk_buff *skb, struct net_device *bond_dev);
 177 void bond_alb_monitor(struct work_struct *);
 178 int bond_alb_set_mac_address(struct net_device *bond_dev, void *addr);
 179 void bond_alb_clear_vlan(struct bonding *bond, unsigned short vlan_id);
 180 #endif /* _NET_BOND_ALB_H */
 181