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/tutorials/new_proj_dll_example_03.htm
author fturovic <frank.turovich@nokia.com>
Tue, 20 Jul 2010 14:14:39 -0500
changeset 1646 7bcb3d758005
parent 1645 0083290c145a
child 1791 727385d8e2b3
permissions -rw-r--r--
completed remote debug tutorial
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
1617
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
     1
 
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
     2
 
<html>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
     3
 
<head>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
     4
 
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
     5
 
<meta http-equiv="Content-Style-Type" content="text/css" />
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
     6
 
<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
     7
 
<title>Debugging a DLL Project Tutorial</title>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
     8
 
<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
     9
 
</head>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    10
 
<body bgcolor="#FFFFFF">
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    11
 
<h2>Debugging a  DLL Project Tutorial</h2>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    12
 
<p>In this example we show how to create a  project for a DLL (Dynamic Linked Library) using one of the built-in Carbide templates, how to build it into an executable, and how to launch the debugger to verify program accuracy. The steps to do this include:</p>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    13
 
<ol>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    14
 
    <li><a href="new_proj_from_template_01.htm">Creating</a> a DLL project from a project template</li>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    15
 
    <li><a href="new_proj_from_template_02.htm">Building</a> the DLL object code based on the project sources</li>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    16
 
    <li><strong>Debugging the DLL using  the Carbide debugger</strong></li>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    17
 
</ol>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    18
 
<hr>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    19
 
<p>With the DLL compiled into object code, it's time to link it to any process running on the target device, then launch it with the debugger. Using the <strong>New Launch Configuration Wizard</strong> makes doing this quick, easy, and reliable.</p>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    20
 
<div class="step">
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    21
 
    <p>Debugging a DLL project</p>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    22
 
    <ol>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    23
 
        <li>Select the project to launch in the Project Explorer view.</li>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    24
 
        <li>Launch a debug session using one of these actions:<br />
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    25
 
            <ul>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    26
 
                <li>Right-click the project in the Project Explorer view and choose <strong>Debug As &gt; Debug Symbian OS Application on Phone or Simulator</strong> menu option.</li>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    27
 
                <li>Click the Run &gt; Debug (F11) menu option.</li>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    28
 
                <li>Click the Debug (<img src="../images/icon_debug.png" alt="Debug icon" width="17" height="17" align="absmiddle">) icon in the toolbar to build the project. </li>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    29
 
            </ul>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    30
 
            <p>The first time you perform any of the following actions, the <strong>New Launch Configuration Wizard</strong> appears asking for the additional info to connect to a device.</p>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    31
 
            <p><img src="../images/dll_new_launch_config.png" alt="New Launch Configuration Wizard" width="550" height="460"></p>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    32
 
        </li>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    33
 
        <li>Provide the wizard the information it needs to complete the Configure launch configuration.<br />
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    34
 
        	<p>Complete all of the options below to create a launch connection for the DLL project.</p>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    35
 
            <ol type="a">
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    36
 
                <li>Connect to device &mdash; click Change... to select a Current connection, create a new one, or edit the chosen remote connection settings.<br />
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    37
 
                	<p><img src="../images/dll_change_remote_connection.png" alt="Change connection dialog"></p>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    38
 
                </li>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    39
 
                <li>Debug process &mdash; click <strong>Change...</strong> to open the <strong>Change Debug Process</strong> dialog. Then select the <strong>Attach to process</strong> option and click <strong>OK</strong><br />
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    40
 
                	<p>To debug a DLL you simply need to attach it to any process running on the target device. Setting the<strong> Attach to process</strong> option will throw up a <strong>Attach to Process</strong> dialog when you start a debug session.</p>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    41
 
                	<p><img src="../images/dll_change_debug_process.png" alt="Change Debug Process dialog"></p>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    42
 
                </li>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    43
 
                <li>Other Settings &mdash; click Change... to open the Other Settings dialog to set a preference for when the project is built during a launch, then click OK.<br />
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    44
 
                	<p><img src="../images/dll_other_settings.png" alt="Other Settings dialog"></p>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    45
 
                </li>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    46
 
                <li>(Optional) Edit advanced settings before launch &mdash; enable this option and click Edit to open the Debug Configurations dialog where you can set more launch options. Click Close to cancel the debug session launch.</li>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    47
 
            </ol>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    48
 
            <p>The <strong>Debug</strong> control enables when all the information is complete.</p>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    49
 
        </li>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    50
 
        <li>Click Debug.<br />
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    51
 
        	<p>The debug session is launched and the <strong>Attach to Process</strong> dialog appears. Select a process and click <strong>OK</strong> to continue.</p>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    52
 
            <p><img src="../images/dll_attach_to_process.png" alt="Attach to Process dialog"></p>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    53
 
        </li>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    54
 
        <p>The DLL is attached to the running process and control returns to the Carbide debugger. From this point you can use all of the Carbide debugger features to debug the DLL as it runs on the device.</p>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    55
 
    </ol>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    56
 
</div>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    57
 
<h4>Other references</h4>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    58
 
<ul>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    59
1645
0083290c145a minor edits to sync titles across tutorials
fturovic <frank.turovich@nokia.com>
parents: 1617
diff changeset 
    60
 
    <li><a href="new_proj_dll_example_00.htm">DLL Projects</a></li>
1617
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    61
 
</ul>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    62
 
<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>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    63
 












94b6d1326534
revised dll example with new images, TOC, and welcome page



fturovic <frank.turovich@nokia.com>


parents: 

diff
changeset




    64


</body>













94b6d1326534
revised dll example with new images, TOC, and welcome page



fturovic <frank.turovich@nokia.com>


parents: 

diff
changeset




    65


</html>














FCL/sftools/dev/ide/carbidecpp