1 /* SPDX-License-Identifier: BSD-3-Clause
2 * Copyright(c) 2017 Intel Corporation
5 #ifndef __INCLUDE_RTE_MTR_DRIVER_H__
6 #define __INCLUDE_RTE_MTR_DRIVER_H__
10 * RTE Generic Traffic Metering and Policing API (Driver Side)
12 * This file provides implementation helpers for internal use by PMDs, they
13 * are not intended to be exposed to applications and are not subject to ABI
19 #include <rte_errno.h>
20 #include "rte_ethdev.h"
21 #include "ethdev_driver.h"
28 /** @internal MTR capabilities get. */
29 typedef int (*rte_mtr_capabilities_get_t)(struct rte_eth_dev *dev,
30 struct rte_mtr_capabilities *cap,
31 struct rte_mtr_error *error);
33 /** @internal MTR meter profile add. */
34 typedef int (*rte_mtr_meter_profile_add_t)(struct rte_eth_dev *dev,
35 uint32_t meter_profile_id,
36 struct rte_mtr_meter_profile *profile,
37 struct rte_mtr_error *error);
39 /** @internal MTR meter profile delete. */
40 typedef int (*rte_mtr_meter_profile_delete_t)(struct rte_eth_dev *dev,
41 uint32_t meter_profile_id,
42 struct rte_mtr_error *error);
44 /** @internal MTR meter policy validate. */
45 typedef int (*rte_mtr_meter_policy_validate_t)(struct rte_eth_dev *dev,
46 struct rte_mtr_meter_policy_params *policy,
47 struct rte_mtr_error *error);
49 /** @internal MTR meter policy add. */
50 typedef int (*rte_mtr_meter_policy_add_t)(struct rte_eth_dev *dev,
52 struct rte_mtr_meter_policy_params *policy,
53 struct rte_mtr_error *error);
55 /** @internal MTR meter policy delete. */
56 typedef int (*rte_mtr_meter_policy_delete_t)(struct rte_eth_dev *dev,
58 struct rte_mtr_error *error);
60 /** @internal MTR object create. */
61 typedef int (*rte_mtr_create_t)(struct rte_eth_dev *dev,
63 struct rte_mtr_params *params,
65 struct rte_mtr_error *error);
67 /** @internal MTR object destroy. */
68 typedef int (*rte_mtr_destroy_t)(struct rte_eth_dev *dev,
70 struct rte_mtr_error *error);
72 /** @internal MTR object meter enable. */
73 typedef int (*rte_mtr_meter_enable_t)(struct rte_eth_dev *dev,
75 struct rte_mtr_error *error);
77 /** @internal MTR object meter disable. */
78 typedef int (*rte_mtr_meter_disable_t)(struct rte_eth_dev *dev,
80 struct rte_mtr_error *error);
82 /** @internal MTR object meter profile update. */
83 typedef int (*rte_mtr_meter_profile_update_t)(struct rte_eth_dev *dev,
85 uint32_t meter_profile_id,
86 struct rte_mtr_error *error);
88 /** @internal MTR object meter policy update. */
89 typedef int (*rte_mtr_meter_policy_update_t)(struct rte_eth_dev *dev,
91 uint32_t meter_policy_id,
92 struct rte_mtr_error *error);
94 /** @internal MTR object meter DSCP table update. */
95 typedef int (*rte_mtr_meter_dscp_table_update_t)(struct rte_eth_dev *dev,
97 enum rte_color *dscp_table,
98 struct rte_mtr_error *error);
100 /** @internal MTR object enabled stats update. */
101 typedef int (*rte_mtr_stats_update_t)(struct rte_eth_dev *dev,
104 struct rte_mtr_error *error);
106 /** @internal MTR object stats read. */
107 typedef int (*rte_mtr_stats_read_t)(struct rte_eth_dev *dev,
109 struct rte_mtr_stats *stats,
110 uint64_t *stats_mask,
112 struct rte_mtr_error *error);
115 /** MTR capabilities get */
116 rte_mtr_capabilities_get_t capabilities_get;
118 /** MTR meter profile add */
119 rte_mtr_meter_profile_add_t meter_profile_add;
121 /** MTR meter profile delete */
122 rte_mtr_meter_profile_delete_t meter_profile_delete;
124 /** MTR object create */
125 rte_mtr_create_t create;
127 /** MTR object destroy */
128 rte_mtr_destroy_t destroy;
130 /** MTR object meter enable */
131 rte_mtr_meter_enable_t meter_enable;
133 /** MTR object meter disable */
134 rte_mtr_meter_disable_t meter_disable;
136 /** MTR object meter profile update */
137 rte_mtr_meter_profile_update_t meter_profile_update;
139 /** MTR object meter DSCP table update */
140 rte_mtr_meter_dscp_table_update_t meter_dscp_table_update;
142 /** MTR object enabled stats update */
143 rte_mtr_stats_update_t stats_update;
145 /** MTR object stats read */
146 rte_mtr_stats_read_t stats_read;
148 /** MTR meter policy validate */
149 rte_mtr_meter_policy_validate_t meter_policy_validate;
151 /** MTR meter policy add */
152 rte_mtr_meter_policy_add_t meter_policy_add;
154 /** MTR meter policy delete */
155 rte_mtr_meter_policy_delete_t meter_policy_delete;
157 /** MTR object meter policy update */
158 rte_mtr_meter_policy_update_t meter_policy_update;
162 * Initialize generic error structure.
164 * This function also sets rte_errno to a given value.
167 * Pointer to error structure (may be NULL).
169 * Related error code (rte_errno).
171 * Cause field and error type.
173 * Object responsible for the error.
175 * Human-readable error message.
181 rte_mtr_error_set(struct rte_mtr_error *error,
183 enum rte_mtr_error_type type,
188 *error = (struct rte_mtr_error){
199 * Get generic traffic metering and policing operations structure from a port
202 * The port identifier of the Ethernet device.
207 * The traffic metering and policing operations structure associated with
208 * port_id on success, NULL otherwise.
210 const struct rte_mtr_ops *
211 rte_mtr_ops_get(uint16_t port_id, struct rte_mtr_error *error);
217 #endif /* __INCLUDE_RTE_MTR_DRIVER_H__ */