man: document _outbound

diff --git a/man/nss-myhostname.xml b/man/nss-myhostname.xml
index 8d5b549c3b142798a0f3afc389f49e5d15e8bcea..8a603fb9ce4ce3e1e690c0af138c9c36f30b2958 100644 (file)
--- a/man/nss-myhostname.xml
+++ b/man/nss-myhostname.xml
@@ -51,6 +51,13 @@
       ordered by their metric. This assigns a stable hostname to the
       current gateway, useful for referencing it independently of the
       current network configuration state.</para></listitem>
+
+      <listitem><para>The hostname <literal>_outbound</literal> is resolved to the local IPv4 and IPv6
+      addresses that are most likely used for communication with other hosts. This is determined by
+      requesting a routing decision to the configured default gateways from the kernel and then using the
+      local IP addresses selected by this decision. This hostname is only available if there is at least one
+      local default gateway configured. This assigns a stable hostname to the local outbound IP addresses,
+      useful for referencing them independently of the current network configuration state.</para></listitem>
     </itemizedlist>
 
     <para>Various software relies on an always-resolvable local

diff --git a/man/resolvectl.xml b/man/resolvectl.xml
index 6dd467445638287721c6a98bd62e2614925243c2..bd1a636d605a3267cfc2f1e2dc9d6db77f108f0f 100644 (file)
--- a/man/resolvectl.xml
+++ b/man/resolvectl.xml
@@ -299,11 +299,11 @@
 
         <listitem><para>Takes a boolean parameter; used in conjunction with <command>query</command>. If true
         (the default), select domains are resolved on the local system, among them
-        <literal>localhost</literal> and <literal>_gateway</literal> or entries from
-        <filename>/etc/hosts</filename>. If false these domains are not resolved locally, and either fail (in
-        case of <literal>localhost</literal> or <literal>_gateway</literal> and suchlike) or go to the
-        network via regular DNS/mDNS/LLMNR lookups (in case of <filename>/etc/hosts</filename>
-        entries).</para></listitem>
+        <literal>localhost</literal>, <literal>_gateway</literal> and <literal>_outbound</literal>, or
+        entries from <filename>/etc/hosts</filename>. If false these domains are not resolved locally, and
+        either fail (in case of <literal>localhost</literal>, <literal>_gateway</literal> or
+        <literal>_outbound</literal> and suchlike) or go to the network via regular DNS/mDNS/LLMNR lookups
+        (in case of <filename>/etc/hosts</filename> entries).</para></listitem>
       </varlistentry>
 
       <varlistentry>

diff --git a/man/systemd-resolved.service.xml b/man/systemd-resolved.service.xml
index ed6214cd625b23362fac6c86726cdeaf50955bf9..9c7c482549d4a9cc728461838e6368db42f09f55 100644 (file)
--- a/man/systemd-resolved.service.xml
+++ b/man/systemd-resolved.service.xml
@@ -104,6 +104,13 @@
       gateway addresses, ordered by their metric. This assigns a stable hostname to the current gateway,
       useful for referencing it independently of the current network configuration state.</para></listitem>
 
+      <listitem><para>The hostname <literal>_outbound</literal> is resolved to the local IPv4 and IPv6
+      addresses that are most likely used for communication with other hosts. This is determined by
+      requesting a routing decision to the configured default gateways from the kernel and then using the
+      local IP addresses selected by this decision. This hostname is only available if there is at least one
+      local default gateway configured. This assigns a stable hostname to the local outbound IP addresses,
+      useful for referencing them independently of the current network configuration state.</para></listitem>
+
       <listitem><para>The mappings defined in <filename>/etc/hosts</filename> are resolved to their
       configured addresses and back, but they will not affect lookups for non-address types (like MX).
       Support for <filename>/etc/hosts</filename> may be disabled with <varname>ReadEtcHosts=no</varname>,