From 8e24b345c5217c0030c0ca9d02a7ecdca2aca881 Mon Sep 17 00:00:00 2001
From: Lennart Poettering <lennart@poettering.net>
Date: Mon, 30 Oct 2023 18:05:42 +0100
Subject: [PATCH] man: document the new ip=link-local kernel cmdline option

---
 man/systemd-network-generator.service.xml | 23 ++++++++++++++++-------
 1 file changed, 16 insertions(+), 7 deletions(-)

diff --git a/man/systemd-network-generator.service.xml b/man/systemd-network-generator.service.xml
index 0eb98a96354..53d559edbf1 100644
--- a/man/systemd-network-generator.service.xml
+++ b/man/systemd-network-generator.service.xml
@@ -30,7 +30,7 @@
     <title>Description</title>
 
     <para><filename>systemd-network-generator.service</filename> is a system service that translates
-    <varname>ip=</varname> and the related settings on the kernel command line (see below) into
+    <varname>ip=</varname> and related settings on the kernel command line (see below) into
     <citerefentry><refentrytitle>systemd.network</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
     <citerefentry><refentrytitle>systemd.netdev</refentrytitle><manvolnum>5</manvolnum></citerefentry>, and
     <citerefentry><refentrytitle>systemd.link</refentrytitle><manvolnum>5</manvolnum></citerefentry>
@@ -59,8 +59,15 @@
         <term><varname>rd.route=</varname></term>
         <term><varname>rd.peerdns=</varname></term>
         <listitem>
-          <para>— translated into
-          <citerefentry><refentrytitle>systemd.network</refentrytitle><manvolnum>5</manvolnum></citerefentry> files.</para>
+          <para>Translated into
+          <citerefentry><refentrytitle>systemd.network</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+          files.</para>
+
+          <para>In addition to the parameters <citerefentry
+          project='man-pages'><refentrytitle>dracut.cmdline</refentrytitle><manvolnum>7</manvolnum></citerefentry>
+          defines the <varname>ip=</varname> option accepts the special value
+          <literal>link-local</literal>. If selected, the network interfaces will be configured for
+          link-local addressing (IPv4LL, IPv6LL) only, DHCP or IPv6RA will not be enabled.</para>
 
           <xi:include href="version-info.xml" xpointer="v245"/>
         </listitem>
@@ -70,8 +77,9 @@
         <term><varname>ifname=</varname></term>
         <term><varname>net.ifname-policy=</varname></term>
         <listitem>
-          <para>— translated into
-          <citerefentry><refentrytitle>systemd.link</refentrytitle><manvolnum>5</manvolnum></citerefentry> files.</para>
+          <para>Translated into
+          <citerefentry><refentrytitle>systemd.link</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+          files.</para>
 
           <xi:include href="version-info.xml" xpointer="v245"/>
         </listitem>
@@ -83,8 +91,9 @@
         <term><varname>bridge=</varname></term>
         <term><varname>bootdev=</varname></term>
         <listitem>
-          <para>— translated into
-          <citerefentry><refentrytitle>systemd.netdev</refentrytitle><manvolnum>5</manvolnum></citerefentry> files.</para>
+          <para>Translated into
+          <citerefentry><refentrytitle>systemd.netdev</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+          files.</para>
 
           <xi:include href="version-info.xml" xpointer="v245"/>
         </listitem>