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/concepts/breakpoints.htm
author fturovic <frank.turovich@nokia.com>
Tue, 21 Sep 2010 15:50:51 -0500
changeset 2087 617a89f9dffc
parent 1791 727385d8e2b3
child 2131 ff0156b93599
permissions -rw-r--r--
BUG 12110 - text instances of apptrk/systrk changed, more images yet to update
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
1601
c8b627039298 revised variables, watchpoints pages with new images, fixed broken links in F1 help too
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset 
     1
 
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
c8b627039298 revised variables, watchpoints pages with new images, fixed broken links in F1 help too
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset 
     2
 
<html>
c8b627039298 revised variables, watchpoints pages with new images, fixed broken links in F1 help too
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset 
     3
 
<head>
c8b627039298 revised variables, watchpoints pages with new images, fixed broken links in F1 help too
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset 
     4
 
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
c8b627039298 revised variables, watchpoints pages with new images, fixed broken links in F1 help too
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset 
     5
 
<meta http-equiv="Content-Style-Type" content="text/css" />
c8b627039298 revised variables, watchpoints pages with new images, fixed broken links in F1 help too
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset 
     6
 
<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
c8b627039298 revised variables, watchpoints pages with new images, fixed broken links in F1 help too
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset 
     7
 
<title>Breakpoints Overview</title>
c8b627039298 revised variables, watchpoints pages with new images, fixed broken links in F1 help too
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset 
     8
 
<link rel="StyleSheet" href="../../book.css" type="text/css"/>
c8b627039298 revised variables, watchpoints pages with new images, fixed broken links in F1 help too
fturovic <frank.turovich@nokia.com>
parents: 1248
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: 1601
diff changeset 
    10
 
<body >
1601
c8b627039298 revised variables, watchpoints pages with new images, fixed broken links in F1 help too
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset 
    11
 
<h2>Breakpoints Overview</h2>
c8b627039298 revised variables, watchpoints pages with new images, fixed broken links in F1 help too
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset 
    12
 
<p>  A <b>breakpoint</b> is a marker set on a specific line of source code and is designed to halt program execution when encountered by the debugger. After you set a breakpoint at a key point in the program, you can halt its execution, examine its current state, and check register and variable values. You can also change values and alter the flow of normal program execution. Setting breakpoints helps you debug your program and verify its efficiency.</p>
c8b627039298 revised variables, watchpoints pages with new images, fixed broken links in F1 help too
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset 
    13
 
<p>A project can have multiple breakpoints set in the source code files. All breakpoints  in a project are shown in the <a href="../reference/view_breakpoints.htm">Breakpoints</a> view. Breakpoints are enabled or disabled on the currently selected line within  a source code editor by selecting the <b>Run &gt; Toggle Breakpoint</b> menu option, right-clicking the marker bar in the editor and selecting <b>Toggle Breakpoint</b>, or by pressing <span class="code">CTRL-SHIFT-B</span>.</p>
c8b627039298 revised variables, watchpoints pages with new images, fixed broken links in F1 help too
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset 
    14
 
<p>You can set a breakpoint on any executable line of code that the debugger can resolve. Lines containing comments and other non executable code cannot be assigned a breakpoint as they are normally stripped from the  compiled   binary. The debugger must load  the symbols for a module before it can attempt to resolve  breakpoints within the module. This is most easily done using the <a href="../reference/view_executables.htm">Executables</a> view to import a binary file, especially if the binary is not in the workspace. </p>
c8b627039298 revised variables, watchpoints pages with new images, fixed broken links in F1 help too
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset 
    15
 
<p>When the debugger attempts to resolve a breakpoint it will result in:</p>
c8b627039298 revised variables, watchpoints pages with new images, fixed broken links in F1 help too
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset 
    16
 
<ul>
c8b627039298 revised variables, watchpoints pages with new images, fixed broken links in F1 help too
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset 
    17
 
  <li><b>resolved</b> &#8212; the symbols for the module  are loaded  and the breakpoint  located in the executable that&#8217;s currently being debugged, circle icon changes to flagged icon </li>
c8b627039298 revised variables, watchpoints pages with new images, fixed broken links in F1 help too
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset 
    18
 
  <li><b>resolved and moved</b> &#8212;the breakpoint is not found in the executable at the specified point. Debugger moves breakpoint forward in the current function until a line is found that can be resolved. Breakpoint icon moved to source line matching new breakpoint location and changed to flagged icon.</li>
