Linux内核模块管理_insmod与lsmod使用说明【教程】

“Invalid module format”是因内核版本或符号版本不匹配，需检查modinfo输出与uname -r是否一致、编译是否使用正确内核头文件及Module.symvers；lsmod中星号表示模块tainted；insmod后未列显但无错，多因init函数返回非零值，应查dmesg；推荐用modprobe替代insmod以自动处理依赖和配置。

insmod 加载模块时提示 “Invalid module format” 怎么办

这通常不是权限问题，而是内核版本或符号版本不匹配。模块编译时用的 KBUILD_EXTRA_SYMBOLS 或 Module.symvers 文件缺失、路径不对，或者模块没用当前运行内核的头文件编译。

• 检查模块依赖的内核版本：

  modinfo your_module.ko | grep ^vermagic

  ，输出应与 uname -r 完全一致（包括 -smp、-generic 等后缀）
• 确认编译环境使用了正确的内核源码树，比如：make -C /lib/modules/$(uname -r)/build M=$(pwd) modules
• 若模块引用了外部符号，确保 Module.symvers 在构建目录中且被正确引用
• 禁用签名强制（仅调试）：加载时加 insmod your_module.ko sig_id=0（需内核配置支持 CONFIG_MODULE_SIG_FORCE=n）

lsmod 输出里模块名后面带星号（*）代表什么

星号表示该模块已被标记为“tainted”，即内核认为其来源不可信或行为可能影响稳定性。常见触发条件包括：模块未签名、使用了 staging 驱动、调用了 EXPORT_SYMBOL_GPL 以外的非 GPL 符号、或在加载时绕过了签名验证。

• lsmod 本身不显示 taint 状态细节，要看 dmesg 或 /proc/sys/kernel/tainted 的数值
• 数值非零即 tainted，可用 cat /proc/sys/kernel/tainted | awk '{printf \"%x\\n\", $1}' 查对应标志位
• 星号不影响模块功能，但某些厂商驱动或调试工具会拒绝在 tainted 内核上运行

insmod 后模块没出现在 lsmod 列表中，但也没报错

最可能是模块初始化函数（module_init()）返回了非零值，导致加载失败并自动卸载。这种失败不会向终端打印明显错误，只记入内核日志。

• 立即执行 dmesg | tail -20，查找类似 your_module: init failed with -22 的行
• 检查 init 函数是否调用了 request_irq()、register_chrdev() 等可能失败的接口，并做了错误处理和返回
• 模块中若有 __init 段函数，在初始化完成后会被释放，无法通过 cat /sys/module/your_module/sections/.init.text 查看 —— 这是正常行为，不代表加载失败
• 确认模块没有被 modprobe 的黑名单机制拦截（检查 /etc/modprobe.d/*.conf 中是否有 blacklist your_module）

为什么不用 insmod 而改用 modprobe

insmod 是底层加载器，不做依赖解析、别名展开或参数预设；modprobe 才是日常管理的合理入口。直接用 insmod 绕过依赖检查，容易导致模块静默失效或系统不稳定。

• modprobe your_module 会自动加载 your_module.ko 及其所有 depends: 字段声明的依赖模块
• 支持配置：可在 /etc/modprobe.d/ 下写 options your_module debug=1，下次 modprobe 时自动传参
• insmod 必须指定完整路径（如 insmod ./your_module.ko），而 modprobe 从 /lib/modules/$(uname -r)/ 下搜索，更安全可靠
• 调试时才用 insmod：比如测试未安装到标准路径的开发版模块，或复现特定加载顺序问题

模块加载不是“执行完就完事”，init 函数的返回值、符号解析时机、内核版本字符串的每个字符，都可能让一切静默失败。别只盯着命令是否报错，dmesg 和 modinfo 才是真实信源。