DPDK文档翻译DPDK学习指南

DPDK编程指南（翻译）（ 三十一）

2017-11-16  本文已影响414人  半天妖

31. 开发套件构建系统

DPDK 需要一个构建系统用于编译等操作。 本节介绍 DPDK 框架中使用的约束和机制。

这个框架有两个使用场景：

31.1. 编译DPDK二进制文件

以下提供了如何构建DPDK二进制文件。

31.1.1. 建立目录概念

安装之后，将创建一个构建目录结构。 每个构件目录包含文件、库和应用程序。

构建目录特定于配置的体系结构、执行环境、工具链。 可以存在几个构建目录共享源码，但是配置不一样的情况。

例如，要使用配置模板 config/defconfig_x86_64-linuxapp 创建一个名为 my_sdk_build_dir 的构建目录，我们使用如下命令：

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

这会创建一个新的 new my_sdk_build_dir 目录，之后，我们可以使用如下的命令进行编译：

cd my_sdk_build_dir
make

相当于：

make O=my_sdk_build_dir

目录 my_sdk_build_dir 的内容是：

    -- .config                         # used configuration

    -- Makefile                        # wrapper that calls head Makefile
                                       # with $PWD as build directory


        -- build                              #All temporary files used during build
        +--app                                # process, including . o, .d, and .cmd files.
            |  +-- test                       # For libraries, we have the .a file.
            |  +-- test.o                     # For applications, we have the elf file.
            |  `-- ...
            +-- lib
                +-- librte_eal
                |   `-- ...
                +-- librte_mempool
                |  +--  mempool-file1.o
                |  +--  .mempool-file1.o.cmd
                |  +--  .mempool-file1.o.d
                |  +--   mempool-file2.o
                |  +--  .mempool-file2.o.cmd
                |  +--  .mempool-file2.o.d
                |  `--  mempool.a
                `-- ...

    -- include                # All include files installed by libraries
        +-- librte_mempool.h  # and applications are located in this
        +-- rte_eal.h         # directory. The installed files can depend
        +-- rte_spinlock.h    # on configuration if needed (environment,
        +-- rte_atomic.h      # architecture, ..)
        `-- \*.h ...

    -- lib                    # all compiled libraries are copied in this
        +-- librte_eal.a      # directory
        +-- librte_mempool.a
        `-- \*.a ...

    -- app                    # All compiled applications are installed
    + --test                  # here. It includes the binary in elf format

请参阅 Development Kit Root Makefile Help 获取更详细的信息。

31.2. 构建外部应用程序

由于DPDK本质上是一个开发工具包，所以最终用户的第一个目标就是使用这个SDK创建新的应用程序。 要编译应用程序，用户必须设置 RTE_SDK 和 RTE_TARGET 环境变量。

export RTE_SDK=/opt/DPDK
export RTE_TARGET=x86_64-native-linuxapp-gcc
cd /path/to/my_app

对于一个新的应用程序，用户必须创建新的 Makefile 并包含指定的 .mk 文件，如 ${RTE_SDK}/mk/rte.vars.mk 和 ${RTE_SDK}/mk/rte.app.mk。 这部分内容描述请参考 Building Your Own Application .

根据 Makefile 所选定的目标（架构、机器、执行环境、工具链）或环境变量，应用程序和库将使用适当的h头文件进行编译，并和适当的a库链接。 这些文件位于 ${RTE_SDK}/arch-machine-execenv-toolchain，由 ${RTE_BIN_SDK} 内部引用。

为了编译应用程序，用户只需要调用make命令。编译结果将置于 /path/to/my_app/build 目录。

示例应用程序在example目录中提供。

31.3. Makefile 描述

31.3.1. DPDK Makefiles 的通用规则

在DPDK中，Makefiles始终遵循相同的方案：

  1. 起始处包含 $(RTE_SDK)/mk/rte.vars.mk 文件。

  2. 为RTE构建系统定义特殊的变量。

  3. 包含指定的 $(RTE_SDK)/mk/rte.XYZ.mk 文件，其中 XYZ 可以是 app、lib、extapp, extlib、obj、gnuconfigure等等，取决于要编译什么样的目标文件。 请参阅

    See Makefile Types

    描述。

  4. 包含用户定义的规则及变量。

    以下是一个简单的例子，用于便于一个外部应用程序：

        include $(RTE_SDK)/mk/rte.vars.mk

    # binary name
    APP = helloworld

    # all source are stored in SRCS-y
    SRCS-y := main.c

    CFLAGS += -O3
    CFLAGS += $(WERROR_FLAGS)

    include $(RTE_SDK)/mk/rte.extapp.mk

31.3.2. Makefile 类型

根据Makefile最后包含的 .mk 文件，Makefile将具有不同的角色。 注意到，并不能在同一个Makefile文件中同时编译库和应用程序。 因此，用户必须创建两个独立的Makefile文件，最好是置于两个不同的目录中。

无论如何，rte.vars.mk 文件必须包含用户Makefile。

31.3.2.1. 应用程序

这些 Makefiles 生成一个二进制应用程序。

31.3.2.2. 库

创建一个 .a 库。

31.3.2.3. 安装

31.3.2.4. 内核模块

31.3.2.5. 对象

31.3.2.6. 杂

31.3.3. 内部生成的构建工具

app/dpdk-pmdinfogen

dpdk-pmdinfogen 扫描各种总所周知的符号名称对象文件。这些目标文件由各种宏定义，用于导出关于pmd文件的硬件支持和使用的重要信息。 例如宏定义：

RTE_PMD_REGISTER_PCI(name, drv)

创建以下的符号：

static char this_pmd_name0[] __attribute__((used)) = "<name>";

将被 dpdk-pmdinfogen 扫描。使用这个虚拟系，可以从目标文件中导出其他相关位信息，并用于产生硬件支持描述， 然后 dpdk-pmdinfogen 按照以下格式编码成 json 格式的字符串：

static char <name_pmd_string>="PMD_INFO_STRING=\"{'name' : '<name>', ...}\"";

然后可以通过外部工具搜索这些字符串，以确定给定库或应用程序的硬件支持。

31.3.4. 构建系统提供的有用变量

31.3.5. 只能在Makefile中设置/覆盖的变量

31.3.6. 只能在命令行上由用户设置/覆盖的变量

一些变量可以用来配置构建系统的行为。在文件 Development Kit Root Makefile Help 及 External Application/Library Makefile Help 中有描述。

这避免了根据编译器（icc或gcc）使用不同的情况。而且，这个变量可以从命令行覆盖，这允许绕过标志用于测试目的。

31.3.7. 可以在Makefile或命令行中由用户设置/覆盖的变量

上一篇 下一篇

猜你喜欢

热点阅读