PGRelief使用指南2014（windows版）

1 PGRelief的安装 

硬件方面:CPU：Intel系列的在PIII 1G或者以上即可；SPARC的在300MHZ以上的

即可。内存：推荐为1G以上内存。

软件方面:目前GUI版本的PgRelief可以运行在如下软件平台：

Windows2000/XP 日文版本

Redhat Linux 7.3/9.0 日文版本

Solaris 7/8/9 日文版

2 PGRelief界面版的使用 

使用PGRelief进行静态分析的过程基本分为四步:创建分析项目、配置分析选项、进行分析、查看分析结果  。

2.1 创建分析项目

创建新项目 ：点击主文件 ->新建项目

设置项目信息

包括如下内容：

设置项目名

设置项目文件存放路径

说明项目概要信息

选择分析对象代码 （选择要对哪些源代码进行解析。目前PgRelief只支持对C/C++代码的检查）

2.2 配置分析选项

配置分析选项是整个分析过程中比较困难和麻烦的一步，只有配置正确，才能使PGRelief正确分析代码。

其中，必须要设置编译、宏定义、头文件路径。

2.2.1 设置编译器

由于不同的编译器以及不同的操作系统对 C/C++语言中的一些细节行为的处理是不同

的，因此必须根据被分析代码原先的开发环境（操作系统和编译器），在PGRelief中选择相

应的编译器选项。

2.2.2宏设置

在这里可以定义或者取消定义一些宏，如下图所示：

一般而言这里是不需要特别进行设置的，但是如果在编译程序时定义了一些

影响到程序编译的重要的宏，则需要在这里加以定义，如在linux下makefile

里面定义的宏。

2.2.3标准头文件和用户自定义头文件

用户自定义头文件 :用户头文件目录的设定 ，是需要用户自己手动添加：当前解析的cpp 或者c 文件，所要用到的所有的用户自定义的头文件的路径。注意，不能有遗漏。

标准头文件 :标准头文件目录的设定类似于用户头文件目录的设定，是需要用户自己手动添加：当前

解析的cpp 或者c 文件，所要用到的所有的标准库的头文件的路径。注意，不能有遗漏，并且要有先后次序。

2.2.4 其它

除了以上三项是必须之外，剩下的选项是可选的。用户可以根据自身的要求，并结合帮助

文档，进行更加详细的，符合自己要求的设置。

2.3 进行分析

分析的步骤

在完成对分析选项的配置后，就可以开始进行解析了。 对一个项目的解析包括两个阶段：

单文件分析(在这个阶段会逐个对项目中的每个文件进行分析);文件间分析(在所有文件的单文件分析都完成的情况下，将所有文件的全局信息连接起来进行分析)。

分析的方式

用户可以选择多种方式进行解析：

全体解析 ：对当前项目下所有文件进行解析，包括单文件分析和文件间分析

选择解析 ：对选定的一个或者多个文件进行解析，此时仅仅进行单文件分析

差分解析 ：对项目中所有还没有分析的文件进行分析，并最后执行文件间分析。

分析错误的解决

一般来说，文件分析中断主要是由头文件找不到或者源文件不符合C/C++标准导致的。根据

我们的经验，总结了以下几种错误情况：

注意：由于头文件配置错误引起的中断，需要重新配置头文件。

2.3.4 其它解析操作

保存解析信息 ：参见下图：

2.4 查看分析结果

可以通过以下2种方式查看指摘信息：根据指摘号来查看指摘信息；根据指摘出现的文件来查看指摘信息。

其它操作：

查看指摘的源文件处 ：选中一条指摘信息 --> 点击主菜单 打开pgr浏览，系统会自动定位到指摘的位置

3 PGRelief命令行的使用

3.1 配置分析选项

3.1.1设置编译器

-K

指定编译器。

用法：

pgr -K GNU/GCC3 a.cc

[支持的编译器一览]

3.1.2宏设置

-D macro

指定宏

用法：

pgr -D macro a.cc

效果：

相当于，在a.cc开头写了  #define macro 1

-D mac=value

指定宏

用法：(注意mac=value不能有空格，value可以使任意值)

pgr -D mac=value a.cc

-U macro

指定系统宏。

用法：

pgr -U __LINE__ a.cc

选项的参数：

__LINE__, __FILE__, __TIME__, __DATE__, __STDC__等

C++ __cplusplus

C99  _STDC_HOSTED__, __STDC_VERSION__

3.1.3标准头文件和用户自定义头文件

-I

设置自定义头文件的查找路径

用法：

pgr -I path a.cc

注意：path最好是头文件全路径，或是正确的相对路径。是文件夹，别搞错。

-Y

设置标准头文件的查找途径

pgr -Y path a.cc

4 常见问题

4.1 分析错误的解决

一般来说，文件分析中断主要是由头文件找不到或者源文件不符合C/C++标准导致的。根据

我们的经验，总结了以下几种错误情况：