<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>

<!-- ========================================================================
* 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.
======================================================================== -->

<head>
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>自述文件 － IBM Debugger for AIX V6.1</title>
</head>

<body link="blue" vlink="purple">
<p>
========================================================================<br>
* IBM(R) IBM Debugger for AIX, Version 6.1                              <br>
* (C) COPYRIGHT International Business Machines Corp. 2006, 2008        <br>
* All Rights Reserved                                                   <br>
* Licensed Materials - Property of IBM                                  <br>
*                                                                       <br>
* US Government Users Restricted Rights - Use, duplication or           <br>
* disclosure restricted by GSA ADP Schedule Contract with IBM Corp.     <br>
* AIX and IBM are trademarks of IBM Corp.                               <br>
*                                                                       <br>
* Other company, product, and service names may be trademarks or service<br>
* marks of others.                                                      <br>
========================================================================</p>
<table summary="自述文件" border="0" cellspacing="5" cellpadding="2" width="100%">
  <tr>
    <td align="left" valign="middle" colspan="1" bgcolor="#C5CEF5">
      <strong>自述文件 － IBM Debugger for AIX V6.1</strong>
    </td>
  </tr>
</table>

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

<table summary="自述文件" border="0" cellspacing="5" cellpadding="2" width="100%">
  <tr>
    <td align="left" valign="middle" colspan="1" bgcolor="#C5CEF5">
      <p>IBM Debugger for AIX 包含两个组件：</p>

      <ol>
        <li>可用于控制和调试 AIX V5 上的 C/C++ 应用程序的 AIX 调试引擎程序（irmtdbgc）。调试引擎与要调试的应用程序在同一台机器上运行。在调试控制下，调试引擎与应用程序进行交互。</li>
        <li>与引擎通信且允许您调试应用程序的用户界面客户机（idebug）。提供了同时适用于 AIX 和 Windows 的 idebug 版本。用户界面客户机可以与调试引擎在同一台 AIX 机器上运行。</li>
      </ol>
    </td>
  </tr>
</table>

<p>本文档包含下列部分：</p>

<ul>
  <li><a href="#prerequisite">必备软件</a></li>
  <li><a href="#install_debug">安装 IBM Debugger for AIX</a></li>
  <!-- <li><a href="#install_fix">Installing Interim Fixes</a></li> -->
  <li><a href="#uninstall">卸载 IBM Debugger for AIX</a></li>
  <li><a href="#v6_features">IBM Debugger for AIX V6.1 的新增内容</a></li>
  <li><a href="#start">启动调试会话</a></li>
  <li><a href="#docs">访问 IBM Debugger for AIX 文档</a></li>
  <li><a href="#limitations">IBM Debugger for AIX 局限性</a></li>
</ul>

<h2><a name="prerequisite">必备软件</a></h2>

<h3>AIX 客户机安装</h3>

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

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

<!-- <p>If you are applying an Interim Fix, you must have IBM Debugger for AIX v6.1 installed.</p>

<p>Interim Fixes are cumulative in nature. Applying an Interim Fix on an AIX client will include everything delivered by the previous Interim Fix for this release.</p> -->

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

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

<!-- <h3>Windows client installation</h3>

<p>If you are applying an Interim Fix, you must have IBM Debugger for AIX v6.1 installed.</p>

<p>Interim Fixes are cumulative in nature, however, an Eclipse update error in the IBM Debugger for AIX v5.0.0 product release will prevent the installation of this Interim Fix on the IBM Debugger for AIX v5.0.0 product release. You should apply this Interim Fix to the IBM Debugger for AIX v5.0.0 after installing the IBM Debugger for AIX Version 5.0.0.1 Interim Fix. Alternatively, you can install this Interim Fix if you choose to install all optional features.</p> -->

<h2><a name="install_debug">安装 IBM Debugger for AIX</a></h2>

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

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

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

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

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

<p>IBM Debugger for AIX 已打包在下列文件集中：</p>

<table border="1" cellpadding="1" cellspacing="1">
  <tr>
    <th><p align="center">文件集</th>
    <th><p align="center">描述
