docs: Add BIND9 version comparison and migration guidance
- Generate BIND_VERSION_DIFFERENCES.md with detailed grammar comparison - Document 44 breaking changes between BIND9 9.18.44 and 9.20.18 - Document 35 new options and 22 modified options in BIND9 9.20 - Document 3 newly deprecated options - Add version compatibility section to CONFIGURATION_GRAMMAR.md - Update CHANGELOG.md with version differences details - Include migration guide for upgrading from 9.18 to 9.20 Closes #11
This commit is contained in:
Daniel Akulenok
326
docs/bind_version_comparison.json
Normal file
326
docs/bind_version_comparison.json
Normal file
@@ -0,0 +1,326 @@
|
||||
{
|
||||
"options": {
|
||||
"file": "options",
|
||||
"added": [
|
||||
"allow-proxy",
|
||||
"allow-proxy-on",
|
||||
"cdnskey",
|
||||
"cds-digest-types",
|
||||
"check-svcb",
|
||||
"cipher-suites",
|
||||
"dnsrps-library",
|
||||
"inline-signing",
|
||||
"key-store",
|
||||
"manual-mode",
|
||||
"max-validation-failures-per-fetch",
|
||||
"max-validations-per-fetch",
|
||||
"min-transfer-rate-in",
|
||||
"notify-defer",
|
||||
"offline-ksk",
|
||||
"pkcs11-uri",
|
||||
"recursing-file",
|
||||
"remote-servers",
|
||||
"require-cookie",
|
||||
"resolver-use-dns64",
|
||||
"responselog",
|
||||
"reuseport",
|
||||
"sig0-checks-quota",
|
||||
"sig0-checks-quota-exempt",
|
||||
"sig0-key-checks-limit",
|
||||
"sig0-message-checks-limit"
|
||||
],
|
||||
"removed": [
|
||||
"alt-transfer-source",
|
||||
"alt-transfer-source-v6",
|
||||
"auto-dnssec",
|
||||
"coresize",
|
||||
"datasize",
|
||||
"dscp",
|
||||
"files",
|
||||
"glue-cache",
|
||||
"heartbeat-interval",
|
||||
"keep-response-order",
|
||||
"lock-file",
|
||||
"maxz-zone-ttl",
|
||||
"parent-registration-delay",
|
||||
"parental-agents",
|
||||
"primaries",
|
||||
"random-device",
|
||||
"recurse-ing-file",
|
||||
"reserved-sockets",
|
||||
"resolver-nonbackoff-tries",
|
||||
"resolver-retry-interval",
|
||||
"reuse",
|
||||
"root-delegation-only",
|
||||
"stacksize",
|
||||
"suppress-initial-notify",
|
||||
"tkey-dhkey",
|
||||
"tkey-gssapi-credential",
|
||||
"use-alt-transfer-source"
|
||||
],
|
||||
"modified": [
|
||||
{
|
||||
"option": "listen-on",
|
||||
"old_definition": "[ port <integer> ] [ tls <string> ] [ http <string> ] { <address_match_element>",
|
||||
"new_definition": "[ port <integer> ] [ proxy <string> ] [ tls <string> ] [ http <string> ] { <address_match_element>"
|
||||
},
|
||||
{
|
||||
"option": "response-policy",
|
||||
"old_definition": "{ zone <string> [ add-soa <boolean> ] [ log <boolean> ] [ max-policy-ttl <duration> ] [ min-update-interval <duration> ] [ policy ( cname | disabled | drop | given | no-op | nodata | nxdomain | passthru | tcp-only <quoted_string> ) ] [ recursive-only <boolean> ] [ nsip-enable <boolean> ] [ nsdname-enable <boolean> ]",
|
||||
"new_definition": "{ zone <string> [ add-soa <boolean> ] [ log <boolean> ] [ max-policy-ttl <duration> ] [ min-update-interval <duration> ] [ policy ( cname | disabled | drop | given | no-op | nodata | nxdomain | passthru | tcp-only <quoted_string> ) ] [ recursive-only <boolean> ] [ nsip-enable <boolean> ] [ nsdname-enable <boolean> ] [ ede <string> ]"
|
||||
},
|
||||
{
|
||||
"option": "cookie-algorithm",
|
||||
"old_definition": "( aes | siphash24 )",
|
||||
"new_definition": "( siphash24 )"
|
||||
},
|
||||
{
|
||||
"option": "forwarders",
|
||||
"old_definition": "[ port <integer> ] { ( <ipv4_address> | <ipv6_address> ) [ port <integer> ]",
|
||||
"new_definition": "[ port <integer> ] [ tls <string> ] { ( <ipv4_address> | <ipv6_address> ) [ port <integer> ] [ tls <string> ]"
|
||||
},
|
||||
{
|
||||
"option": "listen-on-v6",
|
||||
"old_definition": "[ port <integer> ] [ tls <string> ] [ http <string> ] { <address_match_element>",
|
||||
"new_definition": "[ port <integer> ] [ proxy <string> ] [ tls <string> ] [ http <string> ] { <address_match_element>"
|
||||
},
|
||||
{
|
||||
"option": "also-notify",
|
||||
"old_definition": "[ port <integer> ] { ( <remote-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]",
|
||||
"new_definition": "[ port <integer> ] [ source ( <ipv4_address> | * ) ] [ source-v6 ( <ipv6_address> | * ) ] { ( <server-list> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]"
|
||||
},
|
||||
{
|
||||
"option": "catalog-zones",
|
||||
"old_definition": "{ zone <string> [ default-primaries [ port <integer> ] { ( <remote-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]",
|
||||
"new_definition": "{ zone <string> [ default-primaries [ port <integer> ] [ source ( <ipv4_address> | * ) ] [ source-v6 ( <ipv6_address> | * ) ] { ( <server-list> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]"
|
||||
}
|
||||
],
|
||||
"deprecated_new": [
|
||||
"sortlist"
|
||||
],
|
||||
"options1_count": 334,
|
||||
"options2_count": 333
|
||||
},
|
||||
"forward.zoneopt": {
|
||||
"file": "forward.zoneopt",
|
||||
"added": [],
|
||||
"removed": [
|
||||
"delegation-only"
|
||||
],
|
||||
"modified": [
|
||||
{
|
||||
"option": "forwarders",
|
||||
"old_definition": "[ port <integer> ] { ( <ipv4_address> | <ipv6_address> ) [ port <integer> ]",
|
||||
"new_definition": "[ port <integer> ] [ tls <string> ] { ( <ipv4_address> | <ipv6_address> ) [ port <integer> ] [ tls <string> ]"
|
||||
}
|
||||
],
|
||||
"deprecated_new": [],
|
||||
"options1_count": 5,
|
||||
"options2_count": 4
|
||||
},
|
||||
"hint.zoneopt": {
|
||||
"file": "hint.zoneopt",
|
||||
"added": [],
|
||||
"removed": [
|
||||
"delegation-only"
|
||||
],
|
||||
"modified": [],
|
||||
"deprecated_new": [],
|
||||
"options1_count": 5,
|
||||
"options2_count": 4
|
||||
},
|
||||
"in-view.zoneopt": {
|
||||
"file": "in-view.zoneopt",
|
||||
"added": [],
|
||||
"removed": [],
|
||||
"modified": [],
|
||||
"deprecated_new": [],
|
||||
"options1_count": 2,
|
||||
"options2_count": 2
|
||||
},
|
||||
"mirror.zoneopt": {
|
||||
"file": "mirror.zoneopt",
|
||||
"added": [
|
||||
"min-transfer-rate-in",
|
||||
"notify-defer"
|
||||
],
|
||||
"removed": [
|
||||
"alt-transfer-source",
|
||||
"alt-transfer-source-v6",
|
||||
"use-alt-transfer-source"
|
||||
],
|
||||
"modified": [
|
||||
{
|
||||
"option": "also-notify",
|
||||
"old_definition": "[ port <integer> ] { ( <remote-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]",
|
||||
"new_definition": "[ port <integer> ] [ source ( <ipv4_address> | * ) ] [ source-v6 ( <ipv6_address> | * ) ] { ( <server-list> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]"
|
||||
},
|
||||
{
|
||||
"option": "primaries",
|
||||
"old_definition": "[ port <integer> ] { ( <remote-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]",
|
||||
"new_definition": "[ port <integer> ] [ source ( <ipv4_address> | * ) ] [ source-v6 ( <ipv6_address> | * ) ] { ( <server-list> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]"
|
||||
}
|
||||
],
|
||||
"deprecated_new": [],
|
||||
"options1_count": 44,
|
||||
"options2_count": 43
|
||||
},
|
||||
"primary.zoneopt": {
|
||||
"file": "primary.zoneopt",
|
||||
"added": [
|
||||
"check-svcb",
|
||||
"checkds",
|
||||
"notify-defer"
|
||||
],
|
||||
"removed": [
|
||||
"alt-transfer-source",
|
||||
"alt-transfer-source-v6",
|
||||
"auto-dnssec",
|
||||
"update-check-ksk"
|
||||
],
|
||||
"modified": [
|
||||
{
|
||||
"option": "update-policy",
|
||||
"old_definition": "( local | { ( deny | grant ) <string> ( 6to4-self | external | krb5-self | krb5-selfsub | krb5-subdomain | krb5-subdomain-self-rhs | ms-self | ms-selfsub | ms-subdomain | ms-subdomain-self-rhs | name | self | selfsub | selfwild | subdomain | tcp-self | wildcard | zonesubject ) [ <string> ] <rrtype list>",
|
||||
"new_definition": "( local | { ( deny | grant ) <string> ( 6to4-self | external | krb5-self | krb5-selfsub | krb5-subdomain | krb5-subdomain-self-rhs | ms-self | ms-selfsub | ms-subdomain | ms-subdomain-self-rhs | name | self | selfsub | selfwild | subdomain | tcp-self | wildcard | zonesub ) [ <string> ] <rrtype list>"
|
||||
},
|
||||
{
|
||||
"option": "also-notify",
|
||||
"old_definition": "[ port <integer> ] { ( <remote-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]",
|
||||
"new_definition": "[ port <integer> ] [ source ( <ipv4_address> | * ) ] [ source-v6 ( <ipv6_address> | * ) ] { ( <server-list> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]"
|
||||
},
|
||||
{
|
||||
"option": "parental-agents",
|
||||
"old_definition": "[ port <integer> ] { ( <remote-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]",
|
||||
"new_definition": "[ port <integer> ] [ source ( <ipv4_address> | * ) ] [ source-v6 ( <ipv6_address> | * ) ] { ( <server-list> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]"
|
||||
},
|
||||
{
|
||||
"option": "forwarders",
|
||||
"old_definition": "[ port <integer> ] { ( <ipv4_address> | <ipv6_address> ) [ port <integer> ]",
|
||||
"new_definition": "[ port <integer> ] [ tls <string> ] { ( <ipv4_address> | <ipv6_address> ) [ port <integer> ] [ tls <string> ]"
|
||||
}
|
||||
],
|
||||
"deprecated_new": [
|
||||
"max-zone-ttl"
|
||||
],
|
||||
"options1_count": 63,
|
||||
"options2_count": 62
|
||||
},
|
||||
"redirect.zoneopt": {
|
||||
"file": "redirect.zoneopt",
|
||||
"added": [],
|
||||
"removed": [],
|
||||
"modified": [
|
||||
{
|
||||
"option": "primaries",
|
||||
"old_definition": "[ port <integer> ] { ( <remote-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]",
|
||||
"new_definition": "[ port <integer> ] [ source ( <ipv4_address> | * ) ] [ source-v6 ( <ipv6_address> | * ) ] { ( <server-list> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]"
|
||||
}
|
||||
],
|
||||
"deprecated_new": [
|
||||
"max-zone-ttl"
|
||||
],
|
||||
"options1_count": 14,
|
||||
"options2_count": 14
|
||||
},
|
||||
"secondary.zoneopt": {
|
||||
"file": "secondary.zoneopt",
|
||||
"added": [
|
||||
"checkds",
|
||||
"min-transfer-rate-in",
|
||||
"notify-defer"
|
||||
],
|
||||
"removed": [
|
||||
"alt-transfer-source",
|
||||
"alt-transfer-source-v6",
|
||||
"auto-dnssec",
|
||||
"use-alt-transfer-source"
|
||||
],
|
||||
"modified": [
|
||||
{
|
||||
"option": "also-notify",
|
||||
"old_definition": "[ port <integer> ] { ( <remote-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]",
|
||||
"new_definition": "[ port <integer> ] [ source ( <ipv4_address> | * ) ] [ source-v6 ( <ipv6_address> | * ) ] { ( <server-list> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]"
|
||||
},
|
||||
{
|
||||
"option": "parental-agents",
|
||||
"old_definition": "[ port <integer> ] { ( <remote-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]",
|
||||
"new_definition": "[ port <integer> ] [ source ( <ipv4_address> | * ) ] [ source-v6 ( <ipv6_address> | * ) ] { ( <server-list> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]"
|
||||
},
|
||||
{
|
||||
"option": "forwarders",
|
||||
"old_definition": "[ port <integer> ] { ( <ipv4_address> | <ipv6_address> ) [ port <integer> ]",
|
||||
"new_definition": "[ port <integer> ] [ tls <string> ] { ( <ipv4_address> | <ipv6_address> ) [ port <integer> ] [ tls <string> ]"
|
||||
},
|
||||
{
|
||||
"option": "primaries",
|
||||
"old_definition": "[ port <integer> ] { ( <remote-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]",
|
||||
"new_definition": "[ port <integer> ] [ source ( <ipv4_address> | * ) ] [ source-v6 ( <ipv6_address> | * ) ] { ( <server-list> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]"
|
||||
}
|
||||
],
|
||||
"deprecated_new": [],
|
||||
"options1_count": 66,
|
||||
"options2_count": 65
|
||||
},
|
||||
"static-stub.zoneopt": {
|
||||
"file": "static-stub.zoneopt",
|
||||
"added": [],
|
||||
"removed": [],
|
||||
"modified": [
|
||||
{
|
||||
"option": "forwarders",
|
||||
"old_definition": "[ port <integer> ] { ( <ipv4_address> | <ipv6_address> ) [ port <integer> ]",
|
||||
"new_definition": "[ port <integer> ] [ tls <string> ] { ( <ipv4_address> | <ipv6_address> ) [ port <integer> ] [ tls <string> ]"
|
||||
}
|
||||
],
|
||||
"deprecated_new": [],
|
||||
"options1_count": 12,
|
||||
"options2_count": 12
|
||||
},
|
||||
"stub.zoneopt": {
|
||||
"file": "stub.zoneopt",
|
||||
"added": [
|
||||
"min-transfer-rate-in"
|
||||
],
|
||||
"removed": [
|
||||
"delegation-only",
|
||||
"use-alt-transfer-source"
|
||||
],
|
||||
"modified": [
|
||||
{
|
||||
"option": "forwarders",
|
||||
"old_definition": "[ port <integer> ] { ( <ipv4_address> | <ipv6_address> ) [ port <integer> ]",
|
||||
"new_definition": "[ port <integer> ] [ tls <string> ] { ( <ipv4_address> | <ipv6_address> ) [ port <integer> ] [ tls <string> ]"
|
||||
},
|
||||
{
|
||||
"option": "primaries",
|
||||
"old_definition": "[ port <integer> ] { ( <remote-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]",
|
||||
"new_definition": "[ port <integer> ] [ source ( <ipv4_address> | * ) ] [ source-v6 ( <ipv6_address> | * ) ] { ( <server-list> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]"
|
||||
}
|
||||
],
|
||||
"deprecated_new": [],
|
||||
"options1_count": 28,
|
||||
"options2_count": 27
|
||||
},
|
||||
"delegation-only.zoneopt": {
|
||||
"file": "delegation-only.zoneopt",
|
||||
"added": [],
|
||||
"removed": [
|
||||
"type",
|
||||
"zone"
|
||||
],
|
||||
"modified": [],
|
||||
"deprecated_new": [],
|
||||
"options1_count": 2,
|
||||
"options2_count": 0
|
||||
},
|
||||
"rndc.grammar": {
|
||||
"file": "rndc.grammar",
|
||||
"added": [],
|
||||
"removed": [],
|
||||
"modified": [],
|
||||
"deprecated_new": [],
|
||||
"options1_count": 14,
|
||||
"options2_count": 14
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user