DPDK源码库中提供了一些示例程序来测试DPDK，这些示例程序可以看作是一个个小的DPDK的app。那我们先来分析第一个最简单的app——helloworld。
编译执行示例程序
运行app之前需要完成app的编译，这个前提是已经完成了DPDK库的编译和安装，编译方法很简单，首先需要导入两个环境变量，RTE_SDK指向DPDK的安装目录，RTE_TARGET指向DPDK的目标环境目录：
export RTE_SDK=/home/user/DPDK
export RTE_TARGET=x86_64-native-linuxapp-gcc
再进入示例程序的源码目录，如helloworld的app的代码就在$RET_SDK/examples/helloworld目录下，执行命令make即可完成编译，编译的可执行文件存放在build/app目录下：
# cd $RTE_SDK/examples/helloworld
# ls
Makefile main.c meson.build
# make
CC main.o
LD helloworld
INSTALL-APP helloworld
INSTALL-MAP helloworld.map
# ls build/app/
helloworld helloworld.map
执行该示例程序，该程序完成的功能是，从lcore上分别打印一条语句hello from core #，等所有的lcore都执行完之后master core也打印一条后退出。
# cd build/app/
# ./helloworld -l 0-4 -n 4
EAL: Detected 16 lcore(s)
EAL: Detected 2 NUMA nodes
EAL: Multi-process socket /var/run/dpdk/rte/mp_socket
EAL: No free hugepages reported in hugepages-1048576kB
EAL: No free hugepages reported in hugepages-2048kB
EAL: Probing VFIO support...
EAL: PCI device 0000:00:03.0 on NUMA socket -1
EAL: Invalid NUMA socket, default to 0
EAL: probe driver: 1af4:1000 net_virtio
EAL: PCI device 0000:00:07.0 on NUMA socket -1
EAL: Invalid NUMA socket, default to 0
EAL: probe driver: 1af4:1000 net_virtio
hello from core 1
hello from core 2
hello from core 3
hello from core 4
hello from core 0
EAL参数说明
从上面可以看到在执行helloworld程序时，后面指定了几个参数-l 0-4 -n 4，那这几个参数的含义是什么呢。打开源码可以看到这些参数最终都是传给EAL做初始化使用的，下面列出部分EAL参数说明其含义：
lcore相关参数
- -c COREMASK | -l CORELIST | --lcores COREMAPS：DPDK程序使用的核，可以使用核号的掩码或者列表的形式给出，例如 -c 0x1f 和 -l 0-4 效果是一样的，都表示使用的核是0,1,2,3,4。
- --master-lcore COREID：指定master core的核号，默认为核号最小的那个核。
- -s SERVICE_CORE_MASK：执行service cores的核的掩码，默认不分配。
内存相关参数
- -n CHANNELS：设置使用的内存通道。
- -r RANKS：设置使用的内存ranks，默认自动检测。
- -m MEGABYTES：启动时预分配的内存大小。
- --in-memory：
- --iova-mode <pa|va>
设备相关参数
- -b, --pci-blacklist PCI：禁止EAL使用的PCI设备列表。
- -w, --pci-whitelist PCI：将PCI设备加入到白名单。
- --vdev <device arguments>：添加一个虚拟设备，格式为
<driver><id>,[key=val,...]，例如：--vdev net_pcap0,rx_pcap=input.pcap,tx_pcap=output.pcap - -d <path_to_shared_object>：
- --no-pci：
调试相关参数
- --log-level <type:val>：设置不同组件的日志级别，例如
--log-level eal:8。
helloworld代码分析
了解上面一些基本的EAL参数之后，回头来分析一下hellworld的源码，从这个简单的app上看看DPDK的程序编码风格等。
/* SPDX-License-Identifier: BSD-3-Clause
* Copyright(c) 2010-2014 Intel Corporation
*/
#include <stdio.h>
#include <string.h>
#include <stdint.h>
#include <errno.h>
#include <sys/queue.h>
#include <rte_memory.h>
#include <rte_launch.h>
#include <rte_eal.h>
#include <rte_per_lcore.h>
#include <rte_lcore.h>
#include <rte_debug.h>
static int
lcore_hello(__attribute__((unused)) void *arg)
{
unsigned lcore_id;
lcore_id = rte_lcore_id();
printf("hello from core %u\n", lcore_id);
return 0;
}
int
main(int argc, char **argv)
{
int ret;
unsigned lcore_id;
ret = rte_eal_init(argc, argv);
if (ret < 0)
rte_panic("Cannot init EAL\n");
/* call lcore_hello() on every slave lcore */
RTE_LCORE_FOREACH_SLAVE(lcore_id) {
rte_eal_remote_launch(lcore_hello, NULL, lcore_id);
}
/* call it on master lcore too */
lcore_hello(NULL);
rte_eal_mp_wait_lcore();
return 0;
}
