From patchwork Wed Aug 9 00:10:07 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stephen Hemminger X-Patchwork-Id: 129984 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 2530B43011; Wed, 9 Aug 2023 02:12:37 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 0FE32432BC; Wed, 9 Aug 2023 02:10:54 +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 43E3443262 for ; Wed, 9 Aug 2023 02:10:48 +0200 (CEST) Received: by mail-pl1-f174.google.com with SMTP id d9443c01a7336-1bc1c1c68e2so40263615ad.3 for ; Tue, 08 Aug 2023 17:10:48 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=networkplumber-org.20221208.gappssmtp.com; s=20221208; t=1691539847; x=1692144647; 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=pWrUcrx3QY2veudIAyIB9UEXA03L7m5PhCWZDX9VwMU=; b=OADyRlNTlKHTBXZWa8vz5UTyAnll28tcn0+01kxLrPXjt88/TUDnAhqaY1ozUSfhsO 9jDUV7Z5gtNqNDzb0iF+4dBmyerR5pGr43+x+1PTxLwi3dbCTm9n47lYdairbn6JApvw nn9iez87kyGH+ifoIHlaS/sp3U5nvn6/FC4YKYotwLHkRwort7MLcSaqynhmAfb1d2Oj Ud/6KUQqj20XSoiWvFrXI32UlXBiEOJuZ4xexzHe0nPk5kpULJokg7zNDFJx8WHJ3r+R N8onZYKoSQBq2dWwsttqJezTd2aUfF1xgxzDQnCx1vzMfLf9tAk38iKJEce5ot2wmq61 t35A== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1691539847; x=1692144647; 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=pWrUcrx3QY2veudIAyIB9UEXA03L7m5PhCWZDX9VwMU=; b=Q/dtJ4PenDP9CP7tJqfxcKxIIqBfa1eHpWXOPsPp5VjiAwYjosrVVf5le1EfFx0NpP nhNmtRNl8lVU3IhN+0mDrffj+DMS+uYWfqxbK+tCFIoRfgO1wmLsax5ZZJzGE8kVuGDu 2lSFz5pyppHIYlVSMNatdfh4I+sfuFQYUy1s3iZyeCiTvY6bhlfZ5XYvKTGewS3LxaHw u1H/WT5PrDfPYy538+p79vAr+K6kcyKa3D98/umA9U4qeICZyTdC93NJkU5GZQMODVE3 vfApV+4/bxowFDz2SlWkfqt1Kx5GBUPtUTMrSDTRB794XDSc2zK9swSLb1IhLM73LFB2 IiEw== X-Gm-Message-State: AOJu0YycxYYPpJ3J7CHVXBAveXT6BQtBkXCW5zVTmJEL4p+3csk3+bS2 KeExhSNU8rvk27H+z+MZVxh1AUZ2xFLKokpAzeaMGQ== X-Google-Smtp-Source: AGHT+IFg8Vrj+kqFY1p562PETHLNLn9ndHlD0sG3WqOVRAHRO50nI9mLDD0owEYFE0RxIxAKeXZBiA== X-Received: by 2002:a17:902:ee8a:b0:1bc:6e74:3746 with SMTP id a10-20020a170902ee8a00b001bc6e743746mr1103780pld.64.1691539847238; Tue, 08 Aug 2023 17:10:47 -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.46 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 08 Aug 2023 17:10:46 -0700 (PDT) From: Stephen Hemminger To: dev@dpdk.org Cc: Stephen Hemminger , Yipeng Wang , Sameh Gobriel Subject: [PATCH v2 19/29] member: remove experimental tag Date: Tue, 8 Aug 2023 17:10:07 -0700 Message-Id: <20230809001017.293037-20-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 The member library last received new API's in 22.11. All the API's should be marked stable by now. Signed-off-by: Stephen Hemminger --- lib/member/rte_member.h | 54 ----------------------------------------- lib/member/version.map | 12 +++------ 2 files changed, 3 insertions(+), 63 deletions(-) diff --git a/lib/member/rte_member.h b/lib/member/rte_member.h index a15e0d69e696..a6bf22651700 100644 --- a/lib/member/rte_member.h +++ b/lib/member/rte_member.h @@ -15,9 +15,6 @@ * bloom filter (vBF). For HT setsummary, two subtypes or modes are available, * cache and non-cache modes. The table below summarize some properties of * the different implementations. - * - * @warning - * @b EXPERIMENTAL: this API may change without prior notice */ /** @@ -117,17 +114,11 @@ extern int librte_member_logtype; struct rte_member_setsum; /** - * @warning - * @b EXPERIMENTAL: this API may change without prior notice - * * Parameter struct used to create set summary */ struct rte_member_parameters; /** - * @warning - * @b EXPERIMENTAL: this API may change without prior notice - * * Define different set summary types */ enum rte_member_setsum_type { @@ -207,9 +198,6 @@ struct rte_member_setsum { } __rte_cache_aligned; /** - * @warning - * @b EXPERIMENTAL: this API may change without prior notice - * * Parameters used when create the set summary table. Currently user can * specify two types of setsummary: HT based and vBF. For HT based, user can * specify cache or non-cache mode. Here is a table to describe some differences @@ -351,9 +339,6 @@ struct rte_member_parameters { } __rte_cache_aligned; /** - * @warning - * @b EXPERIMENTAL: this API may change without prior notice - * * Find an existing set-summary and return a pointer to it. * * @param name @@ -367,9 +352,6 @@ struct rte_member_setsum * rte_member_find_existing(const char *name); /** - * @warning - * @b EXPERIMENTAL: this API may change without prior notice - * * Create set-summary (SS). * * @param params @@ -382,9 +364,6 @@ struct rte_member_setsum * rte_member_create(const struct rte_member_parameters *params); /** - * @warning - * @b EXPERIMENTAL: this API may change without prior notice - * * Lookup key in set-summary (SS). * Single key lookup and return as soon as the first match found * @@ -402,9 +381,6 @@ rte_member_lookup(const struct rte_member_setsum *setsum, const void *key, member_set_t *set_id); /** - * @warning - * @b EXPERIMENTAL: this API may change without prior notice - * * Lookup bulk of keys in set-summary (SS). * Each key lookup returns as soon as the first match found * @@ -427,9 +403,6 @@ rte_member_lookup_bulk(const struct rte_member_setsum *setsum, member_set_t *set_ids); /** - * @warning - * @b EXPERIMENTAL: this API may change without prior notice - * * Lookup a key in set-summary (SS) for multiple matches. * The key lookup will find all matched entries (multiple match). * Note that for cache mode of HT, each key can have at most one match. This is @@ -456,9 +429,6 @@ rte_member_lookup_multi(const struct rte_member_setsum *setsum, member_set_t *set_id); /** - * @warning - * @b EXPERIMENTAL: this API may change without prior notice - * * Lookup a bulk of keys in set-summary (SS) for multiple matches each key. * Each key lookup will find all matched entries (multiple match). * Note that for cache mode HT, each key can have at most one match. So @@ -489,9 +459,6 @@ rte_member_lookup_multi_bulk(const struct rte_member_setsum *setsum, member_set_t *set_ids); /** - * @warning - * @b EXPERIMENTAL: this API may change without prior notice - * * Insert key into set-summary (SS). * * @param setsum @@ -522,9 +489,6 @@ rte_member_add(const struct rte_member_setsum *setsum, const void *key, member_set_t set_id); /** - * @warning - * @b EXPERIMENTAL: this API may change without prior notice - * * Add the packet byte size into the sketch. * * @param setsum @@ -536,15 +500,11 @@ rte_member_add(const struct rte_member_setsum *setsum, const void *key, * @return * Return -EINVAL for invalid parameters, otherwise return 0. */ -__rte_experimental int rte_member_add_byte_count(const struct rte_member_setsum *setsum, const void *key, uint32_t byte_count); /** - * @warning - * @b EXPERIMENTAL: this API may change without prior notice - * * Query packet count for a certain flow-key. * * @param setsum @@ -556,16 +516,12 @@ rte_member_add_byte_count(const struct rte_member_setsum *setsum, * @return * Return -EINVAL for invalid parameters. */ -__rte_experimental int rte_member_query_count(const struct rte_member_setsum *setsum, const void *key, uint64_t *count); /** - * @warning - * @b EXPERIMENTAL: this API may change without prior notice - * * Report heavyhitter flow-keys into set-summary (SS). * * @param setsum @@ -578,16 +534,12 @@ rte_member_query_count(const struct rte_member_setsum *setsum, * Return -EINVAL for invalid parameters. Return a positive integer indicate * how many heavy hitters are reported. */ -__rte_experimental int rte_member_report_heavyhitter(const struct rte_member_setsum *setsum, void **keys, uint64_t *counts); /** - * @warning - * @b EXPERIMENTAL: this API may change without prior notice - * * De-allocate memory used by set-summary. * * @param setsum @@ -598,9 +550,6 @@ void rte_member_free(struct rte_member_setsum *setsum); /** - * @warning - * @b EXPERIMENTAL: this API may change without prior notice - * * Reset the set-summary tables. E.g. reset bits to be 0 in BF, * reset set_id in each entry to be RTE_MEMBER_NO_MATCH in HT based SS. * @@ -611,9 +560,6 @@ void rte_member_reset(const struct rte_member_setsum *setsum); /** - * @warning - * @b EXPERIMENTAL: this API may change without prior notice - * * Delete items from the set-summary. Note that vBF does not support deletion * in current implementation. For vBF, error code of -EINVAL will be returned. * diff --git a/lib/member/version.map b/lib/member/version.map index 9be5068d68fb..3aeba8826ba1 100644 --- a/lib/member/version.map +++ b/lib/member/version.map @@ -2,6 +2,7 @@ DPDK_24 { global: rte_member_add; + rte_member_add_byte_count; rte_member_create; rte_member_delete; rte_member_find_existing; @@ -10,16 +11,9 @@ DPDK_24 { rte_member_lookup_bulk; rte_member_lookup_multi; rte_member_lookup_multi_bulk; + rte_member_query_count; + rte_member_report_heavyhitter; rte_member_reset; local: *; }; - -EXPERIMENTAL { - global: - - # added in 22.11 - rte_member_add_byte_count; - rte_member_query_count; - rte_member_report_heavyhitter; -};