Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/133821/?format=api
{ "id": 133821, "url": "http://patches.dpdk.org/api/patches/133821/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/patch/20231103073811.13196-2-fengchengwen@huawei.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": "<20231103073811.13196-2-fengchengwen@huawei.com>", "list_archive_url": "https://inbox.dpdk.org/dev/20231103073811.13196-2-fengchengwen@huawei.com", "date": "2023-11-03T07:38:07", "name": "[v3,1/5] kvargs: add one new process API", "commit_ref": null, "pull_url": null, "state": "changes-requested", "archived": true, "hash": "84d388592573a59c8e7c9931a04aac90e2b949be", "submitter": { "id": 2146, "url": "http://patches.dpdk.org/api/people/2146/?format=api", "name": "fengchengwen", "email": "fengchengwen@huawei.com" }, "delegate": { "id": 319, "url": "http://patches.dpdk.org/api/users/319/?format=api", "username": "fyigit", "first_name": "Ferruh", "last_name": "Yigit", "email": "ferruh.yigit@amd.com" }, "mbox": "http://patches.dpdk.org/project/dpdk/patch/20231103073811.13196-2-fengchengwen@huawei.com/mbox/", "series": [ { "id": 30132, "url": "http://patches.dpdk.org/api/series/30132/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/list/?series=30132", "date": "2023-11-03T07:38:06", "name": "fix segment fault when parse args", "version": 3, "mbox": "http://patches.dpdk.org/series/30132/mbox/" } ], "comments": "http://patches.dpdk.org/api/patches/133821/comments/", "check": "warning", "checks": "http://patches.dpdk.org/api/patches/133821/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 mails.dpdk.org (mails.dpdk.org [217.70.189.124])\n\tby inbox.dpdk.org (Postfix) with ESMTP id AAD8B43277;\n\tFri, 3 Nov 2023 08:41:12 +0100 (CET)", "from mails.dpdk.org (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id AC62942D9A;\n\tFri, 3 Nov 2023 08:40:57 +0100 (CET)", "from szxga03-in.huawei.com (szxga03-in.huawei.com [45.249.212.189])\n by mails.dpdk.org (Postfix) with ESMTP id 4B6E94027F\n for <dev@dpdk.org>; Fri, 3 Nov 2023 08:40:53 +0100 (CET)", "from dggpeml100024.china.huawei.com (unknown [172.30.72.53])\n by szxga03-in.huawei.com (SkyGuard) with ESMTP id 4SMCGy54FrzMmMN;\n Fri, 3 Nov 2023 15:36:26 +0800 (CST)", "from localhost.localdomain (10.50.165.33) by\n dggpeml100024.china.huawei.com (7.185.36.115) with Microsoft SMTP Server\n (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id\n 15.1.2507.31; Fri, 3 Nov 2023 15:40:49 +0800" ], "From": "Chengwen Feng <fengchengwen@huawei.com>", "To": "<thomas@monjalon.net>, <ferruh.yigit@amd.com>", "CC": "<dev@dpdk.org>, <stephen@networkplumber.org>", "Subject": "[PATCH v3 1/5] kvargs: add one new process API", "Date": "Fri, 3 Nov 2023 07:38:07 +0000", "Message-ID": "<20231103073811.13196-2-fengchengwen@huawei.com>", "X-Mailer": "git-send-email 2.17.1", "In-Reply-To": "<20231103073811.13196-1-fengchengwen@huawei.com>", "References": "<20230314124813.39521-1-fengchengwen@huawei.com>\n <20231103073811.13196-1-fengchengwen@huawei.com>", "MIME-Version": "1.0", "Content-Type": "text/plain", "X-Originating-IP": "[10.50.165.33]", "X-ClientProxiedBy": "dggems701-chm.china.huawei.com (10.3.19.178) To\n dggpeml100024.china.huawei.com (7.185.36.115)", "X-CFilter-Loop": "Reflected", "X-BeenThere": "dev@dpdk.org", "X-Mailman-Version": "2.1.29", "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" }, "content": "The rte_kvargs_process() was used to parse key-value (e.g. socket_id=0),\nit also supports to parse only-key (e.g. socket_id). But many drivers's\ncallback can only handle key-value, it will segment fault if handles\nonly-key. so the patchset [1] was introduced.\n\nBecause the patchset [1] modified too much drivers, therefore:\n1) A new API rte_kvargs_process_opt() was introduced, it inherits the\nfunction of rte_kvargs_process() which could parse both key-value and\nonly-key.\n2) Constraint the rte_kvargs_process() can only parse key-value.\n\n[1] https://patches.dpdk.org/project/dpdk/patch/20230320092110.37295-1-fengchengwen@huawei.com/\n\nSigned-off-by: Chengwen Feng <fengchengwen@huawei.com>\n---\n lib/kvargs/rte_kvargs.c | 29 ++++++++++++++++++++++++++++-\n lib/kvargs/rte_kvargs.h | 28 ++++++++++++++++++++++++++++\n lib/kvargs/version.map | 3 +++\n 3 files changed, 59 insertions(+), 1 deletion(-)", "diff": "diff --git a/lib/kvargs/rte_kvargs.c b/lib/kvargs/rte_kvargs.c\nindex c77bb82feb..5ce8664238 100644\n--- a/lib/kvargs/rte_kvargs.c\n+++ b/lib/kvargs/rte_kvargs.c\n@@ -168,7 +168,7 @@ rte_kvargs_count(const struct rte_kvargs *kvlist, const char *key_match)\n }\n \n /*\n- * For each matching key, call the given handler function.\n+ * For each matching key in key/value, call the given handler function.\n */\n int\n rte_kvargs_process(const struct rte_kvargs *kvlist,\n@@ -179,6 +179,33 @@ rte_kvargs_process(const struct rte_kvargs *kvlist,\n \tconst struct rte_kvargs_pair *pair;\n \tunsigned i;\n \n+\tif (kvlist == NULL)\n+\t\treturn 0;\n+\n+\tfor (i = 0; i < kvlist->count; i++) {\n+\t\tpair = &kvlist->pairs[i];\n+\t\tif (pair->value == NULL)\n+\t\t\tcontinue;\n+\t\tif (key_match == NULL || strcmp(pair->key, key_match) == 0) {\n+\t\t\tif ((*handler)(pair->key, pair->value, opaque_arg) < 0)\n+\t\t\t\treturn -1;\n+\t\t}\n+\t}\n+\treturn 0;\n+}\n+\n+/*\n+ * For each matching key in key/value or only-key, call the given handler function.\n+ */\n+int\n+rte_kvargs_process_opt(const struct rte_kvargs *kvlist,\n+\t\t const char *key_match,\n+\t\t arg_handler_t handler,\n+\t\t void *opaque_arg)\n+{\n+\tconst struct rte_kvargs_pair *pair;\n+\tunsigned int i;\n+\n \tif (kvlist == NULL)\n \t\treturn 0;\n \ndiff --git a/lib/kvargs/rte_kvargs.h b/lib/kvargs/rte_kvargs.h\nindex 4900b750bc..522e83f757 100644\n--- a/lib/kvargs/rte_kvargs.h\n+++ b/lib/kvargs/rte_kvargs.h\n@@ -195,6 +195,34 @@ const char *rte_kvargs_get_with_value(const struct rte_kvargs *kvlist,\n int rte_kvargs_process(const struct rte_kvargs *kvlist,\n \tconst char *key_match, arg_handler_t handler, void *opaque_arg);\n \n+/**\n+ * @warning\n+ * @b EXPERIMENTAL: this API may change without prior notice.\n+ *\n+ * Call a handler function for each key/value or only-key matching the key\n+ *\n+ * For each key/value or only-key association that matches the given key, calls\n+ * the handler function with the for a given arg_name passing the value on the\n+ * dictionary for that key and a given extra argument.\n+ *\n+ * @param kvlist\n+ * The rte_kvargs structure. No error if NULL.\n+ * @param key_match\n+ * The key on which the handler should be called, or NULL to process handler\n+ * on all associations\n+ * @param handler\n+ * The function to call for each matching key\n+ * @param opaque_arg\n+ * A pointer passed unchanged to the handler\n+ *\n+ * @return\n+ * - 0 on success\n+ * - Negative on error\n+ */\n+__rte_experimental\n+int rte_kvargs_process_opt(const struct rte_kvargs *kvlist,\n+\tconst char *key_match, arg_handler_t handler, void *opaque_arg);\n+\n /**\n * Count the number of associations matching the given key\n *\ndiff --git a/lib/kvargs/version.map b/lib/kvargs/version.map\nindex 387a94e725..15d482e9b3 100644\n--- a/lib/kvargs/version.map\n+++ b/lib/kvargs/version.map\n@@ -16,4 +16,7 @@ EXPERIMENTAL {\n \n \t# added in 21.11\n \trte_kvargs_get_with_value;\n+\n+\t# added in 23.11\n+\trte_kvargs_process_opt;\n };\n", "prefixes": [ "v3", "1/5" ] }