Tested with https://github.com/rust-lang/rust-bindgen v0.47. Tested with https://github.com/DPDK/dpdk.git v20.02.

There are other rust-dpdk implementations and you may choose most proper implementation to your purpose. (https://github.com/flier/rust-dpdk, https://github.com/netsys/netbricks) This library is built for following design goals.

1. Minimize hand-written binding code.
2. Do not include bindgen's output in this repository.
3. Statically link DPDK libraries instead of using shared libraries.
4. (TODO) Rust wrapper (rust-dpdk) for low-level DPDK APIs (rust-dpdk-sys).

First, this library depends on Intel Data Plane Development Kit (DPDK). Refer to official DPDK document to install DPDK (http://doc.dpdk.org/guides/linux_gsg/index.html).

Here, we include basic instructions to build DPDK and use this library.

Commonly, following packages are required to build DPDK.

apt-get install -y curl git build-essential libnuma-dev # To download and build DPDK
apt-get install -y linux-headers-amd64 # To build kernel drivers
apt-get install -y libclang-dev clang llvm-dev # To analyze DPDK headers and create bindings

We recognized existing DPDK installation from RTE_SDK and RTE_TARGET environment variables. If none of them is set, it will download and build DPDK in its temp directory.

If you want to install your own DPDK, download source code from DPDK official website.

wget http://fast.dpdk.org/rel/dpdk-20.02.tar.xz
tar xf dpdk-20.02.tar.xz
mv dpdk-20.02 dpdk
cd dpdk
export RTE_SDK=`pwd`

If you prepare your own DPDK build, DPDK must be built with -fPIC flag.

# in DPDK directory
EXTRA_CFLAGS=" -fPIC " make config T=x86_64-native-linux-clang
EXTRA_CFLAGS=" -fPIC " make -j install

# T=x86_64-native-linux-clang becomes RTE_TARGET
export RTE_TARGET="x86_64-native-linux-clang"

Now add rust-dpdk to your project's Cargo.toml and use it!

[dependencies]
rust-dpdk-sys = { git = "https://github.com/ANLAB-KAIST/rust-dpdk.git" }

1. Update Rust stable
2. Try new DPDK release with current bindgen
3. Check whether clang and bindgen repository share clang-sys versions
4. Try update bindgen (Do not sole update clang or bindgen)
5. Test build
6. Test run (refer to Dockerfile and Jenkinsfile)

List of failed bindgen builds (last update: 2020-03-18)

• v0.48
• v0.51
• v0.53 (clang-sys mismatch)