Chapter 5. Managing Traps

In addition to setting traps by using the command line, the Views menu of the Main View window provides you with three views specific to trap management:

Call up the Trap Manager window from the Main View window menu bar as follows by selecting Trap Manager from the Views menu.

Trap Manager

The Trap Manager allows you to set, edit, and manage traps (used in both the Debugger and Performance Analyzer).

The Trap Manager window contains the following items (besides the menu bar, which is discussed below):

  • Trap text field: Contains a description of the trap.

  • Condition text field: Contains the condition of the trap.

  • Cycle Count text field: Displays the current cycle count.

  • Current Count text field: Displays the current trap count.

  • Full button: Allows you to toggle between display of full and partial path names.

  • Modify button: Allows you to change the selected breakpoint's settings.

  • Add button: Allows you to add a new breakpoint.

  • Clear button: Clears all the current breakpoint selections and text fields.

  • Delete button: Deletes the selected breakpoint.

  • Active label: If selected with a check mark, the trap is enabled.

  • Trap display area: Contains a description of each trap, and a toggle to indicate whether or not the trap is active.

  • Search text field: Allows you to perform an incremental textual search for the trap list.

The Trap Manager window has a menu bar which contains the Admin, Config, Traps, Display, and Help menus. The Admin menu is the same as that described in “Admin Menu, Task View” in Chapter 3. The Help menu is the same as that described in “Help Menu” in Chapter 1. The other menus are described in the following list:

  • The Config menu contains the following items:

    • Load Traps: Brings up the File dialog allowing you to load the traps from a file.

    • Save Traps: Brings up the File dialog allowing you to save the current traps to a file.

  • The Traps menu has options that allow you to set traps under a number of conditions. The following conditions are available:

    • At Source Line: Highlight a line in the Main View window's source pane before selecting this option to set a breakpoint at the selected line.

    • Entry Function: Highlight a function name in the Main View window's source pane before selecting this option to set a breakpoint at the entry to the function.

    • Exit Function: Highlight a function name in the Main View window's source pane before selection this option to set a breakpoint at the exit from the function.

    • Stop Trap Default: Causes a trap created to be a “stop” trap. Toggles with the Sample Trap Default.

    • Sample Trap Default: Causes a trap created to be a “sample” trap. Toggles with the Stop Trap Default.

    • Group Trap Default: ON/OFF toggle to cause a trap created to have the “pgrp” option.

    • Stop All Default: ON/OFF toggle to cause a trap created to have the All option.

  • The Display menu contains the Delete All optoin, which deletes all traps from the trap list.

Signal Panel

The Signal Panel displays the signals that can occur. You can specify which signals trigger traps and which are to be ignored.

The Signal Panel contains an Admin menu (described in “Admin Menu, Task View” in Chapter 3) and a Help menu (described in “Help Menu” in Chapter 1). Each signal trigger trap in the display has a toggle associated with it. In addition, the panel has a Search text field.


Note: When debugging IRIX 6.5 pthreads, the Signal Panel is inaccessible if more than one thread is active.


Syscall Panel

The Syscall Panel allows you to set traps at the entry to or exit from system calls.

The Syscall Panel contains an Admin menu (described in “Admin Menu, Task View” in Chapter 3) and a Help menu (described in “Help Menu” in Chapter 1). Each system call in the display has two toggles associated with it: one to set a trap on entry, one to set a trap on exit. In addition, the panel has a Search text field.