man: document tty-ask-password-agent

[elogind.git] / man / udev.xml

diff --git a/man/udev.xml b/man/udev.xml
index 168b1dc1501e84c708041c394bc20eee81ceeb5c..b5c7cd4be44e4012b25d8b22585e0e271fc16edb 100644 (file)
--- a/man/udev.xml
+++ b/man/udev.xml
@@ -41,7 +41,7 @@
     names provide a way to reliably identify devices based on their properties or
     current configuration.</para>
 
-    <para>The udev daemon, <citerefentry><refentrytitle>udevd</refentrytitle>
+    <para>The udev daemon, <citerefentry><refentrytitle>systemd-udevd.service</refentrytitle>
     <manvolnum>8</manvolnum></citerefentry>, receives device uevents directly from
     the kernel whenever a device is added or removed from the system, or it changes its
     state. When udev receives a device event, it matches its configured set of rules
@@ -64,14 +64,6 @@
       It consists of a set of variables allowing the user to override default udev values.
       The following variables can be set:</para>
       <variablelist>
-        <varlistentry>
-          <term><option>udev_root</option></term>
-          <listitem>
-            <para>Specifies where to place the device nodes in the filesystem.
-            The default value is <filename>/dev</filename>.</para>
-          </listitem>
-        </varlistentry>
-
         <varlistentry>
           <term><option>udev_log</option></term>
           <listitem>
@@ -287,6 +279,8 @@
             successfully. The device properties are made available to the
             executed program in the environment. The program's stdout
             is available in the RESULT key.</para>
+            <para>This can only be used for very short-running foreground tasks. For details
+            see <option>RUN</option>.</para>
           </listitem>
         </varlistentry>
 
@@ -401,10 +395,12 @@
             /usr/lib/udev, otherwise the absolute path must be specified. The program
             name and following arguments are separated by spaces. Single quotes can
             be used to specify arguments with spaces.</para>
-            <para>This can only be used for very short running tasks. Running an
+            <para>This can only be used for very short-running foreground tasks. Running an
             event process for a long period of time may block all further events for
-            this or a dependent device. Starting daemons or other long running processes
-            is not appropriate for udev.</para>
+            this or a dependent device.</para>
+            <para>Starting daemons or other long running processes is not appropriate
+            for udev; the forked processes, detached or not, will be unconditionally
+            killed after the event handling has finished.</para>
           </listitem>
         </varlistentry>
 
@@ -470,6 +466,8 @@
                 </listitem>
               </varlistentry>
             </variablelist>
+            <para>This can only be used for very short-running foreground tasks. For details
+            see <option>RUN</option>.</para>
           </listitem>
         </varlistentry>
 
@@ -513,10 +511,9 @@
                 <term><option>static_node=</option></term>
                 <listitem>
                   <para>Apply the permissions specified in this rule to the static device node with
-                  the specified name. Static device nodes might be provided by kernel modules
-                  or copied from <filename>/usr/lib/udev/devices</filename>. These nodes might not have
-                  a corresponding kernel device at the time udevd is started; they can trigger
-                  automatic kernel module loading.</para>
+                  the specified name. Static device node creation can be requested by kernel modules.
+                  These nodes might not have a corresponding kernel device at the time systemd-udevd is
+                  started; they can trigger automatic kernel module loading.</para>
                 </listitem>
               </varlistentry>
               <varlistentry>
@@ -694,7 +691,7 @@
   <refsect1>
     <title>See Also</title>
     <para><citerefentry>
-        <refentrytitle>udevd</refentrytitle><manvolnum>8</manvolnum>
+        <refentrytitle>systemd-udevd.service</refentrytitle><manvolnum>8</manvolnum>
       </citerefentry>,
       <citerefentry>
         <refentrytitle>udevadm</refentrytitle><manvolnum>8</manvolnum>