ebpf-go is a pure Go library that provides utilities for loading, compiling, and debugging eBPF programs. It has minimal external dependencies and is intended to be used in long running processes.
See ebpf.io for complementary projects from the wider eBPF ecosystem.
A small collection of Go and eBPF programs that serve as examples for building your own tools can be found under examples/.
Contributions are highly encouraged, as they highlight certain use cases of eBPF and the library, and help shape the future of the project.
The community actively monitors our GitHub Discussions page. Please search for existing threads before starting a new one. Refrain from opening issues on the bug tracker if you‘re just starting out or if you’re not sure if something is a bug in the library code.
Alternatively, join the #ebpf-go channel on Slack if you have other questions regarding the project. Note that this channel is ephemeral and has its history erased past a certain point, which is less helpful for others running into the same problem later.
This library includes the following packages:
PERF_EVENT_ARRAY
BPF_MAP_TYPE_RINGBUF
mapbpftool feature probe
for discovering BPF-related kernel features using native Go.RLIMIT_MEMLOCK
constraint on kernels before 5.11.Run make
in the root of this repository to rebuild testdata in all subpackages. This requires Docker, as it relies on a standardized build environment to keep the build output stable.
It is possible to regenerate data using Podman by overriding the CONTAINER_*
variables: CONTAINER_ENGINE=podman CONTAINER_RUN_ARGS= make
.
The toolchain image build files are kept in testdata/docker/.
MIT
The eBPF honeygopher is based on the Go gopher designed by Renee French.