aboutsummaryrefslogtreecommitdiff
path: root/draft-schanzen-gns.html
diff options
context:
space:
mode:
Diffstat (limited to 'draft-schanzen-gns.html')
-rw-r--r--draft-schanzen-gns.html92
1 files changed, 63 insertions, 29 deletions
diff --git a/draft-schanzen-gns.html b/draft-schanzen-gns.html
index d8e173a..3a1ee65 100644
--- a/draft-schanzen-gns.html
+++ b/draft-schanzen-gns.html
@@ -1090,7 +1090,10 @@ async function addMetadata(){try{const e=document.styleSheets[0].cssRules;for(le
1090 <p id="section-boilerplate.3-1.3.2.3.1"><a href="#section-3.3" class="xref">3.3</a>.  <a href="#name-leho" class="xref">LEHO</a><a href="#section-boilerplate.3-1.3.2.3.1" class="pilcrow">¶</a></p> 1090 <p id="section-boilerplate.3-1.3.2.3.1"><a href="#section-3.3" class="xref">3.3</a>.  <a href="#name-leho" class="xref">LEHO</a><a href="#section-boilerplate.3-1.3.2.3.1" class="pilcrow">¶</a></p>
1091</li> 1091</li>
1092 <li class="toc ulEmpty" id="section-boilerplate.3-1.3.2.4"> 1092 <li class="toc ulEmpty" id="section-boilerplate.3-1.3.2.4">
1093 <p id="section-boilerplate.3-1.3.2.4.1"><a href="#section-3.4" class="xref">3.4</a>.  <a href="#name-box" class="xref">BOX</a><a href="#section-boilerplate.3-1.3.2.4.1" class="pilcrow">¶</a></p> 1093 <p id="section-boilerplate.3-1.3.2.4.1"><a href="#section-3.4" class="xref">3.4</a>.  <a href="#name-nick" class="xref">NICK</a><a href="#section-boilerplate.3-1.3.2.4.1" class="pilcrow">¶</a></p>
1094</li>
1095 <li class="toc ulEmpty" id="section-boilerplate.3-1.3.2.5">
1096 <p id="section-boilerplate.3-1.3.2.5.1"><a href="#section-3.5" class="xref">3.5</a>.  <a href="#name-box" class="xref">BOX</a><a href="#section-boilerplate.3-1.3.2.5.1" class="pilcrow">¶</a></p>
1094</li> 1097</li>
1095 </ul> 1098 </ul>
1096</li> 1099</li>
@@ -1451,12 +1454,43 @@ async function addMetadata(){try{const e=document.styleSheets[0].cssRules;for(le
1451 <span>[<a href="#RFC3492" class="xref">RFC3492</a>]</span>.<a href="#section-3.3-3" class="pilcrow">¶</a></p> 1454 <span>[<a href="#RFC3492" class="xref">RFC3492</a>]</span>.<a href="#section-3.3-3" class="pilcrow">¶</a></p>
1452</section> 1455</section>
1453</div> 1456</div>
1454<div id="gnsrecords_box"> 1457<div id="gnsrecords_nick">
1455<section id="section-3.4"> 1458<section id="section-3.4">
1459 <h3 id="name-nick">
1460<a href="#section-3.4" class="section-number selfRef">3.4. </a><a href="#name-nick" class="section-name selfRef">NICK</a>
1461 </h3>
1462<p id="section-3.4-1">Nickname records can be used by zone administrators to publish an
1463 indication on what label this zone prefers to be referred to.
1464 This is a suggestion to other zones what label to use when creating a
1465 PKEY <a href="#gnsrecords_pkey" class="xref">Section 3.1</a> record containing this zone's
1466 public zone key.
1467 A NICK resource record contains an UTF-8 string
1468 (which is not 0-terminated) representing the preferred label.
1469 This string may NOT inlcude a ".".
1470 A NICK DATA entry has the following format:<a href="#section-3.4-1" class="pilcrow">¶</a></p>
1471<div id="figure_nickrecord">
1472<figure id="figure-6">
1473 <div class="artwork art-text alignLeft" id="section-3.4-2.1">
1474<pre>
1475 0 8 16 24 32 40 48 56
1476 +-----+-----+-----+-----+-----+-----+-----+-----+
1477 | NICKNAME |
1478 / /
1479 / /
1480 | |
1481 +-----+-----+-----+-----+-----+-----+-----+-----+
1482 </pre>
1483</div>
1484<figcaption><a href="#figure-6" class="selfRef">Figure 6</a></figcaption></figure>
1485</div>
1486</section>
1487</div>
1488<div id="gnsrecords_box">
1489<section id="section-3.5">
1456 <h3 id="name-box"> 1490 <h3 id="name-box">
1457<a href="#section-3.4" class="section-number selfRef">3.4. </a><a href="#name-box" class="section-name selfRef">BOX</a> 1491<a href="#section-3.5" class="section-number selfRef">3.5. </a><a href="#name-box" class="section-name selfRef">BOX</a>
1458 </h3> 1492 </h3>
1459<p id="section-3.4-1"> 1493<p id="section-3.5-1">
1460 In GNS, every "." in a name delegates to another zone, and 1494 In GNS, every "." in a name delegates to another zone, and
1461 GNS lookups are expected to return all of the required useful 1495 GNS lookups are expected to return all of the required useful
1462 information in one record set. This is incompatible with the 1496 information in one record set. This is incompatible with the
@@ -1471,10 +1505,10 @@ async function addMetadata(){try{const e=document.styleSheets[0].cssRules;for(le
1471 otherwise it is to be left untouched. This way, TLSA (and SRV) 1505 otherwise it is to be left untouched. This way, TLSA (and SRV)
1472 records do not require a separate network request, and TLSA 1506 records do not require a separate network request, and TLSA
1473 records become inseparable from the corresponding address records. 1507 records become inseparable from the corresponding address records.
1474 A BOX DATA entry has the following format:<a href="#section-3.4-1" class="pilcrow">¶</a></p> 1508 A BOX DATA entry has the following format:<a href="#section-3.5-1" class="pilcrow">¶</a></p>
1475<div id="figure_boxrecord"> 1509<div id="figure_boxrecord">
1476<figure id="figure-6"> 1510<figure id="figure-7">
1477 <div class="artwork art-text alignLeft" id="section-3.4-2.1"> 1511 <div class="artwork art-text alignLeft" id="section-3.5-2.1">
1478<pre> 1512<pre>
1479 0 8 16 24 32 40 48 56 1513 0 8 16 24 32 40 48 56
1480 +-----+-----+-----+-----+-----+-----+-----+-----+ 1514 +-----+-----+-----+-----+-----+-----+-----+-----+
@@ -1487,26 +1521,26 @@ async function addMetadata(){try{const e=document.styleSheets[0].cssRules;for(le
1487 +-----+-----+-----+-----+-----+-----+-----+-----+ 1521 +-----+-----+-----+-----+-----+-----+-----+-----+
1488 </pre> 1522 </pre>
1489</div> 1523</div>
1490<figcaption><a href="#figure-6" class="selfRef">Figure 6</a></figcaption></figure> 1524<figcaption><a href="#figure-7" class="selfRef">Figure 7</a></figcaption></figure>
1491</div> 1525</div>
1492<dl class="dlParallel" id="section-3.4-3"> 1526<dl class="dlParallel" id="section-3.5-3">
1493 <dt id="section-3.4-3.1">PROTO</dt> 1527 <dt id="section-3.5-3.1">PROTO</dt>
1494 <dd id="section-3.4-3.2"> 1528 <dd id="section-3.5-3.2">
1495 the 16-bit protocol number, e.g. 6 for tcp. In network byte order.<a href="#section-3.4-3.2" class="pilcrow">¶</a> 1529 the 16-bit protocol number, e.g. 6 for tcp. In network byte order.<a href="#section-3.5-3.2" class="pilcrow">¶</a>
1496</dd> 1530</dd>
1497 <dt id="section-3.4-3.3">SVC</dt> 1531 <dt id="section-3.5-3.3">SVC</dt>
1498 <dd id="section-3.4-3.4"> 1532 <dd id="section-3.5-3.4">
1499 the 16-bit service value of the boxed record, i.e. the port number. 1533 the 16-bit service value of the boxed record, i.e. the port number.
1500 In network byte order.<a href="#section-3.4-3.4" class="pilcrow">¶</a> 1534 In network byte order.<a href="#section-3.5-3.4" class="pilcrow">¶</a>
1501</dd> 1535</dd>
1502 <dt id="section-3.4-3.5">TYPE</dt> 1536 <dt id="section-3.5-3.5">TYPE</dt>
1503 <dd id="section-3.4-3.6"> 1537 <dd id="section-3.5-3.6">
1504 is the 32-bit record type of the boxed record. In network byte order.<a href="#section-3.4-3.6" class="pilcrow">¶</a> 1538 is the 32-bit record type of the boxed record. In network byte order.<a href="#section-3.5-3.6" class="pilcrow">¶</a>
1505</dd> 1539</dd>
1506 <dt id="section-3.4-3.7">RECORD DATA</dt> 1540 <dt id="section-3.5-3.7">RECORD DATA</dt>
1507 <dd id="section-3.4-3.8"> 1541 <dd id="section-3.5-3.8">
1508 is a variable length field containing the "DATA" format of TYPE as 1542 is a variable length field containing the "DATA" format of TYPE as
1509 defined for the respective TYPE in DNS.<a href="#section-3.4-3.8" class="pilcrow">¶</a> 1543 defined for the respective TYPE in DNS.<a href="#section-3.5-3.8" class="pilcrow">¶</a>
1510</dd> 1544</dd>
1511 </dl> 1545 </dl>
1512</section> 1546</section>
@@ -1606,7 +1640,7 @@ async function addMetadata(){try{const e=document.styleSheets[0].cssRules;for(le
1606 include a periodic refresh publication. 1640 include a periodic refresh publication.
1607 A GNS resource records block has the following format:<a href="#section-4.2-1" class="pilcrow">¶</a></p> 1641 A GNS resource records block has the following format:<a href="#section-4.2-1" class="pilcrow">¶</a></p>
1608<div id="figure_record_block"> 1642<div id="figure_record_block">
1609<figure id="figure-7"> 1643<figure id="figure-8">
1610 <div class="artwork art-text alignLeft" id="section-4.2-2.1"> 1644 <div class="artwork art-text alignLeft" id="section-4.2-2.1">
1611<pre> 1645<pre>
1612 0 8 16 24 32 40 48 56 1646 0 8 16 24 32 40 48 56
@@ -1635,7 +1669,7 @@ async function addMetadata(){try{const e=document.styleSheets[0].cssRules;for(le
1635 +-----+-----+-----+-----+-----+-----+-----+-----+ 1669 +-----+-----+-----+-----+-----+-----+-----+-----+
1636 </pre> 1670 </pre>
1637</div> 1671</div>
1638<figcaption><a href="#figure-7" class="selfRef">Figure 7</a></figcaption></figure> 1672<figcaption><a href="#figure-8" class="selfRef">Figure 8</a></figcaption></figure>
1639</div> 1673</div>
1640<p id="section-4.2-3">where:<a href="#section-4.2-3" class="pilcrow">¶</a></p> 1674<p id="section-4.2-3">where:<a href="#section-4.2-3" class="pilcrow">¶</a></p>
1641<dl class="dlParallel" id="section-4.2-4"> 1675<dl class="dlParallel" id="section-4.2-4">
@@ -1698,7 +1732,7 @@ async function addMetadata(){try{const e=document.styleSheets[0].cssRules;for(le
1698 set RDATA into the BDATA field of a GNS record block. 1732 set RDATA into the BDATA field of a GNS record block.
1699 The wire format of the RDATA looks as follows:<a href="#section-4.3-1" class="pilcrow">¶</a></p> 1733 The wire format of the RDATA looks as follows:<a href="#section-4.3-1" class="pilcrow">¶</a></p>
1700<div id="figure_rdata"> 1734<div id="figure_rdata">
1701<figure id="figure-8"> 1735<figure id="figure-9">
1702 <div class="artwork art-text alignLeft" id="section-4.3-2.1"> 1736 <div class="artwork art-text alignLeft" id="section-4.3-2.1">
1703<pre> 1737<pre>
1704 0 8 16 24 32 40 48 56 1738 0 8 16 24 32 40 48 56
@@ -1726,7 +1760,7 @@ async function addMetadata(){try{const e=document.styleSheets[0].cssRules;for(le
1726 / / 1760 / /
1727 </pre> 1761 </pre>
1728</div> 1762</div>
1729<figcaption><a href="#figure-8" class="selfRef">Figure 8</a></figcaption></figure> 1763<figcaption><a href="#figure-9" class="selfRef">Figure 9</a></figcaption></figure>
1730</div> 1764</div>
1731<p id="section-4.3-3">where:<a href="#section-4.3-3" class="pilcrow">¶</a></p> 1765<p id="section-4.3-3">where:<a href="#section-4.3-3" class="pilcrow">¶</a></p>
1732<dl class="dlParallel" id="section-4.3-4"> 1766<dl class="dlParallel" id="section-4.3-4">
@@ -1785,7 +1819,7 @@ async function addMetadata(){try{const e=document.styleSheets[0].cssRules;for(le
1785 <span>[<a href="#RFC3826" class="xref">RFC3826</a>]</span> key 1819 <span>[<a href="#RFC3826" class="xref">RFC3826</a>]</span> key
1786 and a 256-bit TWOFISH <span>[<a href="#TWOFISH" class="xref">TWOFISH</a>]</span> key:<a href="#section-4.3-8" class="pilcrow">¶</a></p> 1820 and a 256-bit TWOFISH <span>[<a href="#TWOFISH" class="xref">TWOFISH</a>]</span> key:<a href="#section-4.3-8" class="pilcrow">¶</a></p>
1787<div id="figure_hkdf_keys"> 1821<div id="figure_hkdf_keys">
1788<figure id="figure-9"> 1822<figure id="figure-10">
1789 <div class="artwork art-text alignLeft" id="section-4.3-9.1"> 1823 <div class="artwork art-text alignLeft" id="section-4.3-9.1">
1790<pre> 1824<pre>
1791 0 8 16 24 32 40 48 56 1825 0 8 16 24 32 40 48 56
@@ -1802,13 +1836,13 @@ async function addMetadata(){try{const e=document.styleSheets[0].cssRules;for(le
1802 +-----+-----+-----+-----+-----+-----+-----+-----+ 1836 +-----+-----+-----+-----+-----+-----+-----+-----+
1803 </pre> 1837 </pre>
1804</div> 1838</div>
1805<figcaption><a href="#figure-9" class="selfRef">Figure 9</a></figcaption></figure> 1839<figcaption><a href="#figure-10" class="selfRef">Figure 10</a></figcaption></figure>
1806</div> 1840</div>
1807<p id="section-4.3-10"> 1841<p id="section-4.3-10">
1808 Similarly, we divide "IV" into a 128-bit initialization vector 1842 Similarly, we divide "IV" into a 128-bit initialization vector
1809 and a 128-bit initialization vector:<a href="#section-4.3-10" class="pilcrow">¶</a></p> 1843 and a 128-bit initialization vector:<a href="#section-4.3-10" class="pilcrow">¶</a></p>
1810<div id="figure_hkdf_ivs"> 1844<div id="figure_hkdf_ivs">
1811<figure id="figure-10"> 1845<figure id="figure-11">
1812 <div class="artwork art-text alignLeft" id="section-4.3-11.1"> 1846 <div class="artwork art-text alignLeft" id="section-4.3-11.1">
1813<pre> 1847<pre>
1814 0 8 16 24 32 40 48 56 1848 0 8 16 24 32 40 48 56
@@ -1821,7 +1855,7 @@ async function addMetadata(){try{const e=document.styleSheets[0].cssRules;for(le
1821 +-----+-----+-----+-----+-----+-----+-----+-----+ 1855 +-----+-----+-----+-----+-----+-----+-----+-----+
1822 </pre> 1856 </pre>
1823</div> 1857</div>
1824<figcaption><a href="#figure-10" class="selfRef">Figure 10</a></figcaption></figure> 1858<figcaption><a href="#figure-11" class="selfRef">Figure 11</a></figcaption></figure>
1825</div> 1859</div>
1826<p id="section-4.3-12"> 1860<p id="section-4.3-12">
1827 The keys and IVs are used for a CFB128-AES-256 and 1861 The keys and IVs are used for a CFB128-AES-256 and