From 347c8822d1a8a5b70624920b3de2a91d4e0fca91 Mon Sep 17 00:00:00 2001
From: Yu Watanabe <watanabe.yu+github@gmail.com>
Date: Fri, 2 Aug 2024 13:42:29 +0900
Subject: [PATCH] man: extend explanation for ConfigureWithoutCarrier= in
 systemd.network(5)

Prompted by #33702.
---
 man/systemd.network.xml | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/man/systemd.network.xml b/man/systemd.network.xml
index 8755a06eb0..b4d438823d 100644
--- a/man/systemd.network.xml
+++ b/man/systemd.network.xml
@@ -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>
-- 
2.25.1