<?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-1560C4FF-82EC-5E5D-A37D-3BBE046F0A5B" xml:lang="en"><title>Target

Types</title><prolog><metadata><keywords/></metadata></prolog><conbody>

<ul>

<li id="GUID-2254E482-D730-5661-9878-6B90F17977F4"><p><xref href="GUID-1560C4FF-82EC-5E5D-A37D-3BBE046F0A5B.dita#GUID-1560C4FF-82EC-5E5D-A37D-3BBE046F0A5B/GUID-5D0338E0-E2D4-5904-9B21-244CA52DD91B">Generation of STDEXE, STDDLL and STDLIB</xref>  </p> </li>

<li id="GUID-F57FF724-6A83-5746-B85E-7548B8BD911A"><p><xref href="GUID-1560C4FF-82EC-5E5D-A37D-3BBE046F0A5B.dita#GUID-1560C4FF-82EC-5E5D-A37D-3BBE046F0A5B/GUID-801FC48D-BCE4-51A1-8D27-F66505A6C6AA">WCHARENTRYPOINT - new keyword</xref>  </p> </li>

<li id="GUID-D9117869-204F-51ED-8E40-F6D5F4D5889B"><p><xref href="GUID-1560C4FF-82EC-5E5D-A37D-3BBE046F0A5B.dita#GUID-1560C4FF-82EC-5E5D-A37D-3BBE046F0A5B/GUID-21D63C00-362C-50AE-BCAF-65572BF23F5E">External functions and symbols exported by default</xref>  </p> </li>

</ul>

<section id="GUID-5D0338E0-E2D4-5904-9B21-244CA52DD91B"><title>Generation

of STDEXE, STDDLL and STDLIB</title> <p>The introduction of two new Symbian

platform target types, <codeph>STDEXE</codeph> and <codeph>STDDLL</codeph>,

was required to enable the specific options for compilers and linkers to generate

P.I.P.S. executables. </p> <p>P.I.P.S. executables are implemented using native

Symbian platform executables linked statically to the glue code. The target

types <codeph>STDEXE</codeph> and <codeph>STDDLL</codeph> make symbol information

available for lookup by name. </p> <p>For each new target type the following

library files, system files and include paths are included <i>by default</i>.

The table below shows the additional libraries and paths for the new target

types. </p> <table id="GUID-8C82882E-0F2A-5CD0-B318-04FD5FC88A01">

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

<tbody>

<row>

<entry><p> <b>Target Type</b>  </p> </entry>

<entry><p> <b>File/Path</b>  </p> </entry>

<entry><p> <b>Purpose</b>  </p> </entry>

</row>

<row>

<entry><p> <codeph>STDEXE</codeph>  </p> </entry>

<entry><p> <filepath>libcrt0.lib</filepath>  </p> </entry>

<entry><p>Multithreaded 'glue code' library. Provides the <xref href="GUID-92602438-C8AC-3E15-ABB1-DCB8E8771E0C.dita"><apiname>E32Main()</apiname></xref> entry

point for a <filepath>.exe</filepath> that uses the char <xref href="GUID-13E4A48A-07DB-34E6-B220-C4B134D6DF13.dita"><apiname>main()</apiname></xref> function. </p> </entry>

</row>

<row>

<entry><p> <codeph>STDEXE</codeph>  </p> </entry>

<entry><p> <filepath>libwcrt0.lib</filepath>  </p> </entry>

<entry><p>Multithreaded 'glue code' library. Provides the <codeph>E32Main()</codeph> entry

point for a <filepath>.exe</filepath> that uses the wide char <codeph>main()</codeph> function. </p> </entry>

</row>

<row>

<entry><p> <codeph>STDEXE</codeph> | <codeph>STDDLL</codeph> | <codeph>STDLIB</codeph>  </p> </entry>

<entry><p> <filepath>euser.lib</filepath>, <filepath>backend.lib</filepath>  </p> </entry>

<entry><p>Fundamental libraries that are linked by default for <codeph>STDEXE</codeph> s

and <codeph>STDDLL</codeph> s. </p> </entry>

</row>

<row>

<entry><p> <codeph>STDEXE</codeph> | <codeph>STDDLL</codeph> | <codeph>STDLIB</codeph>  </p> </entry>

<entry><p> <filepath>\epoc32\include\stdapis</filepath>  </p> </entry>

<entry><p>Location of standard header files for P.I.P.S.. </p> </entry>

</row>

</tbody>

</tgroup>

</table> <p>The new target types for P.I.P.S. are <codeph>STDEXE</codeph>, <codeph>STDDLL</codeph> and <codeph>STDLIB</codeph> (<codeph>STDLIB</codeph> s are the P.I.P.S. static libraries). For <codeph>STDLIB</codeph> s, the

user need not annotate source with <xref href="GUID-2F78C3AC-7330-34C0-8A83-75D7345F2DC8.dita"><apiname>EXPORT_C</apiname></xref> or <xref href="GUID-BD292953-36BF-3C7D-AA93-98E6CB38968E.dita"><apiname>IMPORT_C</apiname></xref>.

All symbols with <codeph>extern</codeph> linkage are: </p> <ol id="GUID-9D6A6BB0-C2DC-50F5-B5D4-97CBD381D10A">

<li id="GUID-7828C346-6ED2-5B6A-B89D-12D988FED39E"><p>exported if they are

defined in the module, and </p> </li>

<li id="GUID-42BFE700-719A-5DE9-8732-30E82DBAE304"><p>imported if they are

referred to but not defined. </p> </li>

</ol> <p>The compiler marks the symbols imported/exported for <codeph>STDLIB</codeph> s,

while for native Static Libraries the user explicitly needs to specify <codeph>EXPORT_C</codeph> /<codeph>IMPORT_C</codeph>. </p> </section>

<section id="GUID-801FC48D-BCE4-51A1-8D27-F66505A6C6AA"><title>WCHARENTRYPOINT

- new keyword</title> <p>The user should include the new keyword <codeph>WCHARENTRYPOINT</codeph> in

MMP files to select the <xref href="GUID-6CDDDD1E-BDB9-5C61-8EFD-8B3369F5A12D.dita#GUID-6CDDDD1E-BDB9-5C61-8EFD-8B3369F5A12D/GUID-49C7F951-8317-5F41-B1B9-9F7B8803E655">Glue

code (CRT0)</xref> library for the wide char main entry point, <filepath>libwcrt0.lib</filepath>.

This option is valid only for the <codeph>STDEXE</codeph> target type and

will be ignored if used with other target types. </p> </section>

<section id="GUID-21D63C00-362C-50AE-BCAF-65572BF23F5E"><title>External functions

and symbols exported by default </title> <p>With a <codeph>STDDLL</codeph> library,

functions and data with external linkage are exported by default, without

any requirement for the <xref href="GUID-BD292953-36BF-3C7D-AA93-98E6CB38968E.dita"><apiname>IMPORT_C</apiname></xref> and <xref href="GUID-2F78C3AC-7330-34C0-8A83-75D7345F2DC8.dita"><apiname>EXPORT_C</apiname></xref> declarations

in header or source files. It is important to note that in the Linux world

all symbols with external linkage are visible outside a shared object. </p> <p>When

porting C APIs to the Symbian platform, the user should use the

new <codeph>STDDLL</codeph> target type to indicate to the tool chain that

all functions and global data should be exported. </p> </section>

</conbody></concept>