Geen omschrijving

Alessandro Decina e2b673eb41 Merge pull request #651 from alessandrod/bpf-cargo-config 1 jaar geleden
.cargo 6ca7d53733 Remove detritus 1 jaar geleden
.github 6ac1320707 integration-test: build "fake" by default 1 jaar geleden
.vim dc31e11691 Re-organize into a single workspace 2 jaren geleden
.vscode 728a25d9d9 vscode: check all targets 1 jaar geleden
assets 2b98259be7 readme: Add crabby, sync with aya/README.md 2 jaren geleden
aya 242d8c33c4 Fix build 1 jaar geleden
aya-bpf-macros 27120b328a aya: don't allocate static strings 1 jaar geleden
aya-log 84e5e2894f aya-log: Unify IP format hints into one, repsesent it by `:i` token 1 jaar geleden
aya-log-common 7f25956aea Add missing test annotation 1 jaar geleden
aya-log-ebpf-macros 6feebef9e5 aya-log-ebpf: simplify argument validation 1 jaar geleden
aya-log-parser e08c6471dd Cargo.toml: suppress resolver warning on nightly 1 jaar geleden
aya-obj e621a09181 Clippy over tests and integration-ebpf 1 jaar geleden
aya-tool 27120b328a aya: don't allocate static strings 1 jaar geleden
bpf c64d8e2bb7 Add back bpf/.cargo/config.toml 1 jaar geleden
libbpf @ a2258003f2 8c61fc9ea6 integration-test: compile C probes using build.rs 1 jaar geleden
test 94f554a52f fix loaded_programs() race in int-tests 1 jaar geleden
xtask 6ac1320707 integration-test: build "fake" by default 1 jaar geleden
.gitignore 8c61fc9ea6 integration-test: compile C probes using build.rs 1 jaar geleden
.gitmodules 8c61fc9ea6 integration-test: compile C probes using build.rs 1 jaar geleden
CODE_OF_CONDUCT.md e752ffb3be Add a Code of Conduct 2 jaren geleden
CONTRIBUTING.md d4a399fb0c Update CONTRIBUTING.md to link to the test/README.md 2 jaren geleden
Cargo.toml e08c6471dd Cargo.toml: suppress resolver warning on nightly 1 jaar geleden
LICENSE-APACHE 01e9f81043 Add license files 4 jaren geleden
LICENSE-MIT 01e9f81043 Add license files 4 jaren geleden
README.md 4ddbc1cacb Fix Aya build badge 2 jaren geleden
netlify.toml 7d19bde66b Unpin Rust nightly 2 jaren geleden
release.toml dfb03382f6 release.toml: fix pre/post release templates 2 jaren geleden
rustfmt.toml d6f299065d Add rustfmt.toml 4 jaren geleden

README.md

Aya

Crates.io License Build status Book

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