From patchwork Wed Sep 15 16:55:35 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Bruce Richardson X-Patchwork-Id: 98950 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 9CD88A0C41; Wed, 15 Sep 2021 18:55:42 +0200 (CEST) Received: from [217.70.189.124] (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 84FC141149; Wed, 15 Sep 2021 18:55:42 +0200 (CEST) Received: from mga01.intel.com (mga01.intel.com [192.55.52.88]) by mails.dpdk.org (Postfix) with ESMTP id 3E9DC4014F for ; Wed, 15 Sep 2021 18:55:40 +0200 (CEST) X-IronPort-AV: E=McAfee;i="6200,9189,10108"; a="244745888" X-IronPort-AV: E=Sophos;i="5.85,295,1624345200"; d="scan'208";a="244745888" Received: from fmsmga006.fm.intel.com ([10.253.24.20]) by fmsmga101.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 15 Sep 2021 09:55:39 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.85,295,1624345200"; d="scan'208";a="698380892" Received: from silpixa00399126.ir.intel.com ([10.237.223.29]) by fmsmga006.fm.intel.com with ESMTP; 15 Sep 2021 09:55:38 -0700 From: Bruce Richardson To: dev@dpdk.org Cc: ciara.power@intel.com, mdr@ashroe.eu, Bruce Richardson Date: Wed, 15 Sep 2021 17:55:35 +0100 Message-Id: <20210915165535.24616-1-bruce.richardson@intel.com> X-Mailer: git-send-email 2.30.2 In-Reply-To: <20210702152305.606933-1-bruce.richardson@intel.com> References: <20210702152305.606933-1-bruce.richardson@intel.com> MIME-Version: 1.0 Subject: [dpdk-dev] [PATCH v2] telemetry: remove experimental tags from APIs 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 Sender: "dev" The telemetry APIs have been present and unchanged for >1 year now, so remove experimental tag from them. Signed-off-by: Bruce Richardson Acked-by: Ciara Power Acked-by: Ray Kinsella --- v2: remove note from docs about telemetry being experimental. doc/guides/howto/telemetry.rst | 4 ---- lib/telemetry/rte_telemetry.h | 18 ------------------ lib/telemetry/version.map | 2 +- 3 files changed, 1 insertion(+), 23 deletions(-) -- 2.32.0 diff --git a/doc/guides/howto/telemetry.rst b/doc/guides/howto/telemetry.rst index cf73dc41ce..8f4fa1a510 100644 --- a/doc/guides/howto/telemetry.rst +++ b/doc/guides/howto/telemetry.rst @@ -9,10 +9,6 @@ The Telemetry library provides users with the ability to query DPDK for telemetry information, currently including information such as ethdev stats, ethdev port list, and eal parameters. -.. Note:: - - This library is experimental and the output format may change in the future. - Telemetry Interface ------------------- diff --git a/lib/telemetry/rte_telemetry.h b/lib/telemetry/rte_telemetry.h index 8776998b54..d3c61ffcd3 100644 --- a/lib/telemetry/rte_telemetry.h +++ b/lib/telemetry/rte_telemetry.h @@ -24,10 +24,6 @@ * * RTE Telemetry. * - * @warning - * @b EXPERIMENTAL: - * All functions in this file may be changed or removed without prior notice. - * * The telemetry library provides a method to retrieve statistics from * DPDK by sending a request message over a socket. DPDK will send * a JSON encoded response containing telemetry data. @@ -59,7 +55,6 @@ enum rte_tel_value_type { * @return * 0 on success, negative errno on error */ -__rte_experimental int rte_tel_data_start_array(struct rte_tel_data *d, enum rte_tel_value_type type); @@ -71,7 +66,6 @@ rte_tel_data_start_array(struct rte_tel_data *d, enum rte_tel_value_type type); * @return * 0 on success, negative errno on error */ -__rte_experimental int rte_tel_data_start_dict(struct rte_tel_data *d); @@ -85,7 +79,6 @@ rte_tel_data_start_dict(struct rte_tel_data *d); * @return * 0 on success, negative errno on error, E2BIG on string truncation */ -__rte_experimental int rte_tel_data_string(struct rte_tel_data *d, const char *str); @@ -101,7 +94,6 @@ rte_tel_data_string(struct rte_tel_data *d, const char *str); * @return * 0 on success, negative errno on error, E2BIG on string truncation */ -__rte_experimental int rte_tel_data_add_array_string(struct rte_tel_data *d, const char *str); @@ -117,7 +109,6 @@ rte_tel_data_add_array_string(struct rte_tel_data *d, const char *str); * @return * 0 on success, negative errno on error */ -__rte_experimental int rte_tel_data_add_array_int(struct rte_tel_data *d, int x); @@ -133,7 +124,6 @@ rte_tel_data_add_array_int(struct rte_tel_data *d, int x); * @return * 0 on success, negative errno on error */ -__rte_experimental int rte_tel_data_add_array_u64(struct rte_tel_data *d, uint64_t x); @@ -154,7 +144,6 @@ rte_tel_data_add_array_u64(struct rte_tel_data *d, uint64_t x); * @return * 0 on success, negative errno on error */ -__rte_experimental int rte_tel_data_add_array_container(struct rte_tel_data *d, struct rte_tel_data *val, int keep); @@ -173,7 +162,6 @@ rte_tel_data_add_array_container(struct rte_tel_data *d, * 0 on success, negative errno on error, E2BIG on string truncation of * either name or value. */ -__rte_experimental int rte_tel_data_add_dict_string(struct rte_tel_data *d, const char *name, const char *val); @@ -191,7 +179,6 @@ rte_tel_data_add_dict_string(struct rte_tel_data *d, const char *name, * @return * 0 on success, negative errno on error, E2BIG on string truncation of name. */ -__rte_experimental int rte_tel_data_add_dict_int(struct rte_tel_data *d, const char *name, int val); @@ -208,7 +195,6 @@ rte_tel_data_add_dict_int(struct rte_tel_data *d, const char *name, int val); * @return * 0 on success, negative errno on error, E2BIG on string truncation of name. */ -__rte_experimental int rte_tel_data_add_dict_u64(struct rte_tel_data *d, const char *name, uint64_t val); @@ -232,7 +218,6 @@ rte_tel_data_add_dict_u64(struct rte_tel_data *d, * @return * 0 on success, negative errno on error */ -__rte_experimental int rte_tel_data_add_dict_container(struct rte_tel_data *d, const char *name, struct rte_tel_data *val, int keep); @@ -285,7 +270,6 @@ typedef void * (*handler)(void *sock_id); * @return * -ENOMEM for mem allocation failure. */ -__rte_experimental int rte_telemetry_register_cmd(const char *cmd, telemetry_cb fn, const char *help); @@ -297,7 +281,6 @@ rte_telemetry_register_cmd(const char *cmd, telemetry_cb fn, const char *help); * @return * Pointer to a container. */ -__rte_experimental struct rte_tel_data * rte_tel_data_alloc(void); @@ -309,7 +292,6 @@ rte_tel_data_alloc(void); * Pointer to container. *. */ -__rte_experimental void rte_tel_data_free(struct rte_tel_data *data); diff --git a/lib/telemetry/version.map b/lib/telemetry/version.map index bde80ce29b..77528bb1fe 100644 --- a/lib/telemetry/version.map +++ b/lib/telemetry/version.map @@ -1,4 +1,4 @@ -EXPERIMENTAL { +DPDK_22 { global: rte_tel_data_add_array_container;