From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id 29761431AE; Thu, 19 Oct 2023 18:59:03 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 3B97042E55; Thu, 19 Oct 2023 18:56:40 +0200 (CEST) Received: from mail-oo1-f54.google.com (mail-oo1-f54.google.com [209.85.161.54]) by mails.dpdk.org (Postfix) with ESMTP id 14D3C42DD9 for ; Thu, 19 Oct 2023 18:56:29 +0200 (CEST) Received: by mail-oo1-f54.google.com with SMTP id 006d021491bc7-5840fe01176so56249eaf.1 for ; Thu, 19 Oct 2023 09:56:28 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=networkplumber-org.20230601.gappssmtp.com; s=20230601; t=1697734588; x=1698339388; darn=dpdk.org; 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=xHS4TXGEN2oDJlz5yUDiCjZz5wLDuwfMibuVCzkXuNfEvOlmkOkevaRUa4yQlWGA19 dIZONda47aNvcYM/OQC75XhVAV7VIhIX8mDf0h61zYwJaGtuig/uA6vjuhskIwkfTiiL HcRuC/gf9BnvJOp5plxnUaRiTbUHlOZTqBE1R2GOHWMLgkeALb6m6KBU9WBaDWF1jEel gKJEdweZ9CNKgku4fbFR1kRLna3HAIzD+QAYWy2CJKpfrHvd+GsU9opqPKMBAxZgd2DG RqyFG/2HAVE+/xp+WMRvSFs4zncQNMsB2vfrlhz+72tv/qZWZIWeLzUXJrSOY0KNLnWO wgdQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1697734588; x=1698339388; 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=R9WCoPDUxVvQwWz3wFuF3nL6SohaQkH1m+/KT14vD35SYVm1qxvPg1qmPb9d9fHFS9 T7kG26aAo2NWWFn0PCiBGuIRfRSnEpGDW84/V7lvvidPSUULh1k7BYfDZ+0MWUnIMgVi dYylKM58xiYEVpl1f+iTHPlq1eqV5x7zGGtHmypOA4hntd/gLIuRtEzHT3YiLxG5ykvM QglSZ/DIsPAKxkyMgZmFnaEM021cFIBFgWqYJdA9GGBCpJHHuNs5xd6LTZ9PCkCpZ8ZP Z0c2heZLp7wm0QTmaEvCgHS7hAC3fNVsASaBjLX2TCy0TOe3mA1IQtf71uyuYWaJpSsB 3YzQ== X-Gm-Message-State: AOJu0YwwyUXbLAzfYQBmxUySWeWfgaWCmTRVO6oi2Cal0hCdZwYn4sn0 HH1JMW1NoQnM616uY2onEK0qD1Ifqx+BsQFfeFqKEQ== X-Google-Smtp-Source: AGHT+IE02c2nWV0C0M2xfCqSCB00IixCNDeUN7omrRHEanAGv/+Hkc5/Ecc2NlKaEn1MEJDkQMhWKw== X-Received: by 2002:a05:6358:cb27:b0:13a:a094:737d with SMTP id gr39-20020a056358cb2700b0013aa094737dmr2334565rwb.18.1697734587992; Thu, 19 Oct 2023 09:56:27 -0700 (PDT) Received: from hermes.local (204-195-126-68.wavecable.com. [204.195.126.68]) by smtp.gmail.com with ESMTPSA id y22-20020aa79436000000b00672ea40b8a9sm13988pfo.170.2023.10.19.09.56.27 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 19 Oct 2023 09:56:27 -0700 (PDT) From: Stephen Hemminger To: dev@dpdk.org Cc: Stephen Hemminger , Maxime Coquelin , Chenbo Xia Subject: [PATCH v3 22/29] vhost: remove experimental from some API's Date: Thu, 19 Oct 2023 09:55:51 -0700 Message-Id: <20231019165559.115742-23-stephen@networkplumber.org> X-Mailer: git-send-email 2.39.2 In-Reply-To: <20231019165559.115742-1-stephen@networkplumber.org> References: <20230808173527.186042-1-stephen@networkplumber.org> <20231019165559.115742-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 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; -- 2.39.2