2 * Copyright(c) 1999 - 2004 Intel Corporation. All rights reserved.
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.
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
14 * You should have received a copy of the GNU General Public License along
15 * with this program; if not, write to the Free Software Foundation, Inc.,
16 * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
18 * The full GNU General Public License is included in this distribution in the
19 * file called LICENSE.
23 #ifndef __BOND_ALB_H__
24 #define __BOND_ALB_H__
26 #include <linux/if_ether.h>
31 #define BOND_ALB_INFO(bond) ((bond)->alb_info)
32 #define SLAVE_TLB_INFO(slave) ((slave)->tlb_info)
34 #define ALB_TIMER_TICKS_PER_SEC 10 /* should be a divisor of HZ */
35 #define BOND_TLB_REBALANCE_INTERVAL 10 /* In seconds, periodic re-balancing.
36 * Used for division - never set
39 #define BOND_ALB_LP_INTERVAL 1 /* In seconds, periodic send of
40 * learning packets to the switch
43 #define BOND_TLB_REBALANCE_TICKS (BOND_TLB_REBALANCE_INTERVAL \
44 * ALB_TIMER_TICKS_PER_SEC)
46 #define BOND_ALB_LP_TICKS (BOND_ALB_LP_INTERVAL \
47 * ALB_TIMER_TICKS_PER_SEC)
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 !
55 #define TLB_NULL_INDEX 0xffffffff
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).
65 /* RLB_PROMISC_TIMEOUT = 10 sec equals the time that the current slave is
66 * promiscuous after failover
68 #define RLB_PROMISC_TIMEOUT (10*ALB_TIMER_TICKS_PER_SEC)
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.
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
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
86 u32 next; /* The next Hash table entry index, assigned
87 * to use the same adapter for transmit.
89 u32 prev; /* The previous Hash table entry index,
90 * assigned to use the same
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.
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.
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 * -------------------------------------------------------------------------
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 */
116 /* list of used hash table entries, starting at rx_hashtbl_used_head */
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 */
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 */
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.
137 u32 load; /* Each slave sums the loadHistory of all clients
142 struct alb_bond_info {
143 struct tlb_client_info *tx_hashtbl; /* Dynamically allocated */
144 spinlock_t tx_hashtbl_lock;
146 int tx_rebalance_counter;
148 /* -------- rlb parameters -------- */
150 struct rlb_client_info *rx_hashtbl; /* Receive hash table */
151 spinlock_t rx_hashtbl_lock;
152 u32 rx_hashtbl_used_head;
153 u8 rx_ntt; /* flag - need to transmit
156 struct slave *next_rx_slave;/* next slave to be assigned
157 * to a new rx client for
159 u8 primary_is_promisc; /* boolean */
160 u32 rlb_promisc_timeout_counter;/* counts primary
163 u32 rlb_update_delay_counter;
164 u32 rlb_update_retry_counter;/* counter of retries
167 u8 rlb_rebalance; /* flag - indicates that the
168 * rx traffic should be
173 int bond_alb_initialize(struct bonding *bond, int rlb_enabled);
174 void bond_alb_deinitialize(struct bonding *bond);
175 int bond_alb_init_slave(struct bonding *bond, struct slave *slave);
176 void bond_alb_deinit_slave(struct bonding *bond, struct slave *slave);
177 void bond_alb_handle_link_change(struct bonding *bond, struct slave *slave, char link);
178 void bond_alb_handle_active_change(struct bonding *bond, struct slave *new_slave);
179 int bond_alb_xmit(struct sk_buff *skb, struct net_device *bond_dev);
180 void bond_alb_monitor(struct work_struct *);
181 int bond_alb_set_mac_address(struct net_device *bond_dev, void *addr);
182 void bond_alb_clear_vlan(struct bonding *bond, unsigned short vlan_id);
183 #endif /* __BOND_ALB_H__ */