DPDK  23.07.0
rte_flow_driver.h
Go to the documentation of this file.
1 /* SPDX-License-Identifier: BSD-3-Clause
2  * Copyright 2016 6WIND S.A.
3  * Copyright 2016 Mellanox Technologies, Ltd
4  */
5 
6 #ifndef RTE_FLOW_DRIVER_H_
7 #define RTE_FLOW_DRIVER_H_
8 
18 #include <stdint.h>
19 
20 #include "rte_ethdev.h"
21 #include "ethdev_driver.h"
22 #include "rte_flow.h"
23 
24 #ifdef __cplusplus
25 extern "C" {
26 #endif
27 
39 struct rte_flow_ops {
41  int (*validate)
42  (struct rte_eth_dev *,
43  const struct rte_flow_attr *,
44  const struct rte_flow_item [],
45  const struct rte_flow_action [],
46  struct rte_flow_error *);
48  struct rte_flow *(*create)
49  (struct rte_eth_dev *,
50  const struct rte_flow_attr *,
51  const struct rte_flow_item [],
52  const struct rte_flow_action [],
53  struct rte_flow_error *);
55  int (*destroy)
56  (struct rte_eth_dev *,
57  struct rte_flow *,
58  struct rte_flow_error *);
60  int (*flush)
61  (struct rte_eth_dev *,
62  struct rte_flow_error *);
64  int (*query)
65  (struct rte_eth_dev *,
66  struct rte_flow *,
67  const struct rte_flow_action *,
68  void *,
69  struct rte_flow_error *);
71  int (*isolate)
72  (struct rte_eth_dev *,
73  int,
74  struct rte_flow_error *);
76  int (*dev_dump)
77  (struct rte_eth_dev *dev,
78  struct rte_flow *flow,
79  FILE *file,
80  struct rte_flow_error *error);
82  int (*get_aged_flows)
83  (struct rte_eth_dev *dev,
84  void **context,
85  uint32_t nb_contexts,
86  struct rte_flow_error *err);
88  int (*get_q_aged_flows)
89  (struct rte_eth_dev *dev,
90  uint32_t queue_id,
91  void **contexts,
92  uint32_t nb_contexts,
93  struct rte_flow_error *error);
95  struct rte_flow_action_handle *(*action_handle_create)
96  (struct rte_eth_dev *dev,
97  const struct rte_flow_indir_action_conf *conf,
98  const struct rte_flow_action *action,
99  struct rte_flow_error *error);
101  int (*action_handle_destroy)
102  (struct rte_eth_dev *dev,
103  struct rte_flow_action_handle *handle,
104  struct rte_flow_error *error);
106  int (*action_handle_update)
107  (struct rte_eth_dev *dev,
108  struct rte_flow_action_handle *handle,
109  const void *update,
110  struct rte_flow_error *error);
112  int (*action_handle_query)
113  (struct rte_eth_dev *dev,
114  const struct rte_flow_action_handle *handle,
115  void *data,
116  struct rte_flow_error *error);
119  (struct rte_eth_dev *dev,
120  struct rte_flow_action_handle *handle,
121  const void *update, void *query,
122  enum rte_flow_query_update_mode qu_mode,
123  struct rte_flow_error *error);
125  struct rte_flow_action_list_handle *(*action_list_handle_create)
126  (struct rte_eth_dev *dev,
127  const struct rte_flow_indir_action_conf *conf,
128  const struct rte_flow_action actions[],
129  struct rte_flow_error *error);
132  (struct rte_eth_dev *dev,
133  struct rte_flow_action_list_handle *handle,
134  struct rte_flow_error *error);
136  int (*tunnel_decap_set)
137  (struct rte_eth_dev *dev,
138  struct rte_flow_tunnel *tunnel,
139  struct rte_flow_action **pmd_actions,
140  uint32_t *num_of_actions,
141  struct rte_flow_error *err);
143  int (*tunnel_match)
144  (struct rte_eth_dev *dev,
145  struct rte_flow_tunnel *tunnel,
146  struct rte_flow_item **pmd_items,
147  uint32_t *num_of_items,
148  struct rte_flow_error *err);
150  int (*get_restore_info)
151  (struct rte_eth_dev *dev,
152  struct rte_mbuf *m,
153  struct rte_flow_restore_info *info,
154  struct rte_flow_error *err);
157  (struct rte_eth_dev *dev,
158  struct rte_flow_action *pmd_actions,
159  uint32_t num_of_actions,
160  struct rte_flow_error *err);
162  int (*tunnel_item_release)
163  (struct rte_eth_dev *dev,
164  struct rte_flow_item *pmd_items,
165  uint32_t num_of_items,
166  struct rte_flow_error *err);
168  int (*pick_transfer_proxy)
169  (struct rte_eth_dev *dev,
170  uint16_t *proxy_port_id,
171  struct rte_flow_error *error);
172  struct rte_flow_item_flex_handle *(*flex_item_create)
173  (struct rte_eth_dev *dev,
174  const struct rte_flow_item_flex_conf *conf,
175  struct rte_flow_error *error);
176  int (*flex_item_release)
177  (struct rte_eth_dev *dev,
178  const struct rte_flow_item_flex_handle *handle,
179  struct rte_flow_error *error);
181  int (*info_get)
182  (struct rte_eth_dev *dev,
183  struct rte_flow_port_info *port_info,
184  struct rte_flow_queue_info *queue_info,
185  struct rte_flow_error *err);
187  int (*configure)
188  (struct rte_eth_dev *dev,
189  const struct rte_flow_port_attr *port_attr,
190  uint16_t nb_queue,
191  const struct rte_flow_queue_attr *queue_attr[],
192  struct rte_flow_error *err);
194  struct rte_flow_pattern_template *(*pattern_template_create)
195  (struct rte_eth_dev *dev,
196  const struct rte_flow_pattern_template_attr *template_attr,
197  const struct rte_flow_item pattern[],
198  struct rte_flow_error *err);
201  (struct rte_eth_dev *dev,
202  struct rte_flow_pattern_template *pattern_template,
203  struct rte_flow_error *err);
205  struct rte_flow_actions_template *(*actions_template_create)
206  (struct rte_eth_dev *dev,
207  const struct rte_flow_actions_template_attr *template_attr,
208  const struct rte_flow_action actions[],
209  const struct rte_flow_action masks[],
210  struct rte_flow_error *err);
213  (struct rte_eth_dev *dev,
214  struct rte_flow_actions_template *actions_template,
215  struct rte_flow_error *err);
217  struct rte_flow_template_table *(*template_table_create)
218  (struct rte_eth_dev *dev,
219  const struct rte_flow_template_table_attr *table_attr,
220  struct rte_flow_pattern_template *pattern_templates[],
221  uint8_t nb_pattern_templates,
222  struct rte_flow_actions_template *actions_templates[],
223  uint8_t nb_actions_templates,
224  struct rte_flow_error *err);
227  (struct rte_eth_dev *dev,
228  struct rte_flow_template_table *template_table,
229  struct rte_flow_error *err);
231  struct rte_flow *(*async_create)
232  (struct rte_eth_dev *dev,
233  uint32_t queue_id,
234  const struct rte_flow_op_attr *op_attr,
235  struct rte_flow_template_table *template_table,
236  const struct rte_flow_item pattern[],
237  uint8_t pattern_template_index,
238  const struct rte_flow_action actions[],
239  uint8_t actions_template_index,
240  void *user_data,
241  struct rte_flow_error *err);
243  struct rte_flow *(*async_create_by_index)
244  (struct rte_eth_dev *dev,
245  uint32_t queue_id,
246  const struct rte_flow_op_attr *op_attr,
247  struct rte_flow_template_table *template_table,
248  uint32_t rule_index,
249  const struct rte_flow_action actions[],
250  uint8_t actions_template_index,
251  void *user_data,
252  struct rte_flow_error *err);
254  int (*async_destroy)
255  (struct rte_eth_dev *dev,
256  uint32_t queue_id,
257  const struct rte_flow_op_attr *op_attr,
258  struct rte_flow *flow,
259  void *user_data,
260  struct rte_flow_error *err);
262  int (*push)
263  (struct rte_eth_dev *dev,
264  uint32_t queue_id,
265  struct rte_flow_error *err);
267  int (*pull)
268  (struct rte_eth_dev *dev,
269  uint32_t queue_id,
270  struct rte_flow_op_result res[],
271  uint16_t n_res,
272  struct rte_flow_error *error);
274  struct rte_flow_action_handle *(*async_action_handle_create)
275  (struct rte_eth_dev *dev,
276  uint32_t queue_id,
277  const struct rte_flow_op_attr *op_attr,
278  const struct rte_flow_indir_action_conf *indir_action_conf,
279  const struct rte_flow_action *action,
280  void *user_data,
281  struct rte_flow_error *err);
284  (struct rte_eth_dev *dev,
285  uint32_t queue_id,
286  const struct rte_flow_op_attr *op_attr,
287  struct rte_flow_action_handle *action_handle,
288  void *user_data,
289  struct rte_flow_error *error);
292  (struct rte_eth_dev *dev,
293  uint32_t queue_id,
294  const struct rte_flow_op_attr *op_attr,
295  struct rte_flow_action_handle *action_handle,
296  const void *update,
297  void *user_data,
298  struct rte_flow_error *error);
301  (struct rte_eth_dev *dev,
302  uint32_t queue_id,
303  const struct rte_flow_op_attr *op_attr,
304  const struct rte_flow_action_handle *action_handle,
305  void *data,
306  void *user_data,
307  struct rte_flow_error *error);
310  (struct rte_eth_dev *dev, uint32_t queue_id,
311  const struct rte_flow_op_attr *op_attr,
312  struct rte_flow_action_handle *action_handle,
313  const void *update, void *query,
314  enum rte_flow_query_update_mode qu_mode,
315  void *user_data, struct rte_flow_error *error);
317  int (*actions_update)
318  (struct rte_eth_dev *dev,
319  struct rte_flow *flow,
320  const struct rte_flow_action actions[],
321  struct rte_flow_error *error);
323  int (*async_actions_update)
324  (struct rte_eth_dev *dev,
325  uint32_t queue_id,
326  const struct rte_flow_op_attr *op_attr,
327  struct rte_flow *flow,
328  const struct rte_flow_action actions[],
329  uint8_t actions_template_index,
330  void *user_data,
331  struct rte_flow_error *error);
333  struct rte_flow_action_list_handle *
334  (*async_action_list_handle_create)
335  (struct rte_eth_dev *dev, uint32_t queue_id,
336  const struct rte_flow_op_attr *attr,
337  const struct rte_flow_indir_action_conf *conf,
338  const struct rte_flow_action *actions,
339  void *user_data, struct rte_flow_error *error);
342  (struct rte_eth_dev *dev, uint32_t queue_id,
343  const struct rte_flow_op_attr *op_attr,
344  struct rte_flow_action_list_handle *action_handle,
345  void *user_data, struct rte_flow_error *error);
348  (struct rte_eth_dev *dev,
349  const struct rte_flow_action_list_handle *handle,
350  const void **update, void **query,
351  enum rte_flow_query_update_mode mode,
352  struct rte_flow_error *error);
355  (struct rte_eth_dev *dev, uint32_t queue_id,
356  const struct rte_flow_op_attr *attr,
357  const struct rte_flow_action_list_handle *handle,
358  const void **update, void **query,
359  enum rte_flow_query_update_mode mode,
360  void *user_data, struct rte_flow_error *error);
361 };
362 
376 const struct rte_flow_ops *
377 rte_flow_ops_get(uint16_t port_id, struct rte_flow_error *error);
378 
382 int
384 
385 #ifdef __cplusplus
386 }
387 #endif
388 
389 #endif /* RTE_FLOW_DRIVER_H_ */
int(* tunnel_item_release)(struct rte_eth_dev *dev, struct rte_flow_item *pmd_items, uint32_t num_of_items, struct rte_flow_error *err)
int(* action_list_handle_destroy)(struct rte_eth_dev *dev, struct rte_flow_action_list_handle *handle, struct rte_flow_error *error)
int(* async_action_list_handle_destroy)(struct rte_eth_dev *dev, uint32_t queue_id, const struct rte_flow_op_attr *op_attr, struct rte_flow_action_list_handle *action_handle, void *user_data, struct rte_flow_error *error)
int(* async_action_handle_destroy)(struct rte_eth_dev *dev, uint32_t queue_id, const struct rte_flow_op_attr *op_attr, struct rte_flow_action_handle *action_handle, void *user_data, struct rte_flow_error *error)
int(* action_handle_query_update)(struct rte_eth_dev *dev, struct rte_flow_action_handle *handle, const void *update, void *query, enum rte_flow_query_update_mode qu_mode, struct rte_flow_error *error)
int(* template_table_destroy)(struct rte_eth_dev *dev, struct rte_flow_template_table *template_table, struct rte_flow_error *err)
int(* actions_update)(struct rte_eth_dev *dev, struct rte_flow *flow, const struct rte_flow_action actions[], struct rte_flow_error *error)
int(* actions_template_destroy)(struct rte_eth_dev *dev, struct rte_flow_actions_template *actions_template, struct rte_flow_error *err)
int(* get_q_aged_flows)(struct rte_eth_dev *dev, uint32_t queue_id, void **contexts, uint32_t nb_contexts, struct rte_flow_error *error)
int(* tunnel_match)(struct rte_eth_dev *dev, struct rte_flow_tunnel *tunnel, struct rte_flow_item **pmd_items, uint32_t *num_of_items, struct rte_flow_error *err)
int(* pull)(struct rte_eth_dev *dev, uint32_t queue_id, struct rte_flow_op_result res[], uint16_t n_res, struct rte_flow_error *error)
int(* async_destroy)(struct rte_eth_dev *dev, uint32_t queue_id, const struct rte_flow_op_attr *op_attr, struct rte_flow *flow, void *user_data, struct rte_flow_error *err)
int(* query)(struct rte_eth_dev *, struct rte_flow *, const struct rte_flow_action *, void *, struct rte_flow_error *)
int(* action_handle_query)(struct rte_eth_dev *dev, const struct rte_flow_action_handle *handle, void *data, struct rte_flow_error *error)
int(* async_action_handle_update)(struct rte_eth_dev *dev, uint32_t queue_id, const struct rte_flow_op_attr *op_attr, struct rte_flow_action_handle *action_handle, const void *update, void *user_data, struct rte_flow_error *error)
int(* info_get)(struct rte_eth_dev *dev, struct rte_flow_port_info *port_info, struct rte_flow_queue_info *queue_info, struct rte_flow_error *err)
int(* push)(struct rte_eth_dev *dev, uint32_t queue_id, struct rte_flow_error *err)
int(* validate)(struct rte_eth_dev *, const struct rte_flow_attr *, const struct rte_flow_item [], const struct rte_flow_action [], struct rte_flow_error *)
int(* pattern_template_destroy)(struct rte_eth_dev *dev, struct rte_flow_pattern_template *pattern_template, struct rte_flow_error *err)
int(* async_action_handle_query_update)(struct rte_eth_dev *dev, uint32_t queue_id, const struct rte_flow_op_attr *op_attr, struct rte_flow_action_handle *action_handle, const void *update, void *query, enum rte_flow_query_update_mode qu_mode, void *user_data, struct rte_flow_error *error)
int(* get_aged_flows)(struct rte_eth_dev *dev, void **context, uint32_t nb_contexts, struct rte_flow_error *err)
int(* action_handle_destroy)(struct rte_eth_dev *dev, struct rte_flow_action_handle *handle, struct rte_flow_error *error)
int(* pick_transfer_proxy)(struct rte_eth_dev *dev, uint16_t *proxy_port_id, struct rte_flow_error *error)
int rte_flow_restore_info_dynflag_register(void)
int(* tunnel_decap_set)(struct rte_eth_dev *dev, struct rte_flow_tunnel *tunnel, struct rte_flow_action **pmd_actions, uint32_t *num_of_actions, struct rte_flow_error *err)
int(* get_restore_info)(struct rte_eth_dev *dev, struct rte_mbuf *m, struct rte_flow_restore_info *info, struct rte_flow_error *err)
rte_flow_query_update_mode
Definition: rte_flow.h:6284
int(* async_action_list_handle_query_update)(struct rte_eth_dev *dev, uint32_t queue_id, const struct rte_flow_op_attr *attr, const struct rte_flow_action_list_handle *handle, const void **update, void **query, enum rte_flow_query_update_mode mode, void *user_data, struct rte_flow_error *error)
int(* async_actions_update)(struct rte_eth_dev *dev, uint32_t queue_id, const struct rte_flow_op_attr *op_attr, struct rte_flow *flow, const struct rte_flow_action actions[], uint8_t actions_template_index, void *user_data, struct rte_flow_error *error)
int(* tunnel_action_decap_release)(struct rte_eth_dev *dev, struct rte_flow_action *pmd_actions, uint32_t num_of_actions, struct rte_flow_error *err)
int(* async_action_handle_query)(struct rte_eth_dev *dev, uint32_t queue_id, const struct rte_flow_op_attr *op_attr, const struct rte_flow_action_handle *action_handle, void *data, void *user_data, struct rte_flow_error *error)
int(* action_list_handle_query_update)(struct rte_eth_dev *dev, const struct rte_flow_action_list_handle *handle, const void **update, void **query, enum rte_flow_query_update_mode mode, struct rte_flow_error *error)
int(* isolate)(struct rte_eth_dev *, int, struct rte_flow_error *)
int(* flush)(struct rte_eth_dev *, struct rte_flow_error *)
int(* dev_dump)(struct rte_eth_dev *dev, struct rte_flow *flow, FILE *file, struct rte_flow_error *error)
int(* destroy)(struct rte_eth_dev *, struct rte_flow *, struct rte_flow_error *)
int(* configure)(struct rte_eth_dev *dev, const struct rte_flow_port_attr *port_attr, uint16_t nb_queue, const struct rte_flow_queue_attr *queue_attr[], struct rte_flow_error *err)
int(* action_handle_update)(struct rte_eth_dev *dev, struct rte_flow_action_handle *handle, const void *update, struct rte_flow_error *error)
const struct rte_flow_ops * rte_flow_ops_get(uint16_t port_id, struct rte_flow_error *error)