1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" |
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" |
2 "http://www.w3.org/TR/html4/loose.dtd"> |
2 "http://www.w3.org/TR/html4/loose.dtd"> |
3 <html> |
3 <html> |
4 <head> |
4 <head> |
5 <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> |
5 <meta http-equiv="content-type" content="text/html; charset=UTF-8"> |
6 <title>Setting Tracing Options</title> |
6 <title>Setting Tracing Options</title> |
7 <link href="../../../book.css" rel="stylesheet" type="text/css"> |
7 <link href="../../../book.css" rel="stylesheet" type="text/css"> |
8 </head> |
8 </head> |
9 |
9 |
10 <body> |
10 <body> |
11 <h2>Setting Tracing Options </h2> |
11 <h2>Setting Tracing Options </h2> |
12 <p>Use the <b>Tracing</b> options menu in the Profiler to specify the types of tracing data to collect when profiling an application executing on a device.</p> |
12 |
13 <table width="650" border="1" align="center"> |
13 <p>Use the <b>Tracing</b> options menu in the Profiler to specify the types of |
14 <tr> |
14 tracing data to collect when profiling an application executing on a device.</p> |
15 <td width="33"><b>S60</b></td> |
15 |
16 <td width="593"><div align="center"><img src="images/TracingOptionsList.png" width="264" height="312"> <img src="images/TracingOptionsList2.png" width="264" height="312"></div></td> |
16 <p align="center"><img src="images/TracingOptionsList.png"> <img |
17 </tr> |
17 src="images/TracingOptionsList2.png"></p> |
18 <tr> |
18 |
19 <td><b>UIQ</b></td> |
19 <p class="figure">Figure 1. Tracing options screen in Profiler (S60)</p> |
20 <td><div align="center"><img src="images/uiq_setting_tracing_options.png" width="240" height="320"></div></td> |
20 |
21 </tr> |
21 <p>The tracing options include:</p> |
|
22 |
|
23 <h5>Table 1. <span class="figure">Profiler Tracing Options</span></h5> |
|
24 |
|
25 <table width="94%" border="0" cellpadding="2" cellspacing="0"> |
|
26 <tbody> |
|
27 <tr> |
|
28 <th width="226" scope="col">Menu Option </th> |
|
29 <th width="616" scope="col">Description</th> |
|
30 </tr> |
|
31 <tr> |
|
32 <td><b>Dynamic binary support</b></td> |
|
33 <td><p>Enable (On) or disable (Off) dynamic binary tracing in your |
|
34 profiling task. </p> |
|
35 |
|
36 <p>If the executables you wish to analyze are not in a ROM image |
|
37 (.symbol file) of your target device, then you will need to turn on |
|
38 Dynamic binary support.</p> |
|
39 </td> |
|
40 </tr> |
|
41 <tr> |
|
42 <td><b>Function call capture </b></td> |
|
43 <td>Enable (On) or disable (Off) function call information in your |
|
44 profiling task. If disabled, then <a |
|
45 href="../analyzer/function_calls.htm">Function call</a> information |
|
46 will not appear in the Analyzer.</td> |
|
47 </tr> |
|
48 <tr> |
|
49 <td><b>Button press capture </b></td> |
|
50 <td>Enable (On) or disable (Off) the gathering of button press |
|
51 information in your profiling task. If disabled, then Button Press |
|
52 information will not appear in the Analyzer.</td> |
|
53 </tr> |
|
54 <tr> |
|
55 <td><b>Memory usage capture </b></td> |
|
56 <td>Enable (On) or disable (Off) memory usage information in your |
|
57 profiling task. If disabled, then Memory usage information will not |
|
58 appear in the Analyzer.</td> |
|
59 </tr> |
|
60 <tr> |
|
61 <td><b>Thread priority capture </b></td> |
|
62 <td><p>Enable (On) or disable (Off) Thread priority information. If |
|
63 enabled, captured data will include the time and priority ranking of |
|
64 the currently executing thread when the operating system is called.</p> |
|
65 |
|
66 <p>If disabled, then thread priority information is not included and a |
|
67 Priority List column will not be shown in the <a |
|
68 href="../analyzer/thread_load.htm">Thread Load</a> table in the |
|
69 Analyzer.</p> |
|
70 </td> |
|
71 </tr> |
|
72 <tr> |
|
73 <td><b>Power usage capture </b></td> |
|
74 <td><p>Enable (On) or disable (Off) power usage information in your |
|
75 profiling task. If disabled, then Power usage information will not |
|
76 appear in the Analyzer.</p> |
|
77 </td> |
|
78 </tr> |
|
79 </tbody> |
22 </table> |
80 </table> |
23 <p class="figure">Figure 1. Tracing options screen in Profiler (S60 and UIQ)</p> |
81 |
24 <p> The tracing options include:</p> |
|
25 <h5>Table 1. <span class="figure">Profiler Tracing Options</span></h5> |
|
26 <table width="94%" border="0" cellpadding="2" cellspacing="0"> |
|
27 <tr> |
|
28 <th width="226" scope="col">Menu Option </th> |
|
29 <th width="616" scope="col">Description</th> |
|
30 </tr> |
|
31 <tr> |
|
32 <td><b>Dynamic binary support</b></td> |
|
33 <td><p>Enable (On) or disable (Off) dynamic binary tracing in your profiling task. </p> |
|
34 <p>If the executables you wish to analyze are not in a ROM image (.symbol file) of your target device, then you will need to turn on Dynamic binary support.</p></td> |
|
35 </tr> |
|
36 <tr> |
|
37 <td><b>Function call capture </b></td> |
|
38 <td>Enable (On) or disable (Off) function call information in your profiling task. If disabled, then <a href="../analyzer/function_calls.htm">Function call</a> information will not appear in the Analyzer.</td> |
|
39 </tr> |
|
40 <tr> |
|
41 <td><b>Button press capture </b></td> |
|
42 <td>Enable (On) or disable (Off) the gathering of button press information in your profiling task. If disabled, then Button Press information will not appear in the Analyzer.</td> |
|
43 </tr> |
|
44 <tr> |
|
45 <td><b>Memory usage capture </b></td> |
|
46 <td>Enable (On) or disable (Off) memory usage information in your profiling task. If disabled, then Memory usage information will not appear in the Analyzer.</td> |
|
47 </tr> |
|
48 <tr> |
|
49 <td><b>Thread priority capture </b></td> |
|
50 <td><p>Enable (On) or disable (Off) Thread priority information. If enabled, captured data will include the time and priority ranking of the currently executing thread when the operating system is called.</p> |
|
51 <p>If disabled, then thread priority information is not included and a Priority List column will not be shown in the <a href="../analyzer/thread_load.htm">Thread Load</a> table in the Analyzer.</p></td> |
|
52 </tr> |
|
53 <tr> |
|
54 <td><b>Power usage capture </b></td> |
|
55 <td><p>Enable (On) or disable (Off) power usage information in your profiling task. If disabled, then Power usage information will not appear in the Analyzer.</p> |
|
56 <p class="note"><b>NOTE</b> Power usage capture is not available in UIQ version. </span></p></td> |
|
57 </tr> |
|
58 </table> |
|
59 <div class="step"> |
82 <div class="step"> |
60 <h4>Setting a Tracing Option</h4> |
83 <h4>Setting a Tracing Option</h4> |
61 <ol> |
84 <ol> |
62 <li>Launch the Profiler application on the target device </li> |
85 <li>Launch the Profiler application on the target device </li> |
63 <li>Open the Profiler options screen: </li> |
86 <li>Open the Profiler options screen: </li> |
64 <ul> |
87 </ol> |
65 <li>S60 - Select the Tracing menu</li> |
88 <ul> |
66 <li>UIQ - Select the Tracing Options menu</li> |
89 <li>Select the Tracing menu</li> |
67 </ul> |
|
68 <li>Set the desired option on or off</li> |
90 <li>Set the desired option on or off</li> |
69 <li>Exit the screen</li> |
91 <li>Exit the screen</li> |
70 </ol> |
92 </ul> |
|
93 <ul> |
|
94 </ul> |
71 </div> |
95 </div> |
72 <h5>Related references |
96 |
73 </h5> |
97 <h5>Related references </h5> |
74 <ul> |
98 <ul> |
75 <li><a href="prof_using.htm">Using the Profiler</a></li> |
99 <li><a href="prof_using.htm">Using the Profiler</a></li> |
76 </ul> |
100 </ul> |
|
101 |
77 <h5>Related tasks</h5> |
102 <h5>Related tasks</h5> |
78 <ul> |
103 <ul> |
79 <li><a href="advanced_options.htm">Setting Advanced Options</a></li> |
104 <li><a href="advanced_options.htm">Setting Advanced Options</a></li> |
80 <li><a href="output_settings.htm">Setting Output Settings </a> </li> |
105 <li><a href="output_settings.htm">Setting Output Settings </a> </li> |
81 </ul> |
106 </ul> |
82 <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> |
107 |
|
108 <div id="footer"> |
|
109 Copyright © 2010 Nokia Corporation and/or its subsidiary(-ies). All rights |
|
110 reserved. <br> |
|
111 License: <a |
|
112 href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div> |
83 </body> |
113 </body> |
84 </html> |
114 </html> |