debug makefile 及 lint 软件质量软件

时间:2022-04-28 12:05:57
make -d
should give you more than enough information to debug your makefile. Be warned: it will take some time and effort to analyze the output but loading the output into your favorite editor and doing searches will assist a lot. You can greatly reduce the amount of debugging output if you specify the specific target you're interested in. So if you're only interested in the dodgy target, instead of just make -d which may make a hundred different things, try: make clean
make -d dodgy
(assuming you have a clean target of course). The make --debug is identical to make -d but you can also specify: make --debug=FLAGS
where flags can be: a for all debugging (same as make -d and make --debug).
b for basic debugging.
v for slightly more verbose basic debugging.
i for implicit rules.
j for invocation information.
m for information during makefile remakes.
It looks like make --debug=b is the best option for what you need, as shown in the following transcript: pax@paxbox> cat makefile
c:a b
touch c pax@paxbox> touch a b ; make
touch c pax@paxbox> make
make: 'c' is up to date. pax@paxbox> touch a ; make --debug=b
GNU Make 3.81
Copyright (C) Free Software Foundation, Inc. Blah, blah, blah.
Reading makefiles...
Updating goal targets....
Prerequisite 'a' is newer than target 'c'.
Must remake target 'c'.
touch c
Successfully remade target file 'c'.

PC-Lint使用简介

LINT工具是一种软件质量保证工具,许多国外的大型专业软件公司,如微软公司,都  
把它作为程序检查工具,在程序合入正试版本或交付测试之前一定要保证通过了LINT检查  
,他们要求软件工程师在使用LINT时要打开所有的编译开关,如果一定要关闭某些开关,  
那么要给出关闭这些开关的正当理由。

  可想而知,如果从我们编码后第一次编译程序时就使用LINT来检查程序,并且保证消  
除所有的LINT告警,我们就不会遇到象今天这么多的告警信息。即使在今天,我们如果能  
抽出一定的精力来消除程序中的LINT告警,以后再维持这种无告警状态就是很容易的了。  
我们程序质量的提高也是不言而喻的。

  PC-LINT是GIMPEL SOFTWARE公司的产品,其中的内容是非常广泛的,光是选项就有30  
0多个,涉及到程序编译及语法使用中的方方面面。本篇培训材料旨在引导读者入门,学会  
PC-LINT的基本使用方法,起抛砖引玉的作用,能让读者从这里起步继续去研究如何娴熟地  
使用PC-LINT的各种选项,能让它充分为我们的开发工作服务。

1.概述  
  如果要给LINT工具下一个形象点的定义,那就是:一种更加严格的编译器。它不仅可  
以象普通编译器那样检查出一般的语法错误,还可以检查出那些虽然完全合乎语法要求,  
但很可能是潜在的、不易发现的错误。请看下面的例子:  
1:  
2:char *report( int m, int n, char *p )  
3:{  
4: int result;  
5: char *temp;  
6: long nm;  
7: int i, k, kk;  
8: char name[11] = "Joe Jakeson";  
9:  
10: nm = n * m;  
11: temp = p == "" ? "null" : p;  
12: for( i = 0; i 13: {  
14: k++;  
15: kk = i;  
16: }  
17:  
18: if( k== 1 ) result = nm;  
19: else if( kk > 0 ) result = 1;  
20: else if( kk < 0 ) result = -1;  
21:  
22: if( m == result ) return( temp );  
23: else return( name );  
24:}  
  上面的代码用一般的编译器编译是一段有效的代码,但是用PC-LINT编译就会有几个告  
警。首先第8行向name数组赋值时丢掉了nul字符,第10行的乘法精度会失准,第11行的比  
较有问题,第14行的变量k没有初始化,第15行的kk可能没有被初始化,第22行的result也  
有可能没有被初始化,第23行返回的是一个局部对象的地址。这段代码在大部分编译器下  
是可以顺利编译通过的,继续查找其中的错误就要靠人工调试程序,如果程序很大,这将  
是一项烦琐的工作,没有人可以保证能找出所有的这类问题,但PC-LINT只通过一次简单的  
编译就可做到,显然为我们节省了大量的开发时间。

  下面就让我们看看如何安装使用PC-LINT。  
2.如何安装PC-LINT  
  PC-LINT的软件的安装过程比较复杂,选项较多,下面根据安装过程,逐条说明每一步  
的含义。  
0)如果是zip文件,将ZIP安装文件展开到目录C:\lint.ins下,进入COMMAND PROMPT,先  
进行目录映射 subst g: c:\lint.ins,然后转到G: , 执行install。其他步骤和下面的从  
软盘安装是一样的。

