chiark / gitweb /
udevd: read debug settings from kernel commandline
[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>--children-max</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>--children-max</option></term>
52         <listitem>
53           <para>Limit the number of parallel executed events.
54           </para>
55         </listitem>
56       </varlistentry>
57       <varlistentry>
58         <term><option>--debug</option></term>
59         <listitem>
60           <para>Print debug messages to stderr.</para>
61         </listitem>
62       </varlistentry>
63       <varlistentry>
64         <term><option>--resolve-names</option></term>
65         <listitem>
66           <para>Specify when udevd should resolve names of users and groups.
67           When set to <option>early</option> (the default) names will be
68           resolved when the rules are parsed.  When set to
69           <option>late</option> names will be resolved for every event.
70           When set to <option>never</option> names will never be resolved
71           and all devices will be owned by root.</para>
72         </listitem>
73       </varlistentry>
74       <varlistentry>
75         <term><option>--version</option></term>
76         <listitem>
77           <para>Print version number.</para>
78         </listitem>
79       </varlistentry>
80       <varlistentry>
81         <term><option>--help</option></term>
82         <listitem>
83           <para>Print help text.</para>
84         </listitem>
85       </varlistentry>
86     </variablelist>
87   </refsect1>
88
89   <refsect1><title>Environment</title>
90     <variablelist>
91       <varlistentry>
92         <term><option>UDEV_LOG</option></term>
93         <listitem>
94           <para>Overrides the syslog priority specified in the config file.</para>
95         </listitem>
96       </varlistentry>
97     </variablelist>
98  </refsect1>
99
100   <refsect1><title>Author</title>
101     <para>Written by Kay Sievers <email>kay.sievers@vrfy.org</email>.</para>
102   </refsect1>
103
104   <refsect1>
105     <title>See Also</title>
106     <para><citerefentry>
107         <refentrytitle>udev</refentrytitle><manvolnum>7</manvolnum>
108       </citerefentry>, 
109       <citerefentry>
110         <refentrytitle>udevadm</refentrytitle><manvolnum>8</manvolnum>
111     </citerefentry></para>
112   </refsect1>
113 </refentry>