4. LTP环境搭建

LTP（Linux Test Project）环境搭建是驱动稳定性测试的基础。本章将系统讲解从依赖安装、源码获取到编译配置的完整流程，并针对常见编译错误提供解决方案。搭建一个干净、可复现的LTP环境，是后续驱动测试用例编写与执行的前提。

4.1 环境依赖安装

LTP依赖众多系统库和开发工具。以下表格列出了核心依赖包及其用途，适用于Debian/Ubuntu和RHEL/CentOS系列发行版。

依赖包	用途说明	Debian/Ubuntu安装命令	RHEL/CentOS安装命令
gcc / gcc-c++	C/C++编译器	apt install gcc g++	yum install gcc gcc-c++
make / automake	构建工具与自动配置	apt install make automake	yum install make automake
autoconf / libtool	自动配置脚本生成	apt install autoconf libtool	yum install autoconf libtool
linux-headers-$(uname -r)	内核头文件，编译内核模块必需	apt install linux-headers-$(uname -r)	yum install kernel-devel
libc6-dev / glibc-devel	C标准库开发文件	apt install libc6-dev	yum install glibc-devel
libnuma-dev / numactl-devel	NUMA支持库	apt install libnuma-dev	yum install numactl-devel
libaio-dev / libaio-devel	异步I/O库	apt install libaio-dev	yum install libaio-devel
libcap-dev / libcap-devel	POSIX能力管理库	apt install libcap-dev	yum install libcap-devel

4.2 源码获取

LTP源码托管于GitHub，推荐使用git克隆最新稳定分支。获取方式如下：

# 克隆主仓库（推荐使用 --depth=1 减少下载量）
git clone --depth=1 https://github.com/linux-test-project/ltp.git
cd ltp

# 查看当前版本
git describe --tags --always

若需特定版本（如与内核版本匹配），可切换标签：

# 列出所有标签
git tag -l

# 切换到20240101版本
git checkout tags/20240101 -b stable-20240101

4.3 编译配置：autotools流程

LTP使用GNU Autotools（autoconf/automake）进行编译配置。标准构建流程如下：

1. 生成configure脚本（若从git克隆需要此步，从发布tarball解压则跳过）：

make autotools

2. 运行configure，检测系统环境并生成Makefile：

./configure --prefix=/opt/ltp

常用配置选项：

配置选项	说明	推荐值
--prefix	安装路径	/opt/ltp
--with-realtime-testsuite	包含实时测试套件	驱动测试通常不需要
--with-open-posix-testsuite	包含POSIX测试套件	按需启用
--with-perl	启用Perl脚本支持	建议启用

3. 编译：

make -j$(nproc)

4. 安装：

sudo make install

安装完成后，LTP测试集位于 /opt/ltp 目录下，测试用例在 /opt/ltp/testcases/bin 中。

4.4 编译配置：Makefile直接构建

对于不需要autotools完整流程的场景（如嵌入式交叉编译），可直接使用顶层Makefile：

# 设置目标架构
export ARCH=arm64
export CROSS_COMPILE=aarch64-linux-gnu-

# 直接编译（跳过configure）
make -j$(nproc) all

此方式依赖 config.mk 文件中的默认配置，适用于快速验证。但推荐优先使用autotools流程，以确保依赖检测完整。

4.5 常见编译错误及解决方案

以下表格总结了LTP编译过程中最常见的错误及其解决方法：

错误现象	根本原因	解决方案
fatal error: linux/xxx.h: No such file or directory	内核头文件未安装或路径错误	安装 linux-headers-$(uname -r) 或 kernel-devel；检查 /lib/modules/$(uname -r)/build 是否存在
configure: error: *** libnuma required	NUMA库缺失	安装 libnuma-dev（Debian）或 numactl-devel（RHEL）
undefined reference to `timer_create'	链接时缺少librt	在configure时添加 LDFLAGS=-lrt，或检查系统是否已集成librt到libc
make[1]: *** No rule to make target 'autotools'	未安装autoconf/automake/libtool	安装 autoconf automake libtool 后重新执行
error: 'struct tpacket_req3' has no member named 'tp_retire_blk_tov'	内核版本过旧，不兼容新LTP	使用与内核版本匹配的LTP标签，或升级内核
/usr/bin/ld: cannot find -lcrypto	OpenSSL开发库缺失	安装 libssl-dev（Debian）或 openssl-devel（RHEL）

4.6 LTP编译流程SVG架构图

下图展示了从源码获取到安装完成的完整编译流程，以及各阶段的关键输入输出：

4.7 验证安装是否成功

安装完成后，执行以下命令验证LTP环境是否正常：

# 查看安装版本
/opt/ltp/runltp -V

# 运行一个简单的测试用例（如hello world测试）
/opt/ltp/testcases/bin/hello

# 列出所有可用测试用例
ls /opt/ltp/testcases/bin/ | head -20

若输出正常，说明LTP环境搭建成功，可以开始驱动测试用例的编写与执行。