From patchwork Thu Oct 19 19:09:56 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stephen Hemminger X-Patchwork-Id: 133037 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 EAC02431B1; Thu, 19 Oct 2023 21:11:36 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 6489642E1E; Thu, 19 Oct 2023 21:10:39 +0200 (CEST) Received: from mail-pl1-f177.google.com (mail-pl1-f177.google.com [209.85.214.177]) by mails.dpdk.org (Postfix) with ESMTP id 932854281D for ; Thu, 19 Oct 2023 21:10:34 +0200 (CEST) Received: by mail-pl1-f177.google.com with SMTP id d9443c01a7336-1c9b7c234a7so72990315ad.3 for ; Thu, 19 Oct 2023 12:10:34 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=networkplumber-org.20230601.gappssmtp.com; s=20230601; t=1697742633; x=1698347433; 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=R4L6+6HkaxrgWVYchlYs7gCVrOyOL5iCGlIfk2KtL1g=; b=WeQqAHUJJScZwxT0ETVq41NT3qJSf+fJfivSsddpOrpsl7tKMB7jlofXc/udriKNvs QZ4bb0RYtGYUtSPpbow3buQ6UxmTzt88pBMgIzVIgs1ogyekZJySS7ZX5PaRRnGE9Hkx x9/cF+3bcx+AVgInbqAVEK1jiFbIY6rmUcB1Roi0dAjNK/CY9NycHptte6iqy70CnjYM Cfk77N2BYjOUX0dl28ahfyO0BH3PLG3YMclys+4vrWarjFXtCx73G36hxcjylVIerBIY MR9svMXR4Uca+IQKj340HH7Kk4InMO77GKl1EmsTTeE6txHFUF3pzHzSYqtaxH/qiOf3 cSaw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1697742633; x=1698347433; 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=R4L6+6HkaxrgWVYchlYs7gCVrOyOL5iCGlIfk2KtL1g=; b=d+/EiJVPuUBKoshrXLhYJXynkULn/aXJHoZfQMLINU1Qt9FgN0i/G2KJUHg5JNlERV wO1yZd7Eq27r3QCXlo+bwHLqp+jLC12g6tCbjBRD61Of7d/oUC7xlxJ31JuqWl7Z3eXk MOHL4BfUnvuGNN/wR7LH2MzwnJ7NaiUeff2z9vL2gZpHL1UueMyJoEGIGKGYCIsu09uN ZL2cwIivn6HThAv+ZvAlIOCQWEqzgYuKmJyArH1AtOqbsUsgEzS49xKsa5DwXE7iZV6O fJ9NUkVjSFCv8Nbh3NoSyV/hFnuOQJfIpmk2m/hY0CCyWskIamOjhZN3bmo6WJ00x2HG z0sw== X-Gm-Message-State: AOJu0Yx2/D5hoHRHca4WYRvKw+JXZnIoBHq5aZaLesdxZ2EHAKJkYbqD xhuBjLE7JjhOk3IgeAoaba2Rhah5bx5T2dZ+DhED0A== X-Google-Smtp-Source: AGHT+IHAMk5U8QOUCeP+lXbAJxIPfTtnIcLjZ7xdNKF6k2gsqEK4DcLfE3zMdGajt0QDEdtxIi7+eg== X-Received: by 2002:a17:902:ac87:b0:1c8:92ee:108d with SMTP id h7-20020a170902ac8700b001c892ee108dmr3232557plr.51.1697742633609; Thu, 19 Oct 2023 12:10:33 -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.32 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 19 Oct 2023 12:10:33 -0700 (PDT) From: Stephen Hemminger To: dev@dpdk.org Cc: Stephen Hemminger , Honnappa Nagarahalli Subject: [PATCH v4 08/28] rcu: remove experimental from rte_rcu_qbsr Date: Thu, 19 Oct 2023 12:09:56 -0700 Message-Id: <20231019191016.156430-9-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 These functions were added back in 2020. Remove experimental flag. Signed-off-by: Stephen Hemminger Reviewed-by: Honnappa Nagarahalli --- lib/rcu/rte_rcu_qsbr.h | 20 -------------------- lib/rcu/version.map | 15 ++++----------- 2 files changed, 4 insertions(+), 31 deletions(-) diff --git a/lib/rcu/rte_rcu_qsbr.h b/lib/rcu/rte_rcu_qsbr.h index 87e1b55153b5..74ef41e0fac1 100644 --- a/lib/rcu/rte_rcu_qsbr.h +++ b/lib/rcu/rte_rcu_qsbr.h @@ -10,10 +10,6 @@ * * RTE Quiescent State Based Reclamation (QSBR). * - * @warning - * @b EXPERIMENTAL: - * All functions in this file may be changed or removed without prior notice. - * * Quiescent State (QS) is any point in the thread execution * where the thread does not hold a reference to a data structure * in shared memory. While using lock-less data structures, the writer @@ -727,9 +723,6 @@ int rte_rcu_qsbr_dump(FILE *f, struct rte_rcu_qsbr *v); /** - * @warning - * @b EXPERIMENTAL: this API may change without prior notice - * * Create a queue used to store the data structure elements that can * be freed later. This queue is referred to as 'defer queue'. * @@ -742,14 +735,10 @@ rte_rcu_qsbr_dump(FILE *f, struct rte_rcu_qsbr *v); * - EINVAL - NULL parameters are passed * - ENOMEM - Not enough memory */ -__rte_experimental struct rte_rcu_qsbr_dq * rte_rcu_qsbr_dq_create(const struct rte_rcu_qsbr_dq_parameters *params); /** - * @warning - * @b EXPERIMENTAL: this API may change without prior notice - * * Enqueue one resource to the defer queue and start the grace period. * The resource will be freed later after at least one grace period * is over. @@ -777,14 +766,10 @@ rte_rcu_qsbr_dq_create(const struct rte_rcu_qsbr_dq_parameters *params); * if the defer queue size is equal (or larger) than the * number of elements in the data structure. */ -__rte_experimental int rte_rcu_qsbr_dq_enqueue(struct rte_rcu_qsbr_dq *dq, void *e); /** - * @warning - * @b EXPERIMENTAL: this API may change without prior notice - * * Free resources from the defer queue. * * This API is multi-thread safe. @@ -806,15 +791,11 @@ rte_rcu_qsbr_dq_enqueue(struct rte_rcu_qsbr_dq *dq, void *e); * On error - 1 with rte_errno set to * - EINVAL - NULL parameters are passed */ -__rte_experimental int rte_rcu_qsbr_dq_reclaim(struct rte_rcu_qsbr_dq *dq, unsigned int n, unsigned int *freed, unsigned int *pending, unsigned int *available); /** - * @warning - * @b EXPERIMENTAL: this API may change without prior notice - * * Delete a defer queue. * * It tries to reclaim all the resources on the defer queue. @@ -832,7 +813,6 @@ rte_rcu_qsbr_dq_reclaim(struct rte_rcu_qsbr_dq *dq, unsigned int n, * - EAGAIN - Some of the resources have not completed at least 1 grace * period, try again. */ -__rte_experimental int rte_rcu_qsbr_dq_delete(struct rte_rcu_qsbr_dq *dq); diff --git a/lib/rcu/version.map b/lib/rcu/version.map index 9218ed1f3399..982ffd59d9cd 100644 --- a/lib/rcu/version.map +++ b/lib/rcu/version.map @@ -2,6 +2,10 @@ DPDK_24 { global: rte_rcu_log_type; + rte_rcu_qsbr_dq_create; + rte_rcu_qsbr_dq_delete; + rte_rcu_qsbr_dq_enqueue; + rte_rcu_qsbr_dq_reclaim; rte_rcu_qsbr_dump; rte_rcu_qsbr_get_memsize; rte_rcu_qsbr_init; @@ -11,14 +15,3 @@ DPDK_24 { local: *; }; - -EXPERIMENTAL { - global: - - rte_rcu_qsbr_dq_create; - rte_rcu_qsbr_dq_enqueue; - rte_rcu_qsbr_dq_reclaim; - rte_rcu_qsbr_dq_delete; - - local: *; -};