man/udev.conf.xml

   1 <?xml version='1.0'?>
   2 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
   3   "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
   4
   5 <!--
   6   SPDX-License-Identifier: LGPL-2.1+
   7 -->
   8
   9 <refentry id="udev.conf"
  10           xmlns:xi="http://www.w3.org/2001/XInclude">
  11
  12   <refentryinfo>
  13     <title>udev.conf</title>
  14     <productname>systemd</productname>
  15   </refentryinfo>
  16
  17   <refmeta>
  18     <refentrytitle>udev.conf</refentrytitle>
  19     <manvolnum>5</manvolnum>
  20   </refmeta>
  21
  22   <refnamediv>
  23     <refname>udev.conf</refname>
  24     <refpurpose>Configuration for device event managing daemon</refpurpose>
  25   </refnamediv>
  26
  27   <refsynopsisdiv>
  28     <para><filename>/etc/udev/udev.conf</filename></para>
  29   </refsynopsisdiv>
  30
  31   <refsect1>
  32     <title>Description</title>
  33
  34     <para>
  35       <citerefentry><refentrytitle>systemd-udevd</refentrytitle><manvolnum>8</manvolnum></citerefentry>
  36       expects its main configuration file at
  37       <filename>/etc/udev/udev.conf</filename>. It consists of a set
  38       of variables allowing the user to override default udev
  39       values. All empty lines or lines beginning with '#' are
  40       ignored. The following variables can be set:
  41     </para>
  42
  43     <variablelist>
  44       <varlistentry>
  45         <term><varname>udev_log=</varname></term>
  46
  47         <listitem>
  48           <para>The log level. Valid values are the numerical
  49           syslog priorities or their textual representations:
  50           <option>err</option>, <option>info</option> and
  51           <option>debug</option>.</para>
  52         </listitem>
  53       </varlistentry>
  54
  55       <varlistentry>
  56         <term><varname>children_max=</varname></term>
  57
  58         <listitem>
  59           <para>An integer. The maximum number of events executed in parallel.</para>
  60
  61           <para>This is the same as the <option>--children-max=</option> option.</para>
  62         </listitem>
  63       </varlistentry>
  64
  65       <varlistentry>
  66         <term><varname>exec_delay=</varname></term>
  67
  68         <listitem>
  69           <para>An integer. Delay the execution of <varname>RUN</varname>
  70           instructions by the given number of seconds. This option
  71           might be useful when debugging system crashes during
  72           coldplug caused by loading non-working kernel
  73           modules.</para>
  74
  75           <para>This is the same as the <option>--exec-delay=</option> option.</para>
  76         </listitem>
  77       </varlistentry>
  78
  79       <varlistentry>
  80         <term><varname>event_timeout=</varname></term>
  81
  82         <listitem>
  83           <para>An integer. The number of seconds to wait for events to finish. After
  84           this time, the event will be terminated. The default is 180 seconds.</para>
  85
  86           <para>This is the same as the <option>--event-timeout=</option> option.</para>
  87         </listitem>
  88       </varlistentry>
  89
  90       <varlistentry>
  91         <term><varname>resolve_names=</varname></term>
  92
  93         <listitem>
  94           <para>Specifes when systemd-udevd should resolve names of users and groups.  When set to
  95           <option>early</option> (the default), names will be resolved when the rules are parsed.
  96           When set to <option>late</option>, names will be resolved for every event.  When set to
  97           <option>never</option>, names will never be resolved and all devices will be owned by
  98           root.</para>
  99
 100           <para>This is the same as the <option>--resolve-names=</option> option.</para>
 101         </listitem>
 102       </varlistentry>
 103     </variablelist>
 104
 105     <para>
 106       In addition, <filename>systemd-udevd</filename> can be configured
 107       by command line options and the kernel command line (see
 108       <citerefentry><refentrytitle>systemd-udevd</refentrytitle><manvolnum>8</manvolnum></citerefentry>).
 109     </para>
 110   </refsect1>
 111
 112   <refsect1>
 113     <title>See Also</title>
 114     <para>
 115       <citerefentry><refentrytitle>systemd-udevd</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
 116       <citerefentry><refentrytitle>udev</refentrytitle><manvolnum>7</manvolnum></citerefentry>,
 117       <citerefentry><refentrytitle>udevadm</refentrytitle><manvolnum>8</manvolnum></citerefentry>
 118     </para>
 119   </refsect1>
 120 </refentry>