1 <?xml version="1.0" encoding="utf-8"?>

     2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->

     3 <!-- This component and the accompanying materials are made available under the terms of the License 

     4 "Eclipse Public License v1.0" which accompanies this distribution, 

     5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->

     6 <!-- Initial Contributors:

     7     Nokia Corporation - initial contribution.

     8 Contributors: 

     9 -->

    10 <!DOCTYPE concept

    11   PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">

    12 <concept id="GUID-F9A98EF0-0285-5B95-8FAD-3B310EB62D8C" xml:lang="en"><title>Variant

    13 Specific Startup Overview</title><shortdesc>This overview briefly describes the variant specific startup utility. </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>

    14 <section id="GUID-E1548A6F-1A46-4CCA-B309-BD365E51821E"><title>Purpose</title> <p>The variant specific startup utility is

    15 the first part of the kernel to run. </p> </section>

    16 <section id="GUID-9FDF4561-11EE-4046-B413-F343A6A67705"><title>Variant specific startup library details</title> <p>The DLL

    17 that provides the functionality and the library to which your code must link

    18 is identified below. </p> <table id="GUID-F18E52DF-FAE6-51BF-980D-D214DB22A7B2">

    19 <tgroup cols="3"><colspec colname="col0"/><colspec colname="col1"/><colspec colname="col2"/>

    20 <thead>

    21 <row>

    22 <entry>DLL</entry>

    23 <entry>LIB</entry>

    24 <entry>Short description</entry>

    25 </row>

    26 </thead>

    27 <tbody>

    28 <row>

    29 <entry><p> <filepath>None</filepath>  </p> </entry>

    30 <entry><p> <filepath> kc_exe.lib</filepath>  </p> </entry>

    31 <entry><p>Variant specific startup utility. </p> </entry>

    32 </row>

    33 </tbody>

    34 </tgroup>

    35 </table> </section>

    36 <section id="GUID-054C50A2-F9FD-44EB-AFA7-931B626F63DC"><title>Description</title> <p>The variant specific startup utility

    37 is the first part of the kernel that runs. It runs right after the bootstrap. </p> <p> <filepath>kc_exe.lib</filepath> is

    38 built as a separate library and then linked in so that it is run at the very

    39 beginning of <filepath>ekern.exe</filepath>. </p> <p> <filepath>kc_exe.lib</filepath> contains: </p> <ul>

    40 <li id="GUID-E3DE979D-7B04-5D82-921C-E391848683CD"><p>ROM header address passed

    41 in by bootstrap </p> </li>

    42 <li id="GUID-84E068F3-8265-5875-9CDC-FD67C2BA2BF3"><p>super page address passed

    43 in by bootstrap. </p> </li>

    44 </ul> </section>

    45 <section id="GUID-6A065469-7969-4099-9F5E-F537371A94EE"><title>Using the variant specific startup library</title> <p>The

    46 DLL is made up of these template files: </p> <ul>

    47 <li id="GUID-C1E00EFF-A197-586E-980F-43A1D33DF4FA"><p>k_entry.cpp </p> </li>

    48 <li id="GUID-EB17DC8D-9B02-54EA-BE44-D8B3F895C9BB"><p>k_entry.cia </p> </li>

    49 </ul> <p>These can be found in the directory <filepath>template\template_variant\specific\</filepath>. </p> <p>The

    50 source files in the <filepath>template_assp</filepath> folder are quite well

    51 commented and should provide ample information on usage. </p> </section>

    52 </conbody></concept>