man/systemd-udevd.xml

   1 <?xml version='1.0'?>
   2 <?xml-stylesheet type="text/xsl" href="http://docbook.sourceforge.net/release/xsl/current/xhtml/docbook.xsl"?>
   3 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
   4   "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
   5
   6 <refentry id="systemd-udevd">
   7   <refentryinfo>
   8     <title>udevd</title>
   9     <productname>systemd</productname>
  10     <authorgroup>
  11       <author>
  12         <contrib>Developer</contrib>
  13         <firstname>Kay</firstname>
  14         <surname>Sievers</surname>
  15         <email>kay@vrfy.org</email>
  16       </author>
  17     </authorgroup>
  18   </refentryinfo>
  19
  20   <refmeta>
  21     <refentrytitle>systemd-udevd</refentrytitle>
  22     <manvolnum>8</manvolnum>
  23     <refmiscinfo class="version"></refmiscinfo>
  24   </refmeta>
  25
  26   <refnamediv>
  27     <refname>systemd-udevd</refname><refpurpose>event managing daemon</refpurpose>
  28   </refnamediv>
  29
  30   <refsynopsisdiv>
  31     <cmdsynopsis>
  32       <command>systemd-udevd</command>
  33       <arg><option>--daemon</option></arg>
  34       <arg><option>--debug</option></arg>
  35       <arg><option>--children-max=</option></arg>
  36       <arg><option>--exec-delay=</option></arg>
  37       <arg><option>--resolve-names=early|late|never</option></arg>
  38       <arg><option>--version</option></arg>
  39       <arg><option>--help</option></arg>
  40     </cmdsynopsis>
  41   </refsynopsisdiv>
  42
  43   <refsect1><title>Description</title>
  44     <para>systemd-udevd listens to kernel uevents. For every event, systemd-udevd executes matching
  45     instructions specified in udev rules. See <citerefentry>
  46         <refentrytitle>udev</refentrytitle><manvolnum>7</manvolnum>
  47       </citerefentry>.</para>
  48     <para>The behavior of the running daemon can be changed with
  49     <command>udevadm control</command>.</para>
  50   </refsect1>
  51
  52   <refsect1><title>Options</title>
  53     <variablelist>
  54       <varlistentry>
  55         <term><option>--daemon</option></term>
  56         <listitem>
  57           <para>Detach and run in the background.</para>
  58         </listitem>
  59       </varlistentry>
  60       <varlistentry>
  61         <term><option>--debug</option></term>
  62         <listitem>
  63           <para>Print debug messages to stderr.</para>
  64         </listitem>
  65       </varlistentry>
  66       <varlistentry>
  67         <term><option>--children-max=</option></term>
  68         <listitem>
  69           <para>Limit the number of parallel executed events.</para>
  70         </listitem>
  71       </varlistentry>
  72       <varlistentry>
  73         <term><option>--exec-delay=</option></term>
  74         <listitem>
  75           <para>Number of seconds to delay the execution of RUN instructions.
  76           This might be useful when debugging system crashes during coldplug
  77           cause by loading non-working kernel modules.</para>
  78         </listitem>
  79       </varlistentry>
  80       <varlistentry>
  81         <term><option>--resolve-names=</option></term>
  82         <listitem>
  83           <para>Specify when systemd-udevd should resolve names of users and groups.
  84           When set to <option>early</option> (the default) names will be
  85           resolved when the rules are parsed.  When set to
  86           <option>late</option> names will be resolved for every event.
  87           When set to <option>never</option> names will never be resolved
  88           and all devices will be owned by root.</para>
  89         </listitem>
  90       </varlistentry>
  91       <varlistentry>
  92         <term><option>--version</option></term>
  93         <listitem>
  94           <para>Print version number.</para>
  95         </listitem>
  96       </varlistentry>
  97       <varlistentry>
  98         <term><option>--help</option></term>
  99         <listitem>
 100           <para>Print help text.</para>
 101         </listitem>
 102       </varlistentry>
 103     </variablelist>
 104   </refsect1>
 105
 106   <refsect1><title>Environment</title>
 107     <variablelist>
 108       <varlistentry>
 109         <term><varname>UDEV_LOG=</varname></term>
 110         <listitem>
 111           <para>Set the logging priority.</para>
 112         </listitem>
 113       </varlistentry>
 114     </variablelist>
 115  </refsect1>
 116
 117   <refsect1><title>Kernel command line</title>
 118     <variablelist>
 119       <para>The parameters starting with "rd.", will be read when udev is used in an initrd.</para>
 120       <varlistentry>
 121         <term><varname>udev.log-priority=</varname></term>
 122         <term><varname>rd.udev.log-priority=</varname></term>
 123         <listitem>
 124           <para>Set the logging priority.</para>
 125         </listitem>
 126       </varlistentry>
 127       <varlistentry>
 128         <term><varname>udev.children-max=</varname></term>
 129         <term><varname>rd.udev.children-max=</varname></term>
 130         <listitem>
 131           <para>Limit the number of parallel executed events.</para>
 132         </listitem>
 133       </varlistentry>
 134       <varlistentry>
 135         <term><varname>udev.exec-delay=</varname></term>
 136         <term><varname>rd.udev.exec-delay=</varname></term>
 137         <listitem>
 138           <para>Number of seconds to delay the execution of RUN instructions.
 139           This might be useful when debugging system crashes during coldplug
 140           cause by loading non-working kernel modules.</para>
 141         </listitem>
 142       </varlistentry>
 143     </variablelist>
 144  </refsect1>
 145
 146   <refsect1>
 147     <title>See Also</title>
 148     <para><citerefentry>
 149         <refentrytitle>udev</refentrytitle><manvolnum>7</manvolnum>
 150       </citerefentry>, <citerefentry>
 151         <refentrytitle>udevadm</refentrytitle><manvolnum>8</manvolnum>
 152     </citerefentry></para>
 153   </refsect1>
 154 </refentry>