README
¶
xdperf
🚧WIP🚧
xdperf is a high-performance network traffic generation tool that leverages XDP (eXpress Data Path). It can operate in both client and server modes, enabling measurement of network throughput and packet rate.
In addition, xdperf provides a flexible mechanism for transmitting arbitrary packets. This functionality is implemented through a plugin system based on WASM, which eliminates the dependency issues often encountered with Python-based tools like Trex. Another major advantage is that it does not rely on DPDK.
Furthermore, since xdperf is implemented in Go, it runs as a single binary, making deployment simple and convenient.
Install
Note: You need to install jq beforehand.
# latest install
curl -fsSL https://raw.githubusercontent.com/takehaya/xdperf/main/scripts/install_xdperf.sh | sudo sh
# extra: select version mode
curl -fsSL https://raw.githubusercontent.com/takehaya/xdperf/main/scripts/install_xdperf.sh | sudo sh -s -- --version v0.1.0
How To Use
sudo ./out/bin/xdperf --plugin simpleudp --device enp138s0f0
# local build case
sudo ./out/bin/xdperf --plugin simpleudp.go --plugin-path ./out/bin \
--device ens4 -D 2 \
--cfg '{"dst_port": 10001, "src_ip": "192.168.1.1", "dst_ip": "192.168.1.2"}'
9c:a3:ba:32:35:c5
For Developers
The following information describes what is required to build the project.
Prepare
On a Debian-based Linux environment, make sure the following tools are installed:
- make
- mise
- docker
Development Setup
make install-dev-pkg
make install-dev-tools
make install-build-tools
# Used by lefthook (explained later)
make install-lint-tools
# Equivalent to pre-commit
lefthook install
Go Binary Build
# Build all binaries (goreleaser)
make goreleaser
# Development build
make build
# Run build test (check for panics)
make test-runnable
BPF Binary Build
make bpf-gen
# debug pattern
# CEXTRA_FLAGS="-DXDPERF_DEBUG" make bpf-gen
Directories