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

  PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">

<task id="GUID-89C5B56D-0846-4D32-94E5-CEF8BFA47D4E" xml:lang="en"><title>Migrating

from C Standard Library (ESTLIB) to P.I.P.S.</title><shortdesc>If you are using ESTLIB, it is recommended that you migrate to

P.I.P.S. available from Symbian^1, as P.I.P.S. is much more POSIX compliant

and feature-rich.</shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody>

<prereq id="GUID-8A3B8F03-A4E9-41C9-A600-C038D79FCB90">       <p>P.I.P.S.

is supported from Symbian^1 onwards on ROM. ESTLIB applications

can be ported to use P.I.P.S., by keeping the base source as it is while making

changes to the MMP files and rebuilding the code.</p>     </prereq>

<context id="GUID-963EA55A-3033-40AC-83AE-00687F7F185E">       <p>To migrate

from C Standard Library (ESTLIB) to P.I.P.S., perform the following steps:</p> 

   </context>

<steps id="GUID-4DD07DEC-6017-4237-BE46-1D69E5FBD744-GENID-1-8-1-11-1-1-5-1-3-1-10-1-3-3">

<step id="GUID-9A69E5AD-E938-4092-A8C2-CB65C37C8962-GENID-1-8-1-11-1-1-5-1-3-1-10-1-3-3-1"><cmd/>

<info><p>Replace the <codeph>LIBRARY</codeph> entry in the <filepath>.MMP</filepath> file

from <filepath>estlib.lib</filepath> to <filepath>libc.lib libm.lib libpthread.lib</filepath>.</p></info>

</step>

<step id="GUID-BB644CB0-A911-4C80-A28D-361319D15580"><cmd/>

<info><p>Replace the <codeph>LIBRARY</codeph> entry in the <filepath>.MMP</filepath> file

from <filepath>ecrt0.lib</filepath> to <filepath>libcrt0.lib</filepath>.</p></info>

</step>

<step id="GUID-9A69E5AD-E938-4092-A8C2-CB65C37C8962-GENID-1-8-1-11-1-1-5-1-3-1-10-1-3-3-3"><cmd/>

<info><p>Replace the <codeph>SYSTEMINCLUDE</codeph> path from <filepath>\epoc32\include\libc</filepath> to <filepath>\epoc32\include\stdapis</filepath>.</p></info>

<stepresult><p><b>Important</b>: If any non-POSIX worked around code (written

to satisfy POSIX-deviated ESTLIB return codes) is present in your existing

application, you will also need to modify it to make them POSIX complaint.</p></stepresult>

</step>

</steps>

<postreq id="GUID-3BF4A7A3-6876-4987-8F17-B8A7BDA639D4"><p><b>Note</b>: For

more information about using P.I.P.S. on Symbian platform, see <xref href="GUID-D79380CF-22B5-5865-9366-44118E8ECA2E.dita">Open

Environment Core (P.I.P.S.)</xref>. </p></postreq>

</taskbody></task>