Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/133106/?format=api
http://patches.dpdk.org/api/patches/133106/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/patch/20231020214119.255491-3-stephen@networkplumber.org/", "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": "<20231020214119.255491-3-stephen@networkplumber.org>", "list_archive_url": "https://inbox.dpdk.org/dev/20231020214119.255491-3-stephen@networkplumber.org", "date": "2023-10-20T21:41:07", "name": "[v2,02/14] eal: mark rte_dev API's as stable", "commit_ref": null, "pull_url": null, "state": "accepted", "archived": true, "hash": "1ad3ea3788614eb50086f0c9741c74c22f5c300d", "submitter": { "id": 27, "url": "http://patches.dpdk.org/api/people/27/?format=api", "name": "Stephen Hemminger", "email": "stephen@networkplumber.org" }, "delegate": { "id": 24651, "url": "http://patches.dpdk.org/api/users/24651/?format=api", "username": "dmarchand", "first_name": "David", "last_name": "Marchand", "email": "david.marchand@redhat.com" }, "mbox": "http://patches.dpdk.org/project/dpdk/patch/20231020214119.255491-3-stephen@networkplumber.org/mbox/", "series": [ { "id": 29936, "url": "http://patches.dpdk.org/api/series/29936/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/list/?series=29936", "date": "2023-10-20T21:41:05", "name": "eal: mark older API's as stable", "version": 2, "mbox": "http://patches.dpdk.org/series/29936/mbox/" } ], "comments": "http://patches.dpdk.org/api/patches/133106/comments/", "check": "success", "checks": "http://patches.dpdk.org/api/patches/133106/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 4618A431BE;\n\tFri, 20 Oct 2023 23:41:46 +0200 (CEST)", "from mails.dpdk.org (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id 4C36840DC9;\n\tFri, 20 Oct 2023 23:41:37 +0200 (CEST)", "from mail-pg1-f182.google.com (mail-pg1-f182.google.com\n [209.85.215.182])\n by mails.dpdk.org (Postfix) with ESMTP id A603A402E0\n for <dev@dpdk.org>; Fri, 20 Oct 2023 23:41:33 +0200 (CEST)", "by mail-pg1-f182.google.com with SMTP id\n 41be03b00d2f7-5b5354da665so870698a12.2\n for <dev@dpdk.org>; Fri, 20 Oct 2023 14:41:33 -0700 (PDT)", "from hermes.local (204-195-126-68.wavecable.com. [204.195.126.68])\n by smtp.gmail.com with ESMTPSA id\n 19-20020a631753000000b005894450b404sm1886543pgx.63.2023.10.20.14.41.31\n (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256);\n Fri, 20 Oct 2023 14:41:31 -0700 (PDT)" ], "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed;\n d=networkplumber-org.20230601.gappssmtp.com; s=20230601; t=1697838092;\n x=1698442892; darn=dpdk.org;\n h=content-transfer-encoding:mime-version:references:in-reply-to\n :message-id:date:subject:cc:to:from:from:to:cc:subject:date\n :message-id:reply-to;\n bh=lIGExvbjqvTLu9DYMWuFCnLXrcEDJA9Qb6lqIsdDDgI=;\n b=1gtcgBpLZm4E7WAaQLMjLxmp2L9yqbbAiNbBfK6eceLzYTX4IUL/eBfkbpKHJm0Kjm\n irXjCHkOCVUNOox3F7fzRB451th0nPI2F1Paps5h3OFXRif1FN8Fa+lUdhS35u9BGwvK\n zNZBEJB9osGzMBzPCIg6A6dsCHOBikP8h0/c0eTXiGpnK5x7+CmUz/WamsdX4Z27+2Om\n IKUPiM89evi0MDLEFZih8SSti5+ht44LPVJU8iXtCJecIrsZSTl0Huz8LZ/pcPvgllkp\n 6scfo5WEb3cDwJ+/m+n2+Weso8UDRXUTBa4GTLI2jDumK7EW95yEAQWAbd3wF8vv3uf3\n pgpA==", "X-Google-DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed;\n d=1e100.net; s=20230601; t=1697838092; x=1698442892;\n h=content-transfer-encoding:mime-version:references:in-reply-to\n :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc\n :subject:date:message-id:reply-to;\n bh=lIGExvbjqvTLu9DYMWuFCnLXrcEDJA9Qb6lqIsdDDgI=;\n b=VMZB+498BAbkAhkSvBrqF1PRaXjEyzbK6CNI7xHG2wZfZ97oaLARFbXhQMmHmO/2YT\n aJaE6klHnchWE40kKv312iK5nPn+8YiY0S+NaTapm/WHbjGgZ9WNmTqDS0zNKA7vSKQ8\n on/K6nYtiMRgNfKZ+ecI4CBNrqJo0gODm+HLq0adn9x5mhzc8UoADUe/xQwpGda4rd4d\n NWBbL1KA2aT45LxJCIYPdKSnYcEKGXEo9JgES3mxofemgGH8mMn1m5Mdv51cAIwaKdGs\n wr8wObliwu3pp2LmJaiCKlsveUHR5Y55ZrIlhEzHkWEZnenmraaObUi2Sk5o/InhBDnT\n JRKw==", "X-Gm-Message-State": "AOJu0Yws6gQAaaCTI9GJKwf6ghWXPCnzohdq2pIWBp/FmQarDooep8jQ\n RAgOlKLU9xb6Bpf2u7I36X7j1WQ+69djTO4F2dq1VA==", "X-Google-Smtp-Source": "\n AGHT+IGzCEqLD0S0VYbyCkLFLjL5DmnMsQbgrdwjYJ+u5hO3f/b60Ld4uMT7JW8TrHAniIfkn/urWw==", "X-Received": "by 2002:a05:6a21:7788:b0:16e:ab42:9837 with SMTP id\n bd8-20020a056a21778800b0016eab429837mr2996764pzc.29.1697838092172;\n Fri, 20 Oct 2023 14:41:32 -0700 (PDT)", "From": "Stephen Hemminger <stephen@networkplumber.org>", "To": "dev@dpdk.org", "Cc": "Stephen Hemminger <stephen@networkplumber.org>", "Subject": "[PATCH v2 02/14] eal: mark rte_dev API's as stable", "Date": "Fri, 20 Oct 2023 14:41:07 -0700", "Message-Id": "<20231020214119.255491-3-stephen@networkplumber.org>", "X-Mailer": "git-send-email 2.39.2", "In-Reply-To": "<20231020214119.255491-1-stephen@networkplumber.org>", "References": "<20230809164312.308093-1-stephen@networkplumber.org>\n <20231020214119.255491-1-stephen@networkplumber.org>", "MIME-Version": "1.0", "Content-Transfer-Encoding": "8bit", "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": "These have been around since 2020.\n\nSigned-off-by: Stephen Hemminger <stephen@networkplumber.org>\n---\n lib/eal/include/rte_dev.h | 32 --------------------------------\n lib/eal/version.map | 28 +++++++++++-----------------\n 2 files changed, 11 insertions(+), 49 deletions(-)", "diff": "diff --git a/lib/eal/include/rte_dev.h b/lib/eal/include/rte_dev.h\nindex 8568535ac04b..86ef2f54235d 100644\n--- a/lib/eal/include/rte_dev.h\n+++ b/lib/eal/include/rte_dev.h\n@@ -341,7 +341,6 @@ typedef void *(*rte_dev_iterate_t)(const void *start,\n * 0 on successful initialization.\n * <0 on error.\n */\n-__rte_experimental\n int\n rte_dev_iterator_init(struct rte_dev_iterator *it, const char *str);\n \n@@ -361,7 +360,6 @@ rte_dev_iterator_init(struct rte_dev_iterator *it, const char *str);\n * NULL if an error occurred (rte_errno is set).\n * NULL if no device could be found (rte_errno is not set).\n */\n-__rte_experimental\n struct rte_device *\n rte_dev_iterator_next(struct rte_dev_iterator *it);\n \n@@ -372,9 +370,6 @@ rte_dev_iterator_next(struct rte_dev_iterator *it);\n \t dev = rte_dev_iterator_next(it))\n \n /**\n- * @warning\n- * @b EXPERIMENTAL: this API may change without prior notice\n- *\n * It registers the callback for the specific device.\n * Multiple callbacks can be registered at the same time.\n *\n@@ -390,16 +385,12 @@ rte_dev_iterator_next(struct rte_dev_iterator *it);\n * - On success, zero.\n * - On failure, a negative value.\n */\n-__rte_experimental\n int\n rte_dev_event_callback_register(const char *device_name,\n \t\t\t\trte_dev_event_cb_fn cb_fn,\n \t\t\t\tvoid *cb_arg);\n \n /**\n- * @warning\n- * @b EXPERIMENTAL: this API may change without prior notice\n- *\n * It unregisters the callback according to the specified device.\n *\n * @param device_name\n@@ -415,16 +406,12 @@ rte_dev_event_callback_register(const char *device_name,\n * - On success, return the number of callback entities removed.\n * - On failure, a negative value.\n */\n-__rte_experimental\n int\n rte_dev_event_callback_unregister(const char *device_name,\n \t\t\t\t rte_dev_event_cb_fn cb_fn,\n \t\t\t\t void *cb_arg);\n \n /**\n- * @warning\n- * @b EXPERIMENTAL: this API may change without prior notice\n- *\n * Executes all the user application registered callbacks for\n * the specific device.\n *\n@@ -433,64 +420,47 @@ rte_dev_event_callback_unregister(const char *device_name,\n * @param event\n * the device event type.\n */\n-__rte_experimental\n void\n rte_dev_event_callback_process(const char *device_name,\n \t\t\t enum rte_dev_event_type event);\n \n /**\n- * @warning\n- * @b EXPERIMENTAL: this API may change without prior notice\n- *\n * Start the device event monitoring.\n *\n * @return\n * - On success, zero.\n * - On failure, a negative value.\n */\n-__rte_experimental\n int\n rte_dev_event_monitor_start(void);\n \n /**\n- * @warning\n- * @b EXPERIMENTAL: this API may change without prior notice\n- *\n * Stop the device event monitoring.\n *\n * @return\n * - On success, zero.\n * - On failure, a negative value.\n */\n-__rte_experimental\n int\n rte_dev_event_monitor_stop(void);\n \n /**\n- * @warning\n- * @b EXPERIMENTAL: this API may change without prior notice\n- *\n * Enable hotplug handling for devices.\n *\n * @return\n * - On success, zero.\n * - On failure, a negative value.\n */\n-__rte_experimental\n int\n rte_dev_hotplug_handle_enable(void);\n \n /**\n- * @warning\n- * @b EXPERIMENTAL: this API may change without prior notice\n- *\n * Disable hotplug handling for devices.\n *\n * @return\n * - On success, zero.\n * - On failure, a negative value.\n */\n-__rte_experimental\n int\n rte_dev_hotplug_handle_disable(void);\n \n@@ -514,7 +484,6 @@ rte_dev_hotplug_handle_disable(void);\n *\t0 if mapping was successful.\n *\tNegative value and rte_errno is set otherwise.\n */\n-__rte_experimental\n int\n rte_dev_dma_map(struct rte_device *dev, void *addr, uint64_t iova, size_t len);\n \n@@ -538,7 +507,6 @@ rte_dev_dma_map(struct rte_device *dev, void *addr, uint64_t iova, size_t len);\n *\t0 if un-mapping was successful.\n *\tNegative value and rte_errno is set otherwise.\n */\n-__rte_experimental\n int\n rte_dev_dma_unmap(struct rte_device *dev, void *addr, uint64_t iova,\n \t\t size_t len);\ndiff --git a/lib/eal/version.map b/lib/eal/version.map\nindex e00a844805bb..01ff887358fa 100644\n--- a/lib/eal/version.map\n+++ b/lib/eal/version.map\n@@ -28,8 +28,19 @@ DPDK_24 {\n \trte_dev_bus;\n \trte_dev_bus_info;\n \trte_dev_devargs;\n+\trte_dev_dma_map;\n+\trte_dev_dma_unmap;\n \trte_dev_driver;\n+\trte_dev_event_callback_process;\n+\trte_dev_event_callback_register;\n+\trte_dev_event_callback_unregister;\n+\trte_dev_event_monitor_start;\n+\trte_dev_event_monitor_stop;\n+\trte_dev_hotplug_handle_disable;\n+\trte_dev_hotplug_handle_enable;\n \trte_dev_is_probed;\n+\trte_dev_iterator_init;\n+\trte_dev_iterator_next;\n \trte_dev_name;\n \trte_dev_numa_node;\n \trte_dev_probe;\n@@ -309,28 +320,11 @@ DPDK_24 {\n EXPERIMENTAL {\n \tglobal:\n \n-\t# added in 18.05\n-\trte_dev_event_callback_register;\n-\trte_dev_event_callback_unregister;\n-\trte_dev_event_monitor_start;\n-\trte_dev_event_monitor_stop;\n-\n \t# added in 18.08\n \trte_class_find;\n \trte_class_find_by_name;\n \trte_class_register;\n \trte_class_unregister;\n-\trte_dev_iterator_init;\n-\trte_dev_iterator_next;\n-\n-\t# added in 18.11\n-\trte_dev_event_callback_process;\n-\trte_dev_hotplug_handle_disable;\n-\trte_dev_hotplug_handle_enable;\n-\n-\t# added in 19.05\n-\trte_dev_dma_map;\n-\trte_dev_dma_unmap;\n \n \t# added in 20.05\n \t__rte_eal_trace_generic_double;\n", "prefixes": [ "v2", "02/14" ] }{ "id": 133106, "url": "