author | fturovic <frank.turovich@nokia.com> |
Wed, 13 Oct 2010 14:07:29 -0500 | |
changeset 2155 | fb8db13ce840 |
parent 2136 | f0b706fa897d |
child 2156 | 76029713f570 |
permissions | -rw-r--r-- |
1933
a77f12f0a631
BUG 10651 - added debugging dll with any process info, revised launch config pages and others
fturovic <frank.turovich@nokia.com>
parents:
diff
changeset
|
1 |
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> |
a77f12f0a631
BUG 10651 - added debugging dll with any process info, revised launch config pages and others
fturovic <frank.turovich@nokia.com>
parents:
diff
changeset
|
2 |
<html> |
a77f12f0a631
BUG 10651 - added debugging dll with any process info, revised launch config pages and others
fturovic <frank.turovich@nokia.com>
parents:
diff
changeset
|
3 |
<head> |
a77f12f0a631
BUG 10651 - added debugging dll with any process info, revised launch config pages and others
fturovic <frank.turovich@nokia.com>
parents:
diff
changeset
|
4 |
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" /> |
a77f12f0a631
BUG 10651 - added debugging dll with any process info, revised launch config pages and others
fturovic <frank.turovich@nokia.com>
parents:
diff
changeset
|
5 |
<meta http-equiv="Content-Style-Type" content="text/css" /> |
a77f12f0a631
BUG 10651 - added debugging dll with any process info, revised launch config pages and others
fturovic <frank.turovich@nokia.com>
parents:
diff
changeset
|
6 |
<meta name="LASTUPDATED" content="06/17/05 11:09:43" /> |
a77f12f0a631
BUG 10651 - added debugging dll with any process info, revised launch config pages and others
fturovic <frank.turovich@nokia.com>
parents:
diff
changeset
|
7 |
<title>Attaching to a Process</title> |
a77f12f0a631
BUG 10651 - added debugging dll with any process info, revised launch config pages and others
fturovic <frank.turovich@nokia.com>
parents:
diff
changeset
|
8 |
<link rel="StyleSheet" href="../../../book.css" type="text/css"/> |
a77f12f0a631
BUG 10651 - added debugging dll with any process info, revised launch config pages and others
fturovic <frank.turovich@nokia.com>
parents:
diff
changeset
|
9 |
</head> |
a77f12f0a631
BUG 10651 - added debugging dll with any process info, revised launch config pages and others
fturovic <frank.turovich@nokia.com>
parents:
diff
changeset
|
10 |
<body > |
a77f12f0a631
BUG 10651 - added debugging dll with any process info, revised launch config pages and others
fturovic <frank.turovich@nokia.com>
parents:
diff
changeset
|
11 |
<h2>Attaching to a Process</h2> |
a77f12f0a631
BUG 10651 - added debugging dll with any process info, revised launch config pages and others
fturovic <frank.turovich@nokia.com>
parents:
diff
changeset
|
12 |
<div> |
2155
fb8db13ce840
BUG 12329 - Reworded to add simulator target as well
fturovic <frank.turovich@nokia.com>
parents:
2136
diff
changeset
|
13 |
<p>Use a <b>Symbian Attach to Process</b> launch configuration to attach the debugger to an already running Symbian process or thread on a target device or simulator. This is useful for debugging DLLs where the main process is unknown or for servers running in RAM in a client-server relationship where the client relies on the presence of the server process to operate.</p> |
2131
ff0156b93599
moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
2125
diff
changeset
|
14 |
<p>One common debugging DLL use case is when the developer doesn't know which process calls the DLL. This makes it difficult to debug the DLL because you doesn't know which process to attach to nor start. Carbide enables DLL debugging by simply attaching the DLL to any running process as long as the DLL is included in the <a href="../../projects/views/view_executables.htm">Executables</a> view.</p> |
2136
f0b706fa897d
all instances of PLUGINS_ROOT preceded by any path had the path removed (incorrect syntax)
fturovic <frank.turovich@nokia.com>
parents:
2131
diff
changeset
|
15 |
<p>You can also attach to a process in the <a href="../../debugger/views/view_symbian_kernel.htm">Symbian Data</a> view when debugging.</p> |
2155
fb8db13ce840
BUG 12329 - Reworded to add simulator target as well
fturovic <frank.turovich@nokia.com>
parents:
2136
diff
changeset
|
16 |
<p class="note"><b>NOTE</b> You cannot attach to a process running on an emulator. It must be a target device or simulator running the Symbian and the CODA software.</p> |
1933
a77f12f0a631
BUG 10651 - added debugging dll with any process info, revised launch config pages and others
fturovic <frank.turovich@nokia.com>
parents:
diff
changeset
|
17 |
<p>When attempting to find a process the debugger uses the UID3 to locate the process. </p> |
a77f12f0a631
BUG 10651 - added debugging dll with any process info, revised launch config pages and others
fturovic <frank.turovich@nokia.com>
parents:
diff
changeset
|
18 |
<div class="step"> |
a77f12f0a631
BUG 10651 - added debugging dll with any process info, revised launch config pages and others
fturovic <frank.turovich@nokia.com>
parents:
diff
changeset
|
19 |
<h4>Attaching to any Running Process</h4> |
a77f12f0a631
BUG 10651 - added debugging dll with any process info, revised launch config pages and others
fturovic <frank.turovich@nokia.com>
parents:
diff
changeset
|
20 |
<ol> |
2131
ff0156b93599
moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
2125
diff
changeset
|
21 |
<li>In the <a href="../../projects/views/view_executables.htm">Executables</a> view, click the Import an executable file icon (<img src="../../images/icons/btn_import_executables.png" alt="Import an executable icon" width="18" height="15" align="absmiddle">) to add an executable to the Executables view for debugging. |
ff0156b93599
moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
2125
diff
changeset
|
22 |
<p>The executable added appears in the <a href="../../projects/views/view_proj_explorer.htm">Project Explorer</a> view under an <b>Executables</b> project. This group includes all executables listed in the <b>Executables</b> view that are not linked to any project in the workspace.</p> |
1933
a77f12f0a631
BUG 10651 - added debugging dll with any process info, revised launch config pages and others
fturovic <frank.turovich@nokia.com>
parents:
diff
changeset
|
23 |
<p align="center"><img src="../projects/images/attach_to_process_proj_explorer.png" alt="Project Explorer Executables project" width="267" height="267"></p> |
a77f12f0a631
BUG 10651 - added debugging dll with any process info, revised launch config pages and others
fturovic <frank.turovich@nokia.com>
parents:
diff
changeset
|
24 |
<p class="figure">Figure 1 -<b> Executables list in Project Explorer view</b></p> |
a77f12f0a631
BUG 10651 - added debugging dll with any process info, revised launch config pages and others
fturovic <frank.turovich@nokia.com>
parents:
diff
changeset
|
25 |
<p class="note"><b>NOTE</b> The executable must include symbolics in order for debugging to work.</p> |
a77f12f0a631
BUG 10651 - added debugging dll with any process info, revised launch config pages and others
fturovic <frank.turovich@nokia.com>
parents:
diff
changeset
|
26 |
</li> |
a77f12f0a631
BUG 10651 - added debugging dll with any process info, revised launch config pages and others
fturovic <frank.turovich@nokia.com>
parents:
diff
changeset
|
27 |
<li>Click Debug (<img src="../../projects/images/icon_debug.png" alt="Debug icon" width="17" height="17" align="absmiddle">) to launch the <a href="../../projects/launch/wiz_new_launch_config.htm">New Configuration Launch Wizard</a>.</li> |
2125
bbb6c7da6e3f
BUG 12110 - more TRK references removed in text and images
fturovic <frank.turovich@nokia.com>
parents:
2092
diff
changeset
|
28 |
<p>Select the Symbian Device (Attach to Process) launch configuration option and fill in the requested information.</p> |
bbb6c7da6e3f
BUG 12110 - more TRK references removed in text and images
fturovic <frank.turovich@nokia.com>
parents:
2092
diff
changeset
|
29 |
<p align="center"><img src="../projects/images/attach_to_process_launch_config.png" alt="Attach to Process launch config" width="528" height="301"></p> |
1933
a77f12f0a631
BUG 10651 - added debugging dll with any process info, revised launch config pages and others
fturovic <frank.turovich@nokia.com>
parents:
diff
changeset
|
30 |
<p class="figure">Figure 2 -<b> Attach to Process</b> launch configuration</p> |
a77f12f0a631
BUG 10651 - added debugging dll with any process info, revised launch config pages and others
fturovic <frank.turovich@nokia.com>
parents:
diff
changeset
|
31 |
<li>Click Debug.</li> |
a77f12f0a631
BUG 10651 - added debugging dll with any process info, revised launch config pages and others
fturovic <frank.turovich@nokia.com>
parents:
diff
changeset
|
32 |
<p>The <b>Attach to Process </b>dialog appears. Click a column title to sort the processes in ascending or descending order to help you locate a specific process or use the filter text box to show specific processes. </p> |
a77f12f0a631
BUG 10651 - added debugging dll with any process info, revised launch config pages and others
fturovic <frank.turovich@nokia.com>
parents:
diff
changeset
|
33 |
<p align="center"><img src="images/sos_processes_choose_thread.png" width="300" height="375" /></p> |
a77f12f0a631
BUG 10651 - added debugging dll with any process info, revised launch config pages and others
fturovic <frank.turovich@nokia.com>
parents:
diff
changeset
|
34 |
<p class="figure">Figure 3 -<b> Attach to Process</b> window </p> |
a77f12f0a631
BUG 10651 - added debugging dll with any process info, revised launch config pages and others
fturovic <frank.turovich@nokia.com>
parents:
diff
changeset
|
35 |
<li>Select a process, click OK.</li> |
2136
f0b706fa897d
all instances of PLUGINS_ROOT preceded by any path had the path removed (incorrect syntax)
fturovic <frank.turovich@nokia.com>
parents:
2131
diff
changeset
|
36 |
<p>In this example we've linked the <span class="code">prefs.dll</span> program to the process <span class="code">BlackFlag.exe</span> on the device. The <b>Attach to Process </b>dialog closes. Open the <a href="../../debugger/views/view_symbian_kernel.htm">Symbian Data</a> view to show the process and thread information.</p> |
1933
a77f12f0a631
BUG 10651 - added debugging dll with any process info, revised launch config pages and others
fturovic <frank.turovich@nokia.com>
parents:
diff
changeset
|
37 |
<p class="note"><b>NOTE</b> Terminating an Attach to Process session actually kills the process on the device. This means you must restart the process on the device in order to attach to it again. </p> |
a77f12f0a631
BUG 10651 - added debugging dll with any process info, revised launch config pages and others
fturovic <frank.turovich@nokia.com>
parents:
diff
changeset
|
38 |
</ol> |
a77f12f0a631
BUG 10651 - added debugging dll with any process info, revised launch config pages and others
fturovic <frank.turovich@nokia.com>
parents:
diff
changeset
|
39 |
</div> |
a77f12f0a631
BUG 10651 - added debugging dll with any process info, revised launch config pages and others
fturovic <frank.turovich@nokia.com>
parents:
diff
changeset
|
40 |
<h5>Related references</h5> |
a77f12f0a631
BUG 10651 - added debugging dll with any process info, revised launch config pages and others
fturovic <frank.turovich@nokia.com>
parents:
diff
changeset
|
41 |
<ul> |
a77f12f0a631
BUG 10651 - added debugging dll with any process info, revised launch config pages and others
fturovic <frank.turovich@nokia.com>
parents:
diff
changeset
|
42 |
<li><a href="../../debugger/debug/viewing_debug.htm">Debug View</a></li> |
a77f12f0a631
BUG 10651 - added debugging dll with any process info, revised launch config pages and others
fturovic <frank.turovich@nokia.com>
parents:
diff
changeset
|
43 |
<li><a href="../../reference/wnd_debug_configuration.htm">Debug Window </a></li> |
2136
f0b706fa897d
all instances of PLUGINS_ROOT preceded by any path had the path removed (incorrect syntax)
fturovic <frank.turovich@nokia.com>
parents:
2131
diff
changeset
|
44 |
<li><a href="../../debugger/views/view_symbian_kernel.htm">Symbian View</a> </li> |
1933
a77f12f0a631
BUG 10651 - added debugging dll with any process info, revised launch config pages and others
fturovic <frank.turovich@nokia.com>
parents:
diff
changeset
|
45 |
<li><a href="../projects/prj_debug_dlls_any_process.htm">Debugging DLLs with any Process</a></li> |
a77f12f0a631
BUG 10651 - added debugging dll with any process info, revised launch config pages and others
fturovic <frank.turovich@nokia.com>
parents:
diff
changeset
|
46 |
</ul> |
a77f12f0a631
BUG 10651 - added debugging dll with any process info, revised launch config pages and others
fturovic <frank.turovich@nokia.com>
parents:
diff
changeset
|
47 |
<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> |
a77f12f0a631
BUG 10651 - added debugging dll with any process info, revised launch config pages and others
fturovic <frank.turovich@nokia.com>
parents:
diff
changeset
|
48 |
|
a77f12f0a631
BUG 10651 - added debugging dll with any process info, revised launch config pages and others
fturovic <frank.turovich@nokia.com>
parents:
diff
changeset
|
49 |
</body> |
a77f12f0a631
BUG 10651 - added debugging dll with any process info, revised launch config pages and others
fturovic <frank.turovich@nokia.com>
parents:
diff
changeset
|
50 |
</html> |