sysperfana/perfinvestigator/com.nokia.carbide.cpp.pi.doc.user/html/reference/profiler/tracing_options.htm
changeset 2 b9ab3b238396
child 5 844b047e260d
equal deleted inserted replaced
1:1050670c6980 2:b9ab3b238396
       
     1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
       
     2 "http://www.w3.org/TR/html4/loose.dtd">
       
     3 <html>
       
     4 <head>
       
     5 	<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
       
     6 	<title>Setting Tracing Options</title>
       
     7     <link href="../../../book.css" rel="stylesheet" type="text/css">
       
     8 </head>
       
     9 
       
    10 <body>
       
    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>
       
    13 <table width="650" border="1" align="center">
       
    14   <tr>
       
    15     <td width="33"><b>S60</b></td>
       
    16     <td width="593"><div align="center"><img src="images/TracingOptionsList.png" width="264" height="312">&nbsp;<img src="images/TracingOptionsList2.png" width="264" height="312"></div></td>
       
    17   </tr>
       
    18   <tr>
       
    19     <td><b>UIQ</b></td>
       
    20     <td><div align="center"><img src="images/uiq_setting_tracing_options.png" width="240" height="320"></div></td>
       
    21   </tr>
       
    22 </table>
       
    23 <p class="figure">Figure 1. Tracing options screen in Profiler (S60 and UIQ)</p>
       
    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">
       
    60   <h4>Setting a Tracing Option</h4>
       
    61   <ol>
       
    62     <li>Launch the Profiler application on the target device </li>
       
    63 <li>Open the Profiler options screen: </li>
       
    64     <ul>
       
    65   <li>S60 - Select the Tracing menu</li>
       
    66   <li>UIQ - Select the Tracing Options menu</li>
       
    67 </ul>
       
    68   <li>Set the desired option on or off</li>
       
    69   <li>Exit the screen</li>
       
    70   </ol>
       
    71 </div>
       
    72 <h5>Related references
       
    73 </h5>
       
    74 <ul>
       
    75   <li><a href="prof_using.htm">Using the Profiler</a></li>
       
    76 </ul>
       
    77 <h5>Related tasks</h5>
       
    78 <ul>
       
    79   <li><a href="advanced_options.htm">Setting Advanced Options</a></li>
       
    80   <li><a href="output_settings.htm">Setting Output Settings </a> </li>
       
    81 </ul>
       
    82 <div id="footer">Copyright &copy; 2009 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>
       
    83 </body>
       
    84 </html>