You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
aya/test
Alessandro Decina 11c227743d bpf: improve bpf_probe_read_kernel_str_bytes and bpf_probe_read_user_str_bytes
This change does a few things:

- it fixes a bug in the wrappers, where we were expecting the kernel to
  return len=1 for b"\0" where it instead returns 0 and doesn't write
  out the NULL terminator

- it makes the helpers more robust by hardcoding bound checks in
  assembly so that LLVM optimizations can't transform the checks in a
  way that the verifier can't understand.

- it adds integration tests
1 year ago
..
integration-ebpf bpf: improve bpf_probe_read_kernel_str_bytes and bpf_probe_read_user_str_bytes 1 year ago
integration-test bpf: improve bpf_probe_read_kernel_str_bytes and bpf_probe_read_user_str_bytes 1 year ago
integration-test-macros build(deps): update syn requirement from 1.0 to 2.0 2 years ago
.gitignore test: Replace RTF with Rust 2 years ago
README.md add libelf as a pre-requisite for linux, libbpf repo link 2 years ago
cloud-localds integration-tests: run on macos to get nested virtualization 2 years ago
run.sh Remove reference to system-llvm 2 years ago

README.md

Aya Integration Tests

The aya integration test suite is a set of tests to ensure that common usage behaviours work on real Linux distros

Prerequisites

Linux

To run locally all you need is:

  1. Rust nightly
  2. libelf
  3. A checkout of libbpf
  4. cargo install bpf-linker
  5. bpftool

Other OSs

  1. A POSIX shell
  2. A checkout of libbpf
  3. rustup target add x86_64-unknown-linux-musl
  4. cargo install bpf-linker
  5. Install qemu and cloud-init-utils package - or any package that provides cloud-localds

Usage

From the root of this repository:

Native

cargo xtask integration-test --libbpf-dir /path/to/libbpf

Virtualized

./test/run.sh /path/to/libbpf

Writing a test

Tests should follow these guidelines:

  • Rust eBPF code should live in integration-ebpf/${NAME}.rs and included in integration-ebpf/Cargo.toml
  • C eBPF code should live in integration-test/src/bpf/${NAME}.bpf.c. It's automatically compiled and made available as ${OUT_DIR}/${NAME}.bpf.o.
  • Any bytecode should be included in the integration test binary using include_bytes_aligned!
  • Tests should be added to integration-test/src/test
  • You may add a new module, or use an existing one
  • Integration tests must use the #[integration_test] macro to be included in the build
  • Test functions should return anyhow::Result<()> since this allows the use of ? to return errors.
  • You may either panic! when an assertion fails or bail!. The former is preferred since the stack trace will point directly to the failed line.