From nobody Tue May 21 02:01:51 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of lists.xenproject.org designates 192.237.175.120 as permitted sender) client-ip=192.237.175.120; envelope-from=xen-devel-bounces@lists.xenproject.org; helo=lists.xenproject.org; Authentication-Results: mx.zohomail.com; spf=pass (zohomail.com: domain of lists.xenproject.org designates 192.237.175.120 as permitted sender) smtp.mailfrom=xen-devel-bounces@lists.xenproject.org Return-Path: Received: from lists.xenproject.org (lists.xenproject.org [192.237.175.120]) by mx.zohomail.com with SMTPS id 1699976238248924.0008926509048; Tue, 14 Nov 2023 07:37:18 -0800 (PST) Received: from list by lists.xenproject.org with outflank-mailman.632829.987296 (Exim 4.92) (envelope-from ) id 1r2vTG-0004K5-43; Tue, 14 Nov 2023 15:36:58 +0000 Received: by outflank-mailman (output) from mailman id 632829.987296; Tue, 14 Nov 2023 15:36:58 +0000 Received: from localhost ([127.0.0.1] helo=lists.xenproject.org) by lists.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1r2vTG-0004Jw-1R; Tue, 14 Nov 2023 15:36:58 +0000 Received: by outflank-mailman (input) for mailman id 632829; Tue, 14 Nov 2023 15:36:56 +0000 Received: from se1-gles-sth1-in.inumbo.com ([159.253.27.254] helo=se1-gles-sth1.inumbo.com) by lists.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1r2vTE-00043K-JZ for xen-devel@lists.xenproject.org; Tue, 14 Nov 2023 15:36:56 +0000 Received: from support.bugseng.com (mail.bugseng.com [162.55.131.47]) by se1-gles-sth1.inumbo.com (Halon) with ESMTPS id a44558c8-8303-11ee-98db-6d05b1d4d9a1; Tue, 14 Nov 2023 16:36:56 +0100 (CET) Received: from nico.bugseng.com (unknown [147.123.100.131]) by support.bugseng.com (Postfix) with ESMTPSA id 398D44EE0744; Tue, 14 Nov 2023 16:36:54 +0100 (CET) X-Outflank-Mailman: Message body and most headers restored to incoming version X-BeenThere: xen-devel@lists.xenproject.org List-Id: Xen developer discussion List-Unsubscribe: , List-Post: List-Help: List-Subscribe: , Errors-To: xen-devel-bounces@lists.xenproject.org Precedence: list Sender: "Xen-devel" X-Inumbo-ID: a44558c8-8303-11ee-98db-6d05b1d4d9a1 From: Nicola Vetrini To: nicola.vetrini@bugseng.com, xen-devel@lists.xenproject.org Cc: sstabellini@kernel.org, michal.orzel@amd.com, xenia.ragiadakou@amd.com, ayan.kumar.halder@amd.com, consulting@bugseng.com, jbeulich@suse.com, andrew.cooper3@citrix.com, roger.pau@citrix.com, bertrand.marquis@arm.com, julien@xen.org, Simone Ballarin , Doug Goldstein Subject: [XEN PATCH v4 1/2] automation/eclair: make the docs for MISRA C:2012 Dir 4.1 visible to ECLAIR Date: Tue, 14 Nov 2023 16:36:47 +0100 Message-Id: X-Mailer: git-send-email 2.34.1 In-Reply-To: References: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-ZM-MESSAGEID: 1699976240034100001 Content-Type: text/plain; charset="utf-8" To be able to check for the existence of the necessary subsections in the documentation for MISRA C:2012 Dir 4.1, ECLAIR needs to have a source file that is built. This file is generated from 'C-runtime-failures.rst' in docs/misra and the configuration is updated accordingly. Signed-off-by: Nicola Vetrini Reviewed-by: Stefano Stabellini --- Changes from RFC: - Dropped unused/useless code - Revised the sed command - Revised the clean target Changes in v2: - Added explanative comment to the makefile - printf instead of echo Changes in v3: - Terminate the generated file with a newline - Build it with -std=3Dc99, so that the documentation for D1.1 applies. Changes in v5: - Transform and build the file directly in the eclair-specific directory --- automation/eclair_analysis/build.sh | 21 +++++++++++++++++++-- automation/eclair_analysis/prepare.sh | 7 ++++--- 2 files changed, 23 insertions(+), 5 deletions(-) diff --git a/automation/eclair_analysis/build.sh b/automation/eclair_analys= is/build.sh index ec087dd822fa..f24292ed0643 100755 --- a/automation/eclair_analysis/build.sh +++ b/automation/eclair_analysis/build.sh @@ -33,12 +33,29 @@ else PROCESSORS=3D6 fi =20 +runtime_failures_docs() { + doc=3D"C-runtime-failures.rst" + builddir=3D"automation/eclair_analysis" + =20 + cp "docs/misra/${doc}" "${builddir}" + cd "${builddir}" + printf "/*\n\n" >"${doc}.tmp" + sed -e 's|\*/|*//*|g' "${doc}" >>"${doc}.tmp" + printf "\n\n*/\n" >>"${doc}.tmp" + mv "${doc}.tmp" "${doc}.c" + =20 + # Cannot redirect to /dev/null because it would be excluded from the ana= lysis + "${CROSS_COMPILE}gcc-12" -std=3Dc99 -c "${doc}.c" -o "${doc}.o" + cd - +} + ( - cd xen + runtime_failures_docs =20 make "-j${PROCESSORS}" "-l${PROCESSORS}.0" \ "CROSS_COMPILE=3D${CROSS_COMPILE}" \ "CC=3D${CROSS_COMPILE}gcc-12" \ "CXX=3D${CROSS_COMPILE}g++-12" \ - "XEN_TARGET_ARCH=3D${XEN_TARGET_ARCH}" + "XEN_TARGET_ARCH=3D${XEN_TARGET_ARCH}" \ + -C xen ) diff --git a/automation/eclair_analysis/prepare.sh b/automation/eclair_anal= ysis/prepare.sh index 0cac5eba00ae..fe9d16e48ecc 100755 --- a/automation/eclair_analysis/prepare.sh +++ b/automation/eclair_analysis/prepare.sh @@ -35,11 +35,12 @@ else fi =20 ( - cd xen - cp "${CONFIG_FILE}" .config + ./configure + cp "${CONFIG_FILE}" xen/.config make clean find . -type f -name "*.safparse" -print -delete - make -f ${script_dir}/Makefile.prepare prepare + cd xen + make -f "${script_dir}/Makefile.prepare" prepare # Translate the /* SAF-n-safe */ comments into ECLAIR CBTs scripts/xen-analysis.py --run-eclair --no-build --no-clean ) --=20 2.34.1 From nobody Tue May 21 02:01:51 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of lists.xenproject.org designates 192.237.175.120 as permitted sender) client-ip=192.237.175.120; envelope-from=xen-devel-bounces@lists.xenproject.org; helo=lists.xenproject.org; Authentication-Results: mx.zohomail.com; spf=pass (zohomail.com: domain of lists.xenproject.org designates 192.237.175.120 as permitted sender) smtp.mailfrom=xen-devel-bounces@lists.xenproject.org Return-Path: Received: from lists.xenproject.org (lists.xenproject.org [192.237.175.120]) by mx.zohomail.com with SMTPS id 169997624155891.83320892165818; Tue, 14 Nov 2023 07:37:21 -0800 (PST) Received: from list by lists.xenproject.org with outflank-mailman.632830.987306 (Exim 4.92) (envelope-from ) id 1r2vTJ-0004cb-CI; Tue, 14 Nov 2023 15:37:01 +0000 Received: by outflank-mailman (output) from mailman id 632830.987306; Tue, 14 Nov 2023 15:37:01 +0000 Received: from localhost ([127.0.0.1] helo=lists.xenproject.org) by lists.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1r2vTJ-0004cR-8K; Tue, 14 Nov 2023 15:37:01 +0000 Received: by outflank-mailman (input) for mailman id 632830; Tue, 14 Nov 2023 15:37:00 +0000 Received: from se1-gles-flk1-in.inumbo.com ([94.247.172.50] helo=se1-gles-flk1.inumbo.com) by lists.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1r2vTH-0004Ze-VR for xen-devel@lists.xenproject.org; Tue, 14 Nov 2023 15:36:59 +0000 Received: from support.bugseng.com (mail.bugseng.com [162.55.131.47]) by se1-gles-flk1.inumbo.com (Halon) with ESMTPS id a55fa335-8303-11ee-9b0e-b553b5be7939; Tue, 14 Nov 2023 16:36:58 +0100 (CET) Received: from nico.bugseng.com (unknown [147.123.100.131]) by support.bugseng.com (Postfix) with ESMTPSA id 13EC64EE0747; Tue, 14 Nov 2023 16:36:55 +0100 (CET) X-Outflank-Mailman: Message body and most headers restored to incoming version X-BeenThere: xen-devel@lists.xenproject.org List-Id: Xen developer discussion List-Unsubscribe: , List-Post: List-Help: List-Subscribe: , Errors-To: xen-devel-bounces@lists.xenproject.org Precedence: list Sender: "Xen-devel" X-Inumbo-ID: a55fa335-8303-11ee-9b0e-b553b5be7939 From: Nicola Vetrini To: nicola.vetrini@bugseng.com, xen-devel@lists.xenproject.org Cc: sstabellini@kernel.org, michal.orzel@amd.com, xenia.ragiadakou@amd.com, ayan.kumar.halder@amd.com, consulting@bugseng.com, jbeulich@suse.com, andrew.cooper3@citrix.com, roger.pau@citrix.com, bertrand.marquis@arm.com, julien@xen.org, George Dunlap , Wei Liu Subject: [XEN PATCH v4 2/2] docs/misra: add guidance on the format of Dir 4.1 docs for ECLAIR Date: Tue, 14 Nov 2023 16:36:48 +0100 Message-Id: X-Mailer: git-send-email 2.34.1 In-Reply-To: References: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-ZM-MESSAGEID: 1699976241797100005 Content-Type: text/plain; charset="utf-8" Additional guidance on the formatting of the document for ECLAIR is supplied. Signed-off-by: Nicola Vetrini Acked-by: Julien Grall Reviewed-by: Stefano Stabellini --- docs/misra/C-runtime-failures.rst | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/docs/misra/C-runtime-failures.rst b/docs/misra/C-runtime-failu= res.rst index 1052b2afca13..cac51d6b2596 100644 --- a/docs/misra/C-runtime-failures.rst +++ b/docs/misra/C-runtime-failures.rst @@ -12,6 +12,14 @@ built-in checks that are present in the language. The presence of such documentation is requested by MISRA C:2012 Directive = 4.1, whose headline states: "Run-time failures shall be minimized". =20 +The ECLAIR checker for MISRA C:2012 Directive 4.1 requires the documentati= on +to be supplied using the following format: + +``Documentation for MISRA C:2012 Dir 4.1: `` + +The matched categories are the ones listed below (e.g., ``overflow`` and +``unexpected wrapping``). The content of the description is not checked an= d can +span multiple lines. =20 Documentation for MISRA C:2012 Dir 4.1: overflow ________________________________________________ --=20 2.34.1