Re: [Xml-sg-cmt] question on sourcecode type="test-vectors"
Alice Russo <arusso@amsl.com> Wed, 27 April 2022 23:23 UTC
Return-Path: <arusso@amsl.com>
X-Original-To: xml-sg-cmt@ietfa.amsl.com
Delivered-To: xml-sg-cmt@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 588B2C159828 for <xml-sg-cmt@ietfa.amsl.com>; Wed, 27 Apr 2022 16:23:39 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -6.899
X-Spam-Level:
X-Spam-Status: No, score=-6.899 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, RCVD_IN_DNSWL_HI=-5, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
Received: from mail.ietf.org ([50.223.129.194]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id yKWgEDHFgVtR for <xml-sg-cmt@ietfa.amsl.com>; Wed, 27 Apr 2022 16:23:35 -0700 (PDT)
Received: from c8a.amsl.com (c8a.amsl.com [4.31.198.40]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 63D1AC159522 for <xml-sg-cmt@ietf.org>; Wed, 27 Apr 2022 16:23:35 -0700 (PDT)
Received: from localhost (localhost [127.0.0.1]) by c8a.amsl.com (Postfix) with ESMTP id D17D2425C194; Wed, 27 Apr 2022 16:23:34 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
Received: from c8a.amsl.com ([127.0.0.1]) by localhost (c8a.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id IKaxexZTkN-a; Wed, 27 Apr 2022 16:23:34 -0700 (PDT)
Received: from [192.168.4.33] (c-24-17-19-210.hsd1.wa.comcast.net [24.17.19.210]) by c8a.amsl.com (Postfix) with ESMTPSA id A0DF8425A344; Wed, 27 Apr 2022 16:23:34 -0700 (PDT)
Content-Type: text/plain; charset="utf-8"
Mime-Version: 1.0 (Mac OS X Mail 10.3 \(3273\))
From: Alice Russo <arusso@amsl.com>
In-Reply-To: <e656a5dd-3130-d550-1744-8df09034a9f3@nostrum.com>
Date: Wed, 27 Apr 2022 16:23:32 -0700
Cc: "xml-sg-cmt@ietf.org" <xml-sg-cmt@ietf.org>
Content-Transfer-Encoding: quoted-printable
Message-Id: <BE9373BB-7A42-40F6-99E4-3F7BEC3C1B23@amsl.com>
References: <66806B6E-AEF2-4D4E-B3AD-66E7117EB3DC@amsl.com> <f76577a7-72c6-a2ff-61a2-caf836cf5d03@taugh.com> <d01ec942-e56b-4146-0e0b-3e44da9c47e3@taugh.com> <9e57234d-1f28-e8ce-132c-22d21dc98346@nostrum.com> <f7f194e3-dd67-e662-21e8-0298d31750f3@taugh.com> <e656a5dd-3130-d550-1744-8df09034a9f3@nostrum.com>
To: Robert Sparks <rjsparks@nostrum.com>
X-Mailer: Apple Mail (2.3273)
Archived-At: <https://mailarchive.ietf.org/arch/msg/xml-sg-cmt/Ua7X-tugXIRk7MQoQM7zDP0hMvE>
Subject: Re: [Xml-sg-cmt] question on sourcecode type="test-vectors"
X-BeenThere: xml-sg-cmt@ietf.org
X-Mailman-Version: 2.1.34
Precedence: list
List-Id: Working list for the xml and style guide change management team <xml-sg-cmt.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/xml-sg-cmt>, <mailto:xml-sg-cmt-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/xml-sg-cmt/>
List-Post: <mailto:xml-sg-cmt@ietf.org>
List-Help: <mailto:xml-sg-cmt-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/xml-sg-cmt>, <mailto:xml-sg-cmt-request@ietf.org?subject=subscribe>
X-List-Received-Date: Wed, 27 Apr 2022 23:23:39 -0000
inline. > On Apr 27, 2022, at 6:06 AM, Robert Sparks <rjsparks@nostrum.com> wrote: > > > On 4/26/22 6:21 PM, John R Levine wrote: >>> This document demonstrates that labeling these things clearly, so that (yes custom) code can pull these out using xml tools is _helpful_. >> >> Makes sense. So how about a more descriptive type like eap-akaprime-test-vector, so the next flavor of test vector doesn't step on them? > > would wfm, but futureproofing might argue for rfcnnnn-test-vector. > > (Generalizing for some future nnnn having multiple things to test: rfcnnnn-simplealg-test-vector, rfcnnnn-mti-test-vector, ...) FWIW, seems there's some precedent for "a more descriptive type" (without the RFC number): rfc8998.notprepped.xml: <section anchor="sm4-gcm-test-vectors" numbered="true" toc="default"> rfc8998.notprepped.xml: <section anchor="sm4-ccm-test-vectors" numbered="true" toc="default"> rfc9106.notprepped.xml: <section anchor="argon2d-test-vectors" numbered="true" toc="default"> rfc9106.notprepped.xml: <section anchor="argon2i-test-vectors" numbered="true" toc="default"> rfc9106.notprepped.xml: <section anchor="argon2id-test-vectors" numbered="true" toc="default"> Alice > >> >> R's, >> John >> >> >> It would be an >>> even stronger demonstration if there were other sourcecode blocks with a different type, but I can envision such a thing easily enough. I would certainly have used them back when we did the sip-certs draft (with its worked examples). >>> >>> Throwing away that semantic hint by putting these in artwork seems ruinous to me. >>> >>> RjS >>> >>> On 4/26/22 5:40 PM, John R Levine wrote: >>>>>> Any recommendation on best markup? Potential paths include: >>>>>> a) leave as they are >>>>>> b) change all to <artwork> >>>>>> c) change all to <sourcecode> without type set >>>>> >>>>> Looks like artwork to me. It's a bunch of examples but nothing that looks machine parsed. >>>> >>>> Having seen Robert's note, I agree you could write a special purpose thing to process these particular examples, but you could do that with a lot of examples. If we say it's "test-vector" that says to me that future things marked test-vector could be parsed the same way which seems unlikely. >>>> >>>> R's, >>>> John >>>> >>>>>> When asked to review the sourcecode type, the author wrote: >>>>>>> As to the sourcecode mark in in each entry, there are separate components: an initial sequence number (ISN), a traffic key, the output of a packet dump, and the MAC (message authentication code). None of these are actually “sourcecode”. I don’t know what portions qualify as a “test-vector”. So I don’t know whether this marking is correct or how best to adjust it if not. >>>>>> >>>>>> >>>>>> Thanks, >>>>>> Alice >>>>>> -- >>>>>> >>>>>> Examples of how type="test-vectors" has been used in the past (full list below): >>>>>> >>>>>> https://www.rfc-editor.org/rfc/rfc9048.html#appendix-D >>>>>> https://www.rfc-editor.org/rfc/rfc9180.html#appendix-A.1.1 (and lots more) >>>>>> https://www.rfc-editor.org/rfc/rfc9189.html#appendix-A.1.1.1 (and a few more) >>>>>> (It becomes <pre class="sourcecode lang-test-vectors"> in the HTML file.) >>>>>> >>>>>> [files in www.rfc-editor.org/in-notes/prerelease/] >>>>>> >>>>>> rfc8696.notprepped.xml: <sourcecode type="test-vectors">< = fdcbc20c, >>>>>> rfc8891.notprepped.xml: <sourcecode type="test-vectors"><![CDATA[K = ffeeddccbbaa99887766554433221100f0f1f2f3f4f5f6f7f8f9fafbfcfdfeff,]]></sourcecode> >>>>>> rfc8891.notprepped.xml: <sourcecode type="test-vectors"><![CDATA[K_1 = ffeeddcc, >>>>>> rfc8891.notprepped.xml: <sourcecode type="test-vectors"><![CDATA[ >>>>>> rfc8891.notprepped.xml: <sourcecode type="test-vectors"><![CDATA[(a_1, a_0) = (fedcba98, 76543210), >>>>>> rfc8891.notprepped.xml: <sourcecode type="test-vectors"><![CDATA[b = G^*[K_32]G[K_31]...G[K_1](a_1, a_0) = 4ee901e5c2d8ca3d.]]></sourcecode> >>>>>> rfc8891.notprepped.xml: <sourcecode type="test-vectors"><![CDATA[b = 4ee901e5c2d8ca3d,]]></sourcecode> >>>>>> rfc8891.notprepped.xml: <sourcecode type="test-vectors"><![CDATA[(b_1, b_0) = (4ee901e5, c2d8ca3d), >>>>>> rfc8891.notprepped.xml: <sourcecode type="test-vectors"><![CDATA[a = G^*[K_1]G[K_2]...G[K_32](b_1, b_0) = fedcba9876543210.]]></sourcecode> >>>>>> rfc9048.notprepped.xml: <sourcecode type="test-vectors"><![CDATA[ >>>>>> rfc9048.notprepped.xml: <sourcecode type="test-vectors"><![CDATA[ >>>>>> rfc9048.notprepped.xml: <sourcecode type="test-vectors"><![CDATA[ >>>>>> rfc9048.notprepped.xml: <sourcecode type="test-vectors"><![CDATA[ >>>>>> rfc9106.notprepped.xml:<sourcecode type="test-vectors"> >>>>>> rfc9106.notprepped.xml:<sourcecode type="test-vectors"> >>>>>> rfc9106.notprepped.xml:<sourcecode type="test-vectors"> >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9180.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9227.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9227.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9227.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9227.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9227.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9227.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9227.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> rfc9227.notprepped.xml: <sourcecode name="" type="test-vectors"><![CDATA[ >>>>>> >>>>> >>>>> Regards, >>>>> John Levine, johnl@taugh.com, Taughannock Networks, Trumansburg NY >>>>> Please consider the environment before reading this e-mail. https://jl.ly >>>>> >>>>> >>>> >>>> Regards, >>>> John Levine, johnl@taugh.com, Taughannock Networks, Trumansburg NY >>>> Please consider the environment before reading this e-mail. https://jl.ly >>>> >>> >>> >> >> Regards, >> John Levine, johnl@taugh.com, Taughannock Networks, Trumansburg NY >> Please consider the environment before reading this e-mail. https://jl.ly >> > > -- > Xml-sg-cmt mailing list > Xml-sg-cmt@ietf.org > https://www.ietf.org/mailman/listinfo/xml-sg-cmt
- [Xml-sg-cmt] question on sourcecode type="test-ve… Alice Russo
- Re: [Xml-sg-cmt] question on sourcecode type="tes… Robert Sparks
- Re: [Xml-sg-cmt] question on sourcecode type="tes… John R Levine
- Re: [Xml-sg-cmt] question on sourcecode type="tes… John R Levine
- Re: [Xml-sg-cmt] question on sourcecode type="tes… Robert Sparks
- Re: [Xml-sg-cmt] question on sourcecode type="tes… Robert Sparks
- Re: [Xml-sg-cmt] question on sourcecode type="tes… John R Levine
- Re: [Xml-sg-cmt] question on sourcecode type="tes… Robert Sparks
- Re: [Xml-sg-cmt] question on sourcecode type="tes… Julian Reschke
- Re: [Xml-sg-cmt] question on sourcecode type="tes… John R Levine
- Re: [Xml-sg-cmt] question on sourcecode type="tes… Julian Reschke
- Re: [Xml-sg-cmt] question on sourcecode type="tes… Alice Russo
- Re: [Xml-sg-cmt] question on sourcecode type="tes… John R Levine
- Re: [Xml-sg-cmt] question on sourcecode type="tes… Robert Sparks
- Re: [Xml-sg-cmt] question on sourcecode type="tes… Carsten Bormann