core/com.nokia.carbide.cpp.doc.user/html/debugger/breakpoints/viewing_breakpoints.htm
author dan.podwall@nokia.com
Mon, 06 Apr 2009 14:56:28 -0500
changeset 56 887bd61e1328
parent 2 d760517a8095
child 1225 a546534a48de
permissions -rw-r--r--
merge from RCL_2_0 to default
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
2
cawthron
parents:
diff changeset
     1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
cawthron
parents:
diff changeset
     2
<html>
cawthron
parents:
diff changeset
     3
<head>
cawthron
parents:
diff changeset
     4
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
cawthron
parents:
diff changeset
     5
<meta http-equiv="Content-Style-Type" content="text/css" />
cawthron
parents:
diff changeset
     6
<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
cawthron
parents:
diff changeset
     7
<title>Viewing Breakpoints and Watchpoints</title>
cawthron
parents:
diff changeset
     8
<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
cawthron
parents:
diff changeset
     9
</head>
cawthron
parents:
diff changeset
    10
<body bgcolor="#FFFFFF">
cawthron
parents:
diff changeset
    11
<h2>Viewing Breakpoints and Watchpoints </h2>
cawthron
parents:
diff changeset
    12
<p>Use the <b>Breakpoints</b> view (Figure 1) to <a href="properties_breakpoints.htm">examine</a> a project's breakpoints and watchpoints, <a href="toggling_breakpoints.htm">toggle</a> individual breakpoints  between enabled and disabled, set <a href="conditional_breakpoints.htm">conditional</a> breakpoints, <a href="exporting_breakpoints.htm">export</a> and <a href="importing_breakpoints.htm">import</a> breakpoints, or remove them from one or more build configurations. </p>
cawthron
parents:
diff changeset
    13
<p>The <b>Breakpoints</b> view is available in the <a href="../../reference/perspective_debug.htm">Debug</a> perspective by default. To open it in another perspective, use the <b>Window &gt; Show View &gt; Breakpoints</b> menu option. Once open you have  control over breakpoint states and how they are shown. For example: </p>
cawthron
parents:
diff changeset
    14
<ul>
cawthron
parents:
diff changeset
    15
  <li>Click a  check box next to a breakpoint to toggle its state between enabled (checked) and disabled (no checkmark) </li>
cawthron
parents:
diff changeset
    16
  <li>Double-click a breakpoint to open the associated source file at the breakpoint line number  in an editor view</li>
cawthron
parents:
diff changeset
    17
  <li>Use the <b>Menu &gt; Group By</b> command to control how the breakpoints are shown in the view. For example, by file, by breakpoints, etc. </li>
cawthron
parents:
diff changeset
    18
  <li>Use the <b>Menu &gt; Working Sets... </b> command to create working sets of breakpoints to quickly switch between different breakpoint settings or groups </li>
cawthron
parents:
diff changeset
    19
  <li>Right-click to open the Breakpoints view's context menu for additional command options </li>
cawthron
parents:
diff changeset
    20
</ul>
cawthron
parents:
diff changeset
    21
<p align="center"><img src="../images/view_breakpoints.png" width="594" height="322"></p>
cawthron
parents:
diff changeset
    22
<p class="figure">Figure 1 - Breakpoints view showing context menu </p>
cawthron
parents:
diff changeset
    23
<h3>Breakpoints view toolbar icons</h3>
cawthron
parents:
diff changeset
    24
<p>The following commands appear on the toolbar within the Breakpoints view: </p>
cawthron
parents:
diff changeset
    25
<table width="100%"  border="0" cellpadding="2" cellspacing="0">
cawthron
parents:
diff changeset
    26
  <tr>
cawthron
parents:
diff changeset
    27
    <th width="27%" scope="col">Item</th>
cawthron
parents:
diff changeset
    28
    <th width="11%" scope="col">Icon</th>
cawthron
parents:
diff changeset
    29
    <th width="62%" scope="col">Explanation</th>
cawthron
parents:
diff changeset
    30
  </tr>
cawthron
parents:
diff changeset
    31
  <tr>
cawthron
parents:
diff changeset
    32
    <td><b>Remove Selected Breakpoint </b></td>
cawthron
parents:
diff changeset
    33
    <td><div align="center"><img src="../../images/icons/breakpoints_remove_one_icon.png" width="19" height="19" /></div></td>
cawthron
parents:
diff changeset
    34
    <td>Removes the selected breakpoint from the breakpoints list. </td>
cawthron
parents:
diff changeset
    35
  </tr>
cawthron
parents:
diff changeset
    36
  <tr>
cawthron
parents:
diff changeset
    37
    <td><b>Remove All Breakpoints </b></td>
