lb.maps — org.clojars.pgdad/clj-ebpf-lb 0.10.0

eBPF map management for the load balancer. Provides functions to create, operate on, and close all required maps.

add-listen-port clj

(add-listen-port listen-map
                 ifindex
                 listen-port
                 {:keys [ip port] :as target}
                 &
                 {:keys [flags] :or {flags 0}})

Configure a listen interface/port with its default target. DEPRECATED: Use add-listen-port-weighted for weighted load balancing. ifindex: network interface index listen-port: listen port number target: {:ip <u32> :port <int>} flags: bit flags (bit 0 = stats enabled)

add-listen-port-unified clj

(add-listen-port-unified listen-map
                         ifindex
                         listen-port
                         af
                         target-group
                         &
                         {:keys [flags session-persistence] :or {flags 0}})

Configure a listen interface/port with weighted targets for unified maps. ifindex: network interface index listen-port: listen port number af: address family (:ipv4 or :ipv6) target-group: TargetGroup record with :targets (having :ip as 16-byte arrays) and :cumulative-weights flags: bit flags (bit 0 = stats enabled) session-persistence: if true, enables sticky sessions based on source IP hash

add-listen-port-weighted clj

(add-listen-port-weighted listen-map
                          ifindex
                          listen-port
                          target-group
                          &
                          {:keys [flags session-persistence] :or {flags 0}})

Configure a listen interface/port with weighted targets. ifindex: network interface index listen-port: listen port number target-group: TargetGroup record with :targets and :cumulative-weights flags: bit flags (bit 0 = stats enabled) session-persistence: if true, enables sticky sessions based on source IP hash

add-sni-route clj

(add-sni-route sni-map
               hostname
               target-group
               &
               {:keys [flags session-persistence] :or {flags 1}})

Add an SNI hostname route with weighted targets to the SNI map. hostname: TLS SNI hostname (will be lowercased) target-group: TargetGroup record with :targets and :cumulative-weights flags: optional flags (default 1 = enabled) session-persistence: if true, enables sticky sessions based on source IP hash

add-sni-route-unified clj

(add-sni-route-unified sni-map
                       hostname
                       target-group
                       &
                       {:keys [flags session-persistence] :or {flags 1}})

Add an SNI hostname route with unified weighted targets. hostname: TLS SNI hostname (will be lowercased) target-group: TargetGroup record with :targets (having :ip as 16-byte arrays) and :cumulative-weights flags: optional flags (default 1 = enabled) session-persistence: if true, enables sticky sessions based on source IP hash

add-source-route clj

(add-source-route config-map
                  {:keys [ip prefix-len]}
                  {:keys [ip port] :as target}
                  &
                  {:keys [flags] :or {flags 1}})

Add a source IP/CIDR route to the config map. DEPRECATED: Use add-source-route-weighted for weighted load balancing. source: {:ip <u32> :prefix-len <int>} target: {:ip <u32> :port <int>} flags: optional flags (default 1 = enabled)

add-source-route-unified clj

(add-source-route-unified config-map
                          {:keys [ip prefix-len]}
                          target-group
                          &
                          {:keys [flags session-persistence] :or {flags 1}})

Add a source IP/CIDR route with weighted targets to the unified config map. source: {:ip <16-byte-array> :prefix-len <int>} target-group: TargetGroup record with :targets (having :ip as 16-byte arrays) and :cumulative-weights flags: optional flags (default 1 = enabled) session-persistence: if true, enables sticky sessions based on source IP hash

add-source-route-weighted clj

(add-source-route-weighted config-map
                           {:keys [ip prefix-len]}
                           target-group
                           &
                           {:keys [flags session-persistence] :or {flags 1}})

Add a source IP/CIDR route with weighted targets to the config map. source: {:ip <u32> :prefix-len <int>} target-group: TargetGroup record with :targets and :cumulative-weights flags: optional flags (default 1 = enabled) session-persistence: if true, enables sticky sessions based on source IP hash

clear-stale-connections clj

(clear-stale-connections conntrack-map current-time-ns timeout-ns)

Remove connections that haven't been seen within the timeout period. timeout-ns: timeout in nanoseconds

close-all-maps clj

(close-all-maps {:keys [config-map listen-map sni-map conntrack-map settings-map
                        stats-ringbuf rate-limit-config-map rate-limit-src-map
                        rate-limit-backend-map]})

Close all maps and release resources.

create-all-maps clj

(create-all-maps)

(create-all-maps opts)

