<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://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"/> <meta http-equiv="X-UA-Compatible" content="IE=9"/> <meta name="generator" content="Doxygen 1.8.15"/> <meta name="viewport" content="width=device-width, initial-scale=1"/> <title>pcsc-lite: eventhandler.h Source File</title> <link href="tabs.css" rel="stylesheet" type="text/css"/> <script type="text/javascript" src="jquery.js"></script> <script type="text/javascript" src="dynsections.js"></script> <link href="doxygen.css" rel="stylesheet" type="text/css" /> </head> <body> <div id="top"><!-- do not remove this div, it is closed by doxygen! --> <div id="titlearea"> <table cellspacing="0" cellpadding="0"> <tbody> <tr style="height: 56px;"> <td id="projectalign" style="padding-left: 0.5em;"> <div id="projectname">pcsc-lite  <span id="projectnumber">1.8.26</span> </div> </td> </tr> </tbody> </table> </div> <!-- end header part --> <!-- Generated by Doxygen 1.8.15 --> <script type="text/javascript" src="menudata.js"></script> <script type="text/javascript" src="menu.js"></script> <script type="text/javascript"> /* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&dn=gpl-2.0.txt GPL-v2 */ $(function() { initMenu('',false,false,'search.php','Search'); }); /* @license-end */</script> <div id="main-nav"></div> <div id="nav-path" class="navpath"> <ul> <li class="navelem"><a class="el" href="dir_68267d1309a1af8e8297ef4c3efbcdba.html">src</a></li> </ul> </div> </div><!-- top --> <div class="header"> <div class="headertitle"> <div class="title">eventhandler.h</div> </div> </div><!--header--> <div class="contents"> <a href="eventhandler_8h.html">Go to the documentation of this file.</a><div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno"> 1</span> <span class="comment">/*</span></div><div class="line"><a name="l00002"></a><span class="lineno"> 2</span> <span class="comment"> * MUSCLE SmartCard Development ( https://pcsclite.apdu.fr/ )</span></div><div class="line"><a name="l00003"></a><span class="lineno"> 3</span> <span class="comment"> *</span></div><div class="line"><a name="l00004"></a><span class="lineno"> 4</span> <span class="comment"> * Copyright (C) 1999-2002</span></div><div class="line"><a name="l00005"></a><span class="lineno"> 5</span> <span class="comment"> * David Corcoran <corcoran@musclecard.com></span></div><div class="line"><a name="l00006"></a><span class="lineno"> 6</span> <span class="comment"> * Copyright (C) 2002-2010</span></div><div class="line"><a name="l00007"></a><span class="lineno"> 7</span> <span class="comment"> * Ludovic Rousseau <ludovic.rousseau@free.fr></span></div><div class="line"><a name="l00008"></a><span class="lineno"> 8</span> <span class="comment"> *</span></div><div class="line"><a name="l00009"></a><span class="lineno"> 9</span> <span class="comment">Redistribution and use in source and binary forms, with or without</span></div><div class="line"><a name="l00010"></a><span class="lineno"> 10</span> <span class="comment">modification, are permitted provided that the following conditions</span></div><div class="line"><a name="l00011"></a><span class="lineno"> 11</span> <span class="comment">are met:</span></div><div class="line"><a name="l00012"></a><span class="lineno"> 12</span> <span class="comment"></span></div><div class="line"><a name="l00013"></a><span class="lineno"> 13</span> <span class="comment">1. Redistributions of source code must retain the above copyright</span></div><div class="line"><a name="l00014"></a><span class="lineno"> 14</span> <span class="comment"> notice, this list of conditions and the following disclaimer.</span></div><div class="line"><a name="l00015"></a><span class="lineno"> 15</span> <span class="comment">2. Redistributions in binary form must reproduce the above copyright</span></div><div class="line"><a name="l00016"></a><span class="lineno"> 16</span> <span class="comment"> notice, this list of conditions and the following disclaimer in the</span></div><div class="line"><a name="l00017"></a><span class="lineno"> 17</span> <span class="comment"> documentation and/or other materials provided with the distribution.</span></div><div class="line"><a name="l00018"></a><span class="lineno"> 18</span> <span class="comment">3. The name of the author may not be used to endorse or promote products</span></div><div class="line"><a name="l00019"></a><span class="lineno"> 19</span> <span class="comment"> derived from this software without specific prior written permission.</span></div><div class="line"><a name="l00020"></a><span class="lineno"> 20</span> <span class="comment"></span></div><div class="line"><a name="l00021"></a><span class="lineno"> 21</span> <span class="comment">THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR</span></div><div class="line"><a name="l00022"></a><span class="lineno"> 22</span> <span class="comment">IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES</span></div><div class="line"><a name="l00023"></a><span class="lineno"> 23</span> <span class="comment">OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.</span></div><div class="line"><a name="l00024"></a><span class="lineno"> 24</span> <span class="comment">IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,</span></div><div class="line"><a name="l00025"></a><span class="lineno"> 25</span> <span class="comment">INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT</span></div><div class="line"><a name="l00026"></a><span class="lineno"> 26</span> <span class="comment">NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,</span></div><div class="line"><a name="l00027"></a><span class="lineno"> 27</span> <span class="comment">DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY</span></div><div class="line"><a name="l00028"></a><span class="lineno"> 28</span> <span class="comment">THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT</span></div><div class="line"><a name="l00029"></a><span class="lineno"> 29</span> <span class="comment">(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF</span></div><div class="line"><a name="l00030"></a><span class="lineno"> 30</span> <span class="comment">THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.</span></div><div class="line"><a name="l00031"></a><span class="lineno"> 31</span> <span class="comment"> */</span></div><div class="line"><a name="l00032"></a><span class="lineno"> 32</span> </div><div class="line"><a name="l00039"></a><span class="lineno"> 39</span> <span class="preprocessor">#ifndef __eventhandler_h__</span></div><div class="line"><a name="l00040"></a><span class="lineno"> 40</span> <span class="preprocessor">#define __eventhandler_h__</span></div><div class="line"><a name="l00041"></a><span class="lineno"> 41</span> </div><div class="line"><a name="l00042"></a><span class="lineno"> 42</span> <span class="preprocessor">#include <stdint.h></span></div><div class="line"><a name="l00043"></a><span class="lineno"> 43</span> </div><div class="line"><a name="l00048"></a><span class="lineno"><a class="line" href="structpubReaderStatesList.html"> 48</a></span>  <span class="keyword">typedef</span> <span class="keyword">struct </span><a class="code" href="structpubReaderStatesList.html">pubReaderStatesList</a></div><div class="line"><a name="l00049"></a><span class="lineno"> 49</span>  {</div><div class="line"><a name="l00050"></a><span class="lineno"><a class="line" href="structpubReaderStatesList.html#a2911a61e0a38e8245a963debf872bfb9"> 50</a></span>  <span class="keywordtype">char</span> <a class="code" href="structpubReaderStatesList.html#a2911a61e0a38e8245a963debf872bfb9">readerName</a>[MAX_READERNAME]; </div><div class="line"><a name="l00051"></a><span class="lineno"><a class="line" href="structpubReaderStatesList.html#a97623f9f724a2a86db3e755badd0cf21"> 51</a></span>  uint32_t <a class="code" href="structpubReaderStatesList.html#a97623f9f724a2a86db3e755badd0cf21">eventCounter</a>; </div><div class="line"><a name="l00052"></a><span class="lineno"><a class="line" href="structpubReaderStatesList.html#ae0bfa9f9998463192d8c18cf86915082"> 52</a></span>  uint32_t <a class="code" href="structpubReaderStatesList.html#ae0bfa9f9998463192d8c18cf86915082">readerState</a>; </div><div class="line"><a name="l00053"></a><span class="lineno"><a class="line" href="structpubReaderStatesList.html#a3466b5e09f39d5857bf6a158a5bb7d30"> 53</a></span>  int32_t <a class="code" href="structpubReaderStatesList.html#a3466b5e09f39d5857bf6a158a5bb7d30">readerSharing</a>; </div><div class="line"><a name="l00055"></a><span class="lineno"><a class="line" href="structpubReaderStatesList.html#a865f4e34f374b7b24b3a56008f92676f"> 55</a></span>  UCHAR <a class="code" href="structpubReaderStatesList.html#a865f4e34f374b7b24b3a56008f92676f">cardAtr</a>[<a class="code" href="pcsclite_8h.html#a7ac7915ff6f9baefa66886c98bdbb91e">MAX_ATR_SIZE</a>]; </div><div class="line"><a name="l00056"></a><span class="lineno"><a class="line" href="structpubReaderStatesList.html#afe108cdd8d9d06f1294ba235303d59a7"> 56</a></span>  uint32_t <a class="code" href="structpubReaderStatesList.html#afe108cdd8d9d06f1294ba235303d59a7">cardAtrLength</a>; </div><div class="line"><a name="l00057"></a><span class="lineno"><a class="line" href="structpubReaderStatesList.html#a8218d71b0c62a617790e645fca310913"> 57</a></span>  uint32_t <a class="code" href="structpubReaderStatesList.html#a8218d71b0c62a617790e645fca310913">cardProtocol</a>; </div><div class="line"><a name="l00058"></a><span class="lineno"> 58</span>  }</div><div class="line"><a name="l00059"></a><span class="lineno"> 59</span>  <a class="code" href="eventhandler_8h.html#a14acdf20e86897434649f849c17f9ea6">READER_STATE</a>;</div><div class="line"><a name="l00060"></a><span class="lineno"> 60</span> </div><div class="line"><a name="l00061"></a><span class="lineno"> 61</span>  LONG <a class="code" href="eventhandler_8h.html#a37ebfbc3287ee2ea69a60e87fead19e4">EHTryToUnregisterClientForEvent</a>(int32_t filedes);</div><div class="line"><a name="l00062"></a><span class="lineno"> 62</span>  LONG EHRegisterClientForEvent(int32_t filedes);</div><div class="line"><a name="l00063"></a><span class="lineno"> 63</span>  LONG <a class="code" href="eventhandler_8h.html#aa1391089c844599baf0cb4c95f8b0f75">EHUnregisterClientForEvent</a>(int32_t filedes);</div><div class="line"><a name="l00064"></a><span class="lineno"> 64</span>  <span class="keywordtype">void</span> <a class="code" href="eventhandler_8h.html#a50b15153ce76ac2412610ba437df7a2f">EHSignalEventToClients</a>(<span class="keywordtype">void</span>);</div><div class="line"><a name="l00065"></a><span class="lineno"> 65</span>  LONG EHInitializeEventStructures(<span class="keywordtype">void</span>);</div><div class="line"><a name="l00066"></a><span class="lineno"> 66</span>  LONG EHDeinitializeEventStructures(<span class="keywordtype">void</span>);</div><div class="line"><a name="l00067"></a><span class="lineno"> 67</span>  LONG EHSpawnEventHandler(<a class="code" href="structReaderContext.html">READER_CONTEXT</a> *);</div><div class="line"><a name="l00068"></a><span class="lineno"> 68</span>  <span class="keywordtype">void</span> EHDestroyEventHandler(<a class="code" href="structReaderContext.html">READER_CONTEXT</a> *);</div><div class="line"><a name="l00069"></a><span class="lineno"> 69</span> </div><div class="line"><a name="l00071"></a><span class="lineno"><a class="line" href="eventhandler_8h.html#a97a0f3217c43cc5d86b1d92cc73d0f63"> 71</a></span> <span class="preprocessor">#define PCSCLITE_SHARING_LAST_CONTEXT 1</span></div><div class="line"><a name="l00072"></a><span class="lineno"> 72</span> </div><div class="line"><a name="l00073"></a><span class="lineno"><a class="line" href="eventhandler_8h.html#a631be0b7327a8f47f9073dcaacc18f98"> 73</a></span> <span class="preprocessor">#define PCSCLITE_SHARING_NO_CONTEXT 0</span></div><div class="line"><a name="l00074"></a><span class="lineno"> 74</span> </div><div class="line"><a name="l00075"></a><span class="lineno"><a class="line" href="eventhandler_8h.html#a2adc2d505aee5e810d17d0e8127a4543"> 75</a></span> <span class="preprocessor">#define PCSCLITE_SHARING_EXCLUSIVE_CONTEXT -1</span></div><div class="line"><a name="l00076"></a><span class="lineno"> 76</span> </div><div class="line"><a name="l00080"></a><span class="lineno"><a class="line" href="eventhandler_8h.html#a5608a42045886b6486390541b0ace5e5"> 80</a></span> <span class="preprocessor">#define READER_NOT_INITIALIZED (MAX_ATR_SIZE+1)</span></div><div class="line"><a name="l00081"></a><span class="lineno"> 81</span> </div><div class="line"><a name="l00082"></a><span class="lineno"> 82</span> <span class="preprocessor">#endif </span><span class="comment">/* __eventhandler_h__ */</span><span class="preprocessor"></span></div><div class="ttc" id="structpubReaderStatesList_html_afe108cdd8d9d06f1294ba235303d59a7"><div class="ttname"><a href="structpubReaderStatesList.html#afe108cdd8d9d06f1294ba235303d59a7">pubReaderStatesList::cardAtrLength</a></div><div class="ttdeci">uint32_t cardAtrLength</div><div class="ttdoc">ATR length.</div><div class="ttdef"><b>Definition:</b> <a href="eventhandler_8h_source.html#l00056">eventhandler.h:56</a></div></div> <div class="ttc" id="structpubReaderStatesList_html_a2911a61e0a38e8245a963debf872bfb9"><div class="ttname"><a href="structpubReaderStatesList.html#a2911a61e0a38e8245a963debf872bfb9">pubReaderStatesList::readerName</a></div><div class="ttdeci">char readerName[MAX_READERNAME]</div><div class="ttdoc">reader name</div><div class="ttdef"><b>Definition:</b> <a href="eventhandler_8h_source.html#l00050">eventhandler.h:50</a></div></div> <div class="ttc" id="structpubReaderStatesList_html_a3466b5e09f39d5857bf6a158a5bb7d30"><div class="ttname"><a href="structpubReaderStatesList.html#a3466b5e09f39d5857bf6a158a5bb7d30">pubReaderStatesList::readerSharing</a></div><div class="ttdeci">int32_t readerSharing</div><div class="ttdoc">PCSCLITE_SHARING_* sharing status.</div><div class="ttdef"><b>Definition:</b> <a href="eventhandler_8h_source.html#l00053">eventhandler.h:53</a></div></div> <div class="ttc" id="eventhandler_8h_html_a37ebfbc3287ee2ea69a60e87fead19e4"><div class="ttname"><a href="eventhandler_8h.html#a37ebfbc3287ee2ea69a60e87fead19e4">EHTryToUnregisterClientForEvent</a></div><div class="ttdeci">LONG EHTryToUnregisterClientForEvent(int32_t filedes)</div><div class="ttdoc">Try to unregisted a client If no client is found then do not log an error.</div><div class="ttdef"><b>Definition:</b> <a href="eventhandler_8c_source.html#l00083">eventhandler.c:83</a></div></div> <div class="ttc" id="eventhandler_8h_html_aa1391089c844599baf0cb4c95f8b0f75"><div class="ttname"><a href="eventhandler_8h.html#aa1391089c844599baf0cb4c95f8b0f75">EHUnregisterClientForEvent</a></div><div class="ttdeci">LONG EHUnregisterClientForEvent(int32_t filedes)</div><div class="ttdoc">Unregister a client and log an error if the client is not found.</div><div class="ttdef"><b>Definition:</b> <a href="eventhandler_8c_source.html#l00103">eventhandler.c:103</a></div></div> <div class="ttc" id="structpubReaderStatesList_html_a97623f9f724a2a86db3e755badd0cf21"><div class="ttname"><a href="structpubReaderStatesList.html#a97623f9f724a2a86db3e755badd0cf21">pubReaderStatesList::eventCounter</a></div><div class="ttdeci">uint32_t eventCounter</div><div class="ttdoc">number of card events</div><div class="ttdef"><b>Definition:</b> <a href="eventhandler_8h_source.html#l00051">eventhandler.h:51</a></div></div> <div class="ttc" id="eventhandler_8h_html_a50b15153ce76ac2412610ba437df7a2f"><div class="ttname"><a href="eventhandler_8h.html#a50b15153ce76ac2412610ba437df7a2f">EHSignalEventToClients</a></div><div class="ttdeci">void EHSignalEventToClients(void)</div><div class="ttdoc">Sends an asynchronous event to any waiting client.</div><div class="ttdef"><b>Definition:</b> <a href="eventhandler_8c_source.html#l00116">eventhandler.c:116</a></div></div> <div class="ttc" id="eventhandler_8h_html_a14acdf20e86897434649f849c17f9ea6"><div class="ttname"><a href="eventhandler_8h.html#a14acdf20e86897434649f849c17f9ea6">READER_STATE</a></div><div class="ttdeci">struct pubReaderStatesList READER_STATE</div><div class="ttdoc">Define an exported public reader state structure so each application gets instant notification of cha...</div></div> <div class="ttc" id="structpubReaderStatesList_html_a865f4e34f374b7b24b3a56008f92676f"><div class="ttname"><a href="structpubReaderStatesList.html#a865f4e34f374b7b24b3a56008f92676f">pubReaderStatesList::cardAtr</a></div><div class="ttdeci">UCHAR cardAtr[MAX_ATR_SIZE]</div><div class="ttdoc">ATR.</div><div class="ttdef"><b>Definition:</b> <a href="eventhandler_8h_source.html#l00055">eventhandler.h:55</a></div></div> <div class="ttc" id="structpubReaderStatesList_html_a8218d71b0c62a617790e645fca310913"><div class="ttname"><a href="structpubReaderStatesList.html#a8218d71b0c62a617790e645fca310913">pubReaderStatesList::cardProtocol</a></div><div class="ttdeci">uint32_t cardProtocol</div><div class="ttdoc">SCARD_PROTOCOL_* value.</div><div class="ttdef"><b>Definition:</b> <a href="eventhandler_8h_source.html#l00057">eventhandler.h:57</a></div></div> <div class="ttc" id="structpubReaderStatesList_html"><div class="ttname"><a href="structpubReaderStatesList.html">pubReaderStatesList</a></div><div class="ttdoc">Define an exported public reader state structure so each application gets instant notification of cha...</div><div class="ttdef"><b>Definition:</b> <a href="eventhandler_8h_source.html#l00048">eventhandler.h:48</a></div></div> <div class="ttc" id="pcsclite_8h_html_a7ac7915ff6f9baefa66886c98bdbb91e"><div class="ttname"><a href="pcsclite_8h.html#a7ac7915ff6f9baefa66886c98bdbb91e">MAX_ATR_SIZE</a></div><div class="ttdeci">#define MAX_ATR_SIZE</div><div class="ttdoc">Maximum ATR size.</div><div class="ttdef"><b>Definition:</b> <a href="pcsclite_8h_source.html#l00059">pcsclite.h:59</a></div></div> <div class="ttc" id="structpubReaderStatesList_html_ae0bfa9f9998463192d8c18cf86915082"><div class="ttname"><a href="structpubReaderStatesList.html#ae0bfa9f9998463192d8c18cf86915082">pubReaderStatesList::readerState</a></div><div class="ttdeci">uint32_t readerState</div><div class="ttdoc">SCARD_* bit field.</div><div class="ttdef"><b>Definition:</b> <a href="eventhandler_8h_source.html#l00052">eventhandler.h:52</a></div></div> <div class="ttc" id="structReaderContext_html"><div class="ttname"><a href="structReaderContext.html">ReaderContext</a></div><div class="ttdef"><b>Definition:</b> <a href="readerfactory_8h_source.html#l00106">readerfactory.h:106</a></div></div> </div><!-- fragment --></div><!-- contents --> <!-- start footer part --> <hr class="footer"/><address class="footer"><small> Generated on Wed Jan 8 2020 17:42:32 for pcsc-lite by  <a href="http://www.doxygen.org/index.html"> <img class="footer" src="doxygen.png" alt="doxygen"/> </a> 1.8.15 </small></address> </body> </html>