代码静态检测——QAC

本文详细介绍了QAC静态代码分析工具的构建过程,包括Compiler personality、Analyser personality和Message personality的设置。QAC用于检查源码的编译器配置和分析选项,以检测潜在问题。常见报警包括指标超出阈值、布尔类型转换警告、指针类型不匹配和隐式类型转换。通过理解并配置QAC,可以提升代码质量和可靠性。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

目录

一、前言

二、QAC构建

三、QAC常见报警


一、前言

QAC和Klockwork都属于静态代码检测并且检测方法日趋于后者,polyspace是动态检测,包括各种条件真假在板子上的实时运行情况。QAC是什么?你把源码文件给它(包括编译器),它根据定义的规则分析,然后根据输出警报的配置选择输出还是抑制,最后输出报告。

Compiler personality:反应编译器配置选项

Analyser personality:定义与项目相关的分析选项

Message personality:定义启用的警报消息及如何显示输出

二、QAC构建

使用QAC8.1新建工程一般包括源码路径,报告输出路径及3个个性化配置文件导入Message(.p_s),Analyser(.p_a),Compilier(.p_c)

2.1 Message

Message用来控制警报消息的显示,将报警按照严重等级分为10级(0-9)。

-n  xxx抑制编号为xxx的警报消息输出-max 显示最多警报消息出现次数,一般 -max 0
-o xxx选择编号为xxx的警报消息输出-format消息的输出格式
-summ创建分析总结-up用户消息文件路径
-hdr显示Header头警报-emhm消息扩展列表,如-emhm  1151, 1123
-hw显示抑制警报消息-usr 
-l显示行号-m- 
-st显示最高报警等级-one- 

上面的选项后面可以添加+ / -等输入参数,具体含义看user-guide
2.2  Analyser

顾名思义,你把文件告诉它在哪里,根据规则进行分析。

-i 指定头文件(绝对路径) -i "path folder"-ppl处理输出 -ppl+
-q抑制来自路径中头文件的消息 -q "header path folder"-ppf在预处理列表中包含文件名和行号 -ppf+
-d ident[= [ value]]定义宏,如 -d "osType = int",工程宏-ss为更大广度生成无符号到更大有符号消息 -ss+
-op path指定生成输出文件的路径,工程-sr为对等类型生成类型转换消息 -sr-
-sty extented括号style的检测-wc警报调用 -wc abort=5126
-t, -tab, -tabstop指定制表符表示的空格数 -tab 8-spragmapragma block ignore -spragma "asm","endasm"
-il代码紧凑等级 -il 0-threshmetrics阈值 -thresh "STCYC>15"
-mll最大行长度 -mll 0-cocomment count -co a
-enEncoding -en ASC-met , -ppm-met显示metrics, -ppm metrics after preprocessing -met+ -ppm-
-maxerr可中止的最大错误数 -maxerr 0-k+rK&R to ANSI portability

 

2.3 Compilier

-i "path"系统头:文件包含-it wchar_t固有类型:wchar_t
-q "path"系统头:移植输出-s类型大小和对齐:size
-d系统宏定义-a类型大小和对齐:alignment
-ar数据类型:右移行为 -ar+-na标识符:内部标识符有效长度 -na 31
-bits数据类型:位域解释 -bits--xn标识符:外部标识符有效长度 -xn 31
-u数据类型:字符解释 -u+-xc标识符:忽略外部标识符case  -xc-
-fpc数据类型:将普通字符折叠为有符号/无符号类型 -fpc+-ex扩展:扩展类型 -ex asm
-it size_t固有类型:size_t-fi扩展:附加包含文件 -fi "xx.h"
-it ptrdiff_t固有类型:ptrdiff_t        -it "ptrdiff_t=int"-sl扩展:忽略\和换行符之间的空白格 -sl-

 

总结:参考QAC-8.1.1-R下的personalities文件夹和help下的user-guide中附录personalities可以构建自己项目的属性文件(如果前人有这些配置文件,轮子就不用造了,但是要具备造轮子的能力)

三、QAC常见报警

3.1 Msg(2:4700) metric value out of  threshold range: STCYC=22:STLIN=307:STMCC = 48;函数内执行的代码行数少于5,比如一个函数中只有if-else if...或者switch-case

