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