rte_bpf.h

Go to the documentation of this file.

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

#ifndef _RTE_BPF_H_
#define _RTE_BPF_H_

#include <rte_compat.h>
#include <rte_common.h>
#include <rte_mbuf.h>
#include <bpf_def.h>

#ifdef __cplusplus
extern "C" {
#endif

enum rte_bpf_arg_type {
    RTE_BPF_ARG_UNDEF,      
    RTE_BPF_ARG_RAW,        
    RTE_BPF_ARG_PTR = 0x10, 
    RTE_BPF_ARG_PTR_MBUF,   
    RTE_BPF_ARG_RESERVED    
};

struct rte_bpf_arg {
    enum rte_bpf_arg_type type;
    size_t size;
    size_t buf_size;
};

#define RTE_BPF_ARG_PTR_TYPE(x) ((x) & RTE_BPF_ARG_PTR)

enum rte_bpf_xtype {
    RTE_BPF_XTYPE_FUNC, 
    RTE_BPF_XTYPE_VAR   
};

struct rte_bpf_xsym {
    const char *name;        
    enum rte_bpf_xtype type; 
    union {
        struct {
            uint64_t (*val)(uint64_t, uint64_t, uint64_t,
                uint64_t, uint64_t);
            uint32_t nb_args;
            struct rte_bpf_arg args[EBPF_FUNC_MAX_ARGS];
            struct rte_bpf_arg ret; 
        } func;
        struct {
            void *val; 
            struct rte_bpf_arg desc; 
        } var; 
    };
};

struct rte_bpf_prm {
    const struct ebpf_insn *ins; 
    uint32_t nb_ins;            
    const struct rte_bpf_xsym *xsym;
    uint32_t nb_xsym; 
    struct rte_bpf_arg prog_arg; 
};

struct rte_bpf_jit {
    uint64_t (*func)(void *); 
    size_t sz;                
};

struct rte_bpf;

void
rte_bpf_destroy(struct rte_bpf *bpf);

struct rte_bpf *
rte_bpf_load(const struct rte_bpf_prm *prm);

struct rte_bpf *
rte_bpf_elf_load(const struct rte_bpf_prm *prm, const char *fname,
        const char *sname);
uint64_t
rte_bpf_exec(const struct rte_bpf *bpf, void *ctx);

uint32_t
rte_bpf_exec_burst(const struct rte_bpf *bpf, void *ctx[], uint64_t rc[],
        uint32_t num);

int
rte_bpf_get_jit(const struct rte_bpf *bpf, struct rte_bpf_jit *jit);

__rte_experimental
void
rte_bpf_dump(FILE *f, const struct ebpf_insn *buf, uint32_t len);

struct bpf_program;

__rte_experimental
struct rte_bpf_prm *
rte_bpf_convert(const struct bpf_program *prog);

#ifdef __cplusplus
}
#endif

#endif /* _RTE_BPF_H_ */