lsd0001

commit d9c65a1d5af834ba30fcc23b140b22a500ff770b
parent 93cb14cd2bb1fe1999ddd589a35d288411c211b3
Author: Schanzenbach, Martin <mschanzenbach@posteo.de>
Date:   Fri,  4 Oct 2019 11:22:52 +0200

Merge branch 'master' of ssh://gnunet.org/lsd0001

Diffstat:
M
draft-schanzen-gns.xml
 | 
20
+++++++++++++-------

1 file changed, 13 insertions(+), 7 deletions(-)
diff --git a/draft-schanzen-gns.xml b/draft-schanzen-gns.xml
@@ -165,20 +165,26 @@
  <dl>
    <dt>SHADOW</dt>
    <dd>
-     If this flag is set, this record should not be used unless all (other)
-     records with an absolute expiration time have expired.
+     If this flag is set, this record should be ignored by resolvers unless all (other)
+     records of the same record type have expired.  Used to allow zone publishers to
+     facilitate good performance when records change by allowing them to put future
+     values of records into the DHT. This way, future values can propagate and may be
+     cached before the transition becomes active.
    </dd>
    <dt>EXPREL</dt>
    <dd>
-     The expiration time value of the record is a relative time and not
-     an absolute time. This flag should never be encountered by a resolver
-     for records resolved from the DHT.
+     The expiration time value of the record is a relative time (still in microseconds)
+     and not an absolute time. This flag should never be encountered by a resolver
+     for records obtained from the DHT, but might be present when a resolver looks up
+     private records of a zone hosted locally.
    </dd>
    <dt>PRIVATE</dt>
    <dd>
      This is a private record of this peer and it should thus not be
-     handed out to other peers. This flag should never be encountered by
-     a resolver for records resolved from the DHT.
+     published in the DHT.  Thus, this flag should never be encountered by
+     a resolver for records obtained from the DHT.
+     Private records should still be considered just like
+     regular records when resolving labels in local zones.
    </dd>
  </dl>
 <section anchor="gnsrecords_pkey" numbered="true" toc="default">