]>
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 | #ifndef BOND_H | |
18 | #define BOND_H 1 | |
19 | ||
20 | #include <stdbool.h> | |
21 | #include <stdint.h> | |
22 | ||
23 | #include "packets.h" | |
24 | #include "tag.h" | |
25 | ||
26 | struct flow; | |
f620b43a BP |
27 | struct netdev; |
28 | struct ofpbuf; | |
29 | ||
30 | /* How flows are balanced among bond slaves. */ | |
31 | enum bond_mode { | |
32 | BM_TCP, /* Transport Layer Load Balance. */ | |
33 | BM_SLB, /* Source Load Balance. */ | |
fb0b29a3 | 34 | BM_STABLE, /* Stable. */ |
f620b43a BP |
35 | BM_AB /* Active Backup. */ |
36 | }; | |
37 | ||
38 | bool bond_mode_from_string(enum bond_mode *, const char *); | |
39 | const char *bond_mode_to_string(enum bond_mode); | |
40 | ||
f620b43a BP |
41 | /* Configuration for a bond as a whole. */ |
42 | struct bond_settings { | |
43 | char *name; /* Bond's name, for log messages. */ | |
672d18b2 | 44 | uint32_t basis; /* Flow hashing basis. */ |
f620b43a BP |
45 | |
46 | /* Balancing configuration. */ | |
47 | enum bond_mode balance; | |
48 | int rebalance_interval; /* Milliseconds between rebalances. */ | |
49 | ||
50 | /* Link status detection. */ | |
f620b43a BP |
51 | int up_delay; /* ms before enabling an up slave. */ |
52 | int down_delay; /* ms before disabling a down slave. */ | |
53 | ||
54 | /* Legacy compatibility. */ | |
55 | bool fake_iface; /* Update fake stats for netdev 'name'? */ | |
f620b43a BP |
56 | }; |
57 | ||
58 | /* Program startup. */ | |
59 | void bond_init(void); | |
60 | ||
61 | /* Basics. */ | |
62 | struct bond *bond_create(const struct bond_settings *); | |
63 | void bond_destroy(struct bond *); | |
64 | ||
59d7b2b6 | 65 | bool bond_reconfigure(struct bond *, const struct bond_settings *); |
e1e90548 | 66 | void bond_slave_register(struct bond *, void *slave_, |
75135fa0 | 67 | uint32_t stable_id, struct netdev *); |
f8ddccd2 | 68 | void bond_slave_set_netdev(struct bond *, void *slave_, struct netdev *); |
f620b43a BP |
69 | void bond_slave_unregister(struct bond *, const void *slave); |
70 | ||
4d6fb5eb | 71 | void bond_run(struct bond *, struct tag_set *, bool lacp_negotiated); |
f620b43a BP |
72 | void bond_wait(struct bond *); |
73 | ||
296f6519 | 74 | void bond_slave_set_may_enable(struct bond *, void *slave_, bool may_enable); |
4d6fb5eb | 75 | |
f620b43a BP |
76 | /* Special MAC learning support for SLB bonding. */ |
77 | bool bond_should_send_learning_packets(struct bond *); | |
78 | int bond_send_learning_packet(struct bond *, | |
79 | const uint8_t eth_src[ETH_ADDR_LEN], | |
80 | uint16_t vlan); | |
81 | ||
82 | /* Packet processing. */ | |
83 | enum bond_verdict { | |
84 | BV_ACCEPT, /* Accept this packet. */ | |
85 | BV_DROP, /* Drop this packet. */ | |
86 | BV_DROP_IF_MOVED /* Drop if we've learned a different port. */ | |
87 | }; | |
88 | enum bond_verdict bond_check_admissibility(struct bond *, const void *slave_, | |
89 | const uint8_t eth_dst[ETH_ADDR_LEN], | |
90 | tag_type *); | |
91 | void *bond_choose_output_slave(struct bond *, | |
92 | const struct flow *, uint16_t vlan, tag_type *); | |
f620b43a BP |
93 | |
94 | /* Rebalancing. */ | |
95 | void bond_account(struct bond *, const struct flow *, uint16_t vlan, | |
96 | uint64_t n_bytes); | |
97 | void bond_rebalance(struct bond *, struct tag_set *); | |
98 | ||
99 | #endif /* bond.h */ |