<?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-C8674786-6C09-45C2-BA5D-4F69EBD8E42F" xml:lang="en"><title>Creating

the MMP File</title><shortdesc/><prolog><metadata><keywords/></metadata></prolog><conbody>

<p><b>Add needed libraries used by the MMP file structure:</b></p>

<p>If developers want to use any of the P.I.P.S. libraries, they need to link

to the corresponding library in the MMP file using the <codeph>LIBRARY</codeph> keyword.</p>

<p>If the application has <codeph>main()</codeph> as the entry point, the

library <filepath>libcrt0.lib</filepath> must be specified as the first library

otherwise, it will result in linker errors. The user must link to the Symbian

platform <filepath>euser.dll</filepath>. This is required since the static

library uses some of the services of the Symbian platform such as creating

cleanup stack, and having a top level TRAP. All these details are hidden from

the developer. The developer will write the application as if it were for

the UNIX environment.</p>

<codeblock xml:space="preserve">STATICLIBRARY  libcrt0.lib

LIBRARY        libc.lib 

LIBRARY        euser.lib  // Needed in order to use Symbian services

// and whatever Open C libraries are needed…

</codeblock>

<p>The <filepath>libcrt0.lib</filepath> library is required if the user is

not going to write <codeph>E32Main</codeph> within the application (EXE).

This static library has an implementation of <codeph>E32Main</codeph> within

which it calls the library initialization method followed by calling main

written by the developer. This static library also gets command-line arguments

and passes the same to main. </p>

<p>If the application has <codeph>E32Main()</codeph> as an entry point, there

is no need to link to <filepath>libcrt0.lib</filepath> like in the example

below.  </p>

<codeblock xml:space="preserve">LIBRARY         libc.lib 

LIBRARY         libm.lib libpthread.lib 

LIBRARY         euser.lib</codeblock>

<p><b>Add needed include paths</b></p>

<codeblock xml:space="preserve">SYSTEMINCLUDE   \epoc32\include\stdapis 

</codeblock>

<note>Some of the SSL/cryptography functions need more than the default available

stack. The recommended stack size is 10K. To set the stack size to 10K add

in the MMP file.</note>

<codeblock xml:space="preserve">EPOCSTACKSIZE 0x10000</codeblock>

</conbody></concept>