rte_telemetry.h

Go to the documentation of this file.

/* SPDX-License-Identifier: BSD-3-Clause
 * Copyright(c) 2018 Intel Corporation
 */

#include <stdint.h>
#include <sched.h>

#include <rte_compat.h>
#include <rte_os.h>

#ifndef _RTE_TELEMETRY_H_
#define _RTE_TELEMETRY_H_

#ifdef __cplusplus
extern "C" {
#endif

#define TELEMETRY_MAX_CALLBACKS 64

#define RTE_TEL_MAX_STRING_LEN 64

#define RTE_TEL_MAX_SINGLE_STRING_LEN 8192

#define RTE_TEL_MAX_DICT_ENTRIES 256

#define RTE_TEL_MAX_ARRAY_ENTRIES 512

struct rte_tel_data;

enum rte_tel_value_type {
    RTE_TEL_STRING_VAL, 
    RTE_TEL_INT_VAL,    
    RTE_TEL_U64_VAL,    
    RTE_TEL_CONTAINER, 
};

__rte_experimental
int
rte_tel_data_start_array(struct rte_tel_data *d, enum rte_tel_value_type type);

__rte_experimental
int
rte_tel_data_start_dict(struct rte_tel_data *d);

__rte_experimental
int
rte_tel_data_string(struct rte_tel_data *d, const char *str);

__rte_experimental
int
rte_tel_data_add_array_string(struct rte_tel_data *d, const char *str);

__rte_experimental
int
rte_tel_data_add_array_int(struct rte_tel_data *d, int x);

__rte_experimental
int
rte_tel_data_add_array_u64(struct rte_tel_data *d, uint64_t x);

__rte_experimental
int
rte_tel_data_add_array_container(struct rte_tel_data *d,
        struct rte_tel_data *val, int keep);

__rte_experimental
int
rte_tel_data_add_dict_string(struct rte_tel_data *d, const char *name,
        const char *val);

__rte_experimental
int
rte_tel_data_add_dict_int(struct rte_tel_data *d, const char *name, int val);

__rte_experimental
int
rte_tel_data_add_dict_u64(struct rte_tel_data *d,
        const char *name, uint64_t val);

__rte_experimental
int
rte_tel_data_add_dict_container(struct rte_tel_data *d, const char *name,
        struct rte_tel_data *val, int keep);

typedef int (*telemetry_cb)(const char *cmd, const char *params,
        struct rte_tel_data *info);

typedef void * (*handler)(void *sock_id);

__rte_experimental
int
rte_telemetry_register_cmd(const char *cmd, telemetry_cb fn, const char *help);

#ifdef RTE_HAS_CPUSET

__rte_experimental
int
rte_telemetry_init(const char *runtime_dir, rte_cpuset_t *cpuset,
        const char **err_str);

#endif /* RTE_HAS_CPUSET */

__rte_experimental
struct rte_tel_data *
rte_tel_data_alloc(void);

__rte_experimental
void
rte_tel_data_free(struct rte_tel_data *data);

#ifdef __cplusplus
}
#endif

#endif