From: Kay Sievers <kay.sievers@vrfy.org>
Date: Fri, 28 May 2010 13:11:36 +0000 (+0200)
Subject: man: add static device nodes and udevd debug options
X-Git-Tag: 174~465
X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=commitdiff_plain;h=9fa68615bb0315501625c6cde3f3077257c740e7;p=elogind.git

man: add static device nodes and udevd debug options
---

diff --git a/udev/udev.xml b/udev/udev.xml
index adf531b37..c517766f9 100644
--- a/udev/udev.xml
+++ b/udev/udev.xml
@@ -489,6 +489,16 @@
                   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>
diff --git a/udev/udevd.xml b/udev/udevd.xml
index 8e7755a6f..02a654323 100644
--- a/udev/udevd.xml
+++ b/udev/udevd.xml
@@ -23,19 +23,23 @@
     <cmdsynopsis>
       <command>udevd</command>
       <arg><option>--daemon</option></arg>
-      <arg><option>--children-max</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>--version</option></arg>
       <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>
 
@@ -48,20 +52,28 @@
         </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>
-        <term><option>--debug</option></term>
+        <term><option>--exec-delay=</option></term>
         <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>
-        <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