From patchwork Wed Aug 9 00:10:16 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stephen Hemminger X-Patchwork-Id: 129993 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 7265843011; Wed, 9 Aug 2023 02:13:25 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 3E7D7432E8; Wed, 9 Aug 2023 02:11:04 +0200 (CEST) Received: from mail-pf1-f171.google.com (mail-pf1-f171.google.com [209.85.210.171]) by mails.dpdk.org (Postfix) with ESMTP id EBE2D432D0 for ; Wed, 9 Aug 2023 02:10:57 +0200 (CEST) Received: by mail-pf1-f171.google.com with SMTP id d2e1a72fcca58-686ea67195dso4614433b3a.2 for ; Tue, 08 Aug 2023 17:10:57 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=networkplumber-org.20221208.gappssmtp.com; s=20221208; t=1691539857; x=1692144657; 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=r0m9LuCsdXHMCFU4c4WgSL4EsyzkvhHetGk+XeWCRE4=; b=VXzGy14zWzyHczxxNlkifTTAr5z+QQP4esFieg4J5oBx9MaRzDkGodJrZlCI+Zb0IZ jJPgu+7/10yWSnj3AE96Lqfp4lu8itbvfWpm9+3VYomMTxuY/XyoRhgpAKxE63BwKgH1 m3EnPMfwliLPE9za4qp32yLDyowtncScIE9zpqDjoNRs4wlRp4IMsR58J+Sprpz814QZ Za6NWhj5vZCWIc7zpW8P2QkCzXoFbAneWj7/l89Xdy+/sN8YuMSFGVjUgiYGXTlxPKyM e6dd+6LAPEZIAtHrs0lidvb+3TqhTq0gWscFOtETm0ZlWqmh4hhQcQ43KKWoIwdDychA HWyQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1691539857; x=1692144657; 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=r0m9LuCsdXHMCFU4c4WgSL4EsyzkvhHetGk+XeWCRE4=; b=cJzoA69pzxe9WjLG1l8c1vjfCxs5D8sPNrHTkuU/XcriEsFG9xnYAv71upCmF9RQrw aQgJ17pZuuRtOhfA/h3HdHWH+cJL5ARSRK4XQRl8JkLP6VltjwiA/jCGAkkWQOtCD7xN Tb31A9SI7xFUsU3yXFkjF8cCv9AnTTz5rJvaE4O7euxOLMEDWlKpEpEm2AeSrVFi/Zml mRswSZlhTk7HMXtEjXq/u8Ussq9m1ObDgfxEUCriM1RY59IHb4A5+v5Y7Lfz6coFrya4 t0FUkL+WG2kVQ0ZhThmAJv/Y8KomyR8IH/Tqp0W64WV4cCn+y543Dcag7oYO7pS9QU4a LQng== X-Gm-Message-State: AOJu0Yzph+8H1zeymVp88CickOREwbr6yJbI65IDGSmSJtZBuEBOkO51 X90dEJsw+X+QFBbSEmd48kQU/nsOUQMpULtG2B0nEQ== X-Google-Smtp-Source: AGHT+IEodjbzWmYVedR6nk0bEdjzUqIQNZIu57VryEIU/dxUKST4YRwsVzLTPYYHzb3hWCbd52o3tg== X-Received: by 2002:a05:6a20:d41d:b0:13d:860e:6f37 with SMTP id il29-20020a056a20d41d00b0013d860e6f37mr951185pzb.23.1691539856786; Tue, 08 Aug 2023 17:10:56 -0700 (PDT) Received: from hermes.local (204-195-127-207.wavecable.com. [204.195.127.207]) by smtp.gmail.com with ESMTPSA id ix11-20020a170902f80b00b001bc676df6a9sm5745629plb.132.2023.08.08.17.10.56 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 08 Aug 2023 17:10:56 -0700 (PDT) From: Stephen Hemminger To: dev@dpdk.org Cc: Stephen Hemminger , Cristian Dumitrescu Subject: [PATCH v2 28/29] table: remove experimental from API Date: Tue, 8 Aug 2023 17:10:16 -0700 Message-Id: <20230809001017.293037-29-stephen@networkplumber.org> X-Mailer: git-send-email 2.39.2 In-Reply-To: <20230809001017.293037-1-stephen@networkplumber.org> References: <20230808173527.186042-1-stephen@networkplumber.org> <20230809001017.293037-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 Though this library is marked for deprecation in future. This patch follows the guideline in deprecation notice which states the experimental API's will become stable. Signed-off-by: Stephen Hemminger --- doc/guides/rel_notes/deprecation.rst | 2 -- lib/table/rte_swx_table_learner.h | 10 ---------- lib/table/rte_swx_table_selector.h | 6 ------ lib/table/rte_table_hash_func.h | 9 --------- lib/table/version.map | 18 ++---------------- 5 files changed, 2 insertions(+), 43 deletions(-) diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst index 317875c5054b..a9c784d69e86 100644 --- a/doc/guides/rel_notes/deprecation.rst +++ b/doc/guides/rel_notes/deprecation.rst @@ -178,8 +178,6 @@ Deprecation Notices * table: The table library legacy API (functions rte_table_*) will be deprecated and subsequently removed in DPDK 24.11 release. - Before this, the new table library API (functions rte_swx_table_*) - will gradually transition from experimental to stable status. * port: The port library legacy API (functions rte_port_*) will be deprecated and subsequently removed in DPDK 24.11 release. diff --git a/lib/table/rte_swx_table_learner.h b/lib/table/rte_swx_table_learner.h index c5ea015b8dcf..66be5fd7d032 100644 --- a/lib/table/rte_swx_table_learner.h +++ b/lib/table/rte_swx_table_learner.h @@ -107,7 +107,6 @@ struct rte_swx_table_learner_params { * @return * Table memory footprint in bytes. */ -__rte_experimental uint64_t rte_swx_table_learner_footprint_get(struct rte_swx_table_learner_params *params); @@ -121,7 +120,6 @@ rte_swx_table_learner_footprint_get(struct rte_swx_table_learner_params *params) * @return * Table mailbox footprint in bytes. */ -__rte_experimental uint64_t rte_swx_table_learner_mailbox_size_get(void); @@ -135,7 +133,6 @@ rte_swx_table_learner_mailbox_size_get(void); * @return * Table handle, on success, or NULL, on error. */ -__rte_experimental void * rte_swx_table_learner_create(struct rte_swx_table_learner_params *params, int numa_node); @@ -152,7 +149,6 @@ rte_swx_table_learner_create(struct rte_swx_table_learner_params *params, int nu * 0 on success or the following error codes otherwise: * -EINVAL: Invalid argument(s). */ -__rte_experimental int rte_swx_table_learner_timeout_update(void *table, uint32_t key_timeout_id, @@ -206,7 +202,6 @@ rte_swx_table_learner_timeout_update(void *table, * 0 when the table lookup operation is not yet completed, and 1 when the table lookup operation * is completed. No other return values are allowed. */ -__rte_experimental int rte_swx_table_learner_lookup(void *table, void *mailbox, @@ -239,7 +234,6 @@ rte_swx_table_learner_lookup(void *table, * @return * 0 on success, 1 or error (table full). */ -__rte_experimental uint32_t rte_swx_table_learner_add(void *table, void *mailbox, @@ -261,7 +255,6 @@ rte_swx_table_learner_add(void *table, * @param[in] time * Current time measured in CPU clock cycles. */ -__rte_experimental void rte_swx_table_learner_rearm(void *table, void *mailbox, @@ -282,7 +275,6 @@ rte_swx_table_learner_rearm(void *table, * @param[in] key_timeout_id * Key timeout ID. */ -__rte_experimental void rte_swx_table_learner_rearm_new(void *table, void *mailbox, @@ -301,7 +293,6 @@ rte_swx_table_learner_rearm_new(void *table, * @param[in] mailbox * Mailbox for the current operation. */ -__rte_experimental void rte_swx_table_learner_delete(void *table, void *mailbox); @@ -312,7 +303,6 @@ rte_swx_table_learner_delete(void *table, * @param[in] table * Table handle. */ -__rte_experimental void rte_swx_table_learner_free(void *table); diff --git a/lib/table/rte_swx_table_selector.h b/lib/table/rte_swx_table_selector.h index 05863cc90b0a..1f9b93640b1f 100644 --- a/lib/table/rte_swx_table_selector.h +++ b/lib/table/rte_swx_table_selector.h @@ -83,7 +83,6 @@ struct rte_swx_table_selector_group { * @return * Selector table memory footprint in bytes. */ -__rte_experimental uint64_t rte_swx_table_selector_footprint_get(uint32_t n_groups_max, uint32_t n_members_per_group_max); @@ -97,7 +96,6 @@ rte_swx_table_selector_footprint_get(uint32_t n_groups_max, uint32_t n_members_p * @return * Selector table mailbox footprint in bytes. */ -__rte_experimental uint64_t rte_swx_table_selector_mailbox_size_get(void); @@ -115,7 +113,6 @@ rte_swx_table_selector_mailbox_size_get(void); * @return * Table handle, on success, or NULL, on error. */ -__rte_experimental void * rte_swx_table_selector_create(struct rte_swx_table_selector_params *params, struct rte_swx_table_selector_group **groups, @@ -135,7 +132,6 @@ rte_swx_table_selector_create(struct rte_swx_table_selector_params *params, * -EINVAL: Invalid argument(s); * -ENOSPC: Too many group members. */ -__rte_experimental int rte_swx_table_selector_group_set(void *table, uint32_t group_id, @@ -177,7 +173,6 @@ rte_swx_table_selector_group_set(void *table, * 0 when the operation is not yet completed, and 1 when the operation is complete. No other * return values are allowed. */ -__rte_experimental int rte_swx_table_selector_select(void *table, void *mailbox, @@ -191,7 +186,6 @@ rte_swx_table_selector_select(void *table, * @param[in] table * Selector table handle. */ -__rte_experimental void rte_swx_table_selector_free(void *table); diff --git a/lib/table/rte_table_hash_func.h b/lib/table/rte_table_hash_func.h index a962ec2f68e8..d7013ba6c091 100644 --- a/lib/table/rte_table_hash_func.h +++ b/lib/table/rte_table_hash_func.h @@ -14,7 +14,6 @@ extern "C" { #include #include -__rte_experimental static inline uint64_t rte_crc32_u64_generic(uint64_t crc, uint64_t value) { @@ -53,7 +52,6 @@ rte_crc32_u64(uint64_t crc, uint64_t v) #endif -__rte_experimental static inline uint64_t rte_table_hash_crc_key8(void *key, void *mask, __rte_unused uint32_t key_size, uint64_t seed) @@ -67,7 +65,6 @@ rte_table_hash_crc_key8(void *key, void *mask, __rte_unused uint32_t key_size, return crc0; } -__rte_experimental static inline uint64_t rte_table_hash_crc_key16(void *key, void *mask, __rte_unused uint32_t key_size, uint64_t seed) @@ -86,7 +83,6 @@ rte_table_hash_crc_key16(void *key, void *mask, __rte_unused uint32_t key_size, return crc0; } -__rte_experimental static inline uint64_t rte_table_hash_crc_key24(void *key, void *mask, __rte_unused uint32_t key_size, uint64_t seed) @@ -108,7 +104,6 @@ rte_table_hash_crc_key24(void *key, void *mask, __rte_unused uint32_t key_size, return crc0; } -__rte_experimental static inline uint64_t rte_table_hash_crc_key32(void *key, void *mask, __rte_unused uint32_t key_size, uint64_t seed) @@ -134,7 +129,6 @@ rte_table_hash_crc_key32(void *key, void *mask, __rte_unused uint32_t key_size, return crc0; } -__rte_experimental static inline uint64_t rte_table_hash_crc_key40(void *key, void *mask, __rte_unused uint32_t key_size, uint64_t seed) @@ -160,7 +154,6 @@ rte_table_hash_crc_key40(void *key, void *mask, __rte_unused uint32_t key_size, return crc0; } -__rte_experimental static inline uint64_t rte_table_hash_crc_key48(void *key, void *mask, __rte_unused uint32_t key_size, uint64_t seed) @@ -187,7 +180,6 @@ rte_table_hash_crc_key48(void *key, void *mask, __rte_unused uint32_t key_size, return crc0; } -__rte_experimental static inline uint64_t rte_table_hash_crc_key56(void *key, void *mask, __rte_unused uint32_t key_size, uint64_t seed) @@ -217,7 +209,6 @@ rte_table_hash_crc_key56(void *key, void *mask, __rte_unused uint32_t key_size, return crc0; } -__rte_experimental static inline uint64_t rte_table_hash_crc_key64(void *key, void *mask, __rte_unused uint32_t key_size, uint64_t seed) diff --git a/lib/table/version.map b/lib/table/version.map index 6c8991073210..c73bf2fc4ec7 100644 --- a/lib/table/version.map +++ b/lib/table/version.map @@ -15,29 +15,15 @@ DPDK_24 { rte_table_lpm_ipv6_ops; rte_table_lpm_ops; rte_table_stub_ops; - - local: *; -}; - -EXPERIMENTAL { - global: - - # added in 20.11 rte_swx_table_exact_match_ops; rte_swx_table_exact_match_unoptimized_ops; - - # added in 21.05 rte_swx_table_wildcard_match_ops; - - # added in 21.08 rte_swx_table_selector_create; rte_swx_table_selector_footprint_get; rte_swx_table_selector_free; rte_swx_table_selector_group_set; rte_swx_table_selector_mailbox_size_get; rte_swx_table_selector_select; - - # added in 21.11 rte_swx_table_learner_add; rte_swx_table_learner_create; rte_swx_table_learner_delete; @@ -45,9 +31,9 @@ EXPERIMENTAL { rte_swx_table_learner_free; rte_swx_table_learner_lookup; rte_swx_table_learner_mailbox_size_get; - - # added in 22.07 rte_swx_table_learner_rearm; rte_swx_table_learner_rearm_new; rte_swx_table_learner_timeout_update; + + local: *; };