mirror of
https://github.com/systemd/systemd
synced 2024-09-06 16:56:43 +00:00
52 lines
2.3 KiB
XML
52 lines
2.3 KiB
XML
<?xml version='1.0'?>
|
|
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
|
|
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
|
|
<!-- SPDX-License-Identifier: LGPL-2.1-or-later -->
|
|
|
|
<refentry id="systemd-udev-settle.service"
|
|
xmlns:xi="http://www.w3.org/2001/XInclude">
|
|
|
|
<refentryinfo>
|
|
<title>systemd-udev-settle.service</title>
|
|
<productname>systemd</productname>
|
|
</refentryinfo>
|
|
|
|
<refmeta>
|
|
<refentrytitle>systemd-udev-settle.service</refentrytitle>
|
|
<manvolnum>8</manvolnum>
|
|
</refmeta>
|
|
|
|
<refnamediv>
|
|
<refname>systemd-udev-settle.service</refname>
|
|
<refpurpose>Wait for all pending udev events to be handled</refpurpose>
|
|
</refnamediv>
|
|
|
|
<refsynopsisdiv>
|
|
<para><filename>systemd-udev-settle.service</filename></para>
|
|
</refsynopsisdiv>
|
|
|
|
<refsect1><title>Description</title>
|
|
<para>This service calls <command>udevadm settle</command> to wait until all events that have been queued
|
|
by <citerefentry><refentrytitle>udev</refentrytitle><manvolnum>7</manvolnum></citerefentry> have been
|
|
processed. It is a crude way to wait until "all" hardware has been discovered. Services may pull in this
|
|
service and order themselves after it to wait for the udev queue to be empty.</para>
|
|
|
|
<para><emphasis>Using this service is not recommended.</emphasis> There can be no guarantee that hardware
|
|
is fully discovered at any specific time, because the kernel does hardware detection asynchronously, and
|
|
certain buses and devices take a very long time to become ready, and also additional hardware may be
|
|
plugged in at any time. Instead, services should subscribe to udev events and react to any new hardware as
|
|
it is discovered. Services that, based on configuration, expect certain devices to appear, may warn or
|
|
report failure after a timeout. This timeout should be tailored to the hardware type. Waiting for
|
|
<filename>systemd-udev-settle.service</filename> usually slows boot significantly, because it means waiting
|
|
for all unrelated events too.</para>
|
|
</refsect1>
|
|
|
|
<refsect1>
|
|
<title>See Also</title>
|
|
<para><simplelist type="inline">
|
|
<member><citerefentry><refentrytitle>udev</refentrytitle><manvolnum>7</manvolnum></citerefentry></member>
|
|
<member><citerefentry><refentrytitle>udevadm</refentrytitle><manvolnum>8</manvolnum></citerefentry></member>
|
|
</simplelist></para>
|
|
</refsect1>
|
|
</refentry>
|