Symbian3/Examples/guid-6013a680-57f9-415b-8851-c4fa63356636/sigusr1_8c-source.html
Week 12 contribution of SDK documentation_content. See release notes for details. Fixes Bug 1892, Bug 1522, Bug 1520, Bug 394, Bug 1319, Bug 344, Bug 1897
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
<title>TB10.1 Example Applications: examples/PIPS/posixsignals/asyncSignal/src/sigusr1.c Source File</title>
<link href="doxygen.css" rel="stylesheet" type="text/css">
<link href="tabs.css" rel="stylesheet" type="text/css">
</head><body>
<!-- Generated by Doxygen 1.5.3 -->
<h1>examples/PIPS/posixsignals/asyncSignal/src/sigusr1.c</h1><div class="fragment"><pre class="fragment"><a name="l00001"></a>00001 <span class="comment">// sigusr1.c</span>
<a name="l00002"></a>00002 <span class="comment">//</span>
<a name="l00003"></a>00003 <span class="comment">// Copyright (c) 2010 Nokia Corporation and/or its subsidiary(-ies).</span>
<a name="l00004"></a>00004 <span class="comment">// All rights reserved.</span>
<a name="l00005"></a>00005 <span class="comment">// This component and the accompanying materials are made available</span>
<a name="l00006"></a>00006 <span class="comment">// under the terms of "Eclipse Public License v1.0"</span>
<a name="l00007"></a>00007 <span class="comment">// which accompanies this distribution, and is available</span>
<a name="l00008"></a>00008 <span class="comment">// at the URL "http://www.eclipse.org/legal/epl-v10.html".</span>
<a name="l00009"></a>00009 <span class="comment">//</span>
<a name="l00010"></a>00010 <span class="comment">// Initial Contributors:</span>
<a name="l00011"></a>00011 <span class="comment">// Nokia Corporation - initial contribution.</span>
<a name="l00012"></a>00012 <span class="comment">//</span>
<a name="l00013"></a>00013 <span class="comment">// Contributors:</span>
<a name="l00014"></a>00014 <span class="comment">//</span>
<a name="l00015"></a>00015 <span class="comment">// Description:This example demonstrates asynchronous signal handling.</span>
<a name="l00016"></a>00016 <span class="comment">//</span>
<a name="l00017"></a>00017
<a name="l00018"></a>00018
<a name="l00019"></a>00019 <span class="preprocessor">#include <stdio.h></span>
<a name="l00020"></a>00020 <span class="preprocessor">#include <stdlib.h></span>
<a name="l00021"></a>00021 <span class="preprocessor">#include <signal.h></span> <span class="comment">//The header for signal functionality.</span>
<a name="l00022"></a>00022 <span class="preprocessor">#include <unistd.h></span> <span class="comment">//The header used for getpid().</span>
<a name="l00023"></a>00023 <span class="preprocessor">#include <e32def.h></span>
<a name="l00024"></a>00024 <span class="preprocessor">#include <spawn.h></span>
<a name="l00025"></a>00025
<a name="l00026"></a>00026 <span class="keywordtype">int</span> gch; <span class="comment">// The variable holding a character value, input by the user.</span>
<a name="l00027"></a>00027 FILE *gfp = NULL; <span class="comment">// The file descriptor variable holding pointer to asyncFile.txt.</span>
<a name="l00028"></a>00028 pid_t chldProcsID; <span class="comment">// The variable for holding the sigusr2 PID.</span>
<a name="l00029"></a>00029 <span class="keywordtype">int</span> gVal = TRUE; <span class="comment">// Variable used as a boolean value.</span>
<a name="l00033"></a>00033 <span class="comment"></span><span class="keywordtype">void</span> SIGUSR1_handler(<span class="keywordtype">int</span> signum)
<a name="l00034"></a>00034 {
<a name="l00035"></a>00035 <span class="keywordtype">int</span> ret;
<a name="l00036"></a>00036 <span class="keyword">const</span> <span class="keywordtype">int</span> delay1 = 1; <span class="comment">//Time delay of 1 sec.</span>
<a name="l00037"></a>00037 <span class="keywordflow">if</span> (signum == SIGUSR1)
<a name="l00038"></a>00038 {
<a name="l00039"></a>00039 gVal = FALSE;
<a name="l00040"></a>00040 printf(<span class="stringliteral">"\nReceived the SIGUSR1 signal from the sigusr2 process\n"</span>);
<a name="l00041"></a>00041 printf(<span class="stringliteral">"Starting to read from the file\n"</span>);
<a name="l00042"></a>00042 <span class="keywordflow">while</span>((gch = fgetc(gfp))!=<span class="charliteral">'\n'</span>)
<a name="l00043"></a>00043 {
<a name="l00044"></a>00044 putchar(gch); <span class="comment">//Writing to stdout.</span>
<a name="l00045"></a>00045 }
<a name="l00046"></a>00046 printf(<span class="stringliteral">"\n"</span>);
<a name="l00047"></a>00047 sleep (delay1);
<a name="l00048"></a>00048
<a name="l00049"></a>00049 <span class="comment">//Sending SIGUSR2 signal to sigusr2 process once the file content is written to the console.</span>
<a name="l00050"></a>00050 printf(<span class="stringliteral">"Reading from the file now completed, sending SIGUSR2 to the sigusr2 process\n"</span>);
<a name="l00051"></a>00051
<a name="l00052"></a>00052 <span class="comment">//Raising SIGUSR2 signal using kill command.</span>
<a name="l00053"></a>00053 ret = kill(chldProcsID,SIGUSR2);
<a name="l00054"></a>00054 <span class="keywordflow">if</span>(ret)
<a name="l00055"></a>00055 {
<a name="l00056"></a>00056 printf(<span class="stringliteral">"kill() failed to send signal, errno=%d\n"</span>,errno);
<a name="l00057"></a>00057 }
<a name="l00058"></a>00058 }
<a name="l00059"></a>00059 }
<a name="l00060"></a>00060
<a name="l00074"></a>00074 <span class="keywordtype">int</span> main()
<a name="l00075"></a>00075 {
<a name="l00076"></a>00076 <span class="keywordtype">int</span> ret;
<a name="l00077"></a>00077 <span class="keyword">const</span> <span class="keywordtype">int</span> delay = 1; <span class="comment">//Delay of 1 sec provided to wait for signal.</span>
<a name="l00078"></a>00078 <span class="keyword">const</span> <span class="keywordtype">int</span> size = 50; <span class="comment">//No.of characters allowed in the filename.</span>
<a name="l00079"></a>00079 <span class="keyword">const</span> <span class="keywordtype">int</span> index = 3; <span class="comment">//No.of elements in the array.</span>
<a name="l00080"></a>00080
<a name="l00081"></a>00081 <span class="keywordtype">char</span> *filename = <span class="stringliteral">"C:\\asyncFile.txt"</span> ; <span class="comment">//Filename of the file that holds names input by the user.</span>
<a name="l00082"></a>00082 <span class="keywordtype">char</span> *childProcess = <span class="stringliteral">"Z:\\sys\\bin\\sigusr2.exe"</span>; <span class="comment">//Filename of sigusr2 process.</span>
<a name="l00083"></a>00083 <span class="keywordtype">char</span> **argv = (<span class="keywordtype">char</span>**)malloc(index*<span class="keyword">sizeof</span>(<span class="keywordtype">char</span>*)); <span class="comment">//Variable holding values to be passed to the sigusr2 process.</span>
<a name="l00084"></a>00084 argv[0] = (<span class="keywordtype">char</span>*)malloc(size*<span class="keyword">sizeof</span>(<span class="keywordtype">char</span>));
<a name="l00085"></a>00085 argv[1] = (<span class="keywordtype">char</span>*)malloc(index*<span class="keyword">sizeof</span>(<span class="keywordtype">char</span>));
<a name="l00086"></a>00086 argv[2] = NULL;
<a name="l00087"></a>00087
<a name="l00088"></a>00088
<a name="l00089"></a>00089 strcpy(argv[0], <span class="stringliteral">"z:\\sys\\bin\\sigusr2.exe"</span>); <span class="comment">//argv[0] holding name of the sigusr2 process.</span>
<a name="l00090"></a>00090 sprintf(argv[1],<span class="stringliteral">"%d"</span>,getpid()); <span class="comment">//argv[1] holding PID of sigusr1 process.</span>
<a name="l00091"></a>00091
<a name="l00092"></a>00092 <span class="comment">//Setup the custom handler for SIGUSR1.</span>
<a name="l00093"></a>00093 signal(SIGUSR1,SIGUSR1_handler);
<a name="l00094"></a>00094
<a name="l00095"></a>00095 printf(<span class="stringliteral">"*****************************************************************\n"</span>);
<a name="l00096"></a>00096 printf(<span class="stringliteral">"* Welcome to the asynchronous signal handling demonstration *\n"</span>);
<a name="l00097"></a>00097 printf(<span class="stringliteral">"*****************************************************************\n"</span>);
<a name="l00098"></a>00098
<a name="l00099"></a>00099 printf(<span class="stringliteral">"* This example demonstrates asynchronous signal handling using SIGUSR1 and SIGUSR2 signals.\n"</span>);
<a name="l00100"></a>00100 printf(<span class="stringliteral">"* The example consists of two processes, the sigusr1 process and the sigusr2 process.\n"</span>);
<a name="l00101"></a>00101 printf(<span class="stringliteral">"* The sigusr1 process handles the SIGUSR1 signal and sends a SIGUSR2 signal to the sigusr2 process.\n"</span>);
<a name="l00102"></a>00102 printf(<span class="stringliteral">"* The sigusr2 process handles the SIGUSR2 signal and sends a SIGUSR1 signal to the sigusr1 process.\n"</span>);
<a name="l00103"></a>00103 printf(<span class="stringliteral">"* The sigusr1 process opens a file and writes some text in it.\n"</span>);
<a name="l00104"></a>00104 printf(<span class="stringliteral">"* The sigusr1 process then spawns the sigusr2 process and waits until SIGUSR1 is received from it.\n"</span>);
<a name="l00105"></a>00105 printf(<span class="stringliteral">"* Once the sigusr1 process obtains a SIGUSR1 signal, it starts reading from the file and displays its\ncontent on the console.\n"</span>);
<a name="l00106"></a>00106 printf(<span class="stringliteral">"* When all the file content is written, the sigusr1 process sends a SIGUSR2 signal to the sigusr2 process and prepares to exit.\n"</span>);
<a name="l00107"></a>00107 printf(<span class="stringliteral">"* On other side the sigusr2 process keeps waiting for the SIGUSR2 signal from the sigusr1 process.\n"</span>);
<a name="l00108"></a>00108 printf(<span class="stringliteral">"* On reception of the SIGUSR2 signal, the sigusr2 process prepares to exit.\n"</span>);
<a name="l00109"></a>00109
<a name="l00110"></a>00110 printf(<span class="stringliteral">"\nPress the Enter key to continue\n"</span>);
<a name="l00111"></a>00111 getchar();
<a name="l00112"></a>00112
<a name="l00113"></a>00113 printf(<span class="stringliteral">"****************** In the sigusr1 process ********************\n"</span>);
<a name="l00114"></a>00114
<a name="l00115"></a>00115
<a name="l00116"></a>00116 printf(<span class="stringliteral">"\nOpening a file for read and write\n"</span>);
<a name="l00117"></a>00117 <span class="keywordflow">if</span>((gfp = fopen(filename,<span class="stringliteral">"w+"</span>))!=NULL)
<a name="l00118"></a>00118 {
<a name="l00119"></a>00119 printf(<span class="stringliteral">"Successfully opened the file\n"</span>);
<a name="l00120"></a>00120 fprintf(gfp, <span class="stringliteral">"%s"</span>, <span class="stringliteral">"An asynchronous signal handling example using the SIGUSR1 and SIGUSR2 signals\n"</span>);
<a name="l00121"></a>00121 rewind(gfp);
<a name="l00122"></a>00122 printf(<span class="stringliteral">"Writing to the file completed, preparing to start reading from the file\n"</span>);
<a name="l00123"></a>00123
<a name="l00124"></a>00124 printf(<span class="stringliteral">"Press the Enter key to spawn the sigusr2 process\n"</span>);
<a name="l00125"></a>00125 getchar();
<a name="l00126"></a>00126
<a name="l00127"></a>00127 <span class="comment">//Spawning sigusr2 process.</span>
<a name="l00128"></a>00128 ret = posix_spawn(&chldProcsID,childProcess,NULL,NULL,argv,(<span class="keywordtype">char</span>**)NULL);
<a name="l00129"></a>00129 <span class="keywordflow">if</span>(ret != 0)
<a name="l00130"></a>00130 {
<a name="l00131"></a>00131 printf(<span class="stringliteral">"\n*** failure posix_spawn ***\n"</span>);
<a name="l00132"></a>00132 <span class="keywordflow">return</span> EXIT_FAILURE;
<a name="l00133"></a>00133 }
<a name="l00134"></a>00134 }
<a name="l00135"></a>00135
<a name="l00136"></a>00136 printf(<span class="stringliteral">"Waiting until SIGUSR1 is obtained from the sigusr2 process"</span>);
<a name="l00137"></a>00137 <span class="keywordflow">while</span>(gVal)
<a name="l00138"></a>00138 {
<a name="l00139"></a>00139 printf(<span class="stringliteral">"."</span>);
<a name="l00140"></a>00140 sleep(delay);
<a name="l00141"></a>00141 }
<a name="l00142"></a>00142
<a name="l00143"></a>00143 <span class="keywordflow">if</span>(!fclose(gfp))
<a name="l00144"></a>00144 {
<a name="l00145"></a>00145 <span class="keyword">remove</span>(filename);
<a name="l00146"></a>00146 gfp=NULL;
<a name="l00147"></a>00147 printf(<span class="stringliteral">"The file was closed successfully.\n"</span>);
<a name="l00148"></a>00148 }
<a name="l00149"></a>00149 <span class="keywordflow">else</span>
<a name="l00150"></a>00150 {
<a name="l00151"></a>00151 printf(<span class="stringliteral">"File close failed.\n"</span>);
<a name="l00152"></a>00152 }
<a name="l00153"></a>00153
<a name="l00154"></a>00154 printf(<span class="stringliteral">"Press 'e'+Enter to exit from the sigusr1 process\n"</span>);
<a name="l00155"></a>00155
<a name="l00156"></a>00156 <span class="keywordflow">while</span>((gch=getchar())!= <span class="charliteral">'e'</span>)
<a name="l00157"></a>00157 {
<a name="l00158"></a>00158 <span class="keywordflow">if</span>(gch == <span class="charliteral">'\n'</span>)
<a name="l00159"></a>00159 <span class="keywordflow">continue</span>;
<a name="l00160"></a>00160 <span class="keywordflow">else</span>
<a name="l00161"></a>00161 printf(<span class="stringliteral">"The wrong option was selected, please try again!!!\n"</span>);
<a name="l00162"></a>00162 }
<a name="l00163"></a>00163 <span class="keywordflow">return</span> EXIT_SUCCESS;
<a name="l00164"></a>00164 }
</pre></div><hr size="1"><address style="text-align: right;"><small>Generated on Thu Jan 21 10:33:00 2010 for TB10.1 Example Applications by
<a href="http://www.doxygen.org/index.html">
<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.3 </small></address>
</body>
</html>