udev 规则可以与内核添加到事件本身的属性或者内核导出到 sysfs 的任何信息相匹配。 规则还可以从外部程序请求其他信息。 根据提供的规则匹配每个事件。 所有规则都位于 /etc/udev/rules.d 目录下。
规则文件中的每一行至少包含一个关键字值对。 有两种类型的关键字,匹配关键字和指派关键字。 如果所有匹配关键字与它们的值匹配,则应用此规则并将指派关键字指派给特定的值。 匹配规则可以指定设备节点的名称、添加指向该节点的符号链接或者运行作为事件处理一部分的特定程序。如果找不到匹配的规则,则使用默认设备节点名来创建设备节点。 在 udev 手册页中描述了有关规则语法和提供用来匹配或导入数据的关键字的详细信息。下面的样本规则提供了 udev 规则语法的基本介绍。这些样本规则全部取自 /etc/udev/rules.d/50-udev-default.rules 下的 udev 默认规则集。
例 13.1. 样本 udev 规则
# console
KERNEL=="console", MODE="0600", OPTIONS="last_rule"
# serial devices
KERNEL=="ttyUSB*", ATTRS{product}=="[Pp]alm*Handheld*", SYMLINK+="pilot"
# printer
SUBSYSTEM=="usb", KERNEL=="lp*", NAME="usb/%k", SYMLINK+="usb%k", GROUP="lp"
# kernel firmware loader
SUBSYSTEM=="firmware", ACTION=="add", RUN+="firmware.sh"
console 规则由三个键构成:一个匹配键 (KERNEL) 和两个赋值键(MODE、OPTIONS)。KERNEL 匹配规则搜索设备列表以查找类型为 console 的所有项。只有完全匹配才有效,才能触发执行此规则。在这种情况下,MODE 关键字为设备节点指派特殊权限,仅为此设备的拥有者指派读写权限。OPTIONS 关键字将该规则标记为此类型的所有设备最后采用的规则。匹配此特殊设备类型的任何后续规则都不产生任何影响。
50-udev-default.rules 中不再提供 serial devices 规则,但该规则仍然值得考虑。该规则由两个匹配关键字(KERNEL 和 ATTRS)和一个赋值关键字 (SYMLINK) 构成。KERNEL 关键字搜索类型为 ttyUSB 的所有设备。该关键字使用 * 通配符匹配这些设备中的几个。第二个匹配关键字 ATTRS 检查任何 ttyUSB 设备的 sysfs 中的 product 属性文件是否包含特定字符串。赋值关键字 (SYMLINK) 将符号链接添加至该设备的 /dev/pilot 下。此关键字中使用的运算符 (+=) 告知 udev 进一步执行此操作,即使前面或后面的规则添加其他符号链接。由于此规则包含两个匹配关键字,因此仅当两个条件都满足时,才应用。
printer 规则处理 USB 打印机,其中包含两个匹配关键字(SUBSYSTEM 和 KERNEL),并且必须同时应用这两个关键字,才能应用整个规则。三个赋值键处理该设备类型的命名 (NAME)、符号设备链接 (SYMLINK) 的创建,以及此设备类型的组成员资格 (GROUP)。在 KERNEL 关键字中使用通配符 * 将使其匹配若干 lp 打印机设备。NAME 和 SYMLINK 关键字中都使用了替换项,以便按内部设备名称扩展这些字符串。例如,指向第一个 lp USB 打印机的符号链接为 /dev/usblp0。
kernel firmware loader 规则用于使 udev 在运行时期间通过外部助手脚本装载其他固件。SUBSYSTEM 匹配关键字搜索 firmware 子系统。ACTION 关键字检查是否添加了属于 firmware 子系统的任何设备。RUN+= 关键字触发执行 firmware.sh 脚本,以便找到应装载的固件。
所有规则具有一些共同的特征:
每个规则由一个或多个以逗号分隔的关键字值对构成。
关键字的运算由运算符确定。udev 规则支持多个不同的运算符。
每个给定值必须用引号引起来。
规则文件的每一行代表一个规则。如果一个规则超过一行,请使用 \ 合并不同行,就像在壳层语法中一样。
udev 规则支持匹配 *、? 和 [] 模式的壳层式模式。
udev 规则支持替换。
创建可以从若干不同运算符选择的关键字,具体取决于希望创建的关键字类型。匹配关键字通常仅用于查找匹配或明显不匹配搜索值的值。匹配关键字包含以下运算符之一:
==
比较等于性。如果关键字包含搜索模式,则匹配该模式的所有结果均有效。
!=
比较不等于性。如果关键字包含搜索模式,则匹配该模式的所有结果均有效。
赋值关键字可以使用下面的任何运算符:
=
为关键字指派值。如果关键字以前由一列值构成,关键字将重置,并且仅指派一个值。
+=
为包含一列项的关键字添加一个值。
:=
指派最终值。不允许后面的规则进行任何后续更改。
udev 规则支持使用占位符和替换项。请按照在其他任何脚本中的相同方式使用。在 udev 规则中可使用以下替换项:
%r、$root
设备目录 /dev(默认)。
%p、$devpath
DEVPATH 的值。
%k、$kernel
KERNEL 的值或内部设备名称。
%n、$number
设备号。
%N、$tempnode
设备文件的临时名称。
%M、$major
设备的主编号。
%m、$minor
设备的次编号。
%s{attribute}/$attr{attribute}
sysfs 属性的值(由 attribute 指定)。
%E{variable}、$attr{variable}
环境变量的值(由 variable 指定)。
%c、$result
PROGRAM 的输出。
%%
% 字符。
$$
$ 字符。
匹配关键字描述应用 udev 规则之前必须满足的条件。以下匹配关键字可用:
ACTION
事件操作的名称,如 add 或 remove(添加或删除设备时)。
DEVPATH
事件设备的设备路径,如 DEVPATH=/bus/pci/drivers/ipw3945,用于搜索与 ipw3945 驱动程序有关的所有事件。
KERNEL
事件设备的内部(内核)名称。
SUBSYSTEM
事件设备的子系统,如 SUBSYSTEM=usb(用于与 USB 设备有关的所有事件)。
ATTR{filename}
事件设备的 sysfs 属性。例如,要匹配 vendor 属性文件名中包含的字符串,可以使用 ATTR{vendor}=="On[sS]tream"。
KERNELS
让 udev 向上搜索设备路径以查找匹配的设备名称。
SUBSYSTEMS
让 udev 向上搜索设备路径以查找匹配的设备子系统名称。
DRIVERS
让 udev 向上搜索设备路径以查找匹配的设备驱动程序名称。
ATTRS{filename}
让 udev 向上搜索设备路径以查找具有匹配的 sysfs 属性值的设备。
ENV{key}
环境变量的值,如 ENV{ID_BUS}="ieee1394,用于搜索与该 FireWire 总线 ID 有关的所有事件。
PROGRAM
让 udev 执行外部程序。程序必须返回退出码零,才能成功。程序的输出(打印到 stdout)可用于 RESULT 关键字。
RESULT
匹配上次 PROGRAM 调用的输出字符串。在与 PROGRAM 关键字相同的规则中包含该关键字,或在后面的一个中。
与上述匹配键相比,赋值键未描述必须满足的条件。它们将值、名称和操作指派给由 udev 维护的设备节点。
NAME
将创建的设备节点的名称。在一个规则设置节点名称之后,将对该节点忽略带有 NAME 关键字的其他所有规则。
SYMLINK
与要创建的节点有关的符号链接名称。多个匹配的规则可添加要使用设备节点创建的符号链接。也可以通过使用空格字符分隔符号链接名称,在一个规则中为一个节点指定多个符号链接。
OWNER, GROUP, MODE
新设备节点的权限。此处指定的值重写已编译的任何值。
ATTR{key}
指定要写入事件设备的 sysfs 属性的值。如果使用 == 运算符,也将使用该关键字匹配 sysfs 属性的值。
ENV{key}
告知 udev 将变量导出到环境。如果使用 == 运算符,也将使用该关键字匹配环境变量。
RUN
告知 udev 向程序列表添加要为该设备执行的程序。请记住,将此程序限制于很短的任务,以免妨碍此设备的后续事件。
LABEL
添加 GOTO 可跳至的标签。
GOTO
告知 udev 跳过一些规则,继续执行具有按 GOTO 关键字引用的标签的规则。
IMPORT{type}
将变量装载入外部程序输出之类的事件环境中。udev 导入不同类型的若干变量。如果未指定任何类型,udev 将尝试根据文件权限的可执行位来自行确定类型。
program 告知 udev 执行外部程序并导入其输出。
file 告知 udev 导入文本文件。
parent 告知 udev 从父设备导入储存的关键字。
WAIT_FOR_SYSFS
告知 udev 等待要为某个设备创建的指定 sysfs 文件。例如,WAIT_FOR_SYSFS="ioerr_cnt" 通知 udev 等待此 ioerr_cnt 文件创建完成。
OPTIONS
OPTION 关键字可能有若干值:
last_rule 告知 udev 忽略后面的所有规则。
ignore_device 告知 udev 完全忽略此事件。
ignore_remove 告知 udev 忽略后面针对设备的所有删除事件。
all_partitions 告知 udev 为块设备上的所有可用分区创建设备节点。