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

26次阅读

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

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

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

这通常不是权限问题,而是内核版本或符号版本不匹配。模块编译时用的 KBUILD_EXTRA_SYMBOLSModule.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 函数的返回值、符号解析时机、内核版本字符串的每个字符,都可能让一切静默失败。别只盯着命令是否报错,dmesgmodinfo 才是真实信源。

text=ZqhQzanResources