mTCP 项目安装与使用教程

1. 项目目录结构及介绍

mTCP 项目的目录结构如下：

mtcp/
├── apps/
│   ├── example/
│   ├── lighttpd-1.4.32/
│   └── apache_benchmark/
├── config/
├── docs/
├── dpdk/
├── dpdk-iface-kmod/
├── io_engine/
│   ├── driver/
│   ├── lib/
│   └── include/
├── mtcp/
│   ├── src/
│   ├── lib/
│   └── include/
├── util/
├── buildtest_dpdk.sh
├── buildtest_netmap.sh
├── buildtest_psio.sh
├── check_hyperthreading.sh
├── gitignore
├── gitmodules
├── travis.yml
├── CHANGELOG
├── LICENSE
├── Makefile.am
├── Makefile.in
├── README
├── README.config
├── README.devel
├── README.md
├── README.netmap
├── TODO
├── aclocal.m4
├── compile
├── config.guess
├── config.h.in
├── config.sub
├── configure
├── configure.ac
├── install-sh
├── missing
├── setup_linux_env.sh
├── setup_mtcp_dpdk_env.sh
└── setup_mtcp_onvm_env.sh

目录介绍

• apps/: 包含 mTCP 应用程序的示例和移植的应用程序，如 lighttpd 和 apache_benchmark。
• config/: 包含 mTCP 的配置文件示例。
• docs/: 包含项目的文档。
• dpdk/: 包含 Intel 的 DPDK 数据平面开发工具包。
• dpdk-iface-kmod/: 包含 DPDK 接口内核模块。
• io_engine/: 包含事件驱动的包 I/O 引擎，包括驱动程序、库和头文件。
• mtcp/: 包含 mTCP 源代码、库和头文件。
• util/: 包含有用的源代码，供应用程序使用。
• 其他文件: 包含项目的构建脚本、配置文件、许可证和自述文件等。

2. 项目启动文件介绍

mTCP 项目的启动文件主要包括以下几个脚本：

• setup_linux_env.sh: 用于设置 Linux 环境的脚本，包括卸载 DPDK 驱动、移除大页内存映射等。
• setup_mtcp_dpdk_env.sh: 用于设置 mTCP 的 DPDK 环境的脚本，包括编译 DPDK、安装驱动、设置大页内存等。
• setup_mtcp_onvm_env.sh: 用于设置 mTCP 的 ONVM（OpenNetVM）环境的脚本。

使用示例

# 设置 DPDK 环境
./setup_mtcp_dpdk_env.sh [<path to $RTE_SDK>]

# 设置 ONVM 环境
./setup_mtcp_onvm_env.sh

3. 项目的配置文件介绍

mTCP 项目的配置文件主要位于 config/ 目录和 apps/example/ 目录中。以下是一些关键配置文件的介绍：

配置文件示例

• apps/example/epserver.conf: 服务器端的配置文件，定义了服务器的监听端口、IP 地址等。
• apps/example/epwget.conf: 客户端的配置文件，定义了客户端的请求目标、并发连接数等。

配置文件格式

配置文件通常采用简单的键值对格式，例如：

# epserver.conf 示例
server_ip = 192.168.1.1
server_port = 8080
max_concurrency = 1000

自定义配置

用户可以根据自己的需求编写自定义的配置文件，并在启动应用程序时指定配置文件路径。

# 启动服务器
./epserver -f epserver.conf

# 启动客户端
./epwget -f epwget.conf

通过以上步骤，您可以成功安装和配置 mTCP 项目，并启动相应的应用程序。