From dfd8f305ef6974426b49c0177e991f098fb88101 Mon Sep 17 00:00:00 2001 From: Josh Soref Date: Thu, 31 May 2018 05:20:15 +0000 Subject: [PATCH] Recursor: try to document how to handle systemd private tmp --- .../docs/manpages/rec_control.1.rst | 32 +++++++++++++++++++ 1 file changed, 32 insertions(+) diff --git a/pdns/recursordist/docs/manpages/rec_control.1.rst b/pdns/recursordist/docs/manpages/rec_control.1.rst index 3692416fd..a54af53ca 100644 --- a/pdns/recursordist/docs/manpages/rec_control.1.rst +++ b/pdns/recursordist/docs/manpages/rec_control.1.rst @@ -74,23 +74,55 @@ dump-cache *FILENAME* also dumped to the same file. The per-thread positive and negative cache dumps are separated with an appropriate comment. + .. note:: + + :program:`pdns_recursor` often runs in a chroot. You can + retrieve the file using:: + + rec_control dump-cache /tmp/file + mv /proc/$(pidof pdns_recursor)/root/tmp/file /tmp/filename + dump-edns *FILENAME* Dumps the EDNS status to the filename mentioned. This file should not exist already, PowerDNS will refuse to overwrite it. While dumping, the recursor will not answer questions. + .. note:: + + :program:`pdns_recursor` often runs in a chroot. You can + retrieve the file using:: + + rec_control dump-edns /tmp/file + mv /proc/$(pidof pdns_recursor)/root/tmp/file /tmp/filename + dump-nsspeeds *FILENAME* Dumps the nameserver speed statistics to the *FILENAME* mentioned. This file should not exist already, PowerDNS will refuse to overwrite it. While dumping, the recursor will not answer questions. Statistics are kept per thread, and the dumps end up in the same file. + .. note:: + + :program:`pdns_recursor` often runs in a chroot. You can + retrieve the file using:: + + rec_control dump-nsspeeds /tmp/file + mv /proc/$(pidof pdns_recursor)/root/tmp/file /tmp/filename + dump-rpz *ZONE NAME* *FILE NAME* Dumps the content of the RPZ zone named *ZONE NAME* to the *FILENAME* mentioned. This file should not exist already, PowerDNS will refuse to overwrite it otherwise. While dumping, the recursor will not answer questions. + .. note:: + + :program:`pdns_recursor` often runs in a chroot. You can + retrieve the file using:: + + rec_control dump-rpz ZONE_NAME /tmp/file + mv /proc/$(pidof pdns_recursor)/root/tmp/file /tmp/filename + get *STATISTIC* [*STATISTIC*]... Retrieve a statistic. For items that can be queried, see :doc:`../metrics` -- 2.40.0