gobee — Schreiben Sie Ihre BPF-Programme in Go, nicht in C. gobee transpiliert eine Go-Teilmenge in BPF-C und generiert typisierte cilium/ebpf-Bindungen. | Kitploit

Ihre Eingabe (Go) Was gobee ausgibt (BPF C)

//go:build ignore

package main

import "github.com/boratanrikulu/gobee/bpf"

//bpf:license GPL

type Event struct {
    Pid  uint32
    Comm [16]byte
}

var Events = bpf.RingBuf[Event]{
    MaxEntries: 4096,
}

//bpf:section tracepoint/syscalls/sys_enter_execve
func OnExec(ctx *bpf.ExecveEnterCtx) bpf.TpReturn {
    e, ok := Events.Reserve()
    if !ok {
        return bpf.TpOk
    }
    e.Pid = bpf.GetCurrentPid()
    bpf.GetTaskComm(&e.Comm)
    Events.Submit(e)
    return bpf.TpOk
}

func main() {}

// Code generated by gobee. DO NOT EDIT.

#include "vmlinux.h"
#include <bpf/bpf_helpers.h>
#include <bpf/bpf_core_read.h>

char _license[] SEC("license") = "GPL";

struct Event {
    __u32 Pid;
    __u8 Comm[16];
};

struct {
    __uint(type, BPF_MAP_TYPE_RINGBUF);
    __uint(max_entries, 4096);
} Events SEC(".maps");

SEC("tracepoint/syscalls/sys_enter_execve")
int OnExec(struct trace_event_raw_sys_enter *ctx) {
    struct Event *e = bpf_ringbuf_reserve(
        &Events, sizeof(struct Event), 0);
    if (!e) {
        return 0;
    }
    e->Pid = (__u32)(
        bpf_get_current_pid_tgid() >> 32);
    bpf_get_current_comm(&e->Comm, 16);
    bpf_ringbuf_submit(e, 0);
    return 0;
}

	gobee	C + clang + bpf2go	Aya (Rust)	bpftrace	BCC
Sprache auf Kernelseite	Go-Teilmenge	C	Rust	DSL	C
Userspace-Integration	typisierte Go-Bindings + cilium/ebpf	bpf2go	aya-runtime	keine	Python
CO-RE	✅ über clang	✅	✅ über LLVM	✅	✅
Helper-Abdeckung	200 typisierte Go-Wrapper	vollständig (C schreiben)	vollständig	begrenzt	vollständig (C schreiben)
Verifier-Fehler → Quelle	✅ Go file:line:col	❌ rohes C	✅ Rust file:line	❌	teilweise
Kernel-Versionssperre beim Laden	✅ über bpfvet	manuell	manuell	n.v.	Laufzeit
Toolchain-Abhängigkeiten	Go + clang	clang + bpf2go	rustc + LLVM	bpftrace	Python + bcc
Generiertes Artefakt	`.bpf.o` + Go-Binärdatei	`.bpf.o` + Go-Binärdatei	`.bpf.o` + Rust-Binärdatei	JIT	JIT

Bereich	Abdeckung
Programmtypen (8)	XDP, tracepoint, kprobe / kretprobe, uprobe / uretprobe, sock_ops, TC, cgroup_skb, LSM
Map-Typen (19)	`array`, `hash`, `lru_hash`, per-CPU variants, `bloom_filter`, `lpm_trie`, `ringbuf`, `perf_event_array`, `prog_array`, `queue`, `stack`, sk/task/inode storage, devmap/cpumap/xskmap
BPF-Helper	~200 typisierte Go-Stubs, die automatisch aus den libbpf v1.5.0-Headern generiert werden. Diejenigen, die von `example/helloworld/` und `example/sysmon/` verwendet werden, werden in realem Kernel-CI getestet; der Rest ist ungeprüft. Erstellen Sie ein Issue, wenn ein Stub nicht mit der Kernel-Signatur übereinstimmt
CO-RE	✅ automatisch erkannt. `BPF_CORE_READ` für kernelinterne Strukturfelder (`task_struct`, `sock`, `inode`); direktes `ctx->field` für UAPI-BPF-Kontextstrukturen (`xdp_md`, `__sk_buff`, `bpf_sock_ops`). Getestet auf Linux 6.x (Ubuntu 24.04 CI); ältere Kernel sind noch nicht in der CI-Matrix enthalten
BTF-fähige Ausgabe	✅ Das ausgegebene C enthält `vmlinux.h` und verwendet `BPF_CORE_READ` für kernelinterne Feldlesungen, sodass das von `clang -g` erzeugte BTF die richtigen Relocationen trägt. clang selbst bleibt in Ihrer Verantwortung (die Beispiel-Makefiles zeigen den kanonischen Aufruf)
Benutzerdefinierte Helper	✅ Top-Level-Go-Funktionen ohne `//bpf:section` werden als `static __always_inline` C-Funktionen ausgegeben
Typisierte Go-Bindings	✅ `Load<Stem>`, `Close`, pro Programm `Attach<Name>`, `AttachAll`, sowie Ihre kernelseitigen Strukturtypen und Konstanten, die in Go neu veröffentlicht werden

yourproject/
├── bpf/                      # Go-Paket, überall in Ihrem Projekt importierbar
│   ├── embed_amd64.go        # //go:embed bin/x86/your.bpf.o
│   ├── embed_arm64.go
│   ├── your_bindings.go      # generated by gobee
│   ├── bin/{x86,arm64}/your.bpf.o
│   └── src/                  # kein Go-Paket; clang lebt hier
│       ├── your.go           # //go:build ignore: BPF source
│       ├── your.bpf.c        # generated
│       ├── Makefile          # clang per arch
│       └── vmlinux.h         # vendored BTF dump
├── main.go                   # imports yourproject/bpf
└── Makefile

gobee

Beliebteste

Wie es sich vergleicht

Was derzeit unterstützt wird

Was gobee tut

Was gobee nicht tun wird

Warum transpilieren und nicht direkt BPF generieren

Schnellstart

Projektstruktur (typisch)

Beispiele

CI

Dokumentation

Toolchain

Inspirationen

Lizenz

gobee

Beliebteste

gobee

Ein Go-File rein, ein BPF-Programm raus

Wie es sich vergleicht

Was derzeit unterstützt wird

Was gobee tut

Was gobee nicht tun wird

Warum transpilieren und nicht direkt BPF generieren

Schnellstart

Projektstruktur (typisch)

Beispiele

CI

Dokumentation

Toolchain

Inspirationen

Lizenz