README
¶
ndn-dpdk/container/strategycode
This package manages the BPF programs of NDN-DPDK's forwarding strategies. Every loaded strategy is identified by a numeric ID and has a (non-unique) short name for presentation purposes.
Strategy Loader
This package loads eBPF programs from an ELF object using two libraries: the DPDK BPF library and the uBPF library. DPDK contains a BPF validator that disallows loops, which is necessary for a forwarding strategy. uBPF has a limited ELF parser that is unable to handle ELF objects compiled by clang-4.0 and later.
To make these two libraries work together, load.c monkey-patches the rte_bpf_load function.
When loading a strategy ELF object:
- The
Loadfunction writes the ELF object to a temporary file. - DPDK's
rte_bpf_elf_loadreads the file and processes the relocations. - The
rte_bpf_loadmonkey patch receives eBPF instructions and passes them to uBPF. - A
struct ubpf_vm*pointer is stored into thebpf->prm.xsymvariable.
Documentation
¶
Overview ¶
Package strategycode manages forwarding strategy BPF programs.
Index ¶
- Variables
- func DestroyAll()
- type Strategy
- func (sc *Strategy) CountRefs() int
- func (sc *Strategy) ID() int
- func (sc *Strategy) InitFunc() func(arg unsafe.Pointer, sizeofArg uintptr) uint64
- func (sc *Strategy) Name() string
- func (sc *Strategy) Ptr() unsafe.Pointer
- func (sc *Strategy) String() string
- func (sc *Strategy) Unref()
- func (sc *Strategy) ValidateParams(params map[string]any) error
- type Xsyms
Constants ¶
This section is empty.
Variables ¶
var (
GqlStrategyType *gqlserver.NodeType[*Strategy]
)
GraphQL types.
Functions ¶
func DestroyAll ¶
func DestroyAll()
DestroyAll immediately unloads all strategies. Panics if some strategies are still used in FIB entry.
Types ¶
type Strategy ¶
type Strategy struct {
// contains filtered or unexported fields
}
Strategy is a reference of a forwarding strategy.
func LoadFile ¶
LoadFile loads a strategy BPF program from ELF file. If filename is empty, search for an ELF file in default locations.
func (*Strategy) CountRefs ¶
CountRefs returns number of references. Each FIB entry using the strategy has a reference. There's also a reference from table.go.
Source Files