mir/bind
2
0
Fork 0
mirror of https://gitlab.isc.org/isc-projects/bind9 synced 2025-08-30 14:07:59 +00:00
Code Issues Releases Wiki Activity

Merge branch '2850-the-list-of-fetches-at-the-end-of-rndc-recursing-output-is-very-poorly-explained-in-the-arm' into 'main'

Browse Source 
Resolve "The list of fetches at the end of 'rndc recursing' output is very poorly explained in the ARM - what does 'allowed' mean?"

Closes #2850

See merge request isc-projects/bind9!5388
This commit is contained in:
Mark Andrews
2021-11-30 11:30:47 +00:00
parent db2aad0e96 65f6d8af75
commit 17d9a74681
3 changed files with 43 additions and 16 deletions
Download Patch File Download Diff File Expand all files Collapse all files

23
bin/rndc/rndc.rst
View File

@@ -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.

13
doc/arm/reference.rst
View File

@@ -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

23
doc/man/rndc.8in
View File

@@ -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.