Create all maps required for the reverse proxy. Returns a map of {:config-map :listen-map :sni-map :conntrack-map :settings-map :stats-ringbuf :rate-limit-config-map :rate-limit-src-map :rate-limit-backend-map}

create-all-maps-unified clj

(create-all-maps-unified)

(create-all-maps-unified opts)

Create all unified maps for IPv4/IPv6 dual-stack support. Returns a map of {:config-map :listen-map :sni-map :conntrack-map :settings-map :stats-ringbuf :rate-limit-config-map :rate-limit-src-map :rate-limit-backend-map}

create-config-map clj

(create-config-map {:keys [max-routes]
                    :or {max-routes (:max-routes default-config)}})

Create LPM trie map for source IP -> target routing with weighted load balancing. Key: {prefix_len (4 bytes) + ip (4 bytes)} = 8 bytes Value: Weighted route format (72 bytes): Header (8 bytes): target_count(1) + reserved(3) + flags(2) + reserved(2) Per target (8 bytes each, max 8): ip(4) + port(2) + cumulative_weight(2)

create-config-map-unified clj

(create-config-map-unified {:keys [max-routes]
                            :or {max-routes (:max-routes default-config)}})

Create unified LPM trie map for source IP -> target routing (IPv4/IPv6). Key: {prefix_len (4 bytes) + ip (16 bytes)} = 20 bytes Value: Unified weighted route format (168 bytes): Header (8 bytes): target_count(1) + reserved(3) + flags(2) + reserved(2) Per target (20 bytes each, max 8): ip(16) + port(2) + cumulative_weight(2)

create-conntrack-map clj

(create-conntrack-map {:keys [max-connections]
                       :or {max-connections (:max-connections default-config)}})

Create per-CPU hash map for connection tracking. Using per-CPU variant for lock-free concurrent access. Key: 5-tuple (16 bytes aligned) Value: conntrack state (64 bytes): orig_dst_ip(4) + orig_dst_port(2) + pad(2) + nat_dst_ip(4) + nat_dst_port(2) + pad(2) + created_ns(8) + last_seen_ns(8) + packets_fwd(8) + packets_rev(8) + bytes_fwd(8) + bytes_rev(8)

create-conntrack-map-unified clj

(create-conntrack-map-unified {:keys [max-connections]
                               :or {max-connections (:max-connections
                                                      default-config)}})

Create unified per-CPU hash map for connection tracking (IPv4/IPv6). Key: 5-tuple (40 bytes): src_ip(16) + dst_ip(16) + ports(4) + proto(1) + pad(3) Value: conntrack state (96 bytes): orig_dst_ip(16) + orig_dst_port(2) + pad(2) + nat_dst_ip(16) + nat_dst_port(2) + pad(2) + created_ns(8) + last_seen_ns(8) + packets_fwd(8) + packets_rev(8) + bytes_fwd(8) + bytes_rev(8)

create-listen-map clj

(create-listen-map {:keys [max-listen-ports]
                    :or {max-listen-ports (:max-listen-ports default-config)}})

Create hash map for listen interface/port -> default target with weighted load balancing. Key: {ifindex (4 bytes) + port (2 bytes) + padding (2 bytes)} = 8 bytes Value: Weighted route format (72 bytes): Header (8 bytes): target_count(1) + reserved(3) + flags(2) + reserved(2) Per target (8 bytes each, max 8): ip(4) + port(2) + cumulative_weight(2)

create-listen-map-unified clj

(create-listen-map-unified {:keys [max-listen-ports]
                            :or {max-listen-ports (:max-listen-ports
                                                    default-config)}})

Create unified hash map for listen interface/port -> default target (IPv4/IPv6). Key: {ifindex (4 bytes) + port (2 bytes) + af (1 byte) + pad (1 byte)} = 8 bytes Value: Unified weighted route format (168 bytes)

create-rate-limit-backend-map clj

(create-rate-limit-backend-map
  {:keys [max-rate-limit-backend]
   :or {max-rate-limit-backend (:max-rate-limit-backend default-config)}})

Create LRU per-CPU hash map for per-backend rate limiting. Key: backend IP:port (8 bytes): ip(4) + port(2) + pad(2) Value: rate bucket (16 bytes): tokens(8) + last_update(8) Using LRU for automatic eviction of stale entries.

create-rate-limit-backend-map-unified clj

(create-rate-limit-backend-map-unified
  {:keys [max-rate-limit-backend]
   :or {max-rate-limit-backend (:max-rate-limit-backend default-config)}})

