]> git.ipfire.org Git - thirdparty/systemd.git/commitdiff
man: fix SendHostname= and Hostname= descriptions to allow multi-label DNS names...
authorMalcolm Frazier <malcolm@opscode.io>
Sun, 8 Mar 2026 02:18:56 +0000 (18:18 -0800)
committerYu Watanabe <watanabe.yu+github@gmail.com>
Mon, 9 Mar 2026 00:42:21 +0000 (09:42 +0900)
man/systemd.network.xml

index 58dae4f948c7e171617682f9221a8a5c445352d1..4c777ef4e0876d4a3ddf36b424cca44860306d6b 100644 (file)
@@ -2382,9 +2382,12 @@ MultiPathRoute=2001:db8::1@eth0</programlisting>
         <listitem>
           <para>When true (the default), the machine's hostname (or the value specified with
           <varname>Hostname=</varname>, described below) will be sent to the DHCP server. Note that the
-          hostname must consist only of 7-bit ASCII lower-case characters and no spaces or dots, and be
-          formatted as a valid DNS domain name. Otherwise, the hostname is not sent even if this option
-          is true.</para>
+          hostname must consist only of 7-bit ASCII lower-case characters and no spaces, and be
+          formatted as a valid DNS domain name. A single-label hostname is sent as DHCP option 12
+          (Host Name, <ulink url="https://tools.ietf.org/html/rfc2132">RFC 2132</ulink>);
+          a multi-label hostname (FQDN) is sent instead as DHCP option 81 (Client FQDN,
+          <ulink url="https://tools.ietf.org/html/rfc4702">RFC 4702</ulink>).
+          Otherwise, the hostname is not sent even if this option is true.</para>
 
           <xi:include href="version-info.xml" xpointer="v215"/>
         </listitem>
@@ -2395,7 +2398,8 @@ MultiPathRoute=2001:db8::1@eth0</programlisting>
         <listitem>
           <para>Use this value for the hostname which is sent to the DHCP server, instead of machine's
           hostname. Note that the specified hostname must consist only of 7-bit ASCII lower-case
-          characters and no spaces or dots, and be formatted as a valid DNS domain name.</para>
+          characters and no spaces, and be formatted as a valid DNS domain name. Multi-label hostnames
+          (FQDNs) are acceptable; see <varname>SendHostname=</varname> above for details.</para>
 
           <xi:include href="version-info.xml" xpointer="v223"/>
         </listitem>