Re: draft-ietf-httpbis-header-structure-15, 2. Defining New Structured Headers

Mark Nottingham <mnot@mnot.net> Wed, 29 January 2020 22:22 UTC

Return-Path: <ietf-http-wg-request+bounce-httpbisa-archive-bis2juki=lists.ie@listhub.w3.org>
X-Original-To: ietfarch-httpbisa-archive-bis2Juki@ietfa.amsl.com
Delivered-To: ietfarch-httpbisa-archive-bis2Juki@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id DD717120045 for <ietfarch-httpbisa-archive-bis2Juki@ietfa.amsl.com>; Wed, 29 Jan 2020 14:22:41 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.75
X-Spam-Level:
X-Spam-Status: No, score=-2.75 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, HEADER_FROM_DIFFERENT_DOMAINS=0.25, MAILING_LIST_MULTI=-1, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=mnot.net header.b=uykbwT/t; dkim=pass (2048-bit key) header.d=messagingengine.com header.b=d8zv2AkJ
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 tPxY1CyeE-xu for <ietfarch-httpbisa-archive-bis2Juki@ietfa.amsl.com>; Wed, 29 Jan 2020 14:22:39 -0800 (PST)
Received: from frink.w3.org (frink.w3.org [IPv6:2603:400a:ffff:804:801e:34:0:38]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 8935F120013 for <httpbisa-archive-bis2Juki@lists.ietf.org>; Wed, 29 Jan 2020 14:22:39 -0800 (PST)
Received: from lists by frink.w3.org with local (Exim 4.89) (envelope-from <ietf-http-wg-request@listhub.w3.org>) id 1iwvhG-0007dP-31 for ietf-http-wg-dist@listhub.w3.org; Wed, 29 Jan 2020 22:20:30 +0000
Resent-Date: Wed, 29 Jan 2020 22:20:30 +0000
Resent-Message-Id: <E1iwvhG-0007dP-31@frink.w3.org>
Received: from titan.w3.org ([2603:400a:ffff:804:801e:34:0:4c]) by frink.w3.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from <mnot@mnot.net>) id 1iwvhE-0007ca-8j for ietf-http-wg@listhub.w3.org; Wed, 29 Jan 2020 22:20:28 +0000
Received: from out2-smtp.messagingengine.com ([66.111.4.26]) by titan.w3.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from <mnot@mnot.net>) id 1iwvhC-00070m-KR for ietf-http-wg@w3.org; Wed, 29 Jan 2020 22:20:28 +0000
Received: from compute3.internal (compute3.nyi.internal [10.202.2.43]) by mailout.nyi.internal (Postfix) with ESMTP id A56DF22089; Wed, 29 Jan 2020 17:20:23 -0500 (EST)
Received: from mailfrontend1 ([10.202.2.162]) by compute3.internal (MEProxy); Wed, 29 Jan 2020 17:20:23 -0500
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=mnot.net; h= content-type:mime-version:subject:from:in-reply-to:date:cc :content-transfer-encoding:message-id:references:to; s=fm1; bh=d +Wgn3O93IPbT8KVxFahxa0bEd6VRMIsYpgJ/FqlR9Y=; b=uykbwT/tv8vxF4gsK J/85xjUiYTe9v9X+WSqxOWUlwD4jC70tRv9jrLjzfcTxxSkQwoFQMiiHLrg2SLt8 jQy4zWkFRX4XGK1O3bBHYlDIA5T3TF4U+6OpjZAG92BeHwAhxEXYrVK+wl1gJZ4r xNHbjd+eA0HCSvGZ2q24KOTARWpHOthNGl7Y6kWRjYpdOvBgnChHn93RI9cbSj5K 0yUQOtlOY7DEDqr/X1RHYsETmpIXuBLIP+aS/pPoHR0I6qdM+Cs48/f4q/5jKuzG ipjDDKI4ufmBxW9ss4M39SRDOgHQWodp+ZNoQgiYTIV7jO/1ioci+1JDTu/0Z6+D UMOYA==
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:content-transfer-encoding:content-type :date:from:in-reply-to:message-id:mime-version:references :subject:to:x-me-proxy:x-me-proxy:x-me-sender:x-me-sender :x-sasl-enc; s=fm1; bh=d+Wgn3O93IPbT8KVxFahxa0bEd6VRMIsYpgJ/FqlR 9Y=; b=d8zv2AkJlR3R9oo5oylGT1tcwJPXiLuRcwXTbbdgMYcK6E5+O6o1+VO89 Jpu6aUXxUnMXKQ4lr7C4VrHG7X1PoSzB7yELQ5dmAcC1L7K64NvXXDKHFVfQae7+ ltC8vYgVQstk2ahkvsAXxjK9IH4N7uc0PDP5egFOBZe9m5AFdspxUuFazkTbv++/ zlnGW6xgwMiiQ5z9EWcNMwuz794EoOBvSsZ0pVoDPXcVPeUk0gYrWwldEzgjad3g ugafbtCP8GIXlmyrdjDVVC+DTS9lYkswfhFJ9FHFUwlv4dMYlon76uaoEV5ZIeF/ kGp0hiBxh1tJj/1JWT4phTc0DhssA==
X-ME-Sender: <xms:JgUyXhGTbnLImvdMQYVgHNpvNAS-pX0Bn9l2IbVFcuxkp0MbjP6Cmw>
X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedugedrfeeigdduheejucetufdoteggodetrfdotf fvucfrrhhofhhilhgvmecuhfgrshhtofgrihhlpdfqfgfvpdfurfetoffkrfgpnffqhgen uceurghilhhouhhtmecufedttdenucesvcftvggtihhpihgvnhhtshculddquddttddmne cujfgurheptggguffhjgffgffkfhfvofesthhqmhdthhdtvdenucfhrhhomhepofgrrhhk ucfpohhtthhinhhghhgrmhcuoehmnhhothesmhhnohhtrdhnvghtqeenucffohhmrghinh epihgvthhfrdhorhhgpdgvgigrmhhplhgvrdgtohhmpdhmnhhothdrnhgvthenucfkphep udduledrudejrdduheekrddvhedunecuvehluhhsthgvrhfuihiivgeptdenucfrrghrrg hmpehmrghilhhfrhhomhepmhhnohhtsehmnhhothdrnhgvth
X-ME-Proxy: <xmx:JgUyXotQcWxYLTiXfxqfHQSPbqR24_klMMSFzCAyKOkcCfK6-MApjg> <xmx:JgUyXkloS41J8Bt4D_GkG6Xv2RLROo5fvHOI2Pwy0LWJkNvXnPPjTg> <xmx:JgUyXowPl1QWbubTAuYgCHoaAsLp2chhFJ4TUjsbl5oHDnrWF3EqYg> <xmx:JwUyXsnUvWvikkQnFsnwIij44wmtEC6f--NyRMC1pN46Zh5jbCIEJw>
Received: from macbook-pro.mnot.net (unknown [119.17.158.251]) by mail.messagingengine.com (Postfix) with ESMTPA id DCEDA3280065; Wed, 29 Jan 2020 17:20:20 -0500 (EST)
Content-Type: text/plain; charset="us-ascii"
Mime-Version: 1.0 (Mac OS X Mail 13.0 \(3608.40.2.2.4\))
From: Mark Nottingham <mnot@mnot.net>
In-Reply-To: <20200129193455.5F71D23882@welho-filter2.welho.com>
Date: Thu, 30 Jan 2020 09:20:18 +1100
Cc: HTTP Working Group <ietf-http-wg@w3.org>, Poul-Henning Kamp <phk@varnish-cache.org>
Content-Transfer-Encoding: quoted-printable
Message-Id: <9E2F28E3-7632-4613-A74C-E0FC9D2E9E43@mnot.net>
References: <158028031175.4610.9085377324549619919@ietfa.amsl.com> <20200129193455.5F71D23882@welho-filter2.welho.com>
To: Kari Hurtta <hurtta-ietf@elmme-mailer.org>
X-Mailer: Apple Mail (2.3608.40.2.2.4)
Received-SPF: pass client-ip=66.111.4.26; envelope-from=mnot@mnot.net; helo=out2-smtp.messagingengine.com
X-W3C-Hub-Spam-Status: No, score=-9.8
X-W3C-Hub-Spam-Report: BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_LOW=-0.7, RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001, W3C_AA=-1, W3C_DB=-1, W3C_IRA=-1, W3C_IRR=-3, W3C_WL=-1
X-W3C-Scan-Sig: titan.w3.org 1iwvhC-00070m-KR 1e385bf67a51cb038bb6efdde70acc2e
X-Original-To: ietf-http-wg@w3.org
Subject: Re: draft-ietf-httpbis-header-structure-15, 2. Defining New Structured Headers
Archived-At: <https://www.w3.org/mid/9E2F28E3-7632-4613-A74C-E0FC9D2E9E43@mnot.net>
Resent-From: ietf-http-wg@w3.org
X-Mailing-List: <ietf-http-wg@w3.org> archive/latest/37321
X-Loop: ietf-http-wg@w3.org
Resent-Sender: ietf-http-wg-request@w3.org
Precedence: list
List-Id: <ietf-http-wg.w3.org>
List-Help: <https://www.w3.org/Mail/>
List-Post: <mailto:ietf-http-wg@w3.org>
List-Unsubscribe: <mailto:ietf-http-wg-request@w3.org?subject=unsubscribe>

