From: Yu Watanabe <watanabe.yu+github@gmail.com>
Date: Sun, 23 Jun 2024 20:03:58 +0000 (+0900)
Subject: man: suggest to enable global IPv6Forwarding= setting to make IPv6 packets forwarded
X-Git-Tag: v257-rc1~794
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=175cdefd33788eced7fd6d76fb0b1676eb6ba799;p=thirdparty%2Fsystemd.git

man: suggest to enable global IPv6Forwarding= setting to make IPv6 packets forwarded

Closes #33414.
---

diff --git a/man/systemd.network.xml b/man/systemd.network.xml
index 42a31b4cdd1..68d0c9be59b 100644
--- a/man/systemd.network.xml
+++ b/man/systemd.network.xml
@@ -853,7 +853,7 @@ DuplicateAddressDetection=none</programlisting></para>
       <varlistentry>
         <term><varname>IPv6Forwarding=</varname></term>
         <listitem>
-          <para>Configures IPv6 packet forwarding for the interface. Takes a boolean value. This controls the
+          <para>Configures interface-specific host/router behaviour. Takes a boolean value. This controls the
           <filename>net.ipv6.conf.<replaceable>INTERFACE</replaceable>.forwarding</filename> sysctl option of
           the network interface. See
           <ulink url="https://docs.kernel.org/networking/ip-sysctl.html">IP Sysctl</ulink>
@@ -867,6 +867,14 @@ DuplicateAddressDetection=none</programlisting></para>
           <citerefentry><refentrytitle>networkd.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>.
           </para>
 
+          <para>Note, unlike <varname>IPv4Forwarding=</varname>, enabling per-interface
+          <varname>IPv6Forwarding=</varname> on two or more interfaces <emphasis>DOES NOT</emphasis> make IPv6
+          packets forwarded within the interfaces. This setting just controls the per-interface sysctl value,
+          and the sysctl value is not directly correlated to whether packets are forwarded. To ensure IPv6
+          packets forwarded, the global setting in
+          <citerefentry><refentrytitle>networkd.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+          needs to be enabled.</para>
+
           <xi:include href="version-info.xml" xpointer="v256"/>
         </listitem>
       </varlistentry>