Symbian3/SDK/Source/GUID-9D278187-8B5E-581D-9869-EE8861048F93.dita
changeset 2 ebc84c812384
parent 0 89d6a7a84779
--- a/Symbian3/SDK/Source/GUID-9D278187-8B5E-581D-9869-EE8861048F93.dita	Fri Jan 22 18:26:19 2010 +0000
+++ b/Symbian3/SDK/Source/GUID-9D278187-8B5E-581D-9869-EE8861048F93.dita	Thu Mar 11 15:24:26 2010 +0000
@@ -19,16 +19,16 @@
 ascertain the address within the DLL of the functions or variables. </p> <p>Alternatively
 a program can dynamically load a DLL into memory during execution, locate
 the address of a symbol, use it and then unload the DLL. Traditionally and
-for greater memory efficiency, Symbian platform links by ordinal, whereas
-Unix-like operating systems link by name. The following sections provide example
-code to illustrate how the DLL loader works with each operating system. </p><p>The
-Symbian platform v9.3 kernel supports all functionalities of P.I.P.S. libraries
-- referred to as "P.I.P.S.- ready". Pre v9.3 the kernel only supports the
-Symbian platform- standard ordinal lookup in DLLs; it does not support symbolic
-lookup. Thus the function <codeph>dlsym()</codeph> cannot be used with a symbolic
-name. To overcome this restriction, pass the function's ordinal number as
-symbol parameter refer the library's list of exports (the DEF file) for the
-function's ordinal number. For example, instead of: <codeph>dlsym(&amp;handle,
+for greater memory efficiency, the Symbian platform links by
+ordinal, whereas Unix-like operating systems link by name. The following sections
+provide example code to illustrate how the DLL loader works with each operating
+system. </p><p>The Symbian platform v9.3 kernel supports all functionalities
+of P.I.P.S. libraries - referred to as "P.I.P.S.- ready". Pre v9.3 the kernel
+only supports the Symbian platform- standard ordinal lookup in DLLs; it does
+not support symbolic lookup. Thus the function <codeph>dlsym()</codeph> cannot
+be used with a symbolic name. To overcome this restriction, pass the function's
+ordinal number as symbol parameter refer the library's list of exports (the
+DEF file) for the function's ordinal number. For example, instead of: <codeph>dlsym(&amp;handle,
 "foo")</codeph> use <codeph>dlsym (&amp;handle, "3")</codeph> where the function <codeph>foo()</codeph> has
 ordinal 3.</p> </section>
 <section id="GUID-CCE3F3DC-307A-41F2-BAB4-523834C12E93"><title>Using shared
@@ -80,10 +80,11 @@
     {
     printf("Result is : %d\n", a + b);
     }</codeblock></section>
-<section id="GUID-7C649A95-3F73-454B-AAD4-80889D6B34E3"><title>DLLs on Symbian
-platform(prior to v9.3)</title><p>Symbian platform programs uses the function
-or variable's ordinal position within a DLL to link with DLLs. For example,
-implementing a shared DLL on Symbian platform could look like this:</p><codeblock xml:space="preserve">EXPORT_C void printSum(int a, int b)
+<section id="GUID-7C649A95-3F73-454B-AAD4-80889D6B34E3"><title>DLLs on the
+Symbian platform(prior to v9.3)</title><p>Symbian platform programs uses the
+function or variable's ordinal position within a DLL to link with DLLs. For
+example, implementing a shared DLL on the Symbian platform could look like
+this:</p><codeblock xml:space="preserve">EXPORT_C void printSum(int a, int b)
     {
     printf("Result is : %d\n", a + b);
     }</codeblock><p>Compiling this will generate a <filepath>.def</filepath> file,
@@ -138,11 +139,11 @@
 mode parameter in the example, it will behave just as <codeph>RTLD_NOW</codeph>.
 Also note that there is no facility to call any library constructor and destructor
 functions using <codeph>__attribute((constructor))</codeph> or <codeph>__attribute((destructor))</codeph>. </p></section>
-<section id="GUID-DEF804DF-CECC-4739-9ACD-24F46A945F6E"><title>DLLs on Symbian
-platform (v9.3 onwards)</title><p>P.I.P.S. provides APIs from libdl to support
-dynamic lookup by name, which is used in Unix-like platforms, instead of the
-native Symbian platform lookup by ordinal mechanism. Lookup by name is possible
-thanks to the new libdl, which in turn uses the existing <ph>RLibrary</ph> functions
+<section id="GUID-DEF804DF-CECC-4739-9ACD-24F46A945F6E"><title>DLLs on the
+Symbian platform (v9.3 onwards)</title><p>P.I.P.S. provides APIs from libdl
+to support dynamic lookup by name, which is used in Unix-like platforms, instead
+of the native Symbian platform lookup by ordinal mechanism. Lookup by name
+is possible thanks to the new libdl, which in turn uses the existing <ph>RLibrary</ph> functions
 to load and unload DLLs. </p><p>A symbol name lookup version of the dlsym()
 function is provided, similar to UNIX®, which does not need any special treatment
 (the example shown in the <b>Using Shared libraries in a Unix-like environment</b> section