[quicwg/base-drafts] fa9f2a: Reorder TLS interface summary

Martin Thomson <noreply@github.com> Mon, 06 July 2020 02:06 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 ACBB43A0D72 for <quic-issues@ietfa.amsl.com>; Sun, 5 Jul 2020 19:06:39 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.101
X-Spam-Level:
X-Spam-Status: No, score=-2.101 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.001, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, URIBL_BLOCKED=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 SHhmSuxSkjtw for <quic-issues@ietfa.amsl.com>; Sun, 5 Jul 2020 19:06:38 -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 045DA3A0D71 for <quic-issues@ietf.org>; Sun, 5 Jul 2020 19:06:37 -0700 (PDT)
Received: from github-lowworker-fa7043e.ash1-iad.github.net (github-lowworker-fa7043e.ash1-iad.github.net [10.56.109.45]) by smtp.github.com (Postfix) with ESMTP id D990D6A08A9 for <quic-issues@ietf.org>; Sun, 5 Jul 2020 19:06:36 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=github.com; s=pf2014; t=1594001196; bh=L9oKg9vGdFjd4dQtKLg9CNYo5DR4csj+8u71inv89x0=; h=Date:From:To:Subject:From; b=hJ6e60LOjyvlt/M3sjd4qMp9vQQ+iiJACWI2K/GY6XHAvZv8QT6ynDjLY8V2yDTAi Ded2QE6Y/qYcxjKYmJ555Yqrn0kY4NuyM1VjV7nxU8K5HgBIwnDsSCMz6IZ89THX9e /xHDwV9HCygvDZ095NjNB7b5vnaiXO7Nq0zeh5i8=
Date: Sun, 05 Jul 2020 19:06:36 -0700
From: Martin Thomson <noreply@github.com>
To: quic-issues@ietf.org
Message-ID: <quicwg/base-drafts/push/refs/heads/interface-summary-order/000000-fa9f2a@github.com>
Subject: [quicwg/base-drafts] fa9f2a: Reorder TLS interface summary
Mime-Version: 1.0
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: 7bit
X-GitHub-Recipient-Address: quic-issues@ietf.org
X-Auto-Response-Suppress: All
Archived-At: <https://mailarchive.ietf.org/arch/msg/quic-issues/rF8QF2e7gH2FxMiqaGFBgqRaHrM>
X-BeenThere: quic-issues@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
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: Mon, 06 Jul 2020 02:06:40 -0000

  Branch: refs/heads/interface-summary-order
  Home:   https://github.com/quicwg/base-drafts
  Commit: fa9f2afff3dca923287bc8429e6066bd93980890
      https://github.com/quicwg/base-drafts/commit/fa9f2afff3dca923287bc8429e6066bd93980890
  Author: Martin Thomson <mt@lowentropy.net>
  Date:   2020-07-06 (Mon, 06 Jul 2020)

  Changed paths:
    M draft-ietf-quic-tls.md

  Log Message:
  -----------
  Reorder TLS interface summary

I came back to this today and found that the ordering was inconsistent
and not sufficiently clear.

Changing this so that all the actions for a single endpoint were grouped
seemed to be the best arrangement.  All events and actions are as close
as possible in the ordering to the preceding event that caused or
enabled it.

The application data packets are displayed with a different marking,
which helps distinguish those that carry CRYPTO frames.

The final implied exchange for Get Handshake was removed.  This was, I
think, intended to imply something about session tickets.  Without
explanation, it is confusing.

This doesn't show HANDSHAKE_DONE, nor do I think that it should, because
that is something that the transport does once it gets the Handshake
Complete signal.