c8b627039298 revised variables, watchpoints pages with new images, fixed broken links in F1 help too
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset 
    19
 
  <li><b>unresolved</b>  &#8212;  if the symbols for the module  are not loaded or the breakpoint was not able to be set within the current function. This may indicate no executable code in the source line or a deadstripped function  not present in the executable. Breakpoint icon remains in unflagged state indicating unresolved status.</li>
c8b627039298 revised variables, watchpoints pages with new images, fixed broken links in F1 help too
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset 
    20
 
</ul>
c8b627039298 revised variables, watchpoints pages with new images, fixed broken links in F1 help too
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset 
    21
 
<p>Breakpoints have enabled and disabled types as well as resolved and unresolved states. Table 1 explains the different breakpoint types and states.</p>
c8b627039298 revised variables, watchpoints pages with new images, fixed broken links in F1 help too
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset 
    22
 
<h5>Table 1 Breakpoint&mdash;type and states </h5>
c8b627039298 revised variables, watchpoints pages with new images, fixed broken links in F1 help too
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset 
    23
 
<table width="90%"  border="0" cellpadding="2" cellspacing="0">
c8b627039298 revised variables, watchpoints pages with new images, fixed broken links in F1 help too
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset 
    24
 
  <tr>
c8b627039298 revised variables, watchpoints pages with new images, fixed broken links in F1 help too
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset 
    25
 
    <th width="15%" scope="col">Type</th>
c8b627039298 revised variables, watchpoints pages with new images, fixed broken links in F1 help too
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset 
    26
 
    <th width="14%" scope="col">State</th>
c8b627039298 revised variables, watchpoints pages with new images, fixed broken links in F1 help too
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset 
    27
 
    <th width="14%" scope="col">Icon</th>
c8b627039298 revised variables, watchpoints pages with new images, fixed broken links in F1 help too
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset 
    28
 
    <th width="71%" scope="col">Explanation</th>
c8b627039298 revised variables, watchpoints pages with new images, fixed broken links in F1 help too
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset 
    29
 
  </tr>
c8b627039298 revised variables, watchpoints pages with new images, fixed broken links in F1 help too
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset 
    30
 
  <tr>
c8b627039298 revised variables, watchpoints pages with new images, fixed broken links in F1 help too
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset 
    31
 
    <td>Enabled</td>
c8b627039298 revised variables, watchpoints pages with new images, fixed broken links in F1 help too
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset 
    32
 
    <td><div align="center">Unresolved</div></td>
c8b627039298 revised variables, watchpoints pages with new images, fixed broken links in F1 help too
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset 
    33
 
    <td><div align="center"><img src="../tasks/breakpoints/images/breakpoints_enabled_icon.png" width="9" height="10" /></div></td>
c8b627039298 revised variables, watchpoints pages with new images, fixed broken links in F1 help too
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset 
    34
 
    <td>Indicates that the breakpoint is currently enabled but not located in the executable during a debug session. Debugger cannot halt program execution.</td>
c8b627039298 revised variables, watchpoints pages with new images, fixed broken links in F1 help too
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset 
    35
 
  </tr>
c8b627039298 revised variables, watchpoints pages with new images, fixed broken links in F1 help too
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset 
    36
 
  <tr>
c8b627039298 revised variables, watchpoints pages with new images, fixed broken links in F1 help too
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset 
    37
 
    <td>Enabled</td>
c8b627039298 revised variables, watchpoints pages with new images, fixed broken links in F1 help too
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset 
    38
 
    <td><div align="center">Resolved</div></td>
c8b627039298 revised variables, watchpoints pages with new images, fixed broken links in F1 help too
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset 
    39
 
    <td><div align="center"> <img src="../images/icons/breakpoints_enabled_icon.png" width="15" height="12" /></div></td>
c8b627039298 revised variables, watchpoints pages with new images, fixed broken links in F1 help too
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset 
    40
 
    <td>Indicates that the breakpoint is currently enabled and resolved for the source line. The debugger halts program execution at an enabled breakpoint. </td>
c8b627039298 revised variables, watchpoints pages with new images, fixed broken links in F1 help too
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset 
    41
 
  </tr>
c8b627039298 revised variables, watchpoints pages with new images, fixed broken links in F1 help too
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset 
    42
 
  <tr>
