Petr Špaček
901b6425d2
Merge branch 'marka-cobertura-replaced-by-coverage_report' into 'main'
...
Fix for GitLab 15.0: cobertura replaced by coverage_report
See merge request isc-projects/bind9!6512
2022-07-04 05:10:32 +00:00
Mark Andrews
008032d268
Fix for GitLab 15.0: cobertura replaced by coverage_report
...
From Gitlab 15.0 release notes:
artifacts:reports:cobertura keyword
As of GitLab 15.0, the artifacts:reports:cobertura keyword has
been replaced by artifacts:reports:coverage_report. Cobertura
is the only supported report file, but this is the first step
towards GitLab supporting other report types.
2022-07-04 13:52:30 +10:00
Arаm Sаrgsyаn
3076231d6f
Merge branch '3398-placeholder' into 'main'
...
Add placeholder for [GL #3398 ]
See merge request isc-projects/bind9!6508
2022-07-01 08:41:18 +00:00
Aram Sargsyan
5e8778df6a
Add placeholder for [GL #3398 ]
2022-07-01 08:36:51 +00:00
Petr Špaček
4a460fb420
Merge branch 'pspacek/arm-grammar-render' into 'main'
...
Render grammar snippets in the ARM
See merge request isc-projects/bind9!6491
2022-07-01 07:25:48 +00:00
Petr Špaček
908acd5d70
Add note that named.conf man page is not a complete manual
...
We cannot simply do URL because it would make our lives more complicated
with -S edition.
2022-07-01 08:59:24 +02:00
Petr Špaček
f5faddd08a
Cleanup tag filtering code for statementlist:: RST directive
...
Technically this is fixup for
33931c97faaa0f728b4194b8077825e75c351e12
but that commit is already merged.
2022-07-01 08:59:24 +02:00
Petr Špaček
d88fefbb4a
Add link anchor and hyperlinks to keys statement
...
This is super confusing because statement "keys" exists in context
controls and server blocks where it refers to symmetric TSIG key, and it
_also_ exists in dnssec-policy block where it specifies public-private
key pair parameters.
In an (unsuccessful) attempt to disambiguate these two I added bunch of
hyperlinks and a warning.
2022-07-01 08:59:24 +02:00
Petr Špaček
82e2f0b37e
Describe rndc server block using .. rndcconf syntax
...
We need to split the description to silence warnings about undescribed
statements.
2022-07-01 08:59:24 +02:00
Petr Špaček
10f88bffe5
Define default-source-address, default-source-address-v6 for rndc
2022-07-01 08:59:24 +02:00
Petr Špaček
1687b40849
Document ipv4only-* options in the ARM
...
Statements ipv4only-contact, ipv4only-enable, ipv4only-server did not
have their own section in the ARM. Now they have.
2022-07-01 08:59:23 +02:00
Petr Špaček
40b3ce727c
Add missing link anchor for dlz search statement
2022-07-01 08:59:23 +02:00
Petr Špaček
261bdc7358
Special-case zone in-view
...
It is not really a zone type, so let's not generate "type in-view"
anchor for it.
2022-07-01 08:59:23 +02:00
Petr Špaček
1af157eb20
Remove extra whitespace in grammar for null statement
2022-07-01 08:59:23 +02:00
Petr Špaček
08a8acffdc
Add ability to filter tables using blocks
...
A new syntax
.. namedconf:statementlist::
:filter_blocks: type secondary
allows to generate tables with statements allowed within specified
blocks.
2022-07-01 08:59:23 +02:00
Petr Špaček
5c04e3c524
Sort grammar map keys while pretty printing them
...
It would be too easy if we could just call sorted(). Thanks to zone
grammar the most important key "type" gets sorted near end, so we pull
it up to the top using a hack.
2022-07-01 08:59:23 +02:00
Petr Špaček
0392144e99
Pretty-print grammar for zones
...
It turns out the tree of dictionaries is not the best structure to
represent our grammar, unfortunatelly. The problem is that "zone" has
several context-dependent variants which change meaning of "zone" based
on inner field "type".
Redesigning the whole structure does not seem to be worth, so I settled
on this terrible hack.
2022-07-01 08:59:23 +02:00
Petr Špaček
435cbb61ba
Add zone definitions into the view grammar
...
I cannot see a reasonable way to achieve this without the hack in this
commit.
2022-07-01 08:59:23 +02:00
Petr Špaček
1f5bc4fe3b
Add option to suppress grammar rendering
...
A new flag
.. namedconf:statement::
:suppress_grammar:
suppresses pretty-printing grammar.
It is useful mostly for zones because each zone has it's own grammar, so
printing all of them at once usually does not make sense.
2022-07-01 08:59:23 +02:00
Petr Špaček
0bbbdc6244
Remove auto-generated rst files in repo in favour of grammar pretty printer
2022-07-01 08:59:23 +02:00
Petr Špaček
7b4ad8a3ff
Warn about experimental and deprecated options
2022-07-01 08:59:23 +02:00
Petr Špaček
c6fe8970f6
Render statement's grammar
...
This is replacement for auto-generated *.rst files stored in the repo.
2022-07-01 08:59:23 +02:00
Petr Špaček
eba3b1ad16
Render list of blocks accepting a given statement
2022-07-01 08:59:23 +02:00
Petr Špaček
d61d998e3b
Detect unsupported statement:: directives with multiple names
2022-07-01 08:59:23 +02:00
Petr Špaček
ebe6ede2ec
Warn about statements not found in the grammar
2022-07-01 08:59:23 +02:00
Petr Špaček
cbad1803a5
Warn about statements in grammar not described in docs
...
Skip over obsolete options.
2022-07-01 08:59:22 +02:00
Petr Špaček
1c6f2c5ad1
Give Sphinx configuration domains access to grammar
2022-07-01 08:59:22 +02:00
Petr Špaček
a691ebd0c9
Add helper to unify options and zone block grammars
...
A helper is needed to combine cfg_test output for generic options and
all the type-dependent zone block variants.
2022-07-01 08:59:22 +02:00
Petr Špaček
190004e46c
Add pretty printer for JSON grammar
...
It produces the same format as cfg_test --grammar. The advantage is that
it allows to print any node in configuration the tree, not just whole
blocks.
2022-07-01 08:59:22 +02:00
Petr Špaček
8960d51aa3
Add utility to search for context-dependent configuration statements
...
The utility detects statements which use the same name (e.g.
max-zone-ttl) but use different grammar in different contexts. These
typically need special case in docs.
2022-07-01 08:59:22 +02:00
Petr Špaček
df08982930
Add a new library to parse grammar format produced by cfg_test
...
It transforms named.conf/rndc.conf grammar from text format into Python
dictionary. This allows granular access to grammar elements.
Beware: It heavity depens on cfg_test output format!
2022-07-01 08:59:04 +02:00
Petr Špaček
fb474de3ab
Add rndc.conf grammar into doc/misc
...
It uses the same mechanism as all other grammars, but the file is named
differently to distinguish it from named.conf grammars.
2022-07-01 08:56:35 +02:00
Petr Špaček
699570cdec
Un-format grammar files in doc/misc
...
The next commit is going to add parser for ISC configuration format.
To simplify the parser the grammar files in doc/misc are no longer
line-wrapped as handling it would make the grammar parser unnecessairly
complicated.
This affects visible output in the ARM, but in the end we are going to
replace the auto-generated .rst files with grammar pretty printed, so
formatting of these files does not matter in practical terms.
2022-07-01 08:56:33 +02:00
Petr Špaček
af3683f436
Add missing comment markers to doc/misc/ grammar files
...
These files can be consumed by scripts, so obviously missing comment
markers wreak havoc.
2022-06-30 19:00:17 +02:00
Petr Špaček
b18fa6c7b2
Merge branch 'sgoldlust/arm-tag-query-transfer' into 'main'
...
Add tags and short descriptions for query and transfer statements
See merge request isc-projects/bind9!6502
2022-06-30 16:11:30 +00:00
Petr Špaček
563eb8e1b9
Accept rst syntax in .. statement:: short: text
...
Nested rst syntax is now parsed and rendered. E.g.:
.. namedconf:statement:: example
:short: Use ``this`` **cool** syntax!
2022-06-30 18:04:44 +02:00
Petr Špaček
0e7ca5b5e0
Disambiguate address_match_list link anchor
...
Let's keep just the :term: produced by grammar glossary.
2022-06-30 18:04:41 +02:00
Suzanne Goldlust
3cf976bd78
Add the :tags: and :short: descriptions for the category "transfer"
2022-06-30 18:04:40 +02:00
Suzanne Goldlust
7187a5cf77
Add the :tags: and :short: descriptions for the category "query"
2022-06-30 18:04:40 +02:00
Petr Špaček
2630cf8e76
Resurrect DNS NOTIFY chapter in the ARM
...
It was accidentally removed in the heat of
25eb91d23c5a2056f36902c90dfe8ca69f6a9400.
2022-06-30 18:04:40 +02:00
Michał Kępień
692fb3eedd
Merge branch '2147-obsolete-the-glue-cache-option' into 'main'
...
Obsolete the "glue-cache" option
Closes #2147
See merge request isc-projects/bind9!6500
2022-06-30 13:27:54 +00:00
Michał Kępień
f0d2d3c03f
Add CHANGES entry and release note for GL #2147
2022-06-30 15:24:08 +02:00
Michał Kępień
887c666caf
Obsolete the "glue-cache" option
...
The "glue-cache" option was marked as deprecated by commit
5ae33351f286feb25a965bf3c9e6b122ab495342 (first released in BIND 9.17.6,
back in October 2020), so now obsolete that option, removing all code
and documentation related to it.
Note: this causes the glue cache feature to be permanently enabled, not
disabled.
2022-06-30 15:24:08 +02:00
Michal Nowak
3fb7ab8476
Merge branch '2371-add-stress-testing-with-rpz' into 'main'
...
Run the "stress" test in RPZ mode in GitLab CI
Closes #2371
See merge request isc-projects/bind9!4526
2022-06-28 18:36:30 +00:00
Michal Nowak
d272574653
Add stress testing with RPZ
2022-06-28 20:32:37 +02:00
Petr Špaček
accc2440ee
Merge branch '3408-drop-debian-9-stretch' into 'main'
...
Drop support for Debian 9 (Stretch)
See merge request isc-projects/bind9!6486
2022-06-28 15:56:06 +00:00
Petr Špaček
4ce1f25210
Declare Debian 9 (Stretch) community-maintained
2022-06-28 17:54:48 +02:00
Petr Špaček
aa86a8bcf0
Drop Debian 9 (Stretch) from CI
2022-06-28 17:54:44 +02:00
Artem Boldariev
7a90169fee
Merge branch '3415-update-http-listeners-on-reconfig' into 'main'
...
Update HTTP listeners settings on reconfiguration
Closes #3415
See merge request isc-projects/bind9!6482
2022-06-28 13:10:20 +00:00
Artem Boldariev
7822670d0f
doth test: extend with HTTP endpoints reconfiguration check
...
This commit add a check which verifies that HTTP endpoints are being
picked up properly by the BIND instance on a reconfiguration.
2022-06-28 15:43:19 +03:00