From 65f6d8af75d99de22f667149435d68d3862cda36 Mon Sep 17 00:00:00 2001 From: Mark Andrews Date: Wed, 8 Sep 2021 13:51:07 +1000 Subject: [PATCH] Update the description of fetches-per-zone counters --- bin/rndc/rndc.rst | 23 ++++++++++++++++++----- doc/arm/reference.rst | 13 +++++++------ doc/man/rndc.8in | 23 ++++++++++++++++++----- 3 files changed, 43 insertions(+), 16 deletions(-) diff --git a/bin/rndc/rndc.rst b/bin/rndc/rndc.rst index b8f0cfe43a..f95859ea38 100644 --- a/bin/rndc/rndc.rst +++ b/bin/rndc/rndc.rst @@ -370,11 +370,24 @@ Currently supported commands are: avoids the need to examine the modification times of the zone files. ``recursing`` - This command dumps the list of queries ``named`` is currently recursing on, and the - list of domains to which iterative queries are currently being sent. - The second list includes the number of fetches currently active for - the given domain, and how many have been passed or dropped because of - the ``fetches-per-zone`` option. + This command dumps the list of queries ``named`` is currently + recursing on, and the list of domains to which iterative queries + are currently being sent. + + The first list includes all unique clients that are waiting for + recursion to complete, including the query that is awaiting a + response and the timestamp (seconds since the Unix epoch) of + when named started processing this client query. + + The second list comprises of domains for which there are active + (or recently active) fetches in progress. It reports the number + of active fetches for each domain and the number of queries that + have been passed (allowed) or dropped (spilled) as a result of + the ``fetches-per-zone`` limit. (Note: these counters are not + cumulative over time; whenever the number of active fetches for + a domain drops to zero, the counter for that domain is deleted, + and the next time a fetch is sent to that domain, it is recreated + with the counters set to zero). ``refresh`` *zone* [*class* [*view*]] This command schedules zone maintenance for the given zone. diff --git a/doc/arm/reference.rst b/doc/arm/reference.rst index c69148989c..3db804154c 100644 --- a/doc/arm/reference.rst +++ b/doc/arm/reference.rst @@ -2998,12 +2998,13 @@ system. The current list of active fetches can be dumped by running ``rndc recursing``. The list includes the number of active fetches - for each domain and the number of queries that have been passed or - dropped as a result of the ``fetches-per-zone`` limit. (Note: these - counters are not cumulative over time; whenever the number of active - fetches for a domain drops to zero, the counter for that domain is - deleted, and the next time a fetch is sent to that domain, it is - recreated with the counters set to zero.) + for each domain and the number of queries that have been passed + (allowed) or dropped (spilled) as a result of the ``fetches-per-zone`` + limit. (Note: these counters are not cumulative over time; + whenever the number of active fetches for a domain drops to zero, + the counter for that domain is deleted, and the next time a fetch + is sent to that domain, it is recreated with the counters set + to zero.) ``fetches-per-server`` This sets the maximum number of simultaneous iterative queries that the server diff --git a/doc/man/rndc.8in b/doc/man/rndc.8in index e6dd0f140f..d80a0f33e4 100644 --- a/doc/man/rndc.8in +++ b/doc/man/rndc.8in @@ -372,11 +372,24 @@ full \fBreload\fP when there is a large number of zones, because it avoids the need to examine the modification times of the zone files. .TP .B \fBrecursing\fP -This command dumps the list of queries \fBnamed\fP is currently recursing on, and the -list of domains to which iterative queries are currently being sent. -The second list includes the number of fetches currently active for -the given domain, and how many have been passed or dropped because of -the \fBfetches\-per\-zone\fP option. +This command dumps the list of queries \fBnamed\fP is currently +recursing on, and the list of domains to which iterative queries +are currently being sent. +.sp +The first list includes all unique clients that are waiting for +recursion to complete, including the query that is awaiting a +response and the timestamp (seconds since the Unix epoch) of +when named started processing this client query. +.sp +The second list comprises of domains for which there are active +(or recently active) fetches in progress. It reports the number +of active fetches for each domain and the number of queries that +have been passed (allowed) or dropped (spilled) as a result of +the \fBfetches\-per\-zone\fP limit. (Note: these counters are not +cumulative over time; whenever the number of active fetches for +a domain drops to zero, the counter for that domain is deleted, +and the next time a fetch is sent to that domain, it is recreated +with the counters set to zero). .TP .B \fBrefresh\fP \fIzone\fP [\fIclass\fP [\fIview\fP]] This command schedules zone maintenance for the given zone.