PC-lint Plus 1.3支持许多CERT C的静态可执行准则。通过在现有配置中添加对au-certc.lnt文件(随PC-lint Plus分发)的引用,可以轻松实现对CERT C的检查。该文件启用与CERT C准则相对应的消息,并将文本添加到已发布的消息中,以指定与每个适用消息关联的规则。au-certc.lnt文件是使用标准PC-lint Plus选项语法的,易于阅读的纯文本配置文件,可以轻松地对其进行修改以满足任何单个项目的需求。
PC-lint Plus 1.3支持许多CERT C的静态可执行准则。通过在现有配置中添加对au-certc.lnt文件(随PC-lint Plus分发)的引用,可以轻松实现对CERT C的检查。该文件启用与CERT C准则相对应的消息,并将文本添加到已发布的消息中,以指定与每个适用消息关联的规则。au-certc.lnt文件是使用标准PC-lint Plus选项语法的,易于阅读的纯文本配置文件,可以轻松地对其进行修改以满足任何单个项目的需求。
PC-lint Plus随附的参考手册包括一个支持矩阵,详细列出了每个指南的支持级别以及每个指南的支持机制。
违规分析与陈述
考虑以下示例:
#include <stdio.h> extern void logger(const char *); #define LOG(x) logger(#x) void copy(FILE *fp_in, FILE *fp_out, int count) { char buf[100]; int bytes = 0; while (bytes < count) { int bytes_read = fread(buf, 1, 100, fp_in); if (!bytes_read) { break; } fwrite(buf, 1, bytes_read, fp_in); LOG(bytes = bytes + bytes_read); } }
当使用PC-lint Plus分析此示例时, 告的CERTC违规包括(其中包括):
warning 2479: attempt to perform write operation on stream after read without
an intervening reposition [CERT C Rule FIO39-C]
fwrite(buf, 1, bytes_read, fp_in);
^
supplemental 831: stream was read here
int bytes_read = fread(buf, 1, 100, fp_in);
^
note 901: variable ‘buf’ of type ‘char [100]’ not initialized by definition
[CERT C Rule EXP33-C]
char buf[100];
^
warning 2666: expression with side effects passed to unexpanded parameter 1 of
macro ‘LOG’: parameter is only used with #/## operators [CERT C Rule PRE31-C]
LOG(bytes = bytes + bytes_read);
^
告的每个违规都包括发生违规的位置、消息 和有关基本问题的文字描述,以及违反的CERT C规则。
解决违规
《PC-lint Plus参考手册》包含每条消息的说明,并经常提供可用于解决问题的其他指导。此信息也可以显示在命令行上。例如,要显示消息2666的描述,请运行带有选项-help=2666的PC-lint Plus,以使PC-lint Plus显示以下内容:
当调用类似函数的宏并带有一个参数时发出此消息,该参数看起来好像在进行评估时会产生副作用,但是由于相应的参数未在宏定义中扩展,因此不会发生副作用。例如:
#define DEBUG_VAL(x) int process(int i) { DEBUG_VAL(++i); // 2666 - increment doesn't occur /* ... */ return i; }
由于未扩展参数,因此不会评估++i,并且不会发生增量,这可能是意外的。如果意图是不管宏如何定义都发生副作用,则应将引起副作用的表达式放在宏调用之外。就此消息而言,任何看起来包含函数调用的表达式都被认为具有副作用。
详细信息是“扩展中未引用参数”或“仅与#/##运算符一起使用参数”之一。可以使用-estring基于detail参数的值来禁止显示该消息。
可以查阅CERT C准则文档以获取有关指定规则的信息。
2666标识的问题是一个错误,应通过将分配移至LOG宏的调用之外来进行纠正。
2479识别的问题不仅是违反规则,而且是错误,该文件指针被意外地用于读取和写入同一文件,这导致了未定义的行为,因为没有中间的重新定位操作。解决方案是在对fwrite的调用中将fp_in更改为fp_out。
向buf添加一个初始化程序:
char buf[100] = {0};
解决了901 告的问题(并将阻止在以后的运行中发布901)。
处理偏差
偏差是指源代码中违反规则的情况被视为可接受的实例。虽然偏差过程因项目而异,但可以使用非常灵活的抑制机制在PC-lint Plus中配置偏差。当引用特定的符 或类型时,或在特定的行上时,可以通过多种方式来抑制大多数消息,例如在文件,函数或语句中。某些类型的禁止操作要求在源代码中添加注释,但大多数不需要。
例如,消息901 告了违反CERT C规则EXP33-C(建议在变量的定义中初始化变量)的情况,该消息始终在消息中包含变量的名称。要为名为buf的变量抑制消息901,可以使用选项-esym(901,buf)。要在函数副本内的任何位置禁止显示该消息,可以使用选项-efunc(901,copy)。适当的抑制选项将添加到项目的配置文件中,或在源代码中包含问题定义的棉绒注释中。评论可以遵循此选项,也许带有与正式偏离政策相关的信息,例如-esym(901,buf)“EXP33-C的偏差”。
库代码
PC-lint Plus区分库代码(默认情况下包括外部和系统头,但可以自定义以包括头和模块的任何子集)和项目代码。默认情况下,PC-lint Plus会同时检查库代码和项目代码是否符合CERTC。通常希望将检查范围限制为项目代码,这很容易在引用au-misra3.lnt文件后,通过使用选项-wlib=4 -wlib=1来重置库警告级别来完成。也可以使用-elib和+elib选项轻松地为库代码启用或禁用单个消息。
相关推荐:
MISRA C 2012
MISRA C++ 2008
MISRA C 2004
AUTOSAR
《PC-lint Plus参考手册》中涉及SEI版权材料和PC-lint Plus配置文件以进行SEI CERT C检查的章节包含“SEI CERT C编码标准维基”的部分内容,版权所有995-2018卡内基梅隆大学,并经其软件特别许可工程学院。卡内基梅隆大学或其软件工程学院未曾审查或认可过上述材料以及由Gimpel Software LLC生产或出版的任何其他材料。有关更多信息,请参见《PC-lint Plus参考手册》中的“致谢”一章。
ERT是卡耐基梅隆大学的注册商标
标签:
声明:本站部分文章及图片源自用户投稿,如本站任何资料有侵权请您尽早请联系jinwei@zod.com.cn进行处理,非常感谢!