From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from picard.linux.it (picard.linux.it [213.254.12.146]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id CC407CD3442 for ; Thu, 7 May 2026 10:43:23 +0000 (UTC) Received: from picard.linux.it (localhost [IPv6:::1]) by picard.linux.it (Postfix) with ESMTP id 90BC03E24A5 for ; Thu, 7 May 2026 12:43:22 +0200 (CEST) Received: from in-3.smtp.seeweb.it (in-3.smtp.seeweb.it [IPv6:2001:4b78:1:20::3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature ECDSA (secp384r1) server-digest SHA384) (No client certificate requested) by picard.linux.it (Postfix) with ESMTPS id 1BFD73C1B73 for ; Thu, 7 May 2026 12:43:01 +0200 (CEST) Received: from mx0b-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) (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 in-3.smtp.seeweb.it (Postfix) with ESMTPS id 0939C1A000A0 for ; Thu, 7 May 2026 12:43:00 +0200 (CEST) Received: from pps.filterd (m0360072.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.18.1.11/8.18.1.11) with ESMTP id 646LZmew2578306 for ; Thu, 7 May 2026 10:42:59 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=ibm.com; h= content-transfer-encoding:content-type:date:from:in-reply-to :message-id:mime-version:references:subject:to; s=pp1; bh=ySOXBa RSX08DicF/QQ8NvcuLPbBk5BB2+b7o8rOGdLs=; b=MFDWe+FjjCOH+Nt4yenr4n 0WXcYIv0Wf46FXNHNW2pqXd+hDkfWMQzfaYXCf7KLoaqZN0ltqwSxdV/dXZfWBkj ZBmARKqTZPuRl5scwq3qJybWJh4lyIixmsNshqCQbty7rO5dQqs5SN54zNfgWnHo wlxqHV56Ln+rIM21RkqGl1O6fuRNQwYroV0QLwzVm8hxJEcAhQcrfIGCQEDrfloZ PE3rBiQDoagu8YnH8ngsKfIiRFt6re6BatzyAGkm3FvcfdVi44DzSbGkYGoMgwdB QVeJDWmVbR3r5hZbVsmVDKZHifH63fjX89IR8UQMN7CI9UJCEXiBSx+3tUaIkdyw == Received: from ppma21.wdc07v.mail.ibm.com (5b.69.3da9.ip4.static.sl-reverse.com [169.61.105.91]) by mx0a-001b2d01.pphosted.com (PPS) with ESMTPS id 4dw9y4vraq-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Thu, 07 May 2026 10:42:59 +0000 (GMT) Received: from pps.filterd (ppma21.wdc07v.mail.ibm.com [127.0.0.1]) by ppma21.wdc07v.mail.ibm.com (8.18.1.7/8.18.1.7) with ESMTP id 647AdeSf017318 for ; Thu, 7 May 2026 10:42:58 GMT Received: from smtprelay04.wdc07v.mail.ibm.com ([172.16.1.71]) by ppma21.wdc07v.mail.ibm.com (PPS) with ESMTPS id 4dwvkk2s8e-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Thu, 07 May 2026 10:42:58 +0000 (GMT) Received: from smtpav05.wdc07v.mail.ibm.com (smtpav05.wdc07v.mail.ibm.com [10.39.53.232]) by smtprelay04.wdc07v.mail.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id 647AgwrN40698582 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Thu, 7 May 2026 10:42:58 GMT Received: from smtpav05.wdc07v.mail.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 3283D58061 for ; Thu, 7 May 2026 10:42:58 +0000 (GMT) Received: from smtpav05.wdc07v.mail.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 52CF458053 for ; Thu, 7 May 2026 10:42:57 +0000 (GMT) Received: from [9.43.101.71] (unknown [9.43.101.71]) by smtpav05.wdc07v.mail.ibm.com (Postfix) with ESMTP for ; Thu, 7 May 2026 10:42:56 +0000 (GMT) Message-ID: Date: Thu, 7 May 2026 16:12:55 +0530 MIME-Version: 1.0 User-Agent: Mozilla Thunderbird To: ltp@lists.linux.it References: <20260507104019.9764-1-sachinp@linux.ibm.com> Content-Language: en-US From: Sachin Sant In-Reply-To: <20260507104019.9764-1-sachinp@linux.ibm.com> X-TM-AS-GCONF: 00 X-Proofpoint-Spam-Details-Enc: AW1haW4tMjYwNTA3MDEwNSBTYWx0ZWRfXyJAkGnepTd0Q Ui1qSPvwRBcTLNjOGFK1/5QXw1wYj3NKM49dJP0toJ6KWGTlRKqSOPQIRjaTrmnpixmKxJgpRZG H5ftAZC/U0Y5tVfvHbugL5L8YugLkNn3oMQ/9Sw+038XRcAoYMd9SKl0eDFoEMWDhAyniZ25v2+ Dgj1rdxlLVxUKx/i2aAFda1gVMvPGs09PhGF9J97i2Q/tG2Yaqq9Our5s2sX/fUlXCoMo7MSYnO xWOesZ4MZ5NkkzOb93taCReNeduK2xe3F0+nIYHO+zKONpR4onx/+btZeT4IKRcGovup7CtTdJ5 AthNa98XU2X8so860TVcohrJh51CJ3zgF3SkLp6cCIz/sQy1qIxFegEQHpEGaWzlbE8HdoqgecA N2gTflj/YRS+VTMhmfjsc2emeFRDKOUW4FlsKFSNDCR9vUwmchCyteEjVklgtMQY/5Srk9msQLW kJqnd8D5oVYUPTig0dw== X-Authority-Analysis: v=2.4 cv=J4GaKgnS c=1 sm=1 tr=0 ts=69fc6cb3 cx=c_pps a=GFwsV6G8L6GxiO2Y/PsHdQ==:117 a=GFwsV6G8L6GxiO2Y/PsHdQ==:17 a=IkcTkHD0fZMA:10 a=NGcC8JguVDcA:10 a=VkNPw1HP01LnGYTKEx00:22 a=RnoormkPH1_aCDwRdu11:22 a=RzCfie-kr_QcCd8fBx8p:22 a=NEAV23lmAAAA:8 a=VwQbUJbxAAAA:8 a=1XWaLZrsAAAA:8 a=VnNF1IyMAAAA:8 a=iox4zFpeAAAA:8 a=4cv_PmrSPDnawAlTv40A:9 a=QEXdDO2ut3YA:10 a=WzC6qhA0u3u7Ye7llzcV:22 X-Proofpoint-GUID: gqFVLhAzYjcwfXkzvww5XJ57w62Q6hc3 X-Proofpoint-ORIG-GUID: gqFVLhAzYjcwfXkzvww5XJ57w62Q6hc3 X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.293,Aquarius:18.0.1143,Hydra:6.1.51,FMLib:17.12.100.49 definitions=2026-05-06_02,2026-05-06_01,2025-10-01_01 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 impostorscore=0 clxscore=1015 malwarescore=0 bulkscore=0 suspectscore=0 priorityscore=1501 spamscore=0 phishscore=0 adultscore=0 lowpriorityscore=0 classifier=typeunknown authscore=0 authtc= authcc= route=outbound adjust=0 reason=mlx scancount=1 engine=8.22.0-2604200000 definitions=main-2605070105 X-Virus-Scanned: clamav-milter 1.0.9 at in-3.smtp.seeweb.it X-Virus-Status: Clean Subject: Re: [LTP] [PATCH v5 1/2] doc: Add CVE catalog to documentation X-BeenThere: ltp@lists.linux.it X-Mailman-Version: 2.1.29 Precedence: list List-Id: Linux Test Project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Content-Transfer-Encoding: 7bit Content-Type: text/plain; charset="us-ascii"; Format="flowed" Errors-To: ltp-bounces+ltp=archiver.kernel.org@lists.linux.it Sender: "ltp" Ignore this series. I forgot to remove old copy of patches. Will resend. On 07/05/26 4:10 pm, Sachin Sant wrote: > Add a new CVE catalog page that automatically generates a comprehensive > list of all CVE reproducers available in LTP. The catalog extracts CVE > information from test metadata tags and presents them in a table format > with links to corresponding test cases. > > Changes: > - Add doc/users/cve_catalog.rst as new documentation page > - Implement generate_cve_catalog() in doc/conf.py to extract CVE tags > from metadata/ltp.json and generate _static/cve.rst > - Configure autosectionlabel with document prefixes to prevent duplicate > label warnings when same test names appear in multiple files > - Update doc/Makefile to clean generated _static/cve.rst file > - Add CVE catalog link to main documentation index > > The catalog displays CVEs in descending order (newest first) with > cross-references to test cases in the test catalog, making it easy > to find reproducers for specific CVEs. > > Closes: https://github.com/linux-test-project/ltp/issues/1254 > Reviewed-by: Andrea Cervesato > Signed-off-by: Sachin Sant > --- > V5 changes: > - Rewrite CVE catalog logic to only use ltp.json metadata > - Remove the dependency on runtest/cve file > - v4 link https://lore.kernel.org/ltp/aftwmBUir04jaik4@yuki.lan/T/#t > > V4 changes: > - Simplified the CVE table (id, test name) > - Removed individual CVE pages > - v3 link https://lore.kernel.org/ltp/69f0b046.df0a0220.3765a8.f8e4@mx.google.com/T/#u > > V3 changes: > - CVEs sorted in descending order > - append test name to CVE id : CVE (Test Name) > - Separate page for CVE catalog > - Link cve testcases to Test catalog entry > - v2 link https://lore.kernel.org/ltp/0df5f75d-eb8f-428e-9888-bb7a90a6b1a4@linux.ibm.com/ > > V2 changes: > - Replace Fixes tag by Closes > - V1 link https://lore.kernel.org/ltp/20260423105304.59788-1-sachinp@linux.ibm.com/T/#u > > --- > doc/Makefile | 2 +- > doc/conf.py | 84 +++++++++++++++++++++++++++++++++++++++ > doc/index.rst | 4 ++ > doc/users/cve_catalog.rst | 6 +++ > 4 files changed, 95 insertions(+), 1 deletion(-) > create mode 100644 doc/users/cve_catalog.rst > > diff --git a/doc/Makefile b/doc/Makefile > index 3123b1cd7..1da240530 100644 > --- a/doc/Makefile > +++ b/doc/Makefile > @@ -31,7 +31,7 @@ spelling: > > clean: > rm -rf html/ build/ _static/syscalls.rst _static/tests.rst syscalls.tbl \ > - ${abs_top_builddir}/metadata/ltp.json > + _static/cve.rst ${abs_top_builddir}/metadata/ltp.json > > distclean: clean > rm -rf $(VENV_DIR) > diff --git a/doc/conf.py b/doc/conf.py > index 63d09352e..9b81162c5 100644 > --- a/doc/conf.py > +++ b/doc/conf.py > @@ -30,6 +30,15 @@ extensions = [ > 'sphinx.ext.extlinks', > ] > > +# Configure autosectionlabel to prefix labels with document name > +# This prevents duplicate labels when same test name appears in multiple files > +autosectionlabel_prefix_document = True > +# Only create labels for sections with unique names > +autosectionlabel_maxdepth = 2 > + > +# Suppress duplicate label warnings for kernel-doc generated content > +suppress_warnings = ['autosectionlabel.*'] > + > exclude_patterns = ["html*", '_static*', '.venv*'] > extlinks = { > 'repo': (f'{ltp_repo}/%s', '%s'), > @@ -535,6 +544,80 @@ def generate_test_catalog(_): > with open(output, 'w+', encoding='utf-8') as new_tests: > new_tests.write('\n'.join(text)) > > +def generate_cve_catalog(_): > + """ > + Generate CVE catalog in a single file by extracting CVE tags from > + metadata/ltp.json. This creates a single _static/cve.rst file with > + all CVE information and links to test sources. > + """ > + output = '_static/cve.rst' > + metadata_file = '../metadata/ltp.json' > + > + # Load metadata > + metadata = None > + try: > + with open(metadata_file, 'r', encoding='utf-8') as data: > + metadata = json.load(data) > + except FileNotFoundError: > + logger = sphinx.util.logging.getLogger(__name__) > + msg = f"Can't find metadata file ({metadata_file})" > + logger.warning(msg) > + return > + > + # Extract CVE information from test tags > + cve_data = {} > + tests = metadata.get('tests', {}) > + > + for test_name, test_info in tests.items(): > + tags = test_info.get('tags', []) > + for tag in tags: > + if len(tag) >= 2 and tag[0] == 'CVE': > + cve_id = tag[1].upper() > + # Normalize CVE ID format: ensure it starts with "CVE-" > + if not cve_id.startswith('CVE-'): > + cve_id = 'CVE-' + cve_id > + if cve_id not in cve_data: > + cve_data[cve_id] = [] > + cve_data[cve_id].append(test_name) > + > + # Generate single CVE catalog file > + total_cves = len(cve_data) > + text = [ > + '.. warning::', > + ' The following CVE catalog has been generated from test', > + ' metadata and includes all CVE reproducers in LTP.', > + '', > + f'LTP includes reproducers for {total_cves} known CVEs.', > + '', > + '.. list-table::', > + ' :header-rows: 1', > + ' :widths: 40 60', > + '', > + ' * - CVE ID', > + ' - Test Name(s)', > + ] > + > + # Add CVEs in descending order (newest first) > + for cve_id in sorted(cve_data.keys(), reverse=True): > + test_names = cve_data[cve_id] > + > + # Create cross-references for all tests > + test_links = [] > + for test_name in sorted(test_names): > + test_anchor = f"users/test_catalog:{test_name}" > + test_link = f":ref:`{test_name} <{test_anchor}>`" > + test_links.append(test_link) > + > + # Join multiple tests with commas > + tests_str = ', '.join(test_links) > + > + text.extend([ > + f' * - {cve_id}', > + f' - {tests_str}', > + ]) > + > + with open(output, 'w+', encoding='utf-8') as cve_catalog: > + cve_catalog.write('\n'.join(text)) > > def setup(app): > """ > @@ -543,4 +626,5 @@ def setup(app): > """ > app.add_css_file('custom.css') > app.connect('builder-inited', generate_syscalls_stats) > + app.connect('builder-inited', generate_cve_catalog) > app.connect('builder-inited', generate_test_catalog) > diff --git a/doc/index.rst b/doc/index.rst > index 496a12f80..733495f51 100644 > --- a/doc/index.rst > +++ b/doc/index.rst > @@ -12,6 +12,7 @@ > users/testers_guide > users/supported_systems > users/stats > + users/cve_catalog > users/test_catalog > > .. toctree:: > @@ -58,6 +59,9 @@ For users > :doc:`users/stats` > Some LTP statistics > > +:doc:`users/cve_catalog` > + LTP reproducers for known CVEs > + > :doc:`users/test_catalog` > The LTP test catalog > > diff --git a/doc/users/cve_catalog.rst b/doc/users/cve_catalog.rst > new file mode 100644 > index 000000000..5a5b9b54a > --- /dev/null > +++ b/doc/users/cve_catalog.rst > @@ -0,0 +1,6 @@ > +.. SPDX-License-Identifier: GPL-2.0-or-later > + > +CVE catalog > +=========== > + > +.. include:: ../_static/cve.rst -- Thanks - Sachin -- Mailing list info: https://lists.linux.it/listinfo/ltp