doc/operation: add the Logging section, describe log rotation methods

diff --git a/doc/man/knotc.8in b/doc/man/knotc.8in
index 8c1e4a02ed379e8a0cf1dad7d9fad40c5f6030a9..87242dd3361d603d9237b3e494359cd12461781e 100644 (file)
--- a/doc/man/knotc.8in
+++ b/doc/man/knotc.8in
@@ -104,8 +104,8 @@ public key pin of the currently used certificate.
 Stop the server if running.
 .TP
 \fBreload\fP
-Reload the server configuration and modified zone files. All open zone
-transactions will be aborted!
+Reload the server configuration and modified zone files, and reopen the log files
+if they are configured. All open zone transactions will be aborted!
 .TP
 \fBstats\fP [\fImodule\fP[\fB\&.\fP\fIcounter\fP]]
 Show global statistics counter(s). To print also counters with value 0, use

diff --git a/doc/man_knotc.rst b/doc/man_knotc.rst
index 46ba5e6f677f8f244c8eebe46326f4cc589340ed..55f4dfaffe1bfb839721666569f57a6b63781cc7 100644 (file)
--- a/doc/man_knotc.rst
+++ b/doc/man_knotc.rst
@@ -81,8 +81,8 @@ Actions
   Stop the server if running.
 
 **reload**
-  Reload the server configuration and modified zone files. All open zone
-  transactions will be aborted!
+  Reload the server configuration and modified zone files, and reopen the log files
+  if they are configured. All open zone transactions will be aborted!
 
 **stats** [*module*\ [\ **.**\ *counter*\ ]]
   Show global statistics counter(s). To print also counters with value 0, use

diff --git a/doc/operation.rst b/doc/operation.rst
index 8058598498f5edfe63197353406440afc57f26f1..93c6103eecc33d0c880f4116284043254b636682 100644 (file)
--- a/doc/operation.rst
+++ b/doc/operation.rst
@@ -1170,6 +1170,21 @@ If you want to refresh the secondary zones, you can do this with::
 
     $ knotc zone-refresh
 
+.. _Logging:
+
+Logging
+=======
+
+Knot DNS supports :ref:`logging<log section>` to ``syslog`` or ``systemd-journald``
+facility, to a specified file, to standard output, or to standard error output.
+Several different logging targets may be used in parallel.
+
+If ``syslog`` or ``systemd-journald`` is used for logging, log rotation is handled
+by that logging facility. When logging to a specified file, log rotation should
+be done by moving the current log file followed by reopening of the log file with
+either ``knotc -b reload`` or by sending ``SIGHUP`` to the ``knotd`` process (see the
+:ref:`server_pidfile`).
+
 .. _Data and metadata backup:
 
 Data and metadata backup