IETF Logo Mail Archive

Re: [Xml-sg-cmt] question on sourcecode type="test-vectors"

John R Levine <johnl@taugh.com> Thu, 28 April 2022 16:59 UTC

Return-Path: <johnl@taugh.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 8F6FCC15E6E6 for <xml-sg-cmt@ietfa.amsl.com>; Thu, 28 Apr 2022 09:59:14 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.1
X-Spam-Level:
X-Spam-Status: No, score=-2.1 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.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=iecc.com header.b=qBaROC2w; dkim=pass (2048-bit key) header.d=taugh.com header.b=oR+LCXkx
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 ho8IQmRa8xXy for <xml-sg-cmt@ietfa.amsl.com>; Thu, 28 Apr 2022 09:59:09 -0700 (PDT)
Received: from gal.iecc.com (gal.iecc.com [IPv6:2001:470:1f07:1126:0:43:6f73:7461]) (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 F02DEC159A32 for <xml-sg-cmt@ietf.org>; Thu, 28 Apr 2022 09:59:08 -0700 (PDT)
Received: (qmail 94866 invoked from network); 28 Apr 2022 16:59:06 -0000
DKIM-Signature: v=1; a=rsa-sha256; c=simple; d=iecc.com; h=date:message-id:from:to:cc:subject:in-reply-to:references:mime-version:content-type; s=1728e.626ac7da.k2204; bh=j0ibEwOhXuLYKry0ekkIaAPOrp2oZIKcfIBwUCTSIOs=; b=qBaROC2wTp6ds5jWfIwZzZHeUZeklGf4UYc7WBe+LIlD29p4zqqeZ8lZampvCGxFoWQBdJlPlNNt7fw7Yj+G9wljMz6JCcpx4GYbN+Oq3Bm/1/7O6HoQcezXCfIZyj9s4ySy6frn/LaeOiD4vaLWUMn0CEipTr9TACcmPZvOkodoBztIajlXgBCVYLISIxpfpyikprOkrQzqbSoyIVkVBr/ys4jfqrU+rSUwTf9QAUxFr3qu7dEm+gxccHiloEDgvhJKPDcnompa3qQHLDYaGHQmMPp7gQQ26SsqYZwZzfSqREd9td1Q48iqXOB67SsZT5fNREYmHlwSq+9jgaYSzw==
DKIM-Signature: v=1; a=rsa-sha256; c=simple; d=taugh.com; h=date:message-id:from:to:cc:subject:in-reply-to:references:mime-version:content-type; s=1728e.626ac7da.k2204; bh=j0ibEwOhXuLYKry0ekkIaAPOrp2oZIKcfIBwUCTSIOs=; b=oR+LCXkxrHs1kUmNs9RbpTDNfcGQlmxJ72W5nGHIBVv/upeKyADIjGVxfM2hpDZ3RgHyjmEpzG1fTuuN3s9XkBnyVWkq846IHE7HzYfKlAXWpi54MwR5HOEtGfI7WRc1ixPK0H4yDD3ipigu0e9LI1ydxRheYULUrd/atSlwTt8VWi3DUoAaSb2ADEJPeKejo7/690/pxwwAyKvparNNkgqYwogvZgefO6tLebwehmqi9j1g7FiRgDzj0mrp4/obfSndmbZpzG2UT5L+9LDspCt140nx9GTc5DOhSQr3maYUA0obl8gO7VxHhP1gTlrfD3XDafpIL86eTosf7a/DCw==
Received: from ary.qy ([IPv6:2001:470:1f07:1126::78:696d:6170]) by imap.iecc.com ([IPv6:2001:470:1f07:1126::78:696d:6170]) with ESMTPS (TLS1.3 ECDHE-RSA AES-256-GCM AEAD) via TCP6; 28 Apr 2022 16:59:06 -0000
Received: by ary.qy (Postfix, from userid 501) id 163A83F0D769; Thu, 28 Apr 2022 12:59:05 -0400 (EDT)
Received: from localhost (localhost [127.0.0.1]) by ary.qy (Postfix) with ESMTP id 8925B3F0D74B; Thu, 28 Apr 2022 12:59:05 -0400 (EDT)
Date: Thu, 28 Apr 2022 12:59:05 -0400
Message-ID: <1ff4ad28-48f4-9686-b648-78b31d7f4be9@taugh.com>
From: John R Levine <johnl@taugh.com>
To: Alice Russo <arusso@amsl.com>, Robert Sparks <rjsparks@nostrum.com>
Cc: "xml-sg-cmt@ietf.org" <xml-sg-cmt@ietf.org>
X-X-Sender: johnl@ary.qy
In-Reply-To: <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> <BE9373BB-7A42-40F6-99E4-3F7BEC3C1B23@amsl.com>
MIME-Version: 1.0
Content-Type: text/plain; charset="US-ASCII"; format="flowed"
Archived-At: <https://mailarchive.ietf.org/arch/msg/xml-sg-cmt/2UolgyFKdysmseWamtQF1l6RnOU>
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: Thu, 28 Apr 2022 16:59:14 -0000

>> 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">

I realize we're into bikeshed territory, but I'd rather have the test 
vector name describe what's being tested than the RFC in which they were 
defned.  If RFC1234 defines something, and then RFC3456 adds some new 
options, are the test vectors rfc1234-test-vector or rfc3456-test-vector 
or something else?

Regards,
John Levine, johnl@taugh.com, Taughannock Networks, Trumansburg NY
Please consider the environment before reading this e-mail. https://jl.ly

v2.23.0 | Report a Bug | By Email