mirror of https://github.com/aya-rs/aya
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.
43 lines
1.2 KiB
Markdown
43 lines
1.2 KiB
Markdown
# aya-obj - an eBPF object file loading library
|
|
|
|
## Overview
|
|
|
|
eBPF programs written with [libbpf] or [aya-bpf] are usually compiled
|
|
into an ELF object file, using various sections to store information
|
|
about the eBPF programs.
|
|
|
|
`aya-obj` is a library that loads, parses and processes such eBPF
|
|
object files.
|
|
|
|
[libbpf]: https://github.com/libbpf/libbpf
|
|
[aya-bpf]: https://github.com/aya-rs/aya
|
|
|
|
## Example
|
|
|
|
This example loads a simple eBPF program and runs it with [rbpf].
|
|
|
|
```rust
|
|
use aya_obj::{generated::bpf_insn, Object};
|
|
|
|
// Parse the object file
|
|
let bytes = std::fs::read("program.o").unwrap();
|
|
let mut object = Object::parse(&bytes).unwrap();
|
|
// Relocate the programs
|
|
object.relocate_calls().unwrap();
|
|
object.relocate_maps(std::iter::empty()).unwrap();
|
|
|
|
// Run with rbpf
|
|
let program = object.programs.iter().next().unwrap().1;
|
|
let instructions = &program.function.instructions;
|
|
let data = unsafe {
|
|
core::slice::from_raw_parts(
|
|
instructions.as_ptr() as *const u8,
|
|
instructions.len() * core::mem::size_of::<bpf_insn>(),
|
|
)
|
|
};
|
|
let vm = rbpf::EbpfVmNoData::new(Some(data)).unwrap();
|
|
let _return = vm.execute_program().unwrap();
|
|
```
|
|
|
|
[rbpf]: https://github.com/qmonnet/rbpf
|