Liking cljdoc? Tell your friends :D

Changelog

All notable changes to clj-ebpf will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[Unreleased]

DEVMAP and CPUMAP Support for XDP packet redirection:
- create-dev-map - Array-based interface redirect map for L2 forwarding
- create-dev-map-hash - Hash-based interface redirect map for sparse mappings
- create-cpu-map - CPU steering map for custom RSS (Receive Side Scaling)
XDP Redirect DSL Helpers (clj-ebpf.dsl.xdp):
- xdp-redirect - Direct interface index redirect
- xdp-redirect-map - Map-based redirect for DEVMAP/CPUMAP/XSKMAP
- xdp-redirect-to-interface - Convenience helper for DEVMAP
- xdp-redirect-to-cpu - Convenience helper for CPUMAP
New BPF helper IDs in DSL:
- redirect-map (51), sk-redirect-map (52), sock-map-update (53), xdp-adjust-meta (54)
XDP redirect example (examples/xdp_redirect_devmap.clj)
20 new tests for DEVMAP/CPUMAP with 55 assertions (CI-safe)

High-Level Declarative Macros (clj-ebpf.macros) - New macro system that reduces boilerplate by 60% and provides a more Clojure-idiomatic API:
- defmap-spec - Define reusable BPF map specifications with sensible defaults
- defprogram - Define BPF programs declaratively with DSL instructions
- with-bpf-script - Complete lifecycle management for maps, programs, and attachments with automatic cleanup
- load-defprogram - Convenience function to load a defprogram spec
- create-defmap - Convenience function to create a map from defmap-spec
Macros re-exported from clj-ebpf.core for convenient access
Support for all attachment types in with-bpf-script:
- XDP (:xdp) with mode and flags options
- TC (:tc) with direction and priority
- Kprobe/Kretprobe (:kprobe, :kretprobe)
- Tracepoint (:tracepoint) with category and event
- Uprobe/Uretprobe (:uprobe, :uretprobe) with binary and symbol/offset
- Cgroup (:cgroup-skb, :cgroup-sock) with cgroup path and direction
- LSM (:lsm) with hook name
Comprehensive macro documentation (docs/guides/macros.md)
Macro tutorial (tutorials/quick-start-macros.md)
Macro examples (examples/macro_dsl.clj)
Updated examples/simple_kprobe.clj to demonstrate both traditional and macro approaches
30 new tests for macros with 81 assertions (CI-safe, no BPF privileges required)

Fixed Java 25 compatibility issue reading /proc filesystem files. The get-current-cgroup function now uses java.nio.file.Files/readString instead of slurp, which fails on /proc files in Java 25 due to FileInputStream.available() returning EINVAL for special filesystem files.
Fixed batch operations fallback logic checking wrong errno keyword. The code was checking for :inval but the syscall layer returns :einval. Now map-lookup-batch, map-update-batch, map-delete-batch, and map-lookup-and-delete-batch correctly fall back to individual operations when the kernel doesn't support batch syscalls.

Fixed ENOENT errno handling in map operations - map-keys, map-values, map-entries, and map-count now work correctly on empty maps and when iterating to the end of a map. Previously checked for :noent instead of the correct :enoent errno keyword.