Hi Kari,

Good catch; we recently updated the example to match the ABNF, but missed the prose. 

I wonder, however, if it's better to leave the disparity, to emphasise that keys are lc-only.

Cheers,


> On 30 Jan 2020, at 6:34 am, Kari Hurtta <hurtta-ietf@elmme-mailer.org> wrote:
> 
> 2.  Defining New Structured Headers
> https://tools.ietf.org/html/draft-ietf-httpbis-header-structure-15#section-2
> 
> 
> |   The following parameters are defined:
> |   * A parameter whose name is "fooUrl", and whose value is a string
> |     (Section Y.Y of [RFCxxxx]), conveying the Foo URLs
> |     for the message. See below for processing requirements.
> |
> |   "fooUrl" contains a URI-reference (Section 4.1 of
> |   [RFC3986], Section 4.1). If its value is not a valid URI-reference,
> |   that URL MUST be ignored. If its value is a relative reference
> |   (Section 4.2 of [RFC3986]), it MUST be resolved (Section 5 of
> |   [RFC3986]) before being used.
> |
> |   For example:
> |
> |     Foo-Example: 2; foourl="https://foo.example.com/"
> 
> 
> Example is fixed to use foourl, but text still uses "fooUrl" (uppercase letter).
> 
> 3.1.2.  Parameters
> https://tools.ietf.org/html/draft-ietf-httpbis-header-structure-15#section-3.1.2
> 
> says that parameter name is lcalpha  -- therefore foourl
> 
> | The ABNF for parameters in HTTP headers is:
> |
> |   parameter     = ";" *SP param-name [ "=" param-value ]
> |   param-name    = key
> |   key           = lcalpha *( lcalpha / DIGIT / "_" / "-" / "." / "*" )
> |   lcalpha       = %x61-7A ; a-z
> |   param-value   = bare-item
> 
> / Kari Hurtta
> 
> 
> 
> 

--
Mark Nottingham   https://www.mnot.net/