| author | fturovic <frank.turovich@nokia.com> |
| Fri, 16 Apr 2010 09:51:37 -0500 | |
| branch | RCL_2_4 |
| changeset 1225 | a546534a48de |
| parent 0 | fb279309251b |
| permissions | -rw-r--r-- |
|
1225
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
1 |
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
2 |
<html> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
3 |
<head> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
4 |
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" /> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
5 |
<meta http-equiv="Content-Style-Type" content="text/css" /> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
6 |
<meta name="LASTUPDATED" content="06/17/05 11:09:43" /> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
7 |
<title>Breakpoints</title> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
8 |
<link rel="StyleSheet" href="../../book.css" type="text/css"/> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
9 |
</head> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
10 |
<body bgcolor="#FFFFFF"> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
11 |
<h2>Breakpoints </h2> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
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> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
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 > 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> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
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> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
15 |
<p>When the debugger attempts to resolve a breakpoint it will result in:</p> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
16 |
<ul> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
17 |
<li><b>resolved</b> — the symbols for the module are loaded and the breakpoint located in the executable that’s currently being debugged, circle icon changes to flagged icon </li> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
18 |
<li><b>resolved and moved</b> —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> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
19 |
<li><b>unresolved</b> — 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> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
20 |
</ul> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
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> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
22 |
<h5>Table 1 Breakpoint—type and states </h5> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
23 |
<table width="90%" border="0" cellpadding="2" cellspacing="0"> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
24 |
<tr> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
25 |
<th width="15%" scope="col">Type</th> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
26 |
<th width="14%" scope="col">State</th> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
27 |
<th width="14%" scope="col">Icon</th> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
28 |
<th width="71%" scope="col">Explanation</th> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
29 |
</tr> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
30 |
<tr> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
31 |
<td>Enabled</td> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
32 |
<td><div align="center">Unresolved</div></td> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
33 |
<td><div align="center"><img src="../tasks/breakpoints/images/breakpoints_enabled_icon.png" width="9" height="10" /></div></td> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
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> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
35 |
</tr> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
36 |
<tr> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
37 |
<td>Enabled</td> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
38 |
<td><div align="center">Resolved</div></td> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
39 |
<td><div align="center"> <img src="../images/icons/breakpoints_enabled_icon.png" width="15" height="12" /></div></td> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
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> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
41 |
</tr> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
42 |
<tr> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
43 |
<td>Disabled</td> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
44 |
<td><div align="center">Unresolved</div></td> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
45 |
<td><div align="center"><img src="../tasks/breakpoints/images/breakpoints_disabled_icon.png" width="12" height="11" /></div></td> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
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> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
47 |
</tr> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
48 |
<tr> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
49 |
<td>Disabled</td> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
50 |
<td><div align="center">Resolved</div></td> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
51 |
<td><div align="center"><img src="../images/icons/breakpoints_disabled_icon.png" width="15" height="12" /></div></td> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
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> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
53 |
</tr> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
54 |
</table> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
55 |
<p>Other references </p> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
56 |
<ul> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
57 |
<li><a href="../reference/view_executables.htm">Executables view</a></li> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
58 |
<li><a href="../tasks/breakpoints/pgm_bp_setting.htm">Setting Breakpoints</a></li> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
59 |
<li><a href="../tasks/breakpoints/pgm_bp_enable.htm">Enabling Breakpoints</a></li> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
60 |
<li><a href="../tasks/breakpoints/pgm_bp_disable.htm">Disabling Breakpoints</a></li> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
61 |
<li><a href="../tasks/breakpoints/pgm_bp_clearing.htm">Clearing Breakpoints</a></li> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
62 |
</ul> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
63 |
<div id="footer">Copyright © 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> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
64 |
|
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
65 |
</body> |
|
a546534a48de
minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
66 |
</html> |