]> git.ipfire.org Git - thirdparty/pdns.git/commitdiff
auth, rec: update option text and docs to clarify logging is to stderr, not stdout 12989/head
authorPeter van Dijk <peter.van.dijk@powerdns.com>
Wed, 5 Jul 2023 20:07:29 +0000 (22:07 +0200)
committerPeter van Dijk <peter.van.dijk@powerdns.com>
Fri, 22 Mar 2024 18:11:32 +0000 (19:11 +0100)
docs/settings.rst
pdns/auth-main.cc
pdns/recursordist/docs/running.rst
pdns/recursordist/settings/table.py

index 9d68d0c82af6cf01a33a434e008ee67977926394..4bd55ea8ad6851e57191e7b0f30369f37b15a804 100644 (file)
@@ -601,7 +601,7 @@ regression testing.
 -  Boolean
 -  Default: no
 
-Do not log to syslog, only to stdout. Use this setting when running
+Do not log to syslog, only to stderr. Use this setting when running
 inside a supervisor that handles logging (like systemd).
 
 .. warning::
@@ -961,7 +961,7 @@ to at least 5 to see the logs.
 - Bool
 - Default: yes
 
-When printing log lines to stdout, prefix them with timestamps.
+When printing log lines to stderr, prefix them with timestamps.
 Disable this if the process supervisor timestamps these lines already.
 
 .. note::
index 4155b743de5650089cf7d7b7a3c074c29544fae3..26db997eb5597db7072ab330affe55385fb7b338 100644 (file)
@@ -195,7 +195,7 @@ static void declareArguments()
   ::arg().set("control-console", "Debugging switch - don't use") = "no"; // but I know you will!
   ::arg().set("loglevel", "Amount of logging. Higher is more. Do not set below 3") = "4";
   ::arg().setSwitch("loglevel-show", "Include log level indicator in log output") = "no";
-  ::arg().set("disable-syslog", "Disable logging to syslog, useful when running inside a supervisor that logs stdout") = "no";
+  ::arg().set("disable-syslog", "Disable logging to syslog, useful when running inside a supervisor that logs stderr") = "no";
   ::arg().set("log-timestamp", "Print timestamps in log lines") = "yes";
   ::arg().set("distributor-threads", "Default number of Distributor (backend) threads to start") = "3";
   ::arg().set("signing-threads", "Default number of signer threads to start") = "3";
index c979e35efbd1113e360af384299bdbc1b09c660f..19473ad88100d11ba97e10118cb63e67aee33187 100644 (file)
@@ -9,7 +9,7 @@ Logging
 In a production environment, you will want to be able to monitor PowerDNS performance.
 Furthermore, PowerDNS can perform a configurable amount of operational logging.
 
-On modern Linux distributions, the PowerDNS recursor logs to stdout, which is consumed by ``systemd-journald``.
+On modern Linux distributions, the PowerDNS recursor logs to stderr, which is consumed by ``systemd-journald``.
 This means that looking into the logs that are produced, `journalctl <https://www.freedesktop.org/software/systemd/man/journalctl.html>`_ can be used::
 
     # journalctl -u pdns-recursor -n 100
index 0d9da85d4540f4e8e6031d5758ff51640b25d6f9..d47cd58df881eca07db3f40c83fccdb1ac4412a2 100644 (file)
@@ -535,9 +535,9 @@ Turn off the packet cache. Useful when running with Lua scripts that cannot be c
         'section' : 'logging',
         'type' : LType.Bool,
         'default' : 'false',
-        'help' : 'Disable logging to syslog, useful when running inside a supervisor that logs stdout',
+        'help' : 'Disable logging to syslog, useful when running inside a supervisor that logs stderr',
         'doc' : '''
-Do not log to syslog, only to stdout.
+Do not log to syslog, only to stderr.
 Use this setting when running inside a supervisor that handles logging (like systemd).
 **Note**: do not use this setting in combination with :ref:`setting-daemon` as all logging will disappear.
  ''',
@@ -1261,7 +1261,7 @@ If an address in :ref:`setting-local-address` does not have an explicit port, th
         'oldname' : 'log-timestamp',
         'type' : LType.Bool,
         'default' : 'true',
-        'help' : 'Print timestamps in log lines, useful to disable when running with a tool that timestamps stdout already',
+        'help' : 'Print timestamps in log lines, useful to disable when running with a tool that timestamps stderr already',
         'doc' : '''
 
  ''',