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 task

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

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

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

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

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

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

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

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

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

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

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

    22    </context>

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

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

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

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

    27 </step>

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

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

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

    31 </step>

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

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

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

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

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

    37 </step>

    38 </steps>

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

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

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

    42 </taskbody></task>