How dpdk/grout works
Grout is a userspace DPDK graph router. An operator configures interfaces and forwarding through grcli or the UNIX socket API; control-plane modules apply configuration, and graph workers process packets between interfaces. FRR can synchronize routes through its zebra dataplane plugin and the same API. The graph preserves major documented capabilities as separate domain subsystems. Evidence is limited to the README, tree, and sampled excerpts, so unsampled module-to-module wiring is not inferred.
Main entry points: api.c UNIX API · main_loop.c Packet graph · control Interfaces and workers · main.c Daemon lifecycle
Components 22
Router runtime
- Daemon lifecycle
main/main.c - Interfaces and workers
modules/infra/control - Graph workers
modules/infra/control/worker.c - Packet graph
modules/infra/datapath/main_loop.c
Forwarding domains
- IPv4 routing
modules/ip/control - IPv6 routing and RA
modules/ip6/control - Bridging and VXLAN
modules/l2/control - NAT and conntrack
modules/policy/control - IP-in-IP tunnels
modules/ipip/control.c - SRv6
modules/srv6/control - DHCP client
modules/dhcp/control/client.c - IPv4 packet handling
modules/ip/datapath/ip_input.c - IPv6 packet handling
modules/ip6/datapath/ip6_input.c - L2 packet handling
modules/l2/datapath/bridge_input.c - NAT packet handling
modules/policy/datapath/nat_datapath.h - SRv6 packet handling
modules/srv6/datapath/srv6_local.c
External integration
- FRR zebra
- Zebra dplane plugin
frr/zebra_dplane_grout.c
Other components
- Operator
- DPDK interfaces
Connections 24
- Operator → grcli: runs commands
- grcli → UNIX API: sends requests
- Operator → UNIX API: programs router
- Daemon lifecycle → UNIX API: starts socket
- Daemon lifecycle → Interfaces and workers: initializes modules
- UNIX API → Interfaces and workers: dispatches requests
- UNIX API → IPv4 routing: dispatches requests
- UNIX API → IPv6 routing and RA: dispatches requests
- UNIX API → Bridging and VXLAN: dispatches requests
- UNIX API → NAT and conntrack: dispatches requests
- UNIX API → IP-in-IP tunnels: dispatches requests
- UNIX API → SRv6: dispatches requests
- UNIX API → DHCP client: dispatches requests
- Interfaces and workers → Graph workers: configures affinity
- Graph workers → Packet graph: runs graph
- DPDK interfaces → Packet graph: receives packets
- Packet graph → DPDK interfaces: transmits packets
- Packet graph → IPv4 packet handling: dispatches packets
- Packet graph → IPv6 packet handling: dispatches packets
- Packet graph → L2 packet handling: dispatches packets
- Packet graph → NAT packet handling: dispatches packets
- Packet graph → SRv6 packet handling: dispatches packets
- FRR zebra → Zebra dplane plugin: supplies routes
- Zebra dplane plugin → UNIX API: configures via API