From 924ccc35f95cabbcb475a659f4a2e2f4cd9ff7c6 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Zbigniew=20J=C4=99drzejewski-Szmek?= Date: Sun, 19 Apr 2020 22:01:21 +0200 Subject: [PATCH] man: add a note that resolvconf updates /etc/resolv.conf in specific circumstances When someone knows how the whole ecosystem works, this is understandable. But for someone coming from a system where resolvconf updates /etc/resolv.conf directly, this can be rather surprising. For https://bugzilla.redhat.com/show_bug.cgi?id=1815605. --- man/resolvectl.xml | 12 ++++++++++-- 1 file changed, 10 insertions(+), 2 deletions(-) diff --git a/man/resolvectl.xml b/man/resolvectl.xml index 594e22c03f..4911980823 100644 --- a/man/resolvectl.xml +++ b/man/resolvectl.xml @@ -297,8 +297,16 @@ systemd-resolved.service8, similar to how and commands operate. Note that systemd-resolved.service is the only supported backend, which is different from other - implementations of this command. Note that not all operations supported by other implementations are supported - natively. Specifically: + implementations of this command. + + /etc/resolv.conf will only be updated with servers added with this command + when /etc/resolv.conf is a symlink to + /run/systemd/resolve/resolv.conf, and not a static file. See the discussion of + /etc/resolv.conf handling in + systemd-resolved.service8. + + + Not all operations supported by other implementations are supported natively. Specifically: