编程 udev 规则不命中:ATTR 与 ATTRS 是两层语义,多个 ATTRS 必须落在同一个父设备

2026-11-23 00:09:15

udev 规则不命中:ATTR 与 ATTRS 是两层语义,多个 ATTRS 必须落在同一个父设备

先给结论:ATTR、KERNEL、SUBSYSTEM、DRIVER、ENV 只针对产生事件的那台设备本身;带 S 的 ATTRS、KERNELS、SUBSYSTEMS、DRIVERS 会沿 devpath 向上逐级搜索,命中任何一层父设备都算匹配。而一条规则里写多个 ATTRS{} 时,它们必须全部落在同一个父设备上,udev 不会把 A 属性取自父层、B 属性取自祖父层拼起来——这是最常见的写错点。

官方原文对这一点的表述是:"If multiple ATTRS matches are specified, all of them must match on the same device." 整段前言也明确:"If multiple keys that match a parent device are specified in a single rule, all these keys must match at one and the same parent device."

判据表

键匹配对象搜索范围
KERNEL事件设备名(如 sdb)仅事件设备
KERNELS设备名沿 devpath 向上
SUBSYSTEM子系统名(如 block、usb)仅事件设备
SUBSYSTEMS子系统名沿 devpath 向上
DRIVER驱动名仅事件设备,且事件产生时已绑定驱动
DRIVERS驱动名沿 devpath 向上
ATTR{file}sysfs 属性值仅事件设备的 sysfs 文件
ATTRS{file}sysfs 属性值沿 devpath 向上找具备该属性值的设备
ENV{key}udev 数据库属性udev 自身维护的属性空间,与 sysfs 无关

DRIVER 的空值陷阱值得单独一句:它只有在事件产生那一刻设备已经绑定驱动时才有值,没绑定就是空,规则直接不命中。想匹配「上游 USB 控制器用了哪个驱动」,用 DRIVERS。

ATTRS 必须同父:一个典型反例

假设要给一块 USB 硬盘建固定软链,看 udevadm info -a -n /dev/sdb 的输出,很容易写出:

SUBSYSTEM=="block", ATTRS{idVendor}=="0480", ATTRS{serial}=="20120902150413", SYMLINK+="my_disk"

如果 idVendor 出现在 USB 设备那一层,而 serial 只出现在更上层的 USB 接口或 hub 上,这条规则不会命中——两个 ATTRS 没落在同一台设备。正确做法是把这两个键收敛到同一个父设备能同时提供的属性上,或者拆成两条规则、用 ENV 中转。

尾部空白:为什么 ATTR{serial}=="ABC123" 也能匹配

udev 匹配属性值时忽略值尾部的空白,除非你写的匹配值本身就带尾部空白。sysfs 属性文件普遍以换行结尾,所以从 cat /sys/.../serial 里看到的内容末尾那个 \n 不会导致比较失败。反过来说,如果你从别处拷来的匹配串自己带了空格,那才会变严格。这一条同样适用于 ATTRS。

ATTR 与 ENV 来源不同,不能互换

  • ATTR{file} 读的是 sysfs 文件内容。
  • ENV{key} 读的是 udev 数据库里的设备属性,由内核 uevent、IMPORT{...}、前面规则的赋值等累积而来。

udevadm info -q property -n /dev/sdb 打印的是后者。在那里看到的 ID_VENDOR_ID、ID_SERIAL_SHORT 之类,是 udev 属性,不是 sysfs 文件,写成 ATTR{ID_SERIAL_SHORT} 必然不命中;反过来,/sys/block/sdb/device/... 里的文件内容也不能当 ENV 匹配。两者的唯一合法交叉是替换语法 $attr{file} 和 $env{key}。

顺带一提,ATTR{key} 不只是匹配键,它也是赋值键:写在赋值位置时,值会被写回事件设备对应的 sysfs 属性,语法与匹配完全相同、只差位置。SYSCTL{} 自 v220 起同样可作匹配键与赋值键。

可复现的排查示例

以一块 U 盘为例,三步定位规则为什么不命中。

第一步,看父设备链里有哪些可用属性值:

udevadm info -a -n /dev/sdb

输出分成两类段落:looking at device '/devices/.../block/sdb': 下的是事件设备自身属性,对应 ATTR;looking at parent device '/devices/...': 下的是各层父设备,对应 ATTRS。要写 ATTRS,就从同一段父设备里挑属性,别跨段拼。

第二步,看 udev 数据库里的属性(要写 ENV 时用这里):

udevadm info -q property -n /dev/sdb

这两个命令的输出不要混着抄。

第三步,模拟事件,直接看规则有没有命中:

udevadm test /sys/class/block/sdb

它隐含 --debug,会把规则求值过程打出来。命中时能看到类似 LINK 'my_disk' /etc/udev/rules.d/10-local.rules:1 的行,以及 DEVLINKS=...;没命中的规则不会出现在输出里。注意 udevadm test 不执行 RUN 指定的程序,所以它验证的是匹配与属性赋值,而非外部副作用。规则文件改动 udev 会自动检测,但不会对已存在的设备重放——所以现场验证要靠 udevadm test,而不是事后 ls /dev 看有没有软链。

规则模板

把上面的约束写进模板,大致是这样:

# 匹配事件设备自身:用 ATTR
SUBSYSTEM=="block", KERNEL=="sdb", ATTR{removable}=="1", SYMLINK+="my_disk"

# 匹配上游父设备:用 ATTRS,且多个键必须同父
SUBSYSTEM=="block", KERNELS=="1-1.2", ATTRS{idVendor}=="0480", ATTRS{idProduct}=="2020", SYMLINK+="my_disk"

参考

  • udev(7) Keys 章节:
  • udevadm(8):
复制全文 生成海报 udev Linux systemd 运维 Shell sysfs

推荐文章

程序员茄子在线接单