dependabot[bot] 1dfcfbcf90 Merge pull request #1113 from aya-rs/dependabot/cargo/cargo-crates-ab63383a63 | 16 hours ago | |
---|---|---|
.cargo | 3 months ago | |
.github | 1 week ago | |
.vim | 2 years ago | |
.vscode | 1 year ago | |
assets | 2 years ago | |
aya | 2 weeks ago | |
aya-build | 1 week ago | |
aya-ebpf-macros | 6 days ago | |
aya-log | 1 month ago | |
aya-log-common | 2 months ago | |
aya-log-ebpf-macros | 8 months ago | |
aya-log-parser | 8 months ago | |
aya-obj | 2 weeks ago | |
aya-tool | 8 months ago | |
ebpf | 1 week ago | |
init | 1 month ago | |
test | 1 week ago | |
xtask | 1 week ago | |
.gitignore | 1 year ago | |
.gitmodules | 1 year ago | |
.markdownlint-cli2.yaml | 9 months ago | |
.mergify.yml | 9 months ago | |
.taplo.toml | 6 months ago | |
CODE_OF_CONDUCT.md | 1 year ago | |
CONTRIBUTING.md | 1 year ago | |
Cargo.toml | 18 hours ago | |
LICENSE-APACHE | 3 years ago | |
LICENSE-MIT | 3 years ago | |
README.md | 2 weeks ago | |
clippy.sh | 1 week ago | |
netlify.toml | 1 year ago | |
release.toml | 9 months ago | |
rustfmt.toml | 1 year ago |
Join the conversation on Discord to discuss anything related to Aya or discover and contribute to a list of Awesome Aya projects.
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:
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)?;
Please see the contributing guide.
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.