Go to file
Tamir Duberstein c5300da1a1 appease `clippy::uninlined-format-args`
.github ci: `brew update` to install LLVM 20
{{project-name}} appease `clippy::uninlined-format-args`
{{project-name}}-common chore: Add LICENSE
{{project-name}}-ebpf chore: Add LICENSE
.gitignore chore: remove Cargo.lock from .gitignore ()
Cargo.toml chore: Add LICENSE
LICENSE-APACHE chore: Add LICENSE
LICENSE-GPL2 chore: Add LICENSE
LICENSE-MIT chore: Add LICENSE
README.md chore: Add LICENSE
cargo-generate.toml docs: update LSM hook prompt to reference lsm_hook_defs.h
pre-script.rhai include and use clap only if needed
rustfmt.toml Add rustfmt to CI
test.sh Enable unwinding in userspace

README.md

{{project-name}}

Prerequisites

  1. stable rust toolchains: rustup toolchain install stable
  2. nightly rust toolchains: rustup toolchain install nightly --component rust-src
  3. (if cross-compiling) rustup target: rustup target add ${ARCH}-unknown-linux-musl
  4. (if cross-compiling) LLVM: (e.g.) brew install llvm (on macOS)
  5. (if cross-compiling) C toolchain: (e.g.) brew install filosottile/musl-cross/musl-cross (on macOS)
  6. 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:

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.

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.