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):