[tor-commits] [torspec] 02/04: prop339: Unify the address format into one object

[gitolite role]

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

dgoulet pushed a commit to branch main
in repository torspec.

commit e7878316891312f3ad81202ba115bd631f7ddd9a
Author: David Goulet <dgoulet at torproject.org>
AuthorDate: Tue Jun 7 09:47:07 2022 -0400

    prop339: Unify the address format into one object
    
    Signed-off-by: David Goulet <dgoulet at torproject.org>
---
 proposals/339-udp-over-tor.md | 65 +++++++++++++++++++++++++------------------
 1 file changed, 38 insertions(+), 27 deletions(-)

diff --git a/proposals/339-udp-over-tor.md b/proposals/339-udp-over-tor.md
index 2a822aa..7bebba0 100644
--- a/proposals/339-udp-over-tor.md
+++ b/proposals/339-udp-over-tor.md
@@ -149,6 +149,39 @@ along with extensions to some older relay message types.  We note in
 passing how we could extend these messages to support unconnected UDP
 sockets in the future.
 
+### Common Format
+
+We define here a common format for an "address" that is used both in a
+CONNECT_UDP and CONNECTED_UDP cell.
+
+#### Address
+
+Defines an IP or Hostname address along with its port. This can be seen as the
+`ADDRPORT` of a `BEGIN` cell defined in tor-spec.txt but with a different
+format.
+
+```
+/* Address types */
+const T_HOSTNAME = 0x01;
+const T_IPV4     = 0x04;
+const T_IPV6     = 0x06;
+
+struct address {
+   u8 type IN [T_IPV4, T_IPV6, T_HOSTNAME];
+   u8 len IN [0, 255];
+   union addr[type] with length len {
+      T_IPV4: u32 ipv4;
+      T_IPV6: u8 ipv6[16];
+      T_HOSTNAME: u8 hostname[];
+   };
+   u16 port IN [1, 65535];
+}
+```
+
+The `hostname` follows the RFC1035 for its accepted length that is 63
+characters or less that is a `len` between 0 and 255 (bytes). It should
+contain a sequence of nonzero octets as in any nul byte results in a malformed
+cell.
 
 ### CONNECT_UDP
 
@@ -161,26 +194,13 @@ sockets in the future.
 struct connect_udp_body {
    /* As in BEGIN cells. */
    u32 flags;
-   /* Tag for union below. */
-   u8 addr_type IN [T_HOSTNAME, T_IPV4, T_IPV6];
-   /* Length of the following union */
-   u8 addr_len;
-   /* The address to connect to. */
-   union address[addr_type] with length addr_len {
-      T_IPV4: u32 ipv4;
-      T_IPV6: u8 ipv6[16];
-      T_HOSTNAME: hostname;
-   };
-   u16 port;
+   /* Address to connect to. */
+   struct address addr;
    // The rest is ignored.
 
    // TODO: Is "the rest is ignored" still a good idea? Look at Rochet's
    // research.
 }
-/* Address types */
-const T_HOSTNAME = 0x01;
-const T_IPV4     = 0x04;
-const T_IPV6     = 0x06;
 
 /* As in BEGIN cells: these control how hostnames are interpreted.
    Clients MUST NOT send unrecognized flags; relays MUST ignore them.
@@ -212,20 +232,11 @@ struct udp_connected_body {
    // TODO: Is "the rest is ignored" still a good idea? Look at Rochet's
    // research.
 }
-
-/* Note that this is a subset of the allowable address parts of a CONNECT_UDP 
- * message */
-struct address {
-   u8 tag IN [T_IPV4, T_IPV6];
-   u8 len;
-   union addr[tag] with length len {
-      T_IPV4: u32 ipv4;
-      T_IPV6: u8 ipv6[16];
-   };
-   u16 port;
-}
 ```
 
+Both `our_address` and `their_address` MUST NOT be of type `T_HOSTNAME` else
+the cell is considered malformed.
+
 ### DATAGRAM
 
 ```

-- 
To stop receiving notification emails like this one, please contact
the administrator of this repository.