https://github.com/aya-rs/aya-template
A cargo-generate template for Rust eBPF Projects using Aya
https://github.com/aya-rs/aya-template
cargo-generate ebpf rust
Last synced: about 1 year ago
JSON representation
A cargo-generate template for Rust eBPF Projects using Aya
- Host: GitHub
- URL: https://github.com/aya-rs/aya-template
- Owner: aya-rs
- License: apache-2.0
- Created: 2021-08-04T15:34:28.000Z (almost 5 years ago)
- Default Branch: main
- Last Pushed: 2025-04-24T10:33:25.000Z (about 1 year ago)
- Last Synced: 2025-04-24T11:33:44.595Z (about 1 year ago)
- Topics: cargo-generate, ebpf, rust
- Language: Rust
- Homepage:
- Size: 182 KB
- Stars: 96
- Watchers: 6
- Forks: 44
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE-APACHE
Awesome Lists containing this project
- awesome-ebpf-zh - aya-template - 用于在 Aya 中编写 BPF 应用程序的模板，可以与 [`cargo generate`](https://github.com/cargo-generate/cargo-generate) 一起使用。 (eBPF 工作流：工具和实用程序 / Aya)
- awesome-ebpf - aya-template - Templates for writing BPF applications in Aya that can be used with [`cargo generate`](https://github.com/cargo-generate/cargo-generate). (eBPF Workflow: Tools and Utilities / Aya)
- awesome-aya - Aya templates for `cargo-generate` - An easy way to generate a new Aya project using [`cargo-generate`](https://github.com/cargo-generate/cargo-generate) (Reference Documentation)
README
# {{project-name}}
## Prerequisites
1. stable rust toolchains: `rustup toolchain install stable`
1. nightly rust toolchains: `rustup toolchain install nightly --component rust-src`
1. (if cross-compiling) rustup target: `rustup target add ${ARCH}-unknown-linux-musl`
1. (if cross-compiling) LLVM: (e.g.) `brew install llvm` (on macOS)
1. (if cross-compiling) C toolchain: (e.g.) [`brew install filosottile/musl-cross/musl-cross`](https://github.com/FiloSottile/homebrew-musl-cross) (on macOS)
1. bpf-linker: `cargo install bpf-linker` (`--no-default-features` on macOS)
## Build & Run
Use `cargo build`, `cargo check`, etc. as normal. Run your program with:
```shell
cargo run --release --config 'target."cfg(all())".runner="sudo -E"'
```
Cargo build scripts are used to automatically build the eBPF correctly and include it in the
program.
## Cross-compiling on macOS
Cross compilation should work on both Intel and Apple Silicon Macs.
```shell
CC=${ARCH}-linux-musl-gcc cargo build --package {{project-name}} --release \
--target=${ARCH}-unknown-linux-musl \
--config=target.${ARCH}-unknown-linux-musl.linker=\"${ARCH}-linux-musl-gcc\"
```
The cross-compiled program `target/${ARCH}-unknown-linux-musl/release/{{project-name}}` can be
copied to a Linux server or VM and run there.
## License
With the exception of eBPF code, {{project-name}} is distributed under the terms
of either the [MIT license] or the [Apache License] (version 2.0), 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.
### eBPF
All eBPF code is distributed under either the terms of the
[GNU General Public License, Version 2] or the [MIT license], at your
option.
Unless you explicitly state otherwise, any contribution intentionally submitted
for inclusion in this project by you, as defined in the GPL-2 license, shall be
dual licensed as above, without any additional terms or conditions.
[Apache license]: LICENSE-APACHE
[MIT license]: LICENSE-MIT
[GNU General Public License, Version 2]: LICENSE-GPL2