[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[lsd0001] branch master updated: update RRBLOCK and RR wire formats
|
From: |
gnunet |
|
Subject: |
[lsd0001] branch master updated: update RRBLOCK and RR wire formats |
|
Date: |
Wed, 02 Feb 2022 22:23:50 +0100 |
This is an automated email from the git hooks/post-receive script.
martin-schanzenbach pushed a commit to branch master
in repository lsd0001.
The following commit(s) were added to refs/heads/master by this push:
new f0c137e update RRBLOCK and RR wire formats
f0c137e is described below
commit f0c137ec2691128050263337049d31ff993c18c3
Author: Martin Schanzenbach <schanzen@gnunet.org>
AuthorDate: Wed Feb 2 22:23:46 2022 +0100
update RRBLOCK and RR wire formats
---
draft-schanzen-gns.xml | 83 ++++++++++++++++++++------------------------------
1 file changed, 33 insertions(+), 50 deletions(-)
diff --git a/draft-schanzen-gns.xml b/draft-schanzen-gns.xml
index 8aba127..4df89c5 100644
--- a/draft-schanzen-gns.xml
+++ b/draft-schanzen-gns.xml
@@ -779,10 +779,9 @@ zTLD := zkl[126..129].zkl[63..125].zkl[0..62]
+-----+-----+-----+-----+-----+-----+-----+-----+
| EXPIRATION |
+-----+-----+-----+-----+-----+-----+-----+-----+
-| DATA SIZE | TYPE |
+| SIZE | FLAGS | TYPE |
+-----+-----+-----+-----+-----+-----+-----+-----+
-| FLAGS | DATA /
-+-----+-----+-----+-----+ /
+| DATA /
/ /
/ /
]]></artwork>
@@ -795,11 +794,15 @@ zTLD := zkl[126..129].zkl[63..125].zkl[0..62]
In microseconds since midnight (0 hour), January 1, 1970 in network
byte order.
</dd>
- <dt>DATA SIZE</dt>
+ <dt>SIZE</dt>
<dd>
- denotes the 32-bit size of the DATA field in bytes and in network byte
+ denotes the 16-bit size of the DATA field in bytes and in network byte
order.
</dd>
+ <dt>FLAGS</dt>
+ <dd>
+ is a 16-bit resource record flags field (see below).
+ </dd>
<dt>TYPE</dt>
<dd>
is the 32-bit resource record type. This type can be one of the GNS
resource
@@ -811,10 +814,6 @@ zTLD := zkl[126..129].zkl[63..125].zkl[0..62]
while values above 2^16 are allocated by the
GNUnet Assigned Numbers Authority <xref target="GANA" />.
</dd>
- <dt>FLAGS</dt>
- <dd>
- is a 32-bit resource record flags field (see below).
- </dd>
<dt>DATA</dt>
<dd>
the variable-length resource record data payload. The contents are
defined
@@ -831,7 +830,7 @@ zTLD := zkl[126..129].zkl[63..125].zkl[0..62]
If an application or implementation encounters a flag which it does not
recognize, it MUST be ignored.
<xref target="figure_flag"/>
- illustrates the flag distribution in the 32-bit flag value of a
+ illustrates the flag distribution in the 16-bit flag field of a
resource record:
</t>
<figure anchor="figure_flag">
@@ -1599,10 +1598,10 @@ q := SHA-512 (ZKDF-Public(zk, label))
<artwork name="" type="" align="left" alt=""><![CDATA[
0 8 16 24 32 40 48 56
+-----+-----+-----+-----+-----+-----+-----+-----+
-| ZONE TYPE | ZONE KEY |
-+-----+-----+-----+-----+ (BLINDED) |
-/ /
-/ /
+| SIZE | ZONE TYPE |
++-----+-----+-----+-----+-----+-----+-----+-----+
+/ ZONE KEY /
+/ (BLINDED) /
| |
+-----+-----+-----+-----+-----+-----+-----+-----+
| SIGNATURE |
@@ -1610,8 +1609,6 @@ q := SHA-512 (ZKDF-Public(zk, label))
/ /
| |
+-----+-----+-----+-----+-----+-----+-----+-----+
-| SIZE | PURPOSE |
-+-----+-----+-----+-----+-----+-----+-----+-----+
| EXPIRATION |
+-----+-----+-----+-----+-----+-----+-----+-----+
| BDATA /
@@ -1621,9 +1618,16 @@ q := SHA-512 (ZKDF-Public(zk, label))
]]></artwork>
</figure>
<t>The RRBLOCK Wire Format.</t>
- <!-- FIXME: Should we remove size and purpose from the wire format?
They are entirely redundant, right?
- I (CG) also think we should then move the expiration first (before
ztype), so that it is aligned. -->
<dl>
+ <dt>SIZE</dt>
+ <dd>
+ A 32-bit value containing the length of the signed data following
the
+ PUBLIC KEY field in network byte order. This value always includes
the
+ length of the fields SIZE (4), PURPOSE (4) and EXPIRATION (8) in
+ addition to the length of the BDATA. While a 32-bit value is used,
+ implementations MAY refuse to publish blocks beyond a certain
+ size significantly below 4 GB.
+ </dd>
<dt>ZONE TYPE</dt>
<dd>
is the 32-bit ztype.
@@ -1642,22 +1646,13 @@ q := SHA-512 (ZKDF-Public(zk, label))
the cryptosystem of the zone and the derived private key
"ZKDF-Private(d, label)" (see <xref target="zones" />).
</dd>
- <dt>SIZE</dt>
- <dd>
- A 32-bit value containing the length of the signed data following
the
- PUBLIC KEY field in network byte order. This value always includes
the
- length of the fields SIZE (4), PURPOSE (4) and EXPIRATION (8) in
- addition to the length of the BDATA. While a 32-bit value is used,
- implementations MAY refuse to publish blocks beyond a certain
- size significantly below 4 GB.
- </dd>
- <dt>PURPOSE</dt>
+ <!--<dt>PURPOSE</dt>
<dd>
A 32-bit signature purpose flag. For a RRBLOCK the value of this
field MUST be 15. The value is encoded in network byte order.
The value of this field corresponds to an entry in the
GANA "GNUnet Signature Purpose" registry.
- </dd>
+ </dd>FIXME: We need the signature wire format -->
<dt>EXPIRATION</dt>
<dd>
Specifies when the RRBLOCK expires and the encrypted block
@@ -1696,48 +1691,36 @@ q := SHA-512 (ZKDF-Public(zk, label))
<artwork name="" type="" align="left" alt=""><![CDATA[
0 8 16 24 32 40 48 56
+-----+-----+-----+-----+-----+-----+-----+-----+
-| RR COUNT | EXPIRA- /
-+-----+-----+-----+-----+-----+-----+-----+-----+
-/ -TION | DATA SIZE |
+| EXPIRATION |
+-----+-----+-----+-----+-----+-----+-----+-----+
-| TYPE | FLAGS |
+| SIZE | FLAGS | TYPE |
+-----+-----+-----+-----+-----+-----+-----+-----+
| DATA /
/ /
-/ |
+/ /
+-----+-----+-----+-----+-----+-----+-----+-----+
| EXPIRATION |
+-----+-----+-----+-----+-----+-----+-----+-----+
-| DATA SIZE | TYPE |
+| SIZE | FLAGS | TYPE |
++-----+-----+-----+-----+-----+-----+-----+-----+
+| DATA /
+/ /
+-----+-----+-----+-----+-----+-----+-----+-----+
-| FLAGS | DATA /
-+-----+-----+-----+-----+ /
-/ +-----------------------/
-/ | /
-+-----------------------+ /
/ PADDING /
/ /
]]></artwork>
</figure>
<t>The RDATA Wire Format.</t>
<dl>
- <dt>RR COUNT</dt>
- <dd>
- A 32-bit value containing the number of variable-length resource
- records which are
- following after this field in network byte order.
- </dd>
- <dt>EXPIRATION, DATA SIZE, TYPE, FLAGS and DATA</dt>
+ <dt>EXPIRATION, SIZE, TYPE, FLAGS and DATA</dt>
<dd>
These fields were defined
in the resource record format in <xref target="rrecords" />.
- There MUST be a total of RR COUNT of these resource records
- present.
</dd>
<dt>PADDING</dt>
<dd>
When publishing an RDATA block, the implementation MUST ensure that
- the size of the RDATA WITHOUT the RR COUNT field is a power of two
+ the size of the RDATA is a power of two
using the padding field. The field MUST be set to zero and MUST be
ignored on receipt.
As a special exception, record sets with (only) a zone delegation
--
To stop receiving notification emails like this one, please contact
gnunet@gnunet.org.
| [Prev in Thread] |
Current Thread |
[Next in Thread] |
- [lsd0001] branch master updated: update RRBLOCK and RR wire formats,
gnunet <=