From: Bruce Richardson Date: Wed, 15 Sep 2021 16:55:35 +0000 (+0100) Subject: telemetry: promote API to stable X-Git-Url: http://git.droids-corp.org/?a=commitdiff_plain;h=b8a0fbab98ff2da9b5c6570b738172f65cd67476;p=dpdk.git telemetry: promote API to stable 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 --- diff --git a/MAINTAINERS b/MAINTAINERS index 30bf77b79a..1d437ca29d 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -1581,7 +1581,7 @@ M: Reshma Pattan F: lib/latencystats/ F: app/test/test_latencystats.c -Telemetry - EXPERIMENTAL +Telemetry M: Ciara Power F: lib/telemetry/ F: app/test/test_telemetry* 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 16f4ee6813..7bca8a9a49 100644 --- a/lib/telemetry/rte_telemetry.h +++ b/lib/telemetry/rte_telemetry.h @@ -23,10 +23,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. @@ -58,7 +54,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); @@ -70,7 +65,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); @@ -84,7 +78,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); @@ -100,7 +93,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); @@ -116,7 +108,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); @@ -132,7 +123,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); @@ -153,7 +143,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); @@ -172,7 +161,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); @@ -190,7 +178,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); @@ -207,7 +194,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); @@ -231,7 +217,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); @@ -284,7 +269,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); @@ -296,7 +280,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); @@ -308,7 +291,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;