1)在A:驱插入PC-LINT安装盘,输入A:\>install命令,进入开始安装栏,按任意键继续,  
进入PC-LINT介绍栏,再按任意键继续。  
2)进入环境选择栏,这一栏中有三个选项:  
Windows NT/Windows 95  
MS-DOS(DOS extended)  
OS/2(32bit)  
如果计算机安装了WIN95、WIN97、WIN98或WINNT要选择Windows NT/Windows 95,如果  
只有DOS则选择DOS。  
3)进入安装目录选择栏,它推荐的是C:\>LINT,如不想安装在这个目录下,可输入自己想  
要安装的目录,然后按回车确认,如果要安装的目录不存在,它会提示为你建立这个目录  
。我们这里选C:\>LINT  
4)选择安装盘所在的磁盘驱动器,我们这里选A:  
5)判断是否要选择多种编译器或编译库的配置,如果要对不同编译环境下的程序进行L

INT,则选YES,否则选NO。然后回车确认。  
6)这时看到一个编译器列表,在这个表中选择自己使用的编译器,如果表中没有自己使用  
的编译器,可选择通用编译器:Generic Compilers。按回车确认。这个选项会体现在co-  
xxx.lnt文件中。  
7)接着安装程序会让你选择一个的内存模型,可以根据自己程序区和数据区的实际大小选  
择一个恰当的内存模型。如果CPU为32位68K系列,则要选择:32-bit Flat Module。  
内存模型的选项会体现在STD.LNT文件中。  
8)选完内存模型后,会看到一个库类型的列表,在这里选择一个或多个编译时使用的库。  
这个选项会体现在LIB-xxx.LNT文件中。  
9)接着是让你选择为使用C++编程提出过重要建议的作者,选择的某作者后,他提出的编  
程建议方面的选项将被打开。与作者选择有关的选项会体现在AU-xxx.LNT文件中。  
10)下一步是设置包含文件目录。有两种选项,第一种是使用环境变量INCLUDE,环境变量  
在批处理文件中设置,环境变量后每个目录用分号隔开,例如可设成“INCLUDE=C:\MRI\M  
CC68K;D:\LAP\SRC\INC”。第二种选项是使用-i选项,-i选项体现在STD.LNT文件中,每个  
目录前以-I引导,目录间以空格分隔,例如可设成“-IC:\MRI\MCC68K -ID:\LAP\SRC\INC  
”。如果选择使用-I选项,安装程序会接着让你输入包含文件所在的目录。  
11) 如果前面选择了使用多个编译环境,这里将会问你是否选择更多的编译环境,如果选  
YES,将会从第6步开使重复。如果选NO则会结束编译器选择。  
12)接下来将会准备产生一个 反映全局编译信息显示情况的选项文件OPTIONS.LNT,该文  
件的产生方式有两种,一种是安装程序对几个核心选项逐一解释并提问你是否取消该选项  
,如果你选择取消,则会体现在OPTIONS.LNT文件中,具体体现方式是在该类信息编码前加  
-e,后面第13~18步是逐一选择核心选项的过程。如果选择第二种选择方式,安装文件会先  
生成一个空的OPTIONS.LNT文件,等你以后在实际应用时加入必要的选项。  
13)是否关闭赋值时的布尔测试告警,如:if(a=f()){...  
14)是否关闭赋值时的有符号量和无符号量间的不匹配告警,通常情况下,这种赋值不会  
带来问题,选择关闭该告警信息的同时,其他类型的有符号量和无符号量间混合操作的告  
警仍然是打开的。  
15)当把一个整形量赋值给一个比它短的量时,后者会丢失精度,例如把一个INT量赋值给  
给一个CHAR量。本步是让你选择是否关闭该类告警。  
16)是否关闭左移带符号量的告警。通常PC-LINT会对所有带符号量的移动产生告警,但右  
移一般是由不同的CPU来确定是否将符号位移入,左移一般是不会产生什么问题的,所以可  
以选择关闭该告警。  
17)在一个C函数被定义或声明前调用它,并不总是会产生错误,在这里可以选择是否关闭  
该告警选项。该选项对C++程序不起作用。  
18)是否关闭“调用不存在的函数原型”告警。有些程序员不愿遵守严格的函数原形定义  
约定,但PC-LINT会在调用一个没有定义的函数原型时产生一个告警,在这里可以选择关闭  
该告警。  
19)通过上面的步骤确定OPTIONS.LNT文件的形式后,接着是选择编译环境。PC-LINT提供  
了集成在多种开发环境中工作的功能,例如可集成在VC、BC、Source Insight中。假如我  
们在这里选择Source Insight。选择后安装程序会继续问你是否还选择其它的环境,可根  
据自己应用的实际情况选择一种或多种开发环境。开发环境的选择情况记录在env-xxx.ln  
t文件中。  
20)安装程序会生成一个LIN.BAT文件,该文件是运行PC-LINT的批处理文件,为了使该文  
件能在任何路径下运行,安装程序提供了两种方法供你选择。第一种方法是让你选择把LI  
N.BAT拷贝到任何一个PATH目录下,在安装结束运行LCOPY.BAT文件时,会把LIN.BAT拷贝到  
你指定的目录。第二种方法是生成一个LSET.BAT文件,在每次使用PC-LINT前先运行它来设  
置路径,或者把LSET.BAT文件的内容拷贝到AUTOEXEC.BAT文件中。  
21)在安装程序执行完后第一件事是在你安装的目录下执行LCOPY.BAT文件。它会从安装盘  
拷贝将一些文件拷贝到安装目录下,并根据你在安装过程中的选择来设置文件中的参数。