cawthron
parents:
diff changeset
    38
    <td><div align="center"><img src="../../images/icons/breakpoints_remove_all_icon.png" width="21" height="19" /></div></td>
cawthron
parents:
diff changeset
    39
    <td>Removes all breakpoints from the breakpoints list. </td>
cawthron
parents:
diff changeset
    40
  </tr>
cawthron
parents:
diff changeset
    41
  <tr>
cawthron
parents:
diff changeset
    42
    <td><b>Show Breakpoints Supported by Selected Target </b></td>
cawthron
parents:
diff changeset
    43
    <td><div align="center"><img src="../../images/icons/breakpoints_show_icon.png" width="20" height="19" /></div></td>
cawthron
parents:
diff changeset
    44
    <td>Limits the breakpoints shown to only those supported in the current target. </td>
cawthron
parents:
diff changeset
    45
  </tr>
cawthron
parents:
diff changeset
    46
  <tr>
cawthron
parents:
diff changeset
    47
    <td><b>Go to File for Breakpoint </b></td>
cawthron
parents:
diff changeset
    48
    <td><div align="center"><img src="../../images/icons/breakpoints_goto_icon.png" width="20" height="19" /></div></td>
cawthron
parents:
diff changeset
    49
    <td>Displays the breakpoint in an editor view, opening the source file if required. </td>
cawthron
parents:
diff changeset
    50
  </tr>
cawthron
parents:
diff changeset
    51
  <tr>
cawthron
parents:
diff changeset
    52
    <td><b>Skip All Breakpoints </b></td>
cawthron
parents:
diff changeset
    53
    <td><div align="center"><img src="../../images/icons/breakpoints_skip_all_icon.png" width="19" height="19" /></div></td>
cawthron
parents:
diff changeset
    54
    <td>Toggles  the debugger to skip all  breakpoints regardless of their current enabled or disabled state, or hit all breakpoints.</td>
cawthron
parents:
diff changeset
    55
  </tr>
cawthron
parents:
diff changeset
    56
  <tr>
cawthron
parents:
diff changeset
    57
    <td><b>Expand All </b></td>
cawthron
parents:
diff changeset
    58
    <td><div align="center"><img src="../../images/icons/breakpoints_collapse_icon.png" width="19" height="18" /></div></td>
cawthron
parents:
diff changeset
    59
    <td>Expand all matches in the hierarchical view.</td>
cawthron
parents:
diff changeset
    60
  </tr>
cawthron
parents:
diff changeset
    61
  <tr>
cawthron
parents:
diff changeset
    62
    <td><b>Collapse All </b></td>
cawthron
parents:
diff changeset
    63
    <td><div align="center"><img src="../../images/icons/breakpoints_expand_icon.png" width="19" height="18" /></div></td>
cawthron
parents:
diff changeset
    64
    <td>Collapse all matches in the hierarchical view.</td>
cawthron
parents:
diff changeset
    65
  </tr>
cawthron
parents:
diff changeset
    66
  <tr>
cawthron
parents:
diff changeset
    67
    <td><b>Link with Debug View</b></td>
cawthron
parents:
diff changeset
    68
    <td><div align="center"><img src="../../images/icons/breakpoints_linkto_debug_icon.png" width="20" height="19" /></div></td>
cawthron
parents:
diff changeset
    69
    <td>When enabled, the breakpoint shown in the editor view is also highlighted in the Breakpoints view. When disabled, the breakpoint selected in the Breakpoints view does not change. </td>
cawthron
parents:
diff changeset
    70
  </tr>
cawthron
parents:
diff changeset
    71
  <tr>
cawthron
parents:
diff changeset
    72
    <td><b>Menu</b></td>
cawthron
parents:
diff changeset
    73
    <td><div align="center"><img src="../../reference/images/icon_breakpoint_menu.png" width="16" height="9"></div></td>
cawthron
parents:
diff changeset
    74
    <td><p>Click to display additional Breakpoints view options for paths, grouping choices, and working sets as shown below. </p>
cawthron
parents:
diff changeset
    75
      <p align="center"><img src="../images/view_breakpoints_menu_cmds.png" width="284" height="150"> </p></td>
cawthron
parents:
diff changeset
    76
  </tr>
cawthron
parents:
diff changeset
    77
</table>
cawthron
parents:
diff changeset
    78
<h3>Breakpoints view context menu options</h3>
cawthron
parents:
diff changeset
    79
<p>The following commands appear on the context menu when you right-click within the Breakpoints view: </p>
cawthron
parents:
diff changeset
    80
<table width="100%"  border="0" cellpadding="2" cellspacing="0">
cawthron
parents:
diff changeset
    81
  <tr>
cawthron
parents:
diff changeset
    82
    <th width="27%" scope="col">Item</th>
cawthron
parents:
diff changeset
    83
    <th width="62%" scope="col">Explanation</th>
