Go to file
Vegard Kamsvåg b3aad24952 aya: adds support for AF_XDP
Contains user-space functionality for doing
AF_XDP socket interactions. Much is copy-paste
from xdpilone, but with higher-level abstractions
put on top.

It should be usable at a high level without requiring
unsafe code on the library user's side. The more
low-level control is still available, for power users
who need that level of control (and accept the safety
implications).

Fixes: 
.cargo aya: add archs powerpc64 and s390x to aya
.github build(deps): bump DavidAnson/markdownlint-cli2-action
.vim Re-organize into a single workspace
.vscode vscode: exclude public-api fixtures from search
assets readme: Add crabby, sync with aya/README.md
aya aya: adds support for AF_XDP
aya-ebpf-macros Release aya-ebpf-cty v0.2.2, aya-ebpf-bindings v0.1.1, aya-ebpf-macros v0.1.1, aya-ebpf v0.1.1
aya-log Release aya v0.13.1
aya-log-common Release aya-log-common v0.1.15, aya-log-ebpf v0.1.1
aya-log-ebpf-macros Release aya-log-ebpf-macros v0.1.0
aya-log-parser Release aya-log-parser v0.1.13
aya-obj aya: adds support for AF_XDP
aya-tool Mark aya-tool publish=false
ebpf aya: adds support for AF_XDP
init test(init): run test with debug logs
test aya: adds support for AF_XDP
xtask aya: adds support for AF_XDP
.gitignore xtask: remove assumptions from docs command
.gitmodules xtask: move libbpf submodule
.markdownlint-cli2.yaml chore: Disable markdownlint for generated files
.mergify.yml chore: Fix Mergify configuration
.taplo.toml fix: fix rustdocs-args ordering in taplo to -D warnings
CODE_OF_CONDUCT.md .github: Add markdownlint
CONTRIBUTING.md .github: Add markdownlint
Cargo.toml build(deps): update public-api requirement in the cargo-crates group
LICENSE-APACHE Add license files
LICENSE-MIT Add license files
README.md Introducing Aya Guru on Gurubase.io ()
netlify.toml toml: add formatter and check in CI
release.toml chore: Fix release.toml
rustfmt.toml rustfmt: group_imports = "StdExternalCrate"

README.md

Aya

Crates.io License Build status Book Gurubase

API Documentation

Unreleased Documentation Documentaiton

Community

Discord Awesome

Join the conversation on Discord to discuss anything related to Aya or discover and contribute to a list of Awesome Aya projects.

Overview

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

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.

Example

Aya supports a large chunk of the eBPF API. The following example shows how to use a BPF_PROG_TYPE_CGROUP_SKB program with aya:

use std::fs::File;
use aya::Ebpf;
use aya::programs::{CgroupSkb, CgroupSkbAttachType};

// load the BPF code
let mut ebpf = Ebpf::load_file("ebpf.o")?;

// get the `ingress_filter` program compiled into `ebpf.o`.
let ingress: &mut CgroupSkb = ebpf.program_mut("ingress_filter")?.try_into()?;

// load the program into the kernel
ingress.load()?;

// attach the program to the root cgroup. `ingress_filter` will be called for all
// incoming packets.
let cgroup = File::open("/sys/fs/cgroup/unified")?;
ingress.attach(cgroup, CgroupSkbAttachType::Ingress)?;

Contributing

Please see the contributing guide.

License

Aya is distributed under the terms of either the MIT license or the Apache License (version 2.0), at your option.

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this crate by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.