summaryrefslogtreecommitdiffstats
path: root/systemd
diff options
context:
space:
mode:
authorTomas Krizek <tomas.krizek@nic.cz>2019-05-22 13:43:32 +0200
committerTomas Krizek <tomas.krizek@nic.cz>2019-05-22 14:00:17 +0200
commiteb22dfe85e32a20f29fe1c99b9b3984a70c4a647 (patch)
treee6eb6a9b777c6a2275f8c50d2835eeed70e2de8b /systemd
parentsystemd: omit unneeded IP from ListenStream/Datagram (diff)
downloadknot-resolver-eb22dfe85e32a20f29fe1c99b9b3984a70c4a647.tar.xz
knot-resolver-eb22dfe85e32a20f29fe1c99b9b3984a70c4a647.zip
systemd: add note about locahost defaults
Diffstat (limited to 'systemd')
-rw-r--r--systemd/kresd.systemd.7.in22
1 files changed, 18 insertions, 4 deletions
diff --git a/systemd/kresd.systemd.7.in b/systemd/kresd.systemd.7.in
index d1f815cd..f7452588 100644
--- a/systemd/kresd.systemd.7.in
+++ b/systemd/kresd.systemd.7.in
@@ -28,7 +28,15 @@ system-kresd.slice
This manual page describes how to manage \fBkresd\fR using \fBsystemd\fR
units.
-.B Socket activation
+.B QUICKSTART
+
+.nf
+.RS 4n
+\fBsystemctl start kresd@1\fR - single instance of kresd, responding on localhost
+.RE
+.fi
+
+.B SOCKET ACTIVATION
\fBkresd\fR integration with systemd takes advantage of socket activation,
which enables the daemon to run without super user priviledges or any
@@ -49,9 +57,15 @@ these systemd sockets associated with it:
.RE
.fi
-.B Configuring network interfaces
+.B CONFIGURING NETWORK INTERFACES
+
+By default, \fBkresd is configured to listen on localhost\fR (see ports above).
+You MUST NOT repeat these defaults in the following drop-in overrides,
+otherwise the socket will fail to start with "Address in use" error. To view
+the entire socket configuration, including any drop-ins, use \fBsystemctl
+cat\fR.
-To configure \fBkresd\fR to listen on public interfaces, drop-in files (see
+To configure \fBkresd\fR to listen on \fBpublic interfaces\fR, drop-in files (see
\fIsystemd.unit\fR(5)) should be used. These can be created with:
.nf
@@ -132,7 +146,7 @@ is unlikely.
For more detailed socket configuration, see \fBsystemd.socket\fR(5).
-.B Concurrent daemons
+.B CONCURRENT DAEMONS
\fBkresd\fR daemon can be executed in multiple independent processes, which are
managed with \fBsystemd\fR via systemd templates (see \fBsystemd.unit\fR(5)).