From patchwork Wed Sep 9 20:30:07 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Andrey Vesnovaty X-Patchwork-Id: 77085 X-Patchwork-Delegate: thomas@monjalon.net Return-Path: X-Original-To: patchwork@inbox.dpdk.org Delivered-To: patchwork@inbox.dpdk.org Received: from dpdk.org (dpdk.org [92.243.14.124]) by inbox.dpdk.org (Postfix) with ESMTP id DB267A04B5; Wed, 9 Sep 2020 22:31:12 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id B136E1BE0C; Wed, 9 Sep 2020 22:31:12 +0200 (CEST) Received: from mellanox.co.il (mail-il-dmz.mellanox.com [193.47.165.129]) by dpdk.org (Postfix) with ESMTP id 51EA41DB8 for ; Wed, 9 Sep 2020 22:31:11 +0200 (CEST) Received: from Internal Mail-Server by MTLPINE1 (envelope-from andreyv@nvidia.com) with SMTP; 9 Sep 2020 23:31:10 +0300 Received: from nvidia.com (r-arch-host11.mtr.labs.mlnx [10.213.43.60]) by labmailer.mlnx (8.13.8/8.13.8) with ESMTP id 089KUKbP023874; Wed, 9 Sep 2020 23:31:10 +0300 From: Andrey Vesnovaty To: dev@dpdk.org Cc: thomas@nvidia.net, orika@nvidia.com, viacheslavo@nvidia.com, andrey.vesnovaty@gmail.com, ozsh@nvidia.com, elibr@nvidia.com, alexr@nvidia.com, roniba@nvidia.com, Ori Kam , Thomas Monjalon , Ferruh Yigit , Andrew Rybchenko Date: Wed, 9 Sep 2020 23:30:07 +0300 Message-Id: <20200909203008.25563-2-andreyv@nvidia.com> X-Mailer: git-send-email 2.26.2 In-Reply-To: <20200909203008.25563-1-andreyv@nvidia.com> References: <20200909203008.25563-1-andreyv@nvidia.com> MIME-Version: 1.0 Subject: [dpdk-dev] [RFC 1/3] ethdev: add item/action for SFT X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org Sender: "dev" Attach SFT flow context to packet with SFT action. Match on SFT flow context (attached to packet), with SFT item. Signed-off-by: Andrey Vesnovaty --- lib/librte_ethdev/rte_flow.h | 84 ++++++++++++++++++++++++++++++++++++ 1 file changed, 84 insertions(+) diff --git a/lib/librte_ethdev/rte_flow.h b/lib/librte_ethdev/rte_flow.h index da8bfa5489..24390e6ab4 100644 --- a/lib/librte_ethdev/rte_flow.h +++ b/lib/librte_ethdev/rte_flow.h @@ -537,6 +537,12 @@ enum rte_flow_item_type { */ RTE_FLOW_ITEM_TYPE_ECPRI, + /** + * Matches SFT context (see fields of struct rte_flow_item_sft). + * + * See struct rte_flow_item_sft. + */ + RTE_FLOW_ITEM_TYPE_SFT, }; /** @@ -1579,6 +1585,54 @@ static const struct rte_flow_item_ecpri rte_flow_item_ecpri_mask = { }; #endif +/** + * @warning + * @b EXPERIMENTAL: this structure may change without prior notice + * + * RTE_FLOW_ITEM_TYPE_SFT + * + * Matches context of flow in SFT table. + * + * 5-tuple: src/dest IP + src/dest port + IP protocol. + * zone: application defined value cupled with 5-tuple to identify flow, + * example - VxLAN, VLAN. + * SFT: Statfull flow table + * SFT in scope of ethernet device (port) is HW offloaded lookup table + * where key is zone + 5-tuple & value is statefull flow context. + * Contents of the SFT maintained by SFT PMD (see SFT PMD API in rte_sft). + * + * The structure describes SFT flow context. + * All the fields of the structure, except @p fid, should be considered as + * user defined. + * The @p fid assigned by RTE SFT & used as unique flow identifier. + * SFT context attached to packet by action ``SFT`` (see RTE_FLOW_ACTION_SFT). + * + * SFT default context defined as context attached to packet when there is no + * entry for the flow in SFT. The @p state has application reserved value + * meaning that SFT context for the packet undefined since entry wasn't found + * in SFT. If state 'undefined' then @p zone should be valid othervice @p fid + * should be valid. + * + * Context considered virtual since the method of storing this info on packet + * is PMD/implementation specific & may involve mapping methods if there is + * 'not enough bits' to store entire contents of struct rte_flow_item_sft. + * + * Maximal value/size of each field depends on HW capabilities and considered + * as implementation specific. + */ +struct rte_flow_item_sft { + union { + uint32_t fid; /**< SFT flow identifier. */ + uint32_t zone; /**< Zone assigned to flow. */ + }; + uint8_t state; /**< User defined flow state. */ + uint8_t fid_valid:1; /**< fid field validity bit. */ + uint8_t zone_valid:1; /**< zone fieald validity bit. */ + uint8_t state_valid:1; /**< state fieald validity bit. */ + uint8_t user_data_size; /**< user_data buffer size. */ + uint8_t *user_data; /**< Arbitrary user data. */ +}; + /** * Matching pattern item definition. * @@ -2132,6 +2186,15 @@ enum rte_flow_action_type { * see enum RTE_ETH_EVENT_FLOW_AGED */ RTE_FLOW_ACTION_TYPE_AGE, + + /** + * RTE_FLOW_ACTION_TYPE_SFT + * + * Set SFT context and redirect to continue processing. + * + * See struct rte_flow_action_sft. + */ + RTE_FLOW_ACTION_TYPE_SFT, }; /** @@ -2721,6 +2784,27 @@ rte_flow_dynf_metadata_set(struct rte_mbuf *m, uint32_t v) *RTE_FLOW_DYNF_METADATA(m) = v; } +/** + * @warning + * @b EXPERIMENTAL: this structure may change without prior notice + * + * RTE_FLOW_ACTION_TYPE_SFT + * + * Attaches an SFT context (see struct rte_flow_item_sft) to packet. + * + * Performs lookup by *zone* and 5-tuple in SFT; if entry found the related SFT + * context will be attached othervise default SFT context attached (see + * 'SFT default context' in struct rte_flow_item_sft description). + * Adding action of type ``SFT`` to the list of rule actions may impose + * limitations on other rule actions added to the list, depending on specific + * PMD implementation. + * + * For 5-tuple, zone & SFT definitions see `struct rte_flow_item_sft`. + */ +struct rte_flow_action_sft { + uint32_t zone; /**< Zone for lookup in SFT */ +}; + /* * Definition of a single action. *