summaryrefslogtreecommitdiff
path: root/gdb/gdbtk/library/help/trace/tp.html
blob: 471e1d545e9c04284780738235f844df873b98d3 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
<HTML>
<HEAD>
<TITLE>Tracepoint Window Help</TITLE>
</HEAD>
<BODY>
<H1>The Tracepoint Window</H1>
<H3>Overview</H3>
<P>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.</P>

<P>Tracepoint Window topics:
<UL>
    <LI><UL><A HREF="#menus">Menus</A>
            <LI><A HREF="#menus_bp">Tracepoint Menu</A>
            <LI><A HREF="#menus_global">Global Menu</A>
        </UL>
    <LI><UL><A HREF="#display">Tracepoint Display</A>
            <LI><A HREF="#display_state">Enabling/Disabling Tracepoints</A>
            <LI><A HREF="#display_remove">Removing Tracepoints</A>
            <LI><A HREF="#display_popup">Tracepoint Pop-up Menu</A>
        </UL>
</UL></P>

<H3><A NAME="menus">Menus</A></H3>
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.
<BR>

<H4><A NAME="menus_bp">Tracepoint Menu</A></H4>
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:
<DL>
    <DT>Actions
        <DD><A HREF="tracedlg.html">Display the Tracepoint Dialog</A> for
            this tracepoint.
    <DT>Enabled
        <DD>The tracepoint is active and will stop the debugger
            when it is hit.
    <DT>Disabled
        <DD>The tracepoint is being ignored. A disabled tracepoint
            will never get hit.
    <DT>Remove
        <DD>Deletes the tracepoint
</DL>
<BR>

<H4><A NAME="menus_global">Global Menu</A></H4>
Items on the Global Menu affect all defined tracepoints. Users may:
<DL>
    <DT>Enable All
        <DD>Enable all tracepoints
    <DT>Disable All
        <DD>Disable all tracepoints
    <DT>Remove All
       <DD>Delete all tracepoints
</DL>
<BR>

<H4><A NAME="display">Tracepoint Display</A></H4>
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.

<P>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.</P>

<H3>Modifying Tracepoints</H3>
To <A NAME="display_state">enable</A> 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.

<P>To remove a <A NAME="display_remove">tracepoint</A>, 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 <A HREF="source.html#setting_a_tracepoint">Source Window Display</A>.
</P>
<BR>

<H4><A NAME="display_popup">Tracepoint Pop-up Menu</A></H4>
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:
<DL>
    <DT>Actions
        <DD>Display the <A HREF="tracedlg.html">Tracepoint Dialog</A> for
            the selected tracepoint. This allows the tracepoint's actions
            to viewed or edited.
    <DT>Enabled
        <DD>The tracepoint is active and will causes actions to be
            performed on the target when it is hit
    <DT>Disabled
        <DD>The tracepoint is being ignored. A disabled tracepoint
            will never perform any actions or be recorded in the trace
            buffer.
    <DT>Remove
        <DD>Deletes the tracepoint
    <DT>Global, Enable All
        <DD>Enable all tracepoints
    <DT>Global, Disable All
        <DD>Disable all tracepoints
    <DT>Global, Remove All
       <DD>Delete all tracepoints
</DL>
</BODY>
</HTML>