========================================================================
* IBM(R) IBM Debugger for AIX, Version 6.1
* (C) COPYRIGHT International Business Machines Corp. 2006, 2008
* All Rights Reserved
* Licensed Materials - Property of IBM
*
* US Government Users Restricted Rights - Use, duplication or
* disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
* AIX and IBM are trademarks of IBM Corp.
*
* Other company, product, and service names may be trademarks or service
* marks of others.
========================================================================

IBM Debugger for AIX V6.1 支持对 AIX V5 上运行的 C/C++ 应用程序进行本地调试和远程调试。对于在 AIX 机器上运行的应用程序，您可以通过同一台机器上运行的调试器用户界面进行调试，也可以从另一台 AIX 或 Windows 机器以远程方式进行调试。

本文档包含下列部分：

• 必备软件
• 安装 IBM Debugger for AIX
• 卸载 IBM Debugger for AIX
• IBM Debugger for AIX V6.1 的新增内容
• 启动调试会话
• 访问 IBM Debugger for AIX 文档
• IBM Debugger for AIX 局限性

必备软件

AIX 客户机安装

AIX 客户机需要 AIX V5.2（AIX 5200-07 或更新版本）或 AIX V5.3（AIX 5300-03 或更新版本）。

要测试此安装平台是否受支持，请在系统提示符处输入 lscfg -p | fgrep Architecture。您应该会接收到应答 Model Architecture: chrp。仅共用硬件参考平台（chrp）系统受支持。

仅当硬件或操作系统中存在相应的功能部件时，才支持对下列功能部件进行调试：

• 线程本地存储器（TLS）
• 十进制浮点（DFP）
• 向量类型
• POWER5 和 POWER6 硬件功能部件

安装 IBM Debugger for AIX

如果在安装 XL C/C++ 编译器时安装了所有文件集，如“IBM XL C/C++ Enterprise Edition for AIX V9.0 Installation Guide”中的缺省安装过程所述，则所有用于 AIX 的 IBM Debugger 组件（客户机和引擎）均已安装。

如果在安装 XL C/C++ 编译器时未安装所有文件集或已使用非缺省安装过程，则将需要单独安装用于 AIX 的 IBM Debugger 组件。有关指示信息，请参阅以下“安装用于 AIX 的调试引擎（irmtdbgc）和用户界面客户机（idebug）”。

如果要在 Windows 上使用 IBM Debugger 用户界面客户机，则需要遵循以下“安装用于 Windows 的用户界面客户机（idebug）”中的过程。

如果要安装完整产品版本，但不安装临时修订，则建议您卸载所有先前版本的 IBM Debugger，然后再安装此版本的 IBM Debugger for AIX（请参阅卸载 IBM Debugger for AIX）。

安装用于 AIX 的调试引擎（irmtdbgc）和用户界面客户机（idebug）

IBM Debugger for AIX 已打包在下列文件集中：

要在 AIX 上安装 IBM Debugger 组件和系统当前支持的相应消息文件集，请发出下列命令：

installp -aXgd . -e /tmp/ibmdebugger.install.log ibmdebugger*

安装用于 Windows 的用户界面客户机（idebug）

要安装用于 Windows 的用户界面客户机，请执行以下操作：

1. 打开命令提示符，然后浏览至产品 CD 上的 IBMdebugger\windows\ 目录。
2. 运行产品 CD 上的程序 IBMdebugger\windows\setup.exe，然后遵循屏幕上的提示来安装用户界面客户机。

卸载 IBM Debugger for AIX

在 Windows 上进行卸载

要在 Windows 上卸载 IBM Debugger for AIX 客户机，打开 Windows 控制面板，然后选择添加或删除程序。找到并选择 IBM Debugger for AIX。单击删除以开始执行卸载过程。

如果卸载失败，则可以执行下列步骤以手工启动卸载程序：

1. 打开命令提示符。
2. 使用 cd 命令将目录更改为 IBM Debugger for AIX 安装目录。缺省安装目录为 C:\Program Files\IBM\IBM Debugger for AIX。
3. 使用 cd 命令将目录更改为 _jvm\bin。
4. 输入下列命令：java -jar ..\..\_uninst\uninstall.jar
5. 卸载程序将启动。

在 AIX 上进行卸载

要在 AIX 上卸载 IBM Debugger for AIX 引擎/客户机，请以 root 用户身份登录，然后发出以下命令：

