]> git.ipfire.org Git - thirdparty/systemd.git/commitdiff
man/network: extend document about the default value of IPv6AcceptRA=
authorYu Watanabe <watanabe.yu+github@gmail.com>
Tue, 21 Oct 2025 17:52:28 +0000 (02:52 +0900)
committerLuca Boccassi <luca.boccassi@gmail.com>
Thu, 6 Nov 2025 14:13:33 +0000 (14:13 +0000)
Prompted by #39304.

(cherry picked from commit cc7ccd3c6a2be9203057f81be4ef55e94b2ab85c)

man/systemd.network.xml

index f1becd46274ada2805b013acf91f601dcec5c99e..9fbc0dc07dcdc49935dedf967c3a9fc4291e54e1 100644 (file)
         <term><varname>Multicast=</varname></term>
         <listitem>
           <para>Takes a boolean. If set to true, the multicast flag on the device is enabled. Defaults
-          to unset.</para>
+          to unset and the flag is unchanged. When disabled, <varname>IPv6AcceptRA=</varname> and
+          <varname>IPv6SendRA=</varname> cannot be enabled.</para>
 
           <xi:include href="version-info.xml" xpointer="v239"/>
         </listitem>
@@ -942,10 +943,19 @@ DuplicateAddressDetection=none</programlisting></para>
           <para>Takes a boolean. Controls IPv6 Router Advertisement (RA) reception support for the interface.
           If true, RAs are accepted; if false, RAs are ignored. When RAs are accepted, they may trigger the
           start of the DHCPv6 client if the relevant flags are set in the RA data, or if no routers are found
-          on the link. Defaults to false for bridge devices, when <varname>IPv6Forwarding=</varname>,
-          <varname>IPv6SendRA=</varname>, or <varname>KeepMaster=</varname> is enabled. Otherwise, enabled by
-          default. Cannot be enabled on devices aggregated in a bond device or when link-local addressing is
-          disabled.</para>
+          on the link.</para>
+
+          <para>This cannot be enabled on devices aggregated in a bond device, or when IPv6 link-local
+          addressing (see <varname>LinkLocalAddressing=</varname>) or multicasting (see
+          <varname>Multicast=</varname>) is disabled. Note, multicasting is disabled by default for some
+          configurations, e.g. bridge ports. Hence, in that case <varname>Multicast=</varname> needs to be
+          explicitly enabled to make this feature usable. When <varname>IPv6SendRA=</varname>,
+          <varname>IPv6Forwarding=</varname>, or <varname>IPMasquerade=</varname> is enabled, this feature is
+          disabled by default, but can be overridden by explicitly enabling this setting. Note,
+          <varname>IPv6Forwarding=</varname> may be indirectly enabled when the global setting with the same
+          name is enabled, or when <varname>IPMasquerade=</varname> is enabled on <emphasis>any other
+          interfaces</emphasis>. See also <varname>IPv6Forwarding=</varname> and
+          <varname>IPMasquerade=</varname> for more details. Enabled by default otherwise.</para>
 
           <para>Further settings for the IPv6 RA support may be configured in the [IPv6AcceptRA]
           section, see below.</para>