d/numam-dpdk
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

ethdev: add flow action for metering and policing

Browse Source 
Metering and policing action typically sits on top of flow classification,
which is why MTR objects are enabled through a newly introduced flow
action.

The configuration of MTR objects is done in their own namespace (rte_mtr)
within the librte_ether library. The MTR object is hooked into ethdev RX
processing path using the "meter" flow action.

Signed-off-by: Cristian Dumitrescu <cristian.dumitrescu@intel.com>
Acked-by: Adrien Mazarguil <adrien.mazarguil@6wind.com>
Acked-by: Jerin Jacob <jerin.jacob@caviumnetworks.com>
This commit is contained in:
Cristian Dumitrescu 2017-10-13 13:22:14 +01:00
parent 6b9ed026a8
commit 1634de2728
2 changed files with 45 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

23
doc/guides/prog_guide/rte_flow.rst
View File

@ -1371,6 +1371,29 @@ rule or if packets are not addressed to a VF in the first place.
| ``vf`` | VF ID to redirect packets to |
+--------------+--------------------------------+
Action: ``METER``
^^^^^^^^^^^^^^^^^
Applies a stage of metering and policing.
The metering and policing (MTR) object has to be first created using the
rte_mtr_create() API function. The ID of the MTR object is specified as
action parameter. More than one flow can use the same MTR object through
the meter action. The MTR object can be further updated or queried using
the rte_mtr* API.
- Non-terminating by default.
.. _table_rte_flow_action_meter:
.. table:: METER
+--------------+---------------+
| Field | Value |
+==============+===============+
| ``mtr_id`` | MTR object ID |
+--------------+---------------+
Negative types
~~~~~~~~~~~~~~

22
lib/librte_ether/rte_flow.h
View File

@ -967,6 +967,14 @@ enum rte_flow_action_type {
* See struct rte_flow_action_vf.
*/
RTE_FLOW_ACTION_TYPE_VF,
/**
* Traffic metering and policing (MTR).
*
* See struct rte_flow_action_meter.
* See file rte_mtr.h for MTR object configuration.
*/
RTE_FLOW_ACTION_TYPE_METER,
};
/**
@ -1059,6 +1067,20 @@ struct rte_flow_action_vf {
uint32_t id; /**< VF ID to redirect packets to. */
};
/**
* RTE_FLOW_ACTION_TYPE_METER
*
* Traffic metering and policing (MTR).
*
* Packets matched by items of this type can be either dropped or passed to the
* next item with their color set by the MTR object.
*
* Non-terminating by default.
*/
struct rte_flow_action_meter {
uint32_t mtr_id; /**< MTR object ID created with rte_mtr_create(). */
};
/**
* Definition of a single action.
*