Skip to content


bpfman Configuration File

bpfman looks for a configuration file to be present at /etc/bpfman/bpfman.toml. If no file is found, defaults are assumed. There is an example at scripts/bpfman.toml, similar to:

  xdp_mode = "hw" # Valid xdp modes are "hw", "skb" and "drv". Default: "skb".

allow_unsigned = true

max_retries = 10
millisec_delay = 1000

Config Section: [interfaces]

This section of the configuration file allows the XDP Mode for a given interface to be set. If not set, the default value of skb will be used. Multiple interfaces can be configured.

  xdp_mode = "drv"
  xdp_mode = "hw"
  xdp_mode = "skb"

Valid fields:

  • xdp_mode: XDP Mode for a given interface. Valid values: ["drv"|"hw"|"skb"]

Config Section: [signing]

This section of the configuration file allows control over whether OCI packaged eBPF bytecode as container images are required to be signed via cosign or not. By default, unsigned images are allowed. See eBPF Bytecode Image Specifications for more details on building and shipping bytecode in a container image.

Valid fields:

  • allow_unsigned: Flag indicating whether unsigned images are allowed or not. Valid values: ["true"|"false"]

Config Section: [database]

bpfman uses an embedded database to store state and persistent data on disk which can only be accessed synchronously by a single process at a time. To avoid returning database lock errors and enhance the user experience, bpfman performs retries when opening of the database. The number of retries and the time between retries is configurable.

Valid fields:

  • max_retries: The number of times to retry opening the database on a given request.
  • millisec_delay: Time in milliseconds to wait between retry attempts.