From: Tomas Krizek Date: Thu, 18 Apr 2019 16:09:59 +0000 (+0200) Subject: doc/net: nitpicks and system-kresd.slice restart X-Git-Tag: v4.0.0~1^2~1 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=47b4fd2d90965877c6a5c79f03dd112cccf6ed8a;p=thirdparty%2Fknot-resolver.git doc/net: nitpicks and system-kresd.slice restart --- diff --git a/daemon/bindings/net.rst b/daemon/bindings/net.rst index f9920bf23..1109ed114 100644 --- a/daemon/bindings/net.rst +++ b/daemon/bindings/net.rst @@ -4,11 +4,11 @@ Network configuration ^^^^^^^^^^^^^^^^^^^^^ Modern Linux distributions use so-called *Systemd socket activation*, which -effectivelly means that IP addresses and ports to listen on are configured +effectively means that IP addresses and ports to listen on are configured in Systemd configuration files. Older Linux systems and all non-Linux systems do not support this modern method -and have to resort to old fashioned way of configuring things using +and have to resort to old fashioned way of configuring network interfaces using ``net.listen()`` configuration call. Most notable examples of such systems are CentOS 7 and macOS. @@ -31,7 +31,7 @@ Each protocol has its own configuration file: ":ref:`mod-http-doh`","``kresd-doh.socket``" ":ref:`Web management `","``kresd-webmgmt.socket``" -To configure kresd to listen on public a interface using the original DNS protocol, +To configure kresd to listen on a public interface using the original DNS protocol, create a drop-in file: .. code-block:: bash @@ -46,6 +46,10 @@ create a drop-in file: ListenDatagram=192.0.2.115:53 ListenStream=192.0.2.115:53 +.. note:: If you change network interfaces of systemd sockets for already running + kresd instance, make sure to call ``systemctl restart system-kresd.slice`` for + these changes to take effect. + Configuration you provide is automatically merged with defaults from your distribution. It is also possible to check resulting configuration using ``systemctl cat``: diff --git a/systemd/kresd.systemd.7.in b/systemd/kresd.systemd.7.in index 9dc49dd1e..32b28d271 100644 --- a/systemd/kresd.systemd.7.in +++ b/systemd/kresd.systemd.7.in @@ -62,6 +62,10 @@ To configure \fBkresd\fR to listen on public interfaces, drop-in files (see .RE .fi +If you change network interfaces of systemd sockets for already running kresd instance, +make sure to call \fBsystemctl restart system-kresd.slice\fR for these changes +to take effect. + For example, to configure \fBkresd\fR to listen on 192.0.2.115 on ports 53 and 853, the drop-in files would look like: