From patchwork Fri Oct 20 21:41:07 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stephen Hemminger X-Patchwork-Id: 133106 X-Patchwork-Delegate: david.marchand@redhat.com 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 4618A431BE; Fri, 20 Oct 2023 23:41:46 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 4C36840DC9; Fri, 20 Oct 2023 23:41:37 +0200 (CEST) Received: from mail-pg1-f182.google.com (mail-pg1-f182.google.com [209.85.215.182]) by mails.dpdk.org (Postfix) with ESMTP id A603A402E0 for ; Fri, 20 Oct 2023 23:41:33 +0200 (CEST) Received: by mail-pg1-f182.google.com with SMTP id 41be03b00d2f7-5b5354da665so870698a12.2 for ; Fri, 20 Oct 2023 14:41:33 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=networkplumber-org.20230601.gappssmtp.com; s=20230601; t=1697838092; x=1698442892; 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=lIGExvbjqvTLu9DYMWuFCnLXrcEDJA9Qb6lqIsdDDgI=; b=1gtcgBpLZm4E7WAaQLMjLxmp2L9yqbbAiNbBfK6eceLzYTX4IUL/eBfkbpKHJm0Kjm irXjCHkOCVUNOox3F7fzRB451th0nPI2F1Paps5h3OFXRif1FN8Fa+lUdhS35u9BGwvK zNZBEJB9osGzMBzPCIg6A6dsCHOBikP8h0/c0eTXiGpnK5x7+CmUz/WamsdX4Z27+2Om IKUPiM89evi0MDLEFZih8SSti5+ht44LPVJU8iXtCJecIrsZSTl0Huz8LZ/pcPvgllkp 6scfo5WEb3cDwJ+/m+n2+Weso8UDRXUTBa4GTLI2jDumK7EW95yEAQWAbd3wF8vv3uf3 pgpA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1697838092; x=1698442892; 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=lIGExvbjqvTLu9DYMWuFCnLXrcEDJA9Qb6lqIsdDDgI=; b=VMZB+498BAbkAhkSvBrqF1PRaXjEyzbK6CNI7xHG2wZfZ97oaLARFbXhQMmHmO/2YT aJaE6klHnchWE40kKv312iK5nPn+8YiY0S+NaTapm/WHbjGgZ9WNmTqDS0zNKA7vSKQ8 on/K6nYtiMRgNfKZ+ecI4CBNrqJo0gODm+HLq0adn9x5mhzc8UoADUe/xQwpGda4rd4d NWBbL1KA2aT45LxJCIYPdKSnYcEKGXEo9JgES3mxofemgGH8mMn1m5Mdv51cAIwaKdGs wr8wObliwu3pp2LmJaiCKlsveUHR5Y55ZrIlhEzHkWEZnenmraaObUi2Sk5o/InhBDnT JRKw== X-Gm-Message-State: AOJu0Yws6gQAaaCTI9GJKwf6ghWXPCnzohdq2pIWBp/FmQarDooep8jQ RAgOlKLU9xb6Bpf2u7I36X7j1WQ+69djTO4F2dq1VA== X-Google-Smtp-Source: AGHT+IGzCEqLD0S0VYbyCkLFLjL5DmnMsQbgrdwjYJ+u5hO3f/b60Ld4uMT7JW8TrHAniIfkn/urWw== X-Received: by 2002:a05:6a21:7788:b0:16e:ab42:9837 with SMTP id bd8-20020a056a21778800b0016eab429837mr2996764pzc.29.1697838092172; Fri, 20 Oct 2023 14:41:32 -0700 (PDT) Received: from hermes.local (204-195-126-68.wavecable.com. [204.195.126.68]) by smtp.gmail.com with ESMTPSA id 19-20020a631753000000b005894450b404sm1886543pgx.63.2023.10.20.14.41.31 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 20 Oct 2023 14:41:31 -0700 (PDT) From: Stephen Hemminger To: dev@dpdk.org Cc: Stephen Hemminger 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> <20231020214119.255491-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 These have been around since 2020. Signed-off-by: Stephen Hemminger --- lib/eal/include/rte_dev.h | 32 -------------------------------- lib/eal/version.map | 28 +++++++++++----------------- 2 files changed, 11 insertions(+), 49 deletions(-) diff --git a/lib/eal/include/rte_dev.h b/lib/eal/include/rte_dev.h index 8568535ac04b..86ef2f54235d 100644 --- a/lib/eal/include/rte_dev.h +++ b/lib/eal/include/rte_dev.h @@ -341,7 +341,6 @@ typedef void *(*rte_dev_iterate_t)(const void *start, * 0 on successful initialization. * <0 on error. */ -__rte_experimental int rte_dev_iterator_init(struct rte_dev_iterator *it, const char *str); @@ -361,7 +360,6 @@ rte_dev_iterator_init(struct rte_dev_iterator *it, const char *str); * NULL if an error occurred (rte_errno is set). * NULL if no device could be found (rte_errno is not set). */ -__rte_experimental struct rte_device * rte_dev_iterator_next(struct rte_dev_iterator *it); @@ -372,9 +370,6 @@ rte_dev_iterator_next(struct rte_dev_iterator *it); dev = rte_dev_iterator_next(it)) /** - * @warning - * @b EXPERIMENTAL: this API may change without prior notice - * * It registers the callback for the specific device. * Multiple callbacks can be registered at the same time. * @@ -390,16 +385,12 @@ rte_dev_iterator_next(struct rte_dev_iterator *it); * - On success, zero. * - On failure, a negative value. */ -__rte_experimental int rte_dev_event_callback_register(const char *device_name, rte_dev_event_cb_fn cb_fn, void *cb_arg); /** - * @warning - * @b EXPERIMENTAL: this API may change without prior notice - * * It unregisters the callback according to the specified device. * * @param device_name @@ -415,16 +406,12 @@ rte_dev_event_callback_register(const char *device_name, * - On success, return the number of callback entities removed. * - On failure, a negative value. */ -__rte_experimental int rte_dev_event_callback_unregister(const char *device_name, rte_dev_event_cb_fn cb_fn, void *cb_arg); /** - * @warning - * @b EXPERIMENTAL: this API may change without prior notice - * * Executes all the user application registered callbacks for * the specific device. * @@ -433,64 +420,47 @@ rte_dev_event_callback_unregister(const char *device_name, * @param event * the device event type. */ -__rte_experimental void rte_dev_event_callback_process(const char *device_name, enum rte_dev_event_type event); /** - * @warning - * @b EXPERIMENTAL: this API may change without prior notice - * * Start the device event monitoring. * * @return * - On success, zero. * - On failure, a negative value. */ -__rte_experimental int rte_dev_event_monitor_start(void); /** - * @warning - * @b EXPERIMENTAL: this API may change without prior notice - * * Stop the device event monitoring. * * @return * - On success, zero. * - On failure, a negative value. */ -__rte_experimental int rte_dev_event_monitor_stop(void); /** - * @warning - * @b EXPERIMENTAL: this API may change without prior notice - * * Enable hotplug handling for devices. * * @return * - On success, zero. * - On failure, a negative value. */ -__rte_experimental int rte_dev_hotplug_handle_enable(void); /** - * @warning - * @b EXPERIMENTAL: this API may change without prior notice - * * Disable hotplug handling for devices. * * @return * - On success, zero. * - On failure, a negative value. */ -__rte_experimental int rte_dev_hotplug_handle_disable(void); @@ -514,7 +484,6 @@ rte_dev_hotplug_handle_disable(void); * 0 if mapping was successful. * Negative value and rte_errno is set otherwise. */ -__rte_experimental int rte_dev_dma_map(struct rte_device *dev, void *addr, uint64_t iova, size_t len); @@ -538,7 +507,6 @@ rte_dev_dma_map(struct rte_device *dev, void *addr, uint64_t iova, size_t len); * 0 if un-mapping was successful. * Negative value and rte_errno is set otherwise. */ -__rte_experimental int rte_dev_dma_unmap(struct rte_device *dev, void *addr, uint64_t iova, size_t len); diff --git a/lib/eal/version.map b/lib/eal/version.map index e00a844805bb..01ff887358fa 100644 --- a/lib/eal/version.map +++ b/lib/eal/version.map @@ -28,8 +28,19 @@ DPDK_24 { rte_dev_bus; rte_dev_bus_info; rte_dev_devargs; + rte_dev_dma_map; + rte_dev_dma_unmap; rte_dev_driver; + rte_dev_event_callback_process; + rte_dev_event_callback_register; + rte_dev_event_callback_unregister; + rte_dev_event_monitor_start; + rte_dev_event_monitor_stop; + rte_dev_hotplug_handle_disable; + rte_dev_hotplug_handle_enable; rte_dev_is_probed; + rte_dev_iterator_init; + rte_dev_iterator_next; rte_dev_name; rte_dev_numa_node; rte_dev_probe; @@ -309,28 +320,11 @@ DPDK_24 { EXPERIMENTAL { global: - # added in 18.05 - rte_dev_event_callback_register; - rte_dev_event_callback_unregister; - rte_dev_event_monitor_start; - rte_dev_event_monitor_stop; - # added in 18.08 rte_class_find; rte_class_find_by_name; rte_class_register; rte_class_unregister; - rte_dev_iterator_init; - rte_dev_iterator_next; - - # added in 18.11 - rte_dev_event_callback_process; - rte_dev_hotplug_handle_disable; - rte_dev_hotplug_handle_enable; - - # added in 19.05 - rte_dev_dma_map; - rte_dev_dma_unmap; # added in 20.05 __rte_eal_trace_generic_double;