七、 Purify的退出码
像UNIX下的软件,一般都会提供和别的应用程序的接口,像上面的生成文本文件,也是给别的应用程序提供接口的一种方式。这里,我们所要讲述的是Purify的退出码,我们知道程序都有退出码,以提供给别的程序或操作系统自己运行的信息。被Purify编译过的程序,你可以通过指定-exit-status参数来告诉Purify是否用Purify的退出码,如果这个参数值为yes,那么表示使用Purify的退出码,如果值为no则表示使用程序内的退出码。
如果我们这样设置:-exit-status=yes,那么Purify的退出码是这样定义的:
内存错误种类
退出码(按位或)
内存存取错误
0x40
内存泄露
0x20
潜在内存泄露
0x10
通过上表,我们可以知道,当-exit-status参数被打开后,程序的退出码被Purify完全接管,如果程序中有内存错误,那么退出码所对应的位就会被置为1,这样,我们可以用别的程序来调用Purify所编译出来的程序,并根据其退出码作相应的处理。
八、 Purify和Shell的集成
你可以在UNIX的Shell环境中使用Purify的一些参数和信息,Purify为Shell提供了一些通配符之类的东西,只要你使用 –run-at-exit参数。例如你有一个Shell程序想把Purify生的文件拷贝到别的目录中,或是你想根据Purify的报告中是否有内存错误进行下一步的行动。
下面有两个表格,说明了一些Purify和Shell交互的参数:
有关内存出错的信息:
通配字符串
含义
%z
指明是否有内存错误或内存泄露。其值是“true”或“false”
%x
程序的退出状态(如果是0,表示程序没有调用exit函数)
%e
程序中内存访问错误的个数。
%E
程序中错误总数。
%l
内存泄露的字节数。
%L
潜在内存泄露的字节数。
有关程序运行的信息:
通配字符串
含义
%V
运行程序的全路径(“/”被替换成了“_”)
%v
程序的名称
%p
程序的进行ID
在使用Purify过程中,有两种方法可以传递Purify的参数,一种就是在命令行上指明。另外一种是设置一个和Purify相关的环境变量:PURIFYOPTIONS。现在,我通过这个环境变量要举一个例子,以说明上面表格中的参数在使用中的情况:
例如,如果我们这样这置环境变量:(在C-Shell中)
setenv PURIFYOPTIONS '-run-at-exit="if %z ; then \
echo \"%v: %e errors, %l+%L bytes leaked.\" ; fi"'
当我们运行被Purify编译过的程序后,会出现以下结果:
hello: 2 errors, 1+10 bytes leaked.
我们可以看到,由于hello程序出错了,所以%z为“true”,所以Purify执行echo命令,其中,%v表示了程序名(hello),%e表示了错误的个数(2),%l表示了内存泄露的字节数(1),%L表示了程序中有潜在可能的内存泄露字节数(12)。
让我们再来看两个例子:
示例一:
指定Purify的参数为: -log-file=./%v.plog
示例二:
指定Purify的参数为: -view-file=/home/hchen/%V.pv
总这,这些有“%”的变量,都是Purify提供给操作系统Shell的,以供Shell编程使用的。
九、 过滤Purify的报告信息
如果你的程序比较大,模块也比较多,有时候出现的信息非常的多,你程序中很可能有某段代码产生了若干个内存错误,所以,我们可以使用Purify的过滤器来让Purify只显示某一种类的信息,这样方便我们进行问题的查找和排错。
1、 在Purify的X-Window中设置信息过滤,点击图形界面中的菜单“Options” -–> “Suppressions”,将出现“Suppressions”对话框,如下所示:
我们可以看到在上面的对话框中,如果过滤Purify的报告信息。当我们点击“Where to suppress”只要,我们会看到有如下的五个选项:
l In Call Chain:表示在某个函数调用链中信息。
l In File:表示只报告在某个文件中的信息。
l In Library:表示只报告在某个LIB文件中的信息。
l In Class:这是C++的,表示报告某个类的信息。
l Everywhere:表示全部范围内的信息。
但是图形界面中,Purify并没有给我们提供一个选取文件或LIB或类的对话框,我们只能通过其文本语法来描述,接下来就让我们来看一看,过滤Purify报告信息的文本语法。
2、 我们可以使用Purify的过滤语法来要求Purify的过滤信息。并把其存于.purify文件中,这样当我们的Purify起动后载入这个文件,就可以达到过滤信息的目的了。通过文本语法来设置过滤信息比图形界有更为强大的地方。下面还是来看看suppress的语法:
语法:
suppress <message-type> <function-call-chain>
unsuppress <message-type> <function-call-chain>
其中,suppress和unsuppress中关键字,分别表示过滤或不过滤。<message-type>指明要操作的消息,可以使用“*”做通配符,<function-call-chain>表示函数的调用链,调用的函数链用分号分隔,其同样可以使用“*”做通配符,还可以使用“…”来表示无论中间是什么。
还是来看几个示例吧:
1) suppress AB*
表示过滤ABR和ABW错误。
2) suppress *W
表示过滤ABW、FMW、IPW、NPW、SBW、WPW和ZPW错误。
3) suppress ABR “libc*”
表示在所有以libc打头的LIB文件中过滤ABR信息。
4) suppress ABR sortFunction; sort*; qsort; “libc*”
其表示,过滤ABR错误。过滤范围是在sortFunction中,并且是在以libc开头的函数库文件中,其调用链是qsort -> sort* -> sortFunction。换言之,只要有“libc*”文件中的函数调用了qsort,并且qsort调用了开头为sort*的函数,并且这些函数调用了sortFunction,那么,在这一个函数链中,不显示ABR错误信息。
5) suppress UMR tzsetWall;…; main
其表示,在tzsetWall函数中过滤URM信息,只要tzsetWall函数是被main函数间接调用的,无论有多远,都不显示UMR信息。
6) suppress FNH Test: :Test
这是C++中使用的语法,表示在类Test所有的构造函数中过滤FNH信息。如果要指明特定的函数,请加上其参数类型,如:suppress FNH Test::Test(const char*)。
注意,“…”语法表示调用链无论有多远。当然,如果你设置了参数“-chain-length=6”,那么,“…”只能到6层函数调用,7层的就不管了。
在启动Purify时,我们可以这样来读取.purify文件:
% purify -suppression-file-names=".purify,.purify.sunos4,\
$HOME/purify_suppressions"
Purify会在下面的目录中寻找这个文件:
<purifyhome>/.purify
<purifyhome>/.purify.sunos4
$HOME/.purify
$HOME/.purify.sunos4
<progdir>/.purify
<progdir>/.purify.sunos4
$HOME/purify_suppressions
<-上一页 下一页->
(版权所有,转载时请注明作者和出处)
本文地址:http://com.8s8s.com/it/it37445.htm