gRPC API

Async, observable, typed.

The gRPC service is the single source of truth for runtime introspection. All handlers are asynchronous; pipeline RPCs return FAILED_PRECONDITION until start_flow completes.

kind

name

description

rpc

Health.Check

descriptionBasic liveness/readiness probe.

rpc

Hugepage.Stats

descriptionHugepage allocation statistics.

rpc

Hugepage.Info

descriptionDetailed mempool and hugepage layout.

rpc

ControlPlane.Snapshot

descriptionCurrent addresses, neighbors and routes from netlink.

rpc

Flow.Pipeline

descriptionInstalled pipes, entries and pipeline state.

Proto definition

The full service contract lives in proto/llmx_service.proto. Generated stubs are produced as part of the CMake build.

Error model

DOCA/DPDK errors propagate through llmx::expected and surface as gRPC status codes with structured detail messages.