[lsd0004] branch master updated: IANA/GANA considerations

[gnunet]

This is an automated email from the git hooks/post-receive script.

grothoff pushed a commit to branch master
in repository lsd0004.

The following commit(s) were added to refs/heads/master by this push:
     new 3f0cec4  IANA/GANA considerations
3f0cec4 is described below

commit 3f0cec40b22cfdf999dbeb79d8197c7071f1f9eb
Author: Christian Grothoff <grothoff@gnunet.org>
AuthorDate: Fri Mar 11 03:08:42 2022 +0100

    IANA/GANA considerations
---
 draft-schanzen-r5n.xml | 94 +++++++++++++++++++++++++++++++++++++++-----------
 1 file changed, 73 insertions(+), 21 deletions(-)

diff --git a/draft-schanzen-r5n.xml b/draft-schanzen-r5n.xml
index e0ddee6..03bbd94 100644
--- a/draft-schanzen-r5n.xml
+++ b/draft-schanzen-r5n.xml
@@ -683,16 +683,30 @@ Connectivity | |Underlay|  |Underlay|
           is the URL-escaped payload of the address URI without the "://".
         </t>
         <t>
-          For example, consider the URL
-"""          
-gnunet://hello/RH1M20EPK834M6MHZ72G3CMBSF3ECKNY4W0T9VAQP9Z7SZEM6Y3G/
-NGRTAH6RA04X467CGCH7M7CEXR5F9CV5HTZFK0G9BWETY3CCE2QWGVT4WA7JN5M9HMWG
-60A00R71F1PJP8N5628EKGHHBAGA7M8JW30/1647134480?udp=127.0.0.1%3A2086
-"""
+          For example, consider the following URL:
+        </t>
+       <figure>
+         <artwork type="abnf"><![CDATA[
+gnunet://hello/RH1M20EPK834M6MHZ72\
+G3CMBSF3ECKNY4W0T9VAQP9Z7SZEM6Y3G/\
+NGRTAH6RA04X467CGCH7M7CEXR5F9CV5HT\
+ZFK0G9BWETY3CCE2QWGVT4WA7JN5M9HMWG\
+60A00R71F1PJP8N5628EKGHHBAGA7M8JW3\
+0/1647134480?udp=127.0.0.1%3A2086
+
+FIXME: signature is invalid, should
+maybe generate proper test vector.
+]]>
+        </artwork> 
+        </figure>
+       <t>
           It specifies that the peer with the ID "RH1M...6Y3G"
           is reachable via "udp" at 127.0.0.1 on port 2086 until
-          1647134480 seconds after the Epoch.
-          FIXME: signature is invalid, generate proper test vector.
+          1647134480 seconds after the Epoch.  Note that "udp"
+         here is underspecified and just used as a simple example.
+         In practice, the key (addr-name)
+         <bcp14>MUST</bcp14> refer to a scheme supported by a
+         DHT Underlay.
         </t>
         <t>
           The general syntax of HELLO URLs specified using
@@ -700,17 +714,17 @@ 
NGRTAH6RA04X467CGCH7M7CEXR5F9CV5HTZFK0G9BWETY3CCE2QWGVT4WA7JN5M9HMWG
         </t>
        <figure>
          <artwork type="abnf"><![CDATA[
-         hello-URL = "gnunet://hello/" meta [ "?" addrs ]
-          meta = pid "/" sig "/" exp
-          pid = *bchar
-          sig = *bchar
-          exp = *DIGIT
-         addrs = addr *( "&" addr )
-         addr = addr-name "=" addr-value
-         addr-name = scheme
-         addr-value = *pchar
-         bchar = *(ALPHA / DIGIT)
-         ]]>
+hello-URL = "gnunet://hello/" meta [ "?" addrs ]
+meta = pid "/" sig "/" exp
+pid = *bchar
+sig = *bchar
+exp = *DIGIT
+addrs = addr *( "&" addr )
+addr = addr-name "=" addr-value
+addr-name = scheme
+addr-value = *pchar
+bchar = *(ALPHA / DIGIT)
+]]>
         </artwork> 
         </figure>
        <t>
@@ -1975,8 +1989,16 @@ gnunet+tcp://12.3.4.5/ \
     <section anchor="iana" numbered="true" toc="default">
       <name>IANA Considerations</name>
       <t>
-        TODO: URI handler for "common" URI handler that Underlays may want
-        to use as part of HELLOs.
+        TODO: URI schema for "common" URI handler that Underlays may want
+        to use as part of HELLOs, i.e. what we currently term "ip+udp"
+       (but maybe change to "r5n+ip+udp://"!?).
+      </t>
+      <t>
+        TODO: URI schema for "gnunet://", as used for HELLO URIs
+       and for GNUnet-underlay addresses! We basically use both
+       gnunet://hello/ and gnunet://address/, so we should also register
+       "gnunet://" and say that the sub-registry is managed
+       by GANA!
       </t>
     </section>
     <section anchor="gana" numbered="true" toc="default">
@@ -2012,6 +2034,36 @@ Number| Name   | Contact | References | Description
 11      GNS      N/A       GNS          Block for storing record data
 ]]></artwork>
       </figure>
+
+      <t>
+        GANA <xref target="GANA"/>
+        is requested to create a "gnunet://" sub-registry.
+        The registry shall record for each entry:
+      </t>
+      <ul>
+        <li>Name: The name of the subsystem (case-insensitive ASCII
+          string, restricted to alphanumeric characters</li>
+        <li>Comment: Optionally, a brief English text describing the purpose of
+          the subsystem (in UTF-8)</li>
+        <li>Contact: Optionally, the contact information of a person to 
contact for
+          further information</li>
+        <li>References: Optionally, references describing the syntax of the URL
+          (such as an RFC or LSD)</li>
+      </ul>
+      <t>
+        The registration policy for this sub-registry is "First Come First
+        Served", as described in <xref target="RFC8126"/>.
+        GANA is requested to populate this registry as follows:
+      </t>
+      <figure anchor="figure_gnunetschema" title="GNUnet schema Subregistry.">
+        <artwork name="" type="" align="left" alt=""><![CDATA[
+Nam            | Contact | References | Description
+---------------+---------+------------+-------------------------
+HELLO            N/A       [This.I-D]   How to contact a peer.
+ADDRESS          N/A       N/A          Network address.
+]]></artwork>
+      </figure>
+
       <t>
         GANA is requested to amend the "GNUnet Signature Purpose" registry
         as follows:

-- 
To stop receiving notification emails like this one, please contact
gnunet@gnunet.org.