From patchwork Thu Oct 19 16:55:37 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stephen Hemminger X-Patchwork-Id: 132995 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 AF158431AE; Thu, 19 Oct 2023 18:57:17 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id F010042DA1; Thu, 19 Oct 2023 18:56:22 +0200 (CEST) Received: from mail-ot1-f45.google.com (mail-ot1-f45.google.com [209.85.210.45]) by mails.dpdk.org (Postfix) with ESMTP id 2E9EE410FD for ; Thu, 19 Oct 2023 18:56:17 +0200 (CEST) Received: by mail-ot1-f45.google.com with SMTP id 46e09a7af769-6cd33d51852so1016411a34.2 for ; Thu, 19 Oct 2023 09:56:17 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=networkplumber-org.20230601.gappssmtp.com; s=20230601; t=1697734576; x=1698339376; 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=0n/0GeazbQW2tFOcvlyoqYbcYQ87Jng/A9iJuTXgZxgjCJq8MY4L4PImKhsD6B4lY4 1fWYbXrnVcjb/TqPfaD8rW1bD8GYtGosXdLbKa1gxBq/M5h1iDVKi83AlIhPkyS7Poui ABdYZCOrUEmOh/v0o66SYcObm4ZvAuhVpIyPxO9fVjgkBxpV4GT4Fz0hTLX8P3mixNtm BE6W8F82uwyr/58qB9HOObLYrWWvWivxGIcuM8xW4JVc1CKviNFAMQKrECkZYWpckF3y Q8BsaT3MblH2TQCpEQqSmAzh+keRpYU/IJb7JwhzJkdmB5ZPzCSoYIMLDQWr7S0d5ijr hYOQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1697734576; x=1698339376; 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=T6JiS9QIFe2YxEDm+PA420nr3hJw/vu16joF1vM7fyW7PbDAfSdR/RBzhyEyEkPM2m zLW9mMPnVZ5g8RA0BvBFaDl2RDwsCpKtDBQJsEUPpNQmGVYvqXeQNLnWag+y6nduna4k yAlvQUc8mvspUYUfXVKMrBIBKZwJ4TFgzWsavdFvacHC44YWhtC1ZnwKoqck91d2njxh 45DTIUVkwftrf+zlqwk3GZG72QR+8UaDWsBxyNZ+hWL58R6DpfVDwqVVoatbASYAhS8N LrD+I7vq03x+gWvJMjlYRRZZvDyY5UCKIqjerzLzG34ELYBf9ZxpC8pIgqhIgBkHqWHm EGkA== X-Gm-Message-State: AOJu0YzWoD1B2KmyokkosY8HkeHMISCp28UBTUT7Kqfwo7bEI7rsPboi IO5eiZVEGNUupACTA6jm9fnOxc9mhkZmf2f2JzG7CA== X-Google-Smtp-Source: AGHT+IE9b9jyug2eIS0mGl+s8ju92UtXayt+3dcJeMug6ky9Mdn3QKKJR1f9dy3E9P5ygfFL0Uflnw== X-Received: by 2002:a9d:624c:0:b0:6cc:fff0:8ebd with SMTP id i12-20020a9d624c000000b006ccfff08ebdmr2969322otk.24.1697734576257; Thu, 19 Oct 2023 09:56:16 -0700 (PDT) Received: from hermes.local (204-195-126-68.wavecable.com. [204.195.126.68]) by smtp.gmail.com with ESMTPSA id y22-20020aa79436000000b00672ea40b8a9sm13988pfo.170.2023.10.19.09.56.15 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 19 Oct 2023 09:56:15 -0700 (PDT) From: Stephen Hemminger To: dev@dpdk.org Cc: Stephen Hemminger , Honnappa Nagarahalli Subject: [PATCH v3 08/29] rcu: remove experimental from rte_rcu_qbsr Date: Thu, 19 Oct 2023 09:55:37 -0700 Message-Id: <20231019165559.115742-9-stephen@networkplumber.org> X-Mailer: git-send-email 2.39.2 In-Reply-To: <20231019165559.115742-1-stephen@networkplumber.org> References: <20230808173527.186042-1-stephen@networkplumber.org> <20231019165559.115742-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: *; -};