From nobody Sat May 18 14:25:21 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 1702890064208514.1499109389486; Mon, 18 Dec 2023 01:01:04 -0800 (PST) Received: from list by lists.xenproject.org with outflank-mailman.655711.1023438 (Exim 4.92) (envelope-from ) id 1rF9UL-0003Tr-LO; Mon, 18 Dec 2023 09:00:37 +0000 Received: by outflank-mailman (output) from mailman id 655711.1023438; Mon, 18 Dec 2023 09:00:37 +0000 Received: from localhost ([127.0.0.1] helo=lists.xenproject.org) by lists.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1rF9UL-0003Tk-HY; Mon, 18 Dec 2023 09:00:37 +0000 Received: by outflank-mailman (input) for mailman id 655711; Mon, 18 Dec 2023 09:00:36 +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 1rF9UK-0003Te-M5 for xen-devel@lists.xenproject.org; Mon, 18 Dec 2023 09:00:36 +0000 Received: from support.bugseng.com (mail.bugseng.com [162.55.131.47]) by se1-gles-flk1.inumbo.com (Halon) with ESMTPS id e763abf3-9d83-11ee-9b0f-b553b5be7939; Mon, 18 Dec 2023 10:00:34 +0100 (CET) Received: from Dell.bugseng.com (unknown [78.210.165.135]) by support.bugseng.com (Postfix) with ESMTPSA id 803954EE0742; Mon, 18 Dec 2023 10:00:31 +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: e763abf3-9d83-11ee-9b0f-b553b5be7939 From: Federico Serafini To: xen-devel@lists.xenproject.org Cc: consulting@bugseng.com, Federico Serafini , Simone Ballarin , Doug Goldstein , Stefano Stabellini , Andrew Cooper , George Dunlap , Jan Beulich , Julien Grall , Wei Liu Subject: [XEN PATCH v3] automation/eclair: add deviations for MISRA C:2012 Rule 16.3 Date: Mon, 18 Dec 2023 10:00:18 +0100 Message-Id: <23f4bf337883f1d6b67f7bd8466a9c299713e9d4.1702889534.git.federico.serafini@bugseng.com> X-Mailer: git-send-email 2.34.1 MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-ZM-MESSAGEID: 1702890065542100001 Content-Type: text/plain; charset="utf-8" MISRA C:2012 Rule 16.3 states that an unconditional break statement shall terminate every switch-clause. Update ECLAIR configuration to take into account: - continue, goto, return statements; - functions with attribute noreturn; - pseudo-keyword fallthrough; - macro BUG(); - comments. Update docs/misra/deviations.rst accordingly. Signed-off-by: Federico Serafini Reviewed-by: Stefano Stabellini --- Changes in v3: - added bullet point for pseudo-keyword fallthrough; - mentioned noreturn attribute; - fixed typo. --- Changes in v2: - applied suggestions coming from https://lists.xenproject.org/archives/html/xen-devel/2023-12/msg00957.h= tml --- .../eclair_analysis/ECLAIR/deviations.ecl | 28 ++++++++++++++++ docs/misra/deviations.rst | 32 +++++++++++++++++++ 2 files changed, 60 insertions(+) diff --git a/automation/eclair_analysis/ECLAIR/deviations.ecl b/automation/= eclair_analysis/ECLAIR/deviations.ecl index 683f2bbfe8..0e8152f9c3 100644 --- a/automation/eclair_analysis/ECLAIR/deviations.ecl +++ b/automation/eclair_analysis/ECLAIR/deviations.ecl @@ -327,6 +327,34 @@ therefore have the same behavior of a boolean" -config=3DMC3R1.R14.4,etypes+=3D{deliberate, "stmt(child(cond,child(expr,r= ef(^?::is_dying$))))","src_type(enum)"} -doc_end =20 +# +# Series 16. +# + +-doc_begin=3D"Switch clauses ending with continue, goto, return statements= are +safe." +-config=3DMC3R1.R16.3,terminals+=3D{safe, "node(continue_stmt||goto_stmt||= return_stmt)"} +-doc_end + +-doc_begin=3D"Switch clauses ending with a call to a function that does no= t give +the control back (i.e., a function with attribute noreturn) are safe." +-config=3DMC3R1.R16.3,terminals+=3D{safe, "call(property(noreturn))"} +-doc_end + +-doc_begin=3D"Switch clauses ending with pseudo-keyword \"fallthrough\" are +safe." +-config=3DMC3R1.R16.3,reports+=3D{safe, "any_area(end_loc(any_exp(text(/fa= llthrough;/))))"} +-doc_end + +-doc_begin=3D"Switch clauses ending with failure method \"BUG()\" are safe= ." +-config=3DMC3R1.R16.3,reports+=3D{safe, "any_area(end_loc(any_exp(text(/BU= G\\(\\);/))))"} +-doc_end + +-doc_begin=3D"Switch clauses not ending with the break statement are safe = if an +explicit comment indicating the fallthrough intention is present." +-config=3DMC3R1.R16.3,reports+=3D{safe, "any_area(end_loc(any_exp(text(^(?= s).*/\\* [fF]all ?through.? \\*/.*$,0..1))))"} +-doc_end + # # Series 20. # diff --git a/docs/misra/deviations.rst b/docs/misra/deviations.rst index eda3c8100c..0131d72959 100644 --- a/docs/misra/deviations.rst +++ b/docs/misra/deviations.rst @@ -276,6 +276,38 @@ Deviations related to MISRA C:2012 Rules: therefore have the same behavior of a boolean. - Project-wide deviation; tagged as `deliberate` for ECLAIR. =20 + * - R16.3 + - Switch clauses ending with continue, goto, return statements are sa= fe. + - Tagged as `safe` for ECLAIR. + + * - R16.3 + - Switch clauses ending with a call to a function that does not give + the control back (i.e., a function with attribute noreturn) are saf= e. + - Tagged as `safe` for ECLAIR. + + * - R16.3 + - Switch clauses ending with pseudo-keyword \"fallthrough\" are safe. + - Tagged as `safe` for ECLAIR. + + * - R16.3 + - Switch clauses ending with failure method \"BUG()\" are safe. + - Tagged as `safe` for ECLAIR. + + * - R16.3 + - Existing switch clauses not ending with the break statement are saf= e if + an explicit comment indicating the fallthrough intention is present. + However, the use of such comments in new code is deprecated: + the pseudo-keyword "fallthrough" shall be used. + - Tagged as `safe` for ECLAIR. The accepted comments are: + - /\* fall through \*/ + - /\* fall through. \*/ + - /\* fallthrough \*/ + - /\* fallthrough. \*/ + - /\* Fall through \*/ + - /\* Fall through. \*/ + - /\* Fallthrough \*/ + - /\* Fallthrough. \*/ + * - R20.7 - Code violating Rule 20.7 is safe when macro parameters are used: (1) as function arguments; --=20 2.34.1