Create unified LRU per-CPU hash map for per-backend rate limiting (IPv4/IPv6). Key: backend IP:port (20 bytes): ip(16) + port(2) + pad(2) Value: rate bucket (16 bytes): tokens(8) + last_update(8)

create-rate-limit-config-map clj

(create-rate-limit-config-map _opts)

Create array map for rate limit configuration. Index 0: per-source rate limit config Index 1: per-backend rate limit config Each entry is 16 bytes: rate(8) + burst(8)

create-rate-limit-src-map clj

(create-rate-limit-src-map {:keys [max-rate-limit-src]
                            :or {max-rate-limit-src (:max-rate-limit-src
                                                      default-config)}})

Create LRU per-CPU hash map for per-source IP rate limiting. Key: source IP (4 bytes) Value: rate bucket (16 bytes): tokens(8) + last_update(8) Using LRU for automatic eviction of stale entries.

create-rate-limit-src-map-unified clj

(create-rate-limit-src-map-unified {:keys [max-rate-limit-src]
                                    :or {max-rate-limit-src (:max-rate-limit-src
                                                              default-config)}})

Create unified LRU per-CPU hash map for per-source IP rate limiting (IPv4/IPv6). Key: source IP (16 bytes) Value: rate bucket (16 bytes): tokens(8) + last_update(8)

create-settings-map clj

(create-settings-map {:keys [settings-entries]
                      :or {settings-entries (:settings-entries
                                              default-config)}})

Create array map for global settings. Index 0: stats enabled (0/1) Index 1: connection timeout (seconds) Index 2: reserved ... Note: Using default 4-byte values since clj-ebpf array maps use integer serializers.

create-sni-map clj

(create-sni-map {:keys [max-sni-routes]
                 :or {max-sni-routes (:max-sni-routes default-config)}})

Create hash map for TLS SNI hostname -> target routing with weighted load balancing. Key: hostname_hash (8 bytes) - FNV-1a 64-bit hash of lowercase hostname Value: Weighted route format (72 bytes): Header (8 bytes): target_count(1) + reserved(3) + flags(2) + reserved(2) Per target (8 bytes each, max 8): ip(4) + port(2) + cumulative_weight(2)

create-sni-map-unified clj

(create-sni-map-unified {:keys [max-sni-routes]
                         :or {max-sni-routes (:max-sni-routes default-config)}})

Create unified hash map for TLS SNI hostname -> target routing (IPv4/IPv6). Key: hostname_hash (8 bytes) - FNV-1a 64-bit hash of lowercase hostname Value: Unified weighted route format (168 bytes)

create-stats-ringbuf clj

(create-stats-ringbuf {:keys [ringbuf-size]
                       :or {ringbuf-size (:ringbuf-size default-config)}})

Create ring buffer for streaming statistics events. Size must be a power of 2.

decode-rate-config clj

(decode-rate-config bytes)

Decode rate limit configuration from bytes. Returns {:rate <tokens/sec> :burst <max-tokens>}

default-config clj

Default configuration for map creation.

delete-connection clj

(delete-connection conntrack-map five-tuple)

Delete a connection from the tracking map.

delete-connection-unified clj

(delete-connection-unified conntrack-map five-tuple)

Delete a connection from the unified tracking map.

disable-rate-limit clj

(disable-rate-limit config-map limit-type)

Disable rate limiting by setting rate to 0. config-map: the rate_limit_config array map limit-type: :source or :backend

disable-stats clj

(disable-stats settings-map)

Disable statistics collection in eBPF program.

enable-stats clj

(enable-stats settings-map)

Enable statistics collection in eBPF program.

encode-array-key clj

(encode-array-key index)

Encode an array map index as a 4-byte key. BPF array maps use u32 keys, which need to be encoded as bytes when using byte array values.

encode-rate-config clj

(encode-rate-config rate burst)

Encode rate limit configuration to bytes. rate: tokens per second burst: max tokens (burst size) Returns 16-byte buffer: rate(8) + burst(8)

get-connection-timeout clj

(get-connection-timeout settings-map)

Get connection timeout in seconds.

get-rate-limit-config clj

(get-rate-limit-config config-map limit-type)

Get rate limit configuration. config-map: the rate_limit_config array map limit-type: :source or :backend Returns {:rate <tokens/sec> :burst <max-tokens>} or nil if not set

get-setting clj

(get-setting settings-map index)

Get a global setting by index.

