<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/> <title>pcsc-lite: winscard_msg_srv.c File Reference</title> <link href="tabs.css" rel="stylesheet" type="text/css"/> <link href="doxygen.css" rel="stylesheet" type="text/css"/> </head> <body> <!-- Generated by Doxygen 1.7.3 --> <div id="top"> <div id="titlearea"> <table cellspacing="0" cellpadding="0"> <tbody> <tr style="height: 56px;"> <td style="padding-left: 0.5em;"> <div id="projectname">pcsc-lite <span id="projectnumber">1.7.2</span></div> </td> </tr> </tbody> </table> </div> <div id="navrow1" class="tabs"> <ul class="tablist"> <li><a href="index.html"><span>Main Page</span></a></li> <li><a href="modules.html"><span>Modules</span></a></li> <li><a href="annotated.html"><span>Data Structures</span></a></li> <li class="current"><a href="files.html"><span>Files</span></a></li> <li><a href="dirs.html"><span>Directories</span></a></li> </ul> </div> <div id="navrow2" class="tabs2"> <ul class="tablist"> <li><a href="files.html"><span>File List</span></a></li> <li><a href="globals.html"><span>Globals</span></a></li> </ul> </div> <div id="nav-path" class="navpath"> <ul> <li class="navelem"><a class="el" href="dir_7a4553ee0c3b13d0e595a5d1659110a6.html">src</a> </li> </ul> </div> </div> <div class="header"> <div class="summary"> <a href="#func-members">Functions</a> | <a href="#var-members">Variables</a> </div> <div class="headertitle"> <h1>winscard_msg_srv.c File Reference</h1> </div> </div> <div class="contents"> <p>client/server communication (on the server side only) <a href="#_details">More...</a></p> <div class="textblock"><code>#include "config.h"</code><br/> <code>#include <fcntl.h></code><br/> <code>#include <unistd.h></code><br/> <code>#include <sys/types.h></code><br/> <code>#include <sys/stat.h></code><br/> <code>#include <sys/socket.h></code><br/> <code>#include <sys/time.h></code><br/> <code>#include <sys/un.h></code><br/> <code>#include <sys/ioctl.h></code><br/> <code>#include <errno.h></code><br/> <code>#include <stdio.h></code><br/> <code>#include <time.h></code><br/> <code>#include <string.h></code><br/> <code>#include "misc.h"</code><br/> <code>#include "<a class="el" href="pcscd_8h_source.html">pcscd.h</a>"</code><br/> <code>#include "winscard.h"</code><br/> <code>#include "debuglog.h"</code><br/> <code>#include "<a class="el" href="winscard__msg_8h_source.html">winscard_msg.h</a>"</code><br/> </div><div class="textblock"><div class="dynheader"> Include dependency graph for winscard_msg_srv.c:</div> <div class="dyncontent"> <div class="center"><img src="winscard__msg__srv_8c__incl.png" border="0" usemap="#winscard__msg__srv_8c" alt=""/></div> <map name="winscard__msg__srv_8c" id="winscard__msg__srv_8c"> <area shape="rect" id="node29" href="misc_8h_source.html" title="misc.h" alt="" coords="1259,83,1320,112"/><area shape="rect" id="node31" href="pcscd_8h.html" title="This keeps a list of defines for pcsc-lite." alt="" coords="1344,83,1411,112"/><area shape="rect" id="node37" href="winscard__msg_8h.html" title="This defines some structures and #defines to be used over the transport layer." alt="" coords="1653,83,1771,112"/></map> </div> </div> <p><a href="winscard__msg__srv_8c_source.html">Go to the source code of this file.</a></p> <table class="memberdecls"> <tr><td colspan="2"><h2><a name="func-members"></a> Functions</h2></td></tr> <tr><td class="memItemLeft" align="right" valign="top">static int </td><td class="memItemRight" valign="bottom"><a class="el" href="winscard__msg__srv_8c.html#a7c421010b7e933a8ed46927e5b9316e8">ProcessCommonChannelRequest</a> (uint32_t *pdwClientID)</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Accepts a Client connection. <a href="#a7c421010b7e933a8ed46927e5b9316e8"></a><br/></td></tr> <tr><td class="memItemLeft" align="right" valign="top">INTERNAL int32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="winscard__msg__srv_8c.html#a061a490f5d2103751eb6b64573b5fb9d">InitializeSocket</a> (void)</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Prepares the communication channel used by the server to talk to the clients. <a href="#a061a490f5d2103751eb6b64573b5fb9d"></a><br/></td></tr> <tr><td class="memItemLeft" align="right" valign="top">INTERNAL int32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="winscard__msg__srv_8c.html#a187cf841551d3e7b97e23d73067ec2d3">ProcessEventsServer</a> (uint32_t *pdwClientID)</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Looks for messages sent by clients. <a href="#a187cf841551d3e7b97e23d73067ec2d3"></a><br/></td></tr> <tr><td colspan="2"><h2><a name="var-members"></a> Variables</h2></td></tr> <tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a840eb2cc63fe5b38ec8edb835bc7c40c"></a><!-- doxytag: member="winscard_msg_srv.c::commonSocket" ref="a840eb2cc63fe5b38ec8edb835bc7c40c" args="" --> static int </td><td class="memItemRight" valign="bottom"><a class="el" href="winscard__msg__srv_8c.html#a840eb2cc63fe5b38ec8edb835bc7c40c">commonSocket</a> = 0</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Socket to a file, used for clients-server comminication. <br/></td></tr> <tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a7c1bcbba3beb47ba1f62a370bd7ec32c"></a><!-- doxytag: member="winscard_msg_srv.c::AraKiri" ref="a7c1bcbba3beb47ba1f62a370bd7ec32c" args="" --> char </td><td class="memItemRight" valign="bottom"><b>AraKiri</b></td></tr> </table> <hr/><a name="_details"></a><h2>Detailed Description</h2> <div class="textblock"><p>client/server communication (on the server side only) </p> <p>A file based socket (<code>commonSocket</code>) is used to send/receive only messages among clients and server.<br/> The messages' data are passed throw a memory mapped <a href="file:">file:</a> <code>sharedSegmentMsg</code>. </p> <p>Definition in file <a class="el" href="winscard__msg__srv_8c_source.html">winscard_msg_srv.c</a>.</p> </div><hr/><h2>Function Documentation</h2> <a class="anchor" id="a061a490f5d2103751eb6b64573b5fb9d"></a><!-- doxytag: member="winscard_msg_srv.c::InitializeSocket" ref="a061a490f5d2103751eb6b64573b5fb9d" args="(void)" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">INTERNAL int32_t InitializeSocket </td> <td>(</td> <td class="paramtype">void </td> <td class="paramname"></td><td>)</td> <td></td> </tr> </table> </div> <div class="memdoc"> <p>Prepares the communication channel used by the server to talk to the clients. </p> <p>This is called by the server to create a socket for local IPC with the clients. The socket is associated to the file <code>PCSCLITE_CSOCK_NAME</code>. Each client will open a connection to this socket.</p> <dl class="return"><dt><b>Returns:</b></dt><dd>Error code. </dd></dl> <dl><dt><b>Return values:</b></dt><dd> <table class="retval"> <tr><td class="paramname">0</td><td>Success </td></tr> <tr><td class="paramname">-1</td><td>Can not create the socket. </td></tr> <tr><td class="paramname">-1</td><td>Can not bind the socket to the file <code>PCSCLITE_CSOCK_NAME</code>. </td></tr> <tr><td class="paramname">-1</td><td>Can not put the socket in listen mode. </td></tr> </table> </dd> </dl> <p>Definition at line <a class="el" href="winscard__msg__srv_8c_source.html#l00098">98</a> of file <a class="el" href="winscard__msg__srv_8c_source.html">winscard_msg_srv.c</a>.</p> <p>References <a class="el" href="winscard__msg__srv_8c_source.html#l00049">commonSocket</a>.</p> </div> </div> <a class="anchor" id="a7c421010b7e933a8ed46927e5b9316e8"></a><!-- doxytag: member="winscard_msg_srv.c::ProcessCommonChannelRequest" ref="a7c421010b7e933a8ed46927e5b9316e8" args="(uint32_t *pdwClientID)" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">static int ProcessCommonChannelRequest </td> <td>(</td> <td class="paramtype">uint32_t * </td> <td class="paramname"><em>pdwClientID</em></td><td>)</td> <td><code> [static]</code></td> </tr> </table> </div> <div class="memdoc"> <p>Accepts a Client connection. </p> <p>Called by <code><a class="el" href="winscard__msg__srv_8c.html#a187cf841551d3e7b97e23d73067ec2d3" title="Looks for messages sent by clients.">ProcessEventsServer()</a></code>.</p> <dl><dt><b>Parameters:</b></dt><dd> <table class="params"> <tr><td class="paramdir">[out]</td><td class="paramname">pdwClientID</td><td>Connection ID used to reference the Client.</td></tr> </table> </dd> </dl> <dl class="return"><dt><b>Returns:</b></dt><dd>Error code. </dd></dl> <dl><dt><b>Return values:</b></dt><dd> <table class="retval"> <tr><td class="paramname">0</td><td>Success. </td></tr> <tr><td class="paramname">-1</td><td>Can not establish the connection. </td></tr> </table> </dd> </dl> <p>Definition at line <a class="el" href="winscard__msg__srv_8c_source.html#l00063">63</a> of file <a class="el" href="winscard__msg__srv_8c_source.html">winscard_msg_srv.c</a>.</p> <p>References <a class="el" href="winscard__msg__srv_8c_source.html#l00049">commonSocket</a>.</p> <p>Referenced by <a class="el" href="winscard__msg__srv_8c_source.html#l00156">ProcessEventsServer()</a>.</p> </div> </div> <a class="anchor" id="a187cf841551d3e7b97e23d73067ec2d3"></a><!-- doxytag: member="winscard_msg_srv.c::ProcessEventsServer" ref="a187cf841551d3e7b97e23d73067ec2d3" args="(uint32_t *pdwClientID)" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">INTERNAL int32_t ProcessEventsServer </td> <td>(</td> <td class="paramtype">uint32_t * </td> <td class="paramname"><em>pdwClientID</em></td><td>)</td> <td></td> </tr> </table> </div> <div class="memdoc"> <p>Looks for messages sent by clients. </p> <p>This is called by the Server's function <code><a class="el" href="pcscdaemon_8c.html#aa4c7ad16505a34733683cf8c08241783" title="The Server's Message Queue Listener function.">SVCServiceRunLoop()</a></code>.</p> <dl><dt><b>Parameters:</b></dt><dd> <table class="params"> <tr><td class="paramdir">[out]</td><td class="paramname">pdwClientID</td><td>Connection ID used to reference the Client.</td></tr> </table> </dd> </dl> <dl class="return"><dt><b>Returns:</b></dt><dd>Error code. </dd></dl> <dl><dt><b>Return values:</b></dt><dd> <table class="retval"> <tr><td class="paramname">0</td><td>Success. </td></tr> <tr><td class="paramname">-1</td><td>Error accessing the communication channel. </td></tr> <tr><td class="paramname">-2</td><td>EINTR </td></tr> <tr><td class="paramname">2</td><td>Timeout. </td></tr> </table> </dd> </dl> <p>Definition at line <a class="el" href="winscard__msg__srv_8c_source.html#l00156">156</a> of file <a class="el" href="winscard__msg__srv_8c_source.html">winscard_msg_srv.c</a>.</p> <p>References <a class="el" href="winscard__msg__srv_8c_source.html#l00049">commonSocket</a>, and <a class="el" href="winscard__msg__srv_8c_source.html#l00063">ProcessCommonChannelRequest()</a>.</p> <p>Referenced by <a class="el" href="pcscdaemon_8c_source.html#l00079">SVCServiceRunLoop()</a>.</p> <p><div class="dynheader"> Here is the call graph for this function:</div> <div class="dyncontent"> <div class="center"><img src="winscard__msg__srv_8c_a187cf841551d3e7b97e23d73067ec2d3_cgraph.png" border="0" usemap="#winscard__msg__srv_8c_a187cf841551d3e7b97e23d73067ec2d3_cgraph" alt=""/></div> <map name="winscard__msg__srv_8c_a187cf841551d3e7b97e23d73067ec2d3_cgraph" id="winscard__msg__srv_8c_a187cf841551d3e7b97e23d73067ec2d3_cgraph"> <area shape="rect" id="node3" href="winscard__msg__srv_8c.html#a7c421010b7e933a8ed46927e5b9316e8" title="Accepts a Client connection." alt="" coords="204,5,423,35"/></map> </div> </p> </div> </div> </div> <hr class="footer"/><address class="footer"><small>Generated on Thu Mar 31 2011 for pcsc-lite by  <a href="http://www.doxygen.org/index.html"> <img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.7.3 </small></address> </body> </html>