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/projects/launch/page_debugger.htm
author fturovic <frank.turovich@nokia.com>
Wed, 06 Oct 2010 10:31:32 -0500
changeset 2131 ff0156b93599
parent 2087 617a89f9dffc
permissions -rw-r--r--
moved inf, mmp, remote conn, and views to project folder
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
819
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
     1
 
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
     2
 
<html>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
     3
 
<head>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
     4
 
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
     5
 
<meta http-equiv="Content-Style-Type" content="text/css" />
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
     6
 
<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
     7
 
<title>Carbide Debugger panes</title>
2087
617a89f9dffc BUG 12110 - text instances of apptrk/systrk changed, more images yet to update
fturovic <frank.turovich@nokia.com>
parents: 2009
diff changeset 
     8
 
<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
617a89f9dffc BUG 12110 - text instances of apptrk/systrk changed, more images yet to update
fturovic <frank.turovich@nokia.com>
parents: 2009
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: 1754
diff changeset 
    10
 
<body >
819
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    11
 
<h2>Debugger panes</h2>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    12
 
<p>The options shown in the <b>Debugger</b> page differ based upon the type of launch configuration. Generally, the options fall into these choices: </p>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    13
 
<ul>
2087
617a89f9dffc BUG 12110 - text instances of apptrk/systrk changed, more images yet to update
fturovic <frank.turovich@nokia.com>
parents: 2009
diff changeset 
    14
 
  <li><a href="#emulator_mode">Emulation Debugger page</a> (<i>Emulator</i>) </li>
617a89f9dffc BUG 12110 - text instances of apptrk/systrk changed, more images yet to update
fturovic <frank.turovich@nokia.com>
parents: 2009
diff changeset 
    15
 
  <li><a href="#trk_runmode">Run-mode Debugger page</a> (<i>Device (Install SIS)</i>) </li>
617a89f9dffc BUG 12110 - text instances of apptrk/systrk changed, more images yet to update
fturovic <frank.turovich@nokia.com>
parents: 2009
diff changeset 
    16
 
  <li><a href="#trk_stopmode">Stop-mode Debugger page</a> (<i>Device, Device (Attach to Process)</i>) </li>
819
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    17
 
</ul>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    18
 
<h3><a name="emulator_mode" id="emulator_mode"></a>Emulation Debugger page </h3>
2131
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents: 2087
diff changeset 
    19
 
<p>The <b>Symbian <a href="emulation.htm">Emulator</a></b> launch configurations the <b>Debugger</b> page to specify  entry point breaks and which  logs to output to the Console view.</p>
1992
9711068fca7e updated images and pages associated with launch changes as per Warrens message
fturovic <frank.turovich@nokia.com>
parents: 1791
diff changeset 
    20
 
<p align="center"><img src="images/page_debugger_emulation.png" width="685" height="219"></p>
819
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    21
 
<p class="figure">Figure 1 - Debugger page showing emulation options </p>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    22
 
<h5>Table 1. Debugger page &mdash; emulation options </h5>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    23
 
<table width="94%"  border="0" cellpadding="2" cellspacing="0">
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    24
 
  <tr>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    25
 
    <th width="38%" scope="col">Option</th>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    26
 
    <th width="62%" scope="col">Explanation</th>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    27
 
  </tr>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    28
 
  <tr>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    29
 
    <td><b>Break at entry point </b></td>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    30
 
    <td>Select to halt program execution at a specified
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    31
 
      function or address. Enter the desired function
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    32
 
      name or address in the corresponding field. If you
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    33
 
      enter an address, ensure that it is correct and within
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    34
 
      your program.</td>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    35
 
  </tr>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    36
 
  <tr>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    37
 
    <td><b>View program output </b></td>
2131
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents: 2087
diff changeset 
    38
 
    <td><p>Enable to direct standard output messages to the   Emulation Program Output Console in the <a href="../views/view_console.htm">Console</a> view. </p>
