build.md

Build Guide

Building the Intel® Media Transport Library requires three parts: building the DPDK library, building the Intel® Media Transport Library on top of DPDK, and building the sample application.

1. Install the build dependency

1.1 Ubuntu/Debian

sudo apt-get update
sudo apt-get install git gcc meson python3 python3-pip pkg-config libnuma-dev libjson-c-dev libpcap-dev libgtest-dev libsdl2-dev libsdl2-ttf-dev libssl-dev
sudo pip install pyelftools ninja

1.2 Centos

sudo dnf config-manager --set-enabled powertools
sudo yum install git gcc gcc-c++ meson python3 python3-pip pkg-config json-c-devel libpcap-devel gtest-devel SDL2-devel openssl-devel numactl-devel libasan
sudo pip3 install pyelftools

2. DPDK build and install

2.1 Get DPDK 23.03 source code

git clone https://github.com/DPDK/dpdk.git
cd dpdk
git checkout v23.03
git switch -c v23.03

2.2 Apply the DPDK patches required to run Intel® Media Transport Library

Note: $imtl_source_cod point to source code of Intel® Media Transport Library.

git am $imtl_source_cod/patches/dpdk/23.03/*.patch

2.3 Build and install DPDK library

meson build
ninja -C build
cd build
sudo ninja install
pkg-config --cflags libdpdk
pkg-config --libs libdpdk
pkg-config --modversion libdpdk

3. Build Intel® Media Transport Library and app

./build.sh

4. FAQ

4.1 PKG_CONFIG_PATH issue

It may get below error caused by PKG_CONFIG_PATH path problem.

lib/meson.build:10:0: ERROR: Dependency "libdpdk" not found, tried pkgconfig

Try below command to find the pc path and add to the PKG_CONFIG_PATH env.

find / -name libdpdk.pc
export PKG_CONFIG_PATH=/usr/local/lib64/pkgconfig/:/usr/local/lib/pkgconfig/

4.2 Build with clang

Before build, export CC/CXX to clang, see below for example.

export CC=clang CXX=clang++
rm build -rf
./build.sh