Linux modinfo 命令:查看模块文件、参数与内核版本信息

modinfo 查询 Linux 内核模块的描述、文件位置、许可证、别名和参数等元数据。它不会加载模块或修改参数;能查到信息也不代表该模块已经加载,更不等于当前设备正在使用它。

内核模块是内核功能的可加载组件,元数据是描述该组件的信息。modinfo 可以按模块名查找,也能读取指定模块文件;默认按名查找通常针对当前运行内核的模块目录,指定其他内核版本或文件路径后,结果就可能来自不同对象。

基本语法与查询准备

modinfo [options] module_name|file_path

options、module_name 和 file_path 是占位说明,竖线表示“模块名或文件路径二选一”,不是要执行的 shell 管道;不要把这行原样当作实际命令。先用 command -v modinfo、modinfo --version 和 modinfo --help 确认工具及选项,再查看 man modinfo。常见实现属于 kmod,正常读取元数据通常不需要 sudo。

记录 uname -r 返回的内核 release。这与 kmod 工具版本是两回事;系统安装了新内核但尚未重启时,磁盘上的新模块与当前运行内核可能属于不同版本。

查询全部字段、位置与参数

查看模块信息。 以 overlay 为例,前提是目标内核的模块或相应内建元数据可查询:

modinfo overlay

输出通常按“字段名:值”排列。description 描述用途,license 是声明的许可证,alias 是匹配别名,depends 是声明的模块依赖。字段存在与否由模块提供的信息决定;不能要求每个模块都有全部字段,也不要把字段顺序写死。

只查看文件位置。

modinfo -n overlay

-n 是查询 filename 字段的快捷方式,独立模块通常返回模块文件路径。支持内建元数据的实现也可能返回 (builtin),这不是可打开的 .ko 文件名。不要把该输出不加判断地传给文件复制或删除命令。

查看支持的参数。

modinfo -p overlay

输出用于了解参数名、说明及提供的类型信息;不代表每个参数都有详细说明,也不是正在运行的模块参数值。即使说明中提到默认值,它也不能证明启动或加载时没有覆盖该默认值。没有参数输出时,先确认查询成功及模块是否提供参数元数据。

只读取需要的字段

脚本可用 -F 直接输出字段值,避免从整页文字按固定行号截取:

modinfo -F license nf_conntrack

下面是对应模块元数据声明为 GPL 时的示意输出,不是对当前机器的实测:

GPL

license 是声明信息,不能单凭这一行验证整个模块文件的来源、安全性或与当前内核的兼容性。-F 的字段名不区分大小写,某些字段可能有多个值;alias、parm、depends 等内容应按实际输出处理,不能假定任何字段都恰好一行。

空输出不一定表示整个模块不存在:可能是该字段未提供。应区分“命令成功但字段为空”和“查找模块失败”,保留退出状态及标准错误。需要处理值中可能出现的换行时,支持的实现提供 -0,以 NUL 字符分隔字段值,配套解析程序也必须使用相同分隔方式。

主要选项与目标内核

选项 用途与条件
-n 只输出 filename 字段;内建组件可能显示标记而非文件路径。
-F field 只输出指定字段的值;field 应换成真实字段名,需处理空值或多个值。
-p 显示模块参数元数据,不显示运行时已应用值。
-k release 按指定内核 release 查找模块;该内核的模块树必须存在。
-V 显示 modinfo 工具版本,与 uname -r 的内核版本区分。

例如 modinfo -k '目标内核release' overlay 中,引号内必须替换为实际安装的完整 release。-k 不会启动该内核或加载其模块;它适合检查尚未运行的已安装内核,但不能用它的结果证明当前内核的运行状态。

按名字查询通常搜索 /lib/modules 下对应版本的模块树;也可把实际模块文件路径作为参数。路径含空格时加引号,检查对象是否为预期文件。-b basedir 用于改变查找的根目录,适合离线系统树;它与 -k 的版本选择不同,均应先核对本机支持情况。

区分文件元数据与运行状态

要看当前已加载的模块,可另查 lsmod 列表与引用关系。modinfo 查到磁盘文件和 lsmod 显示运行实例是两项独立事实;系统更新替换文件后,也不能假设磁盘元数据完整描述了已加载的旧实例。

内建功能不以独立已加载模块出现在 lsmod 中。内核 Kbuild 的内建模块文件说明区分 modules.builtin 清单与 modules.builtin.modinfo 元数据;是否能查询到详细信息,还取决于内核、工具版本及发行版安装的元数据。

出现 Module ... not found 时,按顺序检查模块名称、uname -r 的 release、指定的 -k 或 -b 目标、模块文件及内建元数据是否齐全。容器中的模块目录还可能与所用内核不匹配。不要为了确认“是不是存在”而随意加载、卸载或更改生产驱动参数。

要核对实际生效的参数,应使用该驱动文档说明的运行时接口或相关日志;参数是否可读、可改和何时生效因驱动而异。读取说明与修改值属于不同操作,参数变化可能影响设备、文件系统或正在运行的服务。

常见问题

modinfo 没有结果,就表示内核不支持该功能吗?

不能。应先区分命令错误与缺少某字段,再核对模块名、文件路径、目标 release 和内建元数据。功能可能内建,也可能只是查询了不匹配或不完整的模块目录。

官方文档

kmod 上游 modinfo 手册说明字段、参数、NUL 分隔与其他内核版本的查询方式。上游版本可能比发行版更新,具体选项应与本机帮助和手册对照。