Linux lsmod与modinfo用法:查看内核模块信息
在Linux系统中,内核模块的管理与故障排查是一项需要细致操作的任务。许多用户都了解lsmod和modinfo这两个命令,但在实际使用时,常会发现它们提供的信息似乎不一致或缺失关键内容。这主要是因为这两个工具的关注点截然不同,必须结合使用才能获得完整的情况。 lsmod仅显示模块加载状态,无法确认是
在Linux系统中,内核模块的管理与故障排查是一项需要细致操作的任务。许多用户都了解lsmod和modinfo这两个命令,但在实际使用时,常会发现它们提供的信息似乎不一致或缺失关键内容。这主要是因为这两个工具的关注点截然不同,必须结合使用才能获得完整的情况。
lsmod仅显示模块加载状态,无法确认是否正常工作;modinfo只读取磁盘文件元数据;二者必须配合使用:lsmod查运行态,modinfo查兼容性与参数。

简而言之,lsmod告诉你的是“哪些模块当前正运行在内存中”,但它并不关心该模块是否真的在正常工作。而modinfo则完全不在意模块是否被加载,它的作用是读取存储在磁盘上的模块文件自带的“说明书”(即元数据)。因此,要彻底搞清楚模块问题,两者缺一不可。
lsmod 输出中 Used by 为 0 的情况分析
当看到Used by一列显示为0时,不要急于断定该模块是“闲置”的。这仅表示当前没有其他模块或内核子系统明确引用它,但模块本身确实还驻留在内存中。以下几种情况都很常见:
- 模块刚被
modprobe加载,但触发其工作的条件尚未满足。例如,一个USB设备驱动已加载,但对应的U盘尚未插入。 - 驱动已加载,但对应的硬件被热拔出或电源关闭。像
usb_storage模块,在U盘拔掉后,它可能仍留在列表中,但Used by会变为0。 - 有些模块在设计上就是“常驻监听”的,例如
kvm_intel,即使当前没有虚拟机在运行,它也会保持加载状态,Used by长期为0也属正常。 - 这里有一个关键陷阱:
Used by 0绝不意味着该模块可以安全卸载。尝试使用rmmod时,很可能仍会收到Module is in use的错误。这是因为内核内部可能通过try_module_get()这类机制持有引用,而lsmod的统计无法反映这一点。
modinfo 查不到模块名?先确认模块是否存在
当modinfo报错ERROR: Module 时,不必先怀疑命令输入有误。绝大多数情况下,是该模块根本没有安装到当前运行内核版本的对应路径下。可以按以下顺序排查:
- 首先使用
uname -r确认当前内核版本,例如输出为6.8.0-45-generic。 - 然后去对应的路径下查找文件:
ls /lib/modules/$(uname -r)/kernel/drivers/net/wireless/rtw88/rtw88_8822bu.ko*。确认文件是否存在。 - 如果文件存在,但是
.ko.xz这类压缩格式,通常modinfo能够直接识别,无需手动解压。不过,一些较老的工具链可能不支持,此时可以临时解压验证:xz -d rtw88_8822bu.ko.xz。 - 还需注意模块名和文件名的区别。例如文件
ath9k.ko对应的模块名就是ath9k。但像ath9k_common.ko,它通常是一个依赖模块,不能直接用modinfo ath9k_common去加载,而需要靠modprobe ath9k在加载主模块时自动将其载入。
使用 grep 过滤 lsmod 时为何会漏掉模块
想用lsmod | grep nvidia来查找所有NVIDIA相关模块?结果可能不如预期,因为模块名不一定包含您想找的关键词。这里有几个典型的“坑”:
- NVIDIA驱动的主模块确实是
nvidia,但其配套模块可能叫nvidia_uvm、nvidia_drm、nvidia_modeset。仅用grep nvidia会漏掉后面这些。 - 有些模块使用了别名(alias)。例如
btusb模块,可能在/etc/modprobe.d/的某个配置文件中被设置为bluetooth的别名。此时用lsmod | grep bluetooth去搜索,自然一无所获。 - 命令是大小写敏感的。
LSMOD不是有效命令,lsmod | grep NVME也无法匹配全小写的nvme模块。 - 更稳妥的做法是:
lsmod | awk '{print $1}' | grep -i 'nvidia\|nvme\|bt'。先用awk精确提取第一列(模块名),再进行不区分大小写的过滤。
modinfo -p 显示的参数,为何 modprobe 添加后未生效
modinfo -p列出的是模块在编译时声明的、可供配置的参数列表。但这只是一个“菜单”,要让参数真正起作用,还需满足几个条件:
- 参数必须在
modprobe命令中显式传递。例如:sudo modprobe r8169 disable_msi=1。 - 如果模块已经加载在内存中,那么再次执行
modprobe(不带-r选项)默认不会重新加载它。需要先rmmod r8169将其卸载,再重新执行带参数的modprobe命令。 - 有些参数比较特殊,必须在模块加载之前通过内核启动参数设置。例如
i915.enable_psr=0这类参数,需要写在GRUB配置文件的linux行里。待系统启动后再用modprobe传递是无效的。 - 如何验证参数生效?模块加载后,可以到
/sys/module/下对应的目录查看:sudo cat /sys/module/r8169/parameters/disable_msi。如果输出是Y或1,才算成功。
归根结底,内核模块管理的复杂之处不在于命令难记,而在于其状态信息分散在多个地方。运行时的加载状态在/proc/modules(即lsmod的数据源),模块文件本身及其元数据在/lib/modules/$(uname -r)/目录下,而加载后的参数与详细状态又在/sys/module/里。这三层信息各自独立,如果只盯着其中一处,很容易查错方向。
