1
0
mirror of https://github.com/systemd/systemd.git synced 2025-03-21 02:50:18 +03:00

man: extend explanation for ConfigureWithoutCarrier= in systemd.network(5)

Prompted by #33702.
This commit is contained in:
Yu Watanabe 2024-08-02 13:42:29 +09:00
parent 6b8e373ce8
commit 347c8822d1

View File

@ -1207,6 +1207,18 @@ DuplicateAddressDetection=none</programlisting></para>
carrier. Defaults to false. If enabled, and the <varname>IgnoreCarrierLoss=</varname> setting
is not explicitly set, then it is enabled as well.</para>
<para>With this enabled, to make the interface enter the <literal>configured</literal> state,
which is required to make <command>systemd-networkd-wait-online</command> work properly for the
interface, all dynamic address configuration mechanisms like <varname>DHCP=</varname> and
<varname>IPv6AcceptRA=</varname> (which is enabled by default in most cases) need to be disabled.
Also, <varname>DuplicateAddressDetection=</varname> (which is enabled by default for IPv4
link-local addresses and all IPv6 addresses) needs to be disabled for all static address
configurations. Otherwise, without carrier, the interface will be stuck in the
<literal>configuring</literal> state, and <command>systemd-networkd-wait-online</command> for the
interface will timeout. Also, it is recommended to set
<varname>RequiredForOnline=no-carrier</varname> to make
<command>systemd-networkd-wait-online</command> work for the interface.</para>
<xi:include href="version-info.xml" xpointer="v235"/>
</listitem>
</varlistentry>