From 71a886518b4ba22029d45e4c9bd5d2f52fb32751 Mon Sep 17 00:00:00 2001 From: Yu Watanabe Date: Tue, 15 Oct 2024 14:15:31 +0900 Subject: [PATCH] man: update documents of "_outbound" addresses Follow-up for 4adf2653e2a68d4d593b46734fd9e24721a8d449. Addresses https://github.com/systemd/systemd/issues/34739#issuecomment-2412904739. --- man/nss-myhostname.xml | 11 ++++++----- man/systemd-resolved.service.xml | 11 ++++++----- 2 files changed, 12 insertions(+), 10 deletions(-) diff --git a/man/nss-myhostname.xml b/man/nss-myhostname.xml index e0cfffe023e..200c9220b99 100644 --- a/man/nss-myhostname.xml +++ b/man/nss-myhostname.xml @@ -53,11 +53,12 @@ current network configuration state. The hostname _outbound 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. + addresses that are most likely used for communication with other hosts. This is the preferred source + addresses of default gateways if specified, or 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. Various software relies on an always-resolvable local diff --git a/man/systemd-resolved.service.xml b/man/systemd-resolved.service.xml index 8d22b22e850..210a8432336 100644 --- a/man/systemd-resolved.service.xml +++ b/man/systemd-resolved.service.xml @@ -118,11 +118,12 @@ useful for referencing it independently of the current network configuration state. The hostname _outbound 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. + addresses that are most likely used for communication with other hosts. This is the preferred source + addresses of default gateways if specified, or 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. The hostname _localdnsstub is resolved to the IP address 127.0.0.53, i.e. the address the local DNS stub (see above) is listening on.