3.LINT 一个C文件  
3.1用命令行方式进行LINT  
如果使用LIN.BAT批处理文件进行LINT,在LINT前要先看一下该批处理文件中的内容,里面  
包含了LINT-NT命令和命令选项,可以根据自己的要求来修改、增减选项。我们看到,在这  
个批命令中嵌套了一个std.lnt文件,在std.lnt文件中还嵌套了co.lnt、options.lnt和l  
ib-stl.lnt文件,原则上*.lnt文件是可以无限制嵌套,该类文件中一般都是了LINT的选项  
,可通过修改这些文件来修改LINT选项,选项是按照从左到右的顺序执行的。可执行下面  
命令行:  
C:\abc\src>lin alpha.c beta.c gamma.c  
通常对于由多个C模块组成的程序,最好先分别对每个C模块单元进行LINT检查,做单元LI  
NT时可如下运行:  
C:\abs\src>lin -u alpha.c  
其中-u是单元选项,使用-u后可以关闭一些检查多模块时会产生的告警,例如“函数未被  
使用”或“函数没有定义”等。  
也可以不使用LIN.BAT批处理文件,而直接使用LINT命令。在DOS环境下LINT命令为LINT.E  
XE,在Windows95/NT环境下为LINT-NT.EXE,在OS2环境下为LINT-OS2.EXE。直接使用LINT  
命令要注意的一点是要在使用前预先设置LINT目录所在路径,最好的方法是把该路径加在  
AUTOEXEC.BAT文件中。其它的使用方法与使用批处理文件相同。例如:  
C:\abs\src>lint-nt -ic:\lint\ std.lnt -os(_lint.tmp) *.c  
3.2用开发环境进行LINT  
也可以使用开发环境来执行LINT操作,一般开发环境都支持运行可执行文件,但不一定支  
持运行批处理文件,下面用Source Insight , Ultra Edit, MSVC 6.0 来举例说明如何在  
开发环境下进行LINT。  
3.2.1 在Source Insight中集成  
如果你在安装过程中选定了使用某个开发环境,安装程序会在你安装的目录下生成一个en  
v-xxx.lnt的文件,例如选择了Source Insight就会有一个env-si.lnt文件。用编辑器打开  
该文件,在该文件开始的注释中说明了如何将PC-LINT功能集成在开发环境中,集成在Sou  
rce Insight中的过程如下:  
1)从Options菜单中选择“Custom Commands”命令项。  
2)在Name栏中输入“PC-lint ”,原则上这个名称可以随便起,只要你能搞清楚它的含义  
就可以了。  
3)在Run栏中输入“c:\lint\lint-nt -u -ic:\lint std env-si %f”其中c:\lint是你P  
C-LINT的安装目录。  
4)在Output栏中选择“Iconic Window”、“Capture Output”。  
5)在Control栏中选择“Save Files First”。  
6)在Source Links in Output栏中选择“Parse Links in Output”、“File,then Lin  
e”。  
7)在Pattern栏中输入“^\([^ ]*\) \([0-9]+\)”。  
8)点Add键加入该命令。如下图:  
9)使用时,在Source Insight下打开要LINT的文件,打开Options菜单中的“Custom Com  
mands”命令项,在“Command”栏中选择“PC-lint unit check”命令运行即可。  
注意到我的Run一栏的参数和上面的提示不一样,其实我的其他古怪参数都放到c:\lint\s  
td.lnt中了。请注意,不论你怎样配置参数一定不要忘记了将si-env.lnt包含在你的配置  
文件里,否则就无法进行错误信息和程序的自动对应了。  
为了使用方便,你还可以配置一下Menu按钮,将它加到系统菜0单里,这属于一般性的  
Source Insight应用,笔者就不在此赘述了。  
第二笔者在NT中使用Source Insight时,好象集成不了,原因暂时不明了。上面的例子在  
WIN 95下测试成功。  
如果要修改LINT选项,可直接在Run栏中修改,也可专门编辑一个*.lnt文件放在c:\lint目  
录下,并将该文件名加入Run栏中,和命令行方式是一样的。  
3.2.2在Ultra Editor中集成  
选取 Menu | Advanced | Tool Configuration ... , 显示如下图:  
1)点按“Insert",  
2)在command line:中填写:c:\lint\lint-nt c:\lint\std.lnt %f  
3)在Menu Item中填写:PC-LINT  
4)在Command Output中选择: (x) Output to List Box 和 (x) Capture Output  
5)点按"OK"  
如图所示的配置笔者在UE6.0 / NT 4.0 下测试成功。  
3.2.3 在MSVC 6.0中集成

