From patchwork Wed Aug 9 16:43:02 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stephen Hemminger X-Patchwork-Id: 130059 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 4FD8E4301A; Wed, 9 Aug 2023 18:45:48 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id EF23943283; Wed, 9 Aug 2023 18:44:50 +0200 (CEST) Received: from mail-pf1-f180.google.com (mail-pf1-f180.google.com [209.85.210.180]) by mails.dpdk.org (Postfix) with ESMTP id 038014327A for ; Wed, 9 Aug 2023 18:44:48 +0200 (CEST) Received: by mail-pf1-f180.google.com with SMTP id d2e1a72fcca58-686b91c2744so5156061b3a.0 for ; Wed, 09 Aug 2023 09:44:47 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=networkplumber-org.20221208.gappssmtp.com; s=20221208; t=1691599487; x=1692204287; 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=l+pEAPV5EZTGAdiM7VyA0Hg7lUtYBWY7KU6wCk5NtsI=; b=EM4WqBX4nyN4oJpg/KcNf3s+NW1vaZT93oVHiAEwrG7wExd5KUnFxpy7FwO+IWs2Jt hRgI9T4UKW2BduecugY6NAKzcM7+dBPwkxLPSRfoD9qG+MTz2sX++QISTZMuqLVgL5fc i4nSL0Cu2IhVjiv+zm9pp1ikBgRzjUY8D1qmzBGh3L4Y6/4nYXJHGfcnZgUWRJfyx+Yz gLvQmij9J1XU+XzSkI+ikvy+gPg+n79jQlfYTjuXuno8q+TM+pHD3w+1Lx4oA6xv/XU2 yFAZLYJSa5iNZbZKM32NUF2jqRcBbXSRgNlUrFjGu18o1OqIe+V3l9ybtJTzz4nfFKma KE2A== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1691599487; x=1692204287; 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=l+pEAPV5EZTGAdiM7VyA0Hg7lUtYBWY7KU6wCk5NtsI=; b=JtDnjJUuZ0jwluIxIL+aXbFVIYWqm5O0r1KLaR3OR2Lhb+XZ96vxXrHUWRGcUkq0qD ZWdJi/jysz5OzsQTn4srYvwM3df3gPaBudYayjp6a6slhoxIQb9xfhhGgvKZHTugop4y Ty0cleNimvaI8ch3RgicFc8RPWzGSoHWeGUMjnBkCaofxUXidgDnA5qir84IQd3KEHWO 5+khx2D7l7x4dVO//Mnrc986dPMU0Fs96fzuk2ubULC2JnO4I0QsPUqJ0mkiQHgap6Fc +T8rqZT/cZzrqJG2rT2QEp/Zx8osz8eoKdvxe/GrgHoVHVK1nntR0pyEh8DOHwqS9b8n BNIw== X-Gm-Message-State: AOJu0YyF3PAsO7I50fYKWtX8hAHVfB2XzV0CxqH1Z7oFCHmTh68prfYo y+glznO06V5W2vvo07U8Tg56D8Di5ajrm3DU+4Cn0g== X-Google-Smtp-Source: AGHT+IH2p19MQAu/HT9hj7V/nw/52VdGNheOo4dGB6KE7eBOl+GPyXblF/qST1fN5proZ8TaDVPitg== X-Received: by 2002:a05:6a21:9989:b0:125:517c:4f18 with SMTP id ve9-20020a056a21998900b00125517c4f18mr3676089pzb.8.1691599486945; Wed, 09 Aug 2023 09:44:46 -0700 (PDT) Received: from hermes.local (204-195-127-207.wavecable.com. [204.195.127.207]) by smtp.gmail.com with ESMTPSA id i8-20020a17090332c800b001b8b0ac2258sm11426394plr.174.2023.08.09.09.44.46 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 09 Aug 2023 09:44:46 -0700 (PDT) From: Stephen Hemminger To: dev@dpdk.org Cc: Stephen Hemminger , Harman Kalra Subject: [PATCH 10/15] eal: mark rte_intr_XXX API's as stable Date: Wed, 9 Aug 2023 09:43:02 -0700 Message-Id: <20230809164312.308093-11-stephen@networkplumber.org> X-Mailer: git-send-email 2.39.2 In-Reply-To: <20230809164312.308093-1-stephen@networkplumber.org> References: <20230809164312.308093-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 were added back in 2020. Signed-off-by: Stephen Hemminger --- lib/eal/include/rte_interrupts.h | 28 ---------------------------- lib/eal/version.map | 14 +++++++------- 2 files changed, 7 insertions(+), 35 deletions(-) diff --git a/lib/eal/include/rte_interrupts.h b/lib/eal/include/rte_interrupts.h index bcafdd58a912..1b9a0b2a78f3 100644 --- a/lib/eal/include/rte_interrupts.h +++ b/lib/eal/include/rte_interrupts.h @@ -127,9 +127,6 @@ rte_intr_callback_unregister_pending(const struct rte_intr_handle *intr_handle, rte_intr_unregister_callback_fn ucb_fn); /** - * @warning - * @b EXPERIMENTAL: this API may change without prior notice - * * Loop until rte_intr_callback_unregister() succeeds. * After a call to this function, * the callback provided by the specified interrupt handle is unregistered. @@ -146,7 +143,6 @@ rte_intr_callback_unregister_pending(const struct rte_intr_handle *intr_handle, * - On success, return the number of callback entities removed. * - On failure, a negative value. */ -__rte_experimental int rte_intr_callback_unregister_sync(const struct rte_intr_handle *intr_handle, rte_intr_callback_fn cb, void *cb_arg); @@ -201,9 +197,6 @@ int rte_intr_ack(const struct rte_intr_handle *intr_handle); int rte_thread_is_intr(void); /** - * @warning - * @b EXPERIMENTAL: this API may change without prior notice - * * It allocates memory for interrupt instance. API takes flag as an argument * which define from where memory should be allocated i.e. using DPDK memory * management library APIs or normal heap allocation. @@ -221,28 +214,20 @@ int rte_thread_is_intr(void); * - On success, address of interrupt handle. * - On failure, NULL. */ -__rte_experimental struct rte_intr_handle * rte_intr_instance_alloc(uint32_t flags); /** - * @warning - * @b EXPERIMENTAL: this API may change without prior notice - * * Free the memory allocated for interrupt handle resources. * * @param intr_handle * Interrupt handle allocated with rte_intr_instance_alloc(). * If intr_handle is NULL, no operation is performed. */ -__rte_experimental void rte_intr_instance_free(struct rte_intr_handle *intr_handle); /** - * @warning - * @b EXPERIMENTAL: this API may change without prior notice - * * Set the fd field of interrupt handle with user provided * file descriptor. * @@ -255,14 +240,10 @@ rte_intr_instance_free(struct rte_intr_handle *intr_handle); * - On success, zero. * - On failure, a negative value and rte_errno is set. */ -__rte_experimental int rte_intr_fd_set(struct rte_intr_handle *intr_handle, int fd); /** - * @warning - * @b EXPERIMENTAL: this API may change without prior notice - * * Returns the fd field of the given interrupt handle instance. * * @param intr_handle @@ -272,14 +253,10 @@ rte_intr_fd_set(struct rte_intr_handle *intr_handle, int fd); * - On success, fd field. * - On failure, a negative value. */ -__rte_experimental int rte_intr_fd_get(const struct rte_intr_handle *intr_handle); /** - * @warning - * @b EXPERIMENTAL: this API may change without prior notice - * * Set the type field of interrupt handle with user provided * interrupt type. * @@ -292,15 +269,11 @@ rte_intr_fd_get(const struct rte_intr_handle *intr_handle); * - On success, zero. * - On failure, a negative value and rte_errno is set. */ -__rte_experimental int rte_intr_type_set(struct rte_intr_handle *intr_handle, enum rte_intr_handle_type type); /** - * @warning - * @b EXPERIMENTAL: this API may change without prior notice - * * Returns the type field of the given interrupt handle instance. * * @param intr_handle @@ -310,7 +283,6 @@ rte_intr_type_set(struct rte_intr_handle *intr_handle, * - On success, interrupt type * - On failure, RTE_INTR_HANDLE_UNKNOWN. */ -__rte_experimental enum rte_intr_handle_type rte_intr_type_get(const struct rte_intr_handle *intr_handle); diff --git a/lib/eal/version.map b/lib/eal/version.map index 200824a9e91f..d75a7379cbdf 100644 --- a/lib/eal/version.map +++ b/lib/eal/version.map @@ -138,8 +138,15 @@ DPDK_24 { rte_intr_callback_register; rte_intr_callback_unregister; rte_intr_callback_unregister_pending; + rte_intr_callback_unregister_sync; rte_intr_disable; rte_intr_enable; + rte_intr_fd_get; + rte_intr_fd_set; + rte_intr_instance_alloc; + rte_intr_instance_free; + rte_intr_type_get; + rte_intr_type_set; rte_keepalive_create; # WINDOWS_NO_EXPORT rte_keepalive_dispatch_pings; # WINDOWS_NO_EXPORT rte_keepalive_mark_alive; # WINDOWS_NO_EXPORT @@ -383,7 +390,6 @@ EXPERIMENTAL { rte_power_pause; # WINDOWS_NO_EXPORT # added in 21.05 - rte_intr_callback_unregister_sync; rte_thread_key_create; rte_thread_key_delete; rte_thread_value_get; @@ -393,12 +399,6 @@ EXPERIMENTAL { rte_power_monitor_multi; # WINDOWS_NO_EXPORT # added in 21.11 - rte_intr_fd_get; - rte_intr_fd_set; - rte_intr_instance_alloc; - rte_intr_instance_free; - rte_intr_type_get; - rte_intr_type_set; # added in 22.07 rte_thread_get_affinity_by_id;