From: Dekel Peled Date: Wed, 7 Oct 2020 13:28:42 +0000 (+0300) Subject: ethdev: support query of age action X-Git-Url: http://git.droids-corp.org/?a=commitdiff_plain;h=f6859b51360cd95d3e2bed6d912d94bfac854c5f;p=dpdk.git ethdev: support query of age action Existing API supports AGE action to monitor the aging of a flow. This patch implements RFC [1], introducing the response format for query of an AGE action. Application will be able to query the AGE action state. The response will be returned in the format implemented here. [1] https://mails.dpdk.org/archives/dev/2020-September/180061.html Signed-off-by: Dekel Peled Acked-by: Matan Azrad Acked-by: Ori Kam Acked-by: Andrew Rybchenko --- diff --git a/doc/guides/prog_guide/rte_flow.rst b/doc/guides/prog_guide/rte_flow.rst index 4e022dfa18..a446b51a65 100644 --- a/doc/guides/prog_guide/rte_flow.rst +++ b/doc/guides/prog_guide/rte_flow.rst @@ -2666,6 +2666,23 @@ timeout passed without any matching on the flow. | ``context`` | user input flow context | +--------------+---------------------------------+ +Query structure to retrieve ageing status information of a +shared AGE action, or a flow rule using the AGE action: + +.. _table_rte_flow_query_age: + +.. table:: AGE query + + +------------------------------+-----+----------------------------------------+ + | Field | I/O | Value | + +==============================+=====+========================================+ + | ``aged`` | out | Aging timeout expired | + +------------------------------+-----+----------------------------------------+ + | ``sec_since_last_hit_valid`` | out | ``sec_since_last_hit`` value is valid | + +------------------------------+-----+----------------------------------------+ + | ``sec_since_last_hit`` | out | Seconds since last traffic hit | + +------------------------------+-----+----------------------------------------+ + Action: ``SAMPLE`` ^^^^^^^^^^^^^^^^^^ diff --git a/doc/guides/rel_notes/release_20_11.rst b/doc/guides/rel_notes/release_20_11.rst index fafad676ff..e1c2f401de 100644 --- a/doc/guides/rel_notes/release_20_11.rst +++ b/doc/guides/rel_notes/release_20_11.rst @@ -387,6 +387,8 @@ API Changes * ``rx_qN*`` -> ``rx_qN_*`` * ``tx_qN*`` -> ``tx_qN_*`` +* ethdev: Added capability to query age flow action. + * ethdev: Renamed internal functions: * ``_rte_eth_dev_callback_process()`` -> ``rte_eth_dev_callback_process()`` diff --git a/lib/librte_ethdev/rte_flow.h b/lib/librte_ethdev/rte_flow.h index fa70d409a0..3d5fb09335 100644 --- a/lib/librte_ethdev/rte_flow.h +++ b/lib/librte_ethdev/rte_flow.h @@ -2130,6 +2130,7 @@ enum rte_flow_action_type { * See struct rte_flow_action_age. * See function rte_flow_get_aged_flows * see enum RTE_ETH_EVENT_FLOW_AGED + * See struct rte_flow_query_age */ RTE_FLOW_ACTION_TYPE_AGE, @@ -2201,6 +2202,20 @@ struct rte_flow_action_age { /**< The user flow context, NULL means the rte_flow pointer. */ }; +/** + * RTE_FLOW_ACTION_TYPE_AGE (query) + * + * Query structure to retrieve the aging status information of a + * shared AGE action, or a flow rule using the AGE action. + */ +struct rte_flow_query_age { + uint32_t reserved:6; /**< Reserved, must be zero. */ + uint32_t aged:1; /**< 1 if aging timeout expired, 0 otherwise. */ + uint32_t sec_since_last_hit_valid:1; + /**< sec_since_last_hit value is valid. */ + uint32_t sec_since_last_hit:24; /**< Seconds since last traffic hit. */ +}; + /** * @warning * @b EXPERIMENTAL: this structure may change without prior notice