rte_rawdev.h

Go to the documentation of this file.

/* SPDX-License-Identifier: BSD-3-Clause
 * Copyright 2017 NXP
 */

#ifndef _RTE_RAWDEV_H_
#define _RTE_RAWDEV_H_

#ifdef __cplusplus
extern "C" {
#endif

#include <rte_common.h>
#include <rte_memory.h>
#include <rte_errno.h>

/* Rawdevice object - essentially a void to be typecasted by implementation */
typedef void *rte_rawdev_obj_t;

uint8_t
rte_rawdev_count(void);

uint16_t
rte_rawdev_get_dev_id(const char *name);

int
rte_rawdev_socket_id(uint16_t dev_id);

struct rte_rawdev_info;

int
rte_rawdev_info_get(uint16_t dev_id, struct rte_rawdev_info *dev_info);

int
rte_rawdev_configure(uint16_t dev_id, struct rte_rawdev_info *dev_conf);


int
rte_rawdev_queue_conf_get(uint16_t dev_id,
                          uint16_t queue_id,
                          rte_rawdev_obj_t queue_conf);

int
rte_rawdev_queue_setup(uint16_t dev_id,
                       uint16_t queue_id,
                       rte_rawdev_obj_t queue_conf);

int
rte_rawdev_queue_release(uint16_t dev_id, uint16_t queue_id);

uint16_t
rte_rawdev_queue_count(uint16_t dev_id);

int
rte_rawdev_start(uint16_t dev_id);

void
rte_rawdev_stop(uint16_t dev_id);

int
rte_rawdev_close(uint16_t dev_id);

int
rte_rawdev_reset(uint16_t dev_id);

#define RTE_RAWDEV_NAME_MAX_LEN (64)

struct rte_rawdev {
        int socket_id;
        uint16_t dev_id;
        const struct rte_rawdev_ops *dev_ops;
        struct rte_device *device;
        const char *driver_name;

        RTE_STD_C11
        uint8_t attached : 1;
        uint8_t started : 1;

        rte_rawdev_obj_t dev_private;
        char name[RTE_RAWDEV_NAME_MAX_LEN];
} __rte_cache_aligned;

extern struct rte_rawdev *rte_rawdevs;


struct rte_rawdev_info {
        const char *driver_name;
        struct rte_device *device;
        int socket_id;
        rte_rawdev_obj_t dev_private;
};

struct rte_rawdev_buf {
        void *buf_addr;
};

int
rte_rawdev_dump(uint16_t dev_id, FILE *f);

int
rte_rawdev_get_attr(uint16_t dev_id,
                    const char *attr_name,
                    uint64_t *attr_value);

int
rte_rawdev_set_attr(uint16_t dev_id,
                    const char *attr_name,
                    const uint64_t attr_value);

int
rte_rawdev_enqueue_buffers(uint16_t dev_id,
                           struct rte_rawdev_buf **buffers,
                           unsigned int count,
                           rte_rawdev_obj_t context);

int
rte_rawdev_dequeue_buffers(uint16_t dev_id,
                           struct rte_rawdev_buf **buffers,
                           unsigned int count,
                           rte_rawdev_obj_t context);

#define RTE_RAW_DEV_XSTATS_NAME_SIZE 64

struct rte_rawdev_xstats_name {
        char name[RTE_RAW_DEV_XSTATS_NAME_SIZE];
};

int
rte_rawdev_xstats_names_get(uint16_t dev_id,
                            struct rte_rawdev_xstats_name *xstats_names,
                            unsigned int size);

int
rte_rawdev_xstats_get(uint16_t dev_id,
                      const unsigned int ids[],
                      uint64_t values[],
                      unsigned int n);

uint64_t
rte_rawdev_xstats_by_name_get(uint16_t dev_id,
                              const char *name,
                              unsigned int *id);

int
rte_rawdev_xstats_reset(uint16_t dev_id,
                        const uint32_t ids[],
                        uint32_t nb_ids);

int
rte_rawdev_firmware_status_get(uint16_t dev_id,
                               rte_rawdev_obj_t status_info);

int
rte_rawdev_firmware_version_get(uint16_t dev_id,
                                rte_rawdev_obj_t version_info);

int
rte_rawdev_firmware_load(uint16_t dev_id, rte_rawdev_obj_t firmware_image);

int
rte_rawdev_firmware_unload(uint16_t dev_id);

int
rte_rawdev_selftest(uint16_t dev_id);

#ifdef __cplusplus
}
#endif

#endif /* _RTE_RAWDEV_H_ */