3.2 Msg(2:4304) An expression of 'essentially Boolean type'is being cast to unsigned type;布尔类型表达式转化为无符号整形

void foo (unsigned c);
unsigned f4304(int a , _Bool b)
{
    foo((unsiged)(a<0));/*4304*/
    return ((unsigned)b);/*4304*/
}

3.3 Msg(2:0310) Casting to different object pointer type,指针类型的强制转换导致警报。类型的大小和对齐方式是基于硬件确定的,转换具有严格对齐要求的类型导致不确定的行为。比如一般是4字节对齐,如果在分配中强制定义为1/2/3字节,在程序运行中会出现异常。

extern char *pa;
extern char *pb;
extern int* pia;

extern void foo(void)
{
    pa = (char*)pia; //0310
    pia = (int*)pb;    //0310 & 3305
}

3.4 Msg(3:3305) pointer cast to stricter alignment;如果是4字节对齐片子,在分配了4字节int的前提下,强制转换为char*是安全的。如果地址恰好位于4的倍数上转换为char*是安全的,否则将会出现异常3305。

3.5 Msg(2:3892)The reslut of this cast is implicitly coverted to another type;声明的不同类型,在代码中没有强制转换统一类型导致的警报;

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

1、 QAC介绍和使用说明 其他的功能概括 1、提供一种可量化措施的代码度量值属性:33基于功能 32基于文件和4个项目级别 2、功能结构关系图,以提供控制流动洞察 3、展示全局调用函数的关系图引用和文件树结构 4、提供统计分析对代码质量的全面评估 5、跨模块分析能力(CMA)、分析递归功能和全局标识符的各种问题 6、简化的旧代码修改的设置基准模块 Source..c文件通过分析工具生成3种文件source.c.i、source.c.met、source.c.err。source.c.i文件可以直接生成报告文件,.met、.err这两个文件可以分析出功能结构、关系、特征标准、报告或者进行跨模块分析,对于跨模块分析和剖析器分析需要进行配置,source.c.met、source.c.err、配置文件可以在信息浏览器中显示 2、 规划 2.1、自动生成文件及参数说明 生成自动文档步骤: 1、从文件菜单中选者Auto-Create Project 2、进入Root Folder Name,这是工程的根目录,后面的自动生成的文件都会对应此根目录产生 3、进入Starting Directory,这个源代码目录与工程的根目录相连 4、进入Output File Path,这里可以选择QAC分析后的输出文件,好的情况就是用一个专门的目录和工程根目录相连 5、Replicate source tree structure in output paths通常是为输出部分建立一个子目录结构,这里可以有2种选择,可以选择Parallel to Source Structure为源代码建立一个平行的目录结构,或者选择Sub-path to each source location把规定的输出的子目录嵌入到源工程目录下面 6、选择File Extensions可以加入项目,通常只要选择一个.C文件,包括对.H文件也就被加入 7、为文件夹选择一个个性,可能会使用默认设置为起始点,可以在QAC中选择Configuration菜单 8、点击OK就是建立了工程,包含源文件工程和子文件夹 9、保存文件,外部扩展名为.prj 注意:也可以在已有的项目上自动生成一个文件夹,点击菜单Edit > Auto-create Sub-Folders,其余步骤和以上相同 文件夹参数:包括文件夹名称、默认源路径、输出路径和三种个性 可以进入Edit > Folder Parameters只可以改变文件夹参数,进入Edit > Propagate Changes to Sub-Folders可以改变所有子文件夹参数 2.2、手动生成文档及参数说明 生成手动文档步骤: 1、从菜单File中选择New Project,显示一个对话框New Project Parameters 2、进入Root Folder Name,输入一个项目名称 3、进入Default Source Path为项目初始化文件夹,这个路径可以改变所有子文件夹 4、在Output File Path中选择需要输出的分析文档 5、为工程选个个性 6、点击 OK创建项目,这工程的配置是唯一的文件夹 7、按要求增加更多的子文件夹和文件按要求 8、保存文件,外部扩展名为.prj 文件夹参数;在File > Reopen这项中可以有10多个选项,当没用的文件可以选择Clean-up。 文件和目录的位置时重新打开项目,将检查的存在。如果不存在一个条目将显示下面的对话框。有的更正可以自动应用的过程。 2.3、选择输出文件 一般文件夹的层次结构在在左边显示,选择的列表在文件的右边显示 所有的选择都在Browse 和d Reports这两个菜单中 A、如果选择单个文件或一组文件,则使用 B、否则当前所选文件夹,再加上所有子其文件夹,窗体所选内容。这意味着使用这些文件夹中的所有文件。 在浏览器内修改,有可能会改变开始的选择,用Select Files…在File菜单内 2.4、互相比较和环境变化的报告 2.4.1、根路径 2.4.2、基于GUI的环境变量创建 2.4.3、相对路径和环境变量的运用 选择Apply Relative Paths项可以选择相对路径减少的所有文件条目,根目录在右上角,表示保存项目文件的位置,确定路径是否合适相对路径减少。 选择Make file paths in each folder relative to its Default Source Path entry项,如果想要应用一个虚拟的环境变量表达默认每个文件的源路径到其他文件条目下。 在Available Environment Variables列表下,可以添加EVs to Apply至右边框中,将这种替换只发生在项目中的项的文件或关联的路径不受相对路径减少的个性 选择Apply path reduction to personality file entries associated with the project项,为了继续应用相对路径和环境变量在文件路径下的个性定义 选择Remove all path reduction from the project and associated personalities项若要撤消所有的相对路径和环境变量从相关个性设置项目恢复到完全在所有情况下限定的路径 例如,一个被重建的“Diff”项目如下所示与充分的relative道路实施 3、 配置QAC 为应用程序配置主要通过可访问Configuration > Options选项卡,有以下几点: Annotated Source 附加说明源 Cross-Module Analysis 跨模块分析 Custom Reports 自定义报告 Default Personalities 默认特性 Editor Preferences 编辑选项 Environment 环境 (Product)Extensions (产品)条目 Project File Options 项目文件选择 要查看您的安装与那些一起中的个性的一组在您的项目中定义,可以在Configuration下选择Message Personalities, Analyser Personalities or Compiler Personalities这几个选项 当创建了一个额外的特性,也可以设置它们成为系统默认,在Configuration>Options>Default Personalities下设置 3.1、配置编译器特性 看附录A 3.1.1、设置系统头文件 在系统包括系统标题选项卡上的标题,设置您系统标头包含路径 可以点击Suppress Output阻止这些头文件,当阻止了那些头文件,一些从特定的头文件或路径中产生的分析数据也不能在.err、.met文件中出现 您可以手动输入是相对于当前项目的路径位置,虽然建议进行完整路径选择和然后将任何选择的道路减少保存项目的过程中的应用操作 3.1.2、设置系统宏 在System Macro Defines下的Project Macros菜单中,设置宏同编译器或开发环境一致,宏可以在Compiler Personality或Analyser Personality设置 3.1.3、设置实现定义的类型 在c编译器里有3中类型定义,在“implementation defined”中选择,如下: size_t 一种无符号必需类型通过sizeof操作表示返回类型 ptrdiff_t 一种有有符号必需类型用减法运算的两个指针来表示 wchar_t 它反映了类型的范围内的整数类型字符文本和宽字符字符串 在Data Types下的Intrinsic Types条目控制这些类型的方法实施,需要以匹配编译器配置环境。所载入的任何相应类型声明头文件(e.g. stddef.h, stdio.h)必须反映内在匹配值类型。如果不符合,qac提示等级9的警告,如有必要,检查您的头文件确定适当的设置这些选项。 如上所述:QAC随提供一套标准库的头文件,如果想改变这些类型定义,必须先明白QAC内部的定义类型,因为那些头文件包含一些声明ptrdiff_t, size_t 和wchar_t,还有3种宏指令定义PRQA_PTRDIFF_T, PRQA_SIZE_T,和PRQA_WCHAR_T, 3.1.4、编译器扩展 许多编译器制造商实施 ISO C 的扩展语言定义来利用特定的硬件环境。特别是在嵌入式软件代码的速度和空间是重要 使用的语言扩展的危险是他们妥协可移植性。源代码越来越依赖于编译器和硬件环境。 QA C 是能够分析各种不同的语言变体和扩展,但它不是通常能够解释扩展在语义上。通常,必须配置该工具等,非标准关键字将被忽略。 有几种方法可以为此配置QAC,看附录B–extensions部分
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值