udev
udev 是一个用户空间的设备管理器,用于为事件设置处理程序。作为守护进程, udev 接收的事件主要由 linux 内核生成,这些事件是外部设备产生的物理事件。总之, udev 探测外设和热插拔,将设备控制权传递给内核,例如加载内核模块或设备固件。
udev 是一个用户空间系统,可以让操作系统管理员为事件注册用户空间处理器。为了实现外设侦测和热插拔,udev 守护进程接收 Linux 内核发出的外设相关事件; 加载内核模块、设备固件; 调整设备权限,让普通用户和用户组能够访问设备。
作为 devfsd 和 hotplug 的替代品, udev 还负责管理 /dev
中的设备节点,即添加、链接和重命名节点,取代了 hotplug 和 hwdetect。
udev 并行处理事件,具有潜在的性能优势,但是无法保证每次加载模块的顺序,例如如果有两个硬盘, /dev/sda
在下次启动后可能变成 /dev/sdb
。本文后面有更详细的信息。
安装[编辑 | 编辑源代码]
Udev 现在是 systemd包 的组成部分,默认已安装。有关信息请查阅 systemd-udevd.service(8)
的手册页。
udev 规则[编辑 | 编辑源代码]
udev 规则以管理员身份编写并保存在 /etc/udev/rules.d/
目录,其文件名必须以 .rules
结尾。各种软件包提供的规则文件位于 /lib/udev/rules.d/
。如果 /usr/lib
和 /etc
这两个目录中有同名文件,则 /etc
中的文件优先。
要学习 udev 规则,请参考 udev(7) 手册和编写 udev 规则及其提供的一些实用案例。
编写 udev 规则[编辑 | 编辑源代码]
mount
命令的方法。对 FUSE 文件系统将会导致 Transport endpoint not connected
错误。应代之以 udisks 以正确处理自动挂载。或者把挂载动作放在 udev 规则内部:
将 /usr/lib/systemd/system/systemd-udevd.service
复制到 /etc/systemd/system/systemd-udevd.service
,将 MountFlags=slave
替换为 MountFlags=shared
。(来源)
- 要想学习写udev规则,请访问编写 udev 规则。
- 要想查看 udev 规则的例子,请查阅上述文章的范例章节。
下面是一个规则的实例,当接入摄像头时创建符号链接 /dev/video-cam1
。
假设摄像头已经连接,加载的设备为 /dev/video2
。编写此规则的原因是下次引导时这个设备名可能变化,比如变成 /dev/video0
。
$ udevadm info --attribute-walk --path=$(udevadm info --query=path --name=/dev/video2)
Udevadm info starts with the device specified by the devpath and then walks up the chain of parent devices. It prints for every device found, all possible attributes in the udev rules key format. A rule to match, can be composed by the attributes of the device and the attributes from one single parent device. looking at device '/devices/pci0000:00/0000:00:04.1/usb3/3-2/3-2:1.0/video4linux/video2': KERNEL=="video2" SUBSYSTEM=="video4linux" ... looking at parent device '/devices/pci0000:00/0000:00:04.1/usb3/3-2/3-2:1.0': KERNELS=="3-2:1.0" SUBSYSTEMS=="usb" ... looking at parent device '/devices/pci0000:00/0000:00:04.1/usb3/3-2': KERNELS=="3-2" SUBSYSTEMS=="usb" ATTRS{idVendor}=="05a9" ATTRS{manufacturer}=="OmniVision Technologies, Inc." ATTRS{removable}=="unknown" ATTRS{idProduct}=="4519" ATTRS{bDeviceClass}=="00" ATTRS{product}=="USB Camera" ...
为了确认 webcamera 设备,我们使用 KERNEL=="video2"
和 SUBSYSTEM=="video4linux"
,向上两极到 SUBSYSTEMS=="usb"
,使用厂商和产品 ID 进行定位: ATTRS{idVendor}=="05a9"
和 ATTRS{idProduct}=="4519"
。
可以为此设备编写规则:
/etc/udev/rules.d/83-webcam.rules
KERNEL=="video[0-9]*", SUBSYSTEM=="video4linux", SUBSYSTEMS=="usb", ATTRS{idVendor}=="05a9", ATTRS{idProduct}=="4519", SYMLINK+="video-cam"
这里使用 SYMLINK+="video-cam"
创建了软链接,这样可以设置用户 OWNER="john"
或用户组 GROUP="video"
或者通过 MODE="0660"
设置权限。
如果要编写设备移除时执行的脚本,请注意此时可能无法访问设备属性。需要使用提前设置的环境变量。要监控这些环境变量,在拔掉设备时执行如下命令:
$ udevadm monitor --property --udev
在命令输出中可以看到类似 ID_VENDOR_ID
和 ID_MODEL_ID
这样的值,它们对应 idVendor
和 idProduct
属性。下面是一个使用设备环境变量的规则示例:
/etc/udev/rules.d/83-webcam-removed.rules
ACTION=="remove", SUBSYSTEM=="usb", ENV{ID_VENDOR_ID}=="05a9", ENV{ID_MODEL_ID}=="4519", RUN+="/path/to/your/script"
列出设备属性[编辑 | 编辑源代码]
要列出所有设备的属性以用来编写规则的话,运行下面的命令:
$ udevadm info --attribute-walk --name=device_name
将 device name
替换为系统中存在的设备,比如 /dev/sda
或 /dev/ttyUSB0
。
如果你不知道设备名,你也可以列出某个系统路径的属性:
$ udevadm info --attribute-walk --path=/sys/class/backlight/acpi_video0
可以通过类型过滤掉不需要的输出:
$ ls /dev/class/by-id
可以在 --name
中使用最终文件或软连接:
$ udevadm info --attribute-walk --name=/dev/input/by-id/usb-foostan_Corne-event-kbd
要获得裸 USB 设备(未创建任何子设备) 的信息,需要使用完整的 USB 设备路径, 先启动监控模式,然后插入 USB 设备:
$ udevadm monitor
... KERNEL[26652.638931] add /devices/pci0000:00/0000:00:01.2/0000:02:00.0/0000:03:05.0/0000:05:00.0/usb1/1-3 (usb) KERNEL[26652.639153] add /devices/pci0000:00/0000:00:01.2/0000:02:00.0/0000:03:05.0/0000:05:00.0/usb1/1-3/1-3:1.0 (usb) ...
可以使用最深的路径, --attribute-walk
会显示全部父属性:
$ udevadm info --attribute-walk --path=/devices/pci0000:00/0000:00:01.2/0000:02:00.0/0000:03:05.0/0000:05:00.0/usb1/1-3/1-3:1.0
加载前测试规则[编辑 | 编辑源代码]
# udevadm test $(udevadm info --query=path --name=device_name) 2>&1
这不会运行你的规则中的所有命令,但会处理已有设备的符号连接,如果你不能加载它们这也许会变得方便。也可以直接输入你测试的设备路径:
# udevadm test /sys/class/backlight/acpi_video0/
加载新规则[编辑 | 编辑源代码]
Udev 自动侦测规则文件的变化,所以修改会立即生效,无需重启 udev。但已接入设备的规则不会自动触发。像 USB 这类热插拔设备也许需要重新插拔才能使新规则生效,也可能需要卸载并重载内核的 ohci-hcd 和 ehci-hcd 模块以重新挂载所有 USB 设备。
如果规则自动重载失败
# udevadm control --reload
可以手工强制触发规则
# udevadm trigger
Udisks[编辑 | 编辑源代码]
参阅 Udisks.
提示与技巧[编辑 | 编辑源代码]
Mounting drives in rules[编辑 | 编辑源代码]
To mount removable drives, do not call mount
from udev rules. This is ill-advised for two reasons:
- systemd by default runs
systemd-udevd.service
with a separate "mount namespace" (see namespaces(7)), which means that mounts will not be visible to the rest of the system. - Even if you change the service parameters to fix this (commenting out the
PrivateMounts
andMountFlags
lines), there is another problem which is that processes started from Udev are killed after a few seconds. In case of FUSE filesystems, such as NTFS-3G, mount starts a user-space process to handle the filesystem internals; when this is killed you will getTransport endpoint not connected
errors if you try to access the filesystem.
There are some options that work:
- Start a custom systemd service from the Udev rule; the systemd service can invoke a script which can start any number of long-running processes (like FUSE). A concise example which automatically mounts USB disks under
/media
is udev-media-automount. A variant of the same idea is explained in this blog post. - Use
systemd-mount
instead ofmount
in your Udev rule. This is recommended by systemd developers. For example this Udev rule should mount USB disks under/media
:
ACTION=="add", SUBSYSTEMS=="usb", SUBSYSTEM=="block", ENV{ID_FS_USAGE}=="filesystem", RUN{program}+="/usr/bin/systemd-mount --no-block --automount=yes --collect $devnode /media"
- Use a package like udisks or udiskie. These are very powerful, but difficult to set up. Also, they are meant to be used in single user sessions, since they make some filesystems available under the ownership of the unprivileged user whose session is currently active.
Allowing regular users to use devices[编辑 | 编辑源代码]
When a kernel driver initializes a device, the default state of the device node is to be owned by root:root
, with permissions 600
. [1] This makes devices inaccessible to regular users unless the driver changes the default, or a udev rule in userspace changes the permissions.
The OWNER
, GROUP
, and MODE
udev values can be used to provide access, though one encounters the issue of how to make a device usable to all users without an overly permissive mode. Ubuntu's approach is to create a plugdev
group that devices are added to, but this practice is not only discouraged by the systemd developers, [2] but considered a bug when shipped in udev rules on Arch (FS#35602). Another approach historically employed, as described in Users and groups#Pre-systemd groups, is to have different groups corresponding to categories of devices.
The modern recommended approach for systemd systems is to use a MODE
of 660
to let the group use the device, and then attach a TAG
named uaccess
[3]. This special tag makes udev apply a dynamic user ACL to the device node, which coordinates with systemd-logind(8) to make the device usable to logged-in users. For an example of a udev rule implementing this:
/etc/udev/rules.d/71-device-name.rules
SUBSYSTEMS=="usb", ATTRS{idVendor}=="vendor_id", ATTRS{idProduct}=="product_id", MODE="0660", TAG+="uaccess"
Execute when HDMI cable is plugged in or unplugged[编辑 | 编辑源代码]
Create the rule /etc/udev/rules.d/95-hdmi-plug.rules
with the following content:
ACTION=="change", SUBSYSTEM=="drm", ENV{DISPLAY}=":0", ENV{XAUTHORITY}="/home/username/.Xauthority", RUN+="/path/to/script.sh"
VGA 线缆接入时执行规则[编辑 | 编辑源代码]
创建包含下列内容的规则文件 /etc/udev/rules.d/95-monitor-hotplug.rules
,可以在 VGA 线缆插入时执行 arandr包:
KERNEL=="card0", SUBSYSTEM=="drm", ENV{DISPLAY}=":0", ENV{XAUTHORITY}="/home/username/.Xauthority", RUN+="/usr/bin/arandr"
$ printenv XAUTHORITY
/run/user/1000/gdm/Xauthority
侦测新的 eSATA 设备[编辑 | 编辑源代码]
If your eSATA drive is not detected when you plug it in, there are a few things you can try. You can reboot with the eSATA plugged in. Or you could try
# echo 0 0 0 > /sys/class/scsi_host/host*/scan
Or you could install scsiaddAUR (from the AUR) and try
# scsiadd -s
Hopefully, your drive is now in /dev
. If it is not, you could try the above commands while running
# udevadm monitor
to see if anything is actually happening.
将内置 SATA 接口标记为 eSATA[编辑 | 编辑源代码]
If you connected a eSATA bay or an other eSATA adapter the system will still recognize this disk as an internal SATA drive. GNOME and KDE will ask you for your root password all the time. The following rule will mark the specified SATA-Port as an external eSATA-Port. With that, a normal GNOME user can connect their eSATA drives to that port like a USB drive, without any root password and so on.
/etc/udev/rules.d/10-esata.rules
DEVPATH=="/devices/pci0000:00/0000:00:1f.2/host4/*", ENV{UDISKS_SYSTEM}="0"
DEVPATH
can be found after connection the eSATA drive with the following commands (replace sdb
accordingly):
# udevadm info -q path -n /dev/sdb /devices/pci0000:00/0000:00:1f.2/host4/target4:0:0/4:0:0:0/block/sdb
# find /sys/devices/ -name sdb /sys/devices/pci0000:00/0000:00:1f.2/host4/target4:0:0/4:0:0:0/block/sdb
设置静态设备名[编辑 | 编辑源代码]
由于 udev 异步加载所有模块,使得它们被初始化的次序不同。这将导致设备会随机改变名称。可以添加一条 udev 规则使得设备使用静态名称。
对于块设备和网络设备的规则配置,请分别参阅块设备持久化命名和网络配置-设备命名。
视频设备[编辑 | 编辑源代码]
For setting up the webcam in the first place, refer to 网络摄像机配置.
Using multiple webcams will assign video devices as /dev/video*
randomly on boot. The recommended solution is to create symlinks using a udev rule as in the #udev rule example:
/etc/udev/rules.d/83-webcam.rules
KERNEL=="video[0-9]*", SUBSYSTEM=="video4linux", SUBSYSTEMS=="usb", ATTRS{idVendor}=="05a9", ATTRS{idProduct}=="4519", SYMLINK+="video-cam1" KERNEL=="video[0-9]*", SUBSYSTEM=="video4linux", SUBSYSTEMS=="usb", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="08f6", SYMLINK+="video-cam2"
/dev/video*
will break preloading of v4l1compat.so
and perhaps v4l2convert.so
打印机[编辑 | 编辑源代码]
If you use multiple printers, /dev/lp[0-9]
devices will be assigned randomly on boot, which will break e.g. CUPS configuration.
You can create following rule, which will create symlinks under /dev/lp/by-id
and /dev/lp/by-path
, similar to Persistent block device naming scheme:
/etc/udev/rules.d/60-persistent-printer.rules
ACTION=="remove", GOTO="persistent_printer_end" # This should not be necessary #KERNEL!="lp*", GOTO="persistent_printer_end" SUBSYSTEMS=="usb", IMPORT{builtin}="usb_id" ENV{ID_TYPE}!="printer", GOTO="persistent_printer_end" ENV{ID_SERIAL}=="?*", SYMLINK+="lp/by-id/$env{ID_BUS}-$env{ID_SERIAL}" IMPORT{builtin}="path_id" ENV{ID_PATH}=="?*", SYMLINK+="lp/by-path/$env{ID_PATH}" LABEL="persistent_printer_end"
Identifying a disk by its serial[编辑 | 编辑源代码]
To perform some action on a specific disk device /dev/sdX
identified permanently by its unique serial ID_SERIAL_SHORT
as displayed with udevadm info /dev/sdX
, one can use the below rule. It is passing as a parameter the device name found if any to illustrate:
/etc/udev/rules.d/69-disk.rules
ACTION=="add", KERNEL=="sd[a-z]", ENV{ID_SERIAL_SHORT}=="X5ER1ALX", RUN+="/path/to/script /dev/%k"
唤醒挂起的 USB 设备[编辑 | 编辑源代码]
A udev rule can be useful to enable the wakeup triggers of a USB device, like a mouse or a keyboard, so that it can be used to wake the system from sleep.
cat /proc/acpi/wakeup
. The rule below is in this case not necessary but can be used as a template to perform other actions, like disabling the wakeup functionality for example.
First, identify the vendor and product identifiers of the USB device. They will be used to recognize it in the udev rule. For example:
$ lsusb | grep Logitech
Bus 007 Device 002: ID 046d:c52b Logitech, Inc. Unifying Receiver
Then, find where the device is connected to using:
$ grep c52b /sys/bus/usb/devices/*/idProduct
/sys/bus/usb/devices/1-1.1.1.4/idProduct:c52b
Now create the rule to change the power/wakeup
attribute of both the device and the USB controller it is connected to whenever it is added:
/etc/udev/rules.d/50-wake-on-device.rules
ACTION=="add", SUBSYSTEM=="usb", DRIVERS=="usb", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c52b", ATTR{power/wakeup}="enabled", ATTR{driver/1-1.1.1.4/power/wakeup}="enabled"
触发事件[编辑 | 编辑源代码]
It can be useful to trigger various udev events. For example, you might want to simulate a USB device disconnect on a remote machine. In such cases, use udevadm trigger
:
# udevadm trigger --verbose --type=subsystems --action=remove --subsystem-match=usb --attr-match="idVendor=abcd"
This command will trigger a USB remove event on all USB devices with vendor ID abcd
.
Triggering desktop notifications from a udev rule[编辑 | 编辑源代码]
Invoking an external script containing calls to notify-send
via udev can sometimes be challenging since the notification(s) never display on the Desktop. Here is an example of what commands and environmental variables need to be included in which files for notify-send
to successfully be executed from a udev rule.
1) The following udev rule executes a script that plays a notification sound and sends a desktop notification when screen brightness is changed according to power state on a laptop. Create the file:
/etc/udev/rules.d/99-backlight_notification.rules
# Rule for when switching to battery ACTION=="change", SUBSYSTEM=="power_supply", ATTR{type}=="Mains", ATTR{online}=="0", ENV{DISPLAY}=":0", ENV{XAUTHORITY}="/home/USERNAME/.Xauthority" RUN+="/usr/bin/su USERNAME_TO_RUN_SCRIPT_AS -c /usr/local/bin/brightness_notification.sh" # Rule for when switching to AC ACTION=="change", SUBSYSTEM=="power_supply", ATTR{type}=="Mains", ATTR{online}=="1", ENV{DISPLAY}=":0", ENV{XAUTHORITY}="/home/USERNAME/.Xauthority" RUN+="/usr/bin/su USERNAME_TO_RUN_SCRIPT_AS -c /usr/local/bin/brightness_notification.sh"
USERNAME_TO_RUN_SCRIPT_AS
andUSERNAME
need to be changed to that of the shortname for the user of the graphical session where the notification will be displayed;- the script needs to be executed with
/usr/bin/su
, which will place its ownership under the user of the graphical session (rather than root/the system) where the notification will be displayed.
2) Contents of the executable script to be run on trigger of the udev rule:
/usr/local/bin/brightness_notification.sh
#!/bin/sh export XAUTHORITY=/home/USERNAME_TO_RUN_SCRIPT_AS/.Xauthority export DISPLAY=:0 export DBUS_SESSION_BUS_ADDRESS="unix:path=/run/user/UID_OF_USER_TO_RUN_SCRIPT_AS/bus" /usr/bin/sudo -u USERNAME_TO_RUN_SCRIPT_AS /usr/bin/paplay --server=/run/user/UID_OF_USER_TO_RUN_SCRIPT_AS/pulse/native /home/USERNAME/.i3/sounds/Click1.wav > /dev/null 2>&1 /usr/bin/notify-send --icon=/usr/share/icons/gnome/256x256/status/battery-full-charging.png 'Changing Power States' --expire-time=4000
USERNAME_TO_RUN_SCRIPT_AS
,UID_OF_USER_TO_RUN_SCRIPT_AS
andUSERNAME
needs to be changed to that of the shortname for the user and user's UID of the graphical session where the notification will be displayed;/usr/bin/sudo
is needed when playing audio via pulseaudio;- three environmental variables (i.e.,
XAUTHORITY
,DISPLAY
andDBUS_SESSION_BUS_ADDRESS
) for the user of the graphical session where the notification will be displayed need to be defined and exported.
IMPORT
key.
3) Load/reload the new udev rule (see above) and test it by unplugging the power supply to the laptop.
排错[编辑 | 编辑源代码]
屏蔽模块[编辑 | 编辑源代码]
极个别情况下,udev 也会犯错或加载错误的模块。为了防止错误的发生,你可以使用模块禁用列表。只要模块加入该列表,无论是启动时,或者是运行时(如usb硬盘等)udev都不会加载这些模块。参见blacklisting.
Debug output[编辑 | 编辑源代码]
To get hardware debug info, use the 内核参数 udev.log-priority=debug
. Alternatively you can set
/etc/udev/udev.conf
udev_log="debug"
This option can also be compiled into your initramfs by adding the config file to your FILES
array
/etc/mkinitcpio.conf
FILES="... /etc/udev/udev.conf"
and then rebuilding the initramfs with
# mkinitcpio -p linux
udevd 引导时挂起[编辑 | 编辑源代码]
After migrating to LDAP or updating an LDAP-backed system udevd can hang at boot at the message "Starting UDev Daemon". This is usually caused by udevd trying to look up a name from LDAP but failing, because the network is not up yet. The solution is to ensure that all system group names are present locally.
Extract the group names referenced in udev rules and the group names actually present on the system:
# grep -Fr GROUP /etc/udev/rules.d/ /usr/lib/udev/rules.d/ | sed 's:.*GROUP="\([-a-z_]\{1,\}\)".*:\1:' | sort -u >udev_groups # cut -d: -f1 /etc/gshadow /etc/group | sort -u >present_groups
To see the differences, do a side-by-side diff:
# diff -y present_groups udev_groups ... network < nobody < ntp < optical optical power | pcscd rfkill < root root scanner scanner smmsp < storage storage ...
In this case, the pcscd
group is for some reason not present in the system. Add the missing groups. Also, make sure that local resources are looked up before resorting to LDAP. /etc/nsswitch.conf
should contain the following line:
group: files ldap
一些移动设备不可移除[编辑 | 编辑源代码]
You need to create a custom udev rule for that particular device. To get definitive information of the device you can use either ID_SERIAL
or ID_SERIAL_SHORT
(remember to change /dev/sdb
if needed):
$ udevadm info /dev/sdb | grep ID_SERIAL
Then we set UDISKS_AUTO="1"
to mark the device for automounting and UDISKS_SYSTEM="0"
to mark the device as "removable". See udisks(8) for details.
/etc/udev/rules.d/99-removable.rules
ENV{ID_SERIAL_SHORT}=="serial_number", ENV{UDISKS_AUTO}="1", ENV{UDISKS_SYSTEM}="0"
Remember to reload udev rules with udevadm control --reload
. Next time you plug your device in, it will be treated as an external drive.
声音问题和一些不能自动加载的模块[编辑 | 编辑源代码]
一些用户发现 /etc/modprobe.d/sound.conf
中的遗留配置会引起这些问题,请清理配置并重试。
udev>=171
开始 OSS 模拟模块(snd_seq_oss, snd_pcm_oss, snd_mixer_oss
) 默认不会自动装载。IDE CD/DVD 驱动器的支持[编辑 | 编辑源代码]
Starting with version 170, udev does not support CD-ROM/DVD-ROM drives that are loaded as traditional IDE drives with the ide_cd_mod
module and show up as /dev/hd*
. The drive remains usable for tools which access the hardware directly, like cdparanoia, but is invisible for higher userspace programs, like KDE.
A cause for the loading of the ide_cd_mod module prior to others, like sr_mod, could be e.g. that you have for some reason the module piix loaded with your initramfs. In that case you can just replace it with ata_piix in your /etc/mkinitcpio.conf
.
光驱被标识为磁盘[编辑 | 编辑源代码]
If the group ID of your optical drive is set to disk
and you want to have it set to optical
, you have to create a custom udev rule:
/etc/udev/rules.d
# permissions for IDE CD devices SUBSYSTEMS=="ide", KERNEL=="hd[a-z]", ATTR{removable}=="1", ATTRS{media}=="cdrom*", GROUP="optical" # permissions for SCSI CD devices SUBSYSTEMS=="scsi", KERNEL=="s[rg][0-9]*", ATTRS{type}=="5", GROUP="optical"
X programs in RUN rules hang when no X server is present[编辑 | 编辑源代码]
When xrandr or another X-based program tries to connect to an X server, it falls back to a TCP connection on failure. However, due to IPAddressDeny
in the systemd-udev service configuration, this hangs. Eventually the program will be killed and event processing will resume.
If the rule is for a drm device and the hang causes event processing to complete once the X server has started, this can cause 3D acceleration to stop working with a failed to authenticate magic
error.