summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorWolfgang Jung <w.elektrowolle.de>2018-05-02 14:43:39 +0200
committerDaniel Salzman <daniel.salzman@nic.cz>2018-05-02 16:07:39 +0200
commitfd346d4bfbb65df6412f6925126c92e1003d51ce (patch)
treeadb852a3005cfadda118d6b75a302f35dcf7b2c9 /doc
parentUnify header files (diff)
downloadknot-fd346d4bfbb65df6412f6925126c92e1003d51ce.tar.xz
knot-fd346d4bfbb65df6412f6925126c92e1003d51ce.zip
config: add rfc1912 dateserial policy
close #582
Diffstat (limited to 'doc')
-rw-r--r--doc/man/knot.conf.5in10
-rw-r--r--doc/reference.rst6
2 files changed, 14 insertions, 2 deletions
diff --git a/doc/man/knot.conf.5in b/doc/man/knot.conf.5in
index 5003cc4ac..70fe70547 100644
--- a/doc/man/knot.conf.5in
+++ b/doc/man/knot.conf.5in
@@ -983,7 +983,7 @@ zone:
dnssec\-signing: BOOL
dnssec\-policy: STR
request\-edns\-option: INT:[HEXSTR]
- serial\-policy: increment | unixtime
+ serial\-policy: increment | unixtime | dateserial
min\-refresh\-interval: TIME
max\-refresh\-interval: TIME
module: STR/STR ...
@@ -1219,6 +1219,12 @@ Possible values:
\fBincrement\fP – The serial is incremented according to serial number arithmetic
.IP \(bu 2
\fBunixtime\fP – The serial is set to the current unix time
+.IP \(bu 2
+.INDENT 2.0
+.TP
+\fBdateserial\fP – The 10\-digit serial (YYYYMMDDnn) is incremented, the first
+8 digits match the current iso\-date
+.UNINDENT
.UNINDENT
.sp
\fBNOTE:\fP
@@ -1228,6 +1234,8 @@ If your serial was in other than unix time format, be careful
with the transition to unix time. It may happen that the new serial will
be \(aqlower\(aq than the old one. If this is the case, the transition should be
done by hand (\fI\%RFC 1982\fP).
+.sp
+Use dateserial only if you expect less than 100 updates per day per zone.
.UNINDENT
.UNINDENT
.sp
diff --git a/doc/reference.rst b/doc/reference.rst
index 1a4980c3d..590869c03 100644
--- a/doc/reference.rst
+++ b/doc/reference.rst
@@ -1110,7 +1110,7 @@ Definition of zones served by the server.
dnssec-signing: BOOL
dnssec-policy: STR
request-edns-option: INT:[HEXSTR]
- serial-policy: increment | unixtime
+ serial-policy: increment | unixtime | dateserial
min-refresh-interval: TIME
max-refresh-interval: TIME
module: STR/STR ...
@@ -1382,6 +1382,8 @@ Possible values:
- ``increment`` – The serial is incremented according to serial number arithmetic
- ``unixtime`` – The serial is set to the current unix time
+- ``dateserial`` – The 10-digit serial (YYYYMMDDnn) is incremented, the first
+ 8 digits match the current iso-date
.. NOTE::
If your serial was in other than unix time format, be careful
@@ -1389,6 +1391,8 @@ Possible values:
be \'lower\' than the old one. If this is the case, the transition should be
done by hand (:rfc:`1982`).
+ Use dateserial only if you expect less than 100 updates per day per zone.
+
*Default:* increment
.. _zone_min-refresh-interval: