This repository provides go bindings for the bcc framework as well as low-level routines to load and use eBPF programs from .elf files.
Input and contributions are very welcome.
We recommend vendoring gobpf and pinning its version as the API is regularly changing following bcc and Linux updates and releases.
eBPF requires a recent Linux kernel. A good feature list can be found here: https://github.com/iovisor/bcc/blob/master/docs/kernel-versions.md
Install the latest released version of libbcc (either using a package manager or by building from source).
Building ELF Object Files
To build ELF object files for use with the elf package, you must use specific
SEC("...")). The following are currently supported:
Map definitions must correspond to
bpf_map_def from the elf package.
Otherwise, you will encounter an error like
only one map with size 280 bytes allowed per section (check bpf_map_def).
tests/dummy.c for a minimal dummy and https://github.com/weaveworks/tcptracer-bpf
for a real world example.
Sample code can be found in the
examples/ directory. Examples can be run as
sudo -E go run examples/bcc/perf/perf.go
go test -tags integration -v ./...