Keine Beschreibung

Tamir Duberstein cc2da4a2a4 ci: download gen_init_cpio with authentication vor 5 Tagen
.cargo b513af12e8 aya: add archs powerpc64 and s390x to aya vor 3 Monaten
.github cc2da4a2a4 ci: download gen_init_cpio with authentication vor 5 Tagen
.vim dc31e11691 Re-organize into a single workspace vor 2 Jahren
.vscode 06d6a3e7a6 vscode: exclude public-api fixtures from search vor 1 Jahr
assets 2b98259be7 readme: Add crabby, sync with aya/README.md vor 2 Jahren
aya 119049f2a2 Define `{detach,take_link}` in macro when possible vor 3 Wochen
aya-build 3d8cb08b7f aya-build: add explicit irrefutable pattern vor 2 Wochen
aya-ebpf-macros 5a43bedc01 Replace proc-macro-error with proc-macro2-diagnostics vor 2 Wochen
aya-log 2791badd94 Release aya v0.13.1 vor 1 Monat
aya-log-common 04bbbccffa Release aya-log-common v0.1.15, aya-log-ebpf v0.1.1 vor 2 Monaten
aya-log-ebpf-macros 2eac95f6d9 Release aya-log-ebpf-macros v0.1.0 vor 8 Monaten
aya-log-parser 04ee35d139 Release aya-log-parser v0.1.13 vor 8 Monaten
aya-obj bf2164c92f feat(aya): Add iterator program type vor 3 Wochen
aya-tool b21f2a1945 Mark aya-tool publish=false vor 8 Monaten
ebpf 1de7e728b6 Allow aya-ebpf to clippy with stable rust vor 2 Wochen
init 3aa2745972 test(init): run test with debug logs vor 1 Monat
test b01bc3f49b Use Result in integration-test's build script vor 2 Wochen
xtask cc2da4a2a4 ci: download gen_init_cpio with authentication vor 5 Tagen
.gitignore b86d42d1b0 xtask: remove assumptions from docs command vor 1 Jahr
.gitmodules d5259ce789 xtask: move libbpf submodule vor 1 Jahr
.markdownlint-cli2.yaml 3a8274d445 chore: Disable markdownlint for generated files vor 9 Monaten
.mergify.yml f81d320142 chore: Fix Mergify configuration vor 9 Monaten
.taplo.toml 5e13283f59 fix: fix rustdocs-args ordering in taplo to -D warnings vor 6 Monaten
CODE_OF_CONDUCT.md 8780a50be1 .github: Add markdownlint vor 1 Jahr
CONTRIBUTING.md 8780a50be1 .github: Add markdownlint vor 1 Jahr
Cargo.toml cc2da4a2a4 ci: download gen_init_cpio with authentication vor 5 Tagen
LICENSE-APACHE 01e9f81043 Add license files vor 3 Jahren
LICENSE-MIT 01e9f81043 Add license files vor 3 Jahren
README.md c81f5e475e Introducing Aya Guru on Gurubase.io (#1085) vor 3 Wochen
clippy.sh e0c4948e36 Extract integration-common for shared types vor 2 Wochen
netlify.toml c8bf646ef0 toml: add formatter and check in CI vor 1 Jahr
release.toml 5393618081 chore: Fix release.toml vor 9 Monaten
rustfmt.toml d16e607fd4 rustfmt: group_imports = "StdExternalCrate" vor 1 Jahr

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, 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.