author | fturovic <frank.turovich@nokia.com> |
Fri, 16 Apr 2010 09:51:37 -0500 | |
branch | RCL_2_4 |
changeset 1225 | a546534a48de |
parent 0 | fb279309251b |
child 1601 | c8b627039298 |
permissions | -rw-r--r-- |
1225
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
1 |
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
2 |
<html> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
3 |
<head> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
4 |
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" /> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
5 |
<meta http-equiv="Content-Style-Type" content="text/css" /> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
6 |
<meta name="LASTUPDATED" content="06/17/05 11:09:43" /> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
7 |
<title>Watchpoint Status Indicators</title> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
8 |
<link rel="StyleSheet" href="../../../book.css" type="text/css"/> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
9 |
</head> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
10 |
<body bgcolor="#FFFFFF"> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
11 |
<h2>Watchpoint Status Indicators</h2> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
12 |
<p>Use <em>watchpoints</em> (sometimes referred to as access breakpoints) to halt program execution when a specific global location is accessed. After you set a watchpoint at a key point in memory, you can halt program execution whenever that point in memory is written to or read from. You can then examine the call chain, check register and variable values, and step through your code. You can also change values and alter the flow of normal program execution.</p> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
13 |
<p>A watchpoint must be both enabled and resolved during a debug session in order to halt program execution. The <a href="../breakpoints/viewing_breakpoints.htm">Breakpoints</a> view indicates the status of any watchpoint using a set of common icons and checkmark status badge. These include:</p> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
14 |
<ul> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
15 |
<li>An <b>enabled</b> watchpoint has a non-gray icon (<img src="../images/icon_watchpoint_write_resolved.png" width="15" height="16" align="absmiddle" />) indicating that program execution halts when encountered.</li> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
16 |
<li>A <b>disabled</b> watchpoint displays a gray icon (<img src="../images/icon_watchpoint_write_disabled.png" width="16" height="16" align="absmiddle" />) indicating that program execution will not stop when encountered. </li> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
17 |
<li>A <b>resolved</b> watchpoint has a small checkmark badge (<img src="../images/icon_watchpoint_rw_enabled_resolved.png" width="16" height="16" align="absmiddle" /> ) indicating that the debugger has located it in memory during program launch. When resolved, the debugger can halt program execution if the watchpoint is encountered.</li> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
18 |
</ul> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
19 |
<p>In effect, a watchpoint that is enabled by the user and resolved by the debugger during program launch can halt program execution. The table below shows the various states that cause the debugger to halt program execution: </p> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
20 |
<h5>Table 1 Watchpoint—stop execution chart </h5> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
21 |
<table width="50%" border="0" align="left" cellpadding="2" cellspacing="0"> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
22 |
<tr> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
23 |
<th width="32%" scope="col">Watchpoint</th> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
24 |
<th width="32%" scope="col"><div align="center">Resolved</div></th> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
25 |
<th width="36%" scope="col"><div align="center">Unresolved</div></th> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
26 |
</tr> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
27 |
<tr> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
28 |
<th scope="col">Enabled</th> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
29 |
<td><div align="center"><b>Stops execution </b></div></td> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
30 |
<td><div align="center"><b>No</b></div></td> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
31 |
</tr> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
32 |
<tr> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
33 |
<th scope="col">Disabled</th> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
34 |
<td><div align="center"><b>No</b></div></td> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
35 |
<td><div align="center"><b>No</b></div></td> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
36 |
</tr> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
37 |
</table> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
38 |
<p> </p> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
39 |
<p> </p> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
40 |
<p> </p> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
41 |
<p>In addition, you can use these types of watchpoints:</p> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
42 |
<ul> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
43 |
<li><a href="setting_watchpoints.htm">regular</a> watchpoints—halt program execution</li> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
44 |
<li><a href="../breakpoints/temporary_breakpoints.htm">conditional</a> watchpoints—halt program execution after meeting a condition that you specify (same as for breakpoints)</li> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
45 |
</ul> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
46 |
<p>A watchpoint is equivalent to a memory breakpoint.</p> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
47 |
<p>Unlike a breakpoint, a watchpoint can detect when any part of your program affects memory. For example, if a write or write/read watchpoint is set, when the program writes a new value to the address or area of memory that has the watchpoint, the debugger suspends program execution.</p> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
48 |
<p class="note"><b>NOTE</b> You cannot set a watchpoint on a local variable, because the debugger cannot detect watchpoints for variables stored on the stack or in registers.</p> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
49 |
<h5>Table 2 Watchpoint—types and states </h5> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
50 |
<table width="90%" border="0" cellpadding="2" cellspacing="0"> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
51 |
<tr> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
52 |
<th width="14%" scope="col">Type</th> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
53 |
<th width="14%" scope="col">State</th> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
54 |
<th width="10%" scope="col">Icon</th> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
55 |
<th width="62%" scope="col">Explanation</th> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
56 |
</tr> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
57 |
<tr> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
58 |
<td rowspan="2"><b>Write</b></td> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
59 |
<td>enabled</td> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
60 |
<td><div align="center"><img src="../images/icon_watchpoint_write_resolved.png" width="15" height="16" /></div></td> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
61 |
<td><p>The watchpoint is activated for write access operations on the specific memory location and if resolved, will halt program execution on a write operation at the watchpoint. </p></td> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
62 |
</tr> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
63 |
<tr> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
64 |
<td>disabled</td> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
65 |
<td><div align="center"><img src="../images/icon_watchpoint_write_disabled.png" width="16" height="16" /></div></td> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
66 |
<td><p>Watchpoint is disabled for the source line, debugger does not halt program execution on a write operation. </p></td> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
67 |
</tr> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
68 |
<tr> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
69 |
<td rowspan="2"><b>Read</b></td> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
70 |
<td>enabled</td> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
71 |
<td><div align="center"><img src="../images/icon_watchpoint_read_enabled.png" width="16" height="16" /></div></td> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
72 |
<td><p>The watchpoint is activated for read access operations on the specific memory location and if resolved, will halt program execution on a read operation at the watchpoint. </p></td> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
73 |
</tr> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
74 |
<tr> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
75 |
<td>disabled</td> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
76 |
<td><div align="center"><img src="../images/icon_watchpoint_read_disabled.png" width="16" height="16" /></div></td> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
77 |
<td><p>Watchpoint is disabled for the source line, debugger does not halt program execution on a read operation. </p></td> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
78 |
</tr> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
79 |
<tr> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
80 |
<td rowspan="2"><b>Write/Read</b></td> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
81 |
<td>enabled</td> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
82 |
<td><div align="center"><img src="../images/icon_watchpoint_rw_enabled.png" width="16" height="16" /></div></td> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
83 |
<td><p>The watchpoint is activated for both read and write access operations on the specific memory location and if resolved, will halt program execution on any read or write operation at the watchpoint. </p></td> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
84 |
</tr> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
85 |
<tr> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
86 |
<td>disabled</td> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
87 |
<td><div align="center"><img src="../images/icon_watchpoint_rw_disabled.png" width="16" height="16" /></div></td> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
88 |
<td><p>Watchpoint is disabled for the source line, debugger does not halt program execution on a read or write operation. </p></td> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
89 |
</tr> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
90 |
</table> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
91 |
<p>A project can have a different maximum number of watchpoints, depending on the build target. The IDE generally limits the acceptable range for watchpoints to memory that it can write-protect. This range also depends on the host and on the application. </p> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
92 |
<p>All set watchpoints appear in the <a href="../breakpoints/viewing_breakpoints.htm">Breakpoints</a> view list.</p> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
93 |
<h4>Other references</h4> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
94 |
<ul> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
95 |
<li><a href="..//watchpoints/watchpoints.htm">Watchpoints overview </a></li> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
96 |
</ul> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
97 |
<div id="footer">Copyright © 2010 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
98 |
</body> |
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
99 |
</html> |