//这个好使过
基本原理是一样的:  
1)选取 menu | tools | customize.....  
2)选取 Tools Tab:  
3)点按主对话框上方的虚线小方框 New a tool item  
4)输入 name: PC-LINT  
5)输入 Command: c:\lint\lint-nt.exe  
6)输入 Arguments: c:\lint\std.lnt $(FilePath)   //注:替std.lnt为lnt\env-vc6.lnt
7) 选择 (x) Use Output Window  
8)Close  
完成后,在tools菜单下就会有一项PC-LINT选项。  
下面是笔者在VC6 / Win NT 4.0 的情况下的TOOL配置图:  
3.3LINT选项  
LINT选项可以放在注释中,例如:  
  
//lint option1 option2 ... optional commentary  
选项间要以空格分开,lint命令一定要小写,并且紧跟在 ((x) /o)   
LINT的选项很多共有300多种,大体可分为以下几类:  
1)错误信息禁止选项  
该类选项是用于禁止生成某类错误信息的选项,最常用的是-e和+e,-e是禁止生成某类错  
误信息,+e是恢复生成某类错误信息。运行lint目录下的msg.exe可以得到msg.txt文件,  
这个长达5000行的文件包含了所有的错误信息号和解释。  
-w 对于所有大于级别的告警信息都不显示。  
-wlib()对于所有大于级别的关于库函数数的告警信息都不显示。我们可以用-wlib(0)来屏  
蔽所有的库函数的告警信息,-wlib(1)只显示库函数中的句法错误。  
-esym(#,) 可以屏蔽对于特定符号的某告警信息。  
2)变量类型大小选项  
不同的目标机、编译系统变量类型的的大小(如短整形变量、整形变量等)会有所不同,  
该类选项用于为目标机设置变量类型的大小。由于默认的设置与大部分的编译器是匹配的  
,这些专门的设置通常情况下是不需要的,只在特别的目标机结构中才用。例如一个M680  
00目标机,它的int类型和指针类型通常是32bit的,这时你应该使用选项:-si4  
-sp4。这些尺寸参数的当前值可以通过help屏来获得,例如可以输入以下命令行:  
lin -si4 -sp4 ?  
3)冗长信息选项  
冗长信息指的是LINT过程中产生的一些与编译过程有关的信息,而不是真正的告警信息、  
错误信息等。是否生成这些信息可以通过-v和+v选项来决定。+v是生成这些信息,-v是关  
闭这些信息,这组选项中除+v外,其它所有选项都可以关闭+v选项。  
4)标记选项  
以+f、++f、-f和--f开头的选项是标记选项。他们的逻辑含义分别如下:  
+f...:通过把标志置为1而把它置为ON  
-f...:通过把标志置为0而把它置为OFF  
++f...:标志增1  
--f...:标志减1  
后面两个用于你想在局部把一个标志置为ON的情况,而不影响全局设置。例如你可以这样  
使用:  
  
