udev/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="udevd">
   7   <refentryinfo>
   8     <title>udevd</title>
   9     <productname>udev</productname>
  10   </refentryinfo>
  11
  12   <refmeta>
  13     <refentrytitle>udevd</refentrytitle>
  14     <manvolnum>8</manvolnum>
  15     <refmiscinfo class="version"></refmiscinfo>
  16   </refmeta>
  17
  18   <refnamediv>
  19     <refname>udevd</refname><refpurpose>event managing daemon</refpurpose>
  20   </refnamediv>
  21
  22   <refsynopsisdiv>
  23     <cmdsynopsis>
  24       <command>udevd</command>
  25       <arg><option>--daemon</option></arg>
  26       <arg><option>--debug</option></arg>
  27       <arg><option>--children-max=</option></arg>
  28       <arg><option>--exec-delay=</option></arg>
  29       <arg><option>--resolve-names=early|late|never</option></arg>
  30       <arg><option>--version</option></arg>
  31       <arg><option>--help</option></arg>
  32     </cmdsynopsis>
  33   </refsynopsisdiv>
  34
  35   <refsect1><title>Description</title>
  36     <para>udevd listens to kernel uevents and executes the instructions specified
  37     in rules. On startup the content of the directory
  38     <filename>/lib/udev/devices</filename> is copied to <filename>/dev</filename>.
  39     If kernel modules specify static device nodes, these nodes are created
  40     even wihtout a corresponding kernel device, to allow on-demand loading of kernel
  41     modules. Matching permissions specified in udev rules are applied to these
  42     static device nodes. The behavior of the running daemon can be changed with
  43     <command>udevadm control</command>.</para>
  44   </refsect1>
  45
  46   <refsect1><title>Options</title>
  47     <variablelist>
  48       <varlistentry>
  49         <term><option>--daemon</option></term>
  50         <listitem>
  51           <para>Detach and run in the background.</para>
  52         </listitem>
  53       </varlistentry>
  54       <varlistentry>
  55         <term><option>--debug</option></term>
  56         <listitem>
  57           <para>Print debug messages to stderr.</para>
  58         </listitem>
  59       </varlistentry>
  60       <varlistentry>
  61         <term><option>--children-max=</option></term>
  62         <listitem>
  63           <para>Limit the number of parallel executed events.</para>
  64         </listitem>
  65       </varlistentry>
  66       <varlistentry>
  67         <term><option>--exec-delay=</option></term>
  68         <listitem>
  69           <para>Number of seconds to delay the execution of RUN instructions.
  70           This might be useful when debugging system crashes during coldplug
  71           cause by loading non-working kernel modules.</para>
  72         </listitem>
  73       </varlistentry>
  74       <varlistentry>
  75         <term><option>--resolve-names=</option></term>
  76         <listitem>
  77           <para>Specify when udevd should resolve names of users and groups.
  78           When set to <option>early</option> (the default) names will be
  79           resolved when the rules are parsed.  When set to
  80           <option>late</option> names will be resolved for every event.
  81           When set to <option>never</option> names will never be resolved
  82           and all devices will be owned by root.</para>
  83         </listitem>
  84       </varlistentry>
  85       <varlistentry>
  86         <term><option>--version</option></term>
  87         <listitem>
  88           <para>Print version number.</para>
  89         </listitem>
  90       </varlistentry>
  91       <varlistentry>
  92         <term><option>--help</option></term>
  93         <listitem>
  94           <para>Print help text.</para>
  95         </listitem>
  96       </varlistentry>
  97     </variablelist>
  98   </refsect1>
  99
 100   <refsect1><title>Environment</title>
 101     <variablelist>
 102       <varlistentry>
 103         <term><varname>UDEV_LOG=</varname></term>
 104         <listitem>
 105           <para>Set the logging priority.</para>
 106         </listitem>
 107       </varlistentry>
 108     </variablelist>
 109  </refsect1>
 110
 111   <refsect1><title>Kernel command line</title>
 112     <variablelist>
 113       <varlistentry>
 114         <term><varname>udev.log-priority=</varname></term>
 115         <listitem>
 116           <para>Set the logging priority.</para>
 117         </listitem>
 118       </varlistentry>
 119       <varlistentry>
 120         <term><varname>udev.children-max=</varname></term>
 121         <listitem>
 122           <para>Limit the number of parallel executed events.</para>
 123         </listitem>
 124       </varlistentry>
 125       <varlistentry>
 126         <term><varname>udev.exec-delay=</varname></term>
 127         <listitem>
 128           <para>Number of seconds to delay the execution of RUN instructions.
 129           This might be useful when debugging system crashes during coldplug
 130           cause by loading non-working kernel modules.</para>
 131         </listitem>
 132       </varlistentry>
 133     </variablelist>
 134  </refsect1>
 135
 136   <refsect1><title>Author</title>
 137     <para>Written by Kay Sievers <email>kay.sievers@vrfy.org</email>.</para>
 138   </refsect1>
 139
 140   <refsect1>
 141     <title>See Also</title>
 142     <para><citerefentry>
 143         <refentrytitle>udev</refentrytitle><manvolnum>7</manvolnum>
 144       </citerefentry>, <citerefentry>
 145         <refentrytitle>udevadm</refentrytitle><manvolnum>8</manvolnum>
 146     </citerefentry></para>
 147   </refsect1>
 148 </refentry>