使用Autotools构建Linux驱动模块有哪些实用配置技巧

在Linux驱动开发场景下，手动维护Makefile需要适配不同内核版本的源码路径、编译参数，移植性较差。Autotools作为成熟的构建自动化工具链，可以通过生成可移植的构建脚本，简化Linux驱动模块的编译配置流程，以下是具体的实用配置技巧。

核心配置文件基础结构

使用Autotools构建驱动模块需要两个核心配置文件，分别是configure.ac和Makefile.am，前者用于生成configure脚本检测编译环境，后者用于定义编译规则。

configure.ac关键配置项

configure.ac需要完成内核源码路径检测、编译工具检查等工作，基础配置示例如下：

AC_INIT([my_driver], [1.0], [dev@ipipp.com])
AM_INIT_AUTOMAKE([-Wall -Werror foreign])
AC_PROG_CC
# 检测内核源码路径，支持通过--with-kernel-dir参数指定
AC_ARG_WITH([kernel-dir],
  AS_HELP_STRING([--with-kernel-dir=DIR], [kernel source directory]),
  [KERNEL_DIR="$with_kernel_dir"],
  [KERNEL_DIR="/lib/modules/$(uname -r)/build"])
# 校验内核源码目录是否存在
AC_CHECK_FILE([$KERNEL_DIR/Makefile],,
  AC_MSG_ERROR([kernel source directory $KERNEL_DIR not found]))
AC_SUBST([KERNEL_DIR])
AC_CONFIG_FILES([Makefile])
AC_OUTPUT

Makefile.am编译规则配置

Makefile.am需要定义驱动模块的编译目标、依赖和编译参数，适配内核模块的编译规则：

# 定义要生成的内核模块名称
obj-m += my_driver.o
# 如果有多个源文件，定义模块依赖的源文件
my_driver-objs := driver_core.o driver_ops.o
# 编译目标，调用内核的Makefile完成模块编译
all:
	$(MAKE) -C $(KERNEL_DIR) M=$(PWD) modules
# 清理编译产物
clean:
	$(MAKE) -C $(KERNEL_DIR) M=$(PWD) clean
# 安装模块到系统目录
install:
	$(MAKE) -C $(KERNEL_DIR) M=$(PWD) modules_install

适配不同内核版本的配置技巧

不同内核版本的API可能存在差异，可以通过以下方式在配置中兼容多版本内核：

• 在configure.ac中添加内核版本检测逻辑，根据版本定义不同的编译宏
• 在驱动源码中使用条件编译，适配不同版本的API差异

内核版本检测的configure.ac配置示例：

# 提取内核主版本号和次版本号
AC_MSG_CHECKING([kernel version])
KERNEL_VERSION=$(make -s -C $KERNEL_DIR kernelversion)
KERNEL_MAJOR=$(echo $KERNEL_VERSION | cut -d. -f1)
KERNEL_MINOR=$(echo $KERNEL_VERSION | cut -d. -f2)
AC_MSG_RESULT([$KERNEL_VERSION])
# 根据版本定义编译宏
if test "$KERNEL_MAJOR" -ge 5 -a "$KERNEL_MINOR" -ge 10; then
  CFLAGS+=" -DKERNEL_VERSION_GE_510"
fi
AC_SUBST([CFLAGS])

处理模块依赖的配置方法

如果驱动模块依赖其他内核模块或者外部库，需要在配置中添加依赖检测逻辑：

# 检测依赖的内核模块是否存在
AC_MSG_CHECKING([for dependency module])
DEP_MOD_PATH="$KERNEL_DIR/drivers/dependency/dependency.ko"
AC_CHECK_FILE([$DEP_MOD_PATH],,
  AC_MSG_WARN([dependency module not found, some features may not work]))
AC_SUBST([DEP_MOD_PATH])

完整构建流程演示

完成配置文件编写后，完整的构建流程如下：

# 生成构建脚本
autoreconf -i
# 配置编译环境，指定内核源码路径
./configure --with-kernel-dir=/usr/src/linux-headers-5.4.0
# 编译驱动模块
make
# 安装模块
sudo make install

通过以上配置技巧，可以让Autotools生成的构建脚本适配不同的编译环境，减少手动调整Makefile的工作量，提升Linux驱动模块的开发和移植效率。

AutotoolsLinux驱动模块Makefileconfigure内核编译修改时间：2026-07-01 20:24:29