From mboxrd@z Thu Jan 1 00:00:00 1970 From: Qi Zhang Subject: [PATCH v3 2/4] ethdev: add packet field set aciton in flow API Date: Mon, 16 Apr 2018 14:10:40 +0800 Message-ID: <20180416061042.785-3-qi.z.zhang@intel.com> References: <1522279780-34842-1-git-send-email-qi.z.zhang@intel.com> <20180416061042.785-1-qi.z.zhang@intel.com> Cc: dev@dpdk.org, declan.doherty@intel.com, sugesh.chandran@intel.com, michael.j.glynn@intel.com, yu.y.liu@intel.com, konstantin.ananyev@intel.com, bruce.richardson@intel.com, Qi Zhang To: adrien.mazarguil@6wind.com Return-path: Received: from mga05.intel.com (mga05.intel.com [192.55.52.43]) by dpdk.org (Postfix) with ESMTP id AA0231B1D4 for ; Mon, 16 Apr 2018 08:10:37 +0200 (CEST) In-Reply-To: <20180416061042.785-1-qi.z.zhang@intel.com> List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org Sender: "dev" Add new action RTE_FLOW_ACTION_TYPE_FIELD_SET, it is used to modify fields of specific protocol layer of the packet, the action only apply on packets that contain the requireds protocol layer. Signed-off-by: Qi Zhang --- doc/guides/prog_guide/rte_flow.rst | 30 +++++++++++++++++++++++++++ lib/librte_ether/rte_flow.h | 42 +++++++++++++++++++++++++++++++++++++- 2 files changed, 71 insertions(+), 1 deletion(-) diff --git a/doc/guides/prog_guide/rte_flow.rst b/doc/guides/prog_guide/rte_flow.rst index 99468bf60..68deb9812 100644 --- a/doc/guides/prog_guide/rte_flow.rst +++ b/doc/guides/prog_guide/rte_flow.rst @@ -1574,6 +1574,36 @@ fields in the pattern items. | 1 | END | +-------+----------+ +Action: ``FILED_SET`` +^^^^^^^^^^^^^^^^^^^^^ + +Modify the value of fields in a protocol layer, only applies to packets that +contain respective protocol layer. + +.. _table_rte_flow_action_field_set: + +.. table:: FIELD_SET + + +---------------+-------------------------------------------------------------------+ + | Field | Value | + +===============+===================================================================+ + | ``type`` | Specify the type of a protocol layer. (see RTE_FLOW_ITEM_TYPE_*) | + +---------------+-------------------------------------------------------------------+ + | ``dir_level`` | Specify the level of matched protocol layer. | + | | direction (1b) | + | | 0: match start from outermost. | + | | 1: match start from innermost. | + | | level: (31b) | + | | 0: outermost or innermost protocol layer that matched @type | + | | 1: next to outmost or innermost protocol layer that matched @type | + | | 2: and so on ... | + +---------------+-------------------------------------------------------------------+ + | ``new_val`` | Pointer to specific data structure according to protocol type, | + | | the content is the new value to updtae. | + +---------------+-------------------------------------------------------------------+ + | ``mask`` | Bit-mask applied to new_val | + +---------------+-------------------------------------------------------------------+ + Negative types ~~~~~~~~~~~~~~ diff --git a/lib/librte_ether/rte_flow.h b/lib/librte_ether/rte_flow.h index f84bbfda5..2dc95b6b8 100644 --- a/lib/librte_ether/rte_flow.h +++ b/lib/librte_ether/rte_flow.h @@ -1245,7 +1245,15 @@ enum rte_flow_action_type { * * See struct rte_flow_action_security. */ - RTE_FLOW_ACTION_TYPE_SECURITY + RTE_FLOW_ACTION_TYPE_SECURITY, + + /** + * Modify the value of fields in a protocol layer, only applies to + * packets that contain respective protocol layer. + * + * See struct rte_flow_action_field_set. + */ + RTE_FLOW_ACTION_TYPE_FIELD_SET, }; /** @@ -1384,6 +1392,38 @@ struct rte_flow_action_security { }; /** + * RTE_FLOW_ACTION_TYPE_FIELD_SET + * + * Modify the value of fields in a protocol layer, only applies to + * packets that contain respective protocol layer. + */ +struct rte_flow_action_field_set { + /** + * Specify the type of a protocol layer. + */ + enum rte_flow_item_type type; + /** + * Specify the level of matched protocol layer. + * + * direction (1b) + * 0: match start from outermost. + * 1: match start from innermost. + * + * level (31b) + * 0: outermost|innermost protocol layer that matched @type. + * 1: next to outermost|innermost protocol layer that matched @type. + * 2: and so on ... + */ + uint32_t dir_level; + /** + * Pointer to specific data structure according to protocol type, + * the content is the new value to update. + */ + const void *new_val; + const void *mask; /**< Bit-mask applied to new_val. */ +}; + +/** * Definition of a single action. * * A list of actions is terminated by a END action. -- 2.13.6