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 5B692431BE; Fri, 20 Oct 2023 23:42:40 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 44B4742DC0; Fri, 20 Oct 2023 23:41:46 +0200 (CEST) Received: from mail-pf1-f177.google.com (mail-pf1-f177.google.com [209.85.210.177]) by mails.dpdk.org (Postfix) with ESMTP id DDB9E40EF0 for ; Fri, 20 Oct 2023 23:41:39 +0200 (CEST) Received: by mail-pf1-f177.google.com with SMTP id d2e1a72fcca58-6ba54c3ed97so1218035b3a.2 for ; Fri, 20 Oct 2023 14:41:39 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=networkplumber-org.20230601.gappssmtp.com; s=20230601; t=1697838099; x=1698442899; 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=2nkb2pR5W3yjSfAegkfIOcJ95iGoY0bDElF9kWKoLuk=; b=OJook0Yo5E4TRqDSpY1JkpL+OZ+U06K+TktxEpyKaBs4Xp5R5G9+5uTPRhZ+ld65s9 kyFGLeSdExUVgpUvrrPGBRM0FwgQ0YWQXdDYugY2LMQnWcZSG07Zlld/aO4qHmxmISKq KexRCgGZwHe2xDUPYLKDjfbGhbzd6f71nlgKI8zubl5nNXvLAJYpdqXlY6Z/4qQutkbU LPZrNGqQB3csU4Mg4Wniq09QitPxEcXrrh0u3y9mxGffoCQJqsiEvMxnf21e7isUSTcR n32GPPTANXbOlWNnh0WKSQua5j+CNk49Iz/ETkJPQQkpGuV9kQKZZ3tH3V8q3+Bo8C4i KfPA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1697838099; x=1698442899; 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=2nkb2pR5W3yjSfAegkfIOcJ95iGoY0bDElF9kWKoLuk=; b=cIOH79N5afnCzbSe5oR1dUNUrGx0hJOZFvif1QblhMVSUudo9se9hnuytDyZJ9IT7F RryTTKgHQNRKu8ykYHkyCPvIOtSNWMv1jnV5l+EiAIkP9aBQ+u/XkZ2wEqtSLeaHqvH4 OIzG9b8bKRo9rCb0qCXElH7T/G3vagxmQ6mMal3viPkQf1WxUKSUEoKQZC4dLZQlWi4B jl58GXhz0rBHLZbE10y+jh0wovNmAPpWijxbPnVj8/89dFkbhPS71wWQJYsoix/CwoVW HxPRMxj3SM1k+BBz1QXr/cu3jH27LeoHKDFYFDxyRn68gcvtX1l3Vl4jhw3xBksgkUZS d1/w== X-Gm-Message-State: AOJu0Yy6FSzJfFbjuOMCwwbJpM3mCjD0SWZpk8ohPN4Bt0rgLsKjcu+M RzYvR1OTiLk+a0+TFl+lLkEEVY6ferWkgBwTibdI8w== X-Google-Smtp-Source: AGHT+IFAkdMwFZf4OlLY5XXmuGMwwtIukFDJcSs+niZbbiFD3VdBeuMowo/nkFYFiuRPCNezcgY9EA== X-Received: by 2002:a05:6a00:1796:b0:6bd:d884:df00 with SMTP id s22-20020a056a00179600b006bdd884df00mr3598960pfg.9.1697838098889; Fri, 20 Oct 2023 14:41:38 -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.38 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 20 Oct 2023 14:41:38 -0700 (PDT) From: Stephen Hemminger To: dev@dpdk.org Cc: Stephen Hemminger , Harman Kalra Subject: [PATCH v2 09/14] eal: mark rte_intr_XXX API's as stable Date: Fri, 20 Oct 2023 14:41:14 -0700 Message-Id: <20231020214119.255491-10-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 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 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 d7f6ea24581e..0dbd8b0573dd 100644 --- a/lib/eal/version.map +++ b/lib/eal/version.map @@ -137,8 +137,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 @@ -377,7 +384,6 @@ EXPERIMENTAL { rte_power_pause; # WINDOWS_NO_EXPORT # added in 21.05 - rte_intr_callback_unregister_sync; rte_version_minor; rte_version_month; rte_version_prefix; @@ -389,12 +395,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 23.03 rte_lcore_register_usage_cb; -- 2.39.2