Symbian3/PDK/Source/GUID-F9A98EF0-0285-5B95-8FAD-3B310EB62D8C.dita
author Dominic Pinkman <Dominic.Pinkman@Nokia.com>
Thu, 11 Mar 2010 18:02:22 +0000
changeset 3 46218c8b8afa
parent 1 25a17d01db0c
child 5 f345bda72bc4
permissions -rw-r--r--
week 10 bug fix submission (SF PDK version): Bug 1892, Bug 1897, Bug 1319. Also 3 or 4 documents were found to contain code blocks with SFL, which has been fixed. Partial fix for broken links, links to Forum Nokia, and the 'Symbian platform' terminology issues.

<?xml version="1.0" encoding="utf-8"?>
<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->
<!-- This component and the accompanying materials are made available under the terms of the License 
"Eclipse Public License v1.0" which accompanies this distribution, 
and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->
<!-- Initial Contributors:
    Nokia Corporation - initial contribution.
Contributors: 
-->
<!DOCTYPE concept
  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<concept id="GUID-F9A98EF0-0285-5B95-8FAD-3B310EB62D8C" xml:lang="en"><title>Variant
Specific Startup Overview</title><shortdesc>This overview briefly describes the variant specific startup utility. </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>
<section id="GUID-E1548A6F-1A46-4CCA-B309-BD365E51821E"><title>Purpose</title> <p>The variant specific startup utility is
the first part of the kernel to run. </p> </section>
<section id="GUID-9FDF4561-11EE-4046-B413-F343A6A67705"><title>Variant specific startup library details</title> <p>The DLL
that provides the functionality and the library to which your code must link
is identified below. </p> <table id="GUID-F18E52DF-FAE6-51BF-980D-D214DB22A7B2">
<tgroup cols="3"><colspec colname="col0"/><colspec colname="col1"/><colspec colname="col2"/>
<thead>
<row>
<entry>DLL</entry>
<entry>LIB</entry>
<entry>Short description</entry>
</row>
</thead>
<tbody>
<row>
<entry><p> <filepath>None</filepath>  </p> </entry>
<entry><p> <filepath> kc_exe.lib</filepath>  </p> </entry>
<entry><p>Variant specific startup utility. </p> </entry>
</row>
</tbody>
</tgroup>
</table> </section>
<section id="GUID-054C50A2-F9FD-44EB-AFA7-931B626F63DC"><title>Description</title> <p>The variant specific startup utility
is the first part of the kernel that runs. It runs right after the bootstrap. </p> <p> <filepath>kc_exe.lib</filepath> is
built as a separate library and then linked in so that it is run at the very
beginning of <filepath>ekern.exe</filepath>. </p> <p> <filepath>kc_exe.lib</filepath> contains: </p> <ul>
<li id="GUID-E3DE979D-7B04-5D82-921C-E391848683CD"><p>ROM header address passed
in by bootstrap </p> </li>
<li id="GUID-84E068F3-8265-5875-9CDC-FD67C2BA2BF3"><p>super page address passed
in by bootstrap. </p> </li>
</ul> </section>
<section id="GUID-6A065469-7969-4099-9F5E-F537371A94EE"><title>Using the variant specific startup library</title> <p>The
DLL is made up of these template files: </p> <ul>
<li id="GUID-C1E00EFF-A197-586E-980F-43A1D33DF4FA"><p>k_entry.cpp </p> </li>
<li id="GUID-EB17DC8D-9B02-54EA-BE44-D8B3F895C9BB"><p>k_entry.cia </p> </li>
</ul> <p>These can be found in the directory <filepath>template\template_variant\specific\</filepath>. </p> <p>The
source files in the <filepath>template_assp</filepath> folder are quite well
commented and should provide ample information on usage. </p> </section>
</conbody></concept>