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 8614C130E65
 for <quic-issues@ietfa.amsl.com>; Fri, 28 Sep 2018 09:25:23 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -3
X-Spam-Level: 
X-Spam-Status: No, score=-3 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, 
 DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, GB_SUMOF=5,
 HTML_MESSAGE=0.001, MAILING_LIST_MULTI=-1, RCVD_IN_DNSWL_HI=-5,
 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 zGFZMcPxVEmA for <quic-issues@ietfa.amsl.com>;
 Fri, 28 Sep 2018 09:25:22 -0700 (PDT)
Received: from out-2.smtp.github.com (out-2.smtp.github.com [192.30.252.193])
 (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits))
 (No client certificate requested)
 by ietfa.amsl.com (Postfix) with ESMTPS id 0E8A9130E63
 for <quic-issues@ietf.org>; Fri, 28 Sep 2018 09:25:22 -0700 (PDT)
Date: Fri, 28 Sep 2018 09:25:20 -0700
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=github.com;
 s=pf2014; t=1538151920;
 bh=cD0OPMK1s743FH7rjspoidDMVGvchhWxvF4awTo0+Jk=;
 h=Date:From:Reply-To:To:Cc:In-Reply-To:References:Subject:List-ID:
 List-Archive:List-Post:List-Unsubscribe:From;
 b=WMGO8oIUUFPMA5MpPTgVfZYq4tE5j2umbYrN7ZfsZgNZjhRMXXpURJ21R/i20owWI
 leafMcfBuEmFPsOAhVKlTE0HrF2U2j7KqRw/1DBl3oyxidDr2jxwmYukMLbFqLgP6t
 Gp6zd93zTIiREvn8yxL5isfUZLg168brH7tYqi0k=
From: Mike Bishop <notifications@github.com>
Reply-To: quicwg/base-drafts
 <reply+0166e4ab04f709edf3eb540772ea464478fc5c26c14a092292cf0000000117c617f092a169ce1586350b@reply.github.com>
To: quicwg/base-drafts <base-drafts@noreply.github.com>
Cc: Subscribed <subscribed@noreply.github.com>
Message-ID: <quicwg/base-drafts/pull/1763/review/159931664@github.com>
In-Reply-To: <quicwg/base-drafts/pull/1763@github.com>
References: <quicwg/base-drafts/pull/1763@github.com>
Subject: Re: [quicwg/base-drafts] QPACK: Encode Largest Reference modulo
 MaxEntries (#1763)
Mime-Version: 1.0
Content-Type: multipart/alternative;
 boundary="--==_mimepart_5bae55f0d651f_4eb53fd74a8d45bc3620a6";
 charset=UTF-8
Content-Transfer-Encoding: 7bit
Precedence: list
X-GitHub-Sender: MikeBishop
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/P6nWphrUeZGAMByA4-8bZM9HHdg>
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: Fri, 28 Sep 2018 16:25:23 -0000


----==_mimepart_5bae55f0d651f_4eb53fd74a8d45bc3620a6
Content-Type: text/plain;
 charset=UTF-8
Content-Transfer-Encoding: 7bit

MikeBishop approved this pull request.



> -safe to process the rest of the block.
+safe to process the rest of the block.  If Largest Reference is greater than
+zero, the encoder transforms it as follows before encoding:
+
+~~~
+   LargestReference = LargestReference mod 2*MaxEntries + 1
+~~~
+
+The decoder reconstructs the Largest Reference using the following algorithm:
+
+~~~
+   if LargestReference > 0:
+      LargestReference -= 1
+      CurrentWrapped = TableLargestAbsoluteIndex mod 2*MaxEntries
+
+      if CurrentWrapped >= LargestReference + MaxEntries:

It makes sense -- if it can be either `MaxEntries` greater *or* `MaxEntries` lesser, then you have `2*MaxEntries + 1` items, counting the one you're currently on.  There's always ambiguity at the far end -- the end values in the range are equivalent -- but because those ambiguous entries are always MaxEntries away, they can't be sent without evicting something unacknowledged or referencing something already evicted, both of which are prohibited.

> +### Calculating Table Size
+
+The size of the dynamic table is the sum of the size of its entries.
+
+The size of an entry is the sum of its name's length in octets (as defined in
+{{string-literals}}), its value's length in octets, and 32.
+
+The size of an entry is calculated using the length of its name and value
+without any Huffman encoding applied.
+
+`MaxEntries` is the maximum number of entries that the dynamic table can have.
+The smallest entry has empty name and value strings and has the size of 32.
+The MaxEntries is calculated as
+
+~~~
+   MaxEntries = floor( MaxTableSize / 32 )

I was concerned that the doubling could cause this to give us one less entry than we need, but after playing with some edge table sizes for a few minutes, this seems to work.

-- 
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/1763#pullrequestreview-159931664
----==_mimepart_5bae55f0d651f_4eb53fd74a8d45bc3620a6
Content-Type: text/html;
 charset=UTF-8
Content-Transfer-Encoding: 7bit

<p><b>@MikeBishop</b> approved this pull request.</p>

<hr>

