From: Matthijs Mekking Date: Thu, 5 Dec 2019 09:47:20 +0000 (+0100) Subject: Update docs with durations, built-in dnssec-policy X-Git-Tag: v9.15.7~27^2~2 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=a339a6df482ec69362d05f0018d050ab576e10d6;p=thirdparty%2Fbind9.git Update docs with durations, built-in dnssec-policy Clarify in the ARM that TTL-style options can also now take ISO 8601 durations. Mention the built-in dnssec policies "default" and "none". Mention that "none" is the default. Add a file documenting the default dnssec-policy configuration options. Fix dnssec-policy syntax in ARM (dnssec-policy.grammar.xml). --- diff --git a/dnssec-policy.default.conf b/dnssec-policy.default.conf new file mode 100644 index 00000000000..d94b2550f02 --- /dev/null +++ b/dnssec-policy.default.conf @@ -0,0 +1,26 @@ +dnssec-policy "default" { + + // Keys + keys { + csk key-directory lifetime 0 algorithm 13; + }; + + // Key timings + dnskey-ttl 3600; + publish-safety 1h; + retire-safety 1h; + + // Signature timings + signatures-refresh 5d; + signatures-validity 14d; + signatures-validity-dnskey 14d; + + // Zone parameters + zone-max-ttl 86400; + zone-propagation-delay 300; + + // Parent parameters + parent-ds-ttl 86400; + parent-registration-delay 24h; + parent-propagation-delay 1h; +}; diff --git a/doc/arm/Bv9ARM-book.xml b/doc/arm/Bv9ARM-book.xml index f57a1dcd0a1..c352dbf30a9 100644 --- a/doc/arm/Bv9ARM-book.xml +++ b/doc/arm/Bv9ARM-book.xml @@ -4467,9 +4467,9 @@ badresp:1,adberr:0,findfail:0,valfail:0] The number of seconds to wait between attempts to reopen a closed output stream. The minimum is 1 second, the maximum is 600 seconds (10 minutes), and the default - is 5 seconds. - For convenience, TTL-style time unit suffixes may be - used to specify the value. + is 5 seconds. For convenience, TTL-style time unit + suffixes may be used to specify the value. It also + accepts ISO 8601 duration formats. @@ -5271,8 +5271,11 @@ options { For convenience, TTL-style time unit suffixes can be used to specify the NTA lifetime in seconds, minutes - or hours. defaults to - one hour. It cannot exceed one week. + or hours. It also accepts ISO 8601 duration formats. + + + defaults to one hour. It + cannot exceed one week. @@ -5305,9 +5308,13 @@ options { For convenience, TTL-style time unit suffixes can be used to specify the NTA recheck interval in seconds, - minutes or hours. The default is five minutes. It - cannot be longer than - (which cannot be longer than a week). + minutes or hours. It also accepts ISO 8601 duration + formats. + + + The default is five minutes. It cannot be longer than + (which cannot be longer + than a week). @@ -5318,7 +5325,10 @@ options { Specifies a maximum permissible TTL value in seconds. For convenience, TTL-style time unit suffixes may be - used to specify the maximum value. + used to specify the maximum value. It also + accepts ISO 8601 duration formats. + + When loading a zone file using a of text or raw, @@ -8463,7 +8473,8 @@ avoid-v6-udp-ports { 40000; range 50000 60000; }; listen-on configuration), and will stop listening on interfaces that have gone away. For convenience, TTL-style time unit suffixes may be - used to specify the value. + used to specify the value. It also accepts ISO 8601 + duration formats. @@ -8744,9 +8755,13 @@ avoid-v6-udp-ports { 40000; range 50000 60000; }; stores negative answers. min-ncache-ttl is used to set a minimum retention time for these answers in the server in seconds. For convenience, TTL-style time unit - suffixes may be used to specify the value. The default - min-ncache-ttl is 0 - seconds. min-ncache-ttl cannot exceed 90 + suffixes may be used to specify the value. It also + accepts ISO 8601 duration formats. + + + The default min-ncache-ttl is + 0 seconds. + min-ncache-ttl cannot exceed 90 seconds and will be truncated to 90 seconds if set to a greater value. @@ -8758,10 +8773,14 @@ avoid-v6-udp-ports { 40000; range 50000 60000; }; Sets the minimum time for which the server will cache ordinary - (positive) answers in seconds. For convenience, TTL-style time - unit suffixes may be used to specify the value. The default - min-cache-ttl is 0 - seconds. min-cache-ttl cannot exceed 90 + (positive) answers in seconds. For convenience, TTL-style + time unit suffixes may be used to specify the value. It also + accepts ISO 8601 duration formats. + + + The default min-cache-ttl is + 0 seconds. + min-cache-ttl cannot exceed 90 seconds and will be truncated to 90 seconds if set to a greater value. @@ -8773,15 +8792,19 @@ avoid-v6-udp-ports { 40000; range 50000 60000; }; To reduce network traffic and increase performance, - the server stores negative answers. max-ncache-ttl is + the server stores negative answers. + max-ncache-ttl is used to set a maximum retention time for these answers in - the server in seconds. - For convenience, TTL-style time unit suffixes may be - used to specify the value. The default - max-ncache-ttl is 10800 seconds (3 hours). - max-ncache-ttl cannot exceed - 7 days and will - be silently truncated to 7 days if set to a greater value. + the server in seconds. For convenience, TTL-style time unit + suffixes may be used to specify the value. It also accepts + ISO 8601 duration formats. + + + The default max-ncache-ttl is + 10800 seconds (3 hours). + max-ncache-ttl cannot exceed 7 days and + will be silently truncated to 7 days if set to a greater + value. @@ -8793,7 +8816,10 @@ avoid-v6-udp-ports { 40000; range 50000 60000; }; Sets the maximum time for which the server will cache ordinary (positive) answers in seconds. For convenience, TTL-style time unit suffixes may be - used to specify the value. + used to specify the value. It also accepts ISO 8601 + duration formats. + + The default is 604800 (one week). A value of zero may cause all queries to return SERVFAIL, because of lost caches of intermediate @@ -10099,7 +10125,9 @@ deny-answer-aliases { "example.net"; }; The max-policy-ttl clause changes the maximum seconds from its default of 5. For convenience, TTL-style time unit suffixes may be - used to specify the value. + used to specify the value. It also accepts ISO 8601 duration + formats. + @@ -10195,7 +10223,8 @@ example.com CNAME rpz-tcp-only. recent update, then the changes will not be carried out until this interval has elapsed. The default is 60 seconds. For convenience, TTL-style time unit suffixes may be - used to specify the value. + used to specify the value. It also accepts ISO 8601 duration + formats. @@ -12131,9 +12160,13 @@ view "external" { dnssec-policy - The key and signing policy for this zone. Set to - "default" if you want to make use - of the default policy. + The key and signing policy for this zone. This is a string + referring to a dnssec-policy statement. + There are two built-in policies: + "default" allows you to use the + default policy, and "none" means + not to use any DNSSEC policy, keeping the zone unsigned. + The default is "none". diff --git a/doc/arm/dnssec-policy.grammar.xml b/doc/arm/dnssec-policy.grammar.xml index 20bc9300971..2055f30dfab 100644 --- a/doc/arm/dnssec-policy.grammar.xml +++ b/doc/arm/dnssec-policy.grammar.xml @@ -13,8 +13,9 @@ dnssec-policy string { +<<<<<<< HEAD dnskey-ttl duration; - keys { ( csk | ksk | zsk ) key-directory duration integer [ integer ] ; ... }; + keys { ( csk | ksk | zsk ) key-directory lifetime duration algorithm integer [ integer ] ; ... }; parent-ds-ttl duration; parent-propagation-delay duration; parent-registration-delay duration;