chiark / gitweb /
fea7db0d2b557719dc9f3abef1a9edeb86a677e7
[elogind.git] / NEWS
1 udev 125
2 ========
3 Bugfixes.
4
5 Default udev rules, which are not supposed to be edited by the user, should
6 be placed in /lib/udev/rules.d/ now, to make it clear that they are private to
7 the udev package and will be replaced with an update. Udev will pick up rule
8 files from:
9   /lib/udev/rules.d/  - default installed rules
10   /etc/udev/rules.d/  - user rules + on-the-fly generated rules
11   /dev/.udev/rules.d/ - temporary non-persistent rules created after bootup
12 It does not matter in which directory a rule file lives, all files are sorted
13 in lexical order.
14
15 To help creating /dev/root, we have now:
16   $ udevadm info --export --export-prefix="ROOT_" --device-id-of-file=/
17   ROOT_MAJOR=8
18   ROOT_MINOR=5
19 In case the current --device-id-of-file is already used, please switch to
20 the --export format version, it saves the output parsing and the old
21 format will be changed to use ':' as a separator, like the format in the
22 sysfs 'dev' file.
23
24 udev 124
25 ========
26 Fix cdrom_id to properly recognize blank media.
27
28 udev 123
29 ========
30 Bugfixes.
31
32 Tape drive id-data is queried from /dev/bsg/* instead of the tape
33 nodes. This avoids rewinding tapes on open().
34
35 udev 122
36 ========
37 Bugfixes.
38
39 The symlinks udevcontrol and udevtrigger are no longer installed by
40 the Makefile.
41
42 The scsi_id program does not depend on sysfs anymore. It can speak
43 SGv4 now, so /dev/bsg/* device nodes can be used, to query SCSI device
44 data, which should solve some old problems with tape devices, where
45 we better do not open all tape device nodes to identify the device.
46
47 udev 121
48 ========
49 Many bugfixes.
50
51 The cdrom_id program is replaced by an advanced version, which can
52 detect most common device types, and also properties of the inserted
53 media. This is part of moving some basic functionality from HAL into
54 udev (and the kernel).
55
56 udev 120
57 ========
58 Bugfixes.
59
60 The last WAIT_FOR_SYSFS rule is removed from the default rules.
61
62 The symlinks to udevadm for the debugging tools: udevmonitor and
63 udevtest are no longer created.
64
65 The symlinks to the udevadm man page for the old tool names are
66 no longer created.
67
68 Abstract namespace sockets paths in RUN+="socket:@<path>" rules,
69 should be prefixed with '@' to indicate that the path is not a
70 real file.
71
72 udev 119
73 ========
74 Bugfixes.
75
76 udev 118
77 ========
78 Bugfixes.
79
80 Udevstart is removed from the tree, it did not get installed for
81 a long time now, and is long replaced by trigger and settle.
82
83 udev 117
84 ========
85 Bugfixes.
86
87 All udev tools are merged into a single binary called udevadm.
88 The old names of the tools are built-in commands in udevadm now.
89 Symlinks to udevadm, with the names of the old tools, provide
90 the same functionality as the standalone tools. There is also
91 only a single udevadm.8 man page left for all tools.
92
93 Tools like mkinitramfs should be checked, if they need to include
94 udevadm in the list of files.
95
96 udev 116
97 ========
98 Bugfixes.
99
100 udev 115
101 ========
102 Bugfixes.
103
104 The etc/udev/rules.d/ directory now contains a default set of basic
105 udev rules. This initial version is the result of a rules file merge
106 of Fedora and openSUSE. For these both distros only a few specific
107 rules are left in their own file, named after the distro. Rules which
108 are optionally installed, because they are only valid for a specific
109 architecture, or rules for subsystems which are not always used are
110 in etc/udev/packages/.
111
112 udev 114
113 ========
114 Bugfixes.
115
116 Dynamic rules can be created in /dev/.udev/rules.d/ to trigger
117 actions by dynamically created rules.
118
119 SYMLINK=="<value>" matches agains the entries in the list of
120 currently defined symlinks. The links are not created in the
121 filesystem at that point in time, but the values can be matched.
122
123 RUN{ignore_error}+="<program>" will ignore any exit code from the
124 program and not record as a failed event.
125
126 udev 113
127 ========
128 Bugfixes.
129
130 Final merge of patches/features from the Ubuntu package.
131
132 udev 112
133 ========
134 Bugfixes.
135
136 Control characters in filesystem label strings are no longer silenty
137 removed, but hex-encoded, to be able to uniquely identify the device
138 by its symlink in /dev/disk/by-label/.
139 If libvolume_id is used by mount(8), LABEL= will work as expected,
140 if slashes or other characters are used in the label string.
141
142 To test the existence of a file, TEST=="<file>" and TEST!="<file>"
143 can be specified now. The TEST key accepts an optional mode mask
144 TEST{0100}=="<is executable file>".
145
146 Scsi_id now supports a mode without expecting scsi-specific sysfs
147 entries to allow the extraction of cciss-device persistent properties.
148
149 udev 111
150 ========
151 Bugfixes.
152
153 In the future, we may see uuid's which are just simple character
154 strings (see the DDF Raid Specification). For that reason vol_id now
155 exports ID_FS_UUID_SAFE, just like ID_FS_LABEL_SAFE. For things like
156 the creation of symlinks, the *_SAFE values ensure, that no control
157 or whitespace characters are used in the filename.
158
159 Possible users of libvolume_id, please use the volume_id_get_* functions.
160 The public struct will go away in a future release of the library.
161
162 udev 110
163 ========
164 Bugfixes.
165
166 Removal of useless extras/eventrecorder.sh.
167
168 udev 109
169 ========
170 Bugfixes.
171
172 udev 108
173 ========
174 Bugfixes.
175
176 The directory multiplexer for dev.d/ and hotplug.d are finally removed
177 from the udev package.
178
179 udev 107
180 ========
181 Bugfixes.
182
183 Symlinks can have priorities now, the priority is assigned to the device
184 and specified with OPTIONS="link_priority=100". Devices with higher
185 priorities overwrite the symlinks of devices with lower priorities.
186 If the device that currently owns the link, goes away, the symlink
187 will be removed, and recreated, pointing to the next device with the
188 highest actual priority. This should make /dev/disk/by-{label,uuid,id}
189 more reliable, if multiple devices contain the same metadata and overwrite
190 these symlinks.
191
192 The dasd_id program is removed from the udev tree, and dasdinfo, with the
193 needed rules, are part of the s390-tools now.
194
195 Please add KERNEL=="[0-9]*:[0-9]*" to the scsi wait-for-sysfs rule,
196 we may get the scsi sysfs mess fixed some day, and this will only catch
197 the devices we are looking for.
198
199 USB serial numbers for storage devices have the target:lun now appended,
200 to make it possibble to distinguish broken multi-lun devices with all
201 the same SCSI identifiers.
202
203 Note: The extra "run_directory" which searches and executes stuff in
204 /etc/hotplug.d/ and /etc/dev.d/ is long deprecated, and will be removed
205 with the next release. Make sure, that you don't use it anymore, or
206 provides your own implementation of that inefficient stuff.
207 We are tired of reports about a "slow udev", because these directories
208 contain stuff, that runs with _every_ event, instead of using rules,
209 that run programs only for the matching events.
210
211 udev 106
212 ========
213 Bugfixes.
214
215 udev 105
216 ========
217 Bugfixes.
218
219 DRIVER== will match only for devices that actually have a real
220 driver. DRIVERS== must be used, if parent devices should be
221 included in the match.
222
223 Libvolume_id's "linux_raid" detection needed another fix.
224
225 udev 104
226 ========
227 Bugfixes.
228
229 udev 103
230 ========
231 Add additional check to volume_id detection of via_raid, cause
232 some company decided to put a matching pattern all over the empty
233 storage area of their music players.
234
235 udev 102
236 ========
237 Fix path_id for SAS devices.
238
239 udev 101
240 ========
241 The udev daemon can be started with --debug-trace now, which will
242 execute all events serialized to get a chance to catch a possible
243 action that crashes the box.
244
245 A warning is logged, if PHYSDEV* keys, the "device" link, or a parent
246 device attribute like $attr{../file} is used, only WAIT_FOR_SYSFS rules
247 are excluded from the warning. Referencing parent attributes directly
248 may break when something in the kernel driver model changes. Udev will
249 just find the attribute by walking up the parent chain.
250
251 Udevtrigger now sorts the list of devices depending on the device
252 dependency, so a "usb" device is triggered after the parent "pci"
253 device.
254
255 udev 100
256 ========
257 Revert persistent-storage ata-serial '_' '-' replacement.
258
259 udev 099
260 ========
261 Bugfixes.
262
263 Udevtrigger can now filter the list of devices to be triggered. Matches
264 for subsystems or sysfs attributes can be specified.
265
266 The entries in /dev/.udev/queue and /dev/.udev/failed have changed to
267 zero-sized files to avoid pointing to /sys and confuse broken tools which
268 scan the /dev directory. To retry failed events, udevtrigger --retry-failed
269 should be used now.
270
271 The rules and scripts to create udev rules for persistent network
272 devices and optical drives are in the extras/rules_generator directory
273 now. If you use something similar, please consider replacing your own
274 version with this, to share the support effort. The rule_generator
275 installs its own rules into /etc/udev/rules.d.
276
277 The cdrom_id tool installs its own rule now in /etc/udev/rules.d, cause
278 the rule_generator depends on cdrom_id to be called in an earlier rule.
279
280 udev 098
281 ========
282 Bugfixes.
283
284 Renaming of some key names (the old names still work):
285 BUS -> SUBSYSTEMS, ID -> KERNELS, SYSFS -> ATTRS, DRIVER -> DRIVERS.
286 (The behavior of the key DRIVER will change soon in one of the next
287 releases, to match only the event device, please switch to DRIVERS
288 instead. If DRIVER is used, it will behave like DRIVERS, but an error
289 is logged.
290 With the new key names, we have a more consistent and simpler scheme.
291 We can match the properties of the event device only, with: KERNEL,
292 SUBSYSTEM, ATTR, DRIVER. Or include all the parent devices in the match,
293 with: KERNELS, SUBSYSTEMS, ATTRS, DRIVERS. ID, BUS, SYSFS, DRIVER are no
294 longer mentioned in the man page and should be switched in the rule
295 files.
296
297 ATTR{file}="value" can be used now, to write to a sysfs file of the
298 event device. Instead of:
299   ..., SYSFS{type}=="0|7|14", RUN+="/bin/sh -c 'echo 60 > /sys$$DEVPATH/timeout'"
300 we now can do:
301   ..., ATTR{type}=="0|7|14", ATTR{timeout}="60"
302
303 All the PHYSDEV* keys are deprecated and will be removed from a
304 future kernel:
305   PHYDEVPATH -    is the path of a parent device and should not be
306                   needed at all.
307   PHYSDEVBUS -    is just a SUBSYSTEM value of a parent, and can be
308                   matched with SUBSYSTEMS==
309   PHYSDEVDRIVER - for bus devices it is available as ENV{DRIVER}.
310                   Newer kernels will have DRIVER in the environment,
311                   for older kernels udev puts in. Class device will
312                   no longer carry this property of a parent and
313                   DRIVERS== can be used to match such a parent value.
314 Note that ENV{DRIVER} is only available for a few bus devices, where
315 the driver is already bound at device event time. On coldplug, the
316 events for a lot devices are already bound to a driver, and they will have
317 that value set. But on hotplug, at the time the kernel creates the device,
318 it can't know what driver may claim the device after that, therefore
319 in most cases it will be empty.
320
321 Failed events should now be re-triggered with:
322    udevtrigger --retry-failed.
323 Please switch to this command, so we keep the details of the /dev/.udev/failed/
324 files private to the udev tools. We may need to switch the current symlink
325 target, cause some obviously broken tools try to scan all files in /dev
326 including /dev/.udev/, find the links to /sys and end up stat()'ing sysfs files
327 million times. This takes ages on slow boxes.
328
329 The udevinfo attribute walk (-a) now works with giving a device node
330 name (-n) instead of a devpath (-p). The query now always works, also when
331 no database file was created by udev.
332
333 The built-in /etc/passwd /etc/group parser is removed, we always depend on
334 getpwnam() and getgrnam() now. One of the next releases will depend on
335 fnmatch() and may use getopt_long().
336
337 udev 097
338 ========
339 Bugfixes and small improvements.
340
341 udev 096
342 ========
343 Fix path_id for recent kernels.
344
345 udev 095
346 ========
347 %e is finally gone.
348
349 Added support for swapping network interface names, by temporarily
350 renaming the device and wait for the target name to become free.
351
352 udev 094
353 ========
354 The built-in MODALIAS key and substitution is removed.
355
356 udev 093
357 ========
358 The binary firmware helper is replaced by the usual simple
359 shell script. Udevsend is removed from the tree.
360
361 udev 092
362 ========
363 Bugfix release.
364
365 udev 091
366 ========
367 Some more keys require the correct use of '==' and '=' depending
368 on the kind of operation beeing an assignment or a match. Rules
369 with invalid operations are skipped and logged to syslog. Please
370 test with udevtest if the parsing of your rules throws errors and
371 fix possibly broken rules.
372
373 udev 090
374 ========
375 Provide "udevsettle" to wait for all current udev events to finish.
376 It also watches the current kernel netlink queue by comparing the
377 even sequence number to make sure that there are no current pending
378 events that have not already arrived in the daemon.
379
380 udev 089
381 ========
382 Fix rule to skip persistent rules for removable IDE devices, which
383 also skipped optical IDE drives.
384
385 All *_id program are installed in /lib/udev/ by default now.
386
387 No binary is stripped anymore as this should be done in the
388 packaging process and not at build time.
389
390 libvolume_id is provided as a shared library now and vol_id is
391 linked against it. Also one of the next HAL versions will require
392 this library, and the HAL build process will also require the
393 header file to be installed. The copy of the same code in HAL will
394 be removed to have only a single copy left on the system.
395
396 udev 088
397 ========
398 Add persistent links for SCSI tapes. The rules file is renamed
399 to 60-persistent-storage.rules.
400
401 Create persistent path for usb devices. Can be used for all sorts
402 of devices that can't be distinguished by other properties like
403 multiple identical keyboards and mice connected to the same box.
404
405 Provide "udevtrigger" program to request events on coldplug. The
406 shell script is much too slow with thousends of devices.
407
408 udev 087
409 ========
410 Fix persistent disk rules to exclude removable IDE drives.
411
412 Warn if %e, $modalias or MODALIAS is used.
413
414 udev 086
415 ========
416 Fix queue export, which wasn't correct for subsequent add/remove
417 events for the same device.
418
419 udev 085
420 ========
421 Fix cramfs detection on big endian.
422
423 Make WAIT_FOR_SYSFS usable in "normal" rules and silent if the whole
424 device goes away.
425
426 udev 084
427 ========
428 If BUS== and SYSFS{}== have been used in the same rule, the sysfs
429 attributes were only checked at the parent device that matched the
430 by BUS requested subsystem. Fix it to also look at the device we
431 received the event for.
432
433 Build variable CROSS has changed to CROSS_COMPILE to match the kernel
434 build name.
435
436 udev 083
437 ========
438 Fix a bug where NAME="" would prevent RUN from beeing executed.
439
440 RUN="/bin/program" does not longer automatically add the subsystem
441 as the first parameter. This is from the days of /sbin/hotplug
442 which is dead now and it's just confusing to need to add a space at
443 the end of the program name to prevent this.
444 If you use rules that need the subsystem as the first parameter,
445 like the old "udev_run_hotlugd" and "udev_run_devd", add the subsystem
446 to the key like RUN+="/bin/program $env{SUBSYSTEM}".
447
448 udev 082
449 ========
450 The udev man page has moved to udev(7) as it does not describe a command
451 anymore. The programs udev, udevstart and udevsend are no longer installed
452 by default and must be copied manually, if they should be installed or
453 included in a package.
454
455 Fix a bug where "ignore_device" could run earlier collected RUN keys before
456 the ignore rule was applied.
457
458 More preparation for future sysfs changes. usb_id and scsi_id no longer
459 depend on a magic order of devices in the /devices chain. Specific devices
460 should be requested by their subsytem.
461
462 This will always find the scsi parent device without depending on a specific
463 path position:
464   dev = sysfs_device_get(devpath);
465   dev_usb = sysfs_device_get_parent_with_subsystem(dev, "scsi");
466
467 The "device" link in the current sysfs layout will be automatically
468 _resolved_ as a parent and in the new sysfs layout it will just _be_ the
469 parent in the devpath. If a device is requested by it's symlink, like all
470 class devices in the new sysfs layout will look like, it gets automatically
471 resolved and substituted with the real devpath and not the symlink path.
472
473 Note:
474 A similar logic must be applied to _all_ sysfs users, including
475 scripts, that search along parent devices in sysfs. The explicit use of
476 the "device" link must be avoided. With the future sysfs layout all
477 DEVPATH's will start with /devices/ and have a "subsystem" symlink poiting
478 back to the "class" or the "bus". The layout of the parent devices in
479 /devices is not necessarily expected to be stable across kernel releases and
480 searching for parents by their subsystem should make sysfs users tolerant
481 for changed parent chains.
482
483 udev 081
484 ========
485 Prepare udev to work with the experimental kernel patch, that moves
486 /sys/class devices to /sys/devices and /sys/block to /sys/class/block.
487
488 Clarify BUS, ID, $id usage and fix $id behavior. This prepares for
489 moving the class devices to /sys/devices.
490
491 Thanks again to Marco for help finding a hopefully nice compromise
492 to make %b simpler and working again.
493
494 udev 080
495 ========
496 Complete removal of libsysfs, replaced by simple helper functions
497 which are much simpler and a bit faster. The udev daemon operatesentirely
498 on event parameters and does not use sysfs for simple rules anymore.
499 Please report any new bugs/problems, that may be caused by this big
500 change. They will be fixed immediately.
501
502 The enumeration format character '%e' is deprecated and will be
503 removed sometimes from a future udev version. It never worked correctly
504 outside of udevstart, so we can't use it with the new parallel
505 coldplug. A simple enumeration is as useless as the devfs naming
506 scheme, just get rid of both if you still use it.
507
508 MODALIAS and $modalias is not needed and will be removed from one of
509 the next udev versions, replace it in all rules with ENV{MODALIAS} or
510 the sysfs "modalias" value.
511
512 Thanks a lot to Marco for all his help on finding and fixing bugs.
513
514 udev 079
515 ========
516 Let scsi_id request libata drive serial numbers from page 0x80.
517
518 Renamed etc/udev/persistent.rules to persistent-disk.rules and
519 added /dev/disk/by-name/* for device mapper device names.
520
521 Removed %e from the man page. It never worked reliably outside
522 of udevstart and udevstart is no longer recommended to use.
523
524 udev 078
525 ========
526 Symlinks are now exported to the event environment. Hopefully it's no
527 longer needed to run udevinfo from an event process, like it was
528 mentioned on the hotplug list:
529   UDEV  [1134776873.702967] add@/block/sdb
530   ...
531   DEVNAME=/dev/sdb
532   DEVLINKS=/dev/disk/by-id/usb-IBM_Memory_Key_0218B301030027E8 /dev/disk/by-path/usb-0218B301030027E8:0:0:0
533
534 udev 077
535 ========
536 Fix a problem if udevsend is used as the hotplug handler and tries to use
537 syslog, which causes a "vc" event loop. 2.6.15 will make udevsend obsolete
538 and this kind of problems will hopefully go away soon.
539
540 udev 076
541 ========
542 All built-in logic to work around bad sysfs timing is removed with this
543 version. The need to wait for sysfs files is almost fixed with a kernel
544 version that doesn't work with this udev version anyway. Until we fix
545 the timing of the "bus" link creation, the former integrated logic should
546 be emulated by a rule placed before all other rules:
547   ACTION=="add", DEVPATH=="/devices/*", ENV{PHYSDEVBUS}=="?*", WAIT_FOR_SYSFS="bus"
548
549 The option "udev_db" does no longer exist. All udev state will be in
550 /$udev_root/.udev/ now, there is no longer an option to set this
551 to anything else.
552 If the init script or something else used this value, just depend on
553 this hardcoded path. But remember _all_content_ of this directory is
554 still private to udev and can change at any time.
555
556 Default location for rule sripts and helper programs is now: /lib/udev/.
557 Everything that is not useful on the commandline should go into this
558 directory. Some of the helpers in the extras folder are installed there
559 now. The rules need to be changed, to find the helpers there.
560
561 Also /lib/udev/devices is recommended as a directory where packages or
562 the user can place real device nodes, which get copied over to /dev at
563 every boot. This should replace the various solutions with custom config
564 files.
565
566 Udevsend does no longer start the udev daemon. This must be done with
567 the init script that prepares /dev on tmpfs and creates the initial nodes,
568 before starting the daemon.
569
570 udev 075
571 ========
572 Silent a too verbose error logging for the old hotplug.d/ dev.d/
573 emulation.
574
575 The copy of klibc is removed. A systemwide installed version of klibc
576 should be used to build a klibc udev now.
577
578 udev 074
579 ========
580 NAME="" will not create any nodes, but execute RUN keys. To completely
581 ignore an event the OPTION "ignore_device" should be used.
582
583 After removal of the reorder queue, events with a TIMEOUT can be executed
584 without any queuing now.
585
586 udev 073
587 ========
588 Fixed bug in udevd, if inotify is not available. We depend on netlink
589 uevents now, kernels without that event source will not work with that
590 version of udev anymore.
591
592 udev 072
593 ========
594 The rule parsing happens now in the daemon once at startup, all udev
595 event processes inherit the already parsed rules from the daemon.
596 It is shipped with SUSE10.0 and reduces heavily the system load at
597 startup. The option to save precompiled rules and let the udev process
598 pick the them up is removed, as it's no longer needed.
599
600 Kernel 2.6.15 will have symlinks at /class/input pointing to the real
601 device. Libsysfs is changed to "translate" the requested link into the
602 real device path, as it would happen with the hotplug event. Otherwise
603 device removal and the udev database will not work.
604
605 Using 'make STRIPCMD=' will leave the binaries unstripped for debugging
606 and packaging.
607
608 A few improvements for vol_id, the filesytem probing code.
609
610 udev 071
611 ========
612 Fix a stupid typo in extras/run_directory for "make install".
613
614 scsi_id creates the temporary devnode now in /dev for usage with a
615 non-writable /tmp directory.
616
617 The uevent kernel socket buffer can carry app. 50.000 events now,
618 let's see who can break this again. :)
619
620 The upcoming kernel will have a new input driver core integration.
621 Some class devices are now symlinks to the real device. libsysfs
622 needs a fix for this to work correctly. Udevstart of older udev
623 versions will _not_ create these devices!
624
625 udev 070
626 ========
627 Fix a 'install' target in the Makefile, that prevents EXTRAS from
628 beeing installed.
629
630 udev 069
631 ========
632 A bunch of mostly trivial bugfixes. From now on no node name or
633 symlink name can contain any character than plain whitelisted ascii
634 characters or validated utf8 byte-streams. This is needed for the
635 /dev/disk/by-label/* links, because we import untrusted data and
636 export it to the filesystem.
637
638 udev 068
639 ========
640 More bugfixes. If udevd was started from the kernel, we don't
641 have stdin/stdout/stderr, which broke the forked tools in some
642 situations.
643
644 udev 067
645 ========
646 Bugfix. udevstart event ordering was broken for a long time.
647 The new run_program() uncovered it, because /dev/null was not
648 available while we try to run external programs.
649 Now udevstart should create it before we run anything.
650
651 udev 066
652 ========
653 Minor bugfixes and some distro rules updates. If you don't have the
654 persistent disk rules in /dev/disk/by-*/* on your distro, just
655 grab it from here. :)
656
657 udev 065
658 ========
659 We can use socket communication now to pass events from udev to
660 other programs:
661   RUN+="socket:/org/freedesktop/hal/udev_event"
662 will pass the whole udev event to the HAL daemon without the need
663 for a forked helper. (See ChangeLog for udevmonitor, as an example)
664
665 udev 064
666 ========
667 Mostly bugfixes and see ChangeLog.
668
669 The test for the existence of an environment value should be
670 switched from:
671   ENV{KEY}=="*" to ENV{KEY}=="?*"
672 because "*" will not fail anymore, if the key does not exist or
673 is empty.
674
675 udev 063
676 ========
677 Bugfixes and a few tweaks described in the ChangeLog.
678
679 udev 062
680 ========
681 Mostly a Bugfix release.
682
683 Added WAIT_FOR_SYSFS="<attribute>" to be able to fight against the sysfs
684 timing with custom rules.
685
686 udev 061
687 ========
688 We changed the  internal rule storage format. Our large rule files took
689 2 MB of RAM, with the change we are down to 99kB.
690
691 If the device-node has been created with default name and no symlink or
692 options are to remenber, it is not longer stored in the udevdb. HAL will
693 need to be updated to work correctly with that change.
694
695 To overrride optimization flags, OPTFLAGS may be used now.
696
697 udev 060
698 ========
699 Bugfix release.
700
701 udev 059
702 ========
703 Major changes happened with this release. The goal is to take over the
704 complete kernel-event handling and provide a more efficient way to dispatch
705 kernel events. Replacing most of the current shell script logic and the
706 kernel forked helper with a netlink-daemon and a rule-based event handling.
707
708 o udevd listens to netlink events now. The first valid netlink event
709   will make udevd ignore any message from udevsend that contains a
710   SEQNUM, to avoid duplicate events. The forked events can be disabled
711   with:
712     echo "" > /proc/sys/kernel/hotplug
713   For full support, the broken input-subsytem needs to be fixed, not to
714   bypass the driver core.
715
716 o /etc/dev.d/ + /etc/hotplug.d/ directory multiplexing is completely
717   removed from udev itself and must be emulated by calling small
718   helper binaries provided in the extras folder:
719     make EXTRAS=extras/run_directory/
720   will build udev_run_devd and udev_run_hotplugd, which can be called
721   from a rule if needed:
722     RUN+="/sbin/udev_run_hotplugd"
723   The recommended way to handle this is to convert all the calls from
724   the directories to explicit udev rules and get completely rid of the
725   multiplexing. (To catch a ttyUSB event, you now no longer need to
726   fork and exit 300 tty script instances you are not interested in, it
727   is just one rule that matches exactly the device.)
728
729 o udev handles now _all_ events not just events for class and block
730   devices, this way it is possible to control the complete event
731   behavior with udev rules. Especially useful for rules like:
732     ACTION="add", DEVPATH="/devices/*", MODALIAS=="?*", RUN+="/sbin/modprobe $modalias"
733
734 o As used in the modalias rule, udev supports now textual
735   substitution placeholder along with the usual format chars. This
736   needs to be documented, for now it's only visible in udev_rules_parse.c.
737
738 o The rule keys support now more operations. This is documented in the
739   man page. It is possible to add values to list-keys like the SYMLINK
740   and RUN list with KEY+="value" and to clear the list by assigning KEY="".
741   Also "final"-assignments are supported by using KEY:="value", which will
742   prevent changing the key by any later rule.
743
744 o kernel 2.6.12 has the "detached_state" attribute removed from
745   sysfs, which was used to recognize sysfs population. We switched that
746   to wait for the "bus" link, which is only available in kernels after 2.6.11.
747   Running this udev version on older kernels may cause a short delay for
748   some events.
749
750 o To provide infrastructure for persistent device naming, the id programs:
751   scsi_id, vol_id (former udev_volume_id), and ata_id (new) are able now
752   to export the probed data in environment key format:
753     pim:~ # /sbin/ata_id --export /dev/hda
754     ID_MODEL=HTS726060M9AT00
755     ID_SERIAL=MRH401M4G6UM9B
756     ID_REVISION=MH4OA6BA
757
758   The following rules:
759     KERNEL="hd*[!0-9]", IMPORT="/sbin/ata_id --export $tempnode"
760     KERNEL="hd*[!0-9]", ENV{ID_SERIAL}=="?*", SYMLINK+="disk/by-id/$env{ID_MODEL}_$env{ID_SERIAL}"
761
762   Will create:
763     kay@pim:~> tree /dev/disk
764     /dev/disk
765     |-- by-id
766     |   |-- HTS726060M9AT00_MRH401M4G6UM9B -> ../../hda
767     |   `-- IBM-Memory_Key -> ../../sda
768     |-- by-label
769     |   |-- swap -> ../../hda1
770     |   |-- date -> ../../sda1
771     |   `-- home -> ../../hda3
772     `-- by-uuid
773         |-- 2E08712B0870F2E7 -> ../../hda3
774         |-- 9352cfef-7687-47bc-a2a3-34cf136f72e1 -> ../../hda1
775         |-- E845-7A89 -> ../../sda1
776         `-- b2a61681-3812-4f13-a4ff-920d70604299 -> ../../hda2
777
778   The IMPORT= operation will import these keys in the environment and make
779   it available for later PROGRAM= and RUN= executed programs. The keys are
780   also stored in the udevdb and can be queried from there with one of the
781   next udev versions.
782
783 o A few binaries are silently added to the repository, which can be used
784   to replay kernel events from initramfs instead of using coldplug. udevd
785   can be instructed now to queue-up events while the stored events from
786   initramfs are filled into the udevd-queue. This code is still under
787   development and there is no documentation now besides the code itself.
788   The additional binaries get compiled, but are not installed by default.
789
790 o There is also a temporary fix for a performance problem where too many
791   events happen in parallel and every event needs to parse the rules.
792   udev can now read precompiled rules stored on disk. This is likely to be
793   replaced by a more elegant solution in a future udev version.
794
795 udev 058
796 ========
797 With kernel version 2.6.12, the sysfs file "detached_state" was removed.
798 Fix for libsysfs not to expect this file was added.
799
800 udev 057
801 ========
802 All rules are applied now, but only the first matching rule with a NAME-key
803 will be applied. All later rules with NAME-key are completely ignored. This
804 way system supplied symlinks or permissions gets applied to user-defined
805 naming rules.
806
807 Note:
808 Please check your rules setup, if you may need to add OPTIONS="last_rule"
809 to some rules, to keep the old behavior.
810
811 The rules are read on "remove"-events too. That makes is possible to match
812 with keys that are available on remove (KERNEL, SUBSYSTEM, ID, ENV, ...) to
813 instruct udev to ignore an event (OPTIONS="ignore_device").
814 The new ACTION-key may be used to let a rule act only at a "remove"-event.
815
816 The new RUN-key supports rule-based execution of programs after device-node
817 handling. This is meant as a general replacement for the dev.d/-directories
818 to give fine grained control over the execution of programs.
819
820 The %s{}-sysfs format char replacement values are searched at any of the
821 devices in the device chain now, not only at the class-device.
822
823 We support log priority levels now. The value udev_log in udev.conf is used
824 to determine what is printed to syslog. This makes it possible to
825 run a version with compiled-in debug messages in a production environment
826 which is sometimes needed to find a bug.
827 It is still possible to supress the inclusion of _any_ syslog usage with
828 USE_LOG=false to create the smallest possible binaries if needed.
829 The configured udev_log value can be overridden with the environment variable
830 UDEV_LOG.
831
832 udev 056
833 ========
834 Possible use of a system-wide klibc:
835   make USE_KLIBC=true KLCC=/usr/bin/klcc all
836 will link against an external klibc and our own version will be ignored.
837
838 udev 055
839 ========
840 We support an unlimited count of symlinks now.
841
842 If USE_STATIC=true is passed to a glibc build, we link statically and use
843 a built-in userdb parser to resolve user and group names.
844
845 The PLACE= key is gone. It can be replaced by an ID= for a long time, because
846 we walk up the chain of physical devices to find a match.
847
848 The KEY="<value>" format supports '=', '==', '!=,' , '+=' now. This makes it
849 easy to skip certain attribute matches without composing rules with weird
850 character class negations like:
851   KERNEL="[!s][!c][!d]*"
852 this can now be replaced with:
853   KERNEL!="scd*"
854 The current simple '=' is still supported, and should work as it does today,
855 but existing rules should be converted if possible, to be better readable.
856
857 We have new ENV{}== key now, to match against a maximum of 5 environment
858 variables.
859
860 udevstart is its own binary again, because we don't need co carry this araound
861 with every forked event.