crashanalysis/crashanalyser/com.nokia.s60tools.crashanalyser.help/html/concepts/selge_vs_symbol.htm
author Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
Tue, 20 Apr 2010 14:41:43 +0300
changeset 4 615035072f7e
parent 0 5ad7ad99af01
permissions -rw-r--r--
Crash Analyser Carbide extension v1.3
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
4
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
     1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
     2
<html>
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
     3
<head>
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
     4
  <meta http-equiv="content-type" content="text/html; charset=iso-8859-1">
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
     5
  <title>Symbol files, Map files, OST dictionary files, and Image files</title>
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
     6
  <link href="../../book.css" type="text/css" rel="stylesheet">
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
     7
</head>
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
     8
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
     9
<body>
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    10
<h2>Symbol files, Map files, OST dictionary files, and Image files</h2>
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    11
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    12
<p>In the Crash Analyser Import Wizard, you have to define either the symbol
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    13
files or map files or both of them. Defining image files is optional.</p>
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    14
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    15
<h4>Symbol files</h4>
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    16
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    17
<p>When you create an image, symbol files are generated automatically. Symbol
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    18
files contain the binary structure of an image, which is needed for producing
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    19
an analysis file. You can find a symbol file for example from
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    20
<i>\epoc32\rombuild\&lt;device&gt;\core.</i></p>
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    21
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    22
<p>If you have defined symbol files, you can define also map files and image
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    23
files.</p>
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    24
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    25
<h4>Map files</h4>
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    26
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    27
<p>If you need to define map files, you can select the <b>Map files folder</b>
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    28
option to define the location of map files, or you can select
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    29
<b>MapFiles.zip</b> option if you want to provide a ZIP file containing the map
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    30
files. If you choose the <b>SDK Map files folder</b> option, the Crash Analyser
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    31
Import Wizard checks which SDKs you have installed in Carbide.c++, and lists
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    32
the directories of each SDK which contain map files. Choose the directory you
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    33
want. If you do not want to define any map files, then select the <b>No map
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    34
files</b> option.</p>
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    35
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    36
<h4>Image files</h4>
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    37
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    38
<p>The following image file types can be selected in the Import Wizard. You can
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    39
also select more that one type at the time.</p>
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    40
<ul>
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    41
  <li><b>R&amp;D image file</b> (.fpsx,), is a flashable Nokia proprietary
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    42
    image file containing the software for the phone.</li>
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    43
  <li><b>Core image file</b> (.Cxx), is a language independent flashable phone
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    44
    software file.</li>
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    45
  <li><b>Variant image file</b> (.Vxx.), is an image file which contains the
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    46
    language, country or operator variant specific phone software.</li>
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    47
  <li><b>(.img) image file</b> is a Symbian OS flashable image file.</li>
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    48
</ul>
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    49
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    50
<p>All the files (.fpsx, .Cxx, .Vxx, .img) refer to flash image files. Usually
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    51
only one / few of them are needed, the extension just differs in different
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    52
environments. The files are the ones that are flashed to phone e.g. with
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    53
Phoenix tool. The image files are not absolutely necessary but they enable the
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    54
analyser to do more precise decoding than just symbol files.</p>
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    55
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    56
<p>Different environments put these files to different locations, common
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    57
locations under SDK root are for example \epoc32\rombuild and \Rom_images_2009.
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    58
If you have not flashed your development phone yourself, it may be difficult to
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    59
find the original flash images anywhere. Most of flash files available can be
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    60
found from Notes DCT5 database, but the decoding files must match the flash
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    61
image in phone exactly. Only reliable way is to flash a certain image first and
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    62
use flash image for decoding only for crashes from that image.</p>
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    63
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    64
<h4>OST dictionary files</h4>
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    65
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    66
<p>OST dictionaries are XML files generated by TraceCompiler. The files are
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    67
used to translate the binary trace to human-readable format. The files are
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    68
located in your environment under <em>\epoc32\ost_dictionaries</em>.</p>
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    69
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    70
<h5>Related concepts</h5>
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    71
<ul>
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    72
  <li><a href="../concepts/how_to_analyse_crash.htm">How to analyse a crash
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    73
  </a></li>
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    74
</ul>
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    75
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    76
<h5>Related tasks</h5>
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    77
<ul>
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    78
  <li><a href="../tasks/import_crash_files.htm">Importing crash files</a></li>
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    79
</ul>
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    80
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    81
<div id="footer">
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    82
Copyright © 2010 Nokia Corporation and/or its subsidiary(-ies). All rights
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    83
reserved. License: <a
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    84
href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a>.</div>
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    85
</body>
615035072f7e Crash Analyser Carbide extension v1.3
Jussi Ryoma <ext-jussi.s.ryoma@nokia.com>
parents: 0
diff changeset
    86
</html>