From patchwork Wed Aug 9 00:10:09 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stephen Hemminger X-Patchwork-Id: 129986 X-Patchwork-Delegate: thomas@monjalon.net Return-Path: 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]) by inbox.dpdk.org (Postfix) with ESMTP id 3EA5043011; Wed, 9 Aug 2023 02:12:49 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 8A66343278; Wed, 9 Aug 2023 02:10:56 +0200 (CEST) Received: from mail-pf1-f176.google.com (mail-pf1-f176.google.com [209.85.210.176]) by mails.dpdk.org (Postfix) with ESMTP id 3E1E2432A2 for ; Wed, 9 Aug 2023 02:10:50 +0200 (CEST) Received: by mail-pf1-f176.google.com with SMTP id d2e1a72fcca58-686fc0d3c92so4297771b3a.0 for ; Tue, 08 Aug 2023 17:10:50 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=networkplumber-org.20221208.gappssmtp.com; s=20221208; t=1691539849; x=1692144649; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=LUtMO29AXZDiMOwvgdN7am2hOn5Qj0O/8DsMFy54yJ0=; b=YWIUJ+wO/pmCPlQXFj9F9yWNuxwRBh1Y7ZO58hkHiUQASCfQRIfDQIxtmBxwebXX6d QFPnQFhr1niQP2CNTZadmwbv87T9NE7NEHe4N3QvKrKneLrtIJaw/LBtxT++1/7cbe/T ez4vdvJjtGq15vcjLiSsOwexUhT3iYnFCOlLuV3chNYrRXaEAGKpyR6oV6z0lvwLohlA OfRQab5sqOoScqwmWALqrCoPcdShHt/QEXuPX8xqxt4lcb2zMvSpmTs8j5hByxatVBka IsyBMFkkL+nqZTfaA34Sr51DurZZ9l9Vnr+K00tUKcvlOEqU3bbz+TEUtD8JnAerqaqI U3mw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1691539849; x=1692144649; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=LUtMO29AXZDiMOwvgdN7am2hOn5Qj0O/8DsMFy54yJ0=; b=aFccXIIoZwvwJawDTPvee/BxGLNIiKLz7ZPlwBjkZMKgKf7/Wvhc72bETlTZ4ozMez MH4P3oG2ONI0gCAnd5l8vTqXGvqNUIFAAWpMSAaUA5QzeCVedHsjMSrQO57qJSBLuopC fq3begV+6BZYE66u0u05GhXdQMDB9xtwzo4oDetMlU3uGSv0F4TKc8TWcKFR2g5HP6HE w/6oi1bER1YuZ80Kk2Q5D8ZgfkjOrrN+Wngb8gBn3+D9/FEBdWCaqqBDvwHxWux0Gu2o nrWmP+t1yUF1yZivxuVK7ivpALU8G7W159aIdz8ddy+GNKEArIiWYjbls9VR9CIlzwkg nnHQ== X-Gm-Message-State: AOJu0YyIBehueaXkFj+v47UHAPtf5ge6e80FQNlkoO/6ZZVDpQ/9P71A k0lxHm5sCzOF/3II2tYZambc9up7pQQFQMhRJm/TQA== X-Google-Smtp-Source: AGHT+IGI66vUQIZ/gPygqOUIdMwOR5CWKZE8/v+KGm+ufGmCDnYT4NNaKONbf9u5O8RHLdgbpTTDvA== X-Received: by 2002:a05:6a20:244f:b0:13f:8153:7e31 with SMTP id t15-20020a056a20244f00b0013f81537e31mr1123958pzc.20.1691539849202; Tue, 08 Aug 2023 17:10:49 -0700 (PDT) Received: from hermes.local (204-195-127-207.wavecable.com. [204.195.127.207]) by smtp.gmail.com with ESMTPSA id ix11-20020a170902f80b00b001bc676df6a9sm5745629plb.132.2023.08.08.17.10.48 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 08 Aug 2023 17:10:48 -0700 (PDT) From: Stephen Hemminger To: dev@dpdk.org Cc: Stephen Hemminger , Maxime Coquelin , Chenbo Xia Subject: [PATCH v2 21/29] vhost: remove experimental from some API's Date: Tue, 8 Aug 2023 17:10:09 -0700 Message-Id: <20230809001017.293037-22-stephen@networkplumber.org> X-Mailer: git-send-email 2.39.2 In-Reply-To: <20230809001017.293037-1-stephen@networkplumber.org> References: <20230808173527.186042-1-stephen@networkplumber.org> <20230809001017.293037-1-stephen@networkplumber.org> MIME-Version: 1.0 X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org All API's that before 22.11 release should have experimental tag removed. Signed-off-by: Stephen Hemminger --- lib/vhost/rte_vhost.h | 5 ---- lib/vhost/rte_vhost_async.h | 19 -------------- lib/vhost/rte_vhost_crypto.h | 1 - lib/vhost/version.map | 51 ++++++++++++++---------------------- 4 files changed, 19 insertions(+), 57 deletions(-) diff --git a/lib/vhost/rte_vhost.h b/lib/vhost/rte_vhost.h index fec650b1dbba..db92f0534431 100644 --- a/lib/vhost/rte_vhost.h +++ b/lib/vhost/rte_vhost.h @@ -509,7 +509,6 @@ rte_vhost_driver_get_vdpa_device(const char *path); * @return * 0 on success, -1 on failure */ -__rte_experimental int rte_vhost_driver_get_vdpa_dev_type(const char *path, uint32_t *type); @@ -648,7 +647,6 @@ int rte_vhost_get_negotiated_features(int vid, uint64_t *features); * @return * 0 on success, -1 on failure */ -__rte_experimental int rte_vhost_get_negotiated_protocol_features(int vid, uint64_t *protocol_features); @@ -960,7 +958,6 @@ int rte_vhost_vring_call(int vid, uint16_t vring_idx); * @return * 0 on success, -1 on failure, -EAGAIN for another retry */ -__rte_experimental int rte_vhost_vring_call_nonblock(int vid, uint16_t vring_idx); /** @@ -987,7 +984,6 @@ uint32_t rte_vhost_rx_queue_count(int vid, uint16_t qid); * @return * 0 on success, -1 on failure */ -__rte_experimental int rte_vhost_get_monitor_addr(int vid, uint16_t queue_id, struct rte_vhost_power_monitor_cond *pmc); @@ -1102,7 +1098,6 @@ rte_vhost_get_vdpa_device(int vid); * @return * 0 on success, < 0 on failure */ -__rte_experimental int rte_vhost_backend_config_change(int vid, bool need_reply); diff --git a/lib/vhost/rte_vhost_async.h b/lib/vhost/rte_vhost_async.h index 8f190dd44b1b..3370026415fb 100644 --- a/lib/vhost/rte_vhost_async.h +++ b/lib/vhost/rte_vhost_async.h @@ -24,7 +24,6 @@ extern "C" { * @return * 0 on success, -1 on failures */ -__rte_experimental int rte_vhost_async_channel_register(int vid, uint16_t queue_id); /** @@ -37,7 +36,6 @@ int rte_vhost_async_channel_register(int vid, uint16_t queue_id); * @return * 0 on success, -1 on failures */ -__rte_experimental int rte_vhost_async_channel_unregister(int vid, uint16_t queue_id); /** @@ -54,7 +52,6 @@ int rte_vhost_async_channel_unregister(int vid, uint16_t queue_id); * @return * 0 on success, -1 on failures */ -__rte_experimental int rte_vhost_async_channel_register_thread_unsafe(int vid, uint16_t queue_id); /** @@ -71,7 +68,6 @@ int rte_vhost_async_channel_register_thread_unsafe(int vid, uint16_t queue_id); * @return * 0 on success, -1 on failures */ -__rte_experimental int rte_vhost_async_channel_unregister_thread_unsafe(int vid, uint16_t queue_id); @@ -95,7 +91,6 @@ int rte_vhost_async_channel_unregister_thread_unsafe(int vid, * @return * num of packets enqueued */ -__rte_experimental uint16_t rte_vhost_submit_enqueue_burst(int vid, uint16_t queue_id, struct rte_mbuf **pkts, uint16_t count, int16_t dma_id, uint16_t vchan_id); @@ -120,7 +115,6 @@ uint16_t rte_vhost_submit_enqueue_burst(int vid, uint16_t queue_id, * @return * num of packets returned */ -__rte_experimental uint16_t rte_vhost_poll_enqueue_completed(int vid, uint16_t queue_id, struct rte_mbuf **pkts, uint16_t count, int16_t dma_id, uint16_t vchan_id); @@ -136,7 +130,6 @@ uint16_t rte_vhost_poll_enqueue_completed(int vid, uint16_t queue_id, * @return * the amount of in-flight packets on success; -1 on failure */ -__rte_experimental int rte_vhost_async_get_inflight(int vid, uint16_t queue_id); /** @@ -153,7 +146,6 @@ int rte_vhost_async_get_inflight(int vid, uint16_t queue_id); * @return * the amount of in-flight packets on success; -1 on failure */ -__rte_experimental int rte_vhost_async_get_inflight_thread_unsafe(int vid, uint16_t queue_id); /** @@ -178,7 +170,6 @@ int rte_vhost_async_get_inflight_thread_unsafe(int vid, uint16_t queue_id); * @return * Number of packets returned */ -__rte_experimental uint16_t rte_vhost_clear_queue_thread_unsafe(int vid, uint16_t queue_id, struct rte_mbuf **pkts, uint16_t count, int16_t dma_id, uint16_t vchan_id); @@ -203,7 +194,6 @@ uint16_t rte_vhost_clear_queue_thread_unsafe(int vid, uint16_t queue_id, * @return * Number of packets returned */ -__rte_experimental uint16_t rte_vhost_clear_queue(int vid, uint16_t queue_id, struct rte_mbuf **pkts, uint16_t count, int16_t dma_id, uint16_t vchan_id); @@ -226,13 +216,9 @@ uint16_t rte_vhost_clear_queue(int vid, uint16_t queue_id, * @return * 0 on success, and -1 on failure */ -__rte_experimental int rte_vhost_async_dma_configure(int16_t dma_id, uint16_t vchan_id); /** - * @warning - * @b EXPERIMENTAL: this API may change, or be removed, without prior notice - * * This function tries to receive packets from the guest with offloading * copies to the DMA vChannels. Successfully dequeued packets are returned * in "pkts". The other packets that their copies are submitted to @@ -260,16 +246,12 @@ int rte_vhost_async_dma_configure(int16_t dma_id, uint16_t vchan_id); * @return * Number of successfully dequeued packets */ -__rte_experimental uint16_t rte_vhost_async_try_dequeue_burst(int vid, uint16_t queue_id, struct rte_mempool *mbuf_pool, struct rte_mbuf **pkts, uint16_t count, int *nr_inflight, int16_t dma_id, uint16_t vchan_id); /** - * @warning - * @b EXPERIMENTAL: this API may change, or be removed, without prior notice. - * * Unconfigure DMA vChannel in Vhost asynchronous data path. * This function should be called when the specified DMA vChannel is no longer * used by the Vhost library. Before this function is called, make sure there @@ -282,7 +264,6 @@ rte_vhost_async_try_dequeue_burst(int vid, uint16_t queue_id, * @return * 0 on success, and -1 on failure */ -__rte_experimental int rte_vhost_async_dma_unconfigure(int16_t dma_id, uint16_t vchan_id); diff --git a/lib/vhost/rte_vhost_crypto.h b/lib/vhost/rte_vhost_crypto.h index 2b01ecda0880..71a30ba202be 100644 --- a/lib/vhost/rte_vhost_crypto.h +++ b/lib/vhost/rte_vhost_crypto.h @@ -40,7 +40,6 @@ enum rte_vhost_crypto_zero_copy { * @return * 0 on success, -1 on failure */ -__rte_experimental int rte_vhost_crypto_driver_start(const char *path); diff --git a/lib/vhost/version.map b/lib/vhost/version.map index 5bc133dafda2..9696c4d91fe8 100644 --- a/lib/vhost/version.map +++ b/lib/vhost/version.map @@ -9,10 +9,23 @@ DPDK_24 { rte_vdpa_get_stats; rte_vdpa_get_stats_names; rte_vdpa_reset_stats; + rte_vhost_async_channel_register; + rte_vhost_async_channel_register_thread_unsafe; + rte_vhost_async_channel_unregister; + rte_vhost_async_channel_unregister_thread_unsafe; + rte_vhost_async_dma_configure; + rte_vhost_async_dma_unconfigure; + rte_vhost_async_get_inflight; + rte_vhost_async_get_inflight_thread_unsafe; + rte_vhost_async_try_dequeue_burst; rte_vhost_avail_entries; + rte_vhost_backend_config_change; + rte_vhost_clear_queue; + rte_vhost_clear_queue_thread_unsafe; rte_vhost_clr_inflight_desc_packed; rte_vhost_clr_inflight_desc_split; rte_vhost_crypto_create; + rte_vhost_crypto_driver_start; rte_vhost_crypto_fetch_requests; rte_vhost_crypto_finalize_requests; rte_vhost_crypto_free; @@ -26,6 +39,7 @@ DPDK_24 { rte_vhost_driver_get_features; rte_vhost_driver_get_protocol_features; rte_vhost_driver_get_queue_num; + rte_vhost_driver_get_vdpa_dev_type; rte_vhost_driver_get_vdpa_device; rte_vhost_driver_register; rte_vhost_driver_set_features; @@ -38,8 +52,10 @@ DPDK_24 { rte_vhost_get_ifname; rte_vhost_get_log_base; rte_vhost_get_mem_table; + rte_vhost_get_monitor_addr; rte_vhost_get_mtu; rte_vhost_get_negotiated_features; + rte_vhost_get_negotiated_protocol_features; rte_vhost_get_numa_node; rte_vhost_get_vdpa_device; rte_vhost_get_vhost_ring_inflight; @@ -49,14 +65,17 @@ DPDK_24 { rte_vhost_get_vring_num; rte_vhost_log_used_vring; rte_vhost_log_write; + rte_vhost_poll_enqueue_completed; rte_vhost_rx_queue_count; rte_vhost_set_inflight_desc_packed; rte_vhost_set_inflight_desc_split; rte_vhost_set_last_inflight_io_packed; rte_vhost_set_last_inflight_io_split; rte_vhost_set_vring_base; + rte_vhost_submit_enqueue_burst; rte_vhost_va_from_guest_pa; rte_vhost_vring_call; + rte_vhost_vring_call_nonblock; rte_vhost_vring_stats_get; rte_vhost_vring_stats_get_names; rte_vhost_vring_stats_reset; @@ -67,38 +86,6 @@ DPDK_24 { EXPERIMENTAL { global: - rte_vhost_crypto_driver_start; - rte_vhost_backend_config_change; - rte_vhost_async_channel_register; - rte_vhost_async_channel_unregister; - rte_vhost_submit_enqueue_burst; - rte_vhost_poll_enqueue_completed; - - # added in 21.05 - rte_vhost_get_negotiated_protocol_features; - - # added in 21.08 - rte_vhost_async_get_inflight; - rte_vhost_async_channel_register_thread_unsafe; - rte_vhost_async_channel_unregister_thread_unsafe; - rte_vhost_clear_queue_thread_unsafe; - - # added in 21.11 - rte_vhost_get_monitor_addr; - - # added in 22.03 - rte_vhost_async_dma_configure; - - # added in 22.07 - rte_vhost_async_get_inflight_thread_unsafe; - rte_vhost_async_try_dequeue_burst; - rte_vhost_driver_get_vdpa_dev_type; - rte_vhost_clear_queue; - - # added in 22.11 - rte_vhost_async_dma_unconfigure; - rte_vhost_vring_call_nonblock; - # added in 23.07 rte_vhost_driver_set_max_queue_num; rte_vhost_notify_guest;