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]

XSKMAP Support for AF_XDP zero-copy packet processing:
- create-xsk-map - XDP Socket Map for AF_XDP (XSK) file descriptors
- Maps queue indices to AF_XDP socket file descriptors
- Enables zero-copy packet delivery to userspace
XDP Redirect to XSK Helpers (clj-ebpf.dsl.xdp):
- xdp-redirect-to-xsk - Redirect packets to AF_XDP socket in XSKMAP
- xdp-redirect-to-xsk-by-queue - Redirect based on rx_queue_index (common pattern)
- Supports both immediate queue index and register-based lookup
XSKMAP Tutorial (tutorials/quick-start-xskmap.md):
- Comprehensive guide covering AF_XDP architecture
- UMEM and ring buffer concepts
- XDP program building patterns
- Performance optimization tips
XSKMAP Guide (docs/guides/xskmap-guide.md):
- Reference documentation for XSKMAP operations
- DSL function reference table
- xdp_md context field offsets
- Kernel version requirements (4.18+)
XSKMAP example (examples/xdp_xsk_redirect.clj)
22 new tests for XSKMAP with 84 assertions (CI-safe)
Updated tutorials/README.md with XSKMAP section
Updated docs/README.md with XSKMAP guide entry

SOCKMAP and SOCKHASH Support for socket redirection:
- create-sock-map - Array-based socket storage for SK_SKB/SK_MSG programs
- create-sock-hash - Hash-based socket storage with custom keys
SK_SKB Program Support (clj-ebpf.dsl.socket):
- sk-skb-prologue - Standard prologue for SK_SKB programs
- sk-redirect-map - Redirect stream data to socket in SOCKMAP
- sk-redirect-hash - Redirect stream data to socket in SOCKHASH
- sk-skb-pass, sk-skb-drop - Return patterns
SK_MSG Program Support (clj-ebpf.dsl.socket):
- sk-msg-prologue - Standard prologue for SK_MSG programs
- msg-redirect-map - Redirect message to socket in SOCKMAP
- msg-redirect-hash - Redirect message to socket in SOCKHASH
- sk-msg-pass, sk-msg-drop - Return patterns
Socket Map Update Helpers:
- sock-map-update - Add socket to SOCKMAP from BPF program
- sock-hash-update - Add socket to SOCKHASH from BPF program
Program Attachment Functions (clj-ebpf.programs):
- attach-sk-skb - Attach SK_SKB program to SOCKMAP/SOCKHASH
- attach-sk-msg - Attach SK_MSG program to SOCKMAP/SOCKHASH
- detach-sk-skb, detach-sk-msg - Detach programs from maps
New BPF helper IDs in DSL:
- msg-redirect-map (60), sock-hash-update (70)
- msg-redirect-hash (71), sk-redirect-hash (72)
SOCKMAP redirect example (examples/sockmap_redirect.clj)
35 new tests for SOCKMAP/SOCKHASH (CI-safe)

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.