sysperfana/analyzetoolext/com.nokia.s60tools.analyzetool.help/html/concepts/preferences.htm
author Matti Laitinen <matti.t.laitinen@nokia.com>
Tue, 24 Aug 2010 12:16:27 +0300
changeset 15 0367d2db2c06
parent 6 f65f740e69f9
permissions -rw-r--r--
AnalyzeTool Carbide extension 1.10.0

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 1.0 Transitional//EN">
<html>
<head>
  <meta http-equiv="content-type" content="text/html; charset=iso-8859-1">
  <meta http-equiv="content-style-type" content="text/css">
  <title>AnalyzeTool preferences</title>
  <link href="../../book.css" type="text/css" rel="StyleSheet">
</head>

<body>
<h2>AnalyzeTool preferences</h2>

<p>You can change the AnalyzeTool preferences by selecting <b>Window &gt;
Preferences...&gt; Carbide Extensions &gt; AnalyzeTool</b>.</p>

<p><img src="../images/AT_preferences.png" alt="Setting preferences"></p>

<p>The AnalyzeTool preferences are described in the following table:</p>

<table width="615" border="1" cellspacing="1" cellpadding="2">
  <colgroup><col width="250*">
    <col width="356*">
  </colgroup>
  <tbody>
    <tr>
      <th>Options</th>
      <th align="center">Description</th>
    </tr>
    <tr>
      <td>AnalyzeTool Engine</td>
      <td>AnalyzeTool uses the command line utility <i>atool.exe</i> which is
        used for instrumenting and uninstrumenting the project and analysing
        captured data. 
        <ul>
          <li><strong>Use internal command line engine</strong>: This option
            uses the built-in version of <i>atool.exe</i>. </li>
          <li><strong>Use external command line engine</strong>: This options
            uses <i>atool.exe</i> from the location selected to the
            <strong>Atool.exe path</strong> field. </li>
        </ul>

        <p>When the <em>atool.exe</em> version has been selected, the system
        automatically checks that it matches with the version of the
        AnalyzeTool Carbide extension. In case of a mismatch, an error is
        displayed "<em>Command Line Engine is older than x.x.x</em>", and the
        <strong>Apply</strong> and <strong>OK</strong> buttons are disnabled.
        In this case you need to select a later CLE tool version. For more
        information, see <a href="../reference/troubleshooting.htm">AnalyzeTool
        Troubleshooting</a>.</p>
      </td>
    </tr>
    <!--<tr>
    <td>Generate statistics</td>
    <td>Enables AnalyzeTool to generate memory statistics.</td>
    </tr>-->
    <tr>
      <td>Verbose output</td>
      <td>Enables command line engine debug information to the <b>Console</b>
        view.</td>
    </tr>
    <tr>
      <td>Engine version</td>
      <td>Displays selected engine's version number.</td>
    </tr>
    <tr>
      <td>Output mode</td>
      <td>Specifies the output mode for AnalyzeTool build. 
        <ul>
          <li><strong>Output to trace (recommended)</strong>: This option will
            send the memory analysis data through tracing utility connection.
            For more information, see <a
            href="../tasks/capture.htm#capture_external">Capturing data in
            output to trace mode</a>.</li>
          <li><strong>Output to file system</strong>: This option will create a
            data file to the target hardware. When using this option, you must
            define a location and name for the data file. For more information,
            see <a href="../tasks/capture.htm#capture_s60_file">Capturing data
            in output to file system mode</a> 
            <ul>
              <li><strong>Log file path</strong>: Type here the location for
                the log file.</li>
              <li><strong>File name</strong>: Type here the name you want to
                use for the log file</li>
            </ul>
          </li>
          <li><strong>Ask always</strong>: When this option is selected,
            Analyse tool will display a dialog, asking which output mode you
            want to use, each time you build a project.</li>
        </ul>
      </td>
    </tr>
    <tr>
      <td>Stored callstack size</td>
      <td><ul>
          <li><strong>No callstack stored</strong>: This option does not store
            any callstack items.</li>
          <li><strong>40 items</strong>: This option stores forty callstack
            items.</li>
          <li><strong>100 items</strong>: This option stores hundred callstack
            items. Note that storing this meni items </li>
          <li><strong>Custom size (0-255</strong>): This option provides
            possibility to define custom size of callstack items. Custom size
            of callstack items is limited to 0-255</li>
        </ul>
        <b>Note!</b> The callstack size affects the speed of hooked process,
        lower callstack size is faster. </td>
    </tr>
    <tr>
      <td>Report level</td>
      <td>Specifies the report level of memory leak analysis results. 
        <ul>
          <li>Show every detail: This option displays all the call stack
            information.</li>
          <li>Show only known code lines: This option displays all the known
            line numbers of call stack information.</li>
          <li>Show only topmost memory allocation code line: This option
            displays the first known line of call stack information.</li>
        </ul>
      </td>
    </tr>
  </tbody>
</table>

<div id="footer">
Copyright © 2010 Nokia Corporation and/or its subsidiary(-ies). All rights
reserved. License: <a
href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a>.</div>
</body>
</html>