DPDK  17.08.2
rte_eth_bond_8023ad.h
1 /*-
2  * BSD LICENSE
3  *
4  * Copyright(c) 2010-2014 Intel Corporation. All rights reserved.
5  * All rights reserved.
6  *
7  * Redistribution and use in source and binary forms, with or without
8  * modification, are permitted provided that the following conditions
9  * are met:
10  *
11  * * Redistributions of source code must retain the above copyright
12  * notice, this list of conditions and the following disclaimer.
13  * * Redistributions in binary form must reproduce the above copyright
14  * notice, this list of conditions and the following disclaimer in
15  * the documentation and/or other materials provided with the
16  * distribution.
17  * * Neither the name of Intel Corporation nor the names of its
18  * contributors may be used to endorse or promote products derived
19  * from this software without specific prior written permission.
20  *
21  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
22  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
23  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
24  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
25  * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
26  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
27  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
28  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
29  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
30  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
31  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
32  */
33 
34 #ifndef RTE_ETH_BOND_8023AD_H_
35 #define RTE_ETH_BOND_8023AD_H_
36 
37 #include <rte_ether.h>
38 
39 #ifdef __cplusplus
40 extern "C" {
41 #endif
42 
46 #define STATE_LACP_ACTIVE 0x01
47 #define STATE_LACP_SHORT_TIMEOUT 0x02
48 #define STATE_AGGREGATION 0x04
49 #define STATE_SYNCHRONIZATION 0x08
50 #define STATE_COLLECTING 0x10
51 #define STATE_DISTRIBUTING 0x20
52 
53 #define STATE_DEFAULTED 0x40
54 #define STATE_EXPIRED 0x80
55 
56 #define TLV_TYPE_ACTOR_INFORMATION 0x01
57 #define TLV_TYPE_PARTNER_INFORMATION 0x02
58 #define TLV_TYPE_COLLECTOR_INFORMATION 0x03
59 #define TLV_TYPE_TERMINATOR_INFORMATION 0x00
60 
61 #define SLOW_SUBTYPE_LACP 0x01
62 #define SLOW_SUBTYPE_MARKER 0x02
63 
64 #define MARKER_TLV_TYPE_INFO 0x01
65 #define MARKER_TLV_TYPE_RESP 0x02
66 
67 typedef void (*rte_eth_bond_8023ad_ext_slowrx_fn)(uint8_t slave_id,
68  struct rte_mbuf *lacp_pkt);
69 
70 enum rte_bond_8023ad_selection {
71  UNSELECTED,
72  STANDBY,
73  SELECTED
74 };
75 
76 enum rte_bond_8023ad_agg_selection {
77  AGG_BANDWIDTH,
78  AGG_COUNT,
79  AGG_STABLE
80 };
81 
83 struct slow_protocol {
84  uint8_t subtype;
85  uint8_t reserved_119[119];
86 } __attribute__((__packed__));
87 
89 struct slow_protocol_frame {
90  struct ether_hdr eth_hdr;
91  struct slow_protocol slow_protocol;
92 } __attribute__((__packed__));
93 
94 struct port_params {
95  uint16_t system_priority;
97  struct ether_addr system;
99  uint16_t key;
101  uint16_t port_priority;
103  uint16_t port_number;
105 } __attribute__((__packed__));
106 
107 struct lacpdu_actor_partner_params {
108  uint8_t tlv_type_info;
109  uint8_t info_length;
110  struct port_params port_params;
111  uint8_t state;
112  uint8_t reserved_3[3];
113 } __attribute__((__packed__));
114 
116 struct lacpdu {
117  uint8_t subtype;
118  uint8_t version_number;
119 
120  struct lacpdu_actor_partner_params actor;
121  struct lacpdu_actor_partner_params partner;
122 
123  uint8_t tlv_type_collector_info;
124  uint8_t collector_info_length;
125  uint16_t collector_max_delay;
126  uint8_t reserved_12[12];
127 
128  uint8_t tlv_type_terminator;
129  uint8_t terminator_length;
130  uint8_t reserved_50[50];
131 } __attribute__((__packed__));
132 
134 struct lacpdu_header {
135  struct ether_hdr eth_hdr;
136  struct lacpdu lacpdu;
137 } __attribute__((__packed__));
138 
139 struct marker {
140  uint8_t subtype;
141  uint8_t version_number;
142 
143  uint8_t tlv_type_marker;
144  uint8_t info_length;
145  uint16_t requester_port;
146  struct ether_addr requester_system;
147  uint32_t requester_transaction_id;
148  uint8_t reserved_2[2];
149 
150  uint8_t tlv_type_terminator;
151  uint8_t terminator_length;
152  uint8_t reserved_90[90];
153 } __attribute__((__packed__));
154 
155 struct marker_header {
156  struct ether_hdr eth_hdr;
157  struct marker marker;
158 } __attribute__((__packed__));
159 
160 struct rte_eth_bond_8023ad_conf {
161  uint32_t fast_periodic_ms;
162  uint32_t slow_periodic_ms;
163  uint32_t short_timeout_ms;
164  uint32_t long_timeout_ms;
165  uint32_t aggregate_wait_timeout_ms;
166  uint32_t tx_period_ms;
167  uint32_t rx_marker_period_ms;
168  uint32_t update_timeout_ms;
169  rte_eth_bond_8023ad_ext_slowrx_fn slowrx_cb;
170  enum rte_bond_8023ad_agg_selection agg_selection;
171 };
172 
173 struct rte_eth_bond_8023ad_slave_info {
174  enum rte_bond_8023ad_selection selected;
175  uint8_t actor_state;
176  struct port_params actor;
177  uint8_t partner_state;
178  struct port_params partner;
179  uint8_t agg_port_id;
180 };
181 
194 int
195 rte_eth_bond_8023ad_conf_get(uint8_t port_id,
196  struct rte_eth_bond_8023ad_conf *conf);
197 int
198 rte_eth_bond_8023ad_conf_get_v20(uint8_t port_id,
199  struct rte_eth_bond_8023ad_conf *conf);
200 int
201 rte_eth_bond_8023ad_conf_get_v1607(uint8_t port_id,
202  struct rte_eth_bond_8023ad_conf *conf);
203 int
204 rte_eth_bond_8023ad_conf_get_v1708(uint8_t port_id,
205  struct rte_eth_bond_8023ad_conf *conf);
206 
218 int
219 rte_eth_bond_8023ad_setup(uint8_t port_id,
220  struct rte_eth_bond_8023ad_conf *conf);
221 int
222 rte_eth_bond_8023ad_setup_v20(uint8_t port_id,
223  struct rte_eth_bond_8023ad_conf *conf);
224 int
225 rte_eth_bond_8023ad_setup_v1607(uint8_t port_id,
226  struct rte_eth_bond_8023ad_conf *conf);
227 int
228 rte_eth_bond_8023ad_setup_v1708(uint8_t port_id,
229  struct rte_eth_bond_8023ad_conf *conf);
230 
243 int
244 rte_eth_bond_8023ad_slave_info(uint8_t port_id, uint8_t slave_id,
245  struct rte_eth_bond_8023ad_slave_info *conf);
246 
247 #ifdef __cplusplus
248 }
249 #endif
250 
261 int
262 rte_eth_bond_8023ad_ext_collect(uint8_t port_id, uint8_t slave_id, int enabled);
263 
274 int
275 rte_eth_bond_8023ad_ext_collect_get(uint8_t port_id, uint8_t slave_id);
276 
287 int
288 rte_eth_bond_8023ad_ext_distrib(uint8_t port_id, uint8_t slave_id, int enabled);
289 
300 int
301 rte_eth_bond_8023ad_ext_distrib_get(uint8_t port_id, uint8_t slave_id);
302 
314 int
315 rte_eth_bond_8023ad_ext_slowtx(uint8_t port_id, uint8_t slave_id,
316  struct rte_mbuf *lacp_pkt);
317 
340 int
341 rte_eth_bond_8023ad_dedicated_queues_enable(uint8_t port_id);
342 
357 int
358 rte_eth_bond_8023ad_dedicated_queues_disable(uint8_t port_id);
359 
360 /*
361  * Get aggregator mode for 8023ad
362  * @param port_id Bonding device id
363  *
364  * @return
365  * agregator mode on success, negative value otherwise
366  */
367 int
368 rte_eth_bond_8023ad_agg_selection_get(uint8_t port_id);
369 
376 int
377 rte_eth_bond_8023ad_agg_selection_set(uint8_t port_id,
378  enum rte_bond_8023ad_agg_selection agg_selection);
379 #endif /* RTE_ETH_BOND_8023AD_H_ */
Generated by   doxygen 1.8.1.2