| 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 1237 | 9654af560a30 |
| 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>Setting and Removing Watchpoints</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>Setting and Removing Watchpoints</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>You create a watchpoint to monitor a value in a specified memory location. The debugger halts program execution on the line of source code that triggered the watchpoint. This is different than a breakpoint, which halts program execution prior to executing the line of source code on which the breakpoint is set.</p> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
13 |
<h4>Setting watchpoints</h4> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
14 |
<p>Right-click in the <a href="../breakpoints/viewing_breakpoints.htm">Breakpoints</a> view and choose the <b>Add Watchpoint (C/C++)...</b> command to open the <b>Add Watchpoint</b> window. A watchpoint suspends program execution when the memory location that you specify is accessed with a write or read operation and it's based on the access setting. Use the <b>Add Watchpoint</b> window to specify the memory location, its memory size, unit size, and define whether the watchpoint triggers on a read, write, or on both operations. Watchpoints can also be added directly in the <a href="../../reference/view_variables.htm">Variables</a>, <a href="PLUGINS_ROOT/org.eclipse.cdt.doc.user/reference/cdt_u_outline_view.htm">Outline</a>, and the <a href="../../reference/view_memory_wnd.htm">Memory Rendering</a> views.</p> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
15 |
<p align="center"><img src="../images/wnd_add_watchpoint.png" width="220" height="261"></p> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
16 |
<p align="center" class="figure">Figure 1. Add Watchpoint window </p> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
17 |
<h5>Table 1. Add Watchpoint options </h5> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
18 |
<table width="88%" 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
|
19 |
<tr> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
20 |
<th width="32%" scope="col">Name</th> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
21 |
<th width="52%" scope="col">Description</th> |
|
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 |
<tr> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
24 |
<td><div align="left"><b>Expression to watch </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
|
25 |
<td>If not already entered, you can enter any arbitrary memory location for watching. </td> |
|
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 |
<td><b>Memory space</b></td> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
29 |
<td>Not supported.</td> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
30 |
</tr> |
|
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 |
<td><b>Units</b></td> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
33 |
<td>Define the size of the units to monitor. This setting defaults to the size of the variable to watch. If an arbitrary memory address is entered, then the default unit size is set to 1 byte. Once you enable the units checkbox, you're must enter a value for it.</td> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
34 |
</tr> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
35 |
<tr> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
36 |
<td><b>Access: 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
|
37 |
<td><p>Check the appropriate access type to trigger the watchpoint for the specified memory location. This setting is shown as a unique icon in the Breakpoints view next to the listed watchpoint. The following list shows the resolved version of the icons used to indicate the type of watchpoint set:</p> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
38 |
<ul> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
39 |
<li>Read only (<img src="../images/icon_watchpoint_read_resolved.png" width="18" height="13" align="absmiddle">)</li> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
40 |
<li>Write only (<img src="../images/icon_watchpoint_write_resolved.png" width="15" height="16" align="absmiddle">)</li> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
41 |
<li>Read/Write (<img src="../images/icon_watchpoint_rw_enabled.png" width="16" height="16" align="absmiddle">)</li> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
42 |
</ul></td> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
43 |
</tr> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
44 |
</table> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
45 |
<h4>Removing Watchpoints</h4> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
46 |
<p>In the <b>Breakpoints</b> view, locate the watchpoint to remove and: </p> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
47 |
<ul> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
48 |
<li>Right-click the watchpoint and choose <b>Remove</b> from the context menu</li> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
49 |
</ul> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
50 |
<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
|
51 |
<ul> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
52 |
<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
|
53 |
</ul> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
54 |
<div id="footer">Copyright © 2009 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
|
55 |
</body> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
56 |
</html> |