installp -u ibmdebugger*

IBM Debugger for AIX V6.1 的新增内容

• 支持以下各项：
  • POWER6 硬件
  • AltiVec 寄存器
  • 十进制浮点（DFP）
  • 线程本地存储器
• 局部变量过滤
• 允许您以有针对性的方式显示 C++ 对象内容的 show_self 函数
• 对具有 C 链接的函数进行 C/C++ 函数求值
• 对赋值表达式进行表达式求值
• 支持单行聚集显示
• 在 C/C++ 源代码中支持本地语言字符
• 支持强制转换为模板类型
• 对监控局部变量进行了改善
• 新的“调试控制台”视图（仅限于技术预览）

启动调试会话

在调试程序之前，确保已通过使用 -g 编译器选项，根据调试信息编译程序。

要启动调试会话，首先在本地或远程 AIX 机器或远程 Windows 机器上启动 IBM Debugger 客户机。然后以本地或远程方式启动调试会话。

启动 IBM Debugger 客户机

要在 Windows 上启动 IBM Debugger 客户机，请转至 Windows 的“开始”菜单，然后选择程序 > IBM > IBM Debugger for AIX > IBM Debugger for AIX。

要在 AIX 上启动 IBM Debugger 客户机，请执行 idebug 命令。在多用户环境中，多个用户在同一台 AIX 机器上运行用户界面客户机，每个用户必须选择唯一的守护程序端口号。为此，请在用户界面客户机中指定守护程序端口范围：

1. 启动用户界面客户机。
2. 单击“调试”视图中守护程序图标旁边的向下箭头。
3. 输入用户界面客户机可以尝试使用的端口范围（例如，输入 8001-8009 的范围）。
4. 用户界面客户机将使用该范围中第一个可用的端口。
5. 如果调试引擎通过用户界面客户机启动，则它将使用该用户界面客户机找到的可用端口。
6. 如果您直接启动调试引擎，则必须指定用户界面客户机获得的端口。

启动 IBM Debugger 引擎

要以本地方式调试程序，可以从 AIX 客户机或命令行启动引擎。要以远程方式调试程序，您必须从 AIX 命令行启动引擎。

要从 AIX 客户机启动引擎（仅限于本地调试），请执行以下操作：

1. 从 AIX 客户机中选择文件 -> 新建启动 -> 装入程序。
2. 提供必要的信息以找到并启动程序。您必须至少指定可执行文件的名称。如果在当前 PATH 环境变量中找不到该程序，则还应该指定指向该程序的完整路径。

将装入应用程序，并且在 main() 处暂停执行。

要从命令行启动引擎（本地或远程调试），请执行下列命令：

irmtdbgc [-qhost=<hostname>:<uidaemonport>] <executable><executable parameters>

其中：

• <uidaemonport> 是在守护程序首选项中指定的客户机上的 TCP/IP 端口号。缺省守护程序端口号是 8001。为引擎指定的端口必须是用户界面正在侦听的其中一个端口。
• -qhost=<hostname> 是正在运行客户机的主机的名称。如果该客户机正在同一台机器上运行，或者您已使用 DER_DBG_ADDR 环境变量指定客户机和端口，则可以忽略此选项（请参阅 IBM Debugger for AIX 局限性的调试器引擎部分）。
• <executable> 是指向您要调试的程序的完整路径。
• <executable parameters> 是传递给您要调试的程序的参数。

然后，该引擎将连接至客户机、装入您的程序，并在到达 main() 时暂停执行。

访问 IBM Debugger for AIX 文档

可从 IBM Debugger 客户机启动的联机信息中心获取 IBM Debugger for AIX 的完整文档。

要查看帮助系统：从 Windows 或 AIX 客户机中选择帮助 > 帮助内容。

IBM Debugger for AIX 局限性

一般局限性：

• 当通过 Windows 客户机应用临时修订时，如果将当前配置替换为另一个配置，则会将一个未捕获的 SWT 异常写入日志文件。您可以忽略此异常，并继续安全地使用具有被替换配置的工作台。
• 当使用 AIX 客户机且在“内存”视图中添加呈示时，该呈示可能不会定位至内存块的基地址。要解决此问题，请在呈示中单击鼠标右键，然后选择复位至基地址。这将使呈示转至内存块的基地址。
• 当使用 AIX 客户机时，如果您的路径上存在不能正常工作的 Web 浏览器，则帮助系统可能会启动失败。要确保帮助系统正常运转，请从路径中除去不能正常工作的 Web 浏览器。
• IBM Debugger for AIX 不支持将程序名作为参数传递至 idebug 命令。

