rte_eal.h

Go to the documentation of this file.

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

#ifndef _RTE_EAL_H_
#define _RTE_EAL_H_

#include <stdint.h>
#include <time.h>

#include <rte_config.h>
#include <rte_compat.h>
#include <rte_per_lcore.h>
#include <rte_uuid.h>

#include <rte_pci_dev_feature_defs.h>

#ifdef __cplusplus
extern "C" {
#endif

#define RTE_MAGIC 19820526 
/* Maximum thread_name length. */
#define RTE_MAX_THREAD_NAME_LEN 16

enum rte_proc_type_t {
    RTE_PROC_AUTO = -1,   /* allow auto-detection of primary/secondary */
    RTE_PROC_PRIMARY = 0, /* set to zero, so primary is the default */
    RTE_PROC_SECONDARY,

    RTE_PROC_INVALID
};

enum rte_proc_type_t rte_eal_process_type(void);

int rte_eal_iopl_init(void);

int rte_eal_init(int argc, char **argv);

int rte_eal_cleanup(void);

int rte_eal_primary_proc_alive(const char *config_file_path);

bool rte_mp_disable(void);

#define RTE_MP_MAX_FD_NUM   8    /* The max amount of fds */
#define RTE_MP_MAX_NAME_LEN 64   /* The max length of action name */
#define RTE_MP_MAX_PARAM_LEN    256  /* The max length of param */
struct rte_mp_msg {
    char name[RTE_MP_MAX_NAME_LEN];
    int len_param;
    int num_fds;
    uint8_t param[RTE_MP_MAX_PARAM_LEN];
    int fds[RTE_MP_MAX_FD_NUM];
};

struct rte_mp_reply {
    int nb_sent;
    int nb_received;
    struct rte_mp_msg *msgs; /* caller to free */
};

typedef int (*rte_mp_t)(const struct rte_mp_msg *msg, const void *peer);

typedef int (*rte_mp_async_reply_t)(const struct rte_mp_msg *request,
        const struct rte_mp_reply *reply);

int
rte_mp_action_register(const char *name, rte_mp_t action);

void
rte_mp_action_unregister(const char *name);

int
rte_mp_sendmsg(struct rte_mp_msg *msg);

int
rte_mp_request_sync(struct rte_mp_msg *req, struct rte_mp_reply *reply,
           const struct timespec *ts);

int
rte_mp_request_async(struct rte_mp_msg *req, const struct timespec *ts,
        rte_mp_async_reply_t clb);

int
rte_mp_reply(struct rte_mp_msg *msg, const char *peer);

typedef void    (*rte_usage_hook_t)(const char * prgname);

rte_usage_hook_t
rte_set_application_usage_hook(rte_usage_hook_t usage_func);

int rte_eal_has_hugepages(void);

int rte_eal_has_pci(void);

int rte_eal_create_uio_dev(void);

enum rte_intr_mode rte_eal_vfio_intr_mode(void);

__rte_experimental
void rte_eal_vfio_get_vf_token(rte_uuid_t vf_token);

int rte_sys_gettid(void);

RTE_DECLARE_PER_LCORE(int, _thread_id);

static inline int rte_gettid(void)
{
    if (RTE_PER_LCORE(_thread_id) == -1)
        RTE_PER_LCORE(_thread_id) = rte_sys_gettid();
    return RTE_PER_LCORE(_thread_id);
}

__rte_internal
uint64_t rte_eal_get_baseaddr(void);

enum rte_iova_mode {
    RTE_IOVA_DC = 0,    /* Don't care mode */
    RTE_IOVA_PA = (1 << 0), /* DMA using physical address */
    RTE_IOVA_VA = (1 << 1)  /* DMA using virtual address */
};

enum rte_iova_mode rte_eal_iova_mode(void);

const char *
rte_eal_mbuf_user_pool_ops(void);

const char *
rte_eal_get_runtime_dir(void);

__rte_internal
int
rte_eal_parse_coremask(const char *coremask, int *cores);

#ifdef __cplusplus
}
#endif

#endif /* _RTE_EAL_H_ */