This document discusses the following topics:

Overview

The HP WDB GUI 5.7 is a graphical user interface (GUI) designed by Hewlett-Packard for the HP Wildebeest Debugger (WDB). It supports source-level debugging of programs written in HP C, HP aC++, and Fortran 90 on Itanium®-based systems running HP-UX 11i v2 or HP-UX 11i v3, and PA-RISC systems running HP-UX 11.0, HP-UX 11i v1, HP-UX 11i v2, or HP-UX 11i v3. HP WDB is an HP-supported implementation of the Open Source GDB debugger developed by the Free Software Foundation.

What Is New in This Release

This section discusses the following new features that are available in this version of HP WDB GUI:

HP WDB 5.7 supports the following new features:

  • Support for Viewing the Arena Profile

    HP WDB 5.7 provides support to view the arena information for a program running on HP-UX 11i v3.

    To view the arena information, complete the following steps

    1. Load the program to HP WDB GUI

    2. Stop the program execution at the required breakpoints

    3. Select View->Memory Usage->Heap Arena to view the arena information

    The following information is displayed in the View Heap Arena window:

    • Arenas

      The Arena IDs are listed in this list menu. Select the required Arena ID from the Arenas list menu to view Arena ID Summary, or Block Details for the selected arena.

    • Arena ID Summary

      The summary information for the selected Arena ID is displayed in this frame.

    • Block Details

      To view the block level details in an arena, select Block Details after selecting the required Arena ID in the Arenas menu. The block distribution in the arena is displayed in the Arenas Block Distribution window.

      The Arenas Block Distribution window displays the block level space distribution graph for an arena. The graph displays the space occupied by the user blocks, the free blocks, the unclaimed space, and the malloc() metadata (which includes the node blocks, the cached blocks, the holding header blocks, the holding SBA blocks). The virtual address of the blocks is used to arrange the blocks in the graph. The Block ID of the block is also displayed within the block if the scale of the graph allows the display. The start of the heap, the end of the heap, the total heap size, and the total number of blocks are also listed.

      HP WDB GUI displays the block distribution graph in the default window. If the complete block distribution graph cannot be displayed in the default window, select Expand Block Distribution Graph toggle option to view the magnified block distribution graph.

      To view the Block ID, the block type, the block size, and the virtual address for each block in the arena,you must right-click on the required block in the block distribution graph.

      The number of used blocks in each block-count range is also displayed graphically for the selected arena. This information is also displayed in a tabular format.

    • Heap Arena Space Usage

      The Heap Arena Space Usage frame displays the Arena ID, the space usage (in KB) in the arena, and the percentage space usage in each arena in comparison to the total space occupied by all the arenas. The comparative space usage across arenas is also displayed with a pie chart. The Arena ID is also displayed in the pie chart if the scale of the graph allows it.

    • Full Summary

      To view the summary for all the arenas, click Full Summary. The summary information for all the arenas is displayed in a new Arena Summary window.

    • Heap Arena Detailed Graphs

      The Heap Arena Detailed Graphs display the following information:

      • The byte distribution (in KB) across used ordinary blocks, used small blocks, free ordinary blocks, and free small blocks is displayed for each arena. This information is displayed as a bar graph for each arena.

      • The byte distribution for uthe used ordinary blocks, the used small blocks, the free ordinary blocks, and the free small blocks across the arenas is displayed with a pie chart. This information is also displayed in a table.

      • The number of blocks that are distributed across the used ordinary blocks, the used small blocks, the free ordinary blocks, and the free small blocks are displayed for each arena. This information is displayed as a bar graph for each arena.

      • The number of blocks occupied by the used ordinary blocks, the used small blocks, the free ordinary blocks, and the free small blocks across the arenas is displayed with a pie chart. This information is also displayed in a table.

  • Support for Viewing the Incremental Heap Profile

    HP WDB GUI provides support to view the incremental heap profile for a program.

    To view the incremental heap profile for a program, complete the following steps:

    1. Load the program to the debugger

    2. Select Tools->Memory Check

    3. Select the Incremental Heap Check Settings option while setting the memory debugging preferences in the Memory Check window

    4. Enter the Heap Check Interval and the Heap Check Repeat Count in the Memory Check window

    5. Run the program after setting the required breakpoints

    6. Select View->Memory Usage->Incremental Heap to view the incremental heap profile

    The Incremental Heap View window displays the incremental heap profile graph for the program.

    The incremental heap profile graph can be plotted based on the outstanding allocations in the program or the actual heap profile, as follows:

    • To view the incremental heap profile graph based on the outstanding allocations, select the Allocation option in the Plot Graph frame. The Allocation Profile displays the outstanding allocations (in KB) in the program with unique color coding for each interval.

    • To view the incremental heap profile graph based on the actual heap profile, select the Actual Heap option in the Plot Graph frame. The Heap Space Profile displays the heap size in KB for the program.

    To specify the time interval for displaying the incremental heap profile, you must select the Select Timeoption and specify the start time and the end time from the Start Time list menu and the End Time list menu. The listings for time in the Start Time list menu and the End Time list menu are derived by dividing the total program execution time into five equal intervals. Additionally, you can enter a custom start time, or a custom end time for displaying the incremental heap profile.

    To view the incremental heap profile summary, click Summary Table. The summary table displays the record ID, the start time,the end time, the heap interval, the heap start, the heap end, the heap size in bytes, the number of allocated bytes, and the number of blocks used for all the collected incremental heap profile records. Click on the required incremental heap profile record to view the block allocation details for the corresponding record.

  • Support for Viewing Execution Path Entries

    Inputs pending

  • Support for the Mouse Scroll Wheel

    The support for the mouse scroll view is now available is all source views and disassembly views.

Patches, Defects, and Fixes
  • WDB GUI does not display the general register.
  • WDB GUI changes the permissions for the history file
Known Problems in This Release
  • There are no reported problems in this release of HP WDB GUI.
Related Documentation

The following table lists the documentation available for HP WDB GUI:

Document Format Location
HP WDB GUI Reference Manual PDF /opt/langtools/wdb/doc/html/wdbgui/C
HP WDB GUI Online Help (Installed with the product) HTML /opt/langtools/wdb/doc/html/wdbgui/C
HP WDB GUI Manpage wdb(1)