From patchwork Fri Oct 20 20:57:40 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stephen Hemminger X-Patchwork-Id: 133085 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 0577E431BE; Fri, 20 Oct 2023 22:59:10 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id AB5D841143; Fri, 20 Oct 2023 22:58:20 +0200 (CEST) Received: from mail-pl1-f174.google.com (mail-pl1-f174.google.com [209.85.214.174]) by mails.dpdk.org (Postfix) with ESMTP id 533B240E7C for ; Fri, 20 Oct 2023 22:58:17 +0200 (CEST) Received: by mail-pl1-f174.google.com with SMTP id d9443c01a7336-1ca052ec63bso10420545ad.1 for ; Fri, 20 Oct 2023 13:58:17 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=networkplumber-org.20230601.gappssmtp.com; s=20230601; t=1697835496; x=1698440296; 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=v3IkX7APV97b7L2KNRwvHOtuaUY+y8UeBL9CanHDZIiKFYeQIUhIUgnO6WUcIv7hN4 a98kmcu8B9d0fTMzh1ZapA0yL8DPwacXOsjmyfffms+8TvK+7BHEjuQIMgF0sJol8YmJ LjcSdCYCpqirNbR14gPPXXD2sA/BpJ3GBCG70SezPuiOFMzsaxSCORtmAjEWEDrTA3o0 aAFVZcdffDTAGLhferQaZK0MR4fE9qQG4cp/GPck66KFBHyLDUuYWC6zecqRyi+IY2mv 3BUUdqF+iWzE8d8CTffq0vjyT3XM2BZNuk3g/ugrSJB3c1gVk+w/woGXgfqRAb49bkQM XEvg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1697835496; x=1698440296; 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/+L8/WB3CLEWQlOhtlhlHEB2f1JPhbAD333M5IjZvBm2OapuTrNMmDcaVHI4K2ga8 qPO1mQ68hSSvCYGbR5gYG+2U08sYdJd/WwyeABNRIEfLHZYgurKGyIqgQOdzGNdwvrGU WMme6684VYDwHppWb+NeoQtsnWR5RpVj2BwH77xeRTC+TUEVZYKwFhc4oPImiS+nSy4S Aw4ADojIeO25IH/EWbSD9bE4hTzGMAgst5KTClAl3xlIScRim5vO2ITrPZQOsFQtGqAx Jmle/MuvXAnf4XONHMZOpiFGRnd+jizeJuA9NGMwluVoA021bTe1DkVWj6eapVm3LcmR LN8w== X-Gm-Message-State: AOJu0Yy0tQPj32sQaHH65EmJj7c/rTbY26KBOZMl4+oIR6VTpBk5nXt8 2BCg4w3jhwhYxUL4jtC+gyD75zn/IHnJtibTRPYg+A== X-Google-Smtp-Source: AGHT+IER+i0lRUwD5+zFQoI5DGDxtePi0k1WeOUQXjz9gdqqz9N2yIwPxZtzOkehUmAt2FACOYqBVw== X-Received: by 2002:a17:903:2286:b0:1bd:da96:dc70 with SMTP id b6-20020a170903228600b001bdda96dc70mr2945229plh.49.1697835496394; Fri, 20 Oct 2023 13:58:16 -0700 (PDT) Received: from hermes.local (204-195-126-68.wavecable.com. [204.195.126.68]) by smtp.gmail.com with ESMTPSA id u17-20020a170902e5d100b001c61512f2a6sm1930961plf.220.2023.10.20.13.58.15 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 20 Oct 2023 13:58:15 -0700 (PDT) From: Stephen Hemminger To: dev@dpdk.org Cc: Stephen Hemminger , Honnappa Nagarahalli Subject: [PATCH v5 07/26] rcu: remove experimental from rte_rcu_qbsr Date: Fri, 20 Oct 2023 13:57:40 -0700 Message-Id: <20231020205759.195126-8-stephen@networkplumber.org> X-Mailer: git-send-email 2.39.2 In-Reply-To: <20231020205759.195126-1-stephen@networkplumber.org> References: <20230808173527.186042-1-stephen@networkplumber.org> <20231020205759.195126-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: *; -};