From patchwork Thu Oct 19 16:55:48 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stephen Hemminger X-Patchwork-Id: 133006 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 6DA3D431AE; Thu, 19 Oct 2023 18:58:39 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id CCB9142E04; Thu, 19 Oct 2023 18:56:36 +0200 (CEST) Received: from mail-oi1-f169.google.com (mail-oi1-f169.google.com [209.85.167.169]) by mails.dpdk.org (Postfix) with ESMTP id 8617D42DDB for ; Thu, 19 Oct 2023 18:56:26 +0200 (CEST) Received: by mail-oi1-f169.google.com with SMTP id 5614622812f47-3b2f28caab9so1032895b6e.1 for ; Thu, 19 Oct 2023 09:56:26 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=networkplumber-org.20230601.gappssmtp.com; s=20230601; t=1697734585; x=1698339385; 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=pWrUcrx3QY2veudIAyIB9UEXA03L7m5PhCWZDX9VwMU=; b=yshar2V6n36Pwq8xqwZv6Oe5Db/7ekvkpL9Hx4EKnG8fIlBNmlmQE6KivUQ0vYLdqb iW0tm8etRQaXAj/8w317Lyp4zoH2dF3fkFmh0xLLp90jTmdTqCSPSU3QhDILRvUyVK5M GbTadsrv54lqG8ZvKvpq0/AtpnJN9Babpwa343jryj4RiYXd+d5iscO/HIc5rl/9l1jt 6G1mNu0QXqW+lIlJTRvHHgm5MJ9Zr+tkMGPCznuraa3KMIJWHkYSn4nH6yXKW1LWlbmr vWoEWW7ge40hLcTKA/BOw6qf4oPmubs3mLrPe7okMCaHfO9qYxMwXoc99sFd1kAbxyIB XYxA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1697734585; x=1698339385; 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=mNDK02XmKe4A8LTPrmK673EIyNzLgKgr3BID51ILy8gfqi1A2AawjOMWVM5GNGadFR eLMhkZZChdR/mhAfTcboJCX3rQC+0UQypiNwnWnps2DIAVi9kdIQKqpQ0jdbcaezOmHH GvjekVB6lv/MuncTIkaPW5qgMh5h/6xpfYqS5dnSj+q4RgsGA7qdMbtgYYMQoguIqqHa 2eKCYSNATeRjdjD7TV6nmaQIobjhGUSNtVVEVN2+GiNXn8wH88ywa2YH5w9JVBqHgpcp XmTa7DMyy+8NlQVYvV/zMOKDxrVpvdB2afFi9yqdKFohOSmdipzEC5eTpc4QnWHBD2zP 0rcA== X-Gm-Message-State: AOJu0Yzw44edco3L7vnrR1QuVCTby14gb1N1/aATzLOwmT/Hs8ByHdFJ hUTvKGhW/6LrDf3d7F6g/AthXqB5o/09oJJfjA8Yuw== X-Google-Smtp-Source: AGHT+IFflz0Rz/4a29NWuI9Q1mUQtY1tZ0MJQ8eNNSRKNS+bzIa9xgy2y6siQ+3+2Hm/FnJAgSDXDw== X-Received: by 2002:a05:6808:2a4f:b0:3b2:db24:6384 with SMTP id fa15-20020a0568082a4f00b003b2db246384mr2363332oib.38.1697734585597; Thu, 19 Oct 2023 09:56:25 -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.24 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 19 Oct 2023 09:56:25 -0700 (PDT) From: Stephen Hemminger To: dev@dpdk.org Cc: Stephen Hemminger , Yipeng Wang , Sameh Gobriel Subject: [PATCH v3 19/29] member: remove experimental tag Date: Thu, 19 Oct 2023 09:55:48 -0700 Message-Id: <20231019165559.115742-20-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 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; -};