]>
Commit | Line | Data |
---|---|---|
f620b43a BP |
1 | /* |
2 | * Copyright (c) 2008, 2009, 2010, 2011 Nicira Networks. | |
3 | * | |
4 | * Licensed under the Apache License, Version 2.0 (the "License"); | |
5 | * you may not use this file except in compliance with the License. | |
6 | * You may obtain a copy of the License at: | |
7 | * | |
8 | * http://www.apache.org/licenses/LICENSE-2.0 | |
9 | * | |
10 | * Unless required by applicable law or agreed to in writing, software | |
11 | * distributed under the License is distributed on an "AS IS" BASIS, | |
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. | |
13 | * See the License for the specific language governing permissions and | |
14 | * limitations under the License. | |
15 | */ | |
16 | ||
17 | #include <config.h> | |
18 | ||
19 | #include "bond.h" | |
20 | ||
21 | #include <limits.h> | |
22 | #include <stdint.h> | |
23 | #include <stdlib.h> | |
24 | ||
25 | #include "coverage.h" | |
26 | #include "dynamic-string.h" | |
27 | #include "flow.h" | |
28 | #include "hmap.h" | |
f620b43a BP |
29 | #include "list.h" |
30 | #include "netdev.h" | |
31 | #include "odp-util.h" | |
32 | #include "ofpbuf.h" | |
33 | #include "packets.h" | |
34 | #include "poll-loop.h" | |
35 | #include "tag.h" | |
36 | #include "timeval.h" | |
37 | #include "unixctl.h" | |
38 | #include "vlog.h" | |
39 | ||
40 | VLOG_DEFINE_THIS_MODULE(bond); | |
41 | ||
f620b43a BP |
42 | /* Bit-mask for hashing a flow down to a bucket. |
43 | * There are (BOND_MASK + 1) buckets. */ | |
44 | #define BOND_MASK 0xff | |
45 | ||
46 | /* A hash bucket for mapping a flow to a slave. | |
47 | * "struct bond" has an array of (BOND_MASK + 1) of these. */ | |
48 | struct bond_entry { | |
49 | struct bond_slave *slave; /* Assigned slave, NULL if unassigned. */ | |
50 | uint64_t tx_bytes; /* Count of bytes recently transmitted. */ | |
51 | tag_type tag; /* Tag for entry<->slave association. */ | |
52 | struct list list_node; /* In bond_slave's 'entries' list. */ | |
53 | }; | |
54 | ||
55 | /* A bond slave, that is, one of the links comprising a bond. */ | |
56 | struct bond_slave { | |
57 | struct hmap_node hmap_node; /* In struct bond's slaves hmap. */ | |
58 | struct bond *bond; /* The bond that contains this slave. */ | |
59 | void *aux; /* Client-provided handle for this slave. */ | |
60 | ||
61 | struct netdev *netdev; /* Network device, owned by the client. */ | |
62 | char *name; /* Name (a copy of netdev_get_name(netdev)). */ | |
63 | ||
64 | /* Link status. */ | |
65 | long long delay_expires; /* Time after which 'enabled' may change. */ | |
66 | bool up; /* Last link status read from netdev. */ | |
67 | bool enabled; /* May be chosen for flows? */ | |
4d6fb5eb | 68 | bool lacp_may_enable; /* LACP considers this interface bondable. */ |
f620b43a BP |
69 | tag_type tag; /* Tag associated with this slave. */ |
70 | ||
71 | /* Rebalancing info. Used only by bond_rebalance(). */ | |
72 | struct list bal_node; /* In bond_rebalance()'s 'bals' list. */ | |
73 | struct list entries; /* 'struct bond_entry's assigned here. */ | |
74 | uint64_t tx_bytes; /* Sum across 'tx_bytes' of entries. */ | |
fb0b29a3 EJ |
75 | |
76 | /* BM_STABLE specific bonding info. */ | |
e1e90548 | 77 | uint16_t stb_id; /* ID used for 'stb_slaves' ordering. */ |
fb0b29a3 EJ |
78 | size_t stb_idx; /* Index in 'bond''s 'stb_slaves' array. |
79 | Undefined value if participating in a | |
80 | BTM_STABLE bond or not enabled. */ | |
f620b43a BP |
81 | }; |
82 | ||
83 | /* A bond, that is, a set of network devices grouped to improve performance or | |
84 | * robustness. */ | |
85 | struct bond { | |
86 | struct hmap_node hmap_node; /* In 'all_bonds' hmap. */ | |
87 | char *name; /* Name provided by client. */ | |
88 | ||
89 | /* Slaves. */ | |
90 | struct hmap slaves; | |
91 | ||
92 | /* Bonding info. */ | |
93 | enum bond_mode balance; /* Balancing mode, one of BM_*. */ | |
94 | struct bond_slave *active_slave; | |
95 | tag_type no_slaves_tag; /* Tag for flows when all slaves disabled. */ | |
96 | int updelay, downdelay; /* Delay before slave goes up/down, in ms. */ | |
4d6fb5eb | 97 | bool lacp_negotiated; /* LACP negotiations were successful. */ |
f620b43a BP |
98 | |
99 | /* SLB specific bonding info. */ | |
100 | struct bond_entry *hash; /* An array of (BOND_MASK + 1) elements. */ | |
101 | int rebalance_interval; /* Interval between rebalances, in ms. */ | |
102 | long long int next_rebalance; /* Next rebalancing time. */ | |
103 | bool send_learning_packets; | |
104 | ||
fb0b29a3 EJ |
105 | /* BM_STABLE specific bonding info. */ |
106 | struct bond_slave **stb_slaves; /* Ordered list of enabled slaves. */ | |
107 | size_t n_stb_slaves; /* Number of slaves in 'stb_slaves'. */ | |
108 | size_t len_stb_slaves; /* Slaves allocated in 'stb_slaves'. */ | |
109 | bool stb_need_sort; /* True if stb_slaves is not sorted. */ | |
8bb6f31d | 110 | tag_type stb_tag; /* Tag associated with this bond. */ |
f620b43a BP |
111 | |
112 | /* Monitoring. */ | |
113 | enum bond_detect_mode detect; /* Link status mode, one of BLSM_*. */ | |
114 | struct netdev_monitor *monitor; /* detect == BLSM_CARRIER only. */ | |
115 | long long int miimon_interval; /* Miimon status refresh interval. */ | |
116 | long long int miimon_next_update; /* Time of next miimon update. */ | |
117 | ||
118 | /* Legacy compatibility. */ | |
119 | long long int next_fake_iface_update; /* LLONG_MAX if disabled. */ | |
120 | ||
121 | /* Tag set saved for next bond_run(). This tag set is a kluge for cases | |
122 | * where we can't otherwise provide revalidation feedback to the client. | |
123 | * That's only unixctl commands now; I hope no other cases will arise. */ | |
124 | struct tag_set unixctl_tags; | |
125 | }; | |
126 | ||
127 | static struct hmap all_bonds = HMAP_INITIALIZER(&all_bonds); | |
128 | ||
95aafb2a | 129 | static void bond_entry_reset(struct bond *); |
f620b43a BP |
130 | static struct bond_slave *bond_slave_lookup(struct bond *, const void *slave_); |
131 | static bool bond_is_link_up(struct bond *, struct netdev *); | |
132 | static void bond_enable_slave(struct bond_slave *, bool enable, | |
133 | struct tag_set *); | |
fb0b29a3 EJ |
134 | static bool bond_stb_sort(struct bond *); |
135 | static void bond_stb_enable_slave(struct bond_slave *); | |
f620b43a BP |
136 | static void bond_link_status_update(struct bond_slave *, struct tag_set *); |
137 | static void bond_choose_active_slave(struct bond *, struct tag_set *); | |
138 | static bool bond_is_tcp_hash(const struct bond *); | |
139 | static unsigned int bond_hash_src(const uint8_t mac[ETH_ADDR_LEN], | |
140 | uint16_t vlan); | |
141 | static unsigned int bond_hash_tcp(const struct flow *, uint16_t vlan); | |
142 | static struct bond_entry *lookup_bond_entry(const struct bond *, | |
143 | const struct flow *, | |
144 | uint16_t vlan); | |
145 | static tag_type bond_get_active_slave_tag(const struct bond *); | |
146 | static struct bond_slave *choose_output_slave(const struct bond *, | |
147 | const struct flow *, | |
148 | uint16_t vlan); | |
149 | static void bond_update_fake_slave_stats(struct bond *); | |
150 | ||
151 | /* Attempts to parse 's' as the name of a bond balancing mode. If successful, | |
152 | * stores the mode in '*balance' and returns true. Otherwise returns false | |
153 | * without modifying '*balance'. */ | |
154 | bool | |
155 | bond_mode_from_string(enum bond_mode *balance, const char *s) | |
156 | { | |
157 | if (!strcmp(s, bond_mode_to_string(BM_TCP))) { | |
158 | *balance = BM_TCP; | |
159 | } else if (!strcmp(s, bond_mode_to_string(BM_SLB))) { | |
160 | *balance = BM_SLB; | |
fb0b29a3 EJ |
161 | } else if (!strcmp(s, bond_mode_to_string(BM_STABLE))) { |
162 | *balance = BM_STABLE; | |
f620b43a BP |
163 | } else if (!strcmp(s, bond_mode_to_string(BM_AB))) { |
164 | *balance = BM_AB; | |
165 | } else { | |
166 | return false; | |
167 | } | |
168 | return true; | |
169 | } | |
170 | ||
171 | /* Returns a string representing 'balance'. */ | |
172 | const char * | |
173 | bond_mode_to_string(enum bond_mode balance) { | |
174 | switch (balance) { | |
175 | case BM_TCP: | |
176 | return "balance-tcp"; | |
177 | case BM_SLB: | |
178 | return "balance-slb"; | |
fb0b29a3 EJ |
179 | case BM_STABLE: |
180 | return "stable"; | |
f620b43a BP |
181 | case BM_AB: |
182 | return "active-backup"; | |
183 | } | |
184 | NOT_REACHED(); | |
185 | } | |
186 | ||
187 | /* Attempts to parse 's' as the name of a bond link status detection mode. If | |
188 | * successful, stores the mode in '*detect' and returns true. Otherwise | |
189 | * returns false without modifying '*detect'. */ | |
190 | bool | |
191 | bond_detect_mode_from_string(enum bond_detect_mode *detect, const char *s) | |
192 | { | |
193 | if (!strcmp(s, bond_detect_mode_to_string(BLSM_CARRIER))) { | |
194 | *detect = BLSM_CARRIER; | |
195 | } else if (!strcmp(s, bond_detect_mode_to_string(BLSM_MIIMON))) { | |
196 | *detect = BLSM_MIIMON; | |
197 | } else { | |
198 | return false; | |
199 | } | |
200 | return true; | |
201 | } | |
202 | ||
203 | /* Returns a string representing 'detect'. */ | |
204 | const char * | |
205 | bond_detect_mode_to_string(enum bond_detect_mode detect) | |
206 | { | |
207 | switch (detect) { | |
208 | case BLSM_CARRIER: | |
209 | return "carrier"; | |
210 | case BLSM_MIIMON: | |
211 | return "miimon"; | |
212 | } | |
213 | NOT_REACHED(); | |
214 | } | |
215 | \f | |
216 | /* Creates and returns a new bond whose configuration is initially taken from | |
217 | * 's'. | |
218 | * | |
219 | * The caller should register each slave on the new bond by calling | |
220 | * bond_slave_register(). */ | |
221 | struct bond * | |
222 | bond_create(const struct bond_settings *s) | |
223 | { | |
224 | struct bond *bond; | |
225 | ||
226 | bond = xzalloc(sizeof *bond); | |
227 | hmap_init(&bond->slaves); | |
228 | bond->no_slaves_tag = tag_create_random(); | |
229 | bond->miimon_next_update = LLONG_MAX; | |
230 | bond->next_fake_iface_update = LLONG_MAX; | |
231 | ||
232 | bond_reconfigure(bond, s); | |
233 | ||
234 | tag_set_init(&bond->unixctl_tags); | |
235 | ||
236 | return bond; | |
237 | } | |
238 | ||
239 | /* Frees 'bond'. */ | |
240 | void | |
241 | bond_destroy(struct bond *bond) | |
242 | { | |
243 | struct bond_slave *slave, *next_slave; | |
244 | ||
245 | if (!bond) { | |
246 | return; | |
247 | } | |
248 | ||
249 | hmap_remove(&all_bonds, &bond->hmap_node); | |
250 | ||
251 | HMAP_FOR_EACH_SAFE (slave, next_slave, hmap_node, &bond->slaves) { | |
252 | hmap_remove(&bond->slaves, &slave->hmap_node); | |
253 | /* Client owns 'slave->netdev'. */ | |
254 | free(slave->name); | |
255 | free(slave); | |
256 | } | |
257 | hmap_destroy(&bond->slaves); | |
258 | ||
259 | free(bond->hash); | |
260 | ||
f620b43a BP |
261 | netdev_monitor_destroy(bond->monitor); |
262 | ||
263 | free(bond->name); | |
264 | free(bond); | |
265 | } | |
266 | ||
267 | /* Updates 'bond''s overall configuration to 's'. | |
268 | * | |
269 | * The caller should register each slave on 'bond' by calling | |
270 | * bond_slave_register(). This is optional if none of the slaves' | |
4d6fb5eb | 271 | * configuration has changed. In any case it can't hurt. |
59d7b2b6 EJ |
272 | * |
273 | * Returns true if the configuration has changed in such a way that requires | |
274 | * flow revalidation. | |
275 | * */ | |
276 | bool | |
f620b43a BP |
277 | bond_reconfigure(struct bond *bond, const struct bond_settings *s) |
278 | { | |
59d7b2b6 EJ |
279 | bool revalidate = false; |
280 | ||
f620b43a BP |
281 | if (!bond->name || strcmp(bond->name, s->name)) { |
282 | if (bond->name) { | |
283 | hmap_remove(&all_bonds, &bond->hmap_node); | |
284 | free(bond->name); | |
285 | } | |
286 | bond->name = xstrdup(s->name); | |
287 | hmap_insert(&all_bonds, &bond->hmap_node, hash_string(bond->name, 0)); | |
288 | } | |
289 | ||
f620b43a BP |
290 | bond->detect = s->detect; |
291 | bond->miimon_interval = s->miimon_interval; | |
292 | bond->updelay = s->up_delay; | |
293 | bond->downdelay = s->down_delay; | |
294 | bond->rebalance_interval = s->rebalance_interval; | |
295 | ||
59d7b2b6 EJ |
296 | if (bond->balance != s->balance) { |
297 | bond->balance = s->balance; | |
298 | revalidate = true; | |
299 | } | |
300 | ||
f620b43a BP |
301 | if (bond->detect == BLSM_CARRIER) { |
302 | struct bond_slave *slave; | |
303 | ||
304 | if (!bond->monitor) { | |
305 | bond->monitor = netdev_monitor_create(); | |
306 | } | |
307 | ||
308 | HMAP_FOR_EACH (slave, hmap_node, &bond->slaves) { | |
309 | netdev_monitor_add(bond->monitor, slave->netdev); | |
310 | } | |
311 | } else { | |
312 | netdev_monitor_destroy(bond->monitor); | |
313 | bond->monitor = NULL; | |
314 | ||
315 | if (bond->miimon_next_update == LLONG_MAX) { | |
316 | bond->miimon_next_update = time_msec() + bond->miimon_interval; | |
317 | } | |
318 | } | |
319 | ||
f620b43a BP |
320 | if (s->fake_iface) { |
321 | if (bond->next_fake_iface_update == LLONG_MAX) { | |
322 | bond->next_fake_iface_update = time_msec(); | |
323 | } | |
324 | } else { | |
325 | bond->next_fake_iface_update = LLONG_MAX; | |
326 | } | |
59d7b2b6 | 327 | |
fb0b29a3 EJ |
328 | if (bond->balance != BM_STABLE) { |
329 | free(bond->stb_slaves); | |
330 | bond->stb_slaves = NULL; | |
8bb6f31d EJ |
331 | bond->stb_tag = 0; |
332 | } else if (!bond->stb_tag) { | |
fb0b29a3 EJ |
333 | struct bond_slave *slave; |
334 | ||
8bb6f31d EJ |
335 | bond->stb_tag = tag_create_random(); |
336 | ||
337 | assert(!bond->stb_slaves); | |
fb0b29a3 EJ |
338 | bond->n_stb_slaves = 0; |
339 | bond->len_stb_slaves = 0; | |
340 | bond->stb_slaves = NULL; | |
341 | ||
342 | HMAP_FOR_EACH (slave, hmap_node, &bond->slaves) { | |
343 | if (slave->enabled) { | |
344 | bond_stb_enable_slave(slave); | |
345 | } | |
346 | } | |
347 | } | |
348 | ||
95aafb2a EJ |
349 | if (bond->balance == BM_AB || !bond->hash || revalidate) { |
350 | bond_entry_reset(bond); | |
351 | } | |
352 | ||
59d7b2b6 | 353 | return revalidate; |
f620b43a BP |
354 | } |
355 | ||
356 | /* Registers 'slave_' as a slave of 'bond'. The 'slave_' pointer is an | |
357 | * arbitrary client-provided pointer that uniquely identifies a slave within a | |
358 | * bond. If 'slave_' already exists within 'bond' then this function | |
359 | * reconfigures the existing slave. | |
360 | * | |
e1e90548 EJ |
361 | * 'stb_id' is used in BM_STABLE bonds to guarantee consistent slave choices |
362 | * across restarts and distributed vswitch instances. It should be unique per | |
363 | * slave, and preferably consistent across restarts and reconfigurations. | |
364 | * | |
f620b43a BP |
365 | * 'netdev' must be the network device that 'slave_' represents. It is owned |
366 | * by the client, so the client must not close it before either unregistering | |
367 | * 'slave_' or destroying 'bond'. | |
4d6fb5eb | 368 | */ |
f620b43a | 369 | void |
e1e90548 EJ |
370 | bond_slave_register(struct bond *bond, void *slave_, uint16_t stb_id, |
371 | struct netdev *netdev) | |
f620b43a BP |
372 | { |
373 | struct bond_slave *slave = bond_slave_lookup(bond, slave_); | |
374 | ||
375 | if (!slave) { | |
376 | slave = xzalloc(sizeof *slave); | |
377 | ||
378 | hmap_insert(&bond->slaves, &slave->hmap_node, hash_pointer(slave_, 0)); | |
379 | slave->bond = bond; | |
380 | slave->aux = slave_; | |
381 | slave->delay_expires = LLONG_MAX; | |
382 | slave->up = bond_is_link_up(bond, netdev); | |
244b2160 EJ |
383 | slave->name = xstrdup(netdev_get_name(netdev)); |
384 | ||
b3c18f66 EJ |
385 | slave->enabled = false; |
386 | bond_enable_slave(slave, slave->up, NULL); | |
f620b43a BP |
387 | } |
388 | ||
e1e90548 EJ |
389 | if (slave->stb_id != stb_id) { |
390 | bond->stb_need_sort = true; | |
391 | slave->stb_id = stb_id; | |
392 | } | |
393 | ||
f620b43a BP |
394 | slave->netdev = netdev; |
395 | free(slave->name); | |
396 | slave->name = xstrdup(netdev_get_name(netdev)); | |
f620b43a BP |
397 | } |
398 | ||
399 | /* Unregisters 'slave_' from 'bond'. If 'bond' does not contain such a slave | |
400 | * then this function has no effect. | |
401 | * | |
402 | * Unregistering a slave invalidates all flows. */ | |
403 | void | |
404 | bond_slave_unregister(struct bond *bond, const void *slave_) | |
405 | { | |
406 | struct bond_slave *slave = bond_slave_lookup(bond, slave_); | |
407 | bool del_active; | |
408 | ||
409 | if (!slave) { | |
410 | return; | |
411 | } | |
412 | ||
b3c18f66 EJ |
413 | bond_enable_slave(slave, false, NULL); |
414 | ||
f620b43a BP |
415 | del_active = bond->active_slave == slave; |
416 | if (bond->hash) { | |
417 | struct bond_entry *e; | |
418 | for (e = bond->hash; e <= &bond->hash[BOND_MASK]; e++) { | |
419 | if (e->slave == slave) { | |
420 | e->slave = NULL; | |
421 | } | |
422 | } | |
423 | } | |
424 | ||
425 | free(slave->name); | |
426 | ||
427 | hmap_remove(&bond->slaves, &slave->hmap_node); | |
428 | /* Client owns 'slave->netdev'. */ | |
429 | free(slave); | |
430 | ||
431 | if (del_active) { | |
432 | struct tag_set tags; | |
433 | ||
434 | tag_set_init(&tags); | |
435 | bond_choose_active_slave(bond, &tags); | |
436 | bond->send_learning_packets = true; | |
437 | } | |
438 | } | |
439 | ||
4d6fb5eb EJ |
440 | /* Should be called on each slave in 'bond' before bond_run() to indicate the |
441 | * results of lacp_slave_may_enable() on 'slave_'. */ | |
442 | void | |
443 | bond_slave_set_lacp_may_enable(struct bond *bond, void *slave_, | |
444 | bool may_enable) | |
445 | { | |
446 | bond_slave_lookup(bond, slave_)->lacp_may_enable = may_enable; | |
447 | } | |
448 | ||
f620b43a BP |
449 | /* Performs periodic maintenance on 'bond'. The caller must provide 'tags' to |
450 | * allow tagged flows to be invalidated. | |
451 | * | |
452 | * The caller should check bond_should_send_learning_packets() afterward. */ | |
453 | void | |
4d6fb5eb | 454 | bond_run(struct bond *bond, struct tag_set *tags, bool lacp_negotiated) |
f620b43a BP |
455 | { |
456 | struct bond_slave *slave; | |
dc9908b3 | 457 | bool is_tcp_hash = bond_is_tcp_hash(bond); |
f620b43a | 458 | |
4d6fb5eb EJ |
459 | bond->lacp_negotiated = lacp_negotiated; |
460 | ||
f620b43a BP |
461 | /* Update link status. */ |
462 | if (bond->detect == BLSM_CARRIER | |
463 | || time_msec() >= bond->miimon_next_update) | |
464 | { | |
465 | HMAP_FOR_EACH (slave, hmap_node, &bond->slaves) { | |
466 | slave->up = bond_is_link_up(bond, slave->netdev); | |
467 | } | |
468 | bond->miimon_next_update = time_msec() + bond->miimon_interval; | |
469 | } | |
470 | ||
f620b43a BP |
471 | /* Enable slaves based on link status and LACP feedback. */ |
472 | HMAP_FOR_EACH (slave, hmap_node, &bond->slaves) { | |
473 | bond_link_status_update(slave, tags); | |
474 | } | |
475 | if (!bond->active_slave || !bond->active_slave->enabled) { | |
476 | bond_choose_active_slave(bond, tags); | |
477 | } | |
478 | ||
479 | /* Update fake bond interface stats. */ | |
480 | if (time_msec() >= bond->next_fake_iface_update) { | |
481 | bond_update_fake_slave_stats(bond); | |
482 | bond->next_fake_iface_update = time_msec() + 1000; | |
483 | } | |
484 | ||
fb0b29a3 | 485 | if (bond_stb_sort(bond) || is_tcp_hash != bond_is_tcp_hash(bond)) { |
dc9908b3 | 486 | |
95aafb2a | 487 | bond_entry_reset(bond); |
8bb6f31d EJ |
488 | if (bond->balance != BM_STABLE) { |
489 | struct bond_slave *slave; | |
490 | ||
491 | HMAP_FOR_EACH (slave, hmap_node, &bond->slaves) { | |
492 | tag_set_add(tags, slave->tag); | |
493 | } | |
494 | } else { | |
495 | tag_set_add(tags, bond->stb_tag); | |
dc9908b3 | 496 | } |
0008fbcb | 497 | tag_set_add(tags, bond->no_slaves_tag); |
dc9908b3 EJ |
498 | } |
499 | ||
f620b43a BP |
500 | /* Invalidate any tags required by */ |
501 | tag_set_union(tags, &bond->unixctl_tags); | |
502 | tag_set_init(&bond->unixctl_tags); | |
503 | } | |
504 | ||
505 | /* Causes poll_block() to wake up when 'bond' needs something to be done. */ | |
506 | void | |
507 | bond_wait(struct bond *bond) | |
508 | { | |
509 | struct bond_slave *slave; | |
510 | ||
511 | if (bond->detect == BLSM_CARRIER) { | |
512 | netdev_monitor_poll_wait(bond->monitor); | |
513 | } else { | |
514 | poll_timer_wait_until(bond->miimon_next_update); | |
515 | } | |
516 | ||
517 | HMAP_FOR_EACH (slave, hmap_node, &bond->slaves) { | |
518 | if (slave->delay_expires != LLONG_MAX) { | |
519 | poll_timer_wait_until(slave->delay_expires); | |
520 | } | |
521 | } | |
522 | ||
523 | if (bond->next_fake_iface_update != LLONG_MAX) { | |
524 | poll_timer_wait_until(bond->next_fake_iface_update); | |
525 | } | |
526 | ||
527 | /* Ensure that any saved tags get revalidated right away. */ | |
528 | if (!tag_set_is_empty(&bond->unixctl_tags)) { | |
529 | poll_immediate_wake(); | |
530 | } | |
531 | ||
532 | /* We don't wait for bond->next_rebalance because rebalancing can only run | |
533 | * at a flow account checkpoint. ofproto does checkpointing on its own | |
534 | * schedule and bond_rebalance() gets called afterward, so we'd just be | |
535 | * waking up for no purpose. */ | |
536 | } | |
537 | \f | |
538 | /* MAC learning table interaction. */ | |
539 | ||
540 | static bool | |
541 | may_send_learning_packets(const struct bond *bond) | |
542 | { | |
4d6fb5eb | 543 | return !bond->lacp_negotiated && bond->balance != BM_AB; |
f620b43a BP |
544 | } |
545 | ||
546 | /* Returns true if 'bond' needs the client to send out packets to assist with | |
547 | * MAC learning on 'bond'. If this function returns true, then the client | |
548 | * should iterate through its MAC learning table for the bridge on which 'bond' | |
549 | * is located. For each MAC that has been learned on a port other than 'bond', | |
550 | * it should call bond_send_learning_packet(). | |
551 | * | |
552 | * This function will only return true if 'bond' is in SLB mode and LACP is not | |
553 | * negotiated. Otherwise sending learning packets isn't necessary. | |
554 | * | |
555 | * Calling this function resets the state that it checks. */ | |
556 | bool | |
557 | bond_should_send_learning_packets(struct bond *bond) | |
558 | { | |
559 | bool send = bond->send_learning_packets && may_send_learning_packets(bond); | |
560 | bond->send_learning_packets = false; | |
561 | return send; | |
562 | } | |
563 | ||
564 | /* Sends a gratuitous learning packet on 'bond' from 'eth_src' on 'vlan'. | |
565 | * | |
566 | * See bond_should_send_learning_packets() for description of usage. */ | |
567 | int | |
568 | bond_send_learning_packet(struct bond *bond, | |
569 | const uint8_t eth_src[ETH_ADDR_LEN], | |
570 | uint16_t vlan) | |
571 | { | |
572 | struct bond_slave *slave; | |
573 | struct ofpbuf packet; | |
574 | struct flow flow; | |
575 | int error; | |
576 | ||
577 | assert(may_send_learning_packets(bond)); | |
578 | if (!bond->active_slave) { | |
579 | /* Nowhere to send the learning packet. */ | |
580 | return 0; | |
581 | } | |
582 | ||
583 | memset(&flow, 0, sizeof flow); | |
584 | memcpy(flow.dl_src, eth_src, ETH_ADDR_LEN); | |
585 | slave = choose_output_slave(bond, &flow, vlan); | |
586 | ||
587 | ofpbuf_init(&packet, 0); | |
588 | compose_benign_packet(&packet, "Open vSwitch Bond Failover", 0xf177, | |
589 | eth_src); | |
590 | if (vlan) { | |
591 | eth_set_vlan_tci(&packet, htons(vlan)); | |
592 | } | |
593 | error = netdev_send(slave->netdev, &packet); | |
594 | ofpbuf_uninit(&packet); | |
595 | ||
596 | return error; | |
597 | } | |
598 | \f | |
599 | /* Checks whether a packet that arrived on 'slave_' within 'bond', with an | |
600 | * Ethernet destination address of 'eth_dst', should be admitted. | |
601 | * | |
602 | * The return value is one of the following: | |
603 | * | |
604 | * - BV_ACCEPT: Admit the packet. | |
605 | * | |
606 | * - BV_DROP: Drop the packet. | |
607 | * | |
608 | * - BV_DROP_IF_MOVED: Consult the MAC learning table for the packet's | |
609 | * Ethernet source address and VLAN. If there is none, or if the packet | |
610 | * is on the learned port, then admit the packet. If a different port has | |
611 | * been learned, however, drop the packet (and do not use it for MAC | |
612 | * learning). | |
613 | */ | |
614 | enum bond_verdict | |
615 | bond_check_admissibility(struct bond *bond, const void *slave_, | |
616 | const uint8_t eth_dst[ETH_ADDR_LEN], tag_type *tags) | |
617 | { | |
618 | /* Admit all packets if LACP has been negotiated, because that means that | |
619 | * the remote switch is aware of the bond and will "do the right thing". */ | |
4d6fb5eb | 620 | if (bond->lacp_negotiated) { |
f620b43a BP |
621 | return BV_ACCEPT; |
622 | } | |
623 | ||
624 | /* Drop all multicast packets on inactive slaves. */ | |
625 | if (eth_addr_is_multicast(eth_dst)) { | |
626 | *tags |= bond_get_active_slave_tag(bond); | |
627 | if (bond->active_slave != bond_slave_lookup(bond, slave_)) { | |
628 | return BV_DROP; | |
629 | } | |
630 | } | |
631 | ||
632 | /* Drop all packets for which we have learned a different input port, | |
633 | * because we probably sent the packet on one slave and got it back on the | |
634 | * other. Gratuitous ARP packets are an exception to this rule: the host | |
635 | * has moved to another switch. The exception to the exception is if we | |
636 | * locked the learning table to avoid reflections on bond slaves. */ | |
637 | return BV_DROP_IF_MOVED; | |
638 | } | |
639 | ||
640 | /* Returns the slave (registered on 'bond' by bond_slave_register()) to which | |
641 | * a packet with the given 'flow' and 'vlan' should be forwarded. Returns | |
642 | * NULL if the packet should be dropped because no slaves are enabled. | |
643 | * | |
644 | * 'vlan' is not necessarily the same as 'flow->vlan_tci'. First, 'vlan' | |
645 | * should be a VID only (i.e. excluding the PCP bits). Second, | |
646 | * 'flow->vlan_tci' is the VLAN TCI that appeared on the packet (so it will be | |
647 | * nonzero only for trunk ports), whereas 'vlan' is the logical VLAN that the | |
648 | * packet belongs to (so for an access port it will be the access port's VLAN). | |
649 | * | |
650 | * Adds a tag to '*tags' that associates the flow with the returned slave. | |
651 | */ | |
652 | void * | |
653 | bond_choose_output_slave(struct bond *bond, const struct flow *flow, | |
654 | uint16_t vlan, tag_type *tags) | |
655 | { | |
656 | struct bond_slave *slave = choose_output_slave(bond, flow, vlan); | |
657 | if (slave) { | |
8bb6f31d | 658 | *tags |= bond->balance == BM_STABLE ? bond->stb_tag : slave->tag; |
f620b43a BP |
659 | return slave->aux; |
660 | } else { | |
661 | *tags |= bond->no_slaves_tag; | |
662 | return NULL; | |
663 | } | |
664 | } | |
f620b43a BP |
665 | \f |
666 | /* Rebalancing. */ | |
667 | ||
1b137691 EJ |
668 | static bool |
669 | bond_is_balanced(const struct bond *bond) | |
670 | { | |
671 | return bond->balance == BM_SLB || bond->balance == BM_TCP; | |
672 | } | |
673 | ||
f620b43a BP |
674 | /* Notifies 'bond' that 'n_bytes' bytes were sent in 'flow' within 'vlan'. */ |
675 | void | |
676 | bond_account(struct bond *bond, const struct flow *flow, uint16_t vlan, | |
677 | uint64_t n_bytes) | |
678 | { | |
f620b43a | 679 | |
1b137691 | 680 | if (bond_is_balanced(bond)) { |
f620b43a | 681 | lookup_bond_entry(bond, flow, vlan)->tx_bytes += n_bytes; |
f620b43a BP |
682 | } |
683 | } | |
684 | ||
685 | static struct bond_slave * | |
686 | bond_slave_from_bal_node(struct list *bal) | |
687 | { | |
688 | return CONTAINER_OF(bal, struct bond_slave, bal_node); | |
689 | } | |
690 | ||
691 | static void | |
692 | log_bals(struct bond *bond, const struct list *bals) | |
693 | { | |
694 | if (VLOG_IS_DBG_ENABLED()) { | |
695 | struct ds ds = DS_EMPTY_INITIALIZER; | |
696 | const struct bond_slave *slave; | |
697 | ||
698 | LIST_FOR_EACH (slave, bal_node, bals) { | |
699 | if (ds.length) { | |
700 | ds_put_char(&ds, ','); | |
701 | } | |
702 | ds_put_format(&ds, " %s %"PRIu64"kB", | |
703 | slave->name, slave->tx_bytes / 1024); | |
704 | ||
705 | if (!slave->enabled) { | |
706 | ds_put_cstr(&ds, " (disabled)"); | |
707 | } | |
708 | if (!list_is_empty(&slave->entries)) { | |
709 | struct bond_entry *e; | |
710 | ||
711 | ds_put_cstr(&ds, " ("); | |
712 | LIST_FOR_EACH (e, list_node, &slave->entries) { | |
713 | if (&e->list_node != list_front(&slave->entries)) { | |
714 | ds_put_cstr(&ds, " + "); | |
715 | } | |
716 | ds_put_format(&ds, "h%td: %"PRIu64"kB", | |
717 | e - bond->hash, e->tx_bytes / 1024); | |
718 | } | |
719 | ds_put_cstr(&ds, ")"); | |
720 | } | |
721 | } | |
722 | VLOG_DBG("bond %s:%s", bond->name, ds_cstr(&ds)); | |
723 | ds_destroy(&ds); | |
724 | } | |
725 | } | |
726 | ||
727 | /* Shifts 'hash' from its current slave to 'to'. */ | |
728 | static void | |
729 | bond_shift_load(struct bond_entry *hash, struct bond_slave *to, | |
730 | struct tag_set *set) | |
731 | { | |
732 | struct bond_slave *from = hash->slave; | |
733 | struct bond *bond = from->bond; | |
734 | uint64_t delta = hash->tx_bytes; | |
735 | ||
736 | VLOG_INFO("bond %s: shift %"PRIu64"kB of load (with hash %td) " | |
737 | "from %s to %s (now carrying %"PRIu64"kB and " | |
738 | "%"PRIu64"kB load, respectively)", | |
739 | bond->name, delta / 1024, hash - bond->hash, | |
740 | from->name, to->name, | |
741 | (from->tx_bytes - delta) / 1024, | |
742 | (to->tx_bytes + delta) / 1024); | |
743 | ||
744 | /* Shift load away from 'from' to 'to'. */ | |
745 | from->tx_bytes -= delta; | |
746 | to->tx_bytes += delta; | |
747 | ||
748 | /* Arrange for flows to be revalidated. */ | |
749 | tag_set_add(set, hash->tag); | |
750 | hash->slave = to; | |
751 | hash->tag = tag_create_random(); | |
752 | } | |
753 | ||
754 | /* Pick and returns a bond_entry to migrate to 'to' (the least-loaded slave), | |
755 | * given that doing so must decrease the ratio of the load on the two slaves by | |
756 | * at least 0.1. Returns NULL if there is no appropriate entry. | |
757 | * | |
758 | * The list of entries isn't sorted. I don't know of a reason to prefer to | |
759 | * shift away small hashes or large hashes. */ | |
760 | static struct bond_entry * | |
761 | choose_entry_to_migrate(const struct bond_slave *from, uint64_t to_tx_bytes) | |
762 | { | |
763 | struct bond_entry *e; | |
764 | ||
765 | if (list_is_short(&from->entries)) { | |
766 | /* 'from' carries no more than one MAC hash, so shifting load away from | |
767 | * it would be pointless. */ | |
768 | return NULL; | |
769 | } | |
770 | ||
771 | LIST_FOR_EACH (e, list_node, &from->entries) { | |
772 | double old_ratio, new_ratio; | |
773 | uint64_t delta; | |
774 | ||
775 | if (to_tx_bytes == 0) { | |
776 | /* Nothing on the new slave, move it. */ | |
777 | return e; | |
778 | } | |
779 | ||
780 | delta = e->tx_bytes; | |
781 | old_ratio = (double)from->tx_bytes / to_tx_bytes; | |
782 | new_ratio = (double)(from->tx_bytes - delta) / (to_tx_bytes + delta); | |
783 | if (old_ratio - new_ratio > 0.1) { | |
784 | /* Would decrease the ratio, move it. */ | |
785 | return e; | |
786 | } | |
787 | } | |
788 | ||
789 | return NULL; | |
790 | } | |
791 | ||
792 | /* Inserts 'slave' into 'bals' so that descending order of 'tx_bytes' is | |
793 | * maintained. */ | |
794 | static void | |
795 | insert_bal(struct list *bals, struct bond_slave *slave) | |
796 | { | |
797 | struct bond_slave *pos; | |
798 | ||
799 | LIST_FOR_EACH (pos, bal_node, bals) { | |
800 | if (slave->tx_bytes > pos->tx_bytes) { | |
801 | break; | |
802 | } | |
803 | } | |
804 | list_insert(&pos->bal_node, &slave->bal_node); | |
805 | } | |
806 | ||
807 | /* Removes 'slave' from its current list and then inserts it into 'bals' so | |
808 | * that descending order of 'tx_bytes' is maintained. */ | |
809 | static void | |
810 | reinsert_bal(struct list *bals, struct bond_slave *slave) | |
811 | { | |
812 | list_remove(&slave->bal_node); | |
813 | insert_bal(bals, slave); | |
814 | } | |
815 | ||
816 | /* If 'bond' needs rebalancing, does so. | |
817 | * | |
818 | * The caller should have called bond_account() for each active flow, to ensure | |
819 | * that flow data is consistently accounted at this point. */ | |
820 | void | |
821 | bond_rebalance(struct bond *bond, struct tag_set *tags) | |
822 | { | |
823 | struct bond_slave *slave; | |
824 | struct bond_entry *e; | |
825 | struct list bals; | |
826 | ||
1b137691 | 827 | if (!bond_is_balanced(bond) || time_msec() < bond->next_rebalance) { |
f620b43a BP |
828 | return; |
829 | } | |
830 | bond->next_rebalance = time_msec() + bond->rebalance_interval; | |
831 | ||
832 | /* Add each bond_entry to its slave's 'entries' list. | |
833 | * Compute each slave's tx_bytes as the sum of its entries' tx_bytes. */ | |
834 | HMAP_FOR_EACH (slave, hmap_node, &bond->slaves) { | |
835 | slave->tx_bytes = 0; | |
836 | list_init(&slave->entries); | |
837 | } | |
838 | for (e = &bond->hash[0]; e <= &bond->hash[BOND_MASK]; e++) { | |
839 | if (e->slave && e->tx_bytes) { | |
840 | e->slave->tx_bytes += e->tx_bytes; | |
841 | list_push_back(&e->slave->entries, &e->list_node); | |
842 | } | |
843 | } | |
844 | ||
845 | /* Add enabled slaves to 'bals' in descending order of tx_bytes. | |
846 | * | |
847 | * XXX This is O(n**2) in the number of slaves but it could be O(n lg n) | |
848 | * with a proper list sort algorithm. */ | |
849 | list_init(&bals); | |
850 | HMAP_FOR_EACH (slave, hmap_node, &bond->slaves) { | |
851 | if (slave->enabled) { | |
852 | insert_bal(&bals, slave); | |
853 | } | |
854 | } | |
855 | log_bals(bond, &bals); | |
856 | ||
857 | /* Shift load from the most-loaded slaves to the least-loaded slaves. */ | |
858 | while (!list_is_short(&bals)) { | |
859 | struct bond_slave *from = bond_slave_from_bal_node(list_front(&bals)); | |
860 | struct bond_slave *to = bond_slave_from_bal_node(list_back(&bals)); | |
861 | uint64_t overload; | |
862 | ||
863 | overload = from->tx_bytes - to->tx_bytes; | |
864 | if (overload < to->tx_bytes >> 5 || overload < 100000) { | |
865 | /* The extra load on 'from' (and all less-loaded slaves), compared | |
866 | * to that of 'to' (the least-loaded slave), is less than ~3%, or | |
867 | * it is less than ~1Mbps. No point in rebalancing. */ | |
868 | break; | |
869 | } | |
870 | ||
871 | /* 'from' is carrying significantly more load than 'to', and that load | |
872 | * is split across at least two different hashes. */ | |
873 | e = choose_entry_to_migrate(from, to->tx_bytes); | |
874 | if (e) { | |
875 | bond_shift_load(e, to, tags); | |
876 | ||
877 | /* Delete element from from->entries. | |
878 | * | |
879 | * We don't add the element to to->hashes. That would only allow | |
880 | * 'e' to be migrated to another slave in this rebalancing run, and | |
881 | * there is no point in doing that. */ | |
882 | list_remove(&e->list_node); | |
883 | ||
884 | /* Re-sort 'bals'. */ | |
885 | reinsert_bal(&bals, from); | |
886 | reinsert_bal(&bals, to); | |
887 | } else { | |
888 | /* Can't usefully migrate anything away from 'from'. | |
889 | * Don't reconsider it. */ | |
890 | list_remove(&from->bal_node); | |
891 | } | |
892 | } | |
893 | ||
894 | /* Implement exponentially weighted moving average. A weight of 1/2 causes | |
895 | * historical data to decay to <1% in 7 rebalancing runs. 1,000,000 bytes | |
896 | * take 20 rebalancing runs to decay to 0 and get deleted entirely. */ | |
897 | for (e = &bond->hash[0]; e <= &bond->hash[BOND_MASK]; e++) { | |
898 | e->tx_bytes /= 2; | |
899 | if (!e->tx_bytes) { | |
900 | e->slave = NULL; | |
901 | } | |
902 | } | |
903 | } | |
904 | \f | |
905 | /* Bonding unixctl user interface functions. */ | |
906 | ||
907 | static struct bond * | |
908 | bond_find(const char *name) | |
909 | { | |
910 | struct bond *bond; | |
911 | ||
912 | HMAP_FOR_EACH_WITH_HASH (bond, hmap_node, hash_string(name, 0), | |
913 | &all_bonds) { | |
914 | if (!strcmp(bond->name, name)) { | |
915 | return bond; | |
916 | } | |
917 | } | |
918 | return NULL; | |
919 | } | |
920 | ||
921 | static struct bond_slave * | |
922 | bond_lookup_slave(struct bond *bond, const char *slave_name) | |
923 | { | |
924 | struct bond_slave *slave; | |
925 | ||
926 | HMAP_FOR_EACH (slave, hmap_node, &bond->slaves) { | |
927 | if (!strcmp(slave->name, slave_name)) { | |
928 | return slave; | |
929 | } | |
930 | } | |
931 | return NULL; | |
932 | } | |
933 | ||
934 | static void | |
935 | bond_unixctl_list(struct unixctl_conn *conn, | |
936 | const char *args OVS_UNUSED, void *aux OVS_UNUSED) | |
937 | { | |
938 | struct ds ds = DS_EMPTY_INITIALIZER; | |
939 | const struct bond *bond; | |
940 | ||
941 | ds_put_cstr(&ds, "bond\ttype\tslaves\n"); | |
942 | ||
943 | HMAP_FOR_EACH (bond, hmap_node, &all_bonds) { | |
944 | const struct bond_slave *slave; | |
945 | size_t i; | |
946 | ||
947 | ds_put_format(&ds, "%s\t%s\t", | |
948 | bond->name, bond_mode_to_string(bond->balance)); | |
949 | ||
950 | i = 0; | |
951 | HMAP_FOR_EACH (slave, hmap_node, &bond->slaves) { | |
952 | if (i++ > 0) { | |
953 | ds_put_cstr(&ds, ", "); | |
954 | } | |
955 | ds_put_cstr(&ds, slave->name); | |
956 | } | |
957 | ds_put_char(&ds, '\n'); | |
958 | } | |
959 | unixctl_command_reply(conn, 200, ds_cstr(&ds)); | |
960 | ds_destroy(&ds); | |
961 | } | |
962 | ||
963 | static void | |
964 | bond_unixctl_show(struct unixctl_conn *conn, | |
965 | const char *args, void *aux OVS_UNUSED) | |
966 | { | |
967 | struct ds ds = DS_EMPTY_INITIALIZER; | |
968 | const struct bond_slave *slave; | |
969 | const struct bond *bond; | |
970 | ||
971 | bond = bond_find(args); | |
972 | if (!bond) { | |
973 | unixctl_command_reply(conn, 501, "no such bond"); | |
974 | return; | |
975 | } | |
976 | ||
977 | ds_put_format(&ds, "bond_mode: %s\n", | |
978 | bond_mode_to_string(bond->balance)); | |
979 | ||
f620b43a BP |
980 | if (bond->balance != BM_AB) { |
981 | ds_put_format(&ds, "bond-hash-algorithm: %s\n", | |
982 | bond_is_tcp_hash(bond) ? "balance-tcp" : "balance-slb"); | |
983 | } | |
984 | ||
985 | ds_put_format(&ds, "bond-detect-mode: %s\n", | |
986 | bond->monitor ? "carrier" : "miimon"); | |
987 | ||
988 | if (!bond->monitor) { | |
989 | ds_put_format(&ds, "bond-miimon-interval: %lld\n", | |
990 | bond->miimon_interval); | |
991 | } | |
992 | ||
993 | ds_put_format(&ds, "updelay: %d ms\n", bond->updelay); | |
994 | ds_put_format(&ds, "downdelay: %d ms\n", bond->downdelay); | |
995 | ||
1b137691 | 996 | if (bond_is_balanced(bond)) { |
f620b43a BP |
997 | ds_put_format(&ds, "next rebalance: %lld ms\n", |
998 | bond->next_rebalance - time_msec()); | |
999 | } | |
1000 | ||
4d6fb5eb EJ |
1001 | ds_put_format(&ds, "lacp_negotiated: %s\n", |
1002 | bond->lacp_negotiated ? "true" : "false"); | |
1003 | ||
f620b43a BP |
1004 | HMAP_FOR_EACH (slave, hmap_node, &bond->slaves) { |
1005 | struct bond_entry *be; | |
1006 | struct flow flow; | |
1007 | ||
1008 | /* Basic info. */ | |
1009 | ds_put_format(&ds, "\nslave %s: %s\n", | |
1010 | slave->name, slave->enabled ? "enabled" : "disabled"); | |
1011 | if (slave == bond->active_slave) { | |
1012 | ds_put_cstr(&ds, "\tactive slave\n"); | |
1013 | } | |
1014 | if (slave->delay_expires != LLONG_MAX) { | |
1015 | ds_put_format(&ds, "\t%s expires in %lld ms\n", | |
1016 | slave->enabled ? "downdelay" : "updelay", | |
1017 | slave->delay_expires - time_msec()); | |
1018 | } | |
1019 | ||
70f25ec2 | 1020 | ds_put_format(&ds, "\tlacp_may_enable: %s\n", |
4d6fb5eb EJ |
1021 | slave->lacp_may_enable ? "true" : "false"); |
1022 | ||
1b137691 | 1023 | if (!bond_is_balanced(bond)) { |
f620b43a BP |
1024 | continue; |
1025 | } | |
1026 | ||
1027 | /* Hashes. */ | |
1028 | memset(&flow, 0, sizeof flow); | |
1029 | for (be = bond->hash; be <= &bond->hash[BOND_MASK]; be++) { | |
1030 | int hash = be - bond->hash; | |
1031 | ||
1032 | if (be->slave != slave) { | |
1033 | continue; | |
1034 | } | |
1035 | ||
1036 | ds_put_format(&ds, "\thash %d: %"PRIu64" kB load\n", | |
1037 | hash, be->tx_bytes / 1024); | |
1038 | ||
1039 | if (bond->balance != BM_SLB) { | |
1040 | continue; | |
1041 | } | |
1042 | ||
1043 | /* XXX How can we list the MACs assigned to hashes? */ | |
1044 | } | |
1045 | } | |
1046 | unixctl_command_reply(conn, 200, ds_cstr(&ds)); | |
1047 | ds_destroy(&ds); | |
1048 | } | |
1049 | ||
1050 | static void | |
1051 | bond_unixctl_migrate(struct unixctl_conn *conn, const char *args_, | |
1052 | void *aux OVS_UNUSED) | |
1053 | { | |
1054 | char *args = (char *) args_; | |
1055 | char *save_ptr = NULL; | |
1056 | char *bond_s, *hash_s, *slave_s; | |
1057 | struct bond *bond; | |
1058 | struct bond_slave *slave; | |
1059 | struct bond_entry *entry; | |
1060 | int hash; | |
1061 | ||
1062 | bond_s = strtok_r(args, " ", &save_ptr); | |
1063 | hash_s = strtok_r(NULL, " ", &save_ptr); | |
1064 | slave_s = strtok_r(NULL, " ", &save_ptr); | |
1065 | if (!slave_s) { | |
1066 | unixctl_command_reply(conn, 501, | |
1067 | "usage: bond/migrate BOND HASH SLAVE"); | |
1068 | return; | |
1069 | } | |
1070 | ||
1071 | bond = bond_find(bond_s); | |
1072 | if (!bond) { | |
1073 | unixctl_command_reply(conn, 501, "no such bond"); | |
1074 | return; | |
1075 | } | |
1076 | ||
1077 | if (bond->balance != BM_SLB) { | |
1078 | unixctl_command_reply(conn, 501, "not an SLB bond"); | |
1079 | return; | |
1080 | } | |
1081 | ||
1082 | if (strspn(hash_s, "0123456789") == strlen(hash_s)) { | |
1083 | hash = atoi(hash_s) & BOND_MASK; | |
1084 | } else { | |
1085 | unixctl_command_reply(conn, 501, "bad hash"); | |
1086 | return; | |
1087 | } | |
1088 | ||
1089 | slave = bond_lookup_slave(bond, slave_s); | |
1090 | if (!slave) { | |
1091 | unixctl_command_reply(conn, 501, "no such slave"); | |
1092 | return; | |
1093 | } | |
1094 | ||
1095 | if (!slave->enabled) { | |
1096 | unixctl_command_reply(conn, 501, "cannot migrate to disabled slave"); | |
1097 | return; | |
1098 | } | |
1099 | ||
1100 | entry = &bond->hash[hash]; | |
1101 | tag_set_add(&bond->unixctl_tags, entry->tag); | |
1102 | entry->slave = slave; | |
1103 | entry->tag = tag_create_random(); | |
1104 | unixctl_command_reply(conn, 200, "migrated"); | |
1105 | } | |
1106 | ||
1107 | static void | |
1108 | bond_unixctl_set_active_slave(struct unixctl_conn *conn, const char *args_, | |
1109 | void *aux OVS_UNUSED) | |
1110 | { | |
1111 | char *args = (char *) args_; | |
1112 | char *save_ptr = NULL; | |
1113 | char *bond_s, *slave_s; | |
1114 | struct bond *bond; | |
1115 | struct bond_slave *slave; | |
1116 | ||
1117 | bond_s = strtok_r(args, " ", &save_ptr); | |
1118 | slave_s = strtok_r(NULL, " ", &save_ptr); | |
1119 | if (!slave_s) { | |
1120 | unixctl_command_reply(conn, 501, | |
1121 | "usage: bond/set-active-slave BOND SLAVE"); | |
1122 | return; | |
1123 | } | |
1124 | ||
1125 | bond = bond_find(bond_s); | |
1126 | if (!bond) { | |
1127 | unixctl_command_reply(conn, 501, "no such bond"); | |
1128 | return; | |
1129 | } | |
1130 | ||
1131 | slave = bond_lookup_slave(bond, slave_s); | |
1132 | if (!slave) { | |
1133 | unixctl_command_reply(conn, 501, "no such slave"); | |
1134 | return; | |
1135 | } | |
1136 | ||
1137 | if (!slave->enabled) { | |
1138 | unixctl_command_reply(conn, 501, "cannot make disabled slave active"); | |
1139 | return; | |
1140 | } | |
1141 | ||
1142 | if (bond->active_slave != slave) { | |
1143 | tag_set_add(&bond->unixctl_tags, bond_get_active_slave_tag(bond)); | |
1144 | bond->active_slave = slave; | |
1145 | bond->active_slave->tag = tag_create_random(); | |
1146 | VLOG_INFO("bond %s: active interface is now %s", | |
1147 | bond->name, slave->name); | |
1148 | bond->send_learning_packets = true; | |
1149 | unixctl_command_reply(conn, 200, "done"); | |
1150 | } else { | |
1151 | unixctl_command_reply(conn, 200, "no change"); | |
1152 | } | |
1153 | } | |
1154 | ||
1155 | static void | |
1156 | enable_slave(struct unixctl_conn *conn, const char *args_, bool enable) | |
1157 | { | |
1158 | char *args = (char *) args_; | |
1159 | char *save_ptr = NULL; | |
1160 | char *bond_s, *slave_s; | |
1161 | struct bond *bond; | |
1162 | struct bond_slave *slave; | |
1163 | ||
1164 | bond_s = strtok_r(args, " ", &save_ptr); | |
1165 | slave_s = strtok_r(NULL, " ", &save_ptr); | |
1166 | if (!slave_s) { | |
1167 | char *usage = xasprintf("usage: bond/%s-slave BOND SLAVE", | |
1168 | enable ? "enable" : "disable"); | |
1169 | unixctl_command_reply(conn, 501, usage); | |
1170 | free(usage); | |
1171 | return; | |
1172 | } | |
1173 | ||
1174 | bond = bond_find(bond_s); | |
1175 | if (!bond) { | |
1176 | unixctl_command_reply(conn, 501, "no such bond"); | |
1177 | return; | |
1178 | } | |
1179 | ||
1180 | slave = bond_lookup_slave(bond, slave_s); | |
1181 | if (!slave) { | |
1182 | unixctl_command_reply(conn, 501, "no such slave"); | |
1183 | return; | |
1184 | } | |
1185 | ||
1186 | bond_enable_slave(slave, enable, &bond->unixctl_tags); | |
1187 | unixctl_command_reply(conn, 501, enable ? "enabled" : "disabled"); | |
1188 | } | |
1189 | ||
1190 | static void | |
1191 | bond_unixctl_enable_slave(struct unixctl_conn *conn, const char *args, | |
1192 | void *aux OVS_UNUSED) | |
1193 | { | |
1194 | enable_slave(conn, args, true); | |
1195 | } | |
1196 | ||
1197 | static void | |
1198 | bond_unixctl_disable_slave(struct unixctl_conn *conn, const char *args, | |
1199 | void *aux OVS_UNUSED) | |
1200 | { | |
1201 | enable_slave(conn, args, false); | |
1202 | } | |
1203 | ||
1204 | static void | |
1205 | bond_unixctl_hash(struct unixctl_conn *conn, const char *args_, | |
1206 | void *aux OVS_UNUSED) | |
1207 | { | |
1208 | char *args = (char *) args_; | |
1209 | uint8_t mac[ETH_ADDR_LEN]; | |
1210 | uint8_t hash; | |
1211 | char *hash_cstr; | |
1212 | unsigned int vlan; | |
1213 | char *mac_s, *vlan_s; | |
1214 | char *save_ptr = NULL; | |
1215 | ||
1216 | mac_s = strtok_r(args, " ", &save_ptr); | |
1217 | vlan_s = strtok_r(NULL, " ", &save_ptr); | |
1218 | ||
1219 | if (vlan_s) { | |
1220 | if (sscanf(vlan_s, "%u", &vlan) != 1) { | |
1221 | unixctl_command_reply(conn, 501, "invalid vlan"); | |
1222 | return; | |
1223 | } | |
1224 | } else { | |
1225 | vlan = OFP_VLAN_NONE; | |
1226 | } | |
1227 | ||
1228 | if (sscanf(mac_s, ETH_ADDR_SCAN_FMT, ETH_ADDR_SCAN_ARGS(mac)) | |
1229 | == ETH_ADDR_SCAN_COUNT) { | |
1230 | hash = bond_hash_src(mac, vlan) & BOND_MASK; | |
1231 | ||
1232 | hash_cstr = xasprintf("%u", hash); | |
1233 | unixctl_command_reply(conn, 200, hash_cstr); | |
1234 | free(hash_cstr); | |
1235 | } else { | |
1236 | unixctl_command_reply(conn, 501, "invalid mac"); | |
1237 | } | |
1238 | } | |
1239 | ||
1240 | void | |
1241 | bond_init(void) | |
1242 | { | |
f620b43a BP |
1243 | unixctl_command_register("bond/list", bond_unixctl_list, NULL); |
1244 | unixctl_command_register("bond/show", bond_unixctl_show, NULL); | |
1245 | unixctl_command_register("bond/migrate", bond_unixctl_migrate, NULL); | |
1246 | unixctl_command_register("bond/set-active-slave", | |
1247 | bond_unixctl_set_active_slave, NULL); | |
1248 | unixctl_command_register("bond/enable-slave", bond_unixctl_enable_slave, | |
1249 | NULL); | |
1250 | unixctl_command_register("bond/disable-slave", bond_unixctl_disable_slave, | |
1251 | NULL); | |
1252 | unixctl_command_register("bond/hash", bond_unixctl_hash, NULL); | |
1253 | } | |
1254 | \f | |
95aafb2a EJ |
1255 | static void |
1256 | bond_entry_reset(struct bond *bond) | |
1257 | { | |
1258 | if (bond->balance != BM_AB) { | |
1259 | size_t hash_len = (BOND_MASK + 1) * sizeof *bond->hash; | |
1260 | ||
1261 | if (!bond->hash) { | |
1262 | bond->hash = xmalloc(hash_len); | |
1263 | } | |
1264 | memset(bond->hash, 0, hash_len); | |
1265 | ||
1266 | bond->next_rebalance = time_msec() + bond->rebalance_interval; | |
1267 | } else { | |
1268 | free(bond->hash); | |
1269 | bond->hash = NULL; | |
1270 | } | |
1271 | } | |
1272 | ||
f620b43a BP |
1273 | static struct bond_slave * |
1274 | bond_slave_lookup(struct bond *bond, const void *slave_) | |
1275 | { | |
1276 | struct bond_slave *slave; | |
1277 | ||
1278 | HMAP_FOR_EACH_IN_BUCKET (slave, hmap_node, hash_pointer(slave_, 0), | |
1279 | &bond->slaves) { | |
1280 | if (slave->aux == slave_) { | |
1281 | return slave; | |
1282 | } | |
1283 | } | |
1284 | ||
1285 | return NULL; | |
1286 | } | |
1287 | ||
1288 | static bool | |
1289 | bond_is_link_up(struct bond *bond, struct netdev *netdev) | |
1290 | { | |
1291 | return (bond->detect == BLSM_CARRIER | |
1292 | ? netdev_get_carrier(netdev) | |
1293 | : netdev_get_miimon(netdev)); | |
1294 | } | |
1295 | ||
fb0b29a3 EJ |
1296 | static int |
1297 | bond_stb_sort_cmp__(const void *a_, const void *b_) | |
1298 | { | |
1299 | const struct bond_slave *const *ap = a_; | |
1300 | const struct bond_slave *const *bp = b_; | |
1301 | const struct bond_slave *a = *ap; | |
1302 | const struct bond_slave *b = *bp; | |
e1e90548 EJ |
1303 | uint16_t aid = a->stb_id; |
1304 | uint16_t bid = b->stb_id; | |
fb0b29a3 | 1305 | |
e1e90548 | 1306 | return aid < bid ? -1 : aid > bid; |
fb0b29a3 EJ |
1307 | } |
1308 | ||
1309 | static bool | |
1310 | bond_stb_sort(struct bond *bond) | |
1311 | { | |
1312 | size_t i; | |
1313 | ||
1314 | if (!bond->stb_slaves || !bond->stb_need_sort) { | |
1315 | return false; | |
1316 | } | |
1317 | bond->stb_need_sort = false; | |
1318 | ||
1319 | qsort(bond->stb_slaves, bond->n_stb_slaves, sizeof *bond->stb_slaves, | |
1320 | bond_stb_sort_cmp__); | |
1321 | ||
1322 | for (i = 0; i < bond->n_stb_slaves; i++) { | |
1323 | bond->stb_slaves[i]->stb_idx = i; | |
1324 | } | |
1325 | ||
1326 | return true; | |
1327 | } | |
1328 | ||
1329 | static void | |
1330 | bond_stb_enable_slave(struct bond_slave *slave) | |
1331 | { | |
1332 | struct bond *bond = slave->bond; | |
1333 | ||
9019cbdf | 1334 | if (bond->balance != BM_STABLE) { |
fb0b29a3 EJ |
1335 | return; |
1336 | } | |
1337 | ||
1338 | bond->stb_need_sort = true; | |
1339 | ||
1340 | if (slave->enabled) { | |
1341 | if (bond->len_stb_slaves <= bond->n_stb_slaves) { | |
1342 | bond->stb_slaves = x2nrealloc(bond->stb_slaves, | |
1343 | &bond->len_stb_slaves, | |
1344 | sizeof *bond->stb_slaves); | |
1345 | } | |
1346 | ||
1347 | slave->stb_idx = bond->n_stb_slaves++; | |
1348 | bond->stb_slaves[slave->stb_idx] = slave; | |
1349 | } else { | |
1350 | size_t index = slave->stb_idx; | |
1351 | bond->stb_slaves[index] = bond->stb_slaves[--bond->n_stb_slaves]; | |
1352 | bond->stb_slaves[index]->stb_idx = index; | |
1353 | } | |
1354 | } | |
1355 | ||
f620b43a BP |
1356 | static void |
1357 | bond_enable_slave(struct bond_slave *slave, bool enable, struct tag_set *tags) | |
1358 | { | |
1359 | slave->delay_expires = LLONG_MAX; | |
1360 | if (enable != slave->enabled) { | |
1361 | slave->enabled = enable; | |
1362 | if (!slave->enabled) { | |
1363 | VLOG_WARN("interface %s: disabled", slave->name); | |
b3c18f66 EJ |
1364 | if (tags) { |
1365 | tag_set_add(tags, slave->tag); | |
1366 | } | |
f620b43a BP |
1367 | } else { |
1368 | VLOG_WARN("interface %s: enabled", slave->name); | |
1369 | slave->tag = tag_create_random(); | |
1370 | } | |
fb0b29a3 | 1371 | bond_stb_enable_slave(slave); |
f620b43a BP |
1372 | } |
1373 | } | |
1374 | ||
1375 | static void | |
1376 | bond_link_status_update(struct bond_slave *slave, struct tag_set *tags) | |
1377 | { | |
1378 | struct bond *bond = slave->bond; | |
1379 | bool up; | |
1380 | ||
4d6fb5eb | 1381 | up = slave->up && slave->lacp_may_enable; |
f620b43a BP |
1382 | if ((up == slave->enabled) != (slave->delay_expires == LLONG_MAX)) { |
1383 | static struct vlog_rate_limit rl = VLOG_RATE_LIMIT_INIT(5, 20); | |
1384 | VLOG_INFO_RL(&rl, "interface %s: link state %s", | |
1385 | slave->name, up ? "up" : "down"); | |
1386 | if (up == slave->enabled) { | |
1387 | slave->delay_expires = LLONG_MAX; | |
1388 | VLOG_INFO_RL(&rl, "interface %s: will not be %s", | |
1389 | slave->name, up ? "disabled" : "enabled"); | |
1390 | } else { | |
4d6fb5eb | 1391 | int delay = (bond->lacp_negotiated ? 0 |
f620b43a BP |
1392 | : up ? bond->updelay : bond->downdelay); |
1393 | slave->delay_expires = time_msec() + delay; | |
1394 | if (delay) { | |
1395 | VLOG_INFO_RL(&rl, "interface %s: will be %s if it stays %s " | |
1396 | "for %d ms", | |
1397 | slave->name, | |
1398 | up ? "enabled" : "disabled", | |
1399 | up ? "up" : "down", | |
1400 | delay); | |
1401 | } | |
1402 | } | |
1403 | } | |
1404 | ||
1405 | if (time_msec() >= slave->delay_expires) { | |
1406 | bond_enable_slave(slave, up, tags); | |
1407 | } | |
1408 | } | |
1409 | ||
1410 | static bool | |
1411 | bond_is_tcp_hash(const struct bond *bond) | |
1412 | { | |
fb0b29a3 | 1413 | return (bond->balance == BM_TCP || bond->balance == BM_STABLE) |
4d6fb5eb | 1414 | && bond->lacp_negotiated; |
f620b43a BP |
1415 | } |
1416 | ||
1417 | static unsigned int | |
1418 | bond_hash_src(const uint8_t mac[ETH_ADDR_LEN], uint16_t vlan) | |
1419 | { | |
1420 | return hash_bytes(mac, ETH_ADDR_LEN, vlan); | |
1421 | } | |
1422 | ||
1423 | static unsigned int | |
1424 | bond_hash_tcp(const struct flow *flow, uint16_t vlan) | |
1425 | { | |
1426 | struct flow hash_flow = *flow; | |
1427 | hash_flow.vlan_tci = vlan; | |
1428 | ||
1429 | /* The symmetric quality of this hash function is not required, but | |
1430 | * flow_hash_symmetric_l4 already exists, and is sufficient for our | |
1431 | * purposes, so we use it out of convenience. */ | |
1432 | return flow_hash_symmetric_l4(&hash_flow, 0); | |
1433 | } | |
1434 | ||
fb0b29a3 EJ |
1435 | static unsigned int |
1436 | bond_hash(const struct bond *bond, const struct flow *flow, uint16_t vlan) | |
1437 | { | |
1438 | assert(bond->balance != BM_AB); | |
1439 | ||
1440 | return (bond_is_tcp_hash(bond) | |
1441 | ? bond_hash_tcp(flow, vlan) | |
1442 | : bond_hash_src(flow->dl_src, vlan)); | |
1443 | } | |
1444 | ||
f620b43a BP |
1445 | static struct bond_entry * |
1446 | lookup_bond_entry(const struct bond *bond, const struct flow *flow, | |
1447 | uint16_t vlan) | |
1448 | { | |
fb0b29a3 | 1449 | return &bond->hash[bond_hash(bond, flow, vlan) & BOND_MASK]; |
f620b43a BP |
1450 | } |
1451 | ||
1452 | static struct bond_slave * | |
1453 | choose_output_slave(const struct bond *bond, const struct flow *flow, | |
1454 | uint16_t vlan) | |
1455 | { | |
1456 | struct bond_entry *e; | |
1457 | ||
1458 | switch (bond->balance) { | |
1459 | case BM_AB: | |
1460 | return bond->active_slave; | |
1461 | ||
fb0b29a3 EJ |
1462 | case BM_STABLE: |
1463 | if (bond->n_stb_slaves) { | |
1464 | return bond->stb_slaves[bond_hash(bond, flow, vlan) | |
1465 | % bond->n_stb_slaves]; | |
1466 | } else { | |
1467 | return bond->active_slave; | |
1468 | } | |
1469 | ||
f620b43a BP |
1470 | case BM_SLB: |
1471 | case BM_TCP: | |
1472 | e = lookup_bond_entry(bond, flow, vlan); | |
1473 | if (!e->slave || !e->slave->enabled) { | |
c804cadf EJ |
1474 | e->slave = CONTAINER_OF(hmap_random_node(&bond->slaves), |
1475 | struct bond_slave, hmap_node); | |
1476 | if (!e->slave->enabled) { | |
1477 | e->slave = bond->active_slave; | |
1478 | } | |
f620b43a BP |
1479 | e->tag = tag_create_random(); |
1480 | } | |
1481 | return e->slave; | |
1482 | ||
1483 | default: | |
1484 | NOT_REACHED(); | |
1485 | } | |
1486 | } | |
1487 | ||
1488 | static struct bond_slave * | |
1489 | bond_choose_slave(const struct bond *bond) | |
1490 | { | |
1491 | struct bond_slave *slave, *best; | |
1492 | ||
1493 | /* Find an enabled slave. */ | |
1494 | HMAP_FOR_EACH (slave, hmap_node, &bond->slaves) { | |
1495 | if (slave->enabled) { | |
1496 | return slave; | |
1497 | } | |
1498 | } | |
1499 | ||
1500 | /* All interfaces are disabled. Find an interface that will be enabled | |
1501 | * after its updelay expires. */ | |
1502 | best = NULL; | |
1503 | HMAP_FOR_EACH (slave, hmap_node, &bond->slaves) { | |
1504 | if (slave->delay_expires != LLONG_MAX | |
4d6fb5eb | 1505 | && slave->lacp_may_enable |
f620b43a BP |
1506 | && (!best || slave->delay_expires < best->delay_expires)) { |
1507 | best = slave; | |
1508 | } | |
1509 | } | |
1510 | return best; | |
1511 | } | |
1512 | ||
1513 | static void | |
1514 | bond_choose_active_slave(struct bond *bond, struct tag_set *tags) | |
1515 | { | |
1516 | static struct vlog_rate_limit rl = VLOG_RATE_LIMIT_INIT(5, 20); | |
1517 | struct bond_slave *old_active_slave = bond->active_slave; | |
1518 | ||
1519 | bond->active_slave = bond_choose_slave(bond); | |
1520 | if (bond->active_slave) { | |
1521 | if (bond->active_slave->enabled) { | |
1522 | VLOG_INFO_RL(&rl, "bond %s: active interface is now %s", | |
1523 | bond->name, bond->active_slave->name); | |
1524 | } else { | |
1525 | VLOG_INFO_RL(&rl, "bond %s: active interface is now %s, skipping " | |
1526 | "remaining %lld ms updelay (since no interface was " | |
1527 | "enabled)", bond->name, bond->active_slave->name, | |
1528 | bond->active_slave->delay_expires - time_msec()); | |
1529 | bond_enable_slave(bond->active_slave, true, tags); | |
1530 | } | |
1531 | ||
1532 | if (!old_active_slave) { | |
1533 | tag_set_add(tags, bond->no_slaves_tag); | |
1534 | } | |
1535 | ||
1536 | bond->send_learning_packets = true; | |
1537 | } else if (old_active_slave) { | |
1538 | VLOG_WARN_RL(&rl, "bond %s: all interfaces disabled", bond->name); | |
1539 | } | |
1540 | } | |
1541 | ||
1542 | /* Returns the tag for 'bond''s active slave, or 'bond''s no_slaves_tag if | |
1543 | * there is no active slave. */ | |
1544 | static tag_type | |
1545 | bond_get_active_slave_tag(const struct bond *bond) | |
1546 | { | |
1547 | return (bond->active_slave | |
1548 | ? bond->active_slave->tag | |
1549 | : bond->no_slaves_tag); | |
1550 | } | |
1551 | ||
1552 | /* Attempts to make the sum of the bond slaves' statistics appear on the fake | |
1553 | * bond interface. */ | |
1554 | static void | |
1555 | bond_update_fake_slave_stats(struct bond *bond) | |
1556 | { | |
1557 | struct netdev_stats bond_stats; | |
1558 | struct bond_slave *slave; | |
1559 | struct netdev *bond_dev; | |
1560 | ||
1561 | memset(&bond_stats, 0, sizeof bond_stats); | |
1562 | ||
1563 | HMAP_FOR_EACH (slave, hmap_node, &bond->slaves) { | |
1564 | struct netdev_stats slave_stats; | |
1565 | ||
1566 | if (!netdev_get_stats(slave->netdev, &slave_stats)) { | |
1567 | /* XXX: We swap the stats here because they are swapped back when | |
1568 | * reported by the internal device. The reason for this is | |
1569 | * internal devices normally represent packets going into the | |
1570 | * system but when used as fake bond device they represent packets | |
1571 | * leaving the system. We really should do this in the internal | |
1572 | * device itself because changing it here reverses the counts from | |
1573 | * the perspective of the switch. However, the internal device | |
1574 | * doesn't know what type of device it represents so we have to do | |
1575 | * it here for now. */ | |
1576 | bond_stats.tx_packets += slave_stats.rx_packets; | |
1577 | bond_stats.tx_bytes += slave_stats.rx_bytes; | |
1578 | bond_stats.rx_packets += slave_stats.tx_packets; | |
1579 | bond_stats.rx_bytes += slave_stats.tx_bytes; | |
1580 | } | |
1581 | } | |
1582 | ||
1583 | if (!netdev_open_default(bond->name, &bond_dev)) { | |
1584 | netdev_set_stats(bond_dev, &bond_stats); | |
1585 | netdev_close(bond_dev); | |
1586 | } | |
1587 | } |