Symbian3/SDK/Source/GUID-89C5B56D-0846-4D32-94E5-CEF8BFA47D4E.dita
author Dominic Pinkman <dominic.pinkman@nokia.com>
Fri, 11 Jun 2010 12:39:03 +0100
changeset 8 ae94777fff8f
parent 7 51a74ef9ed63
child 13 48780e181b38
permissions -rw-r--r--
Week 23 contribution of SDK documentation content. See release notes for details. Fixes bugs Bug 2714, Bug 462.

<?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-10-1-11-1-1-5-1-3-1-10-1-3-3">
<step id="GUID-9A69E5AD-E938-4092-A8C2-CB65C37C8962-GENID-1-10-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-10-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>