819
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    39
 
        <p class="note"><b>NOTE</b> In the <span class="code">epoc.ini</span> file the option <span class="code">LogToFile</span> must also be set to <span class="code">1</span>.</p></td>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    40
 
  </tr>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    41
 
  <tr>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    42
 
    <td><b>View emulator output </b></td>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    43
 
    <td><p>Enable to  output emulator messages to the   Emulator  Output Console in the Console view. </p>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    44
 
        <p class="note"><b>NOTE</b> In the <span class="code">epoc.ini</span> file the option <span class="code">LogToDebugger</span> must also be set to&nbsp;<span class="code">1</span>.</p></td>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    45
 
  </tr>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    46
 
  <tr>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    47
 
    <td><b>View Windows system messages </b></td>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    48
 
    <td>Enable to  output Windows system messages to the   Windows System Messages Console in the Console view. </td>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    49
 
  </tr>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    50
 
</table>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    51
 
<h3><a name="trk_runmode" id="trk_runmode"></a>Run-mode Debugger page </h3>
2131
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents: 2087
diff changeset 
    52
 
<p>In a run-mode launch configuration like <b><a href="run_mode.htm">Symbian Device (Install SIS)</a></b>, you can specify an entry break point and how messages are handled as well as define the default instruction set. </p>
1992
9711068fca7e updated images and pages associated with launch changes as per Warrens message
fturovic <frank.turovich@nokia.com>
parents: 1791
diff changeset 
    53
 
<p align="center"><img src="images/page_debugger_run_mode.png" width="660" height="174"></p>
819
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    54
 
<p class="figure">Figure 2 - Debugger page showing run-mode options  </p>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    55
 
<h5>Table 2. Debugger page &mdash; run-mode  options </h5>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    56
 
<table width="94%"  border="0" cellpadding="2" cellspacing="0">
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    57
 
  <tr>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    58
 
    <th width="38%" scope="col">Option</th>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    59
 
    <th width="62%" scope="col">Explanation</th>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    60
 
  </tr>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    61
 
  <tr>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    62
 
    <td><p><b>Break at entry point</b></p>    </td>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    63
 
    <td><p>When checked, break at the specified entry point entered into the text field. For .EXE targets, the default entry point is set to <span class="code">E32Main</span>. By default, the <b>Break at entry point</b> option is unchecked for all other target types.</p></td>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    64
 
  </tr>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    65
 
  <tr>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    66
 
    <td><b>View program output </b></td>
2131
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents: 2087
diff changeset 
    67
 
    <td><p>Enable to direct standard output messages to the   <b>CODA Program Output Console</b> in the <a href="../views/view_console.htm">Console</a> view. </p>
1992
9711068fca7e updated images and pages associated with launch changes as per Warrens message
fturovic <frank.turovich@nokia.com>
parents: 1791
diff changeset 
    68
 
      <p class="note"><b>NOTE</b> In the <span class="code">epoc.ini</span> file the option <span class="code">LogToFile</span> must also be set to <span class="code">1</span>.</p>    </td>
819
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    69
 
  </tr>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    70
 
</table>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    71
 
<h3><a name="trk_stopmode" id="trk_stopmode"></a>Stop-mode Debugger page </h3>
2131
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents: 2087
diff changeset 
    72
 
<p>In  stop-mode launch configurations like <b><a href="stop_mode.htm">Symbian Device</a></b>,<b> </b>and <a href="attach_process.htm"><b>Symbian Device (Attach to Process)</b></a>, use the <b>Startup Options</b> to  attach to a target and debug or run from the specified start address. Then use <b>Target Options</b> to specify the target's processor type,  and set which initialization and memory configuration files to use in the debug session. </p>
1992
9711068fca7e updated images and pages associated with launch changes as per Warrens message
fturovic <frank.turovich@nokia.com>
parents: 1791
diff changeset 
    73
 
