chiark / gitweb /
fix compilation with --enable-debug
[elogind.git] / 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-trace</option></arg>
27       <arg><option>--debug</option></arg>
28       <arg><option>--version</option></arg>
29       <arg><option>--resolve-names=early|late|never</option></arg>
30       <arg><option>--help</option></arg>
31     </cmdsynopsis>
32   </refsynopsisdiv>
33
34   <refsect1><title>Description</title>
35     <para>udevd listens to kernel uevents and passes the incoming events to
36     udev. It ensures the correct event order and takes care, that events for child
37     devices are delayed until the parent event has finished the device handling.
38     The behavior of the running daemon can be changed with
39     <command>udevadm control</command>.</para>
40   </refsect1>
41
42   <refsect1><title>Options</title>
43     <variablelist>
44       <varlistentry>
45         <term><option>--daemon</option></term>
46         <listitem>
47           <para>Detach and run in the background.</para>
48         </listitem>
49       </varlistentry>
50       <varlistentry>
51         <term><option>--debug-trace</option></term>
52         <listitem>
53           <para>Run all events completely serialized. This may be useful if udev triggers
54           actions or loads kernel modules which cause problems and a slow but continuous
55           operation is needed, where no events are processed in parallel.
56           </para>
57         </listitem>
58       </varlistentry>
59       <varlistentry>
60         <term><option>--debug</option></term>
61         <listitem>
62           <para>Print debug messages to stderr.</para>
63         </listitem>
64       </varlistentry>
65       <varlistentry>
66         <term><option>--resolve-names</option></term>
67         <listitem>
68           <para>Specify when udevd should resolve names of users and groups.
69           When set to <option>early</option> (the default) names will be
70           resolved when the rules are parsed.  When set to
71           <option>late</option> names will be resolved for every event.
72           When set to <option>never</option> names will never be resolved
73           and all devices will be owned by root.</para>
74         </listitem>
75       </varlistentry>
76       <varlistentry>
77         <term><option>--version</option></term>
78         <listitem>
79           <para>Print version number.</para>
80         </listitem>
81       </varlistentry>
82       <varlistentry>
83         <term><option>--help</option></term>
84         <listitem>
85           <para>Print help text.</para>
86         </listitem>
87       </varlistentry>
88     </variablelist>
89   </refsect1>
90
91   <refsect1><title>Environment</title>
92     <variablelist>
93       <varlistentry>
94         <term><option>UDEV_LOG</option></term>
95         <listitem>
96           <para>Overrides the syslog priority specified in the config file.</para>
97         </listitem>
98       </varlistentry>
99     </variablelist>
100  </refsect1>
101
102   <refsect1><title>Author</title>
103     <para>Written by Kay Sievers <email>kay.sievers@vrfy.org</email>.</para>
104   </refsect1>
105
106   <refsect1>
107     <title>See Also</title>
108     <para><citerefentry>
109         <refentrytitle>udev</refentrytitle><manvolnum>7</manvolnum>
110       </citerefentry>, 
111       <citerefentry>
112         <refentrytitle>udevadm</refentrytitle><manvolnum>8</manvolnum>
113     </citerefentry></para>
114   </refsect1>
115 </refentry>