Re: [Cbor] 🔔 WGLC with request for reviews on cbor-network-addresses-05

Michael Richardson <mcr+ietf@sandelman.ca> Sun, 18 July 2021 00:33 UTC

Return-Path: <mcr+ietf@sandelman.ca>
X-Original-To: cbor@ietfa.amsl.com
Delivered-To: cbor@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 369573A2A6B for <cbor@ietfa.amsl.com>; Sat, 17 Jul 2021 17:33:35 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.899
X-Spam-Level:
X-Spam-Status: No, score=-1.899 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
Received: from mail.ietf.org ([4.31.198.44]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id cHs8X1C_A3Ah for <cbor@ietfa.amsl.com>; Sat, 17 Jul 2021 17:33:30 -0700 (PDT)
Received: from tuna.sandelman.ca (tuna.sandelman.ca [209.87.249.19]) (using TLSv1.2 with cipher ADH-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 402693A2A69 for <cbor@ietf.org>; Sat, 17 Jul 2021 17:33:30 -0700 (PDT)
Received: from localhost (localhost [127.0.0.1]) by tuna.sandelman.ca (Postfix) with ESMTP id 630FF38995; Sat, 17 Jul 2021 20:36:38 -0400 (EDT)
Received: from tuna.sandelman.ca ([127.0.0.1]) by localhost (localhost [127.0.0.1]) (amavisd-new, port 10024) with LMTP id 3DKGGIoEqf3t; Sat, 17 Jul 2021 20:36:34 -0400 (EDT)
Received: from sandelman.ca (obiwan.sandelman.ca [IPv6:2607:f0b0:f:2::247]) by tuna.sandelman.ca (Postfix) with ESMTP id CD8EA38992; Sat, 17 Jul 2021 20:36:34 -0400 (EDT)
Received: from localhost (localhost [IPv6:::1]) by sandelman.ca (Postfix) with ESMTP id 699ED904; Sat, 17 Jul 2021 20:33:24 -0400 (EDT)
From: Michael Richardson <mcr+ietf@sandelman.ca>
To: Brian E Carpenter <brian.e.carpenter@gmail.com>, cbor@ietf.org
In-Reply-To: <d8899839-a399-f3e6-fa3c-1fa95ee0bd61@gmail.com>
References: <YPGg6rnN6H3feUYx@hephaistos.amsuess.com> <CALaySJK4-xQLpcaucyMb=w1b27X+VEwMQn-8ONawRJ4bJ=rWQQ@mail.gmail.com> <f2162cdb-761c-d1dd-0d10-ff98dfaa4001@gmail.com> <32191.1626561368@localhost> <d8899839-a399-f3e6-fa3c-1fa95ee0bd61@gmail.com>
X-Mailer: MH-E 8.6+git; nmh 1.7+dev; GNU Emacs 26.1
X-Face: $\n1pF)h^`}$H>Hk{L"x@)JS7<%Az}5RyS@k9X%29-lHB$Ti.V>2bi.~ehC0; <'$9xN5Ub# z!G,p`nR&p7Fz@^UXIn156S8.~^@MJ*mMsD7=QFeq%AL4m<nPbLgmtKK-5dC@#:k
MIME-Version: 1.0
Content-Type: multipart/signed; boundary="=-=-="; micalg=pgp-sha512; protocol="application/pgp-signature"
Date: Sat, 17 Jul 2021 20:33:24 -0400
Message-ID: <32107.1626568404@localhost>
Archived-At: <https://mailarchive.ietf.org/arch/msg/cbor/-yDWvBxJ3bbH93XVy11P-OUIpZU>
Subject: Re: [Cbor] =?utf-8?q?=F0=9F=94=94_WGLC_with_request_for_reviews_on_c?= =?utf-8?q?bor-network-addresses-05?=
X-BeenThere: cbor@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: "Concise Binary Object Representation \(CBOR\)" <cbor.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/cbor>, <mailto:cbor-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/cbor/>
List-Post: <mailto:cbor@ietf.org>
List-Help: <mailto:cbor-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/cbor>, <mailto:cbor-request@ietf.org?subject=subscribe>
X-List-Received-Date: Sun, 18 Jul 2021 00:33:35 -0000

Brian E Carpenter <brian.e.carpenter@gmail.com> wrote:
    >> (as I write this, I realize that maybe we should name each format)

    > Good idea.

https://github.com/cbor-wg/cbor-network-address/pull/6/files

New/adjusted text below, please comment on github.
I'm not sure about the ToC levels here.

## Three Forms

### Addresses

These tags can be applied to byte strings to represent a single address.

This form is called the Address Format.

### Prefixes

When applied to an array that starts with a number, they represent a
CIDR-style prefix of that length.

When an Address (byte string), i.e., without prefix) appears in a context where a prefix is expected, then it is to be assumed that all bits are relevant.
That is, for IPv4, a /32 is implied, and for IPv6, a /128 is implied.

This form is called the Prefix Format.

### Interface Definition

When applied to an array that starts with a byte string, that stands
for an IP address, followed by the bit length of a prefix built out of
the first `length` bits of the address.

This form is called the Interface Format, or Interface Definition.




--
Michael Richardson <mcr+IETF@sandelman.ca>   . o O ( IPv6 IøT consulting )
           Sandelman Software Works Inc, Ottawa and Worldwide