<p align="center"><img src="images/page_debugger_stop_mode.png" width="578" height="174"></p>
819
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    74
 
<p class="figure">Figure 3 - Debugger page showing stop-mode options  </p>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    75
 
<h5>Table 3. Debugger page &mdash; stop-mode  options </h5>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    76
 
<table width="94%"  border="0" cellpadding="2" cellspacing="0">
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    77
 
  <tr>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    78
 
    <th width="25%" scope="col">Group</th>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    79
 
    <th width="38%" scope="col">Option</th>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    80
 
    <th width="62%" scope="col">Explanation</th>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    81
 
  </tr>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    82
 
  <tr>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    83
 
    <td>&nbsp;</td>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    84
 
    <td><p><b>Break at entry point</b></p></td>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    85
 
    <td><p>When checked, break at the specified entry point entered into the text field. For .EXE targets, the default entry point is set to <span class="code">E32Main</span>. By default, the <b>Break at entry point</b> option is unchecked for all other target types.</p></td>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    86
 
  </tr>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    87
 
  <tr>
1992
9711068fca7e updated images and pages associated with launch changes as per Warrens message
fturovic <frank.turovich@nokia.com>
parents: 1791
diff changeset 
    88
 
      <td rowspan="2"><b>Startup Options</b></td>
819
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    89
 
    <td><b>Debug from start address </b></td>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    90
 
    <td>Enable the <b>Debug from start addres</b>s option to debug from the target's default start address. </td>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    91
 
  </tr>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    92
 
  <tr>
1992
9711068fca7e updated images and pages associated with launch changes as per Warrens message
fturovic <frank.turovich@nokia.com>
parents: 1791
diff changeset 
    93
 
      <td><b>Run from start address </b></td>
819
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    94
 
    <td>Enable the <b>Run from start addres</b>s option to run from the target's default start address. </td>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    95
 
  </tr>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    96
 
</table>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    97
 












8121a281245c
BUG 10603 - removed sophia text references from 3.0



fturovic <frank.turovich@nokia.com>


parents: 
0

diff
changeset




    98


<h4>Other references</h4>













8121a281245c
BUG 10603 - removed sophia text references from 3.0



fturovic <frank.turovich@nokia.com>


parents: 
0

diff
changeset




    99


<ul>








2131






ff0156b93599
moved inf, mmp, remote conn, and views to project folder



fturovic <frank.turovich@nokia.com>


parents: 
2087

diff
changeset




   100


  <li><a href="run_mode.htm">Symbian Device (Install SIS) Launch Configuration</a></li>








2087






617a89f9dffc
BUG 12110 - text instances of apptrk/systrk changed, more images yet to update



fturovic <frank.turovich@nokia.com>


parents: 
2009

diff
changeset




   101


  <li><a href="emulation.htm">Emulator  Launch Configuration</a></li>








2131






ff0156b93599
moved inf, mmp, remote conn, and views to project folder



fturovic <frank.turovich@nokia.com>


parents: 
2087

diff
changeset




   102


  <li><a href="stop_mode.htm">Symbian Device Launch Configuration </a></li>








819






8121a281245c
BUG 10603 - removed sophia text references from 3.0



fturovic <frank.turovich@nokia.com>


parents: 
0

diff
changeset




   103


</ul>








1207






e265bbe56eb0
merge 2.6 changes to 3.0 docs



fturovic <frank.turovich@nokia.com>


parents: 
819

diff
changeset




   104


<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>








819






8121a281245c
BUG 10603 - removed sophia text references from 3.0



fturovic <frank.turovich@nokia.com>


parents: 
0

diff
changeset




   105


</body>













8121a281245c
BUG 10603 - removed sophia text references from 3.0



fturovic <frank.turovich@nokia.com>


parents: 
0

diff
changeset




   106


</html>















FCL/sftools/dev/ide/carbidecpp