list-connections clj

(list-connections conntrack-map)

List all active connections.

list-connections-unified clj

(list-connections-unified conntrack-map)

List all active connections in unified map.

list-listen-ports clj

(list-listen-ports listen-map)

List all configured listen ports. Returns a sequence of {:listen {...} :route {...}} maps with weighted target data.

list-listen-ports-unified clj

(list-listen-ports-unified listen-map)

List all configured listen ports in unified map. Returns a sequence of {:listen {...} :route {...}} maps with address family.

list-sni-routes clj

(list-sni-routes sni-map)

List all SNI routes in the SNI map. Returns a sequence of {:hostname-hash <long> :route {...}} maps. Note: Original hostnames are not stored in the map, only their hashes.

list-sni-routes-unified clj

(list-sni-routes-unified sni-map)

List all SNI routes in the unified SNI map. Returns a sequence of {:hostname-hash <long> :route {...}} maps.

list-source-routes clj

(list-source-routes config-map)

List all source routes in the config map. Returns a sequence of {:source {...} :route {...}} maps with weighted target data.

list-source-routes-unified clj

(list-source-routes-unified config-map)

List all source routes in the unified config map. Returns a sequence of {:source {...} :route {...}} maps with unified IP addresses.

lookup-connection clj

(lookup-connection conntrack-map five-tuple)

Look up a connection by its 5-tuple.

lookup-connection-unified clj

(lookup-connection-unified conntrack-map five-tuple)

Look up a connection by its unified 5-tuple (with 16-byte IPs).

lookup-listen-port clj

(lookup-listen-port listen-map ifindex port)

Look up configuration for a listen interface/port. Returns weighted route data with :target-count, :flags, and :targets.

lookup-listen-port-unified clj

(lookup-listen-port-unified listen-map ifindex port af)

Look up configuration for a listen interface/port in unified map. Returns unified weighted route data.

lookup-sni-route clj

(lookup-sni-route sni-map hostname)

Look up an SNI hostname in the SNI map. Returns weighted route data with :target-count, :flags, and :targets.

lookup-sni-route-unified clj

(lookup-sni-route-unified sni-map hostname)

Look up an SNI hostname in the unified SNI map. Returns unified weighted route data.

lookup-source-route clj

(lookup-source-route config-map {:keys [ip prefix-len]})

Look up a source IP in the config map (exact match on prefix-len + IP). Returns weighted route data with :target-count, :flags, and :targets.

lookup-source-route-unified clj

(lookup-source-route-unified config-map {:keys [ip prefix-len]})

Look up a source IP in the unified config map. Returns unified weighted route data with :target-count, :flags, and :targets (with :ip as 16-byte arrays).

map-fd clj

(map-fd m)

Get the raw file descriptor for a map. This is needed when building eBPF programs that reference maps.

RATE-BUCKET-SIZE clj

RATE-CONFIG-SIZE clj

RATE-LIMIT-CONFIG-BACKEND clj

RATE-LIMIT-CONFIG-SRC clj

rate-limit-enabled? clj

(rate-limit-enabled? config-map limit-type)

Check if rate limiting is enabled for the given type.

remove-listen-port clj

(remove-listen-port listen-map ifindex port)

Remove a listen interface/port configuration.

remove-listen-port-unified clj

(remove-listen-port-unified listen-map ifindex port af)

Remove a listen interface/port configuration from unified map.

remove-sni-route clj

(remove-sni-route sni-map hostname)

Remove an SNI hostname route from the SNI map.

remove-source-route clj

(remove-source-route config-map {:keys [ip prefix-len]})

Remove a source IP/CIDR route from the config map.

remove-source-route-unified clj

(remove-source-route-unified config-map {:keys [ip prefix-len]})

Remove a source IP/CIDR route from the unified config map.

set-connection-timeout clj

(set-connection-timeout settings-map timeout-seconds)

Set connection timeout in seconds.

set-rate-limit-config clj

(set-rate-limit-config config-map limit-type rate burst)

Set rate limit configuration. config-map: the rate_limit_config array map limit-type: :source or :backend rate: tokens per second burst: max tokens (burst size)

set-setting clj

(set-setting settings-map index value)

Set a global setting by index.

SETTING-CONN-TIMEOUT clj

SETTING-MAX-CONNS clj

SETTING-STATS-ENABLED clj

stats-enabled? clj

(stats-enabled? settings-map)

Check if statistics collection is enabled.

TOKEN-SCALE clj