man: add static device nodes and udevd debug options

diff --git a/udev/udev.xml b/udev/udev.xml
index adf531b372e6146c9fb07353911084c6e55fdece..c517766f97ee78c6911c6ee018c61d305646b8b3 100644 (file)
--- a/udev/udev.xml
+++ b/udev/udev.xml
@@ -489,6 +489,16 @@
                   with this option.</para>
                 </listitem>
               </varlistentry>
                   with this option.</para>
                 </listitem>
               </varlistentry>

+              <varlistentry>
+                <term><option>static_node=</option></term>
+                <listitem>
+                  <para>Apply the permissions specified in this rule to a static device node with
+                  the specified name. Static device nodes might be provided by kernel modules,
+                  or copied from <filename>/lib/udev/devices</filename>. These nodes might not have
+                  a corresponding kernel device at the time udevd is started, and allow to trigger
+                  automatic kernel module on-demand loading.</para>
+                </listitem>
+              </varlistentry>

               <varlistentry>
                 <term><option>watch</option></term>
                 <listitem>
               <varlistentry>
                 <term><option>watch</option></term>
                 <listitem>

diff --git a/udev/udevd.xml b/udev/udevd.xml
index 8e7755a6ff61173bda15755fda5a631522a71066..02a6543235f99819bf42c0e91931a263adfdefd6 100644 (file)
--- a/udev/udevd.xml
+++ b/udev/udevd.xml
@@ -23,19 +23,23 @@
     <cmdsynopsis>
       <command>udevd</command>
       <arg><option>--daemon</option></arg>
     <cmdsynopsis>
       <command>udevd</command>
       <arg><option>--daemon</option></arg>

-      <arg><option>--children-max</option></arg>

       <arg><option>--debug</option></arg>
       <arg><option>--debug</option></arg>

-      <arg><option>--version</option></arg>
+      <arg><option>--children-max=</option></arg>
+      <arg><option>--exec-delay=</option></arg>

       <arg><option>--resolve-names=early|late|never</option></arg>
       <arg><option>--resolve-names=early|late|never</option></arg>

+      <arg><option>--version</option></arg>

       <arg><option>--help</option></arg>
     </cmdsynopsis>
   </refsynopsisdiv>
 
   <refsect1><title>Description</title>
       <arg><option>--help</option></arg>
     </cmdsynopsis>
   </refsynopsisdiv>
 
   <refsect1><title>Description</title>

-    <para>udevd listens to kernel uevents and passes the incoming events to
-    udev. It ensures the correct event order and takes care, that events for child
-    devices are delayed until the parent event has finished the device handling.
-    The behavior of the running daemon can be changed with
+    <para>udevd listens to kernel uevents and executes the instructions specified
+    in rules. On startup the content of the directory
+    <filename>/lib/udev/devices</filename> is copied to <filename>/dev</filename>.
+    If kernel modules specify static device nodes, these nodes are created
+    even wihtout a corresponding kernel device, to allow on-demand loading of kernel
+    modules. Matching permissions specified in udev rules are applied to these
+    static device nodes. The behavior of the running daemon can be changed with

     <command>udevadm control</command>.</para>
   </refsect1>
 
     <command>udevadm control</command>.</para>
   </refsect1>
 


@@ -48,20 +52,28 @@
         </listitem>
       </varlistentry>
       <varlistentry>
         </listitem>
       </varlistentry>
       <varlistentry>

-        <term><option>--children-max</option></term>
+        <term><option>--debug</option></term>
+        <listitem>
+          <para>Print debug messages to stderr.</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--children-max=</option></term>

         <listitem>
           <para>Limit the number of parallel executed events.
           </para>
         </listitem>
       </varlistentry>
       <varlistentry>
         <listitem>
           <para>Limit the number of parallel executed events.
           </para>
         </listitem>
       </varlistentry>
       <varlistentry>

-        <term><option>--debug</option></term>
+        <term><option>--exec-delay=</option></term>

         <listitem>
         <listitem>

-          <para>Print debug messages to stderr.</para>
+          <para>Number of seconds to delay the execution of RUN instructions.
+          This might be useful when debugging system crashes during coldplug
+          cause by loading non-working kernel modules.</para>

         </listitem>
       </varlistentry>
       <varlistentry>
         </listitem>
       </varlistentry>
       <varlistentry>

-        <term><option>--resolve-names</option></term>
+        <term><option>--resolve-names=</option></term>

         <listitem>
           <para>Specify when udevd should resolve names of users and groups.
           When set to <option>early</option> (the default) names will be
         <listitem>
           <para>Specify when udevd should resolve names of users and groups.
           When set to <option>early</option> (the default) names will be