30 lines
1.6 KiB
Markdown
30 lines
1.6 KiB
Markdown
eBPF
|
|
-------
|
|
[](https://pkg.go.dev/github.com/cilium/ebpf)
|
|
|
|
eBPF 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.
|
|
|
|
* [asm](https://pkg.go.dev/github.com/cilium/ebpf/asm) contains a basic assembler.
|
|
* [link](https://pkg.go.dev/github.com/cilium/ebpf/link) allows attaching eBPF to various hooks.
|
|
* [perf](https://pkg.go.dev/github.com/cilium/ebpf/perf) allows reading from a PERF_EVENT_ARRAY.
|
|
* [cmd/bpf2go](https://pkg.go.dev/github.com/cilium/ebpf/cmd/bpf2go) allows embedding eBPF in Go.
|
|
|
|
The library is maintained by [Cloudflare](https://www.cloudflare.com) and [Cilium](https://www.cilium.io). Feel free to [join](https://cilium.herokuapp.com/) the [libbpf-go](https://cilium.slack.com/messages/libbpf-go) channel on Slack.
|
|
|
|
## Current status
|
|
|
|
The package is production ready, but **the API is explicitly unstable
|
|
right now**. Expect to update your code if you want to follow along.
|
|
|
|
## Requirements
|
|
|
|
* A version of Go that is [supported by upstream](https://golang.org/doc/devel/release.html#policy)
|
|
* Linux 4.9, 4.19 or 5.4 (versions in-between should work, but are not tested)
|
|
|
|
## Useful resources
|
|
|
|
* [eBPF.io](https://ebpf.io) (recommended)
|
|
* [Cilium eBPF documentation](https://docs.cilium.io/en/latest/bpf/#bpf-guide) (recommended)
|
|
* [Linux documentation on BPF](http://elixir.free-electrons.com/linux/latest/source/Documentation/networking/filter.txt)
|
|
* [eBPF features by Linux version](https://github.com/iovisor/bcc/blob/master/docs/kernel-versions.md)
|