debuggercdi/com.nokia.carbide.cpp.debug.crashdebugger/html/DebuggingInformation/CrashDebuggerUsingMAKSYM-Ref.guide.html
author tzelaw
Tue, 14 Apr 2009 15:03:19 -0500
changeset 94 d74b720418db
parent 2 d760517a8095
child 990 5d016a880824
child 1024 48b401835d0a
permissions -rw-r--r--
Test framework support: Ask debugger to remember DebugTarget so test framework can use it to setup test framework related utility. With this we can use the DebugUI way of launching while keeping test framework functionality
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
2
cawthron
parents:
diff changeset
     1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
cawthron
parents:
diff changeset
     2
	"http://www.w3.org/TR/html4/loose.dtd">
cawthron
parents:
diff changeset
     3
	<html><head>
cawthron
parents:
diff changeset
     4
	<title>Using the MAKSYM tool in Debugging information</title>
cawthron
parents:
diff changeset
     5
	<link href="../../book.css" type="text/css" rel="stylesheet" >
cawthron
parents:
diff changeset
     6
	<link href="sysdoc-eclipse.css" type="text/css" rel="stylesheet" media="screen">
cawthron
parents:
diff changeset
     7
	<link href="sysdoc-eclipse.css" type="text/css" rel="stylesheet" media="print">
cawthron
parents:
diff changeset
     8
<div class="Head1">
cawthron
parents:
diff changeset
     9
cawthron
parents:
diff changeset
    10
<h2>Using the MAKSYM Tool</h2>
cawthron
parents:
diff changeset
    11
</div><div>
cawthron
parents:
diff changeset
    12
<p>MAKSYM is a command line tool that processes the log file generated
cawthron
parents:
diff changeset
    13
when building a ROM image, and creates a text file that lists the address of
cawthron
parents:
diff changeset
    14
every global and exported function in the ROM.</p>
cawthron
parents:
diff changeset
    15
<p>Reference: tools: MAKSYM outlines
cawthron
parents:
diff changeset
    16
the syntax of the command.</p>
cawthron
parents:
diff changeset
    17
<p>If you know the address of the instruction which caused an exception,
cawthron
parents:
diff changeset
    18
you can compare this address with the MAKSYM log to see which function this is
cawthron
parents:
diff changeset
    19
in. You can narrow this down to the exact code within the function by using
cawthron
parents:
diff changeset
    20
ABLD LISTING to get the assembler output from the compiler.</p>
cawthron
parents:
diff changeset
    21
<p>The following example MAKSYM log is taken from an EKA1 build;
cawthron
parents:
diff changeset
    22
however, the principle is the same for EKA2.</p>
cawthron
parents:
diff changeset
    23
<p class="listing">From    \Epoc32\Release\Misa\UREL\ekern.exe<br>
cawthron
parents:
diff changeset
    24
  <br>50003040    0094    _E32Startup<br>500030d4    002c    ImpDma::Init1(void)<br>50003100    0004    ImpDma::Init3(void)<br>50003104    0008    ImpDma::MaxBlockSize(void)</p>
cawthron
parents:
diff changeset
    25
<p>If, for example, the code address of the exception is at
cawthron
parents:
diff changeset
    26
0x500030dc, then you can see from the log that this is in the
cawthron
parents:
diff changeset
    27
ImpDma::Init1() function, at offset 8 from the start of the
cawthron
parents:
diff changeset
    28
function. This function is in the file
cawthron
parents:
diff changeset
    29
...\e32\ekern\epoc\arm\sa1100\ka_dma.cpp, so use ABLD LISTING to
cawthron
parents:
diff changeset
    30
obtain the assembler:</p>
cawthron
parents:
diff changeset
    31
<p class="listing">&gt; cd \e32</p>
cawthron
parents:
diff changeset
    32
<p class="listing">&gt; abld listing misa urel ekern ka_dma </p>
cawthron
parents:
diff changeset
    33
<p>Notice that you must specify the component that the file is part of,
cawthron
parents:
diff changeset
    34
in this case EKERN, and that you do not put the .cpp extension on
cawthron
parents:
diff changeset
    35
the source file name. If you do not specify a source file ABLD will create an
cawthron
parents:
diff changeset
    36
assembler listing for every file in component EKERN.</p>
cawthron
parents:
diff changeset
    37
<p>The listing file will be placed in the same directory as
cawthron
parents:
diff changeset
    38
ka_dma.cpp, and will be called ka_dma.lis. If you
cawthron
parents:
diff changeset
    39
look at this file you will see something like this:</p>
cawthron
parents:
diff changeset
    40
<p class="listing">7              &nbsp;Init1__6ImpDma:<br>&nbsp;&nbsp;&nbsp;8              &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;@ args = 0, pretend = 0, frame = 0<br>&nbsp;&nbsp;&nbsp;9              &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;@ frame_needed = 0, current_function_anonymous_args = 0<br>&nbsp;&nbsp;10              &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;@ I don't think this function clobbers lr<br>&nbsp;&nbsp;11 0000 18209FE5 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;ldr&nbsp;&nbsp;&nbsp;&nbsp;r2, .L793<br>&nbsp;&nbsp;12 0004 0630A0E3 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;mov&nbsp;&nbsp;&nbsp;&nbsp;r3, #6<br>&nbsp;&nbsp;13 0008 003082E5 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;str&nbsp;&nbsp;&nbsp;&nbsp;r3, [r2, #0]<br>&nbsp;&nbsp;14 000c 10309FE5 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;ldr&nbsp;&nbsp;&nbsp;&nbsp;r3, .L793+4<br>&nbsp;&nbsp;15 0010 10009FE5 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;ldr&nbsp;&nbsp;&nbsp;&nbsp;r0, .L793+8<br>&nbsp;&nbsp;16 0014 000083E5 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;str&nbsp;&nbsp;&nbsp;&nbsp;r0, [r3, #0]<br>&nbsp;&nbsp;17 0018 1810A0E3 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;mov&nbsp;&nbsp;&nbsp;&nbsp;r1, #24<br>&nbsp;&nbsp;18 001c FEFFFFEA &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;b&nbsp;&nbsp;FillZ__3MemPvi</p>
cawthron
parents:
diff changeset
    41
<p>Offset 8 is the first STR instruction. Comparing this with the C++
cawthron
parents:
diff changeset
    42
source:</p>
cawthron
parents:
diff changeset
    43
<p class="listing">void ImpDma::Init1()<br>//<br>// Phase 1 initialisation of the Dma channels<br>//<br>&nbsp;&nbsp;&nbsp;&nbsp;{<br>&nbsp;&nbsp;&nbsp;&nbsp;PP::DmaMaxChannels=KNumberOfDmaChannels;<br>&nbsp;&nbsp;&nbsp;&nbsp;PP::DmaChannelTable=(TDma **)(&amp;DmaChannels[0]);<br>&nbsp;&nbsp;&nbsp;&nbsp;Mem::FillZ(PP::DmaChannelTable,sizeof(TDma *)*KNumberOfDmaChannels);<br>&nbsp;&nbsp;&nbsp;&nbsp;}</p>
cawthron
parents:
diff changeset
    44
<p>The first store is to PP::DmaMaxChannels, so clearly there is a
cawthron
parents:
diff changeset
    45
problem writing this memory. </p> 
cawthron
parents:
diff changeset
    46
cawthron
parents:
diff changeset
    47
	   </div>
cawthron
parents:
diff changeset
    48
<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>
cawthron
parents:
diff changeset
    49
	   </body>
cawthron
parents:
diff changeset
    50
	   </html>
cawthron
parents:
diff changeset
    51