</th>
  </tr>
  <tr>
    <td>ibmdebugger</td>
    <td>包含设置和安装信息的顶级文件集。它包含用于 AIX 的调试引擎组件、客户机 UI 组件和联机帮助组件。</td>
  </tr>
  <tr>
    <td>ibmdebugger.ui</td>
    <td>IBM Debugger for AIX 用户界面。</td>
  </tr>
  <tr>
    <td>ibmdebugger.engine</td>
    <td>用于已编译语言调试的 IBM Debugger for AIX 引擎。</td>
  </tr>
  <tr>
    <td>ibmdebugger.engine.msg.LANG</td>
    <td>IBM Debugger for AIX 引擎本地语言文件集。它包含消息文件，其中 LANG 是以下其中一项：pt_BR、zh_CN、zh_TW、de_DE、es_ES、fr_FR、it_IT、ja_JP 或 ko_KR。</td>
  </tr>
  <tr>
    <td>ibmdebugger.jre</td>
    <td>与 IBM Debugger for AIX 配合使用的 Java 运行时环境（JRE）。</td>
  </tr>
</table>

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

<p><code>installp -aXgd . -e /tmp/ibmdebugger.install.log ibmdebugger*</code></p>

<h3>安装用于 Windows 的用户界面客户机（idebug）</h3>

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

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

<!-- <h2><a name="install_fix">Installing Interim Fixes</a></h2>

<h3>Applying a downloaded Interim Fix to an AIX client</h3>

<p>To apply the Interim fix, you can use smit or installp:</p>

<ol>
  <li>Download and extract the image tar file to a directory on your machine.</li>
  <li>Go to the directory where you extracted the image to and issue the install command. For example, if you are using installp, type <code>installp -X -d /tmp/inst.images ibmdebugger</code>.</li>
  <li>If you use smit, and select 'Install corresponding LANGUAGE filesets? Yes', only the ibmdebugger.msg.lang fileset that matches the LANG environment variable will be installed. To install all language filesets, you must use installp. For example, <code>installp -X -d /tmp/inst.images ibmdebugger.msg.*</code>.</li>
</ol>

<p>If you are using one of the supported non-UTF8 CKJ locales, you must install one of the following filesets:</p>

<p>
X11.fnt.ucs.ttf (for ja_JP or Ja_JP)<br>
X11.fnt.ucs.ttf_CN (for zh_CN or Zh_CN)<br>
X11.fnt.ucs.ttf_KR (for ko_KR)<br>
X11.fnt.ucs.ttf_TW (for zh_TW or Zh_TW)<br>
</p>

<p>The install images are available on AIX v5.2 or higher base CDs, and updates are available from the <a href="http://www.ibm.com/servers/eserver/support/">AIX fix distribution Web site</a>.</p>

<h3>Applying an Interim Fix to a Windows client</h3>

<p>Interim Fixes are installed through the Update Manager capability included in this product. To apply an Interim Fix, complete the following steps:</p>

<ol>
  <li>Select <strong>Help &gt; Software Updates &gt; Find and Install</strong>.</li>
  <li>In the Feature Updates page, click the <strong>Search for updates of the currently installed features</strong> radio button.</li>
  <li>Click <strong>Finish</strong> to contact the Web sites associated with the product's features and discover what versions of those features are available. The potential upgrades are displayed in the Search Results page.</li>
  <li>Select the feature versions that you want to upgrade, and then click <strong>Next</strong>.</li>
  <li>Carefully review the license agreements for the upgraded features. If the terms of all of these licenses are acceptable, select the <strong>I accept the terms in the license agreements</strong> check box, and then click <strong>Next</strong>. Do not proceed to download the features if the license terms are not acceptable.</li>
  <li>In the Optional Features page, click <strong>Next</strong>.</li>
  <li>In the Installation page, click <strong>Finish</strong>.</li>
  <li>Once all of the features and plug-ins have been downloaded successfully and their files installed into the product on the local computer, a new configuration that incorporates these features and plug-ins is formulated. When asked to restart, click <strong>Yes</strong>, and then exit the Workbench for the changes to take effect.</li>
