Linux lsmod 命令:查看已加载模块与 Used by 引用关系
lsmod 列出当前 Linux 内核已加载的模块,并显示模块大小、引用计数和引用它的其他模块。它适合核查驱动或内核功能是否以模块形式加载,但列表中没有某个名字,并不能直接证明该功能不可用。
内核模块是可以按需加载的内核功能组件。lsmod 将 /proc/modules 等当前内核模块状态整理成易读列表;直接编译进内核的功能不以独立已加载模块的形式出现在这里。它也不是磁盘上所有可安装模块的清单。
基本语法与准备
lsmod [option]
option 是选项占位说明,方括号不用原样输入。常见实现来自 kmod 工具集,可先用 command -v lsmod、lsmod --version 和 lsmod --help 确认工具与选项,再查看 man lsmod。查询通常不需要 sudo;命令不存在时应先确认发行版对应的软件包,而不是把“工具缺失”理解为“模块缺失”。
运行环境需要能读取相应的内核状态。容器或受限环境中的 /proc、/sys 视图和可见权限可能影响结果;若出现读取错误,应保留错误内容并核对环境,不能把查询失败解释为模块列表为空。
查看列表并查找指定模块
查看已加载模块。 先直接运行,检查是否正常出现列标题和模块行:
lsmod
结果反映查询时的状态,后台自动加载或卸载可能让两次查询不同。它不表示模块曾在何时加载,也不能证明所有使用该驱动的设备都工作正常。
查找 overlay。 以下命令筛选模块名为 overlay 的行:
lsmod | grep '^overlay '
^ 表示行首,overlay 后的空格用来排除 overlay_extra 等前缀相似的名字。单引号让 shell 原样传递正则表达式。这里假定标准 lsmod 输出以空格分隔字段;如果所用实现格式不同,应先观察原始列表再调整筛选。
若有结果,表示该行在本次列表中出现。若无结果,先独立运行 lsmod,确认没有错误,再判断是否无匹配。通常 grep 返回 0 表示匹配、1 表示没有匹配,其他错误需另查;普通 shell 管道的退出状态通常来自最后一个命令,不能仅凭它证明前面的 lsmod 成功。
查看模块元数据。
modinfo overlay
modinfo 查询模块文件及其描述、参数等元数据,不会因为执行查询就把模块加载进内核。按名字查询通常在所选内核版本的模块目录中查找;能查到文件不等于已加载,已加载模块的磁盘文件信息也不保证与运行中的实例完全一致。
读取 Module、Size 与 Used by
快速浏览时可以截取列表开头;head 默认取前十行,通常包含标题,而不是“前十个模块”:
lsmod | head
下面仅展示列结构,模块名称和数值是示意,不是本机实测:
Module Size Used by
nf_conntrack 123456 1
Module 是模块名;Size 是内核报告的模块大小,不是 CPU 使用率、磁盘上压缩模块文件的大小或性能指标。Used by 开头的数字是当前引用计数,不是累计调用次数,也不是加载次数。上例的 1 不能解释为“只运行过一次”。
数字后若出现模块名,列出的是引用当前模块的其他模块,即“谁在使用它”,不是当前模块需要加载的全部依赖。引用计数不一定等于后面名字的数量,因此只有数字而没有名字,并不自动表示输出损坏。计数为 0 也不应成为随意卸载生产驱动的依据。
kmod 的 lsmod 实现分别取得引用计数和引用者列表后输出,有助于理解这两部分为何不能简单等同。需要模块文件的描述或声明依赖时,应另外使用 modinfo。
主要选项与诊断范围
| 选项 | 用途与限制 |
|---|---|
-s |
把错误消息发送至 syslog,而非标准错误;不是把正常模块列表保存成日志。 |
-v |
增加程序操作的诊断消息;不是自动增加驱动参数、设备状态等列表列。 |
-V |
显示程序版本并退出,注意与小写 -v 区分。 |
-h |
显示帮助并退出,检查当前实现支持的选项。 |
-s 可能让终端不再显示原本送到标准错误的消息,排查时应知道实际日志位置。不同发行版的 kmod 版本或精简实现不一定完全相同,不能把上游支持的每个选项都假设为本机已有。
没有找到模块时如何判断
- 确认 lsmod 本身运行成功,并确认当前是宿主机、虚拟机还是受限容器。
- 检查模块名称是否准确;设备商品名、文件名与内核模块名不一定相同。
- 用 modinfo 查询相应模块元数据,区分磁盘文件可查与运行时已加载。
- 核对当前内核的配置、驱动绑定和相关日志,判断功能是否内建、尚未按需加载或确实缺少支持。
需要更详细的字段查询方法,可参考现有的 modinfo 模块信息说明(英文);这与 lsmod 的运行时列表回答的是不同问题。modinfo 查找失败也可能来自模块目录与当前内核不对应,不能独立证明内核完全不支持该功能。
实际加载或移除模块由 modprobe、insmod、rmmod 等管理命令处理,可能影响网络、存储及正在运行的服务。单纯核查状态无需执行这些修改;需要处理故障时,应先确定设备与模块关系及恢复方案,避免根据名字或引用计数直接卸载。
常见问题
驱动不出现在 lsmod 中,就不能使用吗?
不一定。功能可能已编译进内核、使用不同的模块名,或还没有按需加载。先确认查询成功,再结合内核配置、设备绑定、元数据与日志判断。
官方文档
kmod 上游 lsmod 手册说明列表和选项;modinfo 手册说明模块文件与字段查询。实际行为应与已安装版本的帮助和手册对照。




