DragonOS-Community/aya @ f3262e87bd6ff895537df47fcf5d17c598e564cc

Keine Beschreibung

Andrew Stoycos f3262e87bd Make map APIs return an option		vor 2 Jahren
.cargo	dc31e11691 Re-organize into a single workspace	vor 2 Jahren
.github	6ab7148731 bpf: Only use never type with rust nightly	vor 2 Jahren
.vim	dc31e11691 Re-organize into a single workspace	vor 2 Jahren
.vscode	dc31e11691 Re-organize into a single workspace	vor 2 Jahren
assets	2b98259be7 readme: Add crabby, sync with aya/README.md	vor 2 Jahren
aya	f3262e87bd Make map APIs return an option	vor 2 Jahren
aya-bpf-macros	895f96e971 ebpf: Add TcContext for classifier programs	vor 2 Jahren
aya-log	f3262e87bd Make map APIs return an option	vor 2 Jahren
aya-log-common	6f0637a6c8 aya-log, aya-log-common: start next development iteration 0.1.12-dev.0	vor 2 Jahren
aya-log-ebpf-macros	9a8409e3a2 aya-log-ebpf-macros: Fix the DisplayHint expression names	vor 2 Jahren
aya-log-parser	83ec27f06b lib: Add display hints	vor 2 Jahren
aya-tool	ec2bd69053 cargo: Remove unused dependencies	vor 2 Jahren
bpf	6c813b8c38 fix all clippy warnings	vor 2 Jahren
test	f3262e87bd Make map APIs return an option	vor 2 Jahren
xtask	ec2bd69053 cargo: Remove unused dependencies	vor 2 Jahren
.gitignore	67951cd2d7 xtask: Fix docs generation	vor 2 Jahren
CODE_OF_CONDUCT.md	e752ffb3be Add a Code of Conduct	vor 2 Jahren
CONTRIBUTING.md	0a9c9960e4 Add Documentation section to CONTRIBUTING.md	vor 2 Jahren
Cargo.toml	aaa20cc1fd aya-gen: Rename to aya-tool	vor 2 Jahren
LICENSE-APACHE	01e9f81043 Add license files	vor 4 Jahren
LICENSE-MIT	01e9f81043 Add license files	vor 4 Jahren
README.md	944d6b8a16 Change from Rust edition 2018 to 2021	vor 2 Jahren
netlify.toml	dc31e11691 Re-organize into a single workspace	vor 2 Jahren
release.toml	dc31e11691 Re-organize into a single workspace	vor 2 Jahren
rustfmt.toml	d6f299065d Add rustfmt.toml	vor 4 Jahren

API Documentation

Community

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.

README.md