</ol> -->

<h2><a name="uninstall">卸载 IBM Debugger for AIX</a></h2>

<h3>在 Windows 上进行卸载</h3>

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

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

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

<h3>在 AIX 上进行卸载</h3>

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

<p><code>installp -u ibmdebugger*</code></p>

<h2><a name="v6_features">IBM Debugger for AIX V6.1 的新增内容</a></h2>

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

<h2><a name="start">启动调试会话</a></h2>

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

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

<h3>启动 IBM Debugger 客户机</h3>

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

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

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

<h3>启动 IBM Debugger 引擎</h3>

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

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

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

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

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

<p><code>irmtdbgc [-qhost=&lt;hostname&gt;:&lt;uidaemonport&gt;] &lt;executable&gt;&lt;executable parameters&gt;</code></p>

<p>其中：</p>

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

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

<h2><a name="docs">访问 IBM Debugger for AIX 文档</a></h2>

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

<p>要查看帮助系统：从 Windows 或 AIX 客户机中选择<strong>帮助 &gt; 帮助内容</strong>。</p>

<h2><a name="limitations">IBM Debugger for AIX 局限性</a></h2>

<h3>一般局限性：</h3>

<ul>
  <!-- <li>If you apply an Interim Fix for the IBM Debugger for AIX on Windows and then uninstall the debugger, the files that were added during the Interim Fix are not removed. These files can be manually deleted after the uninstall is complete. This problem occurs with IBM Debugger for AIX Windows Client Version 5.0.0.1 and IBM Debugger for AIX Windows Client Version 5.0.0.2.</li> -->
  <!-- <li>When applying an Interim Fix through a Windows client, after clicking <strong>Finish</strong> in the final Installation page, there may be a delay before the progress message appears (indicating the features that are being installed). During this delay, the Install dialog box will close and the workbench will be in the foreground.</li> -->
  <!-- <li>On Windows, after reverting the configuration back to the IBM Debugger for AIX Version 5.0.0 from either the IBM Debugger for AIX Version 5.0.0.1 or the IBM Debugger for AIX Version 5.0.0.2, you may see a warning symbol associated with the resulting configuration. If you open the Properties dialog box for that configuration, the status will contain this message:
    <p>Plug-in: &quot;system.bundle&quot; version: &quot;3.1.0&quot; referenced by this feature is not included at runtime. Runtime includes plug-in version &quot;3.1.2&quot;.</p>
    <p>This message can be ignored and you can safely proceed to use the workbench with the reverted configuration.</p>
  </li> -->
  <li>当通过 Windows 客户机应用临时修订时，如果将当前配置替换为另一个配置，则会将一个未捕获的 SWT 异常写入日志文件。您可以忽略此异常，并继续安全地使用具有被替换配置的工作台。</li>
  <li>当使用 AIX 客户机且在“内存”视图中添加呈示时，该呈示可能不会定位至内存块的基地址。要解决此问题，请在呈示中单击鼠标右键，然后选择<strong>复位至基地址</strong>。这将使呈示转至内存块的基地址。</li>
  <li>当使用 AIX 客户机时，如果您的路径上存在不能正常工作的 Web 浏览器，则帮助系统可能会启动失败。要确保帮助系统正常运转，请从路径中除去不能正常工作的 Web 浏览器。</li>
  <li>IBM Debugger for AIX 不支持将程序名作为参数传递至 <code>idebug</code> 命令。</li>
</ul>

<h3>调试器引擎：</h3>

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

<h3>文档信息中心</h3>

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

<h3>本地语言局限性：</h3>

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

<!-- ========================================================================
<p></p>
<h3></h3>
<ol>
  <li></li>
</ol>
<ul>
  <li></li>
</ul>
<code></code>
<table border="1" cellpadding="1" cellspacing="1">
  <tr>
    <th><p align="center"></th>
    <th><p align="center"></th>
  </tr>
  <tr>
    <td></td>
    <td></td>
  </tr>
  <tr>
    <td></td>
    <td></td>
  </tr>
</table>
======================================================================== -->

</body>
</html>
