Files
zeekay d14b104790 feat(zap): v2 generic API, bufpool, transport allocator + UMA/RDMA cgo
Three orthogonal additions, one wire format.

v2 package — generic ad-hoc schema dispatch (~/work/lux/zap/v2):
- README + IMPOSSIBILITY + BENCH_RESULTS document the v1↔v2 split.
- builder/field/iter/list/pool/registry/schema/view + codegen package
  emit v1-equivalent fast paths from declarative .zap sources.
- _compile_fail_test/ + examples/ cover negative and positive cases.
- v2_test.go exercises the generic dispatch path.
- doc.go in v1 marks v1 deprecated for *new* schema authoring; existing
  v1 buffers stay parseable by both v1 and v2.

bufpool — pooled read slabs (bufpool.go + bufpool_test.go):
- Message gains optional *bufRef; Release() returns the slab to its
  pool when sourced from the pooled read path, GC-managed otherwise.
- ParseHeader returns (data, rootOffset) without allocating *Message,
  used by zapv2 to avoid two allocations per parse.
- bench_read_test.go + node_quic_stream_test.go cover both paths.

Transport allocator + UMA/RDMA cgo (transport/*):
- Transport.Caps()/Buffer interface: capability + slab-typed buffer
  contract. Bytes() vs DevicePtr() decoupled so UMA and GPUDirect
  can share the same call surface.
- DPDK PMD + GPUDirect RDMA + CUDA UMA real cgo backends gated behind
  build tags; stub paths remain default on darwin / non-Linux.
- transport_test.go covers Caps reporting + Buffer lifecycle on the
  default transport.

LLM.md + go.mod follow the additions.
2026-06-04 17:06:59 -07:00

26 lines
922 B
Go

// Copyright (C) 2025-2026, Lux Industries Inc. All rights reserved.
// See the file LICENSE for licensing terms.
//go:build cgo && linux && !dpdk
package transport
import "errors"
// newDPDK on linux without the dpdk build tag returns a clean
// not-available error so Pick() falls through. The real
// implementation requires:
//
// - `-tags dpdk`
// - DPDK 23.11+ installed with pkg-config visible (`pkg-config
// --modversion libdpdk` must succeed)
// - Hugepages configured (`/sys/kernel/mm/hugepages/<size>/nr_hugepages > 0`)
// - At least one NIC bound to vfio-pci or uio_pci_generic
// - Process privileges for CAP_SYS_NICE + CAP_IPC_LOCK
//
// See dpdk_linux_real.go (build tag cgo,linux,dpdk) for the live
// implementation.
func newDPDK() (Transport, error) {
return nil, errors.New("zap/transport: dpdk: built without -tags dpdk; rebuild with -tags dpdk and pkg-config libdpdk to enable")
}