core/com.nokia.carbide.cpp.doc.user/html/debugger/breakpoints/toggling_breakpoints.htm
author fturovic <frank.turovich@nokia.com>
Tue, 11 Aug 2009 14:21:42 -0500
changeset 413 410577fa5534
parent 0 fb279309251b
child 1225 a546534a48de
permissions -rw-r--r--
additional broken lins fixed and one image re-added to manual
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
413
410577fa5534 additional broken lins fixed and one image re-added to manual
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
410577fa5534 additional broken lins fixed and one image re-added to manual
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     2
<html>
410577fa5534 additional broken lins fixed and one image re-added to manual
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     3
<head>
410577fa5534 additional broken lins fixed and one image re-added to manual
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     4
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
410577fa5534 additional broken lins fixed and one image re-added to manual
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     5
<meta http-equiv="Content-Style-Type" content="text/css" />
410577fa5534 additional broken lins fixed and one image re-added to manual
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     6
<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
410577fa5534 additional broken lins fixed and one image re-added to manual
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     7
<title>Enabling, Disabling and Removing Breakpoints</title>
410577fa5534 additional broken lins fixed and one image re-added to manual
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     8
<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
410577fa5534 additional broken lins fixed and one image re-added to manual
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     9
</head>
410577fa5534 additional broken lins fixed and one image re-added to manual
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    10
<body bgcolor="#FFFFFF">
410577fa5534 additional broken lins fixed and one image re-added to manual
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    11
<h2> Enabling, Disabling and Removing Breakpoints </h2>
410577fa5534 additional broken lins fixed and one image re-added to manual
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    12
<p>Use the <b>Toggle Breakpoint</b> command  (<span class="code">Ctrl+Shift+B</span>) to set a regular breakpoint in an <a href="PLUGINS_ROOT/org.eclipse.cdt.doc.user/reference/cdt_u_editor_view.htm">Editor</a>  or  <a href="../../reference/view_disassembly.htm">Disassembly</a> view. Only a single breakpoint can exist on a source code line. A regular breakpoint suspends program execution when it is hit, or executed, during a debug session. The debugger executes the line of source code that contains the regular breakpoint, then opens the <a href="../../reference/perspective_debug.htm">Debug</a> perspective to allow examination and modification.</p>
410577fa5534 additional broken lins fixed and one image re-added to manual
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    13
<p>If a regular breakpoint already exists on the  selected line, as indicated by the enabled breakpoint badge (<img src="../../tasks/breakpoints/images/breakpoints_enabled_icon.png" width="9" height="10" align="baseline">) in the marker bar,  use <b>Toggle Breakpoint</b> to remove the breakpoint.</p>
410577fa5534 additional broken lins fixed and one image re-added to manual
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    14
<h4>Enabling and Disabling breakpoints</h4>
410577fa5534 additional broken lins fixed and one image re-added to manual
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    15
<p>Once a source line is selected in an editor or Disassembly view, the methods of toggling breakpoints to be enabled of disabled include: </p>
410577fa5534 additional broken lins fixed and one image re-added to manual
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    16
<ul>
410577fa5534 additional broken lins fixed and one image re-added to manual
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    17
  <li>Choose the <b>Run &gt; Toggle Breakpoint</b> menu option</li>
410577fa5534 additional broken lins fixed and one image re-added to manual
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    18
  <li>Right-click and choose <b>Toggle Breakpoint</b> from the context menu</li>
410577fa5534 additional broken lins fixed and one image re-added to manual
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    19
  <li>Press <span class="code">Ctrl+Shift+B</span>  </li>
410577fa5534 additional broken lins fixed and one image re-added to manual
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    20
  <li>Double-click in the marker bar to enable or disable a breakpoint on that source line </li>
410577fa5534 additional broken lins fixed and one image re-added to manual
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    21
</ul>
410577fa5534 additional broken lins fixed and one image re-added to manual
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    22
<h4>Removing breakpoints</h4>
410577fa5534 additional broken lins fixed and one image re-added to manual
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    23
<p>In the  <a href="../../reference/view_breakpoints.htm">Breakpoints</a> view, locate the source code line to modify and: </p>
410577fa5534 additional broken lins fixed and one image re-added to manual
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    24
<ul>
410577fa5534 additional broken lins fixed and one image re-added to manual
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    25
  <li>Right-click the breakpoint and choose <b>Remove</b> from the context menu to remove the breakpoint </li>
410577fa5534 additional broken lins fixed and one image re-added to manual
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    26
</ul>
410577fa5534 additional broken lins fixed and one image re-added to manual
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    27
<p class="note"><strong>NOTE</strong> Once a breakpoint is removed from the Breakpoints view it cannot be recovered using the Breakpoints view, it must be set in an editor or disassembly view. </p>
410577fa5534 additional broken lins fixed and one image re-added to manual
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    28
<p>Breakpoints must first be loaded and resolved before they can be hit during a debug session. See <a href="resolving_breakpoints.htm">Resolving Breakpoint States</a> for more information on the various states a breakpoint can exhibit. </p>
410577fa5534 additional broken lins fixed and one image re-added to manual
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    29
<p>See <a href="exporting_breakpoints.htm">Saving and importing breakpoints</a> for information on storing breakpoint data sets for sharing or re-use. </p>
410577fa5534 additional broken lins fixed and one image re-added to manual
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    30
<p class="note"><strong>TIP</strong> If you find that a breakpoint is not being hit during a debug session, verify that the EXE or DLL is listed in the <a href="../../reference/view_executables.htm">Executables</a> view. </p>
410577fa5534 additional broken lins fixed and one image re-added to manual
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    31
<p class="note"><strong>TIP</strong> If debugging a server launched by a client, you must attach to the server  process using the <a href="../../reference/view_symbian_kernel.htm">Symbian OS Data</a> view in order to hit the breakpoints in the server. Alternately, you can launch the server and  client as two independent EXEs using the same COM port and debug them that way.</p>
410577fa5534 additional broken lins fixed and one image re-added to manual
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    32
<h4>Other references</h4>
410577fa5534 additional broken lins fixed and one image re-added to manual
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    33
<ul>
410577fa5534 additional broken lins fixed and one image re-added to manual
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    34
  <li><a href="breakpoints.htm">Breakpoints overview </a></li>
410577fa5534 additional broken lins fixed and one image re-added to manual
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    35
</ul>
410577fa5534 additional broken lins fixed and one image re-added to manual
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    36
<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>
410577fa5534 additional broken lins fixed and one image re-added to manual
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    37
</body>
410577fa5534 additional broken lins fixed and one image re-added to manual
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    38
</html>