33. 扩展 DPDK

本章描述了开发者如何通过扩展DPDK来提供一个新的库、目标文件或者支持新的开发板。

33.1. 示例：添加新的库 libfoo

要添加新的库到DPDK，按照如下操作：

1. 添加新的配置选项：

   for f in config/\*; do \
       echo CONFIG_RTE_LIBFOO=y >> $f; done
   

2. 创建新的源码目录：

   mkdir ${RTE_SDK}/lib/libfoo
   touch ${RTE_SDK}/lib/libfoo/foo.c
   touch ${RTE_SDK}/lib/libfoo/foo.h
   

3. 源码添加 foo() 函数。

   函数定义于 foo.c:

   void foo(void)
   {
   }
   

   函数声明于 foo.h:

   extern void foo(void);
   

4. 更新文件 lib/Makefile:

   vi ${RTE_SDK}/lib/Makefile
   # add:
   # DIRS-$(CONFIG_RTE_LIBFOO) += libfoo
   

5. 为新的库创建新的 Makefile，如派生自 mempool Makefile，进行修改：

   cp ${RTE_SDK}/lib/librte_mempool/Makefile ${RTE_SDK}/lib/libfoo/
   
   vi ${RTE_SDK}/lib/libfoo/Makefile
   # replace:
   # librte_mempool -> libfoo
   # rte_mempool -> foo
   

6. 更新文件 mk/DPDK.app.mk，添加 -lfoo 选项到 LDLIBS 变量中。 链接DPDK应用程序时会自动添加此标志。

7. 添加此新库之后，重新构建DPDK (此处仅显示这个特殊的部分)：

   cd ${RTE_SDK}
   make config T=x86_64-native-linuxapp-gcc
   make
   

8. 检测这个库被正确安装了：

   ls build/lib
   ls build/include
   

33.1.1. 示例：在测试用例中使用新库 libfoo

测试应用程序用于验证DPDK的所有功能。 一旦添加了一个库，应该在测试用例程序中添加一个用例。

• 新的测试文件 test_foo.c 被添加，包含头文件 foo.h 并调用 foo() 函数。 当测试通过时，test_foo() 函数需要返回0。

• 为了处理新的测试用例，Makefile, test.h 和 commands.c 必须同时更新。

• 测试报告生成：autotest.py 是一个脚本，用于生成文件 ${RTE_SDK}/doc/rst/test_report/autotests 目录中指定的测试用例报告。 如果libfoo处于新的测试家族，链接 ${RTE_SDK}/doc/rst/test_report/test_report.rst 需要更新。

• 重新构建DPDK库，添加新的测试应用程序：

  cd ${RTE_SDK}
  make config T=x86_64-native-linuxapp-gcc
  make