Simple standalone python library to interact with bpf/ebpf maps via libbpf bindings.
This project aims to ease communication with eBPF programs using eBPF maps.
pip install bpfmaps
No need for any other dependencies, because the libbpf binary is built from source inside the github action and included in the python package. You can verify its authenticity by comparing the hashes of the pypi package with the ones printed in the github action that released it.
import bpfmaps
my_map = bpfmaps.BPF_Map.get_map_by_name('some_global')
my_map[0] = 10To locally work on this project you need to get the libbpf binary and put it into src/bpfmaps/libbpf/
This can be done by extracting it from the pypi package or building from source:
git clone --recurse-submodules [email protected]:PeterStolz/pybpfmaps.git
cd pybpfmaps/dependencies/libbpf/src
OBJDIR=../../../src/bpfmaps/libbpf/ make
cd ../../../To install the build dependencies you may run:
sudo apt-get update
sudo apt-get install clang llvm libelf-dev libpcap-dev gcc-multilib build-essential linux-libc-devThis project uses pytest for testing and the tests for x.py are stored in the file test_x.py.
As working with eBPF maps requires root you can execute the tests with:
sudo python3.10 -m pytest ./src
The tests may leave some bpf maps lying around, but they will perish after a reboot.