嵌入式 Linux 与 RTOS / 系统课时
写一个可加载内核模块
写一个可加载内核模块
这一节从零完成一个最小 Linux 内核模块:写源码与 Kbuild 文件,用目标内核构建目录交叉编译出 .ko,再在板端执行 insmod、rmmod 并核对日志。完成后,你会得到后续字符设备、platform 驱动都能复用的最小运行骨架。
学习目标
- 写出包含模块入口、退出函数与许可证声明的最小模块。
- 使用 Kbuild 针对目标内核完成外部模块交叉编译。
- 通过
insmod、lsmod、dmesg与rmmod验证加载和卸载,并识别常见失败原因。
准备源码与 Kbuild
创建空目录并保存下面两个文件。源码使用 pr_info 输出可检索日志;module_init 与 module_exit 分别登记加载和卸载入口。
#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");预期结果
模块编译并加载后,内核日志出现:anystack_hello: loaded
模块卸载后,内核日志出现:anystack_hello: unloaded将文件保存为 anystack_hello.c。同目录创建 Makefile:
obj-m += anystack_hello.o这是 Kbuild 的外部模块描述:目标 anystack_hello.ko 由 anystack_hello.o 链接得到。源码和 Makefile 本身属于构建输入,验证方法是在下一步成功生成 .ko。
针对目标内核编译
外部模块必须使用目标板正在运行的那套内核配置和构建产物。仅安装同版本的头文件并不总是够用;需要的目录通常已经执行过内核配置与准备步骤。
在模块源码目录执行下面命令。把 <PATH-TO-KERNEL-BUILD> 替换为目标内核的构建目录,并按实际架构修改 ARCH 与交叉编译器前缀。
# KDIR 必须对应目标板当前内核的已准备构建目录。
export KDIR="<PATH-TO-KERNEL-BUILD>"
export ARCH=arm64
export CROSS_COMPILE=aarch64-linux-gnu-
make -C "$KDIR" M="$PWD" modules预期输出
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 成功通常不输出文本,因此要同时查看模块列表和内核日志。
# insmod 无标准输出时,用模块表和日志共同确认入口已执行。
sudo insmod ./anystack_hello.ko
lsmod | grep '^anystack_hello'
dmesg | tail -n 20 | grep 'anystack_hello'预期输出
anystack_hello <SIZE> 0
anystack_hello: loaded<SIZE> 是构建结果相关的动态值。看到日志说明 module_init 注册的入口已经执行;lsmod 中引用计数为 0 表示当前没有其他模块或内核对象持有它。
卸载并验证退出
模块没有被占用时,可以通过模块名卸载。卸载完成后再次检查日志,并确认 lsmod 中不再出现该模块。
# 卸载后同时验证退出日志与模块表,避免只凭 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预期输出
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、字符设备或中断处理时,只要这个骨架仍能稳定加载和卸载,就能把新增故障限制在驱动功能层,而不是反复怀疑基础构建环境。