From patchwork Thu Oct 19 19: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: 133050 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 51E7D431AA; Thu, 19 Oct 2023 21:13:19 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 7D53042EBE; Thu, 19 Oct 2023 21:10:55 +0200 (CEST) Received: from mail-pl1-f169.google.com (mail-pl1-f169.google.com [209.85.214.169]) by mails.dpdk.org (Postfix) with ESMTP id 045DF42E55 for ; Thu, 19 Oct 2023 21:10:46 +0200 (CEST) Received: by mail-pl1-f169.google.com with SMTP id d9443c01a7336-1c434c33ec0so59121425ad.3 for ; Thu, 19 Oct 2023 12:10:45 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=networkplumber-org.20230601.gappssmtp.com; s=20230601; t=1697742645; x=1698347445; 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=N+yGpA90WaanaQs3GCzFEk1dzL3nW3gFXcHHAu/l+xIhy3msg/bvZXkWLzVtqVmji1 plZfGTGak6NgrQSmTajUBBqteDdTetBFyJ8G3OuyVwrcvhymkzNP0SD43dkblVtt5L8E NnQEvQmy7nl9wpNSQ1VCYtm25AZZdxoYBhAhzIsK2DhxAj95o77V1ZQzN34jkQz/NXUO EaY0qDCc3m8iyhyDNZnYl6zqqV0eZNtxuy1AgfHNv18vqa4WdkyCiYRe1RekkiHgWwRs HjII0Rr3/qzahjEGV5VtbILoOavMwNGx46wtuEoY2ksTwC4oO0eYmoxNLz92eJSKax1h 28Ew== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1697742645; x=1698347445; 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=v1f5hJzu8b+pRxnxXY0agMe7SfgbkmiBix3VO/RB5oKFqMEGXC2hBUe/MOsejN+9W+ De/49vFcjdaKxU/zS4XUWNE/5noA4AUzDpHKVmKwy/dcA3ISrMHPbX5xWhua7G3B6WUS WVma1pZg4/Lf7+WpMBC7haa3EgIwQ2KZVOcwNwj3sfASnTyNmXLL6xRc7krc16iP3S/i njGccMXvt0zNvNWUOO9tnPNm+Ize9v3z5AI6hwXrJ5VKOOSyaz5ycf1aEyCT+/dHk0Gs 9ObcWqzavNplV6j/4pLD8pnY1Ds4cMU5IwWf/0iCfe+zr5XIBRp7u246iU2rczEeHEOW T3wA== X-Gm-Message-State: AOJu0YyYVTnOR1ADtWHtC6d5McT29q2Wfn1MxZGt23B1QTH4tEQF9ioM zw5CcYSf5lSzXetltNN/9srutTjyxr/BvPvWifjzNA== X-Google-Smtp-Source: AGHT+IELErsYN7GRCpymOY7nRrb/FiBQDRWEEvaKEZGkZplbMBSsw7ZzXO0Ojvzw1jQx91Ot/itZhw== X-Received: by 2002:a17:903:210d:b0:1c9:97b7:b3cc with SMTP id o13-20020a170903210d00b001c997b7b3ccmr2627739ple.47.1697742644976; Thu, 19 Oct 2023 12:10:44 -0700 (PDT) Received: from hermes.local (204-195-126-68.wavecable.com. [204.195.126.68]) by smtp.gmail.com with ESMTPSA id h12-20020a170902eecc00b001a9b29b6759sm52464plb.183.2023.10.19.12.10.44 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 19 Oct 2023 12:10:44 -0700 (PDT) From: Stephen Hemminger To: dev@dpdk.org Cc: Stephen Hemminger , Maxime Coquelin , Chenbo Xia Subject: [PATCH v4 21/28] vhost: remove experimental from some API's Date: Thu, 19 Oct 2023 12:10:09 -0700 Message-Id: <20231019191016.156430-22-stephen@networkplumber.org> X-Mailer: git-send-email 2.39.2 In-Reply-To: <20231019191016.156430-1-stephen@networkplumber.org> References: <20230808173527.186042-1-stephen@networkplumber.org> <20231019191016.156430-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;