Chapter 6. Debugging X/Motif Programs

The X/Motif Analyzer provides special debugging support for X/Motif applications and is available from the WorkShop Views menu. The X/Motif Analyzer operates in a number of modes (referred to as examiners ) for examining different types of X/Motif objects. The X/Motif Analyzer provides information unavailable through conventional debuggers. It also lets you set widget-level breakpoints and collect X-event history.

When you first invoke the X/Motif Analyzer, it comes up in widget examiner mode. You can switch to other examiners through the Examiner menu or by clicking the tabs at the bottom of the window (See Figure 6-1).

Figure 6-1. The X/Motif Analyzer Window

Features of the X/Motif Analyzer

The X/Motif Analyzer provides the following types of examiners:

  • Widget examiner--identifies a widget's ID, name, class, and parent, and displays its definitions.

  • Widget Tree examiner--displays the widget hierarchy (see Figure 6-2). You can display widgets by name, class, or ID by selecting from the widget display menu. Double-clicking a widget node switches to the widget examiner and displays data for the selected widget.

    Figure 6-2. X/Motif Analyzer Widget Tree Examiner

  • Breakpoints examiner--lets you set breakpoints at the widget and widget-class level. You can set breakpoints at the following levels:

    • Callback functions

    • Widget events

    • Resource changes

    • Timeout callback functions

    • Input callback functions

    • Widget state changes

    • X events

    • X requests

  • Trace examiner--lets you trace the execution of your application and collect the following types of data:

    • X Server Events

    • X Server Requests

    • Widget event dispatch information

    • Widget resource changes

    • Widget state changes

    • X callbacks

    Figure 6-3, is a typical example of the trace examiner. The events appear in a list. Double-clicking an event displays its details.

  • Callback examiner--comes up automatically when a process stops in a callback. It displays the following information:

    • Callstack frame for the callback function

    • Widget information

    • Callback data structure

  • Window examiner--identifies the window, its parent and any children, and displays window attribute information.

  • Event examiner--displays the event structure for a given X event pointer.

  • Graphics context (GC) examiner--displays the X graphics context attributes for a given GC pointer.

  • Pixmap examiner--displays the basic attributes of an X pixmap, including size and depth, and can provide an ASCII display of small pixmaps, using the units digit of the pixel values.

  • Widget class examiner--displays the widget class attributes for a given widget class pointer.

    Figure 6-3. X/Motif Analyzer with Trace Examiner Data

The following table details where to find more information about the X/Motif Analyzer in the ProDev Workshop: Debugger User's Guide.

Table 6-1. X/Motif Analyzer Information Details


See ...

General information and tutorial

Chapter 11, “Using the X/Motif Analyzer: X/Motif Analyzer”

Detailed reference information

Appendix A, "X/Motif Analyzer Windows” subsection

Setting breakpoints to capture widget-level information

Appendix A; "Breakpoints Examiner” subsection

Tracing widget-level data through the execution of a program

Appendix A, "Trace Examiner” subsection

Getting information on a specified widget

Appendix A, "Widget Examiner” subsection

Displaying a graph of the widget hierarchy

Appendix A, "Tree Examiner” subsection

Getting information on a specified callback

Appendix A, "Callback Examiner” subsection

Getting information on a specified window

Appendix A, "Window Examiner” subsection

Getting information on a specified X event

Appendix A, "Event Examiner” subsection

Getting information on a specified graphics context

Appendix A, "Graphics Context Examiner” subsection

Getting information on a specified pixmap

Appendix, "Pixmap Examiner” subsection