周玉环 d906a41c2e first commit 2 dienas atpakaļ
..
asm d906a41c2e first commit 2 dienas atpakaļ
btf d906a41c2e first commit 2 dienas atpakaļ
internal d906a41c2e first commit 2 dienas atpakaļ
link d906a41c2e first commit 2 dienas atpakaļ
.clang-format d906a41c2e first commit 2 dienas atpakaļ
.gitignore d906a41c2e first commit 2 dienas atpakaļ
.golangci.yaml d906a41c2e first commit 2 dienas atpakaļ
ARCHITECTURE.md d906a41c2e first commit 2 dienas atpakaļ
CODE_OF_CONDUCT.md d906a41c2e first commit 2 dienas atpakaļ
CONTRIBUTING.md d906a41c2e first commit 2 dienas atpakaļ
LICENSE d906a41c2e first commit 2 dienas atpakaļ
MAINTAINERS.md d906a41c2e first commit 2 dienas atpakaļ
Makefile d906a41c2e first commit 2 dienas atpakaļ
README.md d906a41c2e first commit 2 dienas atpakaļ
attachtype_string.go d906a41c2e first commit 2 dienas atpakaļ
collection.go d906a41c2e first commit 2 dienas atpakaļ
doc.go d906a41c2e first commit 2 dienas atpakaļ
elf_reader.go d906a41c2e first commit 2 dienas atpakaļ
info.go d906a41c2e first commit 2 dienas atpakaļ
linker.go d906a41c2e first commit 2 dienas atpakaļ
map.go d906a41c2e first commit 2 dienas atpakaļ
marshalers.go d906a41c2e first commit 2 dienas atpakaļ
prog.go d906a41c2e first commit 2 dienas atpakaļ
run-tests.sh d906a41c2e first commit 2 dienas atpakaļ
syscalls.go d906a41c2e first commit 2 dienas atpakaļ
types.go d906a41c2e first commit 2 dienas atpakaļ
types_string.go d906a41c2e first commit 2 dienas atpakaļ

README.md

eBPF

PkgGoDev

HoneyGopher

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.

The library is maintained by Cloudflare and Cilium.

See ebpf.io for other projects from the eBPF ecosystem.

Getting Started

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.

Getting Help

Please join the #ebpf-go channel on Slack if you have questions regarding the library.

Packages

This library includes the following packages:

  • asm contains a basic assembler, allowing you to write eBPF assembly instructions directly within your Go code. (You don't need to use this if you prefer to write your eBPF program in C.)
  • cmd/bpf2go allows compiling and embedding eBPF programs written in C within Go code. As well as compiling the C code, it auto-generates Go code for loading and manipulating the eBPF program and map objects.
  • link allows attaching eBPF to various hooks
  • perf allows reading from a PERF_EVENT_ARRAY
  • ringbuf allows reading from a BPF_MAP_TYPE_RINGBUF map
  • features implements the equivalent of bpftool feature probe for discovering BPF-related kernel features using native Go.
  • rlimit provides a convenient API to lift the RLIMIT_MEMLOCK constraint on kernels before 5.11.

Requirements

  • A version of Go that is supported by upstream
  • Linux >= 4.9. CI is run against kernel.org LTS releases. 4.4 should work but is not tested against.

Regenerating Testdata

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/.

License

MIT

eBPF Gopher

The eBPF honeygopher is based on the Go gopher designed by Renee French.