Sen descrición

Alessandro Decina 5dab3d7150 ci: gen: install cross headers %!s(int64=3) %!d(string=hai) anos
.cargo 8311abfdcb added support for armv7-unknown-linux-gnueabi and armv7-unknown-linux-gnueabihf %!s(int64=3) %!d(string=hai) anos
.github 5dab3d7150 ci: gen: install cross headers %!s(int64=3) %!d(string=hai) anos
.vim e115b72245 meta: fix rust-analyzer support for aya-bpf %!s(int64=3) %!d(string=hai) anos
.vscode e115b72245 meta: fix rust-analyzer support for aya-bpf %!s(int64=3) %!d(string=hai) anos
aya 2136f05461 aya: netlink: use NETLINK_EXT_ACK from libc crate %!s(int64=3) %!d(string=hai) anos
aya-gen 4fcb1d75b9 aya-gen: bump bindgen to 0.59 %!s(int64=3) %!d(string=hai) anos
bpf e94e988336 aya-bpf/helpers: add documentation and implement all bpf_probe_read_* wrappers %!s(int64=3) %!d(string=hai) anos
xtask 93dcafca38 xtask: codegen: fix bindings for archs other than x86 %!s(int64=3) %!d(string=hai) anos
.gitignore ac47f7ee73 meta: ignore .vscode/ except .vscode/settings.json %!s(int64=3) %!d(string=hai) anos
CONTRIBUTING.md 8acb92d61c Remove docs. Update URLs to aya-rs %!s(int64=3) %!d(string=hai) anos
Cargo.toml b66a73f6c7 Add aya-gen %!s(int64=3) %!d(string=hai) anos
LICENSE-APACHE 01e9f81043 Add license files %!s(int64=3) %!d(string=hai) anos
LICENSE-MIT 01e9f81043 Add license files %!s(int64=3) %!d(string=hai) anos
README.md 396e15d756 readme: add a link to awesome aya %!s(int64=3) %!d(string=hai) anos
rustfmt.toml d6f299065d Add rustfmt.toml %!s(int64=3) %!d(string=hai) anos

README.md

Aya

Crates.io License Build status Documentaiton

API docs | Chat | Aya-Related Projects

Overview

eBPF is a technology that allows running user-supplied programs inside the Linux kernel. For more info see https://ebpf.io/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 std::convert::TryInto;
use aya::Bpf;
use aya::programs::{CgroupSkb, CgroupSkbAttachType};

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

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

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

// attach th 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)?;

Community

Join the conversation on Discord to discuss anything related to aya.

Contributing

Please see the contributing guide.

License

Aya is distributed under the terms of either the MIT license or the Apache License, 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.