core/com.nokia.carbide.cpp.doc.user/html/debugger/watchpoints/status_watchpoints.htm
author fturovic <frank.turovich@nokia.com>
Fri, 16 Apr 2010 09:51:37 -0500
branchRCL_2_4
changeset 1225 a546534a48de
parent 0 fb279309251b
child 1601 c8b627039298
permissions -rw-r--r--
minor edits to remote conn pages, updated copyrights, fixed some broken links
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
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&mdash;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>&nbsp;</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>&nbsp;</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>&nbsp;</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&mdash;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&mdash;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&mdash;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 &copy; 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>