Nav apraksta

astoycos 5dc007caf5 aya: fix map_pin_path logic 1 gadu atpakaļ
.cargo 6d06e2bf3a Include ~all crates in default members 1 gadu atpakaļ
.github fa6f5e2532 github: run integration tests on local kernel 1 gadu atpakaļ
.vim dc31e11691 Re-organize into a single workspace 2 gadi atpakaļ
.vscode 06d6a3e7a6 vscode: exclude public-api fixtures from search 1 gadu atpakaļ
assets 2b98259be7 readme: Add crabby, sync with aya/README.md 2 gadi atpakaļ
aya 5dc007caf5 aya: fix map_pin_path logic 1 gadu atpakaļ
aya-bpf-macros d16e607fd4 rustfmt: group_imports = "StdExternalCrate" 1 gadu atpakaļ
aya-log d16e607fd4 rustfmt: group_imports = "StdExternalCrate" 1 gadu atpakaļ
aya-log-common b54a106584 log: update comments 1 gadu atpakaļ
aya-log-ebpf-macros 2227223a96 aya-log: fix hygiene 1 gadu atpakaļ
aya-log-parser 96fa08bd82 cargo: Define dependencies on the workspace level 1 gadu atpakaļ
aya-obj a381022fca tmp: hack for btf verifier error 1 gadu atpakaļ
aya-tool d16e607fd4 rustfmt: group_imports = "StdExternalCrate" 1 gadu atpakaļ
bpf e2cf734490 aya: Implement RingBuf 1 gadu atpakaļ
init 82a77bc83d integration-test: Implement running on VMs 1 gadu atpakaļ
test 5dc007caf5 aya: fix map_pin_path logic 1 gadu atpakaļ
xtask e2cf734490 aya: Implement RingBuf 1 gadu atpakaļ
.gitignore b86d42d1b0 xtask: remove assumptions from docs command 1 gadu atpakaļ
.gitmodules d5259ce789 xtask: move libbpf submodule 1 gadu atpakaļ
.mergify.yml 34d1d7a9d7 ci(Mergify): configuration update 1 gadu atpakaļ
.taplo.toml c8bf646ef0 toml: add formatter and check in CI 1 gadu atpakaļ
CODE_OF_CONDUCT.md e752ffb3be Add a Code of Conduct 2 gadi atpakaļ
CONTRIBUTING.md d4a399fb0c Update CONTRIBUTING.md to link to the test/README.md 2 gadi atpakaļ
Cargo.toml d679a973ca integration-tests: enable logs 1 gadu atpakaļ
LICENSE-APACHE 01e9f81043 Add license files 3 gadi atpakaļ
LICENSE-MIT 01e9f81043 Add license files 3 gadi atpakaļ
README.md 1aa1dc53db README: fix build badge 1 gadu atpakaļ
netlify.toml c8bf646ef0 toml: add formatter and check in CI 1 gadu atpakaļ
release.toml dfb03382f6 release.toml: fix pre/post release templates 2 gadi atpakaļ
rustfmt.toml d16e607fd4 rustfmt: group_imports = "StdExternalCrate" 1 gadu atpakaļ

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.