rawdev: add telemetry callbacks

The rawdev library now registers commands with telemetry, and
implements the corresponding callback functions. These allow a list of
rawdev devices and xstats for a rawdev port to be queried.

An example usage, with ioat rawdev driver instances, is shown below:

Connecting to /var/run/dpdk/rte/dpdk_telemetry.v2
{"version": "DPDK 20.05.0-rc0", "pid": 65777, "max_output_len": 16384}
--> /
{"/": ["/", "/ethdev/link_status", "/ethdev/list", "/ethdev/xstats", \
    "/help", "/info", "/rawdev/list", "/rawdev/xstats"]}
--> /rawdev/list
{"/rawdev/list": [0, 1, 2, 3, 4, 5]}
--> /rawdev/xstats,0
{"/rawdev/xstats": {"failed_enqueues": 0, "successful_enqueues": 0, \
    "copies_started": 0, "copies_completed": 0}}

Signed-off-by: Bruce Richardson <bruce.richardson@intel.com>
Signed-off-by: Ciara Power <ciara.power@intel.com>
Reviewed-by: Keith Wiles <keith.wiles@intel.com>

diff --git a/lib/librte_rawdev/Makefile b/lib/librte_rawdev/Makefile
index 7dd1197..5d7c2a5 100644 (file)
--- a/lib/librte_rawdev/Makefile
+++ b/lib/librte_rawdev/Makefile
@@ -11,6 +11,10 @@ CFLAGS += -O3
 CFLAGS += $(WERROR_FLAGS)
 LDLIBS += -lrte_eal
 
+ifeq ($(CONFIG_RTE_LIBRTE_TELEMETRY),y)
+LDLIBS += -lrte_telemetry
+endif
+
 # library source files
 SRCS-y += rte_rawdev.c
 

diff --git a/lib/librte_rawdev/meson.build b/lib/librte_rawdev/meson.build
index a20fbdc..1f23d2a 100644 (file)
--- a/lib/librte_rawdev/meson.build
+++ b/lib/librte_rawdev/meson.build
@@ -3,3 +3,7 @@
 
 sources = files('rte_rawdev.c')
 headers = files('rte_rawdev.h', 'rte_rawdev_pmd.h')
+
+if dpdk_conf.has('RTE_LIBRTE_TELEMETRY')
+       deps += ['telemetry']
+endif

diff --git a/lib/librte_rawdev/rte_rawdev.c b/lib/librte_rawdev/rte_rawdev.c
index b6f1e1c..ee6c087 100644 (file)
--- a/lib/librte_rawdev/rte_rawdev.c
+++ b/lib/librte_rawdev/rte_rawdev.c
@@ -29,6 +29,9 @@
 #include <rte_common.h>
 #include <rte_malloc.h>
 #include <rte_errno.h>
+#ifdef RTE_LIBRTE_TELEMETRY
+#include <rte_telemetry.h>
+#endif
 
 #include "rte_rawdev.h"
 #include "rte_rawdev_pmd.h"
@@ -544,9 +547,85 @@ rte_rawdev_pmd_release(struct rte_rawdev *rawdev)
        return 0;
 }
 
+#ifdef RTE_LIBRTE_TELEMETRY
+static int
+handle_dev_list(const char *cmd __rte_unused,
+               const char *params __rte_unused,
+               struct rte_tel_data *d)
+{
+       int i;
+
+       rte_tel_data_start_array(d, RTE_TEL_INT_VAL);
+       for (i = 0; i < rawdev_globals.nb_devs; i++)
+               if (rte_rawdevices[i].attached == RTE_RAWDEV_ATTACHED)
+                       rte_tel_data_add_array_int(d, i);
+       return 0;
+}
+
+static int
+handle_dev_xstats(const char *cmd __rte_unused,
+               const char *params,
+               struct rte_tel_data *d)
+{
+       uint64_t *rawdev_xstats;
+       struct rte_rawdev_xstats_name *xstat_names;
+       int dev_id, num_xstats, i, ret;
+       unsigned int *ids;
+
+       if (params == NULL || strlen(params) == 0 || !isdigit(*params))
+               return -1;
+
+       dev_id = atoi(params);
+       if (!rte_rawdev_pmd_is_valid_dev(dev_id))
+               return -1;
+
+       num_xstats = xstats_get_count(dev_id);
+       if (num_xstats < 0)
+               return -1;
+
+       /* use one malloc for names, stats and ids */
+       rawdev_xstats = malloc((sizeof(uint64_t) +
+                       sizeof(struct rte_rawdev_xstats_name) +
+                       sizeof(unsigned int)) * num_xstats);
+       if (rawdev_xstats == NULL)
+               return -1;
+       xstat_names = (void *)&rawdev_xstats[num_xstats];
+       ids = (void *)&xstat_names[num_xstats];
+
+       ret = rte_rawdev_xstats_names_get(dev_id, xstat_names, num_xstats);
+       if (ret < 0 || ret > num_xstats) {
+               free(rawdev_xstats);
+               return -1;
+       }
+
+       for (i = 0; i < num_xstats; i++)
+               ids[i] = i;
+
+       ret = rte_rawdev_xstats_get(dev_id, ids, rawdev_xstats, num_xstats);
+       if (ret < 0 || ret > num_xstats) {
+               free(rawdev_xstats);
+               return -1;
+       }
+
+       rte_tel_data_start_dict(d);
+       for (i = 0; i < num_xstats; i++)
+               rte_tel_data_add_dict_u64(d, xstat_names[i].name,
+                               rawdev_xstats[i]);
+
+       free(rawdev_xstats);
+       return 0;
+}
+#endif
+
 RTE_INIT(librawdev_init_log)
 {
        librawdev_logtype = rte_log_register("lib.rawdev");
        if (librawdev_logtype >= 0)
                rte_log_set_level(librawdev_logtype, RTE_LOG_INFO);
+#ifdef RTE_LIBRTE_TELEMETRY
+       rte_telemetry_register_cmd("/rawdev/list", handle_dev_list,
+                       "Returns list of available rawdev ports. Takes no parameters");
+       rte_telemetry_register_cmd("/rawdev/xstats", handle_dev_xstats,
+                       "Returns the xstats for a rawdev port. Parameters: int port_id");
+#endif
 }