Re: [quicwg/base-drafts] Rename Final Offset to Final Size (#2285)

Martin Thomson <> Thu, 03 January 2019 03:04 UTC

Return-Path: <>
Received: from localhost (localhost []) by (Postfix) with ESMTP id 1750F13106A for <>; Wed, 2 Jan 2019 19:04:42 -0800 (PST)
X-Virus-Scanned: amavisd-new at
X-Spam-Flag: NO
X-Spam-Score: -8.065
X-Spam-Status: No, score=-8.065 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.065, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, HTML_MESSAGE=0.001, MAILING_LIST_MULTI=-1, RCVD_IN_DNSWL_HI=-5, SPF_PASS=-0.001] autolearn=ham autolearn_force=no
Authentication-Results: (amavisd-new); dkim=pass (1024-bit key)
Received: from ([]) by localhost ( []) (amavisd-new, port 10024) with ESMTP id bFUMCk873FSt for <>; Wed, 2 Jan 2019 19:04:39 -0800 (PST)
Received: from ( []) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by (Postfix) with ESMTPS id 8323813103D for <>; Wed, 2 Jan 2019 19:04:38 -0800 (PST)
Date: Wed, 02 Jan 2019 19:04:36 -0800
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;; s=pf2014; t=1546484676; bh=EOYmZq3yRqjqxv4FFibwSDz6lHmC3twemXvXkxIZSKs=; h=Date:From:Reply-To:To:Cc:In-Reply-To:References:Subject:List-ID: List-Archive:List-Post:List-Unsubscribe:From; b=QmozRRyOMPzcUUpBnfIOMqoXKqGjSkMDsR1baSQ2qFdBw304YAAkEdrMYAEkmaZc6 uY3XZicYRtS1pIYGwl6AU/yuUZNLfOqYX+u7QA8vE1yaHzK36TIf2BxdYYKxsyA0oq Ki6H+xTSqtzgoiwnog5FTi58PTNzHRKvoxzQhBOU=
From: Martin Thomson <>
Reply-To: quicwg/base-drafts <>
To: quicwg/base-drafts <>
Cc: Subscribed <>
Message-ID: <quicwg/base-drafts/pull/2285/review/>
In-Reply-To: <quicwg/base-drafts/pull/>
References: <quicwg/base-drafts/pull/>
Subject: Re: [quicwg/base-drafts] Rename Final Offset to Final Size (#2285)
Mime-Version: 1.0
Content-Type: multipart/alternative; boundary="--==_mimepart_5c2d7bc49047c_6d083fc7f50d45c46689f"; charset="UTF-8"
Content-Transfer-Encoding: 7bit
Precedence: list
X-GitHub-Sender: martinthomson
X-GitHub-Recipient: quic-issues
X-GitHub-Reason: subscribed
X-Auto-Response-Suppress: All
Archived-At: <>
X-Mailman-Version: 2.1.29
List-Id: Notification list for GitHub issues related to the QUIC WG <>
List-Unsubscribe: <>, <>
List-Archive: <>
List-Post: <>
List-Help: <>
List-Subscribe: <>, <>
X-List-Received-Date: Thu, 03 Jan 2019 03:04:50 -0000

martinthomson commented on this pull request.

I think that this is fine, but wonder if a better definition would help.  Or maybe "end offset" - the offset of the end of the stream.

"offset" was chosen specifically because that is what matters.  And it allows for gaps.  So a more careful definition is probably needed either way.  I've a suggestion inline that uses "final size", but I think that "end offset" might still be better.

-The final offset is the count of the number of bytes that are transmitted on a
-stream.  For a stream that is reset, the final offset is carried explicitly in a
-RESET_STREAM frame.  Otherwise, the final offset is the offset of the end of the
-data carried in a STREAM frame marked with a FIN flag, or 0 in the case of
-incoming unidirectional streams.
+The final size is the amount of data that is transmitted on a stream.  For a

This is the critical piece.  We have to allow for gaps, so I suggest:

The final size is the amount of flow control credit that is consumed by a
stream.  Assuming that every contiguous byte on the stream was sent, the final
size is the number of bytes sent.  More generally, this is one higher than the
largest byte offset sent on the stream.

For a

You are receiving this because you are subscribed to this thread.
Reply to this email directly or view it on GitHub: