使用 udev 进行动态内核设备管理(转自suse文档)
第 12 章使用 udev 进行动态内核设备管理¶
目录
内核几乎可以添加或删除运行系统中的任何设备。设备状态的更改(无论插入还是删除设备)需要传播给用户空间。插入或者识别设备后需要进行配置。某个设备已识别状态的任何更改都需要通知给此设备的用户。udev 可提供所需的基础结构来动态维护 /dev 目录中的设备节点文件和符号链接。udev 规则提供了将外部工具插入内核设备事件处理的方式。这使您能够自定义 udev 设备处理,例如通过添加特定脚本来作为内核设备处理的一部分执行,或者请求并导入额外数据以在设备处理期间评估。
12.1. /dev 目录¶
/dev 目录中的设备节点提供对相应的内核设备的访问。使用 udev 时,/dev 目录反映内核的当前状态。每个内核设备都有相应的设备文件。如果设备从系统断开,则删除此设备节点。
/dev 目录的内容保存在临时文件系统中,所有文件都是在每个系统启动时提供的。手动创建或修改的文件在重引导时是有意不保存的。无论相应内核设备的状态如何都出现在 /dev 目录中的静态文件和目录,可以放置在 /lib/udev/devices 目录中。系统启动时,此目录的内容复制到 /dev 目录,它们与 /lib/udev/devices 中的文件具有相同的所有权和许可权限。
12.2. 内核 uevents 和 udev¶
必需的设备信息由 sysfs 文件系统导出。对于内核检测到并已初始化的设备,将创建一个带有该设备名称的目录。它包含带有特定于设备属性的属性文件。
每次添加或删除设备时,内核都会发送 uevent 来向 udev 通知更改。一旦启动,udev 守护程序便会读取和分析 /etc/udev/rules.d/*.rules 文件中提供的所有规则,并将它们保留在内存中。如果更改、添加或删除了规则文件,则守护程序可以使用命令 udevadm control reload_rules 重新装载所有规则在内存中的表示形式。运行 /etc/init.d/boot.udev reload 时也会执行此操作。有关 udev 规则及其语法的更多细节,请参见第 12.6 节 “使用 udev 规则影响内核设备事件处理”。
每个接收到的事件都根据所提供的规则集进行匹配。这些规则可以增加或更改事件环境键、为要创建的设备节点请求特定名称、添加指向该节点的符号链接或者添加设备节点创建后运行的程序。从内核 netlink 套接字接收驱动程序核心 uevent。
12.3. 驱动程序、内核模块和设备¶
设备的内核总线驱动程序探测。对于每个检测到的设备,内核都会在驱动程序核心将 uevent 发送到 udev 守护程序时创建内部设备结构。总线设备通过特殊格式的 ID 来标识自己,这可以识别设备的类型。通常,这些 ID 由供应商和产品 ID 以及其他特定于子系统的值组成。每个总线都有自己对于这些 ID 的方案,称为 MODALIAS。内核获取设备信息,由此组成一个 MODALIAS ID 字符串,并将该字符串与事件一起发送。对于 USB 鼠标,如下所示:
MODALIAS=usb:v046DpC03Ed2000dc00dsc00dp00ic03isc01ip02
每个设备驱动程序都带有它可以处理的设备的已知别名列表。这个列表包含在内核模块文件中。程序 depmod 读取 ID 列表并在内核的 /lib/modules 目录中为所有当前可用的模块创建文件 modules.alias。使用这种基础结构,模块的装载就如为每个带有 MODALIAS 关键字的事件调用 modprobe 一样简单。如果调用 modprobe $MODALIAS,它将组成该设备的设备别名与模块提供的别名相匹配。如果找到匹配的项,则装载该模块。所有这些操作均由 udev 自动触发。
12.4. 引导和启动设备设置¶
在 udev 守护程序运行之前的引导进程中发生的所有设备事件都会丢失,因为处理这些事件的基础结构保存在 root 文件系统中,并且此时不可用。为了弥补此损失,内核提供了一个 uevent 文件,该文件位于 sysfs 文件系统每个设备的设备目录中。通过将 add 写入到该文件,内核将再次发送引导时丢失的相同事件。/sys 触发器中所有 uevent 文件的简单循环将再次触发所有事件来创建设备节点并执行设备设置。
例如,在引导期间出现的 USB 鼠标可能不会由早期引导逻辑初始化,因为驱动程序在那时不可用。此设备发现的事件丢失并且不能为该设备查找内核模块。不用手动搜索可能连接的设备,udev 会在 root 文件系统可用后直接从内核请求所有设备事件,以便 USB 鼠标设备的事件可以再次运行。现在它在装入的 root 文件系统上找到内核模块,因此可以初始化 USB 鼠标。
在用户空间,设备冷插入序列和运行时期间发现的设备之间没有明显的区别。在这两种情况下,使用相同的规则来匹配并且运行相同的配置程序。
12.5. 监视正在运行的 udev 守护程序¶
程序 udevadm monitor 可以用于将驱动程序核心事件和 udev 事件处理的计时可视化。
UEVENT[1185238505.276660] add /devices/pci0000:00/0000:00:1d.2/usb3/3-1 (usb) UDEV [1185238505.279198] add /devices/pci0000:00/0000:00:1d.2/usb3/3-1 (usb) UEVENT[1185238505.279527] add /devices/pci0000:00/0000:00:1d.2/usb3/3-1/3-1:1.0 (usb) UDEV [1185238505.285573] add /devices/pci0000:00/0000:00:1d.2/usb3/3-1/3-1:1.0 (usb) UEVENT[1185238505.298878] add /devices/pci0000:00/0000:00:1d.2/usb3/3-1/3-1:1.0/input/input10 (input) UDEV [1185238505.305026] add /devices/pci0000:00/0000:00:1d.2/usb3/3-1/3-1:1.0/input/input10 (input) UEVENT[1185238505.305442] add /devices/pci0000:00/0000:00:1d.2/usb3/3-1/3-1:1.0/input/input10/mouse2 (input) UEVENT[1185238505.306440] add /devices/pci0000:00/0000:00:1d.2/usb3/3-1/3-1:1.0/input/input10/event4 (input) UDEV [1185238505.325384] add /devices/pci0000:00/0000:00:1d.2/usb3/3-1/3-1:1.0/input/input10/event4 (input) UDEV [1185238505.342257] add /devices/pci0000:00/0000:00:1d.2/usb3/3-1/3-1:1.0/input/input10/mouse2 (input)
UEVENT 行显示内核已经通过 netlink 发送的事件。UDEV 行显示已经完成的 udev 事件处理程序。计时以微秒为单位显示。UEVENT 和 UDEV 之间的时间是 udev 用于处理此事件或者 udev 守护程序延迟执行从而同步此事件与相关以及已运行的事件的时间。例如,硬盘分区的事件总是等待主磁盘设备事件完成,因为分区事件可能依赖于主磁盘事件从硬件查询的数据。
udevadm monitor --env 显示完整的事件环境:
ACTION=add DEVPATH=/devices/pci0000:00/0000:00:1d.2/usb3/3-1/3-1:1.0/input/input10 SUBSYSTEM=input SEQNUM=1181 NAME="Logitech USB-PS/2 Optical Mouse" PHYS="usb-0000:00:1d.2-1/input0" UNIQ="" EV=7 KEY=70000 0 0 0 0 REL=103 MODALIAS=input:b0003v046DpC03Ee0110-e0,1,2,k110,111,112,r0,1,8,amlsfw
udev 也将消息发送给 syslog。用于控制将哪些消息发送到系统日志的默认系统日志优先级在 udev 配置文件 /etc/udev/udev.conf 中指定。可以使用 udevadm control log_priority=level/number 更改正在运行的守护程序的日志优先权。
12.6. 使用 udev 规则影响内核设备事件处理¶
udev 规则可以与内核添加到事件本身的属性或者内核导出到 sysfs 的任何信息匹配。规则还可以从外部程序请求其他信息。根据提供的规则匹配每个事件。所有规则都位于 /etc/udev/rules.d 目录下。
规则文件中的每一行至少包含一个关键字值对。有两种类型的关键字,匹配关键字和指派关键字。如果所有匹配关键字与它们的值匹配,则应用此规则并将指派关键字指派给特定的值。匹配规则可以指定设备节点的名称、添加指向该节点的符号链接或者运行作为事件处理一部分的特定程序。如果找不到匹配的规则,则使用默认设备节点名来创建设备节点。udev 手册页中描述了有关规则语法和提供用来与数据匹配或导入数据的关键字的详细信息。以下示例规则提供了 udev 规则语法的基本介绍。这些示例规则全部取自 /etc/udev/rules.d/50-udev-default.rules 下的 udev 默认规则集。
例 12.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 规则支持替换。
12.6.1. 在 udev 规则中使用运算符¶
创建可以从若干不同运算符选择的关键字,具体取决于希望创建的关键字类型。匹配关键字通常仅用于查找匹配或明显不匹配搜索值的值。匹配关键字包含以下运算符之一:
==-
比较等于性。如果关键字包含搜索模式,则匹配该模式的所有结果均有效。
!=-
比较不等于性。如果关键字包含搜索模式,则匹配该模式的所有结果均有效。
赋值关键字可以使用下面的任何运算符:
=-
为关键字指派值。如果关键字以前由一列值构成,关键字将重置,并且仅指派一个值。
+=-
为包含一列项的关键字添加一个值。
:=-
指派最终值。不允许后面的规则进行任何后续更改。
12.6.2. 在 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的输出。 %%-
%字符。 $$-
$字符。
12.6.3. 使用 udev 匹配关键字¶
匹配关键字描述应用 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关键字相同的规则中包含该关键字,或在后面的一个中。
12.6.4. 使用 udev 指派关键字¶
与上述匹配键相比,赋值键未描述必须满足的条件。它们将值、名称和操作指派给由 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 为块设备上的所有可用分区创建设备节点。
-
12.7. 永久设备命名¶
动态设备目录和 udev 规则基础结构可以为所有磁盘设备提供固定名称,而不考虑它们的识别顺序或设备使用的连接。内核创建的每个相应的块设备由工具根据有关特定总线、驱动器类型或者文件系统的特殊知识进行检查。除了动态内核提供的设备节点名,udev 还维护各种指向该设备的永久符号链接:
/dev/disk
|-- by-id
| |-- scsi-SATA_HTS726060M9AT00_MRH453M4HWHG7B -> ../../sda
| |-- scsi-SATA_HTS726060M9AT00_MRH453M4HWHG7B-part1 -> ../../sda1
| |-- scsi-SATA_HTS726060M9AT00_MRH453M4HWHG7B-part6 -> ../../sda6
| |-- scsi-SATA_HTS726060M9AT00_MRH453M4HWHG7B-part7 -> ../../sda7
| |-- usb-Generic_STORAGE_DEVICE_02773 -> ../../sdd
| `-- usb-Generic_STORAGE_DEVICE_02773-part1 -> ../../sdd1
|-- by-label
| |-- Photos -> ../../sdd1
| |-- SUSE10 -> ../../sda7
| `-- devel -> ../../sda6
|-- by-path
| |-- pci-0000:00:1f.2-scsi-0:0:0:0 -> ../../sda
| |-- pci-0000:00:1f.2-scsi-0:0:0:0-part1 -> ../../sda1
| |-- pci-0000:00:1f.2-scsi-0:0:0:0-part6 -> ../../sda6
| |-- pci-0000:00:1f.2-scsi-0:0:0:0-part7 -> ../../sda7
| |-- pci-0000:00:1f.2-scsi-1:0:0:0 -> ../../sr0
| |-- usb-02773:0:0:2 -> ../../sdd
| |-- usb-02773:0:0:2-part1 -> ../../sdd1
`-- by-uuid
|-- 159a47a4-e6e6-40be-a757-a629991479ae -> ../../sda7
|-- 3e999973-00c9-4917-9442-b7633bd95b9e -> ../../sda6
`-- 4210-8F8C -> ../../sdd1
12.8. udev 使用的文件¶
/sys/*-
Linux 内核提供的虚拟文件系统,用于导出所有当前已知设备。此信息由
udev用于在/dev中创建设备节点
/dev/*-
动态创建的设备节点和引导时从
/lib/udev/devices/*复制的静态内容
以下文件和目录包含 udev 基础结构的关键元素:
/etc/udev/udev.conf-
主
udev配置文件。 /etc/udev/rules.d/*-
udev 事件匹配规则. /lib/udev/devices/*-
静态
/dev内容。 /lib/udev/*-
从
udev规则调用的帮助程序。
12.9. 更多信息¶
有关 udev 基础结构的更多信息,请参见以下手册页:
udev-
有关
udev、关键字、规则和其他重要配置问题的常规信息。 - udevadm
-
udevadm 可用于控制
udev的运行时行为、请求内核事件、管理事件队列,以及提供简单的调试机制。 udevd-
有关
udev事件管理守护程序的信息。
浙公网安备 33010602011771号