Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/133103/?format=api
{ "id": 133103, "url": "http://patchwork.dpdk.org/api/patches/133103/?format=api", "web_url": "http://patchwork.dpdk.org/project/dpdk/patch/20231020205759.195126-26-stephen@networkplumber.org/", "project": { "id": 1, "url": "http://patchwork.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": "<20231020205759.195126-26-stephen@networkplumber.org>", "list_archive_url": "https://inbox.dpdk.org/dev/20231020205759.195126-26-stephen@networkplumber.org", "date": "2023-10-20T20:57:58", "name": "[v5,25/26] eventdev: make many API's stable", "commit_ref": null, "pull_url": null, "state": "superseded", "archived": true, "hash": "d5485d5a899383a021fd2dd82ef8fd1850ece3ab", "submitter": { "id": 27, "url": "http://patchwork.dpdk.org/api/people/27/?format=api", "name": "Stephen Hemminger", "email": "stephen@networkplumber.org" }, "delegate": { "id": 1, "url": "http://patchwork.dpdk.org/api/users/1/?format=api", "username": "tmonjalo", "first_name": "Thomas", "last_name": "Monjalon", "email": "thomas@monjalon.net" }, "mbox": "http://patchwork.dpdk.org/project/dpdk/patch/20231020205759.195126-26-stephen@networkplumber.org/mbox/", "series": [ { "id": 29935, "url": "http://patchwork.dpdk.org/api/series/29935/?format=api", "web_url": "http://patchwork.dpdk.org/project/dpdk/list/?series=29935", "date": "2023-10-20T20:57:33", "name": "Promote many experimental API's to stable", "version": 5, "mbox": "http://patchwork.dpdk.org/series/29935/mbox/" } ], "comments": "http://patchwork.dpdk.org/api/patches/133103/comments/", "check": "success", "checks": "http://patchwork.dpdk.org/api/patches/133103/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 C1816431BE;\n\tFri, 20 Oct 2023 23:01:43 +0200 (CEST)", "from mails.dpdk.org (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id 00FDB42E48;\n\tFri, 20 Oct 2023 22:58:45 +0200 (CEST)", "from mail-pl1-f169.google.com (mail-pl1-f169.google.com\n [209.85.214.169])\n by mails.dpdk.org (Postfix) with ESMTP id D2DC4402DD\n for <dev@dpdk.org>; Fri, 20 Oct 2023 22:58:35 +0200 (CEST)", "by mail-pl1-f169.google.com with SMTP id\n d9443c01a7336-1cace3e142eso6355385ad.3\n for <dev@dpdk.org>; Fri, 20 Oct 2023 13:58:35 -0700 (PDT)", "from hermes.local (204-195-126-68.wavecable.com. [204.195.126.68])\n by smtp.gmail.com with ESMTPSA id\n u17-20020a170902e5d100b001c61512f2a6sm1930961plf.220.2023.10.20.13.58.34\n (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256);\n Fri, 20 Oct 2023 13:58:34 -0700 (PDT)" ], "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed;\n d=networkplumber-org.20230601.gappssmtp.com; s=20230601; t=1697835515;\n x=1698440315; 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=fxEnMR+/qMY6gI3fQCg2JKBAer68u5/98lSv43La7h8=;\n b=Gh5vMLTxl7jc78RzUYoQO8xfUoVWGBHEIB0IjUQN62qXA76Zyv3So5VC4v5QoV/8YU\n ZK05A2IiVIOPsYqd4lkz//TJwibY+cUyzoBan4JGkQSMJO2h3/tYCX+a3wWNmboG4u+5\n T4xvRzbiCxp9zZqq8TtWVLOHZCRK4eBSdB0VExLOgNro0/wgwchz8DaYfkd1nfJj8i5X\n Kf920oWrhkq/VYvMW5LfwWqMyhQtusvyeLy+vCiK29thJykSZ1U4vXf36Kt7zHEgFSoB\n RIoI/yR2leTaXaFA+DV466UEMXGJdZwFhLb3It/4nOtHD29tPCffXw5jbqs1BF6cm1zT\n 38Qg==", "X-Google-DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed;\n d=1e100.net; s=20230601; t=1697835515; x=1698440315;\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=fxEnMR+/qMY6gI3fQCg2JKBAer68u5/98lSv43La7h8=;\n b=G/17hxTIA99DPCIpwQTGa3qoCLDS5gv75gdVEinkCz/kUAyUBIa1CZn3mcxRFw8uEU\n 51OW2GzjOu290065K5GnVgEabuvwZ7UbjvpGWk0yJNh2AM6yxe+TwixnfL1Ej0y3Gc6p\n 4EK+TJs92MVfx6PXEbi3XImhzsEXDVGpf+SBh74b39KGLda5Xr73FTP1SrQ68LH983WJ\n +3iyzeUUY78zEWng8u2S/vwfktHU9nrlKrv9d+ec/4bx4K379v2CZfq2P2qBvQ4nJJ6U\n GCN/3DHxBYfzAKqyb+e2aHfHMem59qaqDS2ym1mviCJBTJVsq2jA2aDRv++BZ9i2+br1\n fN1g==", "X-Gm-Message-State": "AOJu0YwsLCjm2XVo2AthryhVSK+krjlhVUmQoBEhj1Aep7uYI1ZhnBlO\n trV80zKuYx/Co8znMs0x6VrcmRp1xmFwetyIW4LSRg==", "X-Google-Smtp-Source": "\n AGHT+IFQgjb6ZuRK1RJ02odzjqtY+wtByhvM9U1OlbTZOdHZ5cC4bEEMZx7hRG3xUb7CkDcSODSRMg==", "X-Received": "by 2002:a17:902:fb88:b0:1c7:49dd:2df with SMTP id\n lg8-20020a170902fb8800b001c749dd02dfmr2930879plb.32.1697835514819;\n Fri, 20 Oct 2023 13:58:34 -0700 (PDT)", "From": "Stephen Hemminger <stephen@networkplumber.org>", "To": "dev@dpdk.org", "Cc": "Stephen Hemminger <stephen@networkplumber.org>,\n Abhinandan Gujjar <abhinandan.gujjar@intel.com>,\n Jerin Jacob <jerinj@marvell.com>,\n Naga Harish K S V <s.v.naga.harish.k@intel.com>,\n Erik Gabriel Carrillo <erik.g.carrillo@intel.com>", "Subject": "[PATCH v5 25/26] eventdev: make many API's stable", "Date": "Fri, 20 Oct 2023 13:57:58 -0700", "Message-Id": "<20231020205759.195126-26-stephen@networkplumber.org>", "X-Mailer": "git-send-email 2.39.2", "In-Reply-To": "<20231020205759.195126-1-stephen@networkplumber.org>", "References": "<20230808173527.186042-1-stephen@networkplumber.org>\n <20231020205759.195126-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": "All API's in eventdev up to 22.11 release should be made stable.\n\nSigned-off-by: Stephen Hemminger <stephen@networkplumber.org>\n---\n lib/eventdev/rte_event_crypto_adapter.h | 4 ---\n lib/eventdev/rte_event_eth_rx_adapter.h | 6 -----\n lib/eventdev/rte_event_eth_tx_adapter.h | 3 ---\n lib/eventdev/rte_event_timer_adapter.h | 3 ---\n lib/eventdev/rte_eventdev.h | 4 ---\n lib/eventdev/version.map | 34 ++++++++++---------------\n 6 files changed, 13 insertions(+), 41 deletions(-)", "diff": "diff --git a/lib/eventdev/rte_event_crypto_adapter.h b/lib/eventdev/rte_event_crypto_adapter.h\nindex 4e1f1bb3a8e6..e07f159b7760 100644\n--- a/lib/eventdev/rte_event_crypto_adapter.h\n+++ b/lib/eventdev/rte_event_crypto_adapter.h\n@@ -694,9 +694,6 @@ rte_event_crypto_adapter_runtime_params_get(uint8_t id,\n \t\tstruct rte_event_crypto_adapter_runtime_params *params);\n \n /**\n- * @warning\n- * @b EXPERIMENTAL: this API may change without prior notice\n- *\n * Retrieve vector limits for a given event dev and crypto dev pair.\n * @see rte_event_crypto_adapter_vector_limits\n *\n@@ -712,7 +709,6 @@ rte_event_crypto_adapter_runtime_params_get(uint8_t id,\n * - 0: Success.\n * - <0: Error code on failure.\n */\n-__rte_experimental\n int rte_event_crypto_adapter_vector_limits_get(\n \tuint8_t dev_id, uint16_t cdev_id,\n \tstruct rte_event_crypto_adapter_vector_limits *limits);\ndiff --git a/lib/eventdev/rte_event_eth_rx_adapter.h b/lib/eventdev/rte_event_eth_rx_adapter.h\nindex 842581e87e02..cf42c69b0d71 100644\n--- a/lib/eventdev/rte_event_eth_rx_adapter.h\n+++ b/lib/eventdev/rte_event_eth_rx_adapter.h\n@@ -466,7 +466,6 @@ int rte_event_eth_rx_adapter_create(uint8_t id, uint8_t dev_id,\n * - 0: Success\n * - <0: Error code on failure\n */\n-__rte_experimental\n int rte_event_eth_rx_adapter_create_with_params(uint8_t id, uint8_t dev_id,\n \t\t\tstruct rte_event_port_conf *port_config,\n \t\t\tstruct rte_event_eth_rx_adapter_params *rxa_params);\n@@ -711,7 +710,6 @@ int rte_event_eth_rx_adapter_vector_limits_get(\n * - 0: Success, Receive queue added correctly.\n * - <0: Error code on failure.\n */\n-__rte_experimental\n int rte_event_eth_rx_adapter_queue_conf_get(uint8_t id,\n \t\t\tuint16_t eth_dev_id,\n \t\t\tuint16_t rx_queue_id,\n@@ -736,7 +734,6 @@ int rte_event_eth_rx_adapter_queue_conf_get(uint8_t id,\n * - 0: Success, queue buffer stats retrieved.\n * - <0: Error code on failure.\n */\n-__rte_experimental\n int\n rte_event_eth_rx_adapter_queue_stats_get(uint8_t id,\n \t\tuint16_t eth_dev_id,\n@@ -759,7 +756,6 @@ rte_event_eth_rx_adapter_queue_stats_get(uint8_t id,\n * - 0: Success, queue buffer stats retrieved.\n * - <0: Error code on failure.\n */\n-__rte_experimental\n int\n rte_event_eth_rx_adapter_queue_stats_reset(uint8_t id,\n \t\tuint16_t eth_dev_id,\n@@ -780,7 +776,6 @@ rte_event_eth_rx_adapter_queue_stats_reset(uint8_t id,\n * - <0: Error code on failure, if the adapter doesn't use a rte_service\n * function, this function returns -ESRCH.\n */\n-__rte_experimental\n int\n rte_event_eth_rx_adapter_event_port_get(uint8_t id, uint8_t *event_port_id);\n \n@@ -801,7 +796,6 @@ rte_event_eth_rx_adapter_event_port_get(uint8_t id, uint8_t *event_port_id);\n * - 0: Success\n * - <0: Error code on failure\n */\n-__rte_experimental\n int\n rte_event_eth_rx_adapter_instance_get(uint16_t eth_dev_id,\n \t\t\t\t uint16_t rx_queue_id,\ndiff --git a/lib/eventdev/rte_event_eth_tx_adapter.h b/lib/eventdev/rte_event_eth_tx_adapter.h\nindex 1ea9a153164d..b38b3fce979b 100644\n--- a/lib/eventdev/rte_event_eth_tx_adapter.h\n+++ b/lib/eventdev/rte_event_eth_tx_adapter.h\n@@ -492,7 +492,6 @@ rte_event_eth_tx_adapter_service_id_get(uint8_t id, uint32_t *service_id);\n * - 0: Success\n * - <0: Error code on failure\n */\n-__rte_experimental\n int\n rte_event_eth_tx_adapter_instance_get(uint16_t eth_dev_id,\n \t\t\t\t uint16_t tx_queue_id,\n@@ -527,7 +526,6 @@ rte_event_eth_tx_adapter_instance_get(uint16_t eth_dev_id,\n * - 0: Success\n * - <0: Error code on failure\n */\n-__rte_experimental\n int\n rte_event_eth_tx_adapter_queue_start(uint16_t eth_dev_id, uint16_t tx_queue_id);\n \n@@ -546,7 +544,6 @@ rte_event_eth_tx_adapter_queue_start(uint16_t eth_dev_id, uint16_t tx_queue_id);\n * - 0: Success\n * - <0: Error code on failure\n */\n-__rte_experimental\n int\n rte_event_eth_tx_adapter_queue_stop(uint16_t eth_dev_id, uint16_t tx_queue_id);\n \ndiff --git a/lib/eventdev/rte_event_timer_adapter.h b/lib/eventdev/rte_event_timer_adapter.h\nindex fbdddf8f91bd..686cf80a675f 100644\n--- a/lib/eventdev/rte_event_timer_adapter.h\n+++ b/lib/eventdev/rte_event_timer_adapter.h\n@@ -689,9 +689,6 @@ rte_event_timer_cancel_burst(const struct rte_event_timer_adapter *adapter,\n }\n \n /**\n- * @warning\n- * @b EXPERIMENTAL: this API may change without prior notice\n- *\n * Get the number of ticks remaining until event timer expiry.\n *\n * @param adapter\ndiff --git a/lib/eventdev/rte_eventdev.h b/lib/eventdev/rte_eventdev.h\nindex 2ea98302b89f..ec9b02455d2e 100644\n--- a/lib/eventdev/rte_eventdev.h\n+++ b/lib/eventdev/rte_eventdev.h\n@@ -785,7 +785,6 @@ rte_event_queue_attr_get(uint8_t dev_id, uint8_t queue_id, uint32_t attr_id,\n * - -ENOTSUP: device does not support setting the event attribute.\n * - <0: failed to set event queue attribute\n */\n-__rte_experimental\n int\n rte_event_queue_attr_set(uint8_t dev_id, uint8_t queue_id, uint32_t attr_id,\n \t\t\t uint64_t attr_value);\n@@ -948,7 +947,6 @@ typedef void (*rte_eventdev_port_flush_t)(uint8_t dev_id,\n * @param args\n * Argument supplied to callback.\n */\n-__rte_experimental\n void\n rte_event_port_quiesce(uint8_t dev_id, uint8_t port_id,\n \t\t rte_eventdev_port_flush_t release_cb, void *args);\n@@ -2465,7 +2463,6 @@ rte_event_dequeue_burst(uint8_t dev_id, uint8_t port_id, struct rte_event ev[],\n *\n * @see RTE_EVENT_DEV_CAP_MAINTENANCE_FREE\n */\n-__rte_experimental\n static inline int\n rte_event_maintain(uint8_t dev_id, uint8_t port_id, int op)\n {\n@@ -2514,7 +2511,6 @@ rte_event_maintain(uint8_t dev_id, uint8_t port_id, int op)\n * - 0 on success.\n * - -EINVAL if *dev_id*, *port_id*, or *profile_id* is invalid.\n */\n-__rte_experimental\n static inline uint8_t\n rte_event_port_profile_switch(uint8_t dev_id, uint8_t port_id, uint8_t profile_id)\n {\ndiff --git a/lib/eventdev/version.map b/lib/eventdev/version.map\nindex 42a2f7206e4e..3d5c6c2b835c 100644\n--- a/lib/eventdev/version.map\n+++ b/lib/eventdev/version.map\n@@ -5,6 +5,7 @@ DPDK_24 {\n \t__rte_eventdev_trace_deq_burst;\n \t__rte_eventdev_trace_enq_burst;\n \t__rte_eventdev_trace_eth_tx_adapter_enqueue;\n+\t__rte_eventdev_trace_maintain;\n \t__rte_eventdev_trace_timer_arm_burst;\n \t__rte_eventdev_trace_timer_arm_tmo_tick_burst;\n \t__rte_eventdev_trace_timer_cancel_burst;\n@@ -20,6 +21,7 @@ DPDK_24 {\n \trte_event_crypto_adapter_stats_get;\n \trte_event_crypto_adapter_stats_reset;\n \trte_event_crypto_adapter_stop;\n+\trte_event_crypto_adapter_vector_limits_get;\n \trte_event_dequeue_timeout_ticks;\n \trte_event_dev_attr_get;\n \trte_event_dev_close;\n@@ -42,9 +44,15 @@ DPDK_24 {\n \trte_event_eth_rx_adapter_cb_register;\n \trte_event_eth_rx_adapter_create;\n \trte_event_eth_rx_adapter_create_ext;\n+\trte_event_eth_rx_adapter_create_with_params;\n+\trte_event_eth_rx_adapter_event_port_get;\n \trte_event_eth_rx_adapter_free;\n+\trte_event_eth_rx_adapter_instance_get;\n \trte_event_eth_rx_adapter_queue_add;\n+\trte_event_eth_rx_adapter_queue_conf_get;\n \trte_event_eth_rx_adapter_queue_del;\n+\trte_event_eth_rx_adapter_queue_stats_get;\n+\trte_event_eth_rx_adapter_queue_stats_reset;\n \trte_event_eth_rx_adapter_service_id_get;\n \trte_event_eth_rx_adapter_start;\n \trte_event_eth_rx_adapter_stats_get;\n@@ -56,8 +64,11 @@ DPDK_24 {\n \trte_event_eth_tx_adapter_create_ext;\n \trte_event_eth_tx_adapter_event_port_get;\n \trte_event_eth_tx_adapter_free;\n+\trte_event_eth_tx_adapter_instance_get;\n \trte_event_eth_tx_adapter_queue_add;\n \trte_event_eth_tx_adapter_queue_del;\n+\trte_event_eth_tx_adapter_queue_start;\n+\trte_event_eth_tx_adapter_queue_stop;\n \trte_event_eth_tx_adapter_service_id_get;\n \trte_event_eth_tx_adapter_start;\n \trte_event_eth_tx_adapter_stats_get;\n@@ -68,10 +79,12 @@ DPDK_24 {\n \trte_event_port_default_conf_get;\n \trte_event_port_link;\n \trte_event_port_links_get;\n+\trte_event_port_quiesce;\n \trte_event_port_setup;\n \trte_event_port_unlink;\n \trte_event_port_unlinks_in_progress;\n \trte_event_queue_attr_get;\n+\trte_event_queue_attr_set;\n \trte_event_queue_default_conf_get;\n \trte_event_queue_setup;\n \trte_event_ring_create;\n@@ -100,27 +113,6 @@ DPDK_24 {\n EXPERIMENTAL {\n \tglobal:\n \n-\t# added in 21.11\n-\t__rte_eventdev_trace_maintain;\n-\trte_event_eth_rx_adapter_create_with_params;\n-\trte_event_eth_rx_adapter_queue_conf_get;\n-\trte_event_eth_rx_adapter_queue_stats_get;\n-\trte_event_eth_rx_adapter_queue_stats_reset;\n-\n-\t# added in 22.03\n-\trte_event_eth_rx_adapter_event_port_get;\n-\n-\t# added in 22.07\n-\trte_event_crypto_adapter_vector_limits_get;\n-\trte_event_port_quiesce;\n-\trte_event_queue_attr_set;\n-\n-\t# added in 22.11\n-\trte_event_eth_rx_adapter_instance_get;\n-\trte_event_eth_tx_adapter_instance_get;\n-\trte_event_eth_tx_adapter_queue_start;\n-\trte_event_eth_tx_adapter_queue_stop;\n-\n \t# added in 23.03\n \trte_event_crypto_adapter_runtime_params_get;\n \trte_event_crypto_adapter_runtime_params_init;\n", "prefixes": [ "v5", "25/26" ] }