The Tracepoint Window
Overview
The Tracepoint Window lists all the various tracepoints that exist in
the program. It facilitates modifying tracepoints (make them
temporary or normal, disabled or enabled) and removing tracepoints.
Tracepoint Window topics:
The Tracepoint Window contains two menus, one which deals specifically with
the individual tracepoints selected in the window, and one whose commands
affect all tracepoints.
The Tracepoint Menu operates on the selected tracepoint only. The
state of a tracepoint may be changed by selecting the desired state
from the menu:
- Actions
- Display the Tracepoint Dialog for
this tracepoint.
- Enabled
- The tracepoint is active and will stop the debugger
when it is hit.
- Disabled
- The tracepoint is being ignored. A disabled tracepoint
will never get hit.
- Remove
- Deletes the tracepoint
Items on the Global Menu affect all defined tracepoints. Users may:
- Enable All
- Enable all tracepoints
- Disable All
- Disable all tracepoints
- Remove All
- Delete all tracepoints
The Tracepoint Display is a table of tracepoints. The first column of the
table (unlabeled) shows a checkbutton, indicating whether the tracepoint
is enabled (checked) or disabled (unchecked). Disabled tracepoints are
ignored and will not cause any actions to be performed on the target.
To use the Tracepoint Menu or the Tracepoint Pop-up Menu, first use
the left mouse button to select a tracepoint from the list, then make the
menu selection.
Modifying Tracepoints
To enable a tracepoint, simply click the
checkbutton in the first column of the desired tracepoint so that it is
selected (checked). To disable a tracepoint, "uncheck" the checkbutton.
To remove a tracepoint, use the left mouse
button to select the tracepoint to remove and use either the tracepoint Menu
or the Tracepoint Pop-up Menu to select "remove". To re-install a tracepoint,
use the Source Window Display.
The Tracepoint Pop-up Menu is accessed by using the mouse cursor to select
a tracepoint from the Tracepoint Display and then clicking the right button
on the mouse. The Pop-up allows expert users quicker access to the functions
of the Tracepoint Menu:
- Actions
- Display the Tracepoint Dialog for
the selected tracepoint. This allows the tracepoint's actions
to viewed or edited.
- Enabled
- The tracepoint is active and will causes actions to be
performed on the target when it is hit
- Disabled
- The tracepoint is being ignored. A disabled tracepoint
will never perform any actions or be recorded in the trace
buffer.
- Remove
- Deletes the tracepoint
- Global, Enable All
- Enable all tracepoints
- Global, Disable All
- Disable all tracepoints
- Global, Remove All
- Delete all tracepoints