Mercurial Mercurial > oss > FCL > sftools > dev > ide > carbidecpp / annotate
summary | shortlog | changelog | graph | tags | bookmarks | branches | files | changeset | file | latest | revisions | annotate | diff | comparison | raw | help
Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
core/com.nokia.carbide.cpp.doc.user/html/debugger/watchpoints/setting_watchpoints.htm
author fturovic <frank.turovich@nokia.com>
Thu, 07 Oct 2010 15:31:31 -0500
changeset 2142 1458a474103c
parent 2136 f0b706fa897d
permissions -rw-r--r--
minor edits
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
1376
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
     1
 
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
     2
 
<html>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
     3
 
<head>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
     4
 
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
     5
 
<meta http-equiv="Content-Style-Type" content="text/css" />
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
     6
 
<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
     7
 
<title>Setting and Removing Watchpoints</title>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
     8
 
<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
     9
 
</head>
1791
727385d8e2b3 added new customize carbide section and some relinking done for deleted duplicate page
fturovic <frank.turovich@nokia.com>
parents: 1754
diff changeset 
    10
 
<body >
1376
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    11
 
<h2>Setting and Removing Watchpoints</h2>
120480c02651 BUG 10758 - copyright revised date to 2010
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>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    13
 
<h4>Setting watchpoints</h4>
2136
f0b706fa897d all instances of PLUGINS_ROOT preceded by any path had the path removed (incorrect syntax)
fturovic <frank.turovich@nokia.com>
parents: 1791
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="../views/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="../views/view_memory.htm">Memory Rendering</a> views.</p>
1599
e6d4a94a48d3 revised variables view page and added new images
fturovic <frank.turovich@nokia.com>
parents: 1376
diff changeset 
    15
 
<p align="center"><img src="../images/wnd_add_watchpoint.png" width="238" height="253"></p>
1376
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    16
 
<p align="center" class="figure">Figure 1. Add Watchpoint window </p>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    17
 
<h5>Table 1. Add Watchpoint options </h5>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    18
 
  <table width="88%"  border="0" cellpadding="2" cellspacing="0">
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    19
 
    <tr>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    20
 
      <th width="32%" scope="col">Name</th>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    21
 
      <th width="52%" scope="col">Description</th>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    22
 
    </tr>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    23
 
    <tr>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    24
 
      <td><div align="left"><b>Expression to watch </b></div></td>
120480c02651 BUG 10758 - copyright revised date to 2010
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>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    26
 
    </tr>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    27
 
    <tr>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    28
 
      <td><b>Memory space</b></td>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    29
 
      <td>Not supported.</td>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    30
 
    </tr>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    31
 
    <tr>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    32
 
      <td><b>Units</b></td>
120480c02651 BUG 10758 - copyright revised date to 2010
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>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    34
 
    </tr>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    35
 
    <tr>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    36
 
      <td><b>Access: Write/Read </b></td>
120480c02651 BUG 10758 - copyright revised date to 2010
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>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    38
 
        <ul>
120480c02651 BUG 10758 - copyright revised date to 2010
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>
2142
1458a474103c minor edits
fturovic <frank.turovich@nokia.com>
parents: 2136
diff changeset 
    40
 
          <li>Write only (<img src="../images/icon_watchpoint_write_resolved.png" alt="Write only" width="15" height="16" align="absmiddle">)</li>
1458a474103c minor edits
fturovic <frank.turovich@nokia.com>
parents: 2136
diff changeset 
    41
 
          <li>Read/Write (<img src="../images/icon_watchpoint_rw_enabled.png" alt="Read/Write icon" width="16" height="16" align="absmiddle">)</li>
1376
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    42
 
      </ul></td>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    43
 
    </tr>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    44
 
</table>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    45
 
  <h4>Removing Watchpoints</h4>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    46
 
  <p>In the <b>Breakpoints</b> view, locate the watchpoint to remove and: </p>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    47
 
  <ul>
120480c02651 BUG 10758 - copyright revised date to 2010
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>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    49
 
  </ul>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    50
 
  <h4>Other references</h4>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    51
 
<ul>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    52
 
  <li><a href="..//watchpoints/watchpoints.htm">Watchpoints overview </a></li>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    53
 
</ul>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    54
 
<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>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    55
 
</body>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    56
 
</html>
FCL/sftools/dev/ide/carbidecpp