[PATCH] put netdev handling and dev.d/ in manpages

[Kay Sievers <kay.sievers@vrfy.org>]

[-- Attachment #1: Type: text/plain, Size: 101 bytes --]

Mention the recently added netdev handling and the dev.d/ directories
in the man pages.

thanks,
Kay

[-- Attachment #2: 01-man-netdev.patch --]
[-- Type: text/plain, Size: 5157 bytes --]

===== udev.8 1.54 vs edited =====
--- 1.54/udev.8	Fri Mar 12 21:32:42 2004
+++ edited/udev.8	Fri Apr  2 00:21:34 2004
@@ -23,14 +23,25 @@
 .B UDEV_NO_SLEEP
 The default behavior of
 .B udev
-is to wait until all the sysfs files of the device chain are populated. If set
+is to wait until all the sysfs files of the device chain are populated. If set,
 .B udev
 will continue, regardless of the state of the device representation.
+.TP
+.B UDEV_NO_DEVD
+The default behavior of
+.B udev
+is to execute programs in the
+.I /etc/dev.d/
+directory after device handling. If set,
+.B udev
+will skip this step.
 .SH "DESCRIPTION"
 .B udev
-creates or removes device node files usually located in the /dev directory.
-It provides a dynamic device directory contaning only the files for
-actually present devices.
+provides a dynamic device directory containing only the files for actually
+present devices. It creates or removes device node files usually located in
+the /dev directory, or it renames network interfaces.
+.br
+
 .P
 As part of the
 .B hotplug
@@ -42,7 +53,7 @@
 reads the sysfs directory of the given device to collect device attributes
 like label, serial number or bus device number.
 These attributes may be used as keys to determine a
-unique name for device file creation.
+unique name for the device.
 .B udev
 maintains a database for devices present on the system.
 .br
@@ -88,8 +99,8 @@
 and all permission files are read in lexical order.
 .TP
 .B udev_log
-If you want udev to log some information to the syslog for every node created or
-removed. The default value is
+If you want udev to log some information to the syslog for every device handled.
+The default value is
 .IR yes .
 .TP
 .B default_mode
@@ -149,9 +160,9 @@
 file.
 .P
 Every line in the rules file defines the mapping between device attributes
-and the device file name. One or more keys are specified to match a rule
-with the current device. If all keys are matching, the rule will be applied
-and the name is used for the device node.
+and the device name. One or more keys are specified to match a rule with
+the current device. If all keys are matching, the rule will be applied and
+the name is used to name the device file or the network interface.
 .br
 If no matching rule is found, the default kernel device name is used.
 .P
@@ -200,7 +211,8 @@
 call.
 .TP
 .B NAME
-The name of the node to be created.
+The name of the node to be created, or the name, the network interface
+should be renamed to.
 .br
 If given with the attribute
 .BR NAME{ all_partitions }
@@ -341,11 +353,33 @@
 supported within this match with the '\-' character.  For example, to match on
 the range of all digits, the pattern [0\-9] would be used. If the first character
 following the '[' is a '!', any character not enclosed is matched.
+.P
+After device node creation, removal, or network device renaming,
+.B udev
+executes the programs in the directory tree under
+.IR /etc/dev.d/ .
+The name of a program must end with
+.I .dev
+suffix, to be recognized.
+.br
+In addition to the hotplug environment variables,
+.B DEVNAME
+is exported to make the name of the created node, or the name the network
+device is renamed to, available to the executed program. The programs in every
+directory are sorted in lexical order, while the directories are searched in
+the following order:
+.sp
+.nf
+/etc/dev.d/$(DEVNAME)/*.dev
+/etc/dev.d/$(SUBSYSTEM)/*.dev
+/etc/dev.d/default/*.dev
+.fi
 .SH "FILES"
 .nf
 /sbin/udev                           udev program
 /etc/udev/*                          udev config files
 /etc/hotplug.d/default/udev.hotplug  hotplug symlink to udev program
+/etc/dev.d/*                         programs invoked by udev
 .fi
 .LP
 .SH "SEE ALSO"
===== udevinfo.8 1.9 vs edited =====
--- 1.9/udevinfo.8	Sat Mar  6 05:02:07 2004
+++ edited/udevinfo.8	Fri Apr  2 00:07:42 2004
@@ -24,7 +24,8 @@
 will be prepended.
 .TP
 .BI \-q " query_type"
-Query the database for specified value of a created device node.
+Query the database for specified value of a created device node or network
+interface.
 .RB Needs " \-p " or " \-n " specified.
 .br
 Valid types are:
@@ -34,9 +35,9 @@
 Specify the sysfs path of the device to query.
 .TP
 .BI \-n " name"
-Specify the name of the node or the symlink for the device to query.
-Partition names generated with the NAME{all_partitons} option can not be
-queried, the main device must be used instead.
+Specify the name of the node, the symlink or the network interface for the
+device to query. Partition names generated with the NAME{all_partitons} option
+can not be queried, the main device must be used instead.
 .TP
 .B \-a
 Print all
===== udevtest.8 1.1 vs edited =====
--- 1.1/udevtest.8	Sat Mar 13 02:25:21 2004
+++ edited/udevtest.8	Fri Apr  2 00:18:06 2004
@@ -7,8 +7,9 @@
 .B udevtest
 simulates a
 .B udev
-run for the given device, and prints out the node names
-for the given device, the real udev would have created.
+run for the given device, and prints out the name of the node
+the real udev would have created, or the name of the renamed network
+interface.
 .SH "SEE ALSO"
 .BR udev (8)
 .SH AUTHORS