Crate aya

source · []
Expand description

A library to work with eBPF programs.

eBPF is a technology that allows running user-supplied programs inside the Linux kernel. For more info see

Aya is an eBPF library built with a focus on operability and developer experience. It does not rely on libbpf nor bcc - it’s built from the ground up purely in Rust, using only the libc crate to execute syscalls. With BTF support and when linked with musl, it offers a true compile once, run everywhere solution, where a single self-contained binary can be deployed on many linux distributions and kernel versions.

Some of the major features provided include:

  • Support for the BPF Type Format (BTF), which is transparently enabled when supported by the target kernel. This allows eBPF programs compiled against one kernel version to run on different kernel versions without the need to recompile.
  • Support for function call relocation and global data maps, which allows eBPF programs to make function calls and use global variables and initializers.
  • Async support with both tokio and async-std.
  • Easy to deploy and fast to build: aya doesn’t require a kernel build or compiled headers, and not even a C toolchain; a release build completes in a matter of seconds.


Data structures used to setup and share data with eBPF programs.

eBPF program types.

Utility functions.


Include bytes from a file for use in a subsequent crate::Bpf::load.


The main entry point into the library, used to work with eBPF programs and maps.

Builder style API for advanced loading of eBPF programs.

Bpf Type Format metadata.


The error type returned by Bpf::load_file and Bpf::load.

The error type returned when BTF operations fail.

An endianness that is selectable at run-time.


Marker trait for types that can safely be converted to and from byte slices.