NEWS revision e7f32890335886cfa0f2f835413aed5af8ac2b53
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerFix for ID_PART_ENTRY_* property names, added by the blkid built-in. The
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerfix is needed for udisk2 to operate properly.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerFix for skipped rule execution when the kernel has removed the device
0fe15dc8ddddeb39a5cad1f4f4afa25fa074a5d1Evgeny Vereshchaginnode in /dev again, before the event was even started. The fix is needed
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald Hoyerto run device-mapper/LVM events properly.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerFix for the man page installation, which was skipped when xsltproc was not
3486cb6cfa3d32a95c0daf02c7510fdf372507bfMartin PittBugfix for $name resolution, which broke at least some keymap handling.
c6a77179a4097df355f0f04b8f3260c76b5e515cRonny ChevalierBugfix for the firmware loading behavior with kernel modules which
c6a77179a4097df355f0f04b8f3260c76b5e515cRonny Chevaliertry to load firmware in the module_init() path. The blocked event
c6a77179a4097df355f0f04b8f3260c76b5e515cRonny Chevalierruns into a timout now, which should allow the firmware to be loaded.
c6a77179a4097df355f0f04b8f3260c76b5e515cRonny ChevalierBugfix for a wrong DEVNAME= export, which breaks at least the udev-acl
c6a77179a4097df355f0f04b8f3260c76b5e515cRonny ChevalierBugfix for missing ID_ properties for GPT partitions.
c6a77179a4097df355f0f04b8f3260c76b5e515cRonny ChevalierThe RUN+="socket:.." option is deprecated and should not be used. A warning
c6a77179a4097df355f0f04b8f3260c76b5e515cRonny Chevalierduring rules parsing is printed now. Services which listen to udev events,
c6a77179a4097df355f0f04b8f3260c76b5e515cRonny Chevalierneed to subscribe to the netlink messages with libudev and not let udev block
c6a77179a4097df355f0f04b8f3260c76b5e515cRonny Chevalierin the rules execution until the message is delivered.
c6a77179a4097df355f0f04b8f3260c76b5e515cRonny ChevalierBugfix for rule_generator instalation.
c6a77179a4097df355f0f04b8f3260c76b5e515cRonny ChevalierThe 'devtmpfs' filesystem is required now, udev will not create or delete
c6a77179a4097df355f0f04b8f3260c76b5e515cRonny Chevalierdevice nodes anymore, it only adjusts permissions and ownership of device
c6a77179a4097df355f0f04b8f3260c76b5e515cRonny Chevaliernodes and maintains additional symlinks.
c6a77179a4097df355f0f04b8f3260c76b5e515cRonny ChevalierA writable /run directory (ususally tmpfs) is required now for a fully
c6a77179a4097df355f0f04b8f3260c76b5e515cRonny Chevalierfunctional udev, there is no longer a fallback to /dev/.udev.
b6f0c419e38a960873fe68bf8f89bbb0268eed02Harald HoyerThe default 'configure' install locations have changed. Packages for systems
b6f0c419e38a960873fe68bf8f89bbb0268eed02Harald Hoyerwith the historic / vs. /usr split need to be adapted, otherwise udev will
b6f0c419e38a960873fe68bf8f89bbb0268eed02Harald Hoyerbe installed in /usr and not work properly. Example configuration options
b6f0c419e38a960873fe68bf8f89bbb0268eed02Harald Hoyerto install things the traditional way are in INSTALL.
b6f0c419e38a960873fe68bf8f89bbb0268eed02Harald HoyerThe default install location of the 'udevadm' tool moved from 'sbin'
b6f0c419e38a960873fe68bf8f89bbb0268eed02Harald Hoyerto /usr/bin. Some tools expect udevadm in 'sbin', a symlink to udevadm
b6f0c419e38a960873fe68bf8f89bbb0268eed02Harald Hoyerneeds to be manually created if needed, or --bindir=/sbin be specified.
c6a77179a4097df355f0f04b8f3260c76b5e515cRonny ChevalierThe expected value of '--libexecdir=' has changed and must no longer contain
c6a77179a4097df355f0f04b8f3260c76b5e515cRonny Chevalierthe 'udev' directory.
c6a77179a4097df355f0f04b8f3260c76b5e515cRonny ChevalierKernel modules are now loaded directly by linking udev to 'libkmod'. The
c6a77179a4097df355f0f04b8f3260c76b5e515cRonny Chevalier'modprobe' tool is no longer executed by udev.
c6a77179a4097df355f0f04b8f3260c76b5e515cRonny ChevalierThe 'blkid' tool is no longer executed from udev rules. Udev links
c6a77179a4097df355f0f04b8f3260c76b5e515cRonny Chevalierdirectly to libblkid now.
3486cb6cfa3d32a95c0daf02c7510fdf372507bfMartin PittFirmware is loaded natively by udev now, the external 'firmware' binary
c6a77179a4097df355f0f04b8f3260c76b5e515cRonny Chevalieris no longer used.
c6a77179a4097df355f0f04b8f3260c76b5e515cRonny ChevalierAll built-in tools can be listed and tested with 'udevadm test-builtin'.
c6a77179a4097df355f0f04b8f3260c76b5e515cRonny ChevalierThe 'udevadm control --reload-rules' option has been renamed to '--reload'.
c6a77179a4097df355f0f04b8f3260c76b5e515cRonny ChevalierIt now also reloads the kernel module configuration.
c6a77179a4097df355f0f04b8f3260c76b5e515cRonny ChevalierThe systemd socket files use PassCredentials=yes, which is available in
c6a77179a4097df355f0f04b8f3260c76b5e515cRonny Chevaliersystemd version 38.
c6a77179a4097df355f0f04b8f3260c76b5e515cRonny ChevalierThe udev build system only creates a .xz tarball now.
c6a77179a4097df355f0f04b8f3260c76b5e515cRonny ChevalierAll tabs in the source code used for indentation are replaced by spaces now. :)
889a90422dd47284dffa32b9234a6e58991b000cRonny ChevalierThe udev daemon moved to /lib/udev/udevd. Non-systemd init systems
8a8332f77e61d41f3bb28b8f929ed41e0ffaf721Zbigniew Jędrzejewski-Szmekand non-dracut initramfs image generators need to change the init
3486cb6cfa3d32a95c0daf02c7510fdf372507bfMartin Pittscripts. Alternatively the udev build needs to move udevd back to
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevalier/sbin or create a symlink in /sbin, which is not done by default.
889a90422dd47284dffa32b9234a6e58991b000cRonny ChevalierThe path_id, usb_id, input_id tools are built-in commands now and
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevalierthe stand-alone tools do not exist anymore. Static lists of file in
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevalierinitramfs generators need to be updated. For testing, the commands
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevaliercan still be executed standalone with 'udevadm test-builtin <cmd>'.
889a90422dd47284dffa32b9234a6e58991b000cRonny ChevalierThe fusectl filesystem is no longer mounted directly from udev.
889a90422dd47284dffa32b9234a6e58991b000cRonny ChevalierSystemd systems will take care of mounting fusectl and configfs
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevaliernow. Non-systemd systems need to ship their own rule if they
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevalierneed these filesystems auto-mounted.
889a90422dd47284dffa32b9234a6e58991b000cRonny ChevalierThe long deprecated keys: SYSFS=, ID=, BUS= have been removed.
889a90422dd47284dffa32b9234a6e58991b000cRonny ChevalierThe support for 'udevadm trigger --type=failed, and the
889a90422dd47284dffa32b9234a6e58991b000cRonny ChevalierRUN{fail_event_on_error} attribute was removed.
889a90422dd47284dffa32b9234a6e58991b000cRonny ChevalierThe udev control socket is now created in /run/udev/control
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevalierand no longer as an abstract namespace one.
889a90422dd47284dffa32b9234a6e58991b000cRonny ChevalierThe rules to create persistent network interface and cdrom link
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevalierrules automatically in /etc/udev/rules.d/ have been disabled by
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevalierdefault. Explicit configuration will be required for these use
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevaliercases, udev will no longer try to write any persistent system
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevalierconfiguration from a device hotplug path.
889a90422dd47284dffa32b9234a6e58991b000cRonny ChevalierThe udev-acl extra is no longer enabled by default now. To enable it,
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevalier--enable-udev_acl needs to be given at ./configure time. On systemd
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevaliersystems, the udev-acl rules prevent it from running as the functionality
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevalierhas moved to systemd.
2375607039517c88df51ef16ddbb624ec1c10654Kay SieversUdev now enables kernel media-presence polling if available. Part
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevalierof udisks optical drive tray-handling moved to cdrom_id: The tray
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevalieris locked as soon as a media is detected to enable the receiving
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevalierof media-eject-request events. Media-eject-request events will
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevaliereject the media.
889a90422dd47284dffa32b9234a6e58991b000cRonny ChevalierLibudev enumerate is now able to enumerate a subtree of a given
889a90422dd47284dffa32b9234a6e58991b000cRonny ChevalierThe mobile-action-modeswitch modeswitch tool was deleted. The
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevalierfunctionality is provided by usb_modeswitch now.
b8667ee4162cd2510363602b417cecede9fd2ccaZbigniew Jędrzejewski-SzmekThe systemd service files require systemd version 28. The systemd
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevaliersocket activation make it possible now to start 'udevd' and 'udevadm
739d81ddd005fae2bb82edce5b8a6173c7c48b34Zbigniew Jędrzejewski-Szmektrigger' in parallel.
889a90422dd47284dffa32b9234a6e58991b000cRonny ChevalierFix bug in control message handling, which can lead to a failing
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevalierudevadm control --exit. Thanks to Jürg Billeter for help tracking
889a90422dd47284dffa32b9234a6e58991b000cRonny ChevalierWe require at least Linux kernel 2.6.32 now. Some platforms might
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevalierrequire a later kernel that supports accept4() and similar, or
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevalierneed to backport the trivial syscall wiring to the older kernels.
889a90422dd47284dffa32b9234a6e58991b000cRonny ChevalierThe hid2hci tool moved to the bluez package and was removed.
889a90422dd47284dffa32b9234a6e58991b000cRonny ChevalierMany of the extras can be --enable/--disabled at ./configure
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevaliertime. The --disable-extras option was removed. Some extras have
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevalierbeen disabled by default. The current options and their defaults
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevaliercan be checked with './configure --help'.
889a90422dd47284dffa32b9234a6e58991b000cRonny ChevalierUdev logs a warning now if /run is not writable at udevd
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevalierstartup. It will still fall back to /dev/.udev, but this is
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevaliernow considered a bug.
889a90422dd47284dffa32b9234a6e58991b000cRonny ChevalierThe running udev daemon can now cleanly shut down with:
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevalier udevadm control --exit
889a90422dd47284dffa32b9234a6e58991b000cRonny ChevalierUdev in initramfs should clean the state of the udev database
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevalierwith: udevadm info --cleanup-db which will remove all state left
c7eda0133b6bf13a182337cbe8a61bf2faf9b32eEvgeny Vereshchaginbehind from events/rules in initramfs. If initramfs uses
c7eda0133b6bf13a182337cbe8a61bf2faf9b32eEvgeny Vereshchagin--cleanup-db and device-mapper/LVM, the rules in initramfs need
c7eda0133b6bf13a182337cbe8a61bf2faf9b32eEvgeny Vereshchaginto add OPTIONS+="db_persist" for all dm devices. This will
c7eda0133b6bf13a182337cbe8a61bf2faf9b32eEvgeny Vereshchaginprevent removal of the udev database for these devices.
c7eda0133b6bf13a182337cbe8a61bf2faf9b32eEvgeny VereshchaginSpawned programs by PROGRAM/IMPORT/RUN now have a hard timeout of
c7eda0133b6bf13a182337cbe8a61bf2faf9b32eEvgeny Vereshchagin120 seconds per process. If that timeout is reached the spawned
c7eda0133b6bf13a182337cbe8a61bf2faf9b32eEvgeny Vereshchaginprocess will be killed. The event timeout can be overwritten with
c7eda0133b6bf13a182337cbe8a61bf2faf9b32eEvgeny VereshchaginIf systemd is used, udev gets now activated by netlink data.
889a90422dd47284dffa32b9234a6e58991b000cRonny ChevalierSystemd will bind the netlink socket which will buffer all data.
889a90422dd47284dffa32b9234a6e58991b000cRonny ChevalierIf needed, such setup allows a seemless update of the udev daemon,
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevalierwhere no event can be lost during a udevd update/restart.
889a90422dd47284dffa32b9234a6e58991b000cRonny ChevalierPackages need to make sure to: systemctl stop udev.socket udev.service
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevalieror 'mask' udev.service during the upgrade to prevent any unwanted
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevalierauto-spawning of udevd.
889a90422dd47284dffa32b9234a6e58991b000cRonny ChevalierThis version of udev conflicts with systemd version below 25. The
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevalierunchanged service files will not wirk correctly.
889a90422dd47284dffa32b9234a6e58991b000cRonny ChevalierThe udev runtime data moved from /dev/.udev/ to /run/udev/. The
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevalier/run mountpoint is supposed to be a tmpfs mounted during early boot,
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevalieravailable and writable to for all tools at any time during bootup,
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevalierit replaces /var/run/, which should become a symlink some day.
889a90422dd47284dffa32b9234a6e58991b000cRonny ChevalierIf /run does not exist, or is not writable, udev will fall back using
889a90422dd47284dffa32b9234a6e58991b000cRonny ChevalierOn systemd systems with initramfs and LVM used, packagers must
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevaliermake sure, that the systemd and initramfs versions match. The initramfs
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevalierneeds to create the /run mountpoint for udev to store the data, and
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevaliermount this tmpfs to /run in the rootfs, so the that the udev database
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevalieris preserved for the udev version started in the rootfs.
889a90422dd47284dffa32b9234a6e58991b000cRonny ChevalierThe command 'udevadm info --convert-db' is gone. The udev daemon
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevalieritself, at startup, converts any old database version if necessary.
889a90422dd47284dffa32b9234a6e58991b000cRonny ChevalierThe systemd services files have been reorganized. The udev control
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevaliersocket is bound by systemd and passed to the started udev daemon.
889a90422dd47284dffa32b9234a6e58991b000cRonny ChevalierThe udev-settle.service is no longer active by default. Services which
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevaliercan not handle hotplug setups properly need to actively pull it in, to
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevalieract like a barrier. Alternatively the settle service can be unconditionally
bf3a947cb44f31359bba313e0252cbcc0dc95b03Evgeny Vereshchagin'systemctl'enabled, and act like a barrier for basic.target.
889a90422dd47284dffa32b9234a6e58991b000cRonny ChevalierThe fstab_import callout is no longer built or installed. Udev
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevaliershould not be used to mount, does not watch changes to fstab, and
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevaliershould not mirror fstab values in the udev database.
889a90422dd47284dffa32b9234a6e58991b000cRonny ChevalierNew and updated keymaps.
889a90422dd47284dffa32b9234a6e58991b000cRonny ChevalierThe udev database has changed, After installation of a new udev
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevalierversion, 'udevadm info --convert-db' should be called, to let the new
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevalierudev/libudev version read the already stored data.
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevalierudevadm now supports quoting of property values, and prefixing of
7d023341c765c205068e33d23d63a4000ec211dfMartin Pitt $ udevadm info --export --export-prefix=MY_ --query=property -n sda
7d023341c765c205068e33d23d63a4000ec211dfMartin Pitt MY_MAJOR='259'
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevalier MY_DEVTYPE='disk'
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevalierlibudev now supports:
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevalier udev_device_get_is_initialized()
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevalier udev_enumerate_add_match_is_initialized()
cffae62bcb6912fbaf1b7b282d9d170c9d308897Martin Pittto be able to skip devices the kernel has created , but udev has
99877b7e3782a51b31bf191825f0335500f52fe5Harald Hoyernot already handled.
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevalierlibudev now supports:
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevalier udev_device_get_usec_since_initialized()
3486cb6cfa3d32a95c0daf02c7510fdf372507bfMartin Pittto retrieve the "age" of a udev device record.
889a90422dd47284dffa32b9234a6e58991b000cRonny ChevalierGUdev supports a more generic GUdevEnumerator class, udev TAG
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevalierhandling, device initialization and timestamp now.
889a90422dd47284dffa32b9234a6e58991b000cRonny ChevalierThe counterpart of /sys/dev/{char,block}/$major:$minor,
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevalier/dev/{char,block}/$major:$minor symlinks are now unconditionally
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevaliercreated, even when no rule files exist.
889a90422dd47284dffa32b9234a6e58991b000cRonny ChevalierNew and updated keymaps.
889a90422dd47284dffa32b9234a6e58991b000cRonny ChevalierGUdev moved from /usr to /.
889a90422dd47284dffa32b9234a6e58991b000cRonny ChevalierPersistent network naming rules are disabled inside of Qemu/KVM now.
889a90422dd47284dffa32b9234a6e58991b000cRonny ChevalierNew and updated keymaps.
889a90422dd47284dffa32b9234a6e58991b000cRonny ChevalierUdev gets unconditionally enabled on systemd installations now. There
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevalieris no longer the need to to run 'systemctl enable udev.service'.
889a90422dd47284dffa32b9234a6e58991b000cRonny ChevalierNew and fixed keymaps.
889a90422dd47284dffa32b9234a6e58991b000cRonny ChevalierInstall systemd service files if applicable.
889a90422dd47284dffa32b9234a6e58991b000cRonny ChevalierAll distribution specific rules are removed from the udev source tree,
53d90f9582f96208b3674da823ad1a3d2c3b1aa4Martin Pittmost of them are no longer needed. The Gentoo rules which allow to support
5c404f1ab8e96efedb983806443ca982a1b2a372Evgeny Vereshchaginolder kernel versions, which are not covered by the default rules anymore
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevalierhas moved to rules/misc/30-kernel-compat.rules.
889a90422dd47284dffa32b9234a6e58991b000cRonny ChevalierThe option --debug-trace and the environemnt variable UDEVD_MAX_CHILDS=
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevalierwas removed from udevd.
889a90422dd47284dffa32b9234a6e58991b000cRonny ChevalierUdevd now checks the kernel commandline for the following variables:
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevalier udev.log-priority=<syslog priority>
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevalier udev.children-max=<maximum number of workers>
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevalier udev.exec-delay=<seconds to delay the execution of RUN=>
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevalierto help debuging coldplug setups where the loading of a kernel
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevaliermodule crashes the system.
889a90422dd47284dffa32b9234a6e58991b000cRonny ChevalierThe subdirectory in the source tree rules/packages has been renamed to
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald Hoyerrules/arch, anc contains only architecture specific rules now.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerNow the udev daemon itself, does on startup:
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyer - copy the content of /lib/udev/devices to /dev
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyer - create the standard symlinks like /dev/std{in,out,err},
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyer - use static node information provided by kernel modules
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyer and creates these nodes to allow module on-demand loading
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyer - possibly apply permissions to all ststic nodes from udev
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyer rules which are annotated to match a static node
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerThe default mode for a device node is 0600 now to match the kernel
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyercreated devtmpfs defaults. If GROUP= is specified and no MODE= is
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyergiven the default will be 0660.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerUdev now gradually starts to pass control over the primary device nodes
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerand their names to the kernel, and will in the end only manage the
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerpermissions of the node, and possibly create additional symlinks.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerAs a first step NAME="" will be ignored, and NAME= setings with names
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerother than the kernel provided name will result in a logged warning.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerKernels that don't provide device names, or devtmpfs is not used, will
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerstill work as they did before, but it is strongly recommended to use
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyeronly the same names for the primary device node as the recent kernel
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerprovides for all devices.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerFix broken firmware loader search path.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyer"udevadm trigger" defaults to "change" events now instead of "add"
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerevents. The "udev boot script" might need to add "--action=add" to
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerthe trigger command if not already there, in case the initial coldplug
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerevents are expected as "add" events.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerThe option "all_partitons" was removed from udev. This should not be
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerneeded for usual hardware. Udev can not safely make assumptions
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevalierabout non-existing partition major/minor numbers, and therefore no
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevalierlonger provide this unreliable and unsafe option.
889a90422dd47284dffa32b9234a6e58991b000cRonny ChevalierThe option "ignore_remove" was removed from udev. With devtmpfs
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevalierudev passed control over device nodes to the kernel. This option
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyershould not be needed, or can not work as advertised. Neither
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerudev nor the kernel will remove device nodes which are copied from
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerAll "add|change" matches are replaced by "!remove" in the rules and
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerin the udev logic. All types of events will update possible symlinks
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerand permissions, only "remove" is handled special now.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerThe modem modeswitch extra was removed and the external usb_modeswitch
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerprogram should be used instead.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerNew and fixed keymaps.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerKernels with SYSFS_DEPRECATED=y are not supported since a while. Many users
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerdepend on the current sysfs layout and the information not available in the
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerdeprecated layout. All remaining support for the deprecated sysfs layout is
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerFix for a possible endless loop in the new input_id program.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerThe option "ignore_device" does no longer exist. There is no way to
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerignore an event, as libudev events can not be suppressed by rules.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerIt only prevented RUN keys from being executed, which results in an
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerinconsistent behavior in current setups.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerBUS=, SYSFS{}=, ID= are long deprecated and should be SUBSYSTEM(S)=,
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerATTR(S){}=, KERNEL(S)=. It will cause a warning once for every rule
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerfile from now on.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerThe support for the deprecated IDE devices has been removed from the
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerdefault set of rules. Distros who still care about non-libata drivers
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerneed to add the rules to the compat rules file.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerThe ID_CLASS property on input devices has been replaced by the more accurate
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerset of flags ID_INPUT_{KEYBOARD,KEY,MOUSE,TOUCHPAD,TABLET,JOYSTICK}. These are
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerdetermined by the new "input_id" prober now. Some devices, such as touchpads,
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyercan have several classes. So if you previously had custom udev rules which e. g.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerchecked for ENV{ID_CLASS}=="kbd", you need to replace this with
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerENV{ID_INPUT_KEYBOARD}=="?*".
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerTo support DEVPATH strings larger than the maximum file name length, the
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerprivate udev database format has changed. If some software still reads the
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerprivate files in /dev/.udev/, which it shouldn't, now it's time to fix it.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerPlease do not port anything to the new format again, everything in /dev/.udev
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyeris and always was private to udev, and may and will change any time without
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerprior notice.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerMultiple devices claiming the same names in /dev are limited to symlinks
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald Hoyeronly now. Mixing identical symlink names and node names is not supported.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerThis reduces the amount of data in the database significantly.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerNAME="%k" causes a warning now. It's is and always was completely superfluous.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerIt will break kernel supplied DEVNAMEs and therefore it needs to be removed
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerfrom all rules.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerMost NAME= instructions got removed. Kernel 2.6.31 supplies the needed names
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerif they are not the default. To support older kernels, the NAME= rules need to
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerbe added to the compat rules file.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerSymlinks to udevadm with the old command names are no longer resolved to
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerthe udevadm commands.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerThe udev-acl tool got adopted to changes in ConsoleKit. Version 0.4.1 is
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerrequired now.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerThe option "last_rule" does no longer exist. Its use breaks too many
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerthings which expect to be run from independent later rules, and is an idication
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerthat something needs to be fixed properly instead.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerThe gudev API is no longer marked as experimental,
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerG_UDEV_API_IS_SUBJECT_TO_CHANGE is no longer needed. The gudev introspection
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyeris enabled by default now. Various projects already depend on introspection
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerinformation to bind dynamic languages to the gudev interfaces.
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald HoyerThe udevadm trigger "--retry-failed" option, which is replaced since quite
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyera while by "--type=failed" is removed.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerThe failed tracking was not working at all for a few releases. The RUN
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyeroption "ignore_error" is replaced by a "fail_event_on_error" option, and the
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerdefault is not to track any failing RUN executions.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerNew keymaps, new modem, hid2hci updated.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerFix possible crash in udevd when worker processes are busy, rules are
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerchanged at the same time, and workers get killed to reload the rules.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerProperties set with ENV{.FOO}="bar" are marked private by starting the
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyername with a '.'. They will not be stored in the database, and not be
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerexported with the event.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerFirmware files are looked up in:
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerATA devices switched the property from ID_BUS=scsi to ID_BUS=ata.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerata_id, instead of scsi_id, is the default tool now for ATA devices.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerThe configure options have changed because another library needs to be
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerinstalled in a different location. Instead of exec_prefix and udev_prefix,
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerlibdir, rootlibdir and libexecdir are used. The Details are explained in
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerthe README file.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerEvent processes now get re-used after they handled an event. This reduces
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerthe number of forks and the pressure on the CPU significantly, because
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyercloned event processes no longer cause page faults in the main daemon.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerAfter the events have settled, a few worker processes stay around for
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerfuture events, all others get cleaned up.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerTo be able to use signalfd(), udev depends on kernel version 2.6.25 now.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerAlso inotify support is mandatory now to run udev.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerThe format of the queue exported by the udev damon has changed. There is
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerno longer a /dev/.udev/queue/ directory. The current event queue can be
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyeraccessed with udevadm settle and libudedv.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerLibudev does not have the unstable API header anymore. From now on,
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerincompatible changes will be handled by bumping the library major version.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerTo build udev from the git tree gtk-doc is needed now. The tarballs will
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerbuild without it and contain the pre-built documentation. An online copy
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyeris available here:
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyer http://www.kernel.org/pub/linux/utils/kernel/hotplug/libudev/
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerThe tools from the udev-extras repository have been merged into the main
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerudev repository. Some of the extras have larger external dependencies, and
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerthey can be disabled with the configure switch --disable-extras.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerThe program vol_id and the library libvolume_id are removed from the
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerrepository. Libvolume_id is merged with libblkid from the util-linux-ng
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerpackage. Persistent disk links for label and uuid depend on the
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerutil-linux-ng version (2.15) of blkid now. Older versions of blkid
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyercan not be used with udev.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerLibudev allows to subscribe to udev events. To prevent unwanted messages
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerto be delivered, and waking up the subscribing process, a filter can be
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerinstalled, to drop messages inside a kernel socket filter. The filters
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyermatch on the <subsytem>:<devtype> properties of the device.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyer This is part of the ongoing effort to replace HAL, and switch current
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerusers over to directly use libudev.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyer Libudev is still marked as experimental, and its interface might
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyereventually change if needed, but no major changes of the currently exported
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerinterface are expected anymore, and a first stable release should happen
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerA too old kernel (2.6.21) or a kernel with CONFIG_SYSFS_DEPRECATED
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyeris not supported since while and udevd will log an error message at
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerstartup. It should still be able to boot-up, but advanced rules and system
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerservices which depend on the information not available in the old sysfs
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerformat will fail to work correctly.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerDVB device naming is supplied by the kernel now. In case older kernels
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerneed to be supported, the old shell script should be added to a compat
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerThe processed udev events get send back to the netlink socket. Libudev
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerprovides access to these events. This is work-in-progress, to replace
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerthe DeviceKit daemon functionality directly with libudev. There are
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerupcoming kernel changes to allow non-root users to subcribe to these
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyer"udevadm settle" now optionally accepts a range of events to wait for,
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerinstead of waiting for "all" events.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerThe installed watch for block device metadata changes is now removed
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerduring event hadling, because some (broken) tools may be called from udev
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerrules and (wrongly) open the device with write access. After the finished
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerevent handling the watch is restored.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerDevice nodes can be watched for changes with inotify with OPTIONS="watch".
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerIf closed after being opened for writing, a "change" uevent will occur.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyer/dev/disk/by-{label,uuid}/* symlinks will be automatically updated.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerThe udevadm test command has no longer a --force option, nodes and symlinks
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerare always updated with a test run now.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerThe udevd daemon can be started with --resolve-names=never to avoid all user
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerand group lookups (e.g. in cut-down systems) or --resolve-names=late to
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerlookup user and groups every time events are handled.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerWe are currently merging the Ubuntu rules in the udev default rules,
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerand get one step closer to provide a common Linux /dev setup, regarding
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerdevice names, symlinks, and default device permissions. On udev startup,
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerwe now expect the following groups to be resolvable to their ids with
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerglibc's getgrnam():
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyer disk, cdrom, floppy, tape, audio, video, lp, tty, dialout, kmem.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerLDAP setups need to make sure, that these groups are always resolvable at
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerbootup, with only the rootfs mounted, and without network access available.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerSome systems may need to add some new, currently not used groups, or need
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerto add some users to new groups, but the cost of this change is minimal,
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyercompared to the pain the current, rather random, differences between the
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyervarious distributions cause for upstream projects and third-party vendors.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerIn general, "normal" users who log into a machine should never be a member
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerof any such group, but the device-access should be managed by dynamic ACLs,
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerwhich get added and removed for the specific users on login/logout and
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyersession activity/inactivity. These groups are only provided for custom setups,
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerand mainly system services, to allow proper privilege separation.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerA video-streaming daemon uid would be a member of "audio" and "video", to get
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyeraccess to the sound and video devices, but no "normal" user should ever belong
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerto the "audio" group, because he could listen to the built-in microphone with
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerany ssh-session established from the other side of the world.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyer/dev/serial/by-{id,path}/ now contains links for ttyUSB devices,
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerwhich do not depend on the kernel device name. As usual, unique
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerdevices - only a single one per product connected, or a real
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerUSB serial number in the device - are always found with the same
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyername in the by-id/ directory.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerCompletely identical devices may overwrite their names in by-id/
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerand can only be found reliably in the by-path/ directory. Devices
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerspecified by by-path/ must not change their connection, like the
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerUSB port number they are plugged in, to keep their name.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerTo support some advanced features, Linux 2.6.22 is the oldest supported
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerversion now. The kernel config with enabled SYSFS_DEPRECATED is no longer
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyersupported. Older kernels should still work, and devices nodes should be
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerreliably created, but some rules and libudev will not work correctly because
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerthe old kernels do not provide the expected information or interfaces.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerFix for a possible segfault while swapping network interface names in udev
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerversions 131-134.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerThe group "video" is part of the default rules now.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerBugfix for kernels using SYSFS_DEPRECATED* option and finding parent
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerblock devices in some cases. No common distro uses this option anymore,
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerand we do not get enough testing for this and recent udev versions. If
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerthis option is not needed to run some old distro with a new kernel,
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerit should be disabled in the kernel config.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerBugfix for the $links substitution variable, which may crash if no links
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerare created. This should not happen in usual setups because we always
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyercreate /dev/{block,char}/ links.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerThe strings of the parsed rules, which are kept in memory, no longer
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyercontain duplicate entries, or duplicate tails of strings. This, and the
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyernew rules parsing/matching code reduces the total in-memory size of
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyera huge distro rule sets to 0.08 MB, compared to the 1.2MB of udev
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerThe export of DEVTYPE=disk/partition got removed from the default
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerrules. This value is available from the kernel. The pnp shell script
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyermodprobe hack is removed from the default rules. ACPI devices have _proper_
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyermodalias support and take care of the same functionality.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerInstallations which support old kernels, but install current default
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerudev rules may want to add that to the compat rules file.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerLibvolume_id now always probes for all known filesystems, and does not
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerstop at the first match. Some filesystems are marked as "exclusive probe",
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerand if any other filesytem type matches at the same time, libvolume_id
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerwill, by default, not return any probing result. This is intended to prevent
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyermis-detection with conflicting left-over signatures found from earlier
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerfile system formats. That way, we no longer depend on the probe-order
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerin case of multiple competing signatures. In some setups the kernel allows
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerto mount a volume with just the old filesystem signature still in place.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerThis may damage the new filesystem and cause data-loss, just by mounting
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerit. Because volume_id can not decide which one the correct signature is,
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerthe wrong signatures need to be removed manually from the volume, or the
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyervolume needs to be reformatted, to enable filesystem detection and possible
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerauto-mounting.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerFix segfault if compiled without optimization and dbg() does not get
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyercompiled out and uses variables which are not available.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerBugfixes. (And maybe new bugs. :))
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerThe rule matching engine got converted from a rule list to a token
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerarray which reduced the in-memory rules representation of a full
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerfeatured distros with thousends of udev rules from 1.2MB to 0.12 MB.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerLimits like 5 ENV and ATTR matches, and one single instance for most
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerother keys per rule are gone.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerThe NAME assignment is no longer special cased. If later rules assign
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyera NAME value again, the former value will be overwritten. As usual
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerfor most other keys, the NAME value can be protected by doing a final
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerassignment with NAME:="<value>".
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerAll udev code now uses libudev, which is also exported. The library
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyeris still under development, marked as experimental, and its interface
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyermay change as long as the DeviceKit integration is not finished.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerMany thanks to Alan Jenkins for his continuous help, and finding and
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyeroptimizing some of the computing expensive parts.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerKernel devices and device nodes are connected now by reverse indizes in
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyer/sys and /dev. A device number retrieved by a stat() or similar, the
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerkernel device directory can be found by looking up:
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyer /sys/dev/{block,char}/<maj>:<min>
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerand the device node of the same device by looking up:
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyer /dev/{block,char}/<maj>:<min>
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerFix recently introduced bug, which caused a compilation without large
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerfile support, where vol_id does not recognize raid signatures at the end
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerFirewire disks now create both, by-id/scsi-* and by-id/ieee-* links.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerSeems some kernel versions prevent the creation of the ieee-* links,
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerso people used the scsi-* link which disappeared now.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerMore libudev work. Almost all udevadm functionality comes from libudev
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerudevadm trigger has a new option --type, which allows to trigger events
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerfor "devices", for "subsystems", or "failed" devices. The old option
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyer--retry-failed" still works, but is no longer mentioned in the man page.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerThe udevadm info --device-id-of-file= output has changed to use
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerthe obvious format. Possible current users should use the --export
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyeroption which is not affected.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerThe old udev commands symlinks to udevadm are not installed, if
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerthese symlinks are used, a warning is printed.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerOptical drive's media is no longer probed for raid signatures,
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerreading the end of the device causes some devices to malfunction.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerAlso the offset of the last session found is used now to probe
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerfor the filesystem.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerThe volume_id library got a major version number update to 1,
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyersome deprecated functions are removed.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerA shared library "libudev" gets installed now to provide access
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerto udev device information. DeviceKit, the successor of HAL, will
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerneed this library to access the udev database and search sysfs for
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerThe library is currently in an experimental state, also the API is
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerexpected to change, as long as the DeviceKit integration is not
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerWe use ./configure now. See INSTALL for details. Current
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyer "/usr" - prefix for man pages, include files
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyer --exec-prefix=
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyer "" - the root filesystem, prefix for libs and binaries
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyer --sysconfdir=
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyer --with-libdir-name=
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyer "lib" - directory name for libraries, not a path name
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyer multilib 64bit systems may use "lib64" instead of "lib"
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyer --enable-debug
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyer compile-in verbose debug messages
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyer --disable-logging
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyer disable all logging and compile-out all log strings
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyer --with-selinux
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyer link against SELInux libraries, to set the expected context
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyer for created files
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerIn the default rules, the group "disk" gets permissions 0660 instead
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerof 0640. One small step closer to unify distro rules. Some day, all
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerdistros hopefully end up with the same set of rules.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerNo symlinks to udevadm are installed anymore, if they are still needed,
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerthey should be provided by the package.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerDefault udev rules, which are not supposed to be edited by the user, should
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerbe placed in /lib/udev/rules.d/ now, to make it clear that they are private to
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerthe udev package and will be replaced with an update. Udev will pick up rule
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyer /lib/udev/rules.d/ - default installed rules
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyer /etc/udev/rules.d/ - user rules + on-the-fly generated rules
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyer /dev/.udev/rules.d/ - temporary non-persistent rules created after bootup
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerIt does not matter in which directory a rule file lives, all files are sorted
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerin lexical order.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerTo help creating /dev/root, we have now:
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyer $ udevadm info --export --export-prefix="ROOT_" --device-id-of-file=/
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyer ROOT_MAJOR=8
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyer ROOT_MINOR=5
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerIn case the current --device-id-of-file is already used, please switch to
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerthe --export format version, it saves the output parsing and the old
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerformat will be changed to use ':' as a separator, like the format in the
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyersysfs 'dev' file.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerFix cdrom_id to properly recognize blank media.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerTape drive id-data is queried from /dev/bsg/* instead of the tape
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyernodes. This avoids rewinding tapes on open().
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald HoyerThe symlinks udevcontrol and udevtrigger are no longer installed by
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald Hoyerthe Makefile.
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald HoyerThe scsi_id program does not depend on sysfs anymore. It can speak
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald HoyerSGv4 now, so /dev/bsg/* device nodes can be used, to query SCSI device
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald Hoyerdata, which should solve some old problems with tape devices, where
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald Hoyerwe better do not open all tape device nodes to identify the device.
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald HoyerMany bugfixes.
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald HoyerThe cdrom_id program is replaced by an advanced version, which can
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald Hoyerdetect most common device types, and also properties of the inserted
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald Hoyermedia. This is part of moving some basic functionality from HAL into
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald Hoyerudev (and the kernel).
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald HoyerThe last WAIT_FOR_SYSFS rule is removed from the default rules.
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald HoyerThe symlinks to udevadm for the debugging tools: udevmonitor and
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald Hoyerudevtest are no longer created.
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald HoyerThe symlinks to the udevadm man page for the old tool names are
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald Hoyerno longer created.
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald HoyerAbstract namespace sockets paths in RUN+="socket:@<path>" rules,
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald Hoyershould be prefixed with '@' to indicate that the path is not a
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald HoyerUdevstart is removed from the tree, it did not get installed for
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald Hoyera long time now, and is long replaced by trigger and settle.
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald HoyerAll udev tools are merged into a single binary called udevadm.
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald HoyerThe old names of the tools are built-in commands in udevadm now.
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald HoyerSymlinks to udevadm, with the names of the old tools, provide
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald Hoyerthe same functionality as the standalone tools. There is also
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald Hoyeronly a single udevadm.8 man page left for all tools.
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald HoyerTools like mkinitramfs should be checked, if they need to include
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald Hoyerudevadm in the list of files.
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald HoyerThe etc/udev/rules.d/ directory now contains a default set of basic
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald Hoyerudev rules. This initial version is the result of a rules file merge
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald Hoyerof Fedora and openSUSE. For these both distros only a few specific
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald Hoyerrules are left in their own file, named after the distro. Rules which
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald Hoyerare optionally installed, because they are only valid for a specific
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald Hoyerarchitecture, or rules for subsystems which are not always used are
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald HoyerDynamic rules can be created in /dev/.udev/rules.d/ to trigger
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald Hoyeractions by dynamically created rules.
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald HoyerSYMLINK=="<value>" matches agains the entries in the list of
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald Hoyercurrently defined symlinks. The links are not created in the
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald Hoyerfilesystem at that point in time, but the values can be matched.
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald HoyerRUN{ignore_error}+="<program>" will ignore any exit code from the
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald Hoyerprogram and not record as a failed event.
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald HoyerFinal merge of patches/features from the Ubuntu package.
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald HoyerControl characters in filesystem label strings are no longer silenty
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald Hoyerremoved, but hex-encoded, to be able to uniquely identify the device
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald Hoyerby its symlink in /dev/disk/by-label/.
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald HoyerIf libvolume_id is used by mount(8), LABEL= will work as expected,
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald Hoyerif slashes or other characters are used in the label string.
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald HoyerTo test the existence of a file, TEST=="<file>" and TEST!="<file>"
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald Hoyercan be specified now. The TEST key accepts an optional mode mask
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald HoyerTEST{0100}=="<is executable file>".
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald HoyerScsi_id now supports a mode without expecting scsi-specific sysfs
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald Hoyerentries to allow the extraction of cciss-device persistent properties.
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald HoyerIn the future, we may see uuid's which are just simple character
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald Hoyerstrings (see the DDF Raid Specification). For that reason vol_id now
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald Hoyerexports ID_FS_UUID_SAFE, just like ID_FS_LABEL_SAFE. For things like
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald Hoyerthe creation of symlinks, the *_SAFE values ensure, that no control
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald Hoyeror whitespace characters are used in the filename.
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald HoyerPossible users of libvolume_id, please use the volume_id_get_* functions.
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald HoyerThe public struct will go away in a future release of the library.
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald HoyerRemoval of useless extras/eventrecorder.sh.
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald HoyerThe directory multiplexer for dev.d/ and hotplug.d are finally removed
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald Hoyerfrom the udev package.
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald HoyerSymlinks can have priorities now, the priority is assigned to the device
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald Hoyerand specified with OPTIONS="link_priority=100". Devices with higher
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald Hoyerpriorities overwrite the symlinks of devices with lower priorities.
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald HoyerIf the device that currently owns the link, goes away, the symlink
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald Hoyerwill be removed, and recreated, pointing to the next device with the
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald Hoyerhighest actual priority. This should make /dev/disk/by-{label,uuid,id}
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald Hoyermore reliable, if multiple devices contain the same metadata and overwrite
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald Hoyerthese symlinks.
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald HoyerThe dasd_id program is removed from the udev tree, and dasdinfo, with the
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald Hoyerneeded rules, are part of the s390-tools now.
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald HoyerPlease add KERNEL=="[0-9]*:[0-9]*" to the scsi wait-for-sysfs rule,
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald Hoyerwe may get the scsi sysfs mess fixed some day, and this will only catch
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald Hoyerthe devices we are looking for.
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald HoyerUSB serial numbers for storage devices have the target:lun now appended,
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald Hoyerto make it possibble to distinguish broken multi-lun devices with all
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald Hoyerthe same SCSI identifiers.
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald HoyerNote: The extra "run_directory" which searches and executes stuff in
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald Hoyer/etc/hotplug.d/ and /etc/dev.d/ is long deprecated, and will be removed
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald Hoyerwith the next release. Make sure, that you don't use it anymore, or
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald Hoyerprovides your own implementation of that inefficient stuff.
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald HoyerWe are tired of reports about a "slow udev", because these directories
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald Hoyercontain stuff, that runs with _every_ event, instead of using rules,
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald Hoyerthat run programs only for the matching events.
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald HoyerDRIVER== will match only for devices that actually have a real
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald Hoyerdriver. DRIVERS== must be used, if parent devices should be
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald Hoyerincluded in the match.
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald HoyerLibvolume_id's "linux_raid" detection needed another fix.
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald HoyerAdd additional check to volume_id detection of via_raid, cause
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald Hoyersome company decided to put a matching pattern all over the empty
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald Hoyerstorage area of their music players.
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald HoyerFix path_id for SAS devices.
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald HoyerThe udev daemon can be started with --debug-trace now, which will
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald Hoyerexecute all events serialized to get a chance to catch a possible
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald Hoyeraction that crashes the box.
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald HoyerA warning is logged, if PHYSDEV* keys, the "device" link, or a parent
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald Hoyerdevice attribute like $attr{../file} is used, only WAIT_FOR_SYSFS rules
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald Hoyerare excluded from the warning. Referencing parent attributes directly
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald Hoyermay break when something in the kernel driver model changes. Udev will
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald Hoyerjust find the attribute by walking up the parent chain.
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald HoyerUdevtrigger now sorts the list of devices depending on the device
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald Hoyerdependency, so a "usb" device is triggered after the parent "pci"
0d6e798a784ef0ba6b95512e4453067b2f84a91aHarald HoyerRevert persistent-storage ata-serial '_' '-' replacement.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerUdevtrigger can now filter the list of devices to be triggered. Matches
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerfor subsystems or sysfs attributes can be specified.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerThe entries in /dev/.udev/queue and /dev/.udev/failed have changed to
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerzero-sized files to avoid pointing to /sys and confuse broken tools which
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerscan the /dev directory. To retry failed events, udevtrigger --retry-failed
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyershould be used now.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerThe rules and scripts to create udev rules for persistent network
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerdevices and optical drives are in the extras/rules_generator directory
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyernow. If you use something similar, please consider replacing your own
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerversion with this, to share the support effort. The rule_generator
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerinstalls its own rules into /etc/udev/rules.d.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerThe cdrom_id tool installs its own rule now in /etc/udev/rules.d, cause
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerthe rule_generator depends on cdrom_id to be called in an earlier rule.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerRenaming of some key names (the old names still work):
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerBUS -> SUBSYSTEMS, ID -> KERNELS, SYSFS -> ATTRS, DRIVER -> DRIVERS.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyer(The behavior of the key DRIVER will change soon in one of the next
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerreleases, to match only the event device, please switch to DRIVERS
1ecf6a2b4960229ad1d06c591b4776ddf065e834Harald Hoyerinstead. If DRIVER is used, it will behave like DRIVERS, but an error
1ecf6a2b4960229ad1d06c591b4776ddf065e834Harald HoyerWith the new key names, we have a more consistent and simpler scheme.
1ecf6a2b4960229ad1d06c591b4776ddf065e834Harald HoyerWe can match the properties of the event device only, with: KERNEL,
1ecf6a2b4960229ad1d06c591b4776ddf065e834Harald HoyerSUBSYSTEM, ATTR, DRIVER. Or include all the parent devices in the match,
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerwith: KERNELS, SUBSYSTEMS, ATTRS, DRIVERS. ID, BUS, SYSFS, DRIVER are no
33a5e20ffaa2cbb2853f14265566bac66a7f9026Harald Hoyerlonger mentioned in the man page and should be switched in the rule
33a5e20ffaa2cbb2853f14265566bac66a7f9026Harald HoyerATTR{file}="value" can be used now, to write to a sysfs file of the
33a5e20ffaa2cbb2853f14265566bac66a7f9026Harald Hoyerevent device. Instead of:
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyer ..., SYSFS{type}=="0|7|14", RUN+="/bin/sh -c 'echo 60 > /sys$$DEVPATH/timeout'"
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerwe now can do:
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyer ..., ATTR{type}=="0|7|14", ATTR{timeout}="60"
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerAll the PHYSDEV* keys are deprecated and will be removed from a
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerfuture kernel:
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyer PHYDEVPATH - is the path of a parent device and should not be
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyer needed at all.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyer PHYSDEVBUS - is just a SUBSYSTEM value of a parent, and can be
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyer matched with SUBSYSTEMS==
889a90422dd47284dffa32b9234a6e58991b000cRonny Chevalier PHYSDEVDRIVER - for bus devices it is available as ENV{DRIVER}.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyer Newer kernels will have DRIVER in the environment,
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyer for older kernels udev puts in. Class device will
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyer no longer carry this property of a parent and
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyer DRIVERS== can be used to match such a parent value.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerNote that ENV{DRIVER} is only available for a few bus devices, where
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerthe driver is already bound at device event time. On coldplug, the
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerevents for a lot devices are already bound to a driver, and they will have
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerthat value set. But on hotplug, at the time the kernel creates the device,
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerit can't know what driver may claim the device after that, therefore
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerin most cases it will be empty.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerFailed events should now be re-triggered with:
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyer udevtrigger --retry-failed.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerPlease switch to this command, so we keep the details of the /dev/.udev/failed/
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerfiles private to the udev tools. We may need to switch the current symlink
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyertarget, cause some obviously broken tools try to scan all files in /dev
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerincluding /dev/.udev/, find the links to /sys and end up stat()'ing sysfs files
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyermillion times. This takes ages on slow boxes.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerThe udevinfo attribute walk (-a) now works with giving a device node
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyername (-n) instead of a devpath (-p). The query now always works, also when
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerno database file was created by udev.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerThe built-in /etc/passwd /etc/group parser is removed, we always depend on
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyergetpwnam() and getgrnam() now. One of the next releases will depend on
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerfnmatch() and may use getopt_long().
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerBugfixes and small improvements.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerFix path_id for recent kernels.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyer%e is finally gone.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerAdded support for swapping network interface names, by temporarily
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald Hoyerrenaming the device and wait for the target name to become free.
898720b7e9cf3bdf7a93e435cbed5dd6942ecf9bHarald HoyerThe built-in MODALIAS key and substitution is removed.
All *_id program are installed in /lib/udev/ by default now.
Fix queue export, which wasn't correct for subsequent add/remove
RUN="/bin/program" does not longer automatically add the subsystem
as the first parameter. This is from the days of /sbin/hotplug
to the key like RUN+="/bin/program $env{SUBSYSTEM}".
moving the class devices to /sys/devices.
Please report any new bugs/problems, that may be caused by this big
added /dev/disk/by-name/* for device mapper device names.
UDEV [1134776873.702967] add@/block/sdb
DEVNAME=/dev/sdb
DEVLINKS=/dev/disk/by-id/usb-IBM_Memory_Key_0218B301030027E8 /dev/disk/by-path/usb-0218B301030027E8:0:0:0
Default location for rule sripts and helper programs is now: /lib/udev/.
Also /lib/udev/devices is recommended as a directory where packages or
Kernel 2.6.15 will have symlinks at /class/input pointing to the real
Fix a stupid typo in extras/run_directory for "make install".
/dev/disk/by-label/* links, because we import untrusted data and
have stdin/stdout/stderr, which broke the forked tools in some
The new run_program() uncovered it, because /dev/null was not
persistent disk rules in /dev/disk/by-*/* on your distro, just
RUN+="socket:/org/freedesktop/hal/udev_event"
echo "" > /proc/sys/kernel/hotplug
make EXTRAS=extras/run_directory/
RUN+="/sbin/udev_run_hotplugd"
ACTION="add", DEVPATH="/devices/*", MODALIAS=="?*", RUN+="/sbin/modprobe $modalias"
needs to be documented, for now it's only visible in udev_rules_parse.c.
KERNEL="hd*[!0-9]", IMPORT="/sbin/ata_id --export $tempnode"
KERNEL="hd*[!0-9]", ENV{ID_SERIAL}=="?*", SYMLINK+="disk/by-id/$env{ID_MODEL}_$env{ID_SERIAL}"
kay@pim:~> tree /dev/disk
handling. This is meant as a general replacement for the dev.d/-directories
We support log priority levels now. The value udev_log in udev.conf is used
make USE_KLIBC=true KLCC=/usr/bin/klcc all