cawthron
parents:
diff changeset
    84
  </tr>
cawthron
parents:
diff changeset
    85
  <tr>
cawthron
parents:
diff changeset
    86
    <td><b>Go to File </b></td>
cawthron
parents:
diff changeset
    87
    <td>Opens the associated file  for the breakpoint in an editor, make it active and highlight the breakpoint location. If the file is already open, make it active and the highlight the breakpoint location.</td>
cawthron
parents:
diff changeset
    88
  </tr>
cawthron
parents:
diff changeset
    89
  <tr>
cawthron
parents:
diff changeset
    90
    <td><b>Enable</b></td>
cawthron
parents:
diff changeset
    91
    <td>Enables the selected breakpoints.</td>
cawthron
parents:
diff changeset
    92
  </tr>
cawthron
parents:
diff changeset
    93
  <tr>
cawthron
parents:
diff changeset
    94
    <td><b>Disable</b></td>
cawthron
parents:
diff changeset
    95
    <td>Disables the selected breakpoints. </td>
cawthron
parents:
diff changeset
    96
  </tr>
cawthron
parents:
diff changeset
    97
  <tr>
cawthron
parents:
diff changeset
    98
    <td><b>Remove</b></td>
cawthron
parents:
diff changeset
    99
    <td>Removes the selected breakpoints from the project and Breakpoints view. </td>
cawthron
parents:
diff changeset
   100
  </tr>
cawthron
parents:
diff changeset
   101
  <tr>
cawthron
parents:
diff changeset
   102
    <td><b>Remove All </b></td>
cawthron
parents:
diff changeset
   103
    <td>Removes all  breakpoints from the  project and Breakpoints view. </td>
cawthron
parents:
diff changeset
   104
  </tr>
cawthron
parents:
diff changeset
   105
  <tr>
cawthron
parents:
diff changeset
   106
    <td><b>Select All </b></td>
cawthron
parents:
diff changeset
   107
    <td>Selects all the breakpoints shown in the Breakpoints view. </td>
cawthron
parents:
diff changeset
   108
  </tr>
cawthron
parents:
diff changeset
   109
  <tr>
cawthron
parents:
diff changeset
   110
    <td><b>Copy</b></td>
cawthron
parents:
diff changeset
   111
    <td>Copies the selected breakpoint to the clipboard. </td>
cawthron
parents:
diff changeset
   112
  </tr>
cawthron
parents:
diff changeset
   113
  <tr>
cawthron
parents:
diff changeset
   114
    <td><b>Paste</b></td>
cawthron
parents:
diff changeset
   115
    <td>Always disabled. </td>
cawthron
parents:
diff changeset
   116
  </tr>
cawthron
parents:
diff changeset
   117
  <tr>
cawthron
parents:
diff changeset
   118
    <td><b>Export Breakpoints </b></td>
cawthron
parents:
diff changeset
   119
    <td>Opens the <a href="exporting_breakpoints.htm">Export Breakpoints</a> wizard to store the project's breakpoint data. </td>
cawthron
parents:
diff changeset
   120
  </tr>
cawthron
parents:
diff changeset
   121
  <tr>
cawthron
parents:
diff changeset
   122
    <td><b>Import Breakpoints </b></td>
cawthron
parents:
diff changeset
   123
    <td>Opens the <a href="importing_breakpoints.htm">Import Breakpoints</a> wizard to import stored breakpoint data (.bkpt). </td>
cawthron
parents:
diff changeset
   124
  </tr>
cawthron
parents:
diff changeset
   125
  <tr>
cawthron
parents:
diff changeset
   126
    <td><b>Add Watchpoint (C/C++)... </b></td>
cawthron
parents:
diff changeset
   127
    <td>&nbsp;</td>
cawthron
parents:
diff changeset
   128
  </tr>
cawthron
parents:
diff changeset
   129
  <tr>
cawthron
parents:
diff changeset
   130
    <td><b>Properties</b></td>
cawthron
parents:
diff changeset
   131
    <td>Opens the <a href="properties_breakpoints.htm">Properties for Breakpoint</a> dialog. </td>
cawthron
parents:
diff changeset
   132
  </tr>
cawthron
parents:
diff changeset
   133
</table>
cawthron
parents:
diff changeset
   134
<h4>Other references</h4>
cawthron
parents:
diff changeset
   135
<ul>
cawthron
parents:
diff changeset
   136
  <li><a href="breakpoints.htm">Breakpoints overview  </a></li>
cawthron
parents:
diff changeset
   137
</ul>
cawthron
parents:
diff changeset
   138
<div id="footer">Copyright &copy; 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>
cawthron
parents:
diff changeset
   139
</body>
cawthron
parents:
diff changeset
   140
</html>