<?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>