ouroboros helps you manage and chain multiple eBPF programs together via managing central PROGRAM_MAPS and shared PINNED eBPF maps/ringbufs, making it easier to bpf_tail_call and build complex chain of eBPF program flow structure for complext programs

Running a single eBPF program is straightforward. But what if you need to run many of them in a specific order? ouroboros simplifies this by letting you:

• Organize your eBPF programs into a single project with metadata provided with ouroboros.json.
• Share and Allocate eBPF maps and ring buffers on initialization via ouroboros.json configuration.
• Create program maps for centralized tail call management and easy chaining in your C code.
• Machine Generated constants for program IDs and jump targets, so you don't have to manually manage them.
• Chain them together using eBPF tail calls with generated JUMP_TO_PROGRAM and PROG_* constants, easily implement tailing to next program.
• Build and load everything with simple commands, without finding pinned path when you use bpftool directly.

Make sure you have Go, Clang, and LLVM installed.

go install github.com/PacketStream-LLC/ouroboros@latest

1. Create a project:

   mkdir my_firewall
   cd my_firewall
   ouroboros create

   This will create ouroboros.json, src/ and target/ directories.

2. Add your first program:

   ouroboros add block_list

   Now, edit the C code in src/block_list/main.c.

3. Build and load it:

   ouroboros load

   This will compile your programs and load them into the kernel.

4. Attach to an interface:

   ouroboros attach eth0

5. See the logs:

   ouroboros log

See USAGE.md for detailed usage instructions.