Re: [quicwg/base-drafts] Alternative packet format presentation (#3573)
Lucas Pardue <notifications@github.com> Wed, 15 April 2020 18:00 UTC
Return-Path: <noreply@github.com>
X-Original-To: quic-issues@ietfa.amsl.com
Delivered-To: quic-issues@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 81BD83A0E9B for <quic-issues@ietfa.amsl.com>; Wed, 15 Apr 2020 11:00:42 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -3.267
X-Spam-Level:
X-Spam-Status: No, score=-3.267 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.168, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, HTML_MESSAGE=0.001, MAILING_LIST_MULTI=-1, SPF_HELO_NONE=0.001, SPF_PASS=-0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (1024-bit key) header.d=github.com
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 ku_34TFJDFPw for <quic-issues@ietfa.amsl.com>; Wed, 15 Apr 2020 11:00:39 -0700 (PDT)
Received: from out-24.smtp.github.com (out-24.smtp.github.com [192.30.252.207]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 5F0C43A0EA6 for <quic-issues@ietf.org>; Wed, 15 Apr 2020 11:00:39 -0700 (PDT)
Received: from github-lowworker-e8b54ca.ac4-iad.github.net (github-lowworker-e8b54ca.ac4-iad.github.net [10.52.23.39]) by smtp.github.com (Postfix) with ESMTP id D43296A1ED0 for <quic-issues@ietf.org>; Wed, 15 Apr 2020 11:00:37 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=github.com; s=pf2014; t=1586973637; bh=RwgQo+hfMFIAs4oWBfeu1iQtWYkhJPR5JGTjh7fJydY=; h=Date:From:Reply-To:To:Cc:In-Reply-To:References:Subject:List-ID: List-Archive:List-Post:List-Unsubscribe:From; b=wH/LWcZ2kGSZ4+WlRJxs725pmmpsLPy7KH50MUo2zMJ+TQS7UjB9PD1KHm3lzJtn1 3BL84Jkg67U79EzgdJrcfVtb7o8by2F719+7RFQMCKc+PqHsKOZMCcwQVYxqQn74Ir dg8YF7pop1e69SBWKbVUAH1h1YI6ODzMi9BOQHBw=
Date: Wed, 15 Apr 2020 11:00:37 -0700
From: Lucas Pardue <notifications@github.com>
Reply-To: quicwg/base-drafts <reply+AFTOJKZXU6I6QX3Q55HVKQF4UMWMLEVBNHHCHFHWFE@reply.github.com>
To: quicwg/base-drafts <base-drafts@noreply.github.com>
Cc: Subscribed <subscribed@noreply.github.com>
Message-ID: <quicwg/base-drafts/pull/3573/review/394000888@github.com>
In-Reply-To: <quicwg/base-drafts/pull/3573@github.com>
References: <quicwg/base-drafts/pull/3573@github.com>
Subject: Re: [quicwg/base-drafts] Alternative packet format presentation (#3573)
Mime-Version: 1.0
Content-Type: multipart/alternative; boundary="--==_mimepart_5e974bc5c4bfd_b673f91c7acd968399694"; charset="UTF-8"
Content-Transfer-Encoding: 7bit
Precedence: list
X-GitHub-Sender: LPardue
X-GitHub-Recipient: quic-issues
X-GitHub-Reason: subscribed
X-Auto-Response-Suppress: All
X-GitHub-Recipient-Address: quic-issues@ietf.org
Archived-At: <https://mailarchive.ietf.org/arch/msg/quic-issues/DQ_ESYCt4fbdhYWgBbE7hZzcmhI>
X-BeenThere: quic-issues@ietf.org
X-Mailman-Version: 2.1.29
List-Id: Notification list for GitHub issues related to the QUIC WG <quic-issues.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/quic-issues>, <mailto:quic-issues-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/quic-issues/>
List-Post: <mailto:quic-issues@ietf.org>
List-Help: <mailto:quic-issues-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/quic-issues>, <mailto:quic-issues-request@ietf.org?subject=subscribe>
X-List-Received-Date: Wed, 15 Apr 2020 18:00:43 -0000
@LPardue requested changes on this pull request. Overall I like this. The terser presentation allows you to define the full H3 frame, which I really like. Strictly, those figures now present the whole frame so I've made the suggestion to drop the `Payload` qualifier. Also see comment about the 0 or more SETTINGS parameters, which needs a fixup. > @@ -1229,11 +1220,11 @@ frame is received on a control stream, the recipient MUST respond with a connection error ({{errors}}) of type H3_FRAME_UNEXPECTED. ~~~~~~~~~~ drawing - 0 1 2 3 - 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 -+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ -| Payload (*) ... -+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ +DATA Frame { + Type (i) = 0x0, + Length (i), + Data (..), +} ~~~~~~~~~~ {: #fig-data title="DATA Frame Payload"} ```suggestion {: #fig-data title="DATA Frame"} ``` > @@ -1243,11 +1234,11 @@ The HEADERS frame (type=0x1) is used to carry an HTTP field section, encoded using QPACK. See [QPACK] for more details. ~~~~~~~~~~ drawing - 0 1 2 3 - 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 -+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ -| Encoded Field Section (*) ... -+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ +HEADERS Frame { + Type (i) = 0x1, + Length (i), + Encoded Field Section (..), +} ~~~~~~~~~~ {: #fig-headers title="HEADERS Frame Payload"} ```suggestion {: #fig-headers title="HEADERS Frame"} ``` > @@ -1284,11 +1275,11 @@ frame on a stream other than the control stream MUST be treated as a connection error of type H3_FRAME_UNEXPECTED. ~~~~~~~~~~ drawing - 0 1 2 3 - 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 -+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ -| Push ID (i) ... -+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ +CANCEL_PUSH Frame { + Type (i) = 0x3, + Length (i), + Push ID (..), +} ~~~~~~~~~~ {: #fig-cancel-push title="CANCEL_PUSH Frame Payload"} ```suggestion {: #fig-cancel-push title="CANCEL_PUSH Frame"} ``` > +SETTINGS Frame { + Type (i) = 0x4, + Length (i), + Identifier (i), + Value (i), +} This is wrong, sorry. The text discusses that the frame contains 0 or more parameters and the old drawing presents the format of the parameter, not the frame. I think what you want to do is present the pair of (Identifier, Value) with cardinality, and then update the fig title to sat "SETTINGS Frame". > @@ -1436,13 +1426,12 @@ The PUSH_PROMISE frame (type=0x5) is used to carry a promised request header field section from server to client on a request stream, as in HTTP/2. ~~~~~~~~~~ drawing - 0 1 2 3 - 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 -+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ -| Push ID (i) ... -+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ -| Encoded Field Section (*) ... -+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ +PUSH_PROMISE Frame { + Type (i) = 0x5, + Length (i), + Push ID (i), + Encoded Field Section (..), +} ~~~~~~~~~~ {: #fig-push-promise title="PUSH_PROMISE Frame Payload"} ```suggestion {: #fig-push-promise title="PUSH_PROMISE Frame"} ``` > @@ -1496,11 +1485,11 @@ requests and pushes. This enables administrative actions, like server maintenance. GOAWAY by itself does not close a connection. ~~~~~~~~~~ drawing - 0 1 2 3 - 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 -+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ -| Stream ID/Push ID (i) ... -+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ +GOAWAY Frame { + Type (i) = 0x7, + Length (i), + Stream ID/Push ID (..), +} ~~~~~~~~~~ {: #fig-goaway title="GOAWAY Frame Payload"} ```suggestion {: #fig-goaway title="GOAWAY Frame"} ``` -- You are receiving this because you are subscribed to this thread. Reply to this email directly or view it on GitHub: https://github.com/quicwg/base-drafts/pull/3573#pullrequestreview-394000888
- [quicwg/base-drafts] Alternative packet format pr… Martin Thomson
- Re: [quicwg/base-drafts] Alternative packet forma… ianswett
- Re: [quicwg/base-drafts] Alternative packet forma… Mike Bishop
- Re: [quicwg/base-drafts] Alternative packet forma… Rich Salz
- Re: [quicwg/base-drafts] Alternative packet forma… Mike Bishop
- Re: [quicwg/base-drafts] Alternative packet forma… Rich Salz
- Re: [quicwg/base-drafts] Alternative packet forma… Jana Iyengar
- Re: [quicwg/base-drafts] Alternative packet forma… Martin Thomson
- Re: [quicwg/base-drafts] Alternative packet forma… Martin Thomson
- Re: [quicwg/base-drafts] Alternative packet forma… ianswett
- Re: [quicwg/base-drafts] Alternative packet forma… Lucas Pardue
- Re: [quicwg/base-drafts] Alternative packet forma… Martin Thomson
- Re: [quicwg/base-drafts] Alternative packet forma… Martin Thomson
- Re: [quicwg/base-drafts] Alternative packet forma… Lucas Pardue
- Re: [quicwg/base-drafts] Alternative packet forma… ekr
- Re: [quicwg/base-drafts] Alternative packet forma… Martin Thomson
- Re: [quicwg/base-drafts] Alternative packet forma… Martin Thomson