|
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"> |
|
2 <html lang="en"> |
|
3 |
|
4 <head> |
|
5 <meta http-equiv="Content-Language" content="en-us"> |
|
6 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> |
|
7 <title>Debugging your project</title> |
|
8 <link rel="stylesheet" type="text/css" href="../help.css"> |
|
9 </head> |
|
10 |
|
11 <body> |
|
12 |
|
13 <h1>Debugging a project</h1> |
|
14 |
|
15 <p>The debugger lets you control the execution of your program by setting |
|
16 breakpoints, suspending executed programs, stepping through your code, and |
|
17 examining the contents of variables.</p> |
|
18 <p>To debug a project:</p> |
|
19 <ol> |
|
20 <li>Click <b>Run > Debug Configurations...</b>.<p>The Debug Configurations dialog opens.</li> |
|
21 <li>Double-click <b>C/C++ Application</b>.</li> |
|
22 <li>In the <b>Name</b> field, type <b>Hello World</b>.</li> |
|
23 <p>You can now select this debug launch configuration by name the next time |
|
24 that you debug this project.</p> |
|
25 <li>In the <b>Project</b> box, type or choose your project, e.g. <b>HelloWorld</b>. |
|
26 <br> |
|
27 Your executable should be selected under "C/C++ Application." |
|
28 <br>If not, the <b>Search Project</b> button should find the executable in the project. |
|
29 <p> </p> |
|
30 </li> |
|
31 <ul> |
|
32 <li>If you see the error "[Debugger]: No debugger available", select the Debugger tab |
|
33 and choose a valid debugger for your platform (e.g. gdb/mi). |
|
34 </li> |
|
35 </ul> |
|
36 <li>Click <b>Debug</b>.</li> |
|
37 <p>You will be prompted to switch to the Debug Perspective. Click <b>Yes</b></p> |
|
38 <p>You will now see the debug perspective with the hello.exe application window open. |
|
39 The C/C++ editor repositions in the perspective.</p> |
|
40 <ul> |
|
41 <li>If you see an error in the editor "Can't find source file" you can use the buttons provided |
|
42 to point to your source file, e.g. "Locate File." |
|
43 </li> |
|
44 </ul> |
|
45 <li>In the left margin of the main.cpp window, double-click to set a |
|
46 breakpoint on:<br> |
|
47 cout << "You just entered" |
|
48 <br>You'll see an icon there indicating the breakpoint is set.</br> |
|
49 </li> |
|
50 <li>Click <b>Run > Resume</b>. |
|
51 <br>Or, you can use the <b>Resume</b> button (green arrow) on the toolbar <i>of the Debug View</i> |
|
52 </li> |
|
53 <li>When prompted, in the Console view, type a value other than 'm', and hit Enter/Return.<br> |
|
54 The breakpoint will be hit.</li> |
|
55 <li>In the <b>Variables</b> view, verify that the variable is not 'm'.</li> |
|
56 <li>Click <b>Run > Resume</b>.</li> |
|
57 <li>When prompted, again type a value other than 'm' in the Console view, and press Enter/Return.</li> |
|
58 <p>The breakpoint will be hit.</p> |
|
59 <li>In the <b>Variables</b> view, verify that the variable is not 'm'.</li> |
|
60 <li>In the <b>Variables</b> view, right-click the input variable, and select <b>Change Value...</b> |
|
61 and type <b>'m'</b> <i>between the single quotes</i> and hit <b>OK</b>.</li> |
|
62 <li>Click <b>Run > Resume</b>.</li> |
|
63 <p>The output in the hello.exe application window is:<br> |
|
64 "You just entered m, you need to enter m to exit." |
|
65 <li>The application terminates and the debug session ends. The debug |
|
66 perspective remains open.</li> |
|
67 </ol> |
|
68 |
|
69 <p>To learn more about debugging, see the related debug conceptual topics.</p> |
|
70 |
|
71 <p align="left"> <a href="cdt_w_build.htm"> |
|
72 <img border="0" src="../images/ngback.gif" width="16" height="16" alt="Back icon"></a><b> <a href="cdt_w_build.htm">Back: Building a project</a></b> </p> |
|
73 |
|
74 <p><img border="0" src="../images/ngconcepts.gif" ALT="Related concepts" width="143" height="21"> |
|
75 <br> |
|
76 <a href="../concepts/cdt_c_over_dbg.htm">Debug overview</a><br> |
|
77 <a href="../concepts/cdt_c_dbg_info.htm">Debug information</a></p> |
|
78 <p><img border="0" src="../images/ngtasks.gif" ALT="Related tasks" width="143" height="21"> |
|
79 <br> |
|
80 <a href="../tasks/cdt_o_debug.htm">Debugging</a></p> |
|
81 <p><img border="0" src="../images/ngref.gif" ALT="Related reference" width="143" height="21"> |
|
82 <br> |
|
83 <a href="../reference/cdt_u_dbg_view.htm">Debug view</a><br> |
|
84 <a href="../reference/cdt_u_dbg_view.htm">Debug launch controls</a><br> |
|
85 </p> |
|
86 <p> |
|
87 <img src="../images/ng00_04a.gif" ALT="QNX Copyright Statement" > |
|
88 </body> |
|
89 |
|
90 </html> |