From: Yu Watanabe <watanabe.yu+github@gmail.com>
Date: Fri, 3 Nov 2023 06:45:52 +0000 (+0900)
Subject: man: mention DHCPv4 Router option is ignored when Classless Static Routes option... 
X-Git-Tag: v255-rc1~37
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=45a7ef454e2b8eb3147fe19914231c4327d6f227;p=thirdparty%2Fsystemd.git

man: mention DHCPv4 Router option is ignored when Classless Static Routes option is received

For #29564.
---

diff --git a/man/systemd.network.xml b/man/systemd.network.xml
index 02039b49425..55a5a2ec1c7 100644
--- a/man/systemd.network.xml
+++ b/man/systemd.network.xml
@@ -2567,9 +2567,13 @@ NFTSet=prefix:netdev:filter:eth_ipv4_prefix</programlisting>
       <varlistentry>
         <term><varname>UseGateway=</varname></term>
         <listitem>
-          <para>When true, the gateway will be requested from the DHCP server and added to the routing
-          table with a metric of 1024, and a scope of <option>link</option>. When unset, the value
-          specified with <varname>UseRoutes=</varname> is used.</para>
+          <para>When true, and the DHCP server provides a Router option, the default gateway based on the
+          router address will be configured. Defaults to unset, and the value specified with
+          <varname>UseRoutes=</varname> will be used.</para>
+
+          <para>Note, when the server provides both the Router and Classless Static Routes option, and
+          <varname>UseRoutes=</varname> is enabled, the Router option is always ignored regardless of this
+          setting. See <ulink url="https://datatracker.ietf.org/doc/html/rfc3442">RFC 3442</ulink>.</para>
 
           <xi:include href="version-info.xml" xpointer="v246"/>
         </listitem>