--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/Symbian3/SDK/Source/GUID-B661DFBC-9779-597D-A1DA-4FE085DAA61A.dita	Thu Jan 21 18:18:20 2010 +0000
@@ -0,0 +1,116 @@
+<?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-B661DFBC-9779-597D-A1DA-4FE085DAA61A" xml:lang="en"><title>CRT0
+Libraries of STDLIB</title><prolog><metadata><keywords/></metadata></prolog><conbody>
+<p>This section explains the CRT0 libraries provided by STDLIB. </p>
+<p>The following table lists the CRT0 libraries: </p>
+<table id="GUID-D74087AE-6FCA-5C46-98AE-EAC4AE3B6867">
+<tgroup cols="2"><colspec colname="col0"/><colspec colname="col1"/>
+<thead>
+<row>
+<entry>Simple Mode (thread local mode)</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry><p> <codeph>ecrt0.lib</codeph>  </p> </entry>
+<entry><p>EABI Emulators Narrow <codeph>char main (int
+argc, char *argv[], char                 *envp[])</codeph>  </p> </entry>
+</row>
+<row>
+<entry><p> <codeph>wecrt0.lib</codeph>  </p> </entry>
+<entry><p>EABI Emulators Wide <codeph>char main (int
+argc, wchar_t *argv[],                 wchar_t *envp[])</codeph>  </p> </entry>
+</row>
+<row>
+<entry valign="bottom"><p><b>Complex Mode (multi threaded mode / POSIX server
+mode)</b></p></entry>
+<entry valign="bottom"/>
+</row>
+<row>
+<entry><p> <codeph> mcrt0.lib</codeph>  </p> </entry>
+<entry><p>EABI Emulators Narrow <codeph>char main (int
+argc, char *argv[], char                 *envp[]</codeph>  </p> </entry>
+</row>
+<row>
+<entry><p> <codeph>wcrt0.lib</codeph>  </p> </entry>
+<entry><p>Emulators Narrow <codeph>char main (int argc,
+char *argv[], char                 *envp[])</codeph> with stdxxx redirection
+to Win32 using RWin32Stream server </p> </entry>
+</row>
+<row>
+<entry><p> <codeph>wmcrt0.lib</codeph>  </p> </entry>
+<entry><p>EABI Emulators Wide <codeph>char wmain (int
+argc, wchar_t *argv[],                 wchar_t *envp[])</codeph>  </p> </entry>
+</row>
+<row>
+<entry><p> <codeph>wwcrt0.lib</codeph>  </p> </entry>
+<entry><p>Emulator Wide <codeph>char wmain (int argc,
+wchar_t *argv[], wchar_t                 *envp[])</codeph> with stdxxx redirection
+to Win32 using RWin32Stream server </p> </entry>
+</row>
+<row>
+<entry valign="bottom"><p><b>Other</b></p></entry>
+<entry valign="bottom"/>
+</row>
+<row>
+<entry><p> <codeph>estw32.dll</codeph>  </p> </entry>
+<entry><p>Emulators: Provides the RWin32Stream server </p> </entry>
+</row>
+<row>
+<entry><p> <codeph>redircli.dll</codeph>  </p> </entry>
+<entry><p>EABI Emulators: Provides application specific redirection
+(for example, to Java RT or test applications). </p> </entry>
+</row>
+</tbody>
+</tgroup>
+</table>
+<p>These static libraries provide the compiler runtime glue code that runs
+from the Symbian <codeph>E32Main()</codeph> entry point for regular Symbian
+executables into the standard C <codeph>main()</codeph> entry point. </p>
+<p>These executables are considered to be C programs hosted in a Symbian executable
+image. The glue code has a number of functions to perform, for example: </p>
+<ul>
+<li id="GUID-2692C4C1-78E3-5F5B-BA1F-53FCE4CC085C"><p>marshalling the process
+command arguments in the types used by <codeph>main()</codeph>  </p> </li>
+<li id="GUID-822978FA-C8B4-5E01-A19A-F99306D31582"><p>initialising the C Standard
+library context and mode of operation for example, calling <codeph>SpawnPosixServerThread()</codeph>. </p> </li>
+</ul>
+<section><title>ECRT0.lib and the cleanup stack</title> <p>A normal Symbian
+platform executable provides an <codeph>E32Main()</codeph> function which
+is called by the operating system to start the program. The file <filepath>ecrt0.lib</filepath> provides
+an <codeph>E32Main()</codeph> function for programs which use STDLIB. This
+function prepares the traditional <codeph>argc</codeph> and <codeph>argv</codeph> arguments,
+and passes them to <codeph>main()</codeph>. </p> <p>For a simple example demonstrating
+how to link to <filepath>ecrt0.lib</filepath>, see the description of the
+project specification for "Hello World" in <xref href="GUID-F51062B0-90BB-5659-9F23-2FF25116D78A.dita">Porting</xref>.
+The user of STDLIB need not use <filepath>ecrt0.lib</filepath>, and may provide
+their own <codeph>E32Main()</codeph>. In this case, a <codeph>CTrapCleanup</codeph> pointer
+should normally be provided. This pointer is required because although STDLIB
+does not call Symbian platform functions which can leave, it uses few functions
+which require a cleanup stack. Code in <filepath>ecrt0.lib</filepath> provides
+such a cleanup stack ("<codeph>TheTrapCleanup</codeph> "), but programs which
+do not link with <filepath>ecrt0.lib</filepath> must supply one directly. </p> <p>For
+more details on the motivation behind Symbian's use of the cleanup stack,
+see <xref href="GUID-61DEE78D-4E78-5367-BC8A-F99D3B4E9D5A.dita">Cleanup support</xref>. </p> <p> <b> NOTE</b>:
+If the program is a UI application, that is, one that includes the following
+code in one of the source files: </p> <codeblock id="GUID-D8C4F7A9-9755-58EC-BED9-0232259970BE" xml:space="preserve">GLDEF_C TInt E32Main()
+    {
+    return EikStart::RunApplication(NewApplication);
+    }</codeblock> <p>then, the <codeph>CTrapCleanup</codeph> pointer is provided
+by the application framework. </p> </section>
+</conbody><related-links>
+<link href="GUID-F51062B0-90BB-5659-9F23-2FF25116D78A.dita"><linktext>Porting Tutorials</linktext>
+</link>
+<link href="GUID-61DEE78D-4E78-5367-BC8A-F99D3B4E9D5A.dita"><linktext>Cleanup support
+guide</linktext></link>
+</related-links></concept>
\ No newline at end of file