lib/bpf/rte_bpf_ethdev.h - main - phprus/github_dpdk

lib/bpf/rte_bpf_ethdev.h
170 строк5 KB
Marat Khalili
bpf: add ethdev callback functions
23 июн 2026, 12:17
23 июн 2026, 12:17b2efdbe
/* SPDX-License-Identifier: BSD-3-Clause
 * Copyright(c) 2018 Intel Corporation
 */

#ifndef _RTE_BPF_ETHDEV_H_
#define _RTE_BPF_ETHDEV_H_

/**
 * @file rte_bpf_ethdev.h
 *
 * API to install BPF filter as RX/TX callbacks for eth devices.
 * Note that right now:
 * - it is not MT safe, i.e. it is not allowed to do load/unload for the
 *   same port/queue from different threads in parallel.
 * - though it allows load/unload at runtime
 *   (while RX/TX is ongoing on given port/queue).
 * - allows only one BPF program per port/queue,
 * i.e. new load will replace previously loaded for that port/queue BPF program.
 * Filter behaviour - if BPF program returns zero value for a given packet,
 * then it will be dropped inside callback and no further processing
 *   on RX - it will be dropped inside callback and no further processing
 *   for that packet will happen.
 *   on TX - packet will remain unsent, and it is responsibility of the user
 *   to handle such situation (drop, try to send again, etc.).
 */

#include <rte_bpf.h>

#ifdef __cplusplus
extern "C" {
#endif

enum {
	RTE_BPF_ETH_F_NONE = 0,
	RTE_BPF_ETH_F_JIT  = 0x1, /**< use compiled into native ISA code */
};

/**
 * Unload previously loaded BPF program (if any) from given RX port/queue
 * and remove appropriate RX port/queue callback.
 *
 * @param port
 *   The identifier of the ethernet port
 * @param queue
 *   The identifier of the RX queue on the given port
 */
void
rte_bpf_eth_rx_unload(uint16_t port, uint16_t queue);

/**
 * Unload previously loaded BPF program (if any) from given TX port/queue
 * and remove appropriate TX port/queue callback.
 *
 * @param port
 *   The identifier of the ethernet port
 * @param queue
 *   The identifier of the TX queue on the given port
 */
void
rte_bpf_eth_tx_unload(uint16_t port, uint16_t queue);

/**
 * Load BPF program from the ELF file and install callback to execute it
 * on given RX port/queue.
 *
 * @param port
 *   The identifier of the ethernet port
 * @param queue
 *   The identifier of the RX queue on the given port
 * @param fname
 *  Pathname for a ELF file.
 * @param sname
 *  Name of the executable section within the file to load.
 * @param prm
 *  Parameters used to create and initialise the BPF execution context.
 * @param flags
 *  Flags that define expected behavior of the loaded filter
 *  (i.e. jited/non-jited version to use).
 * @return
 *   Zero on successful completion or negative error code otherwise.
 */
int
rte_bpf_eth_rx_elf_load(uint16_t port, uint16_t queue,
	const struct rte_bpf_prm *prm, const char *fname, const char *sname,
	uint32_t flags);

/**
 * Load BPF program from the ELF file and install callback to execute it
 * on given TX port/queue.
 *
 * @param port
 *   The identifier of the ethernet port
 * @param queue
 *   The identifier of the TX queue on the given port
 * @param fname
 *  Pathname for a ELF file.
 * @param sname
 *  Name of the executable section within the file to load.
 * @param prm
 *  Parameters used to create and initialise the BPF execution context.
 * @param flags
 *  Flags that define expected behavior of the loaded filter
 *  (i.e. jited/non-jited version to use).
 * @return
 *   Zero on successful completion or negative error code otherwise.
 */
int
rte_bpf_eth_tx_elf_load(uint16_t port, uint16_t queue,
	const struct rte_bpf_prm *prm, const char *fname, const char *sname,
	uint32_t flags);

/**
 * @warning
 * @b EXPERIMENTAL: This API may change, or be removed, without prior notice.
 *
 * Install callback to execute specified BPF program on given Rx port/queue.
 *
 * On success the ownership of the program passes to the library,
 * rte_bpf_eth_rx_unload must be used to unload it,
 * and rte_bpf_destroy must no longer be called.
 *
 * @param port
 *   The identifier of the ethernet port.
 * @param queue
 *   The identifier of the Rx queue on the given port.
 * @param bpf
 *   BPF program
 * @param flags
 *   Flags that define expected behavior of the loaded filter
 *   (i.e. jited/non-jited version to use).
 * @return
 *   Zero on successful completion or negative error code otherwise.
 */
__rte_experimental
int
rte_bpf_eth_rx_install(uint16_t port, uint16_t queue, struct rte_bpf *bpf,
	uint32_t flags);

/**
 * @warning
 * @b EXPERIMENTAL: This API may change, or be removed, without prior notice.
 *
 * Install callback to execute specified BPF program on given Tx port/queue.
 *
 * On success the ownership of the program passes to the library,
 * rte_bpf_eth_tx_unload must be used to unload it,
 * and rte_bpf_destroy must no longer be called.
 *
 * @param port
 *   The identifier of the ethernet port.
 * @param queue
 *   The identifier of the Tx queue on the given port.
 * @param bpf
 *   BPF program.
 * @param flags
 *   Flags that define expected behavior of the loaded filter
 *   (i.e. jited/non-jited version to use).
 * @return
 *   Zero on successful completion or negative error code otherwise.
 */
__rte_experimental
int
rte_bpf_eth_tx_install(uint16_t port, uint16_t queue, struct rte_bpf *bpf,
	uint32_t flags);

#ifdef __cplusplus
}
#endif

#endif /* _RTE_BPF_ETHDEV_H_ */