chiark / gitweb /
move syslog wrapper to libudev
[elogind.git] / udev / udevd.xml
1 <?xml version='1.0'?>
2 <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3   "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
4
5 <article>
6   <section>
7     <title>udevd</title>
8     <refentry>
9       <refentryinfo>
10         <title>udevd</title>
11         <date>August 2005</date>
12         <productname>udev</productname>
13       </refentryinfo>
14
15       <refmeta>
16         <refentrytitle>udevd</refentrytitle>
17         <manvolnum>8</manvolnum>
18         <refmiscinfo class="version"></refmiscinfo>
19       </refmeta>
20
21       <refnamediv>
22         <refname>udevd</refname><refpurpose>event managing daemon</refpurpose>
23       </refnamediv>
24
25       <refsynopsisdiv>
26         <cmdsynopsis>
27           <command>udevd</command>
28           <arg><option>--daemon</option></arg>
29           <arg><option>--debug-trace</option></arg>
30           <arg><option>--debug</option></arg>
31           <arg><option>--version</option></arg>
32           <arg><option>--resolve-names=early|late|never</option></arg>
33           <arg><option>--help</option></arg>
34         </cmdsynopsis>
35       </refsynopsisdiv>
36
37       <refsect1><title>DESCRIPTION</title>
38         <para>udevd listens to kernel uevents and passes the incoming events to
39         udev. It ensures the correct event order and takes care, that events for child
40         devices are delayed until the parent event has finished the device handling.
41         The behavior of the running daemon can be changed with
42         <command>udevadm control</command>.</para>
43       </refsect1>
44
45       <refsect1><title>OPTIONS</title>
46         <variablelist>
47           <varlistentry>
48             <term><option>--daemon</option></term>
49             <listitem>
50               <para>Detach and run in the background.</para>
51             </listitem>
52           </varlistentry>
53           <varlistentry>
54             <term><option>--debug-trace</option></term>
55             <listitem>
56               <para>Run all events completely serialized. This may be useful if udev triggers
57               actions or loads kernel modules which cause problems and a slow but continuous
58               operation is needed, where no events are processed in parallel.
59               </para>
60             </listitem>
61           </varlistentry>
62           <varlistentry>
63             <term><option>--debug</option></term>
64             <listitem>
65               <para>Print debug messages to stderr.</para>
66             </listitem>
67           </varlistentry>
68           <varlistentry>
69             <term><option>--resolve-names</option></term>
70             <listitem>
71               <para>Specify when udevd should resolve names of users and groups.
72               When set to <option>early</option> (the default) names will be
73               resolved when the rules are parsed.  When set to
74               <option>late</option> names will be resolved for every event.
75               When set to <option>never</option> names will never be resolved
76               and all devices will be owned by root.</para>
77             </listitem>
78           </varlistentry>
79           <varlistentry>
80             <term><option>--version</option></term>
81             <listitem>
82               <para>Print version number.</para>
83             </listitem>
84           </varlistentry>
85           <varlistentry>
86             <term><option>--help</option></term>
87             <listitem>
88               <para>Print help text.</para>
89             </listitem>
90           </varlistentry>
91         </variablelist>
92       </refsect1>
93
94       <refsect1><title>ENVIRONMENT</title>
95         <variablelist>
96           <varlistentry>
97             <term><option>UDEV_LOG</option></term>
98             <listitem>
99               <para>Overrides the syslog priority specified in the config file.</para>
100             </listitem>
101           </varlistentry>
102         </variablelist>
103      </refsect1>
104
105       <refsect1><title>AUTHOR</title>
106         <para>Written by Kay Sievers <email>kay.sievers@vrfy.org</email>.</para>
107       </refsect1>
108
109       <refsect1>
110         <title>SEE ALSO</title>
111         <para><citerefentry>
112             <refentrytitle>udev</refentrytitle><manvolnum>7</manvolnum>
113           </citerefentry>, 
114           <citerefentry>
115             <refentrytitle>udevadm</refentrytitle><manvolnum>8</manvolnum>
116         </citerefentry></para>
117       </refsect1>
118     </refentry>
119   </section>
120 </article>