summaryrefslogtreecommitdiff
path: root/man/nss-mymachines.xml
diff options
context:
space:
mode:
authorLennart Poettering <lennart@poettering.net>2021-05-26 11:10:18 +0200
committerLuca Boccassi <luca.boccassi@gmail.com>2021-05-26 12:45:20 +0100
commit74c88a25203e7db293ca7a1c31b789e6558129fd (patch)
treec947b6023c3d655c885b0a3743d9e45d63bd6be9 /man/nss-mymachines.xml
parent7dbc38db509f153256d3a3bfe6cbb26e2731c741 (diff)
downloadsystemd-74c88a25203e7db293ca7a1c31b789e6558129fd.tar.gz
man: try to clarify that nss-mymachines does not provide name resolution outside its own scope
Fixes: #18229
Diffstat (limited to 'man/nss-mymachines.xml')
-rw-r--r--man/nss-mymachines.xml9
1 files changed, 9 insertions, 0 deletions
diff --git a/man/nss-mymachines.xml b/man/nss-mymachines.xml
index 03fcd4308e..baec10954b 100644
--- a/man/nss-mymachines.xml
+++ b/man/nss-mymachines.xml
@@ -39,6 +39,15 @@
Note that the name that is resolved is the one registered with <command>systemd-machined</command>, which
may be different than the hostname configured inside of the container.</para>
+ <para>Note that this NSS module only makes available names of the containers running immediately below
+ the current system context. It does not provide host name resolution for containers running side-by-side
+ with the invoking system context, or containers further up or down the container hierarchy. Or in other
+ words, on the host system it provides host name resolution for the containers running immediately below
+ the host environment. When used inside a container environment however, it will not be able to provide
+ name resolution for containers running on the host (as those are siblings and not children of the current
+ container environment), but instead only for nested containers running immediately below its own
+ container environment.</para>
+
<para>To activate the NSS module, add <literal>mymachines</literal> to the line starting with
<literal>hosts:</literal> in <filename>/etc/nsswitch.conf</filename>.</para>