C/C++内存问题检查利器—Purify （四）
七、 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
