3. 模块加载流程详解

模块加载是内核动态扩展能力的核心入口。理解 insmod 与 modprobe 的用户态行为，以及内核模块加载器（module loader）在 VFS 层与文件系统挂载之间的交互，是诊断“模块加载失败”类问题的关键前提。本章从用户态工具到内核态加载路径，逐层拆解完整流程。

3.1 用户态加载工具：insmod vs modprobe

两个工具虽然最终都调用 init_module() 系统调用，但在依赖处理、参数传递和搜索路径上存在本质差异。

特性	insmod	modprobe
依赖解析	不处理依赖，直接加载指定文件	读取 modules.dep，递归加载所有依赖
参数传递	支持命令行参数，直接传给模块	从 /etc/modprobe.d/ 读取配置参数
搜索路径	必须指定 .ko 文件路径	在 /lib/modules/$(uname -r)/ 下自动搜索
别名处理	不支持	支持通过 alias 配置映射设备名到模块名
卸载能力	不支持	支持 modprobe -r 递归卸载

3.2 系统调用入口：init_module 与 finit_module

内核提供了两个系统调用用于加载模块：

• init_module：接收用户态传入的模块二进制数据（ELF 格式）和参数列表。
• finit_module：接收一个文件描述符，内核通过 VFS 读取模块文件。这是 modprobe 默认使用的路径，因为它能利用内核页缓存减少数据拷贝。

两个系统调用最终汇聚到内核模块加载器的核心函数 load_module()。

3.3 内核模块加载器内部流程

从系统调用到模块完成初始化，内核模块加载器经历以下关键阶段：

1. ELF 校验与解析：验证魔数、架构、版本魔法（vermagic）是否匹配当前内核。
2. 模块内存分配：在模块区域（module region）分配连续虚拟地址空间。
3. 段复制与重定位：将 ELF 各段复制到分配的内存，执行符号重定位。
4. 符号解析：查找模块引用的内核导出符号（EXPORT_SYMBOL），若缺失则返回 -ENOENT。
5. 模块参数处理：解析用户传入的参数，匹配模块内的 module_param 定义。
6. 模块初始化调用：执行模块的 init_module() 函数（注意与系统调用同名，但指模块内的初始化入口）。
7. 状态切换：若初始化成功，模块状态从 MODULE_STATE_COMING 切换为 MODULE_STATE_LIVE。

3.4 符号解析与重定位的底层细节

符号解析是模块加载中最容易出错的环节。内核维护一个全局的 符号表（kallsyms），包含所有导出的内核符号和已加载模块的导出符号。加载器通过 find_symbol() 函数在以下顺序中查找：

1. 内核自身符号（__start___ksymtab 段）
2. 已加载模块的导出符号（通过模块链表遍历）
3. 若启用 CONFIG_KALLSYMS_ALL，还可查找非导出符号（仅调试用途）

3.5 模块参数传递机制

模块参数通过 module_param() 宏定义，在加载时由内核解析。参数传递路径如下：

步骤	描述	涉及函数/数据结构
1. 用户态参数收集	insmod 或 modprobe 将参数字符串打包	strsep() 解析 key=val 对
2. 系统调用参数传递	通过 init_module() 的 param_values 参数传入内核	copy_from_user() 拷贝到内核空间
3. 内核参数解析	遍历模块的 __param 段，匹配参数名并调用 param_set_* 函数	parse_args() → parse_one()
4. 参数值写入	将解析后的值写入模块内的对应变量地址	通过 struct kernel_param 的 ops->set() 回调

3.6 模块加载与文件系统的交互点

模块加载过程中，与 VFS 和文件系统挂载相关的关键交互点包括：

• finit_module 的 VFS 读取：通过文件描述符调用 kernel_read_file_from_fd()，触发 VFS 的 read_iter 操作。若文件系统未挂载或损坏，此步骤直接失败。
• 模块 firmware 请求：模块初始化时若调用 request_firmware()，会触发内核通过 uevent 通知用户态，用户态需从 /lib/firmware/ 读取文件。此路径依赖文件系统挂载。
• sysfs 导出：模块加载成功后，内核在 /sys/module/ 下创建目录，依赖 sysfs 文件系统的挂载状态。

mount | grep /lib/modules ② 检查 noexec 标志：mount | grep noexec ③ 检查 firmware 路径：ls /lib/firmware/

3.7 模块加载失败常见错误码与根因

错误码	内核定义	典型根因	排查方向
-EINVAL	22	版本魔法不匹配、参数格式错误、ELF 格式异常	检查 modinfo 输出的 vermagic；确认内核配置
-ENOENT	2	依赖符号未找到、模块文件不存在	使用 modprobe --show-depends 检查依赖链
-ENOMEM	12	模块区域内存不足、模块过大	检查 /proc/modules 中模块数量；调整 CONFIG_MODULES 相关参数
-EFAULT	14	模块初始化函数访问非法地址、用户态参数指针无效	检查模块代码是否存在空指针解引用；使用 dmesg 查看 oops 信息
-EPERM	1	无权限加载模块（内核锁定或安全模块拦截）	检查 kernel.modules_disabled sysctl；查看 SELinux/AppArmor 日志

3.8 模块加载的完整时序与调试方法

以下是一个典型模块加载的完整时序，标注了每个阶段可用的调试手段：

1. 用户态发起 → 使用 strace -e init_module,finit_module 捕获系统调用参数。
2. 系统调用进入内核 → 使用 trace-cmd record -e syscalls:sys_enter_init_module 追踪。
3. ELF 校验 → 启用 dyndbg：echo 'module kernel/module.c +p' > /sys/kernel/debug/dynamic_debug/control。
4. 符号解析 → 查看 /proc/kallsyms 确认符号是否存在；使用 nm 检查模块的未定义符号。
5. 模块初始化 → 在模块的 init_module() 函数内添加 printk 或使用 ftrace 函数追踪。
6. 状态切换 → 检查 /sys/module/<name>/state 文件内容。