Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/77085/?format=api
{ "id": 77085, "url": "http://patches.dpdk.org/api/patches/77085/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/patch/20200909203008.25563-2-andreyv@nvidia.com/", "project": { "id": 1, "url": "http://patches.dpdk.org/api/projects/1/?format=api", "name": "DPDK", "link_name": "dpdk", "list_id": "dev.dpdk.org", "list_email": "dev@dpdk.org", "web_url": "http://core.dpdk.org", "scm_url": "git://dpdk.org/dpdk", "webscm_url": "http://git.dpdk.org/dpdk", "list_archive_url": "https://inbox.dpdk.org/dev", "list_archive_url_format": "https://inbox.dpdk.org/dev/{}", "commit_url_format": "" }, "msgid": "<20200909203008.25563-2-andreyv@nvidia.com>", "list_archive_url": "https://inbox.dpdk.org/dev/20200909203008.25563-2-andreyv@nvidia.com", "date": "2020-09-09T20:30:07", "name": "[RFC,1/3] ethdev: add item/action for SFT", "commit_ref": null, "pull_url": null, "state": "superseded", "archived": true, "hash": "0abf3aa9877c69a30247664d39666fa1b49244e2", "submitter": { "id": 1969, "url": "http://patches.dpdk.org/api/people/1969/?format=api", "name": "Andrey Vesnovaty", "email": "andreyv@nvidia.com" }, "delegate": { "id": 1, "url": "http://patches.dpdk.org/api/users/1/?format=api", "username": "tmonjalo", "first_name": "Thomas", "last_name": "Monjalon", "email": "thomas@monjalon.net" }, "mbox": "http://patches.dpdk.org/project/dpdk/patch/20200909203008.25563-2-andreyv@nvidia.com/mbox/", "series": [ { "id": 12067, "url": "http://patches.dpdk.org/api/series/12067/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/list/?series=12067", "date": "2020-09-09T20:30:05", "name": "introduce Stateful Flow Table", "version": 1, "mbox": "http://patches.dpdk.org/series/12067/mbox/" } ], "comments": "http://patches.dpdk.org/api/patches/77085/comments/", "check": "success", "checks": "http://patches.dpdk.org/api/patches/77085/checks/", "tags": {}, "related": [], "headers": { "Return-Path": "<dev-bounces@dpdk.org>", "X-Original-To": "patchwork@inbox.dpdk.org", "Delivered-To": "patchwork@inbox.dpdk.org", "Received": [ "from dpdk.org (dpdk.org [92.243.14.124])\n\tby inbox.dpdk.org (Postfix) with ESMTP id DB267A04B5;\n\tWed, 9 Sep 2020 22:31:12 +0200 (CEST)", "from [92.243.14.124] (localhost [127.0.0.1])\n\tby dpdk.org (Postfix) with ESMTP id B136E1BE0C;\n\tWed, 9 Sep 2020 22:31:12 +0200 (CEST)", "from mellanox.co.il (mail-il-dmz.mellanox.com [193.47.165.129])\n by dpdk.org (Postfix) with ESMTP id 51EA41DB8\n for <dev@dpdk.org>; Wed, 9 Sep 2020 22:31:11 +0200 (CEST)", "from Internal Mail-Server by MTLPINE1 (envelope-from\n andreyv@nvidia.com) with SMTP; 9 Sep 2020 23:31:10 +0300", "from nvidia.com (r-arch-host11.mtr.labs.mlnx [10.213.43.60])\n by labmailer.mlnx (8.13.8/8.13.8) with ESMTP id 089KUKbP023874;\n Wed, 9 Sep 2020 23:31:10 +0300" ], "From": "Andrey Vesnovaty <andreyv@nvidia.com>", "To": "dev@dpdk.org", "Cc": "thomas@nvidia.net, orika@nvidia.com, viacheslavo@nvidia.com,\n andrey.vesnovaty@gmail.com, ozsh@nvidia.com, elibr@nvidia.com,\n alexr@nvidia.com, roniba@nvidia.com, Ori Kam <orika@mellanox.com>,\n Thomas Monjalon <thomas@monjalon.net>,\n Ferruh Yigit <ferruh.yigit@intel.com>,\n Andrew Rybchenko <arybchenko@solarflare.com>", "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", "Content-Transfer-Encoding": "8bit", "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 <dev.dpdk.org>", "List-Unsubscribe": "<https://mails.dpdk.org/options/dev>,\n <mailto:dev-request@dpdk.org?subject=unsubscribe>", "List-Archive": "<http://mails.dpdk.org/archives/dev/>", "List-Post": "<mailto:dev@dpdk.org>", "List-Help": "<mailto:dev-request@dpdk.org?subject=help>", "List-Subscribe": "<https://mails.dpdk.org/listinfo/dev>,\n <mailto:dev-request@dpdk.org?subject=subscribe>", "Errors-To": "dev-bounces@dpdk.org", "Sender": "\"dev\" <dev-bounces@dpdk.org>" }, "content": "Attach SFT flow context to packet with SFT action.\nMatch on SFT flow context (attached to packet),\nwith SFT item.\n\nSigned-off-by: Andrey Vesnovaty <andreyv@nvidia.com>\n---\n lib/librte_ethdev/rte_flow.h | 84 ++++++++++++++++++++++++++++++++++++\n 1 file changed, 84 insertions(+)", "diff": "diff --git a/lib/librte_ethdev/rte_flow.h b/lib/librte_ethdev/rte_flow.h\nindex da8bfa5489..24390e6ab4 100644\n--- a/lib/librte_ethdev/rte_flow.h\n+++ b/lib/librte_ethdev/rte_flow.h\n@@ -537,6 +537,12 @@ enum rte_flow_item_type {\n \t */\n \tRTE_FLOW_ITEM_TYPE_ECPRI,\n \n+\t/**\n+\t * Matches SFT context (see fields of struct rte_flow_item_sft).\n+\t *\n+\t * See struct rte_flow_item_sft.\n+\t */\n+\tRTE_FLOW_ITEM_TYPE_SFT,\n };\n \n /**\n@@ -1579,6 +1585,54 @@ static const struct rte_flow_item_ecpri rte_flow_item_ecpri_mask = {\n };\n #endif\n \n+/**\n+ * @warning\n+ * @b EXPERIMENTAL: this structure may change without prior notice\n+ *\n+ * RTE_FLOW_ITEM_TYPE_SFT\n+ *\n+ * Matches context of flow in SFT table.\n+ *\n+ * 5-tuple: src/dest IP + src/dest port + IP protocol.\n+ * zone: application defined value cupled with 5-tuple to identify flow,\n+ * example - VxLAN, VLAN.\n+ * SFT: Statfull flow table\n+ * SFT in scope of ethernet device (port) is HW offloaded lookup table\n+ * where key is zone + 5-tuple & value is statefull flow context.\n+ * Contents of the SFT maintained by SFT PMD (see SFT PMD API in rte_sft).\n+ *\n+ * The structure describes SFT flow context.\n+ * All the fields of the structure, except @p fid, should be considered as\n+ * user defined.\n+ * The @p fid assigned by RTE SFT & used as unique flow identifier.\n+ * SFT context attached to packet by action ``SFT`` (see RTE_FLOW_ACTION_SFT).\n+ *\n+ * SFT default context defined as context attached to packet when there is no\n+ * entry for the flow in SFT. The @p state has application reserved value\n+ * meaning that SFT context for the packet undefined since entry wasn't found\n+ * in SFT. If state 'undefined' then @p zone should be valid othervice @p fid\n+ * should be valid.\n+ *\n+ * Context considered virtual since the method of storing this info on packet\n+ * is PMD/implementation specific & may involve mapping methods if there is\n+ * 'not enough bits' to store entire contents of struct rte_flow_item_sft.\n+ *\n+ * Maximal value/size of each field depends on HW capabilities and considered\n+ * as implementation specific.\n+ */\n+struct rte_flow_item_sft {\n+\tunion {\n+\t\tuint32_t fid; /**< SFT flow identifier. */\n+\t\tuint32_t zone; /**< Zone assigned to flow. */\n+\t};\n+\tuint8_t state; /**< User defined flow state. */\n+\tuint8_t fid_valid:1; /**< fid field validity bit. */\n+\tuint8_t zone_valid:1; /**< zone fieald validity bit. */\n+\tuint8_t state_valid:1; /**< state fieald validity bit. */\n+\tuint8_t user_data_size; /**< user_data buffer size. */\n+\tuint8_t *user_data; /**< Arbitrary user data. */\n+};\n+\n /**\n * Matching pattern item definition.\n *\n@@ -2132,6 +2186,15 @@ enum rte_flow_action_type {\n \t * see enum RTE_ETH_EVENT_FLOW_AGED\n \t */\n \tRTE_FLOW_ACTION_TYPE_AGE,\n+\n+\t/**\n+\t * RTE_FLOW_ACTION_TYPE_SFT\n+\t *\n+\t * Set SFT context and redirect to continue processing.\n+\t *\n+\t * See struct rte_flow_action_sft.\n+\t */\n+\tRTE_FLOW_ACTION_TYPE_SFT,\n };\n \n /**\n@@ -2721,6 +2784,27 @@ rte_flow_dynf_metadata_set(struct rte_mbuf *m, uint32_t v)\n \t*RTE_FLOW_DYNF_METADATA(m) = v;\n }\n \n+/**\n+ * @warning\n+ * @b EXPERIMENTAL: this structure may change without prior notice\n+ *\n+ * RTE_FLOW_ACTION_TYPE_SFT\n+ *\n+ * Attaches an SFT context (see struct rte_flow_item_sft) to packet.\n+ *\n+ * Performs lookup by *zone* and 5-tuple in SFT; if entry found the related SFT\n+ * context will be attached othervise default SFT context attached (see\n+ * 'SFT default context' in struct rte_flow_item_sft description).\n+ * Adding action of type ``SFT`` to the list of rule actions may impose\n+ * limitations on other rule actions added to the list, depending on specific\n+ * PMD implementation.\n+ *\n+ * For 5-tuple, zone & SFT definitions see `struct rte_flow_item_sft`.\n+ */\n+struct rte_flow_action_sft {\n+\tuint32_t zone; /**< Zone for lookup in SFT */\n+};\n+\n /*\n * Definition of a single action.\n *\n", "prefixes": [ "RFC", "1/3" ] }