c8b627039298 revised variables, watchpoints pages with new images, fixed broken links in F1 help too
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset 
    43
 
    <td>Disabled</td>
c8b627039298 revised variables, watchpoints pages with new images, fixed broken links in F1 help too
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset 
    44
 
    <td><div align="center">Unresolved</div></td>
c8b627039298 revised variables, watchpoints pages with new images, fixed broken links in F1 help too
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset 
    45
 
    <td><div align="center"><img src="../tasks/breakpoints/images/breakpoints_disabled_icon.png" width="12" height="11" /></div></td>
c8b627039298 revised variables, watchpoints pages with new images, fixed broken links in F1 help too
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset 
    46
 
    <td>Indicates that the breakpoint is currently disabled but not located in the executable during a debug session. The debugger does not halt program execution at a disabled breakpoint.</td>
c8b627039298 revised variables, watchpoints pages with new images, fixed broken links in F1 help too
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset 
    47
 
  </tr>
c8b627039298 revised variables, watchpoints pages with new images, fixed broken links in F1 help too
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset 
    48
 
  <tr>
c8b627039298 revised variables, watchpoints pages with new images, fixed broken links in F1 help too
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset 
    49
 
    <td>Disabled</td>
c8b627039298 revised variables, watchpoints pages with new images, fixed broken links in F1 help too
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset 
    50
 
    <td><div align="center">Resolved</div></td>
c8b627039298 revised variables, watchpoints pages with new images, fixed broken links in F1 help too
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset 
    51
 
    <td><div align="center"><img src="../images/icons/breakpoints_disabled_icon.png" width="15" height="12" /></div></td>
c8b627039298 revised variables, watchpoints pages with new images, fixed broken links in F1 help too
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset 
    52
 
    <td>Indicates that the breakpoint is currently disabled and resolved for the source line. The debugger does not halt program execution at a disabled breakpoint.</td>
c8b627039298 revised variables, watchpoints pages with new images, fixed broken links in F1 help too
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset 
    53
 
  </tr>
c8b627039298 revised variables, watchpoints pages with new images, fixed broken links in F1 help too
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset 
    54
 
</table>
c8b627039298 revised variables, watchpoints pages with new images, fixed broken links in F1 help too
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset 
    55
 
<p>Other references </p>
c8b627039298 revised variables, watchpoints pages with new images, fixed broken links in F1 help too
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset 
    56
 
<ul>
c8b627039298 revised variables, watchpoints pages with new images, fixed broken links in F1 help too
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset 
    57
 
  <li><a href="../reference/view_executables.htm">Executables view</a></li>
c8b627039298 revised variables, watchpoints pages with new images, fixed broken links in F1 help too
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset 
    58
 
  <li><a href="../tasks/breakpoints/pgm_bp_setting.htm">Setting Breakpoints</a></li>
c8b627039298 revised variables, watchpoints pages with new images, fixed broken links in F1 help too
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset 
    59
 
  <li><a href="../tasks/breakpoints/pgm_bp_enable.htm">Enabling Breakpoints</a></li>
c8b627039298 revised variables, watchpoints pages with new images, fixed broken links in F1 help too
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset 
    60
 
  <li><a href="../tasks/breakpoints/pgm_bp_disable.htm">Disabling Breakpoints</a></li>
c8b627039298 revised variables, watchpoints pages with new images, fixed broken links in F1 help too
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset 
    61
 
  <li><a href="../tasks/breakpoints/pgm_bp_clearing.htm">Clearing Breakpoints</a></li>
c8b627039298 revised variables, watchpoints pages with new images, fixed broken links in F1 help too
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset 
    62
 
</ul>
c8b627039298 revised variables, watchpoints pages with new images, fixed broken links in F1 help too
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset 
    63
 
<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>
c8b627039298 revised variables, watchpoints pages with new images, fixed broken links in F1 help too
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset 
    64
 












c8b627039298
revised variables, watchpoints pages with new images, fixed broken links in F1 help too



fturovic <frank.turovich@nokia.com>


parents: 
1248

diff
changeset




    65


</body>













c8b627039298
revised variables, watchpoints pages with new images, fixed broken links in F1 help too



fturovic <frank.turovich@nokia.com>


parents: 
1248

diff
changeset




    66


</html>















FCL/sftools/dev/ide/carbidecpp