<p>In <a href="https://github.com/quicwg/base-drafts/pull/1763#discussion_r221309247">draft-ietf-quic-qpack.md</a>:</p>
<pre style='color:#555'>&gt; -safe to process the rest of the block.
+safe to process the rest of the block.  If Largest Reference is greater than
+zero, the encoder transforms it as follows before encoding:
+
+~~~
+   LargestReference = LargestReference mod 2*MaxEntries + 1
+~~~
+
+The decoder reconstructs the Largest Reference using the following algorithm:
+
+~~~
+   if LargestReference &gt; 0:
+      LargestReference -= 1
+      CurrentWrapped = TableLargestAbsoluteIndex mod 2*MaxEntries
+
+      if CurrentWrapped &gt;= LargestReference + MaxEntries:
</pre>
<p>It makes sense -- if it can be either <code>MaxEntries</code> greater <em>or</em> <code>MaxEntries</code> lesser, then you have <code>2*MaxEntries + 1</code> items, counting the one you're currently on.  There's always ambiguity at the far end -- the end values in the range are equivalent -- but because those ambiguous entries are always MaxEntries away, they can't be sent without evicting something unacknowledged or referencing something already evicted, both of which are prohibited.</p>

<hr>

<p>In <a href="https://github.com/quicwg/base-drafts/pull/1763#discussion_r221309621">draft-ietf-quic-qpack.md</a>:</p>
<pre style='color:#555'>&gt; +### Calculating Table Size
+
+The size of the dynamic table is the sum of the size of its entries.
+
+The size of an entry is the sum of its name&#39;s length in octets (as defined in
+{{string-literals}}), its value&#39;s length in octets, and 32.
+
+The size of an entry is calculated using the length of its name and value
+without any Huffman encoding applied.
+
+`MaxEntries` is the maximum number of entries that the dynamic table can have.
+The smallest entry has empty name and value strings and has the size of 32.
+The MaxEntries is calculated as
+
+~~~
+   MaxEntries = floor( MaxTableSize / 32 )
</pre>
<p>I was concerned that the doubling could cause this to give us one less entry than we need, but after playing with some edge table sizes for a few minutes, this seems to work.</p>

<p style="font-size:small;-webkit-text-size-adjust:none;color:#666;">&mdash;<br />You are receiving this because you are subscribed to this thread.<br />Reply to this email directly, <a href="https://github.com/quicwg/base-drafts/pull/1763#pullrequestreview-159931664">view it on GitHub</a>, or <a href="https://github.com/notifications/unsubscribe-auth/AWbkq6r_SOwEjSSDYJrySTHFFHpdRFjhks5ufk1wgaJpZM4WtE17">mute the thread</a>.<img src="https://github.com/notifications/beacon/AWbkq7Ja2OMr7vd77nqsKTc4hDHKKmNEks5ufk1wgaJpZM4WtE17.gif" height="1" width="1" alt="" /></p>
<script type="application/json" data-scope="inboxmarkup">{"api_version":"1.0","publisher":{"api_key":"05dde50f1d1a384dd78767c55493e4bb","name":"GitHub"},"entity":{"external_key":"github/quicwg/base-drafts","title":"quicwg/base-drafts","subtitle":"GitHub repository","main_image_url":"https://assets-cdn.github.com/images/email/message_cards/header.png","avatar_image_url":"https://assets-cdn.github.com/images/email/message_cards/avatar.png","action":{"name":"Open in GitHub","url":"https://github.com/quicwg/base-drafts"}},"updates":{"snippets":[{"icon":"PERSON","message":"@MikeBishop approved #1763"}],"action":{"name":"View Pull Request","url":"https://github.com/quicwg/base-drafts/pull/1763#pullrequestreview-159931664"}}}</script>
<script type="application/ld+json">[
{
"@context": "http://schema.org",
"@type": "EmailMessage",
"potentialAction": {
"@type": "ViewAction",
"target": "https://github.com/quicwg/base-drafts/pull/1763#pullrequestreview-159931664",
"url": "https://github.com/quicwg/base-drafts/pull/1763#pullrequestreview-159931664",
"name": "View Pull Request"
},
"description": "View this Pull Request on GitHub",
"publisher": {
"@type": "Organization",
"name": "GitHub",
"url": "https://github.com"
}
},
{
"@type": "MessageCard",
"@context": "http://schema.org/extensions",
"hideOriginalBody": "false",
"originator": "AF6C5A86-E920-430C-9C59-A73278B5EFEB",
"title": "@MikeBishop approved 1763",
"sections": [
{
"text": "",
"activityTitle": "**Mike Bishop**",
"activityImage": "https://assets-cdn.github.com/images/email/message_cards/avatar.png",
"activitySubtitle": "@MikeBishop",
"facts": [

]
}
],
"potentialAction": [
{
"targets": [
{
"os": "default",
"uri": "https://github.com/quicwg/base-drafts/pull/1763#pullrequestreview-159931664"
}
],
"@type": "OpenUri",
"name": "View on GitHub"
},
{
"name": "Unsubscribe",
"@type": "HttpPOST",
"target": "https://api.github.com",
"body": "{\n\"commandName\": \"MuteNotification\",\n\"threadId\": 380915067\n}"
}
],
"themeColor": "26292E"
}
]</script>
----==_mimepart_5bae55f0d651f_4eb53fd74a8d45bc3620a6--

