Skip to main content
aboutsummaryrefslogtreecommitdiffstats
blob: 9c6a8659fe17c4134d6c72affe155cad7282b6d8 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<html lang="en">

<head>
	<meta http-equiv="Content-Language" content="en-us">
	<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
	<title>Debugging your project</title>
	<link rel="stylesheet" type="text/css" href="../help.css">
</head>

<body>

<h1>Debugging a project</h1>

<p>The debugger lets you control the execution of your program by setting 
breakpoints, suspending executed programs, stepping through your code, and 
examining the contents of variables.</p>
<h2>To debug a project:</h2>
<ol>
  <li>Click the <strong>Run  &gt; Debug Configurations...</strong> menu option.<br>
      <br>
      <p>The <strong>Debug</strong> <strong>Configurations</strong> dialog opens.<br>
              <br>
                <img src="../images/cdt_w_debug_configurations_01.png" width="873" height="662"><br>
      <br>
  </li>
  <li>Double-click <strong>C/C++  Application</strong> to create a new launch configuration.<br>
          <br>
            <img src="../images/cdt_w_debug_configurations_02.png" width="763" height="601"><br>
      <br>
      <p>If a project is selected in the <a href="../reference/cdt_u_project_explorer_view.htm">Project Explorer</a> view the following data is automatically entered, take a moment to verify its accuracy or change as needed.      <br>
          <br>
      </p>
      <ol type="a">
          <li>In the <strong>Name</strong> edit box, type the project name, like <strong>Hello World</strong>.<br>
              <br>
              You can now select this debug launch configuration by name the next time 
              that you debug this project.<br>
              <br>
          </li>
          <li>In the <strong>C/C++ Application</strong> edit box, type the name of the executable if its not already entered. <br>
              <br>
              If not, click the <strong>Search Project</strong> button to locate the executable in the project.<br>
              <br>
          </li>
          <li>
                <p>In the <strong>Project</strong> edit box, type or choose your project, e.g. <strong>HelloWorld</strong>.<br>
                </p>
              <p>&nbsp;</p>
              <p><strong>NOTE</strong> If you see the error "<span class="typewriter">[Debugger]: No debugger available</span>", select the <strong>Debugger</strong> tab
                      and choose a valid debugger for your platform (e.g. <span class="typewriter">gdb/mi</span>). <br>
                    <br>
                </p>
          </li>
      </ol>
    </li>
  <li>Click <strong>Debug</strong>.</li>
  <p>You may be prompted to switch to the <strong>Debug</strong> perspective.  Click <strong>Yes</strong></p>
  <p>The <strong>Debug</strong> perspective appears with the <span class="typewriter">helloworld.exe</span> application window open. 
  The C/C++ editor repositions in the perspective.</p>
</ol>
<blockquote>
    <p><strong>NOTE</strong> If you see the error "<span class="typewriter">Can't find source file</span>"  in the editor view, use the <strong>Locate File</strong> button
        to locate your source file.<br>
      </p>
</blockquote>
<ol>
    <li>In the left margin of the <span class="typewriter">main.cpp</span> window, double-click to set a 
        breakpoint on:<br>
        <br>
        &nbsp;<span class="typewriter">cout &lt;&lt; &quot;You just entered&quot;
        </span><br>
        <br>
        You'll see a blue circle (<img src="../images/icon_breakpoint_obj.gif" alt="Breakpoint" width="16" height="16" align="absmiddle">) there indicating the breakpoint is set.</br>
        <br>
        <br>
    </li>
    <li>Click <strong>Run  &gt; Resume</strong>.
        <br>
        <br>
        Or, you can use the <strong>Resume</strong> button (<img src="../images/icon_db_resume.png" alt="Resume" width="19" height="14" align="absmiddle">) on the toolbar of the <strong>Debug</strong> view
        .<br>
        <br>
    </li>
    <li>When prompted, in the <strong>Console</strong> view, type a value other than 'm', and press Enter.<br>
        <br>
        The breakpoint will be hit.<br>
        <br>
    </li>
    <li>In the <strong>Variables</strong> view, verify that the variable is not 'm'.<br>
        <br>
    </li>
    <li>Click <strong>Run  &gt; Resume</strong>.<br>
        <br>
    </li>
    <li>When prompted, again type a value other than 'm' in the <a href="../reference/cdt_u_console_view.htm">Console</a> view, and press Enter.</li>
    <p>The breakpoint will be hit.</p>
    <li>In the <strong>Variables</strong> view, verify that the variable is not 'm'.<br>
        <br>
    </li>
    <li>In the <strong>Variables</strong> view, right-click the input variable, and select <strong>Change Value...</strong> 
        and type <strong>'m'</strong> <em>between the single quotes</em> and hit <strong>OK</strong>.<br>
        <br>
    </li>
    <li>Click <strong>Run  &gt; Resume</strong>.</li>
    <p>The output in the <span class="typewriter">helloworld.exe</span> application window is: &nbsp;&quot;<span class="typewriter">You just entered m, you need to enter m to exit.</span>&quot;
    <li>The application terminates and the debug session ends. The <strong>Debug</strong>  perspective remains open.</li>
</ol>
<p>To learn more about   debugging, see   the related debug conceptual topics.</p>

<p align="left"> <a href="cdt_w_build.htm">
<img border="0" src="../images/ngback.gif" width="16" height="16" alt="Back icon"></a><strong> <a href="cdt_w_build.htm">Back: Building a project</a></strong>&nbsp;&nbsp;&nbsp; </p>

<p><img border="0" src="../images/ngconcepts.gif" ALT="Related concepts" width="143" height="21">
<br>
<a href="../concepts/cdt_c_over_dbg.htm">Debug overview</a><br>
<a href="../concepts/cdt_c_dbg_info.htm">Debug information</a></p>
<p><img border="0" src="../images/ngtasks.gif" ALT="Related tasks" width="143" height="21">
<br>
<a href="../tasks/cdt_o_debug.htm">Debugging</a></p>
<p><img border="0" src="../images/ngref.gif" ALT="Related reference" width="143" height="21">
<br>
<a href="../reference/cdt_u_dbg_view.htm">Debug view</a><br>
<a href="../reference/cdt_u_dbg_view.htm">Debug launch controls</a><br>
&nbsp;</p>
<p>
<img src="../images/ng00_04a.gif" ALT="QNX Copyright Statement" >
</body>

</html>

Back to the top