From: Lennart Poettering <lennart@poettering.net>
Date: Wed, 8 Nov 2023 10:52:53 +0000 (+0100)
Subject: man: document that Domains=local bind the domain to unicast DNS, not mDNS
X-Git-Tag: v255-rc2~80^2~2
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=28e3359fdcf5590014a3f36da385e6aa1459f7da;p=thirdparty%2Fsystemd.git

man: document that Domains=local bind the domain to unicast DNS, not mDNS

Fixes: #28983
---

diff --git a/man/resolved.conf.xml b/man/resolved.conf.xml
index 8edd6c94ef3..d153865c6e3 100644
--- a/man/resolved.conf.xml
+++ b/man/resolved.conf.xml
@@ -107,6 +107,13 @@
         <citerefentry><refentrytitle>systemd-resolved.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>
         for details of how search and route-only domains are used.</para>
 
+        <para>Note that configuring the MulticastDNS domain <literal>local</literal> as search or routing
+        domain has the effect of routing lookups for this domain to classic unicast DNS. This may be used to
+        provide compatibility with legacy installations that use this domain in a unicast DNS context,
+        against the IANA assignment of this domain to pure MulticastDNS purposes. Search and routing domains
+        are a unicast DNS concept, they <emphasis>cannot</emphasis> be used to resolve single-label lookups
+        via MulticastDNS.</para>
+
         <xi:include href="version-info.xml" xpointer="v229"/>
         </listitem>
       </varlistentry>