嵌入式 Linux 与 RTOS / 系统课时

写一个可加载内核模块

写一个可加载内核模块

这一节从零完成一个最小 Linux 内核模块:写源码与 Kbuild 文件,用目标内核构建目录交叉编译出 .ko,再在板端执行 insmod、rmmod 并核对日志。完成后,你会得到后续字符设备、platform 驱动都能复用的最小运行骨架。

学习目标

  • 写出包含模块入口、退出函数与许可证声明的最小模块。
  • 使用 Kbuild 针对目标内核完成外部模块交叉编译。
  • 通过 insmod、lsmod、dmesg 与 rmmod 验证加载和卸载,并识别常见失败原因。

准备源码与 Kbuild

创建空目录并保存下面两个文件。源码使用 pr_info 输出可检索日志;module_init 与 module_exit 分别登记加载和卸载入口。

c
#include <linux/init.h>
#include <linux/module.h>

static int __init anystack_hello_init(void)
{
    /* 加载阶段只验证入口执行,不申请额外资源。 */
    pr_info("anystack_hello: loaded\n");
    return 0;
}

static void __exit anystack_hello_exit(void)
{
    /* 退出路径与入口对称,便于后续扩展资源回收。 */
    pr_info("anystack_hello: unloaded\n");
}

module_init(anystack_hello_init);
module_exit(anystack_hello_exit);

MODULE_LICENSE("GPL");
MODULE_AUTHOR("Anystack");
MODULE_DESCRIPTION("Minimal loadable kernel module");

预期结果

text
模块编译并加载后,内核日志出现:anystack_hello: loaded
模块卸载后,内核日志出现:anystack_hello: unloaded

将文件保存为 anystack_hello.c。同目录创建 Makefile:

makefile
obj-m += anystack_hello.o

这是 Kbuild 的外部模块描述:目标 anystack_hello.ko 由 anystack_hello.o 链接得到。源码和 Makefile 本身属于构建输入,验证方法是在下一步成功生成 .ko。

针对目标内核编译

外部模块必须使用目标板正在运行的那套内核配置和构建产物。仅安装同版本的头文件并不总是够用;需要的目录通常已经执行过内核配置与准备步骤。

在模块源码目录执行下面命令。把 <PATH-TO-KERNEL-BUILD> 替换为目标内核的构建目录,并按实际架构修改 ARCH 与交叉编译器前缀。

bash
# KDIR 必须对应目标板当前内核的已准备构建目录。
export KDIR="<PATH-TO-KERNEL-BUILD>"
export ARCH=arm64
export CROSS_COMPILE=aarch64-linux-gnu-
make -C "$KDIR" M="$PWD" modules

预期输出

text
  CC [M]  <PATH>/anystack_hello.o
  MODPOST <PATH>/Module.symvers
  LD [M]  <PATH>/anystack_hello.ko

不同内核版本的日志细节可能略有差异,但成功结果必须包含 anystack_hello.ko。如果内核启用了 CONFIG_MODVERSIONS,还应确保构建时使用与目标内核一致的 Module.symvers,否则可能在加载时出现符号版本不匹配。

加载并验证入口

把 anystack_hello.ko 复制到目标板后,在 root 权限下加载。insmod 成功通常不输出文本,因此要同时查看模块列表和内核日志。

bash
# insmod 无标准输出时,用模块表和日志共同确认入口已执行。
sudo insmod ./anystack_hello.ko
lsmod | grep '^anystack_hello'
dmesg | tail -n 20 | grep 'anystack_hello'

预期输出

text
anystack_hello        <SIZE>  0
anystack_hello: loaded

<SIZE> 是构建结果相关的动态值。看到日志说明 module_init 注册的入口已经执行;lsmod 中引用计数为 0 表示当前没有其他模块或内核对象持有它。

卸载并验证退出

模块没有被占用时,可以通过模块名卸载。卸载完成后再次检查日志,并确认 lsmod 中不再出现该模块。

bash
# 卸载后同时验证退出日志与模块表,避免只凭 rmmod 返回值判断。
sudo rmmod anystack_hello
dmesg | tail -n 20 | grep 'anystack_hello'
if lsmod | grep -q '^anystack_hello'; then
  echo "still-loaded"
else
  echo "removed"
fi

预期输出

text
anystack_hello: unloaded
removed

这说明 module_exit 登记的退出函数已经执行,而且模块已从内核模块表移除。后续驱动如果创建了设备节点、中断、工作队列或内存资源,也应在退出路径中按依赖逆序释放,避免卸载后留下悬空资源。

处理常见加载失败

insmod: ERROR: could not insert module ...: Invalid module format 最常见于目标内核版本、架构或 vermagic 不一致。可先比较目标板 uname -r 与模块的 modinfo -F vermagic,再回到正确的内核构建目录重编译。

Unknown symbol 说明模块引用的符号没有被目标内核导出、依赖模块未加载,或符号版本不一致。若模块间存在依赖,优先用 modprobe 配合已安装的模块依赖信息,而不是手工猜测加载顺序。

Operation not permitted 则可能与权限、模块签名强制校验或系统禁止加载模块有关。遇到加载失败时,先读取紧邻失败时刻的 dmesg;用户态的 insmod 错误通常只是概括,真正能区分版本、签名和符号问题的是内核日志。

这个最小模块的价值在于把“编译链正确、.ko 与目标内核兼容、加载入口能执行、卸载路径能回收”四件事一次验证清楚。后续加入 platform_driver、字符设备或中断处理时,只要这个骨架仍能稳定加载和卸载,就能把新增故障限制在驱动功能层,而不是反复怀疑基础构建环境。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

写一个可加载内核模块

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通