From nobody Fri Dec 19 19:16:34 2025 Received: from mail-qk1-f202.google.com (mail-qk1-f202.google.com [209.85.222.202]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id B33B5285C91 for ; Fri, 7 Nov 2025 05:29:53 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.222.202 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1762493395; cv=none; b=NXk7oWVvHuOkG7DhkZyuFYpPM1Ncinqogz+gYq8H5jGqO3+EIw4XSSuqlebXc8k/57HydazD4qSRaKsf2a2xlTXIHaTIQ/7ZlvBMufjSIgbjwBMdV8MNm2iSNqwIGqeHsPq5emPYjsLi9jBKoZxtyjjD5KlamfRtUnYLXpjGYO8= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1762493395; c=relaxed/simple; bh=L03uIXQZxdkalVh9ZjTUCdHmAeF5s/msBRS6xoMrnQ4=; h=Date:In-Reply-To:Mime-Version:References:Message-ID:Subject:From: To:Cc:Content-Type; b=REEbyvqvPjoFGDd7Ig/tqVPaplDjleq0s9t/Oh+ctqDt/R0C6FeSRaFvryA1OsjFHYyg2shLFL7DMAAAVKef/PaiTNDOgVRvHgkCaKCvMkQI/pYOe7UOI9j1OXs1sJWqvnDpXR9XcLZkdDXO06E6kiVzSUEHfD8j89uQ0lmRisY= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=google.com; spf=pass smtp.mailfrom=flex--rmoar.bounces.google.com; dkim=pass (2048-bit key) header.d=google.com header.i=@google.com header.b=qnNGK6qS; arc=none smtp.client-ip=209.85.222.202 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=google.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=flex--rmoar.bounces.google.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=google.com header.i=@google.com header.b="qnNGK6qS" Received: by mail-qk1-f202.google.com with SMTP id af79cd13be357-89eb8ee2a79so194759485a.2 for ; Thu, 06 Nov 2025 21:29:53 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20230601; t=1762493393; x=1763098193; darn=vger.kernel.org; h=cc:to:from:subject:message-id:references:mime-version:in-reply-to :date:from:to:cc:subject:date:message-id:reply-to; bh=48j2zZJXWTS3tXcJmxqzEPrxFj/EkmhfLmBq2HSrPzY=; b=qnNGK6qSyezrQlCnKtwoFClcO+0ve8xEyIYiT37Xqn5AtoSKQ4xjxYR+V0QwJMKHJX f/fxqFjucLqBCwon9vb8xkI6hdey2LllJns8QdwTATb2p7ZiWlpEMtEIA65JEUhqqbZE 5BnHCr5WNsYndgHpAQaidxqu711zSMav58/TSwxweL2J35/jo+7Y8FdTUCleZThR1qOU S+dYEqQD611rWvYCgQt2zDKdKkHeA+duvmSL8ZQBtOGfdZRZPHVyltEIDSWRIQvhSQId DuvP7LqdyjsxPS6CmgMHsqoIB+oN8EWwngfox46w3H+tow9a56kpQVL8fBKpg8QPwAXD lpeA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1762493393; x=1763098193; h=cc:to:from:subject:message-id:references:mime-version:in-reply-to :date:x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=48j2zZJXWTS3tXcJmxqzEPrxFj/EkmhfLmBq2HSrPzY=; b=kGguB+A8NxmCx/rjF9Ds0iM3rYulR2FUDgNJ9H+u4Jkwww0RUoKUozxL7rtLpd2ybu fmrxFLFmvLOz8eNaHz22QNW1WBF9ME05TdkbWb9zZRIb/iko8TiMySqWVDZn4a2Nxf2+ AwyTuy4a43oKrMQPYi9ZZSJTdG3tqXGGA4SQBGFzoQUX1LOmEiGcdTB5HGcQvG0adFM9 7/6afx1qwrK4+eDUfJhkPo1QCgw53R+/AVsyFgnz2o/6IswjGr2Lx/Wu7D8Zn7jeZK/p m5y7xpngVmRzAHm2l/UUlctyMv06JS+oSFxvMtelcKz3NXxafW3VUrxMqWlpVGs7aM/0 Hh7g== X-Forwarded-Encrypted: i=1; AJvYcCX+YXxlQBHOWeD1Tlj/QCGjjZjpQ7R7Tl6aquuco2FCzPubEviv0RFGIpuId7IkcIl7bkSaFYdKgUEsV/E=@vger.kernel.org X-Gm-Message-State: AOJu0YwrWjnqiqzyxWhi1vuscxAK9uksHRUZ0G+a5F7ayMvL83npRvEd xYu/t9ekFCu5Y+Dp1zv2K4l2e0KhMuFLrLR3A3qGFgAaR8obhIGafH4S3LLV4+1NQjlZvtlL/oJ i7w== X-Google-Smtp-Source: AGHT+IGX6OEfniAXqNWEIhp2i9gcLVm92VZiRnkK4/N6XrrlWlAs+epPZsQEP+HqeKvwBATh/hbqJHdIFw== X-Received: from qkoz12.prod.google.com ([2002:a05:620a:260c:b0:899:fd6d:28b0]) (user=rmoar job=prod-delivery.src-stubby-dispatcher) by 2002:a05:620a:318c:b0:84d:9f49:6898 with SMTP id af79cd13be357-8b245351d7emr265794885a.61.1762493392688; Thu, 06 Nov 2025 21:29:52 -0800 (PST) Date: Fri, 7 Nov 2025 05:29:22 +0000 In-Reply-To: <20251107052926.3403265-1-rmoar@google.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: Mime-Version: 1.0 References: <20251107052926.3403265-1-rmoar@google.com> X-Mailer: git-send-email 2.51.2.1041.gc1ab5b90ca-goog Message-ID: <20251107052926.3403265-2-rmoar@google.com> Subject: [PATCH RESEND 1/5] ktap_v2: change version to 2-rc in KTAP specification From: Rae Moar To: frowand.list@gmail.com, davidgow@google.com, keescook@chromium.org, raemoar63@gmail.com, Tim.Bird@sony.com, shuah@kernel.org Cc: tytso@google.com, gustavo.padovan@collabora.com, ricardo.canuelo@collabora.com, corbet@lwn.net, kernelci@lists.linux.dev, linux-kselftest@vger.kernel.org, kunit-dev@googlegroups.com, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Frank Rowand , Rae Moar Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" From: Frank Rowand Prepare KTAP Specification for the process of creating version 2. The version will remain "2-rc" until the final commit to complete Version 2. Adding the "-rc" ensures that none of the development versions will be mistaken for the completed version 2. After this commit, Sphinx complains that we now need more '=3D' signs: Documentation/dev-tools/ktap.rst:3: WARNING: Title overline too short. =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D The Kernel Test Anything Protocol (KTAP), version 2-rc =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D This warning will disappear in the final commit for the release of version 2, when the "-rc" is removed. Reviewed-by: Rae Moar Signed-off-by: Frank Rowand Signed-off-by: Rae Moar --- Documentation/dev-tools/ktap.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Documentation/dev-tools/ktap.rst b/Documentation/dev-tools/kta= p.rst index a9810bed5fd4..387062b96c10 100644 --- a/Documentation/dev-tools/ktap.rst +++ b/Documentation/dev-tools/ktap.rst @@ -1,7 +1,7 @@ .. SPDX-License-Identifier: GPL-2.0 =20 =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D -The Kernel Test Anything Protocol (KTAP), version 1 +The Kernel Test Anything Protocol (KTAP), version 2-rc =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D =20 TAP, or the Test Anything Protocol is a format for specifying test results= used --=20 2.51.2.1041.gc1ab5b90ca-goog From nobody Fri Dec 19 19:16:34 2025 Received: from mail-qv1-f74.google.com (mail-qv1-f74.google.com [209.85.219.74]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id B5264296BD6 for ; Fri, 7 Nov 2025 05:29:56 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.219.74 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1762493398; cv=none; b=WWnjaCt6QpgPEMdL8nugM2CVvyYY8Cvwi4oMwkXXsEEiLM6k/Zn1VAWIKIos4T0/own6Wb24nQPz0p21i8EvfPudnzNcjBxnkMfTlDOQ/GRiVn6Qa/LCG3u4NcfrHvI9PUW+WZBK8dQ7ZL/yKUoZ9FLlsF4G5IdaJdFoiyz/Hto= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1762493398; c=relaxed/simple; bh=t/n21pSuJSr8MBIv4gg6nnfTGQhILI1Rm200T1DKUvs=; h=Date:In-Reply-To:Mime-Version:References:Message-ID:Subject:From: To:Cc:Content-Type; b=bmin6n5qVpxKaR2RLv8hch0IXPXAVMIKktF0YTHwYWd2TOP1WaQHolfgIPAU40lITpDD5TrocOujBP/XnMXk3aPchisgojA5XJQSkYmC0WvcllbtCtMt4bL4Uv/6b6sI/7qm11ZOGErH7PZU80VY94ocBDW8AoqlN3a2ZkMrpxw= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=google.com; spf=pass smtp.mailfrom=flex--rmoar.bounces.google.com; dkim=pass (2048-bit key) header.d=google.com header.i=@google.com header.b=IWWAAkDp; arc=none smtp.client-ip=209.85.219.74 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=google.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=flex--rmoar.bounces.google.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=google.com header.i=@google.com header.b="IWWAAkDp" Received: by mail-qv1-f74.google.com with SMTP id 6a1803df08f44-79a3c16b276so9427966d6.0 for ; Thu, 06 Nov 2025 21:29:56 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20230601; t=1762493396; x=1763098196; darn=vger.kernel.org; h=cc:to:from:subject:message-id:references:mime-version:in-reply-to :date:from:to:cc:subject:date:message-id:reply-to; bh=6WhJsbd8hQIgaMMcaCdsT9ge7ButLMZT3b1jbA5sMxQ=; b=IWWAAkDp0m/5FmGSvKI9SO/eJXKdJT0NuMn5MJv7uwCeTJa4FcFavHgumtYnojAVbg CzfMtpbsKZA+q0Z7lwcSnf5PH4cXfZh20SjqhctA0WuWPSaRyl9oDP7cmxbC2PKqdzCu wt0V6+vpQKdn52Q690uzhJucMdHqwlZJuSiFePZaK9c+Y8AH2YeKTeRv9fpfZ8avUUqj Q+lS50CuDlFAvN9f1qQloPskD7xbEgdQqn7V298uyflBjnHgvRAaWbsMJvVoxsN7GIla YtLxJc7ywyLilw/R63q/gB8uruiNTR80ZsdxPS8mPsEgzdbgL2MJcXZERVR50Ka+YFXh 5NFg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1762493396; x=1763098196; h=cc:to:from:subject:message-id:references:mime-version:in-reply-to :date:x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=6WhJsbd8hQIgaMMcaCdsT9ge7ButLMZT3b1jbA5sMxQ=; b=OlasdF2/q1GlZhaN2UBIdWPOgp/LnxHE8rJi0y/VyFKF5fPZz7Rj9rchS+dHuORheQ 68U88Trlp4MfRdvcHfL63LNXnPwJAcC8YhFwOP96oI8f21UdapcUPiM90r43x5647zJ8 /BEPXoMCH4P759FTHEcgga7PC88/7WbH+pwWf7cP245INgiZTKQAneYADDwRl76ZY07S qhUEQ1KortyYVdLTwKy2sYyTC0cl40TQaB4AcgWnE/AzwMRi+rw0dqZfs0f8+SUAHVnu p4DNsLvhCewZbUWBzXk+cGu2CXWbgMonNGUk7DznAkwS8BgzF9I8gsowsS7LlqxxWiVl aKSQ== X-Forwarded-Encrypted: i=1; AJvYcCXp/QZzQQ55yO98wBuH476YUZRNX31k0lqewb50pDOPTkokUbu+qM5MfNIB2XcmD6VlLst8gvEf/FHBF4Y=@vger.kernel.org X-Gm-Message-State: AOJu0Ywnw9UK27essSoLYvPaRnIbNu6hKpdV3RrK3ylefqJaFMFa67re pwccOyqxmEV2mf4GKjziJ86WZ1WRzagQx46ELGhiyG6RG1K0re5Hr7rCNB5gWAKZUUEeBE+fLZf gIg== X-Google-Smtp-Source: AGHT+IHYciVpqOb8pQto4TErUyowvJXcico5AhQjHPvT6LVTf1/3owC+ciDU1QPX5RZ1igpKDXNExBFvtA== X-Received: from qvbrb8.prod.google.com ([2002:a05:6214:4e08:b0:880:6bc3:4888]) (user=rmoar job=prod-delivery.src-stubby-dispatcher) by 2002:a05:6214:d6c:b0:880:4982:3afe with SMTP id 6a1803df08f44-881765c5307mr25893326d6.25.1762493395647; Thu, 06 Nov 2025 21:29:55 -0800 (PST) Date: Fri, 7 Nov 2025 05:29:23 +0000 In-Reply-To: <20251107052926.3403265-1-rmoar@google.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: Mime-Version: 1.0 References: <20251107052926.3403265-1-rmoar@google.com> X-Mailer: git-send-email 2.51.2.1041.gc1ab5b90ca-goog Message-ID: <20251107052926.3403265-3-rmoar@google.com> Subject: [PATCH RESEND 2/5] ktap_v2: change "version 1" to "version 2" in examples From: Rae Moar To: frowand.list@gmail.com, davidgow@google.com, keescook@chromium.org, raemoar63@gmail.com, Tim.Bird@sony.com, shuah@kernel.org Cc: tytso@google.com, gustavo.padovan@collabora.com, ricardo.canuelo@collabora.com, corbet@lwn.net, kernelci@lists.linux.dev, linux-kselftest@vger.kernel.org, kunit-dev@googlegroups.com, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Frank Rowand , Rae Moar Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" From: Frank Rowand Change the "version line" in example output from "KTAP version 1" to "KTAP version 2". Change version that should be used by compliant tests from 1 to 2. Reviewed-by: Rae Moar Signed-off-by: Frank Rowand Signed-off-by: Rae Moar --- Documentation/dev-tools/ktap.rst | 23 ++++++++++++----------- 1 file changed, 12 insertions(+), 11 deletions(-) diff --git a/Documentation/dev-tools/ktap.rst b/Documentation/dev-tools/kta= p.rst index 387062b96c10..21e1b80fddd7 100644 --- a/Documentation/dev-tools/ktap.rst +++ b/Documentation/dev-tools/ktap.rst @@ -41,6 +41,7 @@ version of the (K)TAP standard the result is compliant wi= th. For example: =20 - "KTAP version 1" +- "KTAP version 2" - "TAP version 13" - "TAP version 14" =20 @@ -48,7 +49,7 @@ Note that, in KTAP, subtests also begin with a version li= ne, which denotes the start of the nested test results. This differs from TAP14, which uses a separate "Subtest" line. =20 -While, going forward, "KTAP version 1" should be used by compliant tests, = it +While, going forward, "KTAP version 2" should be used by compliant tests, = it is expected that most parsers and other tooling will accept the other vers= ions listed here for compatibility with existing tests and frameworks. =20 @@ -204,9 +205,9 @@ An example of a test with two nested subtests: =20 :: =20 - KTAP version 1 + KTAP version 2 1..1 - KTAP version 1 + KTAP version 2 1..2 ok 1 test_1 not ok 2 test_2 @@ -217,11 +218,11 @@ An example format with multiple levels of nested test= ing: =20 :: =20 - KTAP version 1 + KTAP version 2 1..2 - KTAP version 1 + KTAP version 2 1..2 - KTAP version 1 + KTAP version 2 1..2 not ok 1 test_1 ok 2 test_2 @@ -252,21 +253,21 @@ Example KTAP output -------------------- :: =20 - KTAP version 1 + KTAP version 2 1..1 - KTAP version 1 + KTAP version 2 1..3 - KTAP version 1 + KTAP version 2 1..1 # test_1: initializing test_1 ok 1 test_1 ok 1 example_test_1 - KTAP version 1 + KTAP version 2 1..2 ok 1 test_1 # SKIP test_1 skipped ok 2 test_2 ok 2 example_test_2 - KTAP version 1 + KTAP version 2 1..3 ok 1 test_1 # test_2: FAIL --=20 2.51.2.1041.gc1ab5b90ca-goog From nobody Fri Dec 19 19:16:34 2025 Received: from mail-qv1-f73.google.com (mail-qv1-f73.google.com [209.85.219.73]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 2674A2BDC27 for ; Fri, 7 Nov 2025 05:29:59 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.219.73 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1762493401; cv=none; b=E2J3S8DHgKcdeS76lChU5deoBzlifAWOtGebYaiV0HnDaGy3crWbl/92wvC1pBlemfAXR54VA4S2HkUgwNqA53LobdYYARcNaQuTWxjkuRcOCTvu9P9JPUZWjlPv9/AROVI2EYCv2z1cX3e9A7ImPzo5Ks/7HNY2npD4XilIcyA= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1762493401; c=relaxed/simple; bh=tMUP/7PQ0R0uG3j3317zYrgNiTq3tLLP5J++lGodLN8=; h=Date:In-Reply-To:Mime-Version:References:Message-ID:Subject:From: To:Cc:Content-Type; b=juQDL6raYZ9CAgcbvDIaa2nJ3iMZ73qjhcqHSEOKJZJqiOS2HeFSjtWVh4X4x+qI3TeHwsm+8vB0ofrGjZof4oikFfOsvDxEAqSxZdTYbc6RRxHyMMXkZDJGGVyx2AqBJ8ugSPVuPWMdDXB+Hgwzwu9j0RCc5C4HXCOVCCEJz94= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=google.com; spf=pass smtp.mailfrom=flex--rmoar.bounces.google.com; dkim=pass (2048-bit key) header.d=google.com header.i=@google.com header.b=huaRM6Uu; arc=none smtp.client-ip=209.85.219.73 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=google.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=flex--rmoar.bounces.google.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=google.com header.i=@google.com header.b="huaRM6Uu" Received: by mail-qv1-f73.google.com with SMTP id 6a1803df08f44-8801c2b9ea7so11686286d6.0 for ; Thu, 06 Nov 2025 21:29:59 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20230601; t=1762493398; x=1763098198; darn=vger.kernel.org; h=cc:to:from:subject:message-id:references:mime-version:in-reply-to :date:from:to:cc:subject:date:message-id:reply-to; bh=zHuVMFMOmBcBnySC+NLlmq0lf2rmosYLrIuF3P/08MI=; b=huaRM6UuaW/z1yDZ73vkSNWSvwmdrg4ZKP914dCAKSyZnJPU+1W+Hey9xIXqjrCpEa rCO6wFCnGOt3y3lbnSHfm/8AcZ+fMMF77bTfBDQouOMd57uQMamQVOUjF8wK/aeKTJcg 9CojwJ977UxIh8msfNmQEvDSbwAWxNHXcoDsLjuATeRzhQyA6GUVBdTfNtnJQn1NVibP vRZPpwRzm0JnmgMkZ3Z7eeKXhgUxozA0zpE1ovpj1+wM9nwRftZt5A/b39V1mhyN8Pl5 Tx0X7bWVk8DddiyGEXcunv51kIs33hTNRfkaKQC8x5Q6BuOlGUJiAgnAUjbWbF4vHlP3 C8fg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1762493398; x=1763098198; h=cc:to:from:subject:message-id:references:mime-version:in-reply-to :date:x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=zHuVMFMOmBcBnySC+NLlmq0lf2rmosYLrIuF3P/08MI=; b=f7mtqOFUQD7ff2VGEaWEzOoFSoIh+9NtyeuU4kGOxvsM35Npl9L98OoE1HZow1rg7L L8m18+Wh57qtETpM3ZUbFSsc6oJEKXBHjAEBUFSRNzKIVSimdhRHuBtrog6w7sVgrwSi 6grqNakaipk4W8FitIwlFu8FTaizOCKpELh2Ps6Y4qtZwQrqi1bHOz3wHZvNRhUWDyHY YEmX+68cuTZ5ohDNd0c6ct9kANG4oWoctUiZv7ECfEvBfKk8tzp0IC7k9LyduSK2Mt6u I7edtrjWa8CXJpjQtI+K7aGHEXgM/oMpk5d0GjGP/9DQvlHkWx6ABVzOWmwn0CLD0reI BKZQ== X-Forwarded-Encrypted: i=1; AJvYcCX6KKDa/xfJ8OEaQFZbQz98myx+4tl79POJRsF6rZVArTpHt4rlhvXwDGIPuJG1nShN9yQ2/blxenNBgjo=@vger.kernel.org X-Gm-Message-State: AOJu0YxW+K/thmIiK6yTpmTp6I1r43F/3PT0EZZpJlFRGYnCIiui8XUd sJdGUhsDAF1Xy4N4mIkS1m68YEQ+51el3/7PoP83d42PqpOQRsv1Iw3AlFNwm06XqGh72+PdMXy VvQ== X-Google-Smtp-Source: AGHT+IGp7s78iu2xje/V+eMJgfG1eE3TFtYt6exwrw0FOTs4FULoLCiswwTPKFjpZHXMSFCnjmVX6xqQBg== X-Received: from qvbks29.prod.google.com ([2002:a05:6214:311d:b0:882:2f2f:9ed]) (user=rmoar job=prod-delivery.src-stubby-dispatcher) by 2002:a05:6214:5085:b0:87c:67a:ca69 with SMTP id 6a1803df08f44-881767a7142mr26911986d6.61.1762493398062; Thu, 06 Nov 2025 21:29:58 -0800 (PST) Date: Fri, 7 Nov 2025 05:29:24 +0000 In-Reply-To: <20251107052926.3403265-1-rmoar@google.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: Mime-Version: 1.0 References: <20251107052926.3403265-1-rmoar@google.com> X-Mailer: git-send-email 2.51.2.1041.gc1ab5b90ca-goog Message-ID: <20251107052926.3403265-4-rmoar@google.com> Subject: [PATCH RESEND 3/5] ktap_v2: add test metadata From: Rae Moar To: frowand.list@gmail.com, davidgow@google.com, keescook@chromium.org, raemoar63@gmail.com, Tim.Bird@sony.com, shuah@kernel.org Cc: tytso@google.com, gustavo.padovan@collabora.com, ricardo.canuelo@collabora.com, corbet@lwn.net, kernelci@lists.linux.dev, linux-kselftest@vger.kernel.org, kunit-dev@googlegroups.com, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Rae Moar Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Add specification for test metadata to the KTAP v2 spec. KTAP v1 only specifies the output format of very basic test information: test result and test name. Any additional test information either gets added to general diagnostic data or is not included in the output at all. The purpose of KTAP metadata is to create a framework to include and easily identify additional important test information in KTAP. KTAP metadata could include any test information that is pertinent for user interaction before or after the running of the test. For example, the test file path or the test speed. Since this includes a large variety of information, this specification will recognize notable types of KTAP metadata to ensure consistent format across test frameworks. See the full list of types in the specification. Example of KTAP Metadata: KTAP version 2 #:ktap_test: main #:ktap_arch: uml 1..1 KTAP version 2 #:ktap_test: suite_1 #:ktap_subsystem: example #:ktap_test_file: lib/test.c 1..2 ok 1 test_1 #:ktap_test: test_2 #:ktap_speed: very_slow # test_2 has begun #:custom_is_flaky: true ok 2 test_2 # suite_1 has passed ok 1 suite_1 The changes to the KTAP specification outline the format, location, and different types of metadata. Reviewed-by: Kees Cook Reviewed-by: David Gow Signed-off-by: Rae Moar --- Documentation/dev-tools/ktap.rst | 249 ++++++++++++++++++++++++++++++- 1 file changed, 244 insertions(+), 5 deletions(-) diff --git a/Documentation/dev-tools/ktap.rst b/Documentation/dev-tools/kta= p.rst index 21e1b80fddd7..70f1557e47ac 100644 --- a/Documentation/dev-tools/ktap.rst +++ b/Documentation/dev-tools/ktap.rst @@ -17,20 +17,21 @@ KTAP test results describe a series of tests (which may= be nested: i.e., test can have subtests), each of which can contain both diagnostic data -- e.g.= , log lines -- and a final result. The test structure and results are machine-readable, whereas the diagnostic data is unstructured and is there= to -aid human debugging. - -KTAP output is built from four different types of lines: +aid human debugging. Since version 2, tests can also contain metadata which +consists of important supplemental test information and can be +machine-readable. =20 +KTAP output is built from five different types of lines: - Version lines - Plan lines - Test case result lines - Diagnostic lines +- Metadata lines =20 In general, valid KTAP output should also form valid TAP output, but some information, in particular nested test results, may be lost. Also note that there is a stagnant draft specification for TAP14, KTAP diverges from this= in -a couple of places (notably the "Subtest" header), which are described whe= re -relevant later in this document. +a couple of places, which are described where relevant later in this docum= ent. =20 Version lines ------------- @@ -168,6 +169,238 @@ even if they do not start with a "#": this is to capt= ure any other useful kernel output which may help debug the test. It is nevertheless recommended that tests always prefix any diagnostic output they have with a "#" charac= ter. =20 +KTAP metadata lines +------------------- + +KTAP metadata lines are used to include and easily identify important +supplemental test information in KTAP. These lines may appear similar to +diagnostic lines. They were introduced in KTAP version 2. The format of +metadata lines is below: + +.. code-block:: none + + #:_: + +The indicates where to find the specification for the type of +metadata, such as the name of a test framework or "ktap" to indicate this +specification. The list of currently approved prefixes and where to find t= he +documentation of the metadata types is below. Note any metadata type that = does +not use a prefix from the list below must use the prefix "custom". + +Current List of Approved Prefixes: + +- ``ktap``: See Types of KTAP Metadata below for the list of metadata type= s. + +The format of and varies based on the type. See the +individual specification. For "custom" types the can be any +string excluding ":", spaces, or newline characters and the can be= any +string. + +**Location:** + +The first KTAP metadata line for a test must be "#:ktap_test: ", +which acts as a header to associate metadata with the correct test. Metada= ta +for the main KTAP level uses the test name "main". A test's metadata ends +with a "ktap_test" line for a different test. + +For test cases, the location of the metadata is between the prior test res= ult +line and the current test result line. For test suites, the location of the +metadata is between the suite's version line and test plan line. For the m= ain +level, the location of the metadata is between the main version line and m= ain +test plan line. See the example below. + +Note that a test case's metadata is inline with the test's result line. Wh= ereas +a suite's metadata is inline with the suite's version line and thus will be +more indented than the suite's result line. Additionally, metadata for the= main +level is inline with the main version line. + +KTAP metadata for a test does not need to be contiguous. For example, a ke= rnel +warning or other diagnostic output could interrupt metadata lines. However= , it +is recommended to keep a test's metadata lines in the correct location and +together when possible, as this improves readability. + +**Example of KTAP metadata:** + +:: + + KTAP version 2 + #:ktap_test: main + #:ktap_arch: uml + 1..1 + KTAP version 2 + #:ktap_test: suite_1 + #:ktap_subsystem: example + #:ktap_test_file: lib/test.c + 1..2 + # WARNING: test_1 skipped + ok 1 test_1 # SKIP + #:ktap_test: test_2 + #:ktap_speed: very_slow + # test_2 has begun + #:custom_is_flaky: true + ok 2 test_2 + # suite_1 passed + ok 1 suite_1 + +In this example, the tests are running on UML. The test suite "suite_1" is= part +of the subsystem "example" and belongs to the file "lib/test.c". It has +two subtests, "test_1" and "test_2". The subtest "test_2" has a speed of +"very_slow" and has been marked with a custom KTAP metadata type called +"custom_is_flaky" with the value of "true". + +**Inheritance of KTAP metadata** + +Tests can inherit KTAP metadata. A child test inherits all the parent test= 's +KTAP metadata except for directly opposing metadata. For example, if a su= ite +has a property of "#:ktap_speed: slow", all child test cases are also mark= ed as +slow. However, if one of the test cases has metadata of "#:ktap_speed: +very_slow" then that test case would be marked as very_slow instead and not +slow. + +Note if a test case inherits metadata it does not need to appear as a line= in +the KTAP. Using the example above, not every test case would have the line +"#:ktap_speed: slow" in their metadata. + +**Edge Case Examples of KTAP metadata** + +Here are a few edge case examples of KTAP metadata. The first example shows +metadata in the wrong location. + +:: + + KTAP version 2 + 1..1 + KTAP version 2 + #:ktap_test: suite_1 + 1..3 + ok 1 test_1 + #:ktap_test: test_2 + #:ktap_speed: very_slow + ok 2 test_2 + #:ktap_duration: 1.342s + #:ktap_test: test_3 + #:ktap_speed: slow + ok 3 test_3 + ok 1 suite_1 + +In this example, the metadata "#:ktap_duration: 1.342s" is in the wrong +location. It was meant to belong to test_2 but was printed late. The locat= ion +of this metadata is not recommended. However, it is allowed because the li= ne is +still below "#:ktap_test: test_2" and above any other ktap_test lines. + +This second example shows metadata in the correct location but without the +proper header. + +:: + + KTAP version 2 + 1..1 + KTAP version 2 + #:ktap_test: suite_1 + 1..2 + not ok 1 test_1 + #:ktap_speed: very_slow + ok 2 test_2 + ok 1 suite_1 + +In this example, the metadata "#:ktap_speed: very_slow" is meant to belong= to +test_2. It is in the correct location but does not fall below a ktap_test = line +for test_2. Instead this metadata might be mistaken for belonging to suite= _1 +because it does fall under the ktap_test line for suite_1. This lack of he= ader +is not allowed. + +**Types of KTAP Metadata:** + +This is the current list of KTAP metadata types recognized in this +specification. Note that all of these metadata types are optional (except = for +ktap_test as the KTAP metadata header). + +- ``ktap_test``: Name of test (used as header of KTAP metadata). This shou= ld + match the test name printed in the test result line: "ok 1 [test_name]". + +- ``ktap_module``: Name of the module containing the test + +- ``ktap_subsystem``: Name of the subsystem being tested + +- ``ktap_start_time``: Time tests started in ISO8601 format + + - Example: "#:ktap_start_time: 2024-01-09T13:09:01.990000+00:00" + +- ``ktap_duration``: Time taken (in seconds) to execute the test + + - Example: "#:ktap_duration: 10.154s" + +- ``ktap_speed``: Category of how fast test runs: "normal", "slow", or + "very_slow" + +- ``ktap_test_file``: Path to source file containing the test. This metada= ta + line can be repeated if the test is spread across multiple files. + + - Example: "#:ktap_test_file: lib/test.c" + +- ``ktap_generated_file``: Description of and path to file generated during + test execution. This could be a core dump, generated filesystem image, s= ome + form of visual output (for graphics drivers), etc. This metadata line ca= n be + repeated to attach multiple files to the test. Note use ktap_log_file or + ktap_error_file instead of this type if more applicable. + + - Example: "#:ktap_generated_file: Core dump: /var/lib/systemd/coredump/= hello.core" + +- ``ktap_log_file``: Path to file containing kernel log test output + + - Example: "#:ktap_log_file: /sys/kernel/debugfs/kunit/example/results" + +- ``ktap_error_file``: Path to file containing context for test failure or + error. This could include the difference between optimal test output and + actual test output. + + - Example: "#:ktap_error_file: fs/results/example.out.bad" + +- ``ktap_results_url``: Link to webpage describing this test run and its + results + + - Example: "#:ktap_results_url: https://kcidb.kernelci.org/hello" + +- ``ktap_arch``: Architecture used during test run + + - Example: "#:ktap_arch: x86_64" + +- ``ktap_compiler``: Compiler used during test run + + - Example: "#:ktap_compiler: gcc (GCC) 10.1.1 20200507 (Red Hat 10.1.1-1= )" + +- ``ktap_respository_url``: Link to git repository of the checked out code. + + - Example: "#:ktap_respository_url: https://github.com/torvalds/linux.gi= t" + +- ``ktap_git_branch``: Name of git branch of checked out code + + - Example: "#:ktap_git_branch: kselftest/kunit" + +- ``ktap_kernel_version``: Version of Linux Kernel being used during test = run + + - Example: "#:ktap_kernel_version: 6.7-rc1" + +- ``ktap_config``: Config name and value. This does not necessarly need to= be + restricted to Kconfig. + + - Example: "#:ktap_config: CONFIG_SYSFS=3Dy" + +- ``ktap_id``: Description of ID and ID value. This is an open-ended metad= ata + used for IDs, such as checkout id or test run id. + + - Example: "#:ktap_id: Test run id: 14e782" + +- ``ktap_commit_hash``: The full git commit hash of the checked out base c= ode. + + - Example: "#:ktap_commit_hash: 064725faf8ec2e6e36d51e22d3b86d2707f0f47f" + +**Other Metadata Types:** + +There can also be KTAP metadata that is not included in the recognized list +above. This metadata must be prefixed with the test framework, ie. "kselft= est", +or with the prefix "custom". For example, "# custom_batch: 20". + Unknown lines ------------- =20 @@ -208,6 +441,7 @@ An example of a test with two nested subtests: KTAP version 2 1..1 KTAP version 2 + #:ktap_test: example 1..2 ok 1 test_1 not ok 2 test_2 @@ -221,6 +455,7 @@ An example format with multiple levels of nested testin= g: KTAP version 2 1..2 KTAP version 2 + #:ktap_test: example_test_1 1..2 KTAP version 2 1..2 @@ -256,6 +491,7 @@ Example KTAP output KTAP version 2 1..1 KTAP version 2 + #:ktap_test: main_test 1..3 KTAP version 2 1..1 @@ -263,11 +499,14 @@ Example KTAP output ok 1 test_1 ok 1 example_test_1 KTAP version 2 + #:ktap_test: example_test_2 + #:ktap_speed: slow 1..2 ok 1 test_1 # SKIP test_1 skipped ok 2 test_2 ok 2 example_test_2 KTAP version 2 + #:ktap_test: example_test_3 1..3 ok 1 test_1 # test_2: FAIL --=20 2.51.2.1041.gc1ab5b90ca-goog From nobody Fri Dec 19 19:16:34 2025 Received: from mail-qk1-f202.google.com (mail-qk1-f202.google.com [209.85.222.202]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id A1B802D47F4 for ; Fri, 7 Nov 2025 05:30:04 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.222.202 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1762493406; cv=none; b=F3pIpOGmFta7zBBSJMbL4n5BkmOnNfiNLLqMGoWMZL5G6zrReV+QUlTH42DBH6au2nY/KIeMLEaZqR/ogSK68wjTymVf8ZbprIHbbv5m1L3tjWjUWeLPWv8e5IIUZLWUSJ95Pg4ZZ1CfFEc1FeYKgS8jFnGjIQVNw5vqv0XBM4A= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1762493406; c=relaxed/simple; bh=GNIC6rgmBgBaS/nEumt2IhuduUmMu1+lZQVuuQDtb1E=; h=Date:In-Reply-To:Mime-Version:References:Message-ID:Subject:From: To:Cc:Content-Type; b=C1ph2SLA34hZq+5XMs/031eXmTVlUcQ1qCIR9xKq80psREH5O881xLZt5rpiGmefH7iItouJ1ZVYyT4qpw192uHYcK6U7olrxodiZgW8N8HWihFwN8904f857JNHslqoyb4ieP+ojp3BVEx5eC84Otw3n8lEsYAG5r4SAAMRJ/A= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=google.com; spf=pass smtp.mailfrom=flex--rmoar.bounces.google.com; dkim=pass (2048-bit key) header.d=google.com header.i=@google.com header.b=GjwGwyIt; arc=none smtp.client-ip=209.85.222.202 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=google.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=flex--rmoar.bounces.google.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=google.com header.i=@google.com header.b="GjwGwyIt" Received: by mail-qk1-f202.google.com with SMTP id af79cd13be357-89eb8ee2a79so194810885a.2 for ; Thu, 06 Nov 2025 21:30:04 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20230601; t=1762493403; x=1763098203; darn=vger.kernel.org; h=cc:to:from:subject:message-id:references:mime-version:in-reply-to :date:from:to:cc:subject:date:message-id:reply-to; bh=EaeKaOMtYstcTutB5sBdiY8lvk6UG68jVdp0csxEu3M=; b=GjwGwyIt0wwW3nEwzXvy2WUgtmxpOAllNNCzUvVRa7HaBauJtbOAO7XucpEwjkodJU FzfnBbKplLhxZGvkDda3XFa+2xuFaeN6w6dHyKPTnNttPobQf1w3SdnSOvXasoBb1cH7 8/GUrmux0PlVYidJ1Tnt4gZ+ID73OqET7oRXSSg8UWwLmKQFzrRoPwL97/C8+dy+2sPQ SDWQEBmPmwwJSzfoaxh9CHh2/yKZ/2VAiY7AJXnmeWRsxqoX6FCZwWqWVamA1+2zCCTe 5xfWvn0hh0+HihQ5Hh4R8lrVSRaBYt2Q8HQUabm9idmwivMOuoZQTCaMUhr7CcuON3RI S0Qw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1762493403; x=1763098203; h=cc:to:from:subject:message-id:references:mime-version:in-reply-to :date:x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=EaeKaOMtYstcTutB5sBdiY8lvk6UG68jVdp0csxEu3M=; b=or+gxVx4AvL8RbeTBoFsvcUugGR0+SKZQbZXXlrx6Suil/LL3UFiJs5r8VdAmh0ZZW Rlvz9jmQk/HQmBcGcFf/WzVzG5izc8q4/xKFGVEtkKP6vRPn1lb2v1I+SqcC/NLjWpc2 vd991eqiSqPAHIh4Kza9Tctvzq8lEcS0lWFKtXfa/JROZU6pjlmjzrs98l4y5M6+8kYL wqO8ItfGMwuX49wahE97yDYhbFuWUROs2eV2M5NR/H03mhW9iBKKZnr/oFUu+PRljwxY oZrxE/RA0ZIUvqwoEdmukwPEtj2Dk3Ii1R+ucOLNEeBWD0ryuY6EwqYfinUyttjhUoT/ XgiA== X-Forwarded-Encrypted: i=1; AJvYcCVK/T96eTjwxHZOcjEXu2YH33e+EVO9+65dezKyN0abwEm3/cTPIBTMAGe0KLoF8mrM4NZYfeAOGNGr0yI=@vger.kernel.org X-Gm-Message-State: AOJu0Yy7kwmZBW1nGQs6khUb99GYj5Q3tqua5kxqeVRMOLZUvqleReL6 OAEYJnaZoerwfD+B3+snwa+vhZ/37rKq2MQQ9k6R1cW9tOG/cfvAVfn9sGwrnRDltF/9o0PTZYV reQ== X-Google-Smtp-Source: AGHT+IFZud3Q7EnRa+zf4l7+j2mroOoVI6WsZLmo32vYCEH/+wMZNbvoVYG/kriiFUE2+7VSKhLHDP451Q== X-Received: from qke12.prod.google.com ([2002:a05:620a:a10c:b0:8b2:4d20:bb90]) (user=rmoar job=prod-delivery.src-stubby-dispatcher) by 2002:a05:620a:2544:b0:8b2:2719:ed33 with SMTP id af79cd13be357-8b24533e80fmr250072385a.46.1762493402860; Thu, 06 Nov 2025 21:30:02 -0800 (PST) Date: Fri, 7 Nov 2025 05:29:25 +0000 In-Reply-To: <20251107052926.3403265-1-rmoar@google.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: Mime-Version: 1.0 References: <20251107052926.3403265-1-rmoar@google.com> X-Mailer: git-send-email 2.51.2.1041.gc1ab5b90ca-goog Message-ID: <20251107052926.3403265-5-rmoar@google.com> Subject: [PATCH RESEND 4/5] ktap_v2: formatting fixes to ktap spec From: Rae Moar To: frowand.list@gmail.com, davidgow@google.com, keescook@chromium.org, raemoar63@gmail.com, Tim.Bird@sony.com, shuah@kernel.org Cc: tytso@google.com, gustavo.padovan@collabora.com, ricardo.canuelo@collabora.com, corbet@lwn.net, kernelci@lists.linux.dev, linux-kselftest@vger.kernel.org, kunit-dev@googlegroups.com, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Rae Moar Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Fix formatting of bulleted lists on KTAP specification for new version. Signed-off-by: Rae Moar --- Documentation/dev-tools/ktap.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/Documentation/dev-tools/ktap.rst b/Documentation/dev-tools/kta= p.rst index 70f1557e47ac..d118119910f8 100644 --- a/Documentation/dev-tools/ktap.rst +++ b/Documentation/dev-tools/ktap.rst @@ -22,6 +22,7 @@ consists of important supplemental test information and c= an be machine-readable. =20 KTAP output is built from five different types of lines: + - Version lines - Plan lines - Test case result lines --=20 2.51.2.1041.gc1ab5b90ca-goog From nobody Fri Dec 19 19:16:34 2025 Received: from mail-yw1-f201.google.com (mail-yw1-f201.google.com [209.85.128.201]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 4DECE2C21E7 for ; Fri, 7 Nov 2025 05:30:07 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.128.201 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1762493409; cv=none; b=nPnTSQP0z3dasZywkJQ4IrnZ+S5vjugkm4hGsvu9fgOa+yywYRwc02d+6nL4VFOJEHACUKMtoNDyUml5vWZyjB589GEaIkayeMUPoF4VVu7eL3fQSs5xN2+MmVjRG5D+3ADYDmmudtubBydukdHrNg8nSv3TGHGT/+iXus/q6P4= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1762493409; c=relaxed/simple; bh=Gfa74bvT8g21TTG6UeYJUX49YlH6I28Q/5rLnsXNtu4=; h=Date:In-Reply-To:Mime-Version:References:Message-ID:Subject:From: To:Cc:Content-Type; b=WyWKeTf1Nu6EhpL+2uFuw4fZGvRXOSYoplvtYMgKF00rOlxfIY+zDQA602fxx3RvRqomi5264FoxUSLjwKMkAKCX43Uj5nWUegHtLrgvE2WBUcaO3IIPzu6/J08RNhYyp1AhPzzii6VO4ywVlHgpCKwIjqD8j7hN/vVdElTfwcA= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=google.com; spf=pass smtp.mailfrom=flex--rmoar.bounces.google.com; dkim=pass (2048-bit key) header.d=google.com header.i=@google.com header.b=pX9UZxxf; arc=none smtp.client-ip=209.85.128.201 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=google.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=flex--rmoar.bounces.google.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=google.com header.i=@google.com header.b="pX9UZxxf" Received: by mail-yw1-f201.google.com with SMTP id 00721157ae682-786a589c941so6736947b3.0 for ; Thu, 06 Nov 2025 21:30:07 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20230601; t=1762493406; x=1763098206; darn=vger.kernel.org; h=cc:to:from:subject:message-id:references:mime-version:in-reply-to :date:from:to:cc:subject:date:message-id:reply-to; bh=0gxyC8GUOhbymd0hZW1Wc7AlwN6X8GVnWJwQLTO+kr4=; b=pX9UZxxfciYzQ1uFrIh/3etkrl0QEdGhu3g5Ea3xruo1GWh/xrdLebeOn5l12kmhpm OBuuIUQkzgo4/DkewT8+ykCE0tNkxCjSHfyhT9Br0aVGcfdyyrc2JPSjcfGEBBLdzqme 9SGz1/fFLrN/GqENL4xakl1BNwwFsvJkF1+TNYsxmSD7juRN+p9dTFHz++QW0EtmRLsd 0S8IY8z2b6PArlfsWHkhWy5gn2YsUt9n8cPk/3DLaBpa77G3glj7VJIMh/Nst4CIwXDw O7xnkm31OroAtg7HKG2tVdpp5x3PbDveHlCl+1CA6Cq2qn3FrNyeISHhb1anp5VX1Hpv /BxQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1762493406; x=1763098206; h=cc:to:from:subject:message-id:references:mime-version:in-reply-to :date:x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=0gxyC8GUOhbymd0hZW1Wc7AlwN6X8GVnWJwQLTO+kr4=; b=U3O0V3DoswL1N3qFzLqqMScG9xNb/zu6gyOSYeDsKDtkasWgN61vyM2npAF9wGO15S D3Ns2HDIFBVxEjUb8JQdKvy2ZnH7V0wYFgDJ6XfZAMGHi5whwvgHAopFi8Zd2cmOP/UV A1tGt2OSiX7cSaACiMVBX4L8WeDV+K6CWDbM4LoX8sNGkuLc2skovTOZh3nYq07N6yXY 5YglsaSoB3zdOOO+O+X55NYBzvI7q68XYwEwx5xptc7QhO9J10ciq237E3mQlNs05nr3 cABkgQH2ATQoSl6iit/aMz/HQonGxx6KBV3/yT+ZEqKj3hs1syylK8Nq89h5X2PR4Uk7 Smew== X-Forwarded-Encrypted: i=1; AJvYcCUYUU2aPJZXuyQMizVKkVS7fehtJx0j9+ApBXXrLro+QVwi2iobet6PADWW+QftcPMYpUagz4gbg9P1p4Q=@vger.kernel.org X-Gm-Message-State: AOJu0YxC30Hy2LwHzTuwUAAsCBZGOyGvWWqIaG48rNLrFG9dSm7g4bCe v8qug3YkSdTkYjG98WUDgVTaEqpqcuocADDwkRRkGMvxbafkR/kSHvNU9UVD7V0JDqykgTIly/m EsA== X-Google-Smtp-Source: AGHT+IFyTML4kwjlT8XJq9ynWGzbE9ai1eUBXHm+9uVGmQAwTAKz9Wy9ddid4pLEgQKt5V9M2r2fUt9K2g== X-Received: from ywbkl8.prod.google.com ([2002:a05:690c:5048:b0:784:9edd:65d8]) (user=rmoar job=prod-delivery.src-stubby-dispatcher) by 2002:a05:690c:f89:b0:787:c612:f0f6 with SMTP id 00721157ae682-787c61305eamr15892597b3.1.1762493406390; Thu, 06 Nov 2025 21:30:06 -0800 (PST) Date: Fri, 7 Nov 2025 05:29:26 +0000 In-Reply-To: <20251107052926.3403265-1-rmoar@google.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: Mime-Version: 1.0 References: <20251107052926.3403265-1-rmoar@google.com> X-Mailer: git-send-email 2.51.2.1041.gc1ab5b90ca-goog Message-ID: <20251107052926.3403265-6-rmoar@google.com> Subject: [PATCH RESEND 5/5] ktap_v2: change version to 2 in KTAP specification From: Rae Moar To: frowand.list@gmail.com, davidgow@google.com, keescook@chromium.org, raemoar63@gmail.com, Tim.Bird@sony.com, shuah@kernel.org Cc: tytso@google.com, gustavo.padovan@collabora.com, ricardo.canuelo@collabora.com, corbet@lwn.net, kernelci@lists.linux.dev, linux-kselftest@vger.kernel.org, kunit-dev@googlegroups.com, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Rae Moar Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Prepare KTAP specification for the final release of version 2 by removing "-rc" in the title. This would previously cause a Sphinx warning. This series represents the final version of KTAP version 2 that includes the major addition of test metadata. Signed-off-by: Rae Moar --- Documentation/dev-tools/ktap.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Documentation/dev-tools/ktap.rst b/Documentation/dev-tools/kta= p.rst index d118119910f8..1abb30887008 100644 --- a/Documentation/dev-tools/ktap.rst +++ b/Documentation/dev-tools/ktap.rst @@ -1,7 +1,7 @@ .. SPDX-License-Identifier: GPL-2.0 =20 =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D -The Kernel Test Anything Protocol (KTAP), version 2-rc +The Kernel Test Anything Protocol (KTAP), version 2 =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D =20 TAP, or the Test Anything Protocol is a format for specifying test results= used --=20 2.51.2.1041.gc1ab5b90ca-goog