符号文件——Windows 应用程序调试必备

一、何谓符号文件？

　　符号文件（Symbol Files）是一个数据信息文件，它包含了应用程序二进制文件（比如：EXE、DLL等）调试信息，专门用来作调试之用，最终生成的可执行文件在运行时并 不需要这个符号文件，但你的程序中所有的变量信息都记录在这个文件中。所以调试应用程序时，这个文件是非常重要的。用 Visual C++ 和 WinDbg 调试程序时都要用到这个文件。
　　在 Windows 系统中，符号文件以 .pdb 为扩展名，比如：每个 Windows 操作系统下有一个 GDI32.dll 文件，编译器在编译该 DLL 的时候会产生一个 GDI32.pdb 文件，一旦你拥有了这个 PDB 文件，那么便可以用它来调试并跟踪到 GDI32.dll 内部。该文件和二进制文件的编译版本密切相关，比如修改了 DLL 的输出函数，再编译该 DLL，那么原先的 PDB 文件就过时了，不能再用老的 PDB 文件来做调试工作,而必须使用最新的 PDB 文件版本。
　　Visual C++ 编译代码后会在 Debug 或者 Release 目录下生成一个 PDB 文件。一般情况下，符号文件包括以下的数据信息：

1. 全局变量（Global variables）；
2. 局部变量（Local variables）；
3. 函数名和它们的入口地址（Function names and the addresses of their entry points）；
4. FPO 数据（Frame Pointer Omission)：Frame Pointer 是一种用来在调用堆栈（Call stack）中找到下一个将要被调用的函数的数据结构源代码的行序号（Source-line numbers）；

二、如何得到和安装符号文件?

1. 先确定你的操作系统（OS）版本；
2. 到微软网站下载相应的符号文件；
3. 安装符号文件，对于符号文件的安装位置没有特贝要求，可以安装在任何目录中；
4. 设置环境变量，使得调试工具（比如：Visual C++、WinDbg、Ntsd、DrWatson 等）能找到符号文件；

安装符号文件的注意事项：

　　如果是手动安装符号文件，有一点很重要，那就是宿主机（Hostt Computer）上的符号文件必须与目标机器（Target Computer）上的 Windows 版本相匹配。
　　这里所谓的宿主机指的是运行调试会话的机器，在典型的双系统调试会话环境中，宿主机可以是连接到目标机器的任何机器。目标机器指的是发生软件组件、系 统服务、应用程序或操作系统运行失败的机器。也即是需要被调试的机器，它是调试会话关注的焦点。目标机器可以近在咫尺，也可以位于完全不同的地方。有时我 们也将目标机器称之为——被调试者（debuggee），那么与之对应，宿主机则可以称为调试者（debugger）。

三、在 Visual C++ 使用符号文件的方法

在 Visual C++ 6.0 中的使用方法：

1. 打开 Visual C++ 6.0 的 Workspace 文件（*.dsw）；
2. 进入 Tools 菜单，选择 Options 菜单项 (Tools->Options)；
3. 单击 Directoties 标签；
4. 在 “Show directories for”下拉列表中选择 “Executable files”；
5. 将符号文件的路径添加到 “Directories” 路径列表中；
6. 单击  OK 完成；

在 Visual C++ .NET 2003 中的使用方法：

1. 打开 Visual C++ .NET 的项目文件（*.vcproj）；
2. 在解决方案管理器中选中要使用符号文件的项目；
3. 单击右键进入项目属性对话框；
4. 选择“配置属性”中的“调试”；
5. 在与“调试”对应的“操作”选项中有一个“符号路径”，在此添加符号文件的路径即可；
6. 单击  “确定” 完成；

四、如何产生 Release 版本二进制文件对应的 PDB 文件?

在 Visual C++ 6.0 中的方法：

