systemd-udevd.service.xml revision a057be1fcc61ca1fed96898db05dfe88f54ab2db
c6d33447e28403a90ad817dba4df75fae785be28pquerna<?xml version='1.0'?>
c6d33447e28403a90ad817dba4df75fae785be28pquerna<?xml-stylesheet type="text/xsl" href="http://docbook.sourceforge.net/release/xsl/current/xhtml/docbook.xsl"?>
c6d33447e28403a90ad817dba4df75fae785be28pquerna<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
c6d33447e28403a90ad817dba4df75fae785be28pquerna "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
c6d33447e28403a90ad817dba4df75fae785be28pquerna
c6d33447e28403a90ad817dba4df75fae785be28pquerna<refentry id="systemd-udevd.service">
c6d33447e28403a90ad817dba4df75fae785be28pquerna <refentryinfo>
c6d33447e28403a90ad817dba4df75fae785be28pquerna <title>systemd-udevd.service</title>
c6d33447e28403a90ad817dba4df75fae785be28pquerna <productname>systemd</productname>
c6d33447e28403a90ad817dba4df75fae785be28pquerna <authorgroup>
c6d33447e28403a90ad817dba4df75fae785be28pquerna <author>
c6d33447e28403a90ad817dba4df75fae785be28pquerna <contrib>Developer</contrib>
c6d33447e28403a90ad817dba4df75fae785be28pquerna <firstname>Kay</firstname>
c6d33447e28403a90ad817dba4df75fae785be28pquerna <surname>Sievers</surname>
c6d33447e28403a90ad817dba4df75fae785be28pquerna <email>kay@vrfy.org</email>
c6d33447e28403a90ad817dba4df75fae785be28pquerna </author>
546d45814f6de2976187f3eaad9ba7a4b01c8b77pquerna </authorgroup>
546d45814f6de2976187f3eaad9ba7a4b01c8b77pquerna </refentryinfo>
c6d33447e28403a90ad817dba4df75fae785be28pquerna
c6d33447e28403a90ad817dba4df75fae785be28pquerna <refmeta>
c6d33447e28403a90ad817dba4df75fae785be28pquerna <refentrytitle>systemd-udevd.service</refentrytitle>
c6d33447e28403a90ad817dba4df75fae785be28pquerna <manvolnum>8</manvolnum>
ee55ac2cd2fd8c48de97c754758004a7a0176336pquerna <refmiscinfo class="version"></refmiscinfo>
c6d33447e28403a90ad817dba4df75fae785be28pquerna </refmeta>
c6d33447e28403a90ad817dba4df75fae785be28pquerna
c6d33447e28403a90ad817dba4df75fae785be28pquerna <refnamediv>
c6d33447e28403a90ad817dba4df75fae785be28pquerna <refname>systemd-udevd.service</refname>
546d45814f6de2976187f3eaad9ba7a4b01c8b77pquerna <refname>systemd-udevd-control.socket</refname>
30741f9360fff567fe3450441aaf1e96d19bae9ftrawick <refname>systemd-udevd-kernel.socket</refname>
82d8a5c340e2d50ebadc542a6422bacf3c244432pquerna <refname>systemd-udevd</refname>
c6d33447e28403a90ad817dba4df75fae785be28pquerna <refpurpose>Device event managing daemon</refpurpose>
c6d33447e28403a90ad817dba4df75fae785be28pquerna </refnamediv>
82d8a5c340e2d50ebadc542a6422bacf3c244432pquerna
c6d33447e28403a90ad817dba4df75fae785be28pquerna <refsynopsisdiv>
c6d33447e28403a90ad817dba4df75fae785be28pquerna <para><filename>systemd-udevd.service</filename></para>
c6d33447e28403a90ad817dba4df75fae785be28pquerna <para><filename>systemd-udevd-control.socket</filename></para>
fa9496078a83e18311b90b33574fdeb9c115ed7dpquerna <para><filename>systemd-udevd-kernel.socket</filename></para>
c6d33447e28403a90ad817dba4df75fae785be28pquerna
546d45814f6de2976187f3eaad9ba7a4b01c8b77pquerna <cmdsynopsis>
546d45814f6de2976187f3eaad9ba7a4b01c8b77pquerna <command>/usr/lib/systemd/systemd-udevd</command>
546d45814f6de2976187f3eaad9ba7a4b01c8b77pquerna <arg><option>--daemon</option></arg>
546d45814f6de2976187f3eaad9ba7a4b01c8b77pquerna <arg><option>--debug</option></arg>
546d45814f6de2976187f3eaad9ba7a4b01c8b77pquerna <arg><option>--children-max=</option></arg>
546d45814f6de2976187f3eaad9ba7a4b01c8b77pquerna <arg><option>--exec-delay=</option></arg>
546d45814f6de2976187f3eaad9ba7a4b01c8b77pquerna <arg><option>--resolve-names=early|late|never</option></arg>
546d45814f6de2976187f3eaad9ba7a4b01c8b77pquerna <arg><option>--version</option></arg>
546d45814f6de2976187f3eaad9ba7a4b01c8b77pquerna <arg><option>--help</option></arg>
546d45814f6de2976187f3eaad9ba7a4b01c8b77pquerna </cmdsynopsis>
546d45814f6de2976187f3eaad9ba7a4b01c8b77pquerna
546d45814f6de2976187f3eaad9ba7a4b01c8b77pquerna </refsynopsisdiv>
c6d33447e28403a90ad817dba4df75fae785be28pquerna
c6d33447e28403a90ad817dba4df75fae785be28pquerna <refsect1><title>Description</title>
c6d33447e28403a90ad817dba4df75fae785be28pquerna <para><command>systemd-udevd</command> listens to kernel uevents.
c6d33447e28403a90ad817dba4df75fae785be28pquerna For every event, systemd-udevd executes matching instructions
c6d33447e28403a90ad817dba4df75fae785be28pquerna specified in udev rules. See <citerefentry>
c6d33447e28403a90ad817dba4df75fae785be28pquerna <refentrytitle>udev</refentrytitle><manvolnum>7</manvolnum>
c6d33447e28403a90ad817dba4df75fae785be28pquerna </citerefentry>.</para>
ee55ac2cd2fd8c48de97c754758004a7a0176336pquerna <para>The behavior of the running daemon can be changed with
ee55ac2cd2fd8c48de97c754758004a7a0176336pquerna <command>udevadm control</command>.</para>
546d45814f6de2976187f3eaad9ba7a4b01c8b77pquerna </refsect1>
c6d33447e28403a90ad817dba4df75fae785be28pquerna
c6d33447e28403a90ad817dba4df75fae785be28pquerna <refsect1><title>Options</title>
d3b07cc74a282e33675ae3f5166cd72ddb8de2acpquerna <variablelist>
c6d33447e28403a90ad817dba4df75fae785be28pquerna <varlistentry>
c6d33447e28403a90ad817dba4df75fae785be28pquerna <term><option>--daemon</option></term>
30741f9360fff567fe3450441aaf1e96d19bae9ftrawick <listitem>
30741f9360fff567fe3450441aaf1e96d19bae9ftrawick <para>Detach and run in the background.</para>
30741f9360fff567fe3450441aaf1e96d19bae9ftrawick </listitem>
c6d33447e28403a90ad817dba4df75fae785be28pquerna </varlistentry>
ee55ac2cd2fd8c48de97c754758004a7a0176336pquerna <varlistentry>
ee55ac2cd2fd8c48de97c754758004a7a0176336pquerna <term><option>--debug</option></term>
ee55ac2cd2fd8c48de97c754758004a7a0176336pquerna <listitem>
ee55ac2cd2fd8c48de97c754758004a7a0176336pquerna <para>Print debug messages to stderr.</para>
ee55ac2cd2fd8c48de97c754758004a7a0176336pquerna </listitem>
ee55ac2cd2fd8c48de97c754758004a7a0176336pquerna </varlistentry>
ee55ac2cd2fd8c48de97c754758004a7a0176336pquerna <varlistentry>
ee55ac2cd2fd8c48de97c754758004a7a0176336pquerna <term><option>--children-max=</option></term>
ee55ac2cd2fd8c48de97c754758004a7a0176336pquerna <listitem>
ee55ac2cd2fd8c48de97c754758004a7a0176336pquerna <para>Limit the number of events executed in parallel.</para>
ee55ac2cd2fd8c48de97c754758004a7a0176336pquerna </listitem>
ee55ac2cd2fd8c48de97c754758004a7a0176336pquerna </varlistentry>
ee55ac2cd2fd8c48de97c754758004a7a0176336pquerna <varlistentry>
ee55ac2cd2fd8c48de97c754758004a7a0176336pquerna <term><option>--exec-delay=</option></term>
ee55ac2cd2fd8c48de97c754758004a7a0176336pquerna <listitem>
602b8c83188d37e4782411a3829a0f410839e78bpquerna
ee55ac2cd2fd8c48de97c754758004a7a0176336pquerna <para>Delay the execution of RUN instruction by the given
ee55ac2cd2fd8c48de97c754758004a7a0176336pquerna number of seconds. This option might be useful when
ee55ac2cd2fd8c48de97c754758004a7a0176336pquerna debugging system crashes during coldplug caused by loading
602b8c83188d37e4782411a3829a0f410839e78bpquerna non-working kernel modules.</para>
602b8c83188d37e4782411a3829a0f410839e78bpquerna </listitem>
602b8c83188d37e4782411a3829a0f410839e78bpquerna </varlistentry>
602b8c83188d37e4782411a3829a0f410839e78bpquerna <varlistentry>
602b8c83188d37e4782411a3829a0f410839e78bpquerna <term><option>--resolve-names=</option></term>
602b8c83188d37e4782411a3829a0f410839e78bpquerna <listitem>
602b8c83188d37e4782411a3829a0f410839e78bpquerna <para>Specify when systemd-udevd should resolve names of users and groups.
602b8c83188d37e4782411a3829a0f410839e78bpquerna When set to <option>early</option> (the default) names will be
602b8c83188d37e4782411a3829a0f410839e78bpquerna resolved when the rules are parsed. When set to
602b8c83188d37e4782411a3829a0f410839e78bpquerna <option>late</option> names will be resolved for every event.
602b8c83188d37e4782411a3829a0f410839e78bpquerna When set to <option>never</option> names will never be resolved
602b8c83188d37e4782411a3829a0f410839e78bpquerna and all devices will be owned by root.</para>
ee55ac2cd2fd8c48de97c754758004a7a0176336pquerna </listitem>
ee55ac2cd2fd8c48de97c754758004a7a0176336pquerna </varlistentry>
ee55ac2cd2fd8c48de97c754758004a7a0176336pquerna <varlistentry>
ee55ac2cd2fd8c48de97c754758004a7a0176336pquerna <term><option>--version</option></term>
ee55ac2cd2fd8c48de97c754758004a7a0176336pquerna <listitem>
ee55ac2cd2fd8c48de97c754758004a7a0176336pquerna <para>Print version number.</para>
c6d33447e28403a90ad817dba4df75fae785be28pquerna </listitem>
c6d33447e28403a90ad817dba4df75fae785be28pquerna </varlistentry>
c6d33447e28403a90ad817dba4df75fae785be28pquerna <varlistentry>
c6d33447e28403a90ad817dba4df75fae785be28pquerna <term><option>--help</option></term>
c6d33447e28403a90ad817dba4df75fae785be28pquerna <listitem>
c6d33447e28403a90ad817dba4df75fae785be28pquerna <para>Print help text.</para>
c6d33447e28403a90ad817dba4df75fae785be28pquerna </listitem>
c6d33447e28403a90ad817dba4df75fae785be28pquerna </varlistentry>
c6d33447e28403a90ad817dba4df75fae785be28pquerna </variablelist>
c6d33447e28403a90ad817dba4df75fae785be28pquerna </refsect1>
c6d33447e28403a90ad817dba4df75fae785be28pquerna
c6d33447e28403a90ad817dba4df75fae785be28pquerna <refsect1><title>Environment</title>
ee55ac2cd2fd8c48de97c754758004a7a0176336pquerna <variablelist class='environment-variables'>
ee55ac2cd2fd8c48de97c754758004a7a0176336pquerna <varlistentry>
ee55ac2cd2fd8c48de97c754758004a7a0176336pquerna <term><varname>$UDEV_LOG=</varname></term>
ee55ac2cd2fd8c48de97c754758004a7a0176336pquerna <listitem>
ee55ac2cd2fd8c48de97c754758004a7a0176336pquerna <para>Set the logging priority.</para>
c6d33447e28403a90ad817dba4df75fae785be28pquerna </listitem>
09b4ea40821c7f8663d47a42f31ab74ee9c0f352jfclere </varlistentry>
c6d33447e28403a90ad817dba4df75fae785be28pquerna </variablelist>
c6d33447e28403a90ad817dba4df75fae785be28pquerna </refsect1>
c6d33447e28403a90ad817dba4df75fae785be28pquerna
c6d33447e28403a90ad817dba4df75fae785be28pquerna <refsect1><title>Kernel command line</title>
c6d33447e28403a90ad817dba4df75fae785be28pquerna <variablelist class='kernel-commandline-options'>
c6d33447e28403a90ad817dba4df75fae785be28pquerna <para>Parameters starting with "rd." will be read when
c6d33447e28403a90ad817dba4df75fae785be28pquerna <command>systemd-udevd</command> is used in an initrd.</para>
c6d33447e28403a90ad817dba4df75fae785be28pquerna <varlistentry>
c6d33447e28403a90ad817dba4df75fae785be28pquerna <term><varname>udev.log-priority=</varname></term>
c6d33447e28403a90ad817dba4df75fae785be28pquerna <term><varname>rd.udev.log-priority=</varname></term>
c6d33447e28403a90ad817dba4df75fae785be28pquerna <listitem>
c6d33447e28403a90ad817dba4df75fae785be28pquerna <para>Set the logging priority.</para>
c6d33447e28403a90ad817dba4df75fae785be28pquerna </listitem>
c6d33447e28403a90ad817dba4df75fae785be28pquerna </varlistentry>
c6d33447e28403a90ad817dba4df75fae785be28pquerna <varlistentry>
c6d33447e28403a90ad817dba4df75fae785be28pquerna <term><varname>udev.children-max=</varname></term>
c6d33447e28403a90ad817dba4df75fae785be28pquerna <term><varname>rd.udev.children-max=</varname></term>
546d45814f6de2976187f3eaad9ba7a4b01c8b77pquerna <listitem>
c6d33447e28403a90ad817dba4df75fae785be28pquerna <para>Limit the number of events executed in parallel.</para>
c6d33447e28403a90ad817dba4df75fae785be28pquerna </listitem>
c6d33447e28403a90ad817dba4df75fae785be28pquerna </varlistentry>
c6d33447e28403a90ad817dba4df75fae785be28pquerna <varlistentry>
c6d33447e28403a90ad817dba4df75fae785be28pquerna <term><varname>udev.exec-delay=</varname></term>
c6d33447e28403a90ad817dba4df75fae785be28pquerna <term><varname>rd.udev.exec-delay=</varname></term>
c6d33447e28403a90ad817dba4df75fae785be28pquerna <listitem>
c6d33447e28403a90ad817dba4df75fae785be28pquerna <para>Delay the execution of RUN instruction by the given
c6d33447e28403a90ad817dba4df75fae785be28pquerna number of seconds. This option might be useful when
c6d33447e28403a90ad817dba4df75fae785be28pquerna debugging system crashes during coldplug caused by loading
c6d33447e28403a90ad817dba4df75fae785be28pquerna non-working kernel modules.</para>
c6d33447e28403a90ad817dba4df75fae785be28pquerna </listitem>
c6d33447e28403a90ad817dba4df75fae785be28pquerna </varlistentry>
c6d33447e28403a90ad817dba4df75fae785be28pquerna <varlistentry>
c6d33447e28403a90ad817dba4df75fae785be28pquerna <term><varname>net.ifnames=</varname></term>
c6d33447e28403a90ad817dba4df75fae785be28pquerna <listitem>
c6d33447e28403a90ad817dba4df75fae785be28pquerna <para>Network interfaces are renamed to give them predictable names
c6d33447e28403a90ad817dba4df75fae785be28pquerna when possible. It is enabled by default, specifying 0 disables it.</para>
c6d33447e28403a90ad817dba4df75fae785be28pquerna </listitem>
c6d33447e28403a90ad817dba4df75fae785be28pquerna </varlistentry>
c6d33447e28403a90ad817dba4df75fae785be28pquerna </variablelist>
c6d33447e28403a90ad817dba4df75fae785be28pquerna <!-- when adding entries here, consider also adding them
c6d33447e28403a90ad817dba4df75fae785be28pquerna in kernel-command-line.xml -->
c6d33447e28403a90ad817dba4df75fae785be28pquerna </refsect1>
c6d33447e28403a90ad817dba4df75fae785be28pquerna
c6d33447e28403a90ad817dba4df75fae785be28pquerna <refsect1><title>Configuration file</title>
c6d33447e28403a90ad817dba4df75fae785be28pquerna <para>udev expects its main configuration file at <filename>/etc/udev/udev.conf</filename>.
c6d33447e28403a90ad817dba4df75fae785be28pquerna It consists of a set of variables allowing the user to override default udev values. All
c6d33447e28403a90ad817dba4df75fae785be28pquerna empty lines or lines beginning with '#' are ignored. The following variables can be
c6d33447e28403a90ad817dba4df75fae785be28pquerna set:</para>
c6d33447e28403a90ad817dba4df75fae785be28pquerna <variablelist>
c6d33447e28403a90ad817dba4df75fae785be28pquerna <varlistentry>
c6d33447e28403a90ad817dba4df75fae785be28pquerna <term><varname>udev_log</varname></term>
c6d33447e28403a90ad817dba4df75fae785be28pquerna <listitem>
c6d33447e28403a90ad817dba4df75fae785be28pquerna <para>The logging priority. Valid values are the numerical syslog priorities
c6d33447e28403a90ad817dba4df75fae785be28pquerna or their textual representations: <option>err</option>, <option>info</option>
c6d33447e28403a90ad817dba4df75fae785be28pquerna and <option>debug</option>.</para>
c6d33447e28403a90ad817dba4df75fae785be28pquerna </listitem>
c6d33447e28403a90ad817dba4df75fae785be28pquerna </varlistentry>
c6d33447e28403a90ad817dba4df75fae785be28pquerna </variablelist>
c6d33447e28403a90ad817dba4df75fae785be28pquerna </refsect1>
c6d33447e28403a90ad817dba4df75fae785be28pquerna
c6d33447e28403a90ad817dba4df75fae785be28pquerna <refsect1>
c6d33447e28403a90ad817dba4df75fae785be28pquerna <title>See Also</title>
c6d33447e28403a90ad817dba4df75fae785be28pquerna <para><citerefentry>
c6d33447e28403a90ad817dba4df75fae785be28pquerna <refentrytitle>udev</refentrytitle><manvolnum>7</manvolnum>
c6d33447e28403a90ad817dba4df75fae785be28pquerna </citerefentry>, <citerefentry>
c6d33447e28403a90ad817dba4df75fae785be28pquerna <refentrytitle>udevadm</refentrytitle><manvolnum>8</manvolnum>
c6d33447e28403a90ad817dba4df75fae785be28pquerna </citerefentry></para>
c6d33447e28403a90ad817dba4df75fae785be28pquerna </refsect1>
c6d33447e28403a90ad817dba4df75fae785be28pquerna</refentry>
c6d33447e28403a90ad817dba4df75fae785be28pquerna