调试器引擎：

• 不推荐使用 DER_DBG_PORT 调试引擎环境变量。主机地址和端口应指定为 DER_DBG_ADDR=host:port。
• 不推荐使用 DER_DBG_DEEP_STEP_DEBUG 环境变量。此环境变量已替换为 DER_DBG_STEP_DEBUG = [SHALLOW | DEEP] [INCLUDE | NOINCLUDE]，其中：
  • SHALLOW 或 DEEP 控制 step-debug 功能是仅检查即时子例程以获取调试信息（SHALLOW），还是继续执行调试直至找到带有调试信息的位置为止（DEEP）。缺省值为 SHALLOW。如果具有大量没有调试信息的代码，则深层 step-debug 可能会较慢。
  • INCLUDE 或 NO_INCLUDE 确定包含文件中的代码在您执行 step-debug 时是否被视为具有调试信息。缺省值为 INCLUDE。
• 已添加下列环境变量：
  • DER_DBG_BACKGROUND_READ － 缺省值为 YES。将此变量设置为 NO 将阻止调试器在处于空闲状态时读取调试信息。对于调试数据量极大的应用程序，可能有必要将此变量设置为 NO 以阻止调试器用尽堆空间。
  • DER_DBG_POWER_STEP － 如果设置为 Y 或 YES，则调试器将在单步执行时忽略断点。缺省设置为 NO。
  • DER_DBG_CICS_STEP － 这是在 CICS 中调试时将要使用的特殊环境变量。它使调试器在调试通过 CICS 调用例程的代码时正常地执行单步调试。
• DER_DBG_ NO_LIBPTHDEBUG 环境变量不再受支持。

文档信息中心

• HTTP Status 500 错误或帮助搜索结果中的可视 HTML 代码：如果您在“帮助”窗口（帮助 > 帮助内容）中搜索联机文档并遇到以下某个问题：
  • HTTP Status 500 错误，其描述为“服务器遇到内部错误（），因此无法完成此请求。”
  • 搜索结果列表的顶部或底部有可视的 HTML 标记，例如，<a class="link" id="a113" href="...
  尝试在“动态帮助”视图中再次运行同一搜索：单击帮助 > 动态帮助或选择键盘 F1 键，然后单击视图底部的“搜索”链接。“动态帮助”搜索将在“本地帮助”类别下显示结果。
• 单击帮助搜索结果将显示 XML 代码：如果在“帮助”窗口（帮助 > 帮助内容）中搜索联机文档并单击某个结果，而内容框架显示 XML 源文件而不是可读的内容，则在“动态帮助”视图中再次运行该搜索。请单击帮助 > 动态帮助，然后单击视图底部的“搜索”链接。将在“本地帮助”的折叠标记下显示动态帮助搜索的结果。如果已选择显示结果类别按钮，则您所查找的结果将显示在只能在“动态帮助”视图中正确显示的类别中，例如“欢迎”类别。

本地语言局限性：

• 使用 irmtdbgc 命令，您无法装入其名称或参数包括具有 255 个以上的 UCS 代码点的字符的程序。通过 AIX 客户机文件 > 新建启动 > 装入程序操作，可以在本地装入此类程序。
• 双向（BIDI/BiDi）语言局限性：
  • “调试器”编辑器、“变量”视图、“监视器”视图和“内存”视图可能会不正确地显示由 BIDI 字符和数字组成的字词。该字词中的这些数字和 BIDI 字符的位置可能是错误的。
  • 当使用 CP420 时，Arabic Lam Aleph（或 Lam Alef）字符未正确显示在“内存”视图的 EBCDIC 呈示中。您可以使用 CP420S。
  • 如果末尾字符周围没有空格，则编辑字符串变量以便它包含具有末尾字符的阿拉伯字符时可能无法正确设置该值。末尾字符可能会丢失。
  • 无法在“变量”视图、“监视器”视图和“内存”视图中的“编辑”字段中输入印地语数字。
• 已作为临时修订的结果添加至产品的用户界面文本只限于英文。