commit 14a0cc07160747d61425453a1d42da4b54e24fe4
parent 994cad1bde263d0960a14480269690451c65e8c9
Author: Martin Schanzenbach <schanzen@gnunet.org>
Date: Sat, 4 Dec 2021 14:31:24 +0100
more ise
Diffstat:
1 file changed, 20 insertions(+), 18 deletions(-)
diff --git a/draft-schanzen-gns.xml b/draft-schanzen-gns.xml
@@ -217,9 +217,11 @@
process of name resolution.
</dd>
</dl>
- <t>
- For the "zid" wire format see Figure <xref target="figure_zid"/>.
- </t>
+ <section anchor="zid" numbered="true" toc="default">
+ <name>The Zone ID</name>
+ <t>
+ The "zid" wire format is illustrated in Figure <xref target="figure_zid"/>.
+ </t>
<figure anchor="figure_zid">
<artwork name="" type="" align="left" alt=""><![CDATA[
0 8 16 24 32 40 48 56
@@ -230,19 +232,20 @@
/ /
]]></artwork>
</figure>
- <t>The zid Wire Format.</t>
<t>
- For the string representation of the "zid", we use a base-32 encoding
- "StringEncode".
- However, instead of following <xref target="RFC4648"/> we base
- our character map on the optical character recognition friendly
- proposal of Crockford <xref target="CrockfordB32"/>.
- The only difference to Crockford is that the letter
- "U" decodes to the same base-32 value as the letter "V" (27).
+ For the string representation of the "zid", we use the Crockford Base32
+ encoding <xref target="CrockfordB32"/> but we decode the letter "U" to
+ the same Base32 value as the letter "V".
+ Assuming the encode function of <xref target="CrockfordB32"/> to be
+ "Base32Crockford, we define our function as "StringEncode" as follows:
</t>
<artwork name="" type="" align="left" alt=""><![CDATA[
zkl := <StringEncode(zid)>
- ]]></artwork>
+ ]]></artwork>
+ <t>
+ Note that Crockfor Base32 is NOT compatible with the Base32 encoding
+ as defined in <xref target="RFC4648"/>.
+ </t>
<t>
If "zkl" is less than 63 characters, it is also the "zTLD".
If the resulting "zkl" should be longer than 63 characters, the
@@ -254,12 +257,14 @@ zkl := <StringEncode(zid)>
</t>
<artwork name="" type="" align="left" alt=""><![CDATA[
zTLD := zkl[126:129].zkl[63:125].zkl[0:62]
- ]]></artwork>
+ ]]></artwork>
</section>
<section anchor="zone_types" numbered="true" toc="default">
<name>Zone Types</name>
<t>
- A zone type identifies a family of eight functions:
+ Zone types are identified by a 32-bit resource record type number.
+ Resource record types are discussed in the Section <xref target="rrecords"/>.
+ A zone type defines a family of eight functions:
</t>
<dl>
<dt>Private-KeyGen() -> d</dt>
@@ -313,10 +318,7 @@ zTLD := zkl[126:129].zkl[63:125].zkl[0:62]
"nonce" and "expiration".
</dd>
</dl>
- <t>
- Zone types are identified by a 32-bit resource record type number.
- Resource record types are discussed in the next section.
- </t>
+ </section>
</section>
<section anchor="rrecords" numbered="true" toc="default">
<name>Resource Records</name>
