chiark / gitweb /
02a6543235f99819bf42c0e91931a263adfdefd6
[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</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.
64           </para>
65         </listitem>
66       </varlistentry>
67       <varlistentry>
68         <term><option>--exec-delay=</option></term>
69         <listitem>
70           <para>Number of seconds to delay the execution of RUN instructions.
71           This might be useful when debugging system crashes during coldplug
72           cause by loading non-working kernel modules.</para>
73         </listitem>
74       </varlistentry>
75       <varlistentry>
76         <term><option>--resolve-names=</option></term>
77         <listitem>
78           <para>Specify when udevd should resolve names of users and groups.
79           When set to <option>early</option> (the default) names will be
80           resolved when the rules are parsed.  When set to
81           <option>late</option> names will be resolved for every event.
82           When set to <option>never</option> names will never be resolved
83           and all devices will be owned by root.</para>
84         </listitem>
85       </varlistentry>
86       <varlistentry>
87         <term><option>--version</option></term>
88         <listitem>
89           <para>Print version number.</para>
90         </listitem>
91       </varlistentry>
92       <varlistentry>
93         <term><option>--help</option></term>
94         <listitem>
95           <para>Print help text.</para>
96         </listitem>
97       </varlistentry>
98     </variablelist>
99   </refsect1>
100
101   <refsect1><title>Environment</title>
102     <variablelist>
103       <varlistentry>
104         <term><option>UDEV_LOG</option></term>
105         <listitem>
106           <para>Overrides the syslog priority specified in the config file.</para>
107         </listitem>
108       </varlistentry>
109     </variablelist>
110  </refsect1>
111
112   <refsect1><title>Author</title>
113     <para>Written by Kay Sievers <email>kay.sievers@vrfy.org</email>.</para>
114   </refsect1>
115
116   <refsect1>
117     <title>See Also</title>
118     <para><citerefentry>
119         <refentrytitle>udev</refentrytitle><manvolnum>7</manvolnum>
120       </citerefentry>, 
121       <citerefentry>
122         <refentrytitle>udevadm</refentrytitle><manvolnum>8</manvolnum>
123     </citerefentry></para>
124   </refsect1>
125 </refentry>