RELEASE-NOTES

   1 udev 096
   2 ========
   3 fix path_id for recent kernels
   4
   5 udev 095
   6 ========
   7 %e is finaly gone.
   8
   9 Added support for swapping network interface names, by temporarily
  10 renaming the device and wait for the target name to become free.
  11
  12 udev 094
  13 ========
  14 The built-in MODALIAS key and substitution is removed.
  15
  16 udev 093
  17 ========
  18 The binary firmware helper is replaced by the usual simple
  19 shell script. Udevsend is removed from the tree.
  20
  21 udev 092
  22 ========
  23 Bugfix release.
  24
  25 udev 091
  26 ========
  27 Some more keys require the correct use of '==' and '=' depending
  28 on the kind of operation beeing an assignment or a match. Rules
  29 with invalid operations are skipped and logged to syslog. Please
  30 test with udevtest if the parsing of your rules throws errors and
  31 fix possibly broken rules.
  32
  33 udev 090
  34 ========
  35 Provide "udevsettle" to wait for all current udev events to finish.
  36 It also watches the current kernel netlink queue by comparing the
  37 even sequence number to make sure that there are no current pending
  38 events that have not already arrived in the daemon.
  39
  40 udev 089
  41 ========
  42 Fix rule to skip persistent rules for removable IDE devices, which
  43 also skipped optical IDE drives.
  44
  45 All *_id program are installed in /lib/udev/ by default now.
  46
  47 No binary is stripped anymore as this should be done in the
  48 packaging process and not at build time.
  49
  50 libvolume_id is provided as a shared library now and vol_id is
  51 linked against it. Also one of the next HAL versions will require
  52 this library, and the HAL build process will also require the
  53 header file to be installed. The copy of the same code in HAL will
  54 be removed to have only a single copy left on the system.
  55
  56 udev 088
  57 ========
  58 Add persistent links for SCSI tapes. The rules file is renamed
  59 to 60-persistent-storage.rules.
  60
  61 Create persistent path for usb devices. Can be used for all sorts
  62 of devices that can't be distinguished by other properties like
  63 multiple identical keyboards and mice connected to the same box.
  64
  65 Provide "udevtrigger" program to request events on coldplug. The
  66 shell script is much too slow with thousends of devices.
  67
  68 udev 087
  69 ========
  70 Fix persistent disk rules to exclude removable IDE drives.
  71
  72 Warn if %e, $modalias or MODALIAS is used.
  73
  74 udev 086
  75 ========
  76 Fix queue export, which wasn't correct for subsequent add/remove
  77 events for the same device.
  78
  79 udev 085
  80 ========
  81 Fix cramfs detection on big endian.
  82
  83 Make WAIT_FOR_SYSFS usable in "normal" rules and silent if the whole
  84 device goes away.
  85
  86 udev 084
  87 ========
  88 If BUS== and SYSFS{}== have been used in the same rule, the sysfs
  89 attributes were only checked at the parent device that matched the
  90 by BUS requested subsystem. Fix it to also look at the device we
  91 received the event for.
  92
  93 Build variable CROSS has changed to CROSS_COMPILE to match the kernel
  94 build name.
  95
  96 udev 083
  97 ========
  98 Fix a bug where NAME="" would prevent RUN from beeing executed.
  99
 100 RUN="/bin/program" does not longer automatically add the subsystem
 101 as the first parameter. This is from the days of /sbin/hotplug
 102 which is dead now and it's just confusing to need to add a space at
 103 the end of the program name to prevent this.
 104 If you use rules that need the subsystem as the first parameter,
 105 like the old "udev_run_hotlugd" and "udev_run_devd", add the subsystem
 106 to the key like RUN+="/bin/program $env{SUBSYSTEM}".
 107
 108 udev 082
 109 ========
 110 The udev man page has moved to udev(7) as it does not describe a command
 111 anymore. The programs udev, udevstart and udevsend are no longer installed
 112 by default and must be copied manually, if they should be installed or
 113 included in a package.
 114
 115 Fix a bug where "ignore_device" could run earlier collected RUN keys before
 116 the ignore rule was applied.
 117
 118 More preparation for future sysfs changes. usb_id and scsi_id no longer
 119 depend on a magic order of devices in the /devices chain. Specific devices
 120 should be requested by their subsytem.
 121
 122 This will always find the scsi parent device without depending on a specific
 123 path position:
 124   dev = sysfs_device_get(devpath);
 125   dev_usb = sysfs_device_get_parent_with_subsystem(dev, "scsi");
 126
 127 The "device" link in the current sysfs layout will be automatically
 128 _resolved_ as a parent and in the new sysfs layout it will just _be_ the
 129 parent in the devpath. If a device is requested by it's symlink, like all
 130 class devices in the new sysfs layout will look like, it gets automatically
 131 resolved and substituted with the real devpath and not the symlink path.
 132
 133 Note:
 134 A similar logic must be applied to _all_ sysfs users, including
 135 scripts, that search along parent devices in sysfs. The explicit use of
 136 the "device" link must be avoided. With the future sysfs layout all
 137 DEVPATH's will start with /devices/ and have a "subsystem" symlink poiting
 138 back to the "class" or the "bus". The layout of the parent devices in
 139 /devices is not necessarily expected to be stable across kernel releases and
 140 searching for parents by their subsystem should make sysfs users tolerant
 141 for changed parent chains.
 142
 143 udev 081
 144 ========
 145 Prepare udev to work with the experimental kernel patch, that moves
 146 /sys/class devices to /sys/devices and /sys/block to /sys/class/block.
 147
 148 Clarify BUS, ID, $id usage and fix $id behavior. This prepares for
 149 moving the class devices to /sys/devices.
 150
 151 Thanks again to Marco for help finding a hopefully nice compromise
 152 to make %b simpler and working again.
 153
 154 udev 080
 155 ========
 156 Complete removal of libsysfs, replaced by simple helper functions
 157 which are much simpler and a bit faster. The udev daemon operatesentirely
 158 on event parameters and does not use sysfs for simple rules anymore.
 159 Please report any new bugs/problems, that may be caused by this big
 160 change. They will be fixed immediately.
 161
 162 The enumeration format character '%e' is deprecated and will be
 163 removed sometimes from a future udev version. It never worked correctly
 164 outside of udevstart, so we can't use it with the new parallel
 165 coldplug. A simple enumeration is as useless as the devfs naming
 166 scheme, just get rid of both if you still use it.
 167
 168 MODALIAS and $modalias is not needed and will be removed from one of
 169 the next udev versions, replace it in all rules with ENV{MODALIAS} or
 170 the sysfs "modalias" value.
 171
 172 Thanks a lot to Marco for all his help on finding and fixing bugs.
 173
 174 udev 079
 175 ========
 176 Let scsi_id request libata drive serial numbers from page 0x80.
 177
 178 Renamed etc/udev/persistent.rules to persistent-disk.rules and
 179 added /dev/disk/by-name/* for device mapper device names.
 180
 181 Removed %e from the man page. It never worked reliably outside
 182 of udevstart and udevstart is no longer recommended to use.
 183
 184 udev 078
 185 ========
 186 Symlinks are now exported to the event environment. Hopefully it's no
 187 longer needed to run udevinfo from an event process, like it was
 188 mentioned on the hotplug list:
 189   UDEV  [1134776873.702967] add@/block/sdb
 190   ...
 191   DEVNAME=/dev/sdb
 192   DEVLINKS=/dev/disk/by-id/usb-IBM_Memory_Key_0218B301030027E8 /dev/disk/by-path/usb-0218B301030027E8:0:0:0
 193
 194 udev 077
 195 ========
 196 Fix a problem if udevsend is used as the hotplug handler and tries to use
 197 syslog, which causes a "vc" event loop. 2.6.15 will make udevsend obsolete
 198 and this kind of problems will hopefully go away soon.
 199
 200 udev 076
 201 ========
 202 All built-in logic to work around bad sysfs timing is removed with this
 203 version. The need to wait for sysfs files is almost fixed with a kernel
 204 version that doesn't work with this udev version anyway. Until we fix
 205 the timing of the "bus" link creation, the former integrated logic should
 206 be emulated by a rule placed before all other rules:
 207   ACTION=="add", DEVPATH=="/devices/*", ENV{PHYSDEVBUS}=="?*", WAIT_FOR_SYSFS="bus"
 208
 209 The option "udev_db" does no longer exist. All udev state will be in
 210 /$udev_root/.udev/ now, there is no longer an option to set this
 211 to anything else.
 212 If the init script or something else used this value, just depend on
 213 this hardcoded path. But remember _all_content_ of this directory is
 214 still private to udev and can change at any time.
 215
 216 Default location for rule sripts and helper programs is now: /lib/udev/.
 217 Everything that is not useful on the commandline should go into this
 218 directory. Some of the helpers in the extras folder are installed there
 219 now. The rules need to be changed, to find the helpers there.
 220
 221 Also /lib/udev/devices is recommended as a directory where packages or
 222 the user can place real device nodes, which get copied over to /dev at
 223 every boot. This should replace the various solutions with custom config
 224 files.
 225
 226 Udevsend does no longer start the udev daemon. This must be done with
 227 the init script that prepares /dev on tmpfs and creates the initial nodes,
 228 before starting the daemon.
 229
 230 udev 075
 231 ========
 232 Silent a too verbose error logging for the old hotplug.d/ dev.d/
 233 emulation.
 234
 235 The copy of klibc is removed. A systemwide installed version of klibc
 236 should be used to build a klibc udev now.
 237
 238 udev 074
 239 ========
 240 NAME="" will not create any nodes, but execute RUN keys. To completely
 241 ignore an event the OPTION "ignore_device" should be used.
 242
 243 After removal of the reorder queue, events with a TIMEOUT can be executed
 244 without any queuing now.
 245
 246 udev 073
 247 ========
 248 Fixed bug in udevd, if inotify is not available. We depend on netlink
 249 uevents now, kernels without that event source will not work with that
 250 version of udev anymore.
 251
 252 udev 072
 253 ========
 254 The rule parsing happens now in the daemon once at startup, all udev
 255 event processes inherit the already parsed rules from the daemon.
 256 It is shipped with SUSE10.0 and reduces heavily the system load at
 257 startup. The option to save precompiled rules and let the udev process
 258 pick the them up is removed, as it's no longer needed.
 259
 260 Kernel 2.6.15 will have symlinks at /class/input pointing to the real
 261 device. Libsysfs is changed to "translate" the requested link into the
 262 real device path, as it would happen with the hotplug event. Otherwise
 263 device removal and the udev database will not work.
 264
 265 Using 'make STRIPCMD=' will leave the binaries unstripped for debugging
 266 and packaging.
 267
 268 A few improvements for vol_id, the filesytem probing code.
 269
 270 udev 071
 271 ========
 272 Fix a stupid typo in extras/run_directory for "make install".
 273
 274 scsi_id creates the temporary devnode now in /dev for usage with a
 275 non-writable /tmp directory.
 276
 277 The uevent kernel socket buffer can carry app. 50.000 events now,
 278 let's see who can break this again. :)
 279
 280 The upcoming kernel will have a new input driver core integration.
 281 Some class devices are now symlinks to the real device. libsysfs
 282 needs a fix for this to work correctly. Udevstart of older udev
 283 versions will _not_ create these devices!
 284
 285 udev 070
 286 ========
 287 Fix a 'install' target in the Makefile, that prevents EXTRAS from
 288 beeing installed.
 289
 290 udev 069
 291 ========
 292 A bunch of mostly trivial bugfixes. From now on no node name or
 293 symlink name can contain any character than plain whitelisted ascii
 294 characters or validated utf8 byte-streams. This is needed for the
 295 /dev/disk/by-label/* links, because we import untrusted data and
 296 export it to the filesystem.
 297
 298 udev 068
 299 ========
 300 More bugfixes. If udevd was started from the kernel, we don't
 301 have stdin/stdout/stderr, which broke the forked tools in some
 302 situations.
 303
 304 udev 067
 305 ========
 306 Bugfix. udevstart event ordering was broken for a long time.
 307 The new run_program() uncovered it, because /dev/null was not
 308 available while we try to run external programs.
 309 Now udevstart should create it before we run anything.
 310
 311 udev 066
 312 ========
 313 Minor bugfixes and some distro rules updates. If you don't have the
 314 persistent disk rules in /dev/disk/by-*/* on your distro, just
 315 grab it from here. :)
 316
 317 udev 065
 318 ========
 319 We can use socket communication now to pass events from udev to
 320 other programs:
 321   RUN+="socket:/org/freedesktop/hal/udev_event"
 322 will pass the whole udev event to the HAL daemon without the need
 323 for a forked helper. (See ChangeLog for udevmonitor, as an example)
 324
 325 udev 064
 326 ========
 327 Mostly bugfixes and see ChangeLog.
 328
 329 The test for the existence of an environment value should be
 330 switched from:
 331   ENV{KEY}=="*" to ENV{KEY}=="?*"
 332 because "*" will not fail anymore, if the key does not exist or
 333 is empty.
 334
 335 udev 063
 336 ========
 337 Bugfixes and a few tweaks described in the ChangeLog.
 338
 339 udev 062
 340 ========
 341 Mostly a Bugfix release.
 342
 343 Added WAIT_FOR_SYSFS="<attribute>" to be able to fight against the sysfs
 344 timing with custom rules.
 345
 346 udev 061
 347 ========
 348 We changed the  internal rule storage format. Our large rule files took
 349 2 MB of RAM, with the change we are down to 99kB.
 350
 351 If the device-node has been created with default name and no symlink or
 352 options are to remenber, it is not longer stored in the udevdb. HAL will
 353 need to be updated to work correctly with that change.
 354
 355 To overrride optimization flags, OPTFLAGS may be used now.
 356
 357 udev 060
 358 ========
 359 Bugfix release.
 360
 361 udev 059
 362 ========
 363 Major changes happened with this release. The goal is to take over the
 364 complete kernel-event handling and provide a more efficient way to dispatch
 365 kernel events. Replacing most of the current shell script logic and the
 366 kernel forked helper with a netlink-daemon and a rule-based event handling.
 367
 368 o udevd listens to netlink events now. The first valid netlink event
 369   will make udevd ignore any message from udevsend that contains a
 370   SEQNUM, to avoid duplicate events. The forked events can be disabled
 371   with:
 372     echo "" > /proc/sys/kernel/hotplug
 373   For full support, the broken input-subsytem needs to be fixed, not to
 374   bypass the driver core.
 375
 376 o /etc/dev.d/ + /etc/hotplug.d/ directory multiplexing is completely
 377   removed from udev itself and must be emulated by calling small
 378   helper binaries provided in the extras folder:
 379     make EXTRAS=extras/run_directory/
 380   will build udev_run_devd and udev_run_hotplugd, which can be called
 381   from a rule if needed:
 382     RUN+="/sbin/udev_run_hotplugd"
 383   The recommended way to handle this is to convert all the calls from
 384   the directories to explicit udev rules and get completely rid of the
 385   multiplexing. (To catch a ttyUSB event, you now no longer need to
 386   fork and exit 300 tty script instances you are not interested in, it
 387   is just one rule that matches exactly the device.)
 388
 389 o udev handles now _all_ events not just events for class and block
 390   devices, this way it is possible to control the complete event
 391   behavior with udev rules. Especially useful for rules like:
 392     ACTION="add", DEVPATH="/devices/*", MODALIAS=="?*", RUN+="/sbin/modprobe $modalias"
 393
 394 o As used in the modalias rule, udev supports now textual
 395   substitution placeholder along with the usual format chars. This
 396   needs to be documented, for now it's only visible in udev_rules_parse.c.
 397
 398 o The rule keys support now more operations. This is documented in the
 399   man page. It is possible to add values to list-keys like the SYMLINK
 400   and RUN list with KEY+="value" and to clear the list by assigning KEY="".
 401   Also "final"-assignments are supported by using KEY:="value", which will
 402   prevent changing the key by any later rule.
 403
 404 o kernel 2.6.12 has the "detached_state" attribute removed from
 405   sysfs, which was used to recognize sysfs population. We switched that
 406   to wait for the "bus" link, which is only available in kernels after 2.6.11.
 407   Running this udev version on older kernels may cause a short delay for
 408   some events.
 409
 410 o To provide infrastructure for persistent device naming, the id programs:
 411   scsi_id, vol_id (former udev_volume_id), and ata_id (new) are able now
 412   to export the probed data in environment key format:
 413     pim:~ # /sbin/ata_id --export /dev/hda
 414     ID_MODEL=HTS726060M9AT00
 415     ID_SERIAL=MRH401M4G6UM9B
 416     ID_REVISION=MH4OA6BA
 417
 418   The following rules:
 419     KERNEL="hd*[!0-9]", IMPORT="/sbin/ata_id --export $tempnode"
 420     KERNEL="hd*[!0-9]", ENV{ID_SERIAL}=="?*", SYMLINK+="disk/by-id/$env{ID_MODEL}_$env{ID_SERIAL}"
 421
 422   Will create:
 423     kay@pim:~> tree /dev/disk
 424     /dev/disk
 425     |-- by-id
 426     |   |-- HTS726060M9AT00_MRH401M4G6UM9B -> ../../hda
 427     |   `-- IBM-Memory_Key -> ../../sda
 428     |-- by-label
 429     |   |-- swap -> ../../hda1
 430     |   |-- date -> ../../sda1
 431     |   `-- home -> ../../hda3
 432     `-- by-uuid
 433         |-- 2E08712B0870F2E7 -> ../../hda3
 434         |-- 9352cfef-7687-47bc-a2a3-34cf136f72e1 -> ../../hda1
 435         |-- E845-7A89 -> ../../sda1
 436         `-- b2a61681-3812-4f13-a4ff-920d70604299 -> ../../hda2
 437
 438   The IMPORT= operation will import these keys in the environment and make
 439   it available for later PROGRAM= and RUN= executed programs. The keys are
 440   also stored in the udevdb and can be queried from there with one of the
 441   next udev versions.
 442
 443 o A few binaries are silently added to the repository, which can be used
 444   to replay kernel events from initramfs instead of using coldplug. udevd
 445   can be instructed now to queue-up events while the stored events from
 446   initramfs are filled into the udevd-queue. This code is still under
 447   development and there is no documentation now besides the code itself.
 448   The additional binaries get compiled, but are not installed by default.
 449
 450 o There is also a temporary fix for a performance problem where too many
 451   events happen in parallel and every event needs to parse the rules.
 452   udev can now read precompiled rules stored on disk. This is likely to be
 453   replaced by a more elegant solution in a future udev version.
 454
 455 udev 058
 456 ========
 457 With kernel version 2.6.12, the sysfs file "detached_state" was removed.
 458 Fix for libsysfs not to expect this file was added.
 459
 460 udev 057
 461 ========
 462 All rules are applied now, but only the first matching rule with a NAME-key
 463 will be applied. All later rules with NAME-key are completely ignored. This
 464 way system supplied symlinks or permissions gets applied to user-defined
 465 naming rules.
 466
 467 Note:
 468 Please check your rules setup, if you may need to add OPTIONS="last_rule"
 469 to some rules, to keep the old behavior.
 470
 471 The rules are read on "remove"-events too. That makes is possible to match
 472 with keys that are available on remove (KERNEL, SUBSYSTEM, ID, ENV, ...) to
 473 instruct udev to ignore an event (OPTIONS="ignore_device").
 474 The new ACTION-key may be used to let a rule act only at a "remove"-event.
 475
 476 The new RUN-key supports rule-based execution of programs after device-node
 477 handling. This is meant as a general replacement for the dev.d/-directories
 478 to give fine grained control over the execution of programs.
 479
 480 The %s{}-sysfs format char replacement values are searched at any of the
 481 devices in the device chain now, not only at the class-device.
 482
 483 We support log priority levels now. The value udev_log in udev.conf is used
 484 to determine what is printed to syslog. This makes it possible to
 485 run a version with compiled-in debug messages in a production environment
 486 which is sometimes needed to find a bug.
 487 It is still possible to supress the inclusion of _any_ syslog usage with
 488 USE_LOG=false to create the smallest possible binaries if needed.
 489 The configured udev_log value can be overridden with the environment variable
 490 UDEV_LOG.
 491
 492 udev 056
 493 ========
 494 Possible use of a system-wide klibc:
 495   make USE_KLIBC=true KLCC=/usr/bin/klcc all
 496 will link against an external klibc and our own version will be ignored.
 497
 498 udev 055
 499 ========
 500 We support an unlimited count of symlinks now.
 501
 502 If USE_STATIC=true is passed to a glibc build, we link statically and use
 503 a built-in userdb parser to resolve user and group names.
 504
 505 The PLACE= key is gone. It can be replaced by an ID= for a long time, because
 506 we walk up the chain of physical devices to find a match.
 507
 508 The KEY="<value>" format supports '=', '==', '!=,' , '+=' now. This makes it
 509 easy to skip certain attribute matches without composing rules with weird
 510 character class negations like:
 511   KERNEL="[!s][!c][!d]*"
 512 this can now be replaced with:
 513   KERNEL!="scd*"
 514 The current simple '=' is still supported, and should work as it does today,
 515 but existing rules should be converted if possible, to be better readable.
 516
 517 We have new ENV{}== key now, to match against a maximum of 5 environment
 518 variables.
 519
 520 udevstart is its own binary again, because we don't need co carry this araound
 521 with every forked event.