1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> |
|
2 <html> |
|
3 <head> |
|
4 <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" /> |
|
5 <meta http-equiv="Content-Style-Type" content="text/css" /> |
|
6 <meta name="LASTUPDATED" content="06/17/05 11:09:43" /> |
|
7 <title>Attaching to a Symbian OS Process</title> |
|
8 <link rel="StyleSheet" href="../../../book.css" type="text/css"/> |
|
9 </head> |
|
10 <body > |
|
11 <h2>Attaching to a Symbian OS Process</h2> |
|
12 <div> |
|
13 <p>Use the <b>Symbian OS Attach to Process</b> launch configuration to attach the debugger to an already running Symbian OS process or thread on a target device. This is useful for debugging servers running in RAM in a client-server relationship where the client relies on the presence of the server process to operate as one example.</p> |
|
14 <p><span class="note">You can also attach to a process in the <a href="../../reference/view_symbian_kernel.htm">Symbian OS Data</a> view when debugging.</span></p> |
|
15 <p class="note"><b>NOTE</b> You cannot attach to a process running on the emulator. It must be a target device running the Symbian OS and the TRK debug agent.</p> |
|
16 <p>When attempting to find a process the debugger uses the UID3 to locate the process. </p> |
|
17 <div class="step"> |
|
18 <h4>Attaching to a Symbian OS Process</h4> |
|
19 <ol> |
|
20 <li><a href="../projects/prj_import_exe.htm">Import an executable</a> to import it into the <a href="../../reference/view_executables.htm">Executables</a> view </li> |
|
21 <li>Select any project in the workspace or the binary to attach to in the Executables view</li> |
|
22 <p>In this example, we select the Executables project created when the binary was imported from the Project Explorer view (Figure 1). </p> |
|
23 <p align="center"><img src="images/sos_processes_executables.png" width="258" height="189"></p> |
|
24 <p class="figure">Figure 1 - Executables project created when importing an executable </p> |
|
25 <li>Click Debug (<img src="../../images/icons/btn_debug.png" width="17" height="16" align="absmiddle">) to launch the <a href="../../projects/launch/wiz_new_launch_config.htm">New Configuration Launch Wizard</a> </li> |
|
26 <li>Select the Attach to Process Launch Configuration option and fill in the requested information</li> |
|
27 <li>Click Debug</li> |
|
28 <p>The <b>Attach to Process </b>window 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> |
|
29 <p align="center"><img src="images/sos_processes_choose_thread.png" width="300" height="375" /></p> |
|
30 <p class="figure">Figure 2 -<b> Attach to Process</b> window </p> |
|
31 <li>Select a process, click OK</li> |
|
32 <p>The <b>Attach to Process </b>window closes. Open a <a href="../../reference/view_symbian_kernel.htm">Symbian OS</a> view to show the process and thread information.</p> |
|
33 <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> |
|
34 </ol> |
|
35 </div> |
|
36 </div> |
|
37 <h5>Related references</h5> |
|
38 <ul> |
|
39 <li><a href="../../debugger/debug/viewing_debug.htm">Debug View</a></li> |
|
40 <li><a href="../../reference/wnd_debug_configuration.htm">Debug Window </a></li> |
|
41 <li><a href="../../reference/view_symbian_kernel.htm">Symbian OS View</a> </li> |
|
42 </ul> |
|
43 <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> |
|
44 |
|
45 </body> |
|
46 </html> |
|