[v2,2/4] ethdev: add template table hash calculation function
Checks
Commit Message
Allow user to specify hash calculation function used in template tables.
The hash calculation type is responsible for the calculation of the flow
rule index a packet would hit upon arrival at the table.
Control over this is useful for applications with custom RSS algorithms,
for example. An application can select various packet fields to serve as
a hash calculation source and jump to the appropriate flow rule location.
The RSS hash result will be used as the index in the table. For the linear
hash function, the mapping is one-to-one and the hash result is the index.
For other hash functions, the index is the hash result module table size.
The RSS hash result can be retrieved via modify_field API: HASH_RESULT.
Signed-off-by: Alexander Kozyrev <akozyrev@nvidia.com>
---
doc/guides/rel_notes/release_23_03.rst | 4 ++++
lib/ethdev/rte_flow.h | 30 ++++++++++++++++++++++++++
2 files changed, 34 insertions(+)
@@ -76,6 +76,10 @@ New Features
Introduced new function ``rte_flow_async_create_by_index()``
to insert rules by index into index-based template tables.
+* **Added index-based rules insertion in flow API.**
+ Added hash calculation function used in template tables
+ to allow control over the calculation of the rule index for a packet.
+
Removed Items
-------------
@@ -3528,6 +3528,7 @@ enum rte_flow_field_id {
RTE_FLOW_FIELD_IPV6_ECN, /**< IPv6 ECN. */
RTE_FLOW_FIELD_GTP_PSC_QFI, /**< GTP QFI. */
RTE_FLOW_FIELD_METER_COLOR, /**< Meter color marker. */
+ RTE_FLOW_FIELD_HASH_RESULT, /**< Hash result. */
};
/**
@@ -5204,6 +5205,31 @@ enum rte_flow_table_insertion_type {
RTE_FLOW_TABLE_INSERTION_TYPE_INDEX,
};
+/**
+ * @warning
+ * @b EXPERIMENTAL: this API may change without prior notice.
+ *
+ * Template table hash index calculation function.
+ */
+enum rte_flow_table_hash_func {
+ /**
+ * Default hash calculation.
+ */
+ RTE_FLOW_TABLE_HASH_FUNC_DEFAULT,
+ /**
+ * Linear hash calculation.
+ */
+ RTE_FLOW_TABLE_HASH_FUNC_LINEAR,
+ /**
+ * 32-bit checksum hash calculation.
+ */
+ RTE_FLOW_TABLE_HASH_FUNC_CRC32,
+ /**
+ * 16-bit checksum hash calculation.
+ */
+ RTE_FLOW_TABLE_HASH_FUNC_CRC16,
+};
+
/**
* @warning
* @b EXPERIMENTAL: this API may change without prior notice.
@@ -5223,6 +5249,10 @@ struct rte_flow_template_table_attr {
* Insertion type for flow rules.
*/
enum rte_flow_table_insertion_type insertion_type;
+ /**
+ * Hash calculation function for the packet matching.
+ */
+ enum rte_flow_table_hash_func hash_func;
};
/**