core/com.nokia.carbide.cpp.doc.user/html/tasks/breakpoints/pgm_bp_setting.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>Setting 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>Setting Breakpoints</h2>
cawthron
parents:
diff changeset
    12
<p>Use the <b>Set Breakpoint</b> command (<span class="code">Ctrl+Shift+B</span>) to set a breakpoint. A regular breakpoint suspends program execution. The debugger executes the line of source code that contains the regular breakpoint.</p>
cawthron
parents:
diff changeset
    13
<p class="note"><strong>TIP</strong> If you find that a breakpoint is not being hit, verify that the EXE or DLL is listed in the <a href="../../reference/view_executables.htm">Executables</a> view. </p>
cawthron
parents:
diff changeset
    14
<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
    15
<p>Figure 1 shows some source code and the marker bar to the left of the source code. The selected line shows the breakpoint dot that appears in the marker bar when a breakpoint is set.</p>
cawthron
parents:
diff changeset
    16
<p align="center"><img src="images/breakpoints_marker_bar.png" width="582" height="230" /></p>
cawthron
parents:
diff changeset
    17
<p class="figure">Figure 1 - Setting Breakpoints in an editor view </p>
cawthron
parents:
diff changeset
    18
<div class="step">
cawthron
parents:
diff changeset
    19
  <h4>Setting a Breakpoint in Editor or Disassembly Views</h4>
cawthron
parents:
diff changeset
    20
  <ul>
cawthron
parents:
diff changeset
    21
    <li>Double-click the marker bar to the left of the line of code where you want to place a breakpoint </li>
cawthron
parents:
diff changeset
    22
  </ul>
cawthron
parents:
diff changeset
    23
  <blockquote>
cawthron
parents:
diff changeset
    24
    <p>or</p>
cawthron
parents:
diff changeset
    25
  </blockquote>
cawthron
parents:
diff changeset
    26
  <ul>
cawthron
parents:
diff changeset
    27
    <li>Right-click in the marker bar and select Toggle  Breakpoint</li>
cawthron
parents:
diff changeset
    28
  </ul>
cawthron
parents:
diff changeset
    29
  <blockquote>
cawthron
parents:
diff changeset
    30
    <p>or</p>
cawthron
parents:
diff changeset
    31
  </blockquote>
cawthron
parents:
diff changeset
    32
  <ul>
cawthron
parents:
diff changeset
    33
    <li>Click on the line of code and select Run &gt;  Toggle   Breakpoint from the program menu bar </li>
cawthron
parents:
diff changeset
    34
  </ul>
cawthron
parents:
diff changeset
    35
  <blockquote>
cawthron
parents:
diff changeset
    36
    <p>or</p>
cawthron
parents:
diff changeset
    37
  </blockquote>
cawthron
parents:
diff changeset
    38
  <ul>
cawthron
parents:
diff changeset
    39
    <li>While selecting a line, press Ctrl+Shift+B  </li>
cawthron
parents:
diff changeset
    40
    <p>The active breakpoint dot appears (<img src="images/breakpoints_enabled_icon.png" width="9" height="10" />) in the marker bar. If the breakpoint is  <a href="../../concepts/breakpoints.htm">resolved</a> during the debug session,  the debugger halts program execution at the line with the resolved breakpoint (<img src="../../images/icons/breakpoints_enabled_icon.png" width="15" height="12" />).</p>
cawthron
parents:
diff changeset
    41
<p class="note"><span class="note"><b>NOTE</b> Setting a breakpoint in a file affects execution of all build targets that include that file.</span></p>
cawthron
parents:
diff changeset
    42
  </ul>
cawthron
parents:
diff changeset
    43
</div>
cawthron
parents:
diff changeset
    44
<p>For more information on breakpoints, see <b>C/C++ Development User Guide &gt; Concepts &gt; Debug &gt; Breakpoints</b>.</p>
cawthron
parents:
diff changeset
    45
<h5>Related concepts</h5>
cawthron
parents:
diff changeset
    46
<ul>
cawthron
parents:
diff changeset
    47
  <li><a href="../../concepts/breakpoints.htm">Breakpoints</a></li>
cawthron
parents:
diff changeset
    48
</ul>
cawthron
parents:
diff changeset
    49
<h5>Related tasks</h5>
cawthron
parents:
diff changeset
    50
<ul>
cawthron
parents:
diff changeset
    51
  <li><a href="pgm_bp_enable.htm">Enabling Breakpoints</a></li>
cawthron
parents:
diff changeset
    52
  <li><a href="pgm_bp_disable.htm">Disabling Breakpoints</a></li>
cawthron
parents:
diff changeset
    53
  <li><a href="pgm_bp_clearing.htm">Removing Breakpoints</a></li>
cawthron
parents:
diff changeset
    54
</ul>
cawthron
parents:
diff changeset
    55
<h5>Related references </h5>
cawthron
parents:
diff changeset
    56
<ul>
cawthron
parents:
diff changeset
    57
  <li><a href="../../reference/view_breakpoints.htm">Breakpoints view</a></li>
cawthron
parents:
diff changeset
    58
</ul>
cawthron
parents:
diff changeset
    59
<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
    60
cawthron
parents:
diff changeset
    61
</body>
cawthron
parents:
diff changeset
    62
</html>