1. 打开 Visual C++ 6.0 的 Workspace 文件（*.dsw）；
2. 进入 Project 菜单，选择 Settings 菜单项 (Project->Settings)，打开项目设置对话框；
3. 在 “Settings for”列表中选择项目的 Release 配置；
4. 单击“C/C++”标签；
5. 在“Category”下拉列表框中选择“General”选项；
6. 在“Debug info”下拉列表框中选择调试信息格式（具体选项参见图一），在此不必禁用任何优化选项；
7. 单击“Link”标签；
8. 在“Category”下拉列表框中选择“Debug”选项；
9. 选中“Debug info”复选框，然后选择需要的链接调试类型（具体选项参见图一）；
10. 不要选择“Separate types”复选框；
11. 在“Project options”编辑框的最后添加如下指令：/opt:ref,icf；
12. 重新生成（Rebuild）项目；

在 Visual C++ .NET 2003 中的方法：

1. 打开 Visual C++ .NET 的项目文件（*.vcproj）；
2. 进入 Project 菜单，选择 Settings 菜单项 (Project->Settings)，打开项目设置对话框；
3. 在 “配置”下拉列表中选择项目的 “（活动）Release” 配置；
4. 选择“配置属性”树型节点中的“C/C++” ==〉“常规”；
5. 设置右边的“调试信息格式”选项（具体选项参见图一）；
6. 选择“配置属性”树型节点中的“链接器”==〉“调试”；
7. 设置右边的“生成程序数据库文件”（具体选项参见图一）；
8. 选择“配置属性”树型节点中的“链接器”==〉“命令行”；
9. 在“附加选项(D)”编辑框中添加如下指令：/opt:ref,icf；
10. 按“确定”退出；
11. 重新生成（Rebuild）项目；

图一

五、关于 Free Build（也称 Retail Build）和 Checked Build（也称 Debug Build）

每个基于 NT 操作系统有两种不同的程序生成模式，即：

• Free Build (或 Retail Build)
• Checked Build (或 Debug Build)

　　Free Build 生成的是最终用户版本，针对生成的二进制文件进行了彻底的优化，禁用了调试断言，并剥离了调试信息。这样一来使可执行程序文件更小，加载更快，使用的内存也更小。
　　Checked Build 生成的是测试和调试版本。它包含额外的 Free Build 所没有的错误检查，参数验证和调试信息，Checked Build 有助于隔离和跟踪可能导致不可预见的行为的问题，比如内存溢出，不正确的设备配置。虽然 Checked Build 提供了额外的保护，但与 Free Build 比较，它需要更多的内存开销和磁盘空间。由于可执行程序包含符号调试信息；调试时要执行附加的代码、参数检查和输出调试诊断信息，从而导致性能下降。

六、系统符号文件的更新方法

　　系统符号文件指 Windows 操作系统依赖的那几个重要的 DLL/SYS 和可执行文件对应的符号文件，常见的比如：gdi32.dll、Kernel32.dll、Kerberos.dll、psapi.dll、user32.dll等，使用 WinDbg 调试时，你就会发现系统符号文件(PDB)有多重要，这些文件都与本地的 OS 密切相关，比如，Windows 2000 打了SP补丁的话，那么必须更新系统符号文件才能进行相关调试，原来的符号文件与打补丁后的系统就会不匹配，怎么办呢? 可以通过网络来更新！象下面这样在 WinDbg 的 Symbols Path 里面输入路径：

SRV*D:\Symbols\websymbols*

http://msdl.microsoft.com/download/symbols

（斜体部分是你在本地保存符号文件的路径）

　　如果你不是通过代理上网，那么在你用 WinDbg 打开一个被调试程序后，输入 symchk 回车，WinDbg 就会自动的连到微软的网站根据你的机器的情况更新的 PDB 文件，并将它保存在上面斜体部分指定的本地路径里，这样你就可以确保你的符号文件版本和你机器上的文件版本一致。

如果你是通过代理上网那么你需要配置 IE 的连接设置。具体方法恕不赘言。