int printf( );  
  
标记选项的种类很多,基本含义是用于打开或关闭某类语法情况使用,例如允许使用缩写  
结构体名称,允许使用无名联合体,把所有模块当作C++编译等。  
5)消息显示选项  
消息显示选项用于定义消息输出格式。主要有消息高度选项、消息宽度选项、消息格式选  
项等。  
6)其它选项  
其它选项中的种类很多,各种类间差异很大,在这里就不一一介绍了,建议大家看一看《  
PC-LINT》一书,第五章有对每种选项的详细说明。lint本身也有一些说明信息, lint-n  
t 2> lint.txt 然后狂按几个回车就可以生成一个lint选项的说明文件。  
4.LINT一个工程下的多个C文件  
4.1为何要LINT多个C文件  
在程序编码初期,我们关心的可能只是单个C模块种中的语法问题,等到编程后期,对于由  
多个C模块组成的程序,我们希望了解当把多个模块连接在一起后是否还有存在于模块间的  
语法问题。这时编译器虽然能给出一些告警,但PC-LINT的连接能给出更多的告警。还有当  
我们能保证其中的几个模块相对稳定,而另外几个模块仍有问题时可以先将几个稳定的模  
块编译连接成一个目标文件,文件每次修改完成后先单独编译,然后连接入总的目标文件  
。  
4.2如何LINT一个工程下的多个C文件  
象我们平时使用的编译工具一样,PC-LINT在编译连接多个C文件时也会先把每个C文件编译  
生成中间的目标文件*.lob,然后再将所有的LOB文件连接在一起。LOB是Lint Object Mod  
ule的缩写。这个文件中包含了一个C或C++模块的所有外部信息。生成LOB文件时有三种选  
项要注意:第一种是-u,如果要LINT生成LOB文件,就一定要加-u选项;第二种是-zero或  
-zero(500)选项,为了保证LOB文件在模块存在错误的情况下也能生成,就一定要加这个选  
项;第三种是-oo[(filename)],filename是生成的LOB文件的名称,在-oo后面,可加,也  
可不加,如不加,则LOB文件名与原C模块的名称相同,例如:  
lint -u alpha.c -oo(a1)  
生成的LOB文件名为:a1.lob  
lint -u alpha.c -oo  
生成的LOB文件名为:alpha.lob  
LINT一个工程下的多个C模块,在用户的源程序目录下一般需要三个文件: 一个选项文件  
(*.lnt)、一个批处理文件(*.bat)和一个MAKEFILE文件(*.mak)。下面一一讲述如何  
制作这些文件。  
1)选项文件(*.lnt)  
选项文件在前面也提到过,你可以把你LINT每个C文件时时用到的所有公共选项罗列在该文  
件中,选项生效的顺序按照从左到右,从上到下的原则。该类文件可以层层嵌套,嵌套的  
层数没有限制。例如make.lnt文件:  
-iC:\lint  
std.lnt  
+os(temp)  
-e46  
+vm  
-zero  
2)批处理文件(*.bat)  
制作批处理文件时要注意要在该文件中调用TCMAKE.EXE文件和MAKEFILE文件,例如lintma  
ke.mak文件:  
@echo Lint Making 'makelap':  
tcmake -flintmake.mak  
@echo End of making  
3)MAKEFILE文件(*.mak)  
MAKEFILE使用的TCMAKE的语法,和我们平时开发编译时使用的MAKEFILE文件语法格式一样  
,例如下面的lintmake.mak文件:  
MCCPATH = c:\mcc68k  
OPTION = -u make.lnt -oo  
GLOBLE = os.h l2lap.h  
mail_depend = $(GLOBLE) q931.h mail.h  
lapmain_depend = $(GLOBLE) l1pubdef.h q931.h mail.h  
lapos_depend = $(GLOBLE)  
fhdlc1_depend = $(GLOBLE) cpuhdlc.h bd_prar.h q931.h  
OBJ = mail.lob lapmain.lob lapos.lob fhdlc1.lob  
project.lob : $(OBJ)  
lint-nt make.lnt -e768 -e769 *.lob  
mail.lob: mail.c $(mail_depend)  
lint-nt $(OPTION) mail.c  
lapmain.lob: lapmain.c $(lapmain_depend)  
lint-nt $(OPTION) lapmain.c  
lapos.lob: lapos.c $(lapos_depend)  
lint-nt $(OPTION) lapos.c  
fhdlc1.lob: fhdlc1.c $(fhdlc1_depend)  
lint-nt $(OPTION) fhdlc1.c  
4.3简单的LINT多个文件  
假设我们的工程不复杂,我们可以负担起每次都将所有的文件都lint一遍的开销,也可以  
不使用上面的正规用法。笔者在实践中发现,将所有的*.c文件放在一个lint命令中,同样  
能完成lint整个工程的目的。  
如:  
lint-nt c:\lint\std.lnt AllMySource.lnt  
在AllMySource.lnt中包括你的工程中的所有源文件:  
a1.c  
a2.c  
a3.c  
需要注意的是,在std.lnt文件中就不需要-u选项了。因为我们已经提供了所有的信息

作者:wdy9927
发表时间:2004-11-25 18:56:49

下载链接

http://amine.nease.net/down/pclint.zip

http://xyzboard.com/xyz_soft/PC.Lint.v8.00e.zip

原文:http://harrisonhuanglin.spaces.live.com/blog/cns!6EEDA08E2A9C506D!158.entry