core/com.nokia.carbide.cpp.doc.user/html/debugger/breakpoints/toggling_breakpoints.htm
author dan.podwall@nokia.com
Mon, 06 Apr 2009 14:56:28 -0500
changeset 56 887bd61e1328
parent 2 d760517a8095
child 413 410577fa5534
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>Enabling, Disabling and Removing Breakpoints</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> Enabling, Disabling and Removing Breakpoints </h2>
cawthron
parents:
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>
cawthron
parents:
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>
cawthron
parents:
diff changeset
    14
<h4>Enabling and Disabling breakpoints</h4>
cawthron
parents:
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>
cawthron
parents:
diff changeset
    16
<ul>
cawthron
parents:
diff changeset
    17
  <li>Choose the <b>Run &gt; Toggle Breakpoint</b> menu option</li>
cawthron
parents:
diff changeset
    18
  <li>Right-click and choose <b>Toggle Breakpoint</b> from the context menu</li>
cawthron
parents:
diff changeset
    19
  <li>Press <span class="code">Ctrl+Shift+B</span>  </li>
cawthron
parents:
diff changeset
    20
  <li>Double-click in the marker bar to enable or disable a breakpoint on that source line </li>
cawthron
parents:
diff changeset
    21
</ul>
cawthron
parents:
diff changeset
    22
<h4>Removing breakpoints</h4>
cawthron
parents:
diff changeset
    23
<p>In the  <a href="../../reference/view_breakpoints.htm">Breakpoints</a> view, locate the source code line to modify and: </p>
cawthron
parents:
diff changeset
    24
<ul>
cawthron
parents:
diff changeset
    25
  <li>Right-click the breakpoint and choose <b>Remove</b> from the context menu to remove the breakpoint </li>
cawthron
parents:
diff changeset
    26
</ul>
cawthron
parents:
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>
cawthron
parents:
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>
cawthron
parents:
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>
cawthron
parents:
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>
cawthron
parents:
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>
cawthron
parents:
diff changeset
    32
<h4>Other references</h4>
cawthron
parents:
diff changeset
    33
<ul>
cawthron
parents:
diff changeset
    34
  <li><a href="breakpoints.htm">Breakpoints overview </a></li>
cawthron
parents:
diff changeset
    35
</ul>
cawthron
parents:
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>
cawthron
parents:
diff changeset
    37
</body>
cawthron
parents:
diff changeset
    38
</html>