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-- |
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\<device>\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&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> |