the Symbian platform) program, the use of the LibpThread library to demonstrate

simple multi-threading and synchronisation. </p>

<section id="GUID-026FD8D6-6C4A-5958-B289-775D4AE1E756-GENID-1-6-1-9-1-1-5-1-3-1-11-1-7-1-2-3"><title>Download</title> <p>Click

<section id="GUID-7E7C4564-B10E-41F9-8A9D-D8A6C5E9C51C-GENID-1-6-1-9-1-1-5-1-3-1-11-1-7-1-2-4"><title>Description</title> <p>The

following sections provide more information about the steps that the example

performs. </p> <p><b> Thread Synchronisation</b> </p> <p>The example creates

three threads named ThreadOne, ThreadTwo and ThreadThree. The threads write

"One", "Two" and "Three" five times in a text file. The text file, located

in <filepath>epoc32\winscw\c\newfile.txt</filepath>, is used as a shared resource

for all three threads. A mutex is used to ensure that first ThreadOne writes

in the file, then ThreadTwo and then ThreadThree. If the mutex is not used

all the threads can simultaneously write in the file. This can be seen by

commenting out <codeph>pthread_mutex_lock</codeph> and <codeph>pthread_mutex_unlock</codeph> in

<section id="GUID-236CB272-E196-4A61-B627-ACFFC4B37AA1"><title>Related APIs</title><p><xref href="GUID-736D5209-CD86-324C-BAB0-7B15C3D1862D.dita"><apiname>pthread_mutex_lock</apiname></xref> </p><p><xref href="GUID-9D7CD10C-F958-3792-8888-B7F39B148302.dita"><apiname>pthread_mutex_unlock</apiname></xref> </p><p><xref href="GUID-3A89E849-DD7F-3381-9469-6CD89892E616.dita"><apiname>pthread_join</apiname></xref></p><p><xref href="GUID-889CB456-6980-3B92-9350-0C6C8C9AC435.dita"><apiname>pthread_mutex_t</apiname></xref></p></section>

<section id="GUID-67A72761-1D92-46D1-B1C9-7455978BDE4E-GENID-1-6-1-9-1-1-5-1-3-1-11-1-7-1-2-6"><title>Build</title> <p>The <xref href="GUID-3100800B-B2F7-50EF-BD4C-3C345ECCB2A5.dita">Symbian build

process</xref> describes how to build this example application. </p> <p>The