systemd-udevd.service.xml revision b938cb902c3b5bca807a94b277672c64d6767886
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering<?xml version='1.0'?> <!--*- Mode: nxml; nxml-child-indent: 2; indent-tabs-mode: nil -*-->
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering xmlns:xi="http://www.w3.org/2001/XInclude">
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering <refentryinfo>
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering </authorgroup>
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering </refentryinfo>
4871690d9e32608bbd9b18505b5326c2079c9690Allin Cottrell <refentrytitle>systemd-udevd.service</refentrytitle>
b5efdb8af40ea759a1ea584c1bc44ecc81dd00ceLennart Poettering <refname>systemd-udevd-control.socket</refname>
3ffd4af22052963e7a29431721ee204e634bea75Lennart Poettering <refname>systemd-udevd-kernel.socket</refname>
afc5dbf37fd2399d37976388d9dd9ab470ecf446Lennart Poettering <refpurpose>Device event managing daemon</refpurpose>
07630cea1f3a845c09309f197ac7c4f11edd3b62Lennart Poettering <refsynopsisdiv>
3ffd4af22052963e7a29431721ee204e634bea75Lennart Poettering <para><filename>systemd-udevd.service</filename></para>
40b71e89bae4e51768db4dc50ec64c1e9c96eec4Sebastian Thorarensen <para><filename>systemd-udevd-control.socket</filename></para>
0b452006de98294d1690f045f6ea2f7f6630ec3bRonny Chevalier <para><filename>systemd-udevd-kernel.socket</filename></para>
15a5e95075a7f6007dd97b2a165c8ed16fe683dfLennart Poettering <command>/usr/lib/systemd/systemd-udevd</command>
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering <arg><option>--children-max=</option></arg>
178cc7700c23ac088cd7190d7854282075028d91Lennart Poettering <arg><option>--exec-delay=</option></arg>
178cc7700c23ac088cd7190d7854282075028d91Lennart Poettering <arg><option>--event-timeout=</option></arg>
178cc7700c23ac088cd7190d7854282075028d91Lennart Poettering <arg><option>--resolve-names=early|late|never</option></arg>
b92bea5d2a9481de69bb627a7b442a9f58fca43dZbigniew Jędrzejewski-Szmek <arg><option>--help</option></arg>
46b131574fdd7d77c15a0919ca9010cad7aa6ac7Lennart Poettering </cmdsynopsis>
b92bea5d2a9481de69bb627a7b442a9f58fca43dZbigniew Jędrzejewski-Szmek </refsynopsisdiv>
b92bea5d2a9481de69bb627a7b442a9f58fca43dZbigniew Jędrzejewski-Szmek <refsect1><title>Description</title>
b92bea5d2a9481de69bb627a7b442a9f58fca43dZbigniew Jędrzejewski-Szmek <para><command>systemd-udevd</command> listens to kernel uevents.
b92bea5d2a9481de69bb627a7b442a9f58fca43dZbigniew Jędrzejewski-Szmek For every event, systemd-udevd executes matching instructions
46b131574fdd7d77c15a0919ca9010cad7aa6ac7Lennart Poettering specified in udev rules. See <citerefentry>
b92bea5d2a9481de69bb627a7b442a9f58fca43dZbigniew Jędrzejewski-Szmek <refentrytitle>udev</refentrytitle><manvolnum>7</manvolnum>
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering <para>The behavior of the daemon can be configured using
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering <citerefentry><refentrytitle>udev.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering its command line options, environment variables, and on the kernel
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering command line, or changed dynamically with <command>udevadm
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering control</command>.
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering <variablelist>
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering <varlistentry>
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering <para>Detach and run in the background.</para>
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering </varlistentry>
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering <varlistentry>
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering <para>Print debug messages to standard error.</para>
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering </varlistentry>
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering <varlistentry>
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering <term><option>--children-max=</option></term>
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering <para>Limit the number of events executed in parallel.</para>
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering </varlistentry>
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering <varlistentry>
178cc7700c23ac088cd7190d7854282075028d91Lennart Poettering <term><option>--exec-delay=</option></term>
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering <para>Delay the execution of <varname>RUN</varname>
178cc7700c23ac088cd7190d7854282075028d91Lennart Poettering instructions by the given number of seconds. This option
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering might be useful when debugging system crashes during
ccf23ad5faf228d450d263d7291156a948b61af2Christian Seiler coldplug caused by loading non-working kernel
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering modules.</para>
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering </varlistentry>
ccf23ad5faf228d450d263d7291156a948b61af2Christian Seiler <varlistentry>
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering <term><option>--event-timeout=</option></term>
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering <para>Set the number of seconds to wait for events to finish. After
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering this time, the event will be terminated. The default is 180 seconds.</para>
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering </varlistentry>
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering <varlistentry>
178cc7700c23ac088cd7190d7854282075028d91Lennart Poettering <term><option>--resolve-names=</option></term>
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering <para>Specify when systemd-udevd should resolve names of users and groups.
178cc7700c23ac088cd7190d7854282075028d91Lennart Poettering When set to <option>early</option> (the default), names will be
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering resolved when the rules are parsed. When set to
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering <option>late</option>, names will be resolved for every event.
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering When set to <option>never</option>, names will never be resolved
56f64d95763a799ba4475daf44d8e9f72a1bd474Michal Schmidt and all devices will be owned by root.</para>
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering </varlistentry>
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering <varlistentry>
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering <xi:include href="standard-options.xml" xpointer="help-text" />
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering </varlistentry>
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering <xi:include href="standard-options.xml" xpointer="version" />
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering </variablelist>
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering <refsect1><title>Kernel command line</title>
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering <variablelist class='kernel-commandline-options'>
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering <para>Parameters starting with "rd." will be read when
3b3154df7e2773332bb814e167187367a0ccae4aLennart Poettering <command>systemd-udevd</command> is used in an initrd.</para>
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering <varlistentry>
3b97fcbd28f92a1e51887fef5de8844a89bde523Lennart Poettering <term><varname>udev.log-priority=</varname></term>
5ffa8c818120e35c89becd938d160235c069dd12Zbigniew Jędrzejewski-Szmek <term><varname>rd.udev.log-priority=</varname></term>
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering </varlistentry>
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering <varlistentry>
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering <term><varname>udev.children-max=</varname></term>
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering <term><varname>rd.udev.children-max=</varname></term>
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering <para>Limit the number of events executed in parallel.</para>
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering </varlistentry>
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering <varlistentry>
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering <term><varname>udev.exec-delay=</varname></term>
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering <term><varname>rd.udev.exec-delay=</varname></term>
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering <para>Delay the execution of <varname>RUN</varname> instructions by the given
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering number of seconds. This option might be useful when
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering debugging system crashes during coldplug caused by loading
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering non-working kernel modules.</para>
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering </varlistentry>
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering <varlistentry>
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering <term><varname>udev.event-timeout=</varname></term>
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering <term><varname>rd.udev.event-timeout=</varname></term>
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering <para>Wait for events to finish up to the given number
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering of seconds. This option might be useful if events are
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering terminated due to kernel drivers taking too long to initialize.</para>
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering </varlistentry>
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering <varlistentry>
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering <term><varname>net.ifnames=</varname></term>
5ffa8c818120e35c89becd938d160235c069dd12Zbigniew Jędrzejewski-Szmek <para>Network interfaces are renamed to give them predictable names
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering when possible. It is enabled by default; specifying 0 disables it.</para>
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering </varlistentry>
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering </variablelist>
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering <!-- when adding entries here, consider also adding them
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering <citerefentry><refentrytitle>udev.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering <citerefentry><refentrytitle>udev</refentrytitle><manvolnum>7</manvolnum></citerefentry>,
35e2e347d38cc2f8bd7c38a0d8a5129f5fbb0ab9Lennart Poettering <citerefentry><refentrytitle>udevadm</refentrytitle><manvolnum>8</manvolnum></citerefentry>