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 <stdalign.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 
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   253  /* The max amount of fds (see SCM_MAX_FD) */
#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;
    alignas(8) 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);
 
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);
 
#ifdef __cplusplus
}
#endif
 
#endif /* _RTE_EAL_H_ */