PageRenderTime 45ms CodeModel.GetById 17ms RepoModel.GetById 0ms app.codeStats 1ms

/doc/ccode/html/ccn__match_8c.html

http://ccnx-trace-interest.googlecode.com/
HTML | 249 lines | 193 code | 16 blank | 40 comment | 0 complexity | afdfec33797acf0653b9a6deeb9ff488 MD5 | raw file
Possible License(s): LGPL-2.1 
    

  1. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
    2. 

  2. <html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
    3. 

  3. <title>Content-Centric Networking in C: lib/ccn_match.c File Reference</title>
    4. 

  4. <link href="doxygen.css" rel="stylesheet" type="text/css">
    5. 

  5. <link href="tabs.css" rel="stylesheet" type="text/css">
    6. 

  6. </head><body>
    7. 

  7. <!-- Generated by Doxygen 1.5.6 -->
    8. 

  8. <script type="text/javascript">
    9. 

  9. <!--
    10. 

  10. function changeDisplayState (e){
    11. 

  11.   var num=this.id.replace(/[^[0-9]/g,'');
    12. 

  12.   var button=this.firstChild;
    13. 

  13.   var sectionDiv=document.getElementById('dynsection'+num);
    14. 

  14.   if (sectionDiv.style.display=='none'||sectionDiv.style.display==''){
    15. 

  15.     sectionDiv.style.display='block';
    16. 

  16.     button.src='open.gif';
    17. 

  17.   }else{
    18. 

  18.     sectionDiv.style.display='none';
    19. 

  19.     button.src='closed.gif';
    20. 

  20.   }
    21. 

  21. }
    22. 

  22. function initDynSections(){
    23. 

  23.   var divs=document.getElementsByTagName('div');
    24. 

  24.   var sectionCounter=1;
    25. 

  25.   for(var i=0;i<divs.length-1;i++){
    26. 

  26.     if(divs[i].className=='dynheader'&&divs[i+1].className=='dynsection'){
    27. 

  27.       var header=divs[i];
    28. 

  28.       var section=divs[i+1];
    29. 

  29.       var button=header.firstChild;
    30. 

  30.       if (button!='IMG'){
    31. 

  31.         divs[i].insertBefore(document.createTextNode(' '),divs[i].firstChild);
    32. 

  32.         button=document.createElement('img');
    33. 

  33.         divs[i].insertBefore(button,divs[i].firstChild);
    34. 

  34.       }
    35. 

  35.       header.style.cursor='pointer';
    36. 

  36.       header.onclick=changeDisplayState;
    37. 

  37.       header.id='dynheader'+sectionCounter;
    38. 

  38.       button.src='closed.gif';
    39. 

  39.       section.id='dynsection'+sectionCounter;
    40. 

  40.       section.style.display='none';
    41. 

  41.       section.style.marginLeft='14px';
    42. 

  42.       sectionCounter++;
    43. 

  43.     }
    44. 

  44.   }
    45. 

  45. }
    46. 

  46. window.onload = initDynSections;
    47. 

  47. -->
    48. 

  48. </script>
    49. 

  49. <div class="navigation" id="top">
    50. 

  50.   <div class="tabs">
    51. 

  51.     <ul>
    52. 

  52.       <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
    53. 

  53.       <li><a href="pages.html"><span>Related&nbsp;Pages</span></a></li>
    54. 

  54.       <li><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
    55. 

  55.       <li class="current"><a href="files.html"><span>Files</span></a></li>
    56. 

  56.       <li><a href="dirs.html"><span>Directories</span></a></li>
    57. 

  57.     </ul>
    58. 

  58.   </div>
    59. 

  59.   <div class="navpath"><a class="el" href="dir_d294727123e4a9950cfa1260f7dd34bc.html">lib</a>
    60. 

  60.   </div>
    61. 

  61. </div>
    62. 

  62. <div class="contents">
    63. 

  63. <h1>ccn_match.c File Reference</h1>Support for the match predicate between interest and content. <a href="#_details">More...</a>
    64. 

  64. <p>
    65. 

  65. 

  66. <p>
    67. 

  67. <a href="ccn__match_8c-source.html">Go to the source code of this file.</a><table border="0" cellpadding="0" cellspacing="0">
    68. 

  68. <tr><td></td></tr>
    69. 

  69. <tr><td colspan="2"><br><h2>Functions</h2></td></tr>
    70. 

  70. <tr><td class="memItemLeft" nowrap align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="ccn__match_8c.html#fb9d2587d92fdbb92b7b1eee41bd7aab">ccn_digest_ContentObject</a> (const unsigned char *content_object, struct <a class="el" href="structccn__parsed___content_object.html">ccn_parsed_ContentObject</a> *pc)</td></tr>
    71. 

  71. 

  72. <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Compute the digest of the entire ContentObject if necessary, caching the result in pc-&gt;digest, pc-&gt;digest_bytes.  <a href="#fb9d2587d92fdbb92b7b1eee41bd7aab"></a><br></td></tr>
    73. 

  73. <tr><td class="memItemLeft" nowrap align="right" valign="top">static int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="ccn__match_8c.html#e0c8eb0ebf1238cc623dd735b91be527">ccn_pubid_matches</a> (const unsigned char *content_object, struct <a class="el" href="structccn__parsed___content_object.html">ccn_parsed_ContentObject</a> *pc, const unsigned char *interest_msg, const struct <a class="el" href="structccn__parsed__interest.html">ccn_parsed_interest</a> *pi)</td></tr>
    74. 

  74. 

  75. <tr><td class="memItemLeft" nowrap align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="ccn__match_8c.html#2e161e1c17ef110dfa019bc1d560c82c">ccn_content_matches_interest</a> (const unsigned char *content_object, size_t content_object_size, int implicit_content_digest, struct <a class="el" href="structccn__parsed___content_object.html">ccn_parsed_ContentObject</a> *pc, const unsigned char *interest_msg, size_t interest_msg_size, const struct <a class="el" href="structccn__parsed__interest.html">ccn_parsed_interest</a> *pi)</td></tr>
    76. 

  76. 

  77. <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Test for a match between a ContentObject and an Interest.  <a href="#2e161e1c17ef110dfa019bc1d560c82c"></a><br></td></tr>
    78. 

  78. </table>
    79. 

  79. <hr><a name="_details"></a><h2>Detailed Description</h2>
    80. 

  80. Support for the match predicate between interest and content. 
    81. 

  81. <p>
    82. 

  82. Part of the CCNx C Library.<p>
    83. 

  83. Copyright (C) 2008, 2009 Palo Alto Research Center, Inc.<p>
    84. 

  84. This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License version 2.1 as published by the Free Software Foundation. This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details. You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. 
    85. 

  85. <p>Definition in file <a class="el" href="ccn__match_8c-source.html">ccn_match.c</a>.</p>
    86. 

  86. <hr><h2>Function Documentation</h2>
    87. 

  87. <a class="anchor" name="2e161e1c17ef110dfa019bc1d560c82c"></a><!-- doxytag: member="ccn_match.c::ccn_content_matches_interest" ref="2e161e1c17ef110dfa019bc1d560c82c" args="(const unsigned char *content_object, size_t content_object_size, int implicit_content_digest, struct ccn_parsed_ContentObject *pc, const unsigned char *interest_msg, size_t interest_msg_size, const struct ccn_parsed_interest *pi)" -->
    88. 

  88. <div class="memitem">
    89. 

  89. <div class="memproto">
    90. 

  90.       <table class="memname">
    91. 

  91.         <tr>
    92. 

  92.           <td class="memname">int ccn_content_matches_interest           </td>
    93. 

  93.           <td>(</td>
    94. 

  94.           <td class="paramtype">const unsigned char *&nbsp;</td>
    95. 

  95.           <td class="paramname"> <em>content_object</em>, </td>
    96. 

  96.         </tr>
    97. 

  97.         <tr>
    98. 

  98.           <td class="paramkey"></td>
    99. 

  99.           <td></td>
    100. 

  100.           <td class="paramtype">size_t&nbsp;</td>
    101. 

  101.           <td class="paramname"> <em>content_object_size</em>, </td>
    102. 

  102.         </tr>
    103. 

  103.         <tr>
    104. 

  104.           <td class="paramkey"></td>
    105. 

  105.           <td></td>
    106. 

  106.           <td class="paramtype">int&nbsp;</td>
    107. 

  107.           <td class="paramname"> <em>implicit_content_digest</em>, </td>
    108. 

  108.         </tr>
    109. 

  109.         <tr>
    110. 

  110.           <td class="paramkey"></td>
    111. 

  111.           <td></td>
    112. 

  112.           <td class="paramtype">struct <a class="el" href="structccn__parsed___content_object.html">ccn_parsed_ContentObject</a> *&nbsp;</td>
    113. 

  113.           <td class="paramname"> <em>pc</em>, </td>
    114. 

  114.         </tr>
    115. 

  115.         <tr>
    116. 

  116.           <td class="paramkey"></td>
    117. 

  117.           <td></td>
    118. 

  118.           <td class="paramtype">const unsigned char *&nbsp;</td>
    119. 

  119.           <td class="paramname"> <em>interest_msg</em>, </td>
    120. 

  120.         </tr>
    121. 

  121.         <tr>
    122. 

  122.           <td class="paramkey"></td>
    123. 

  123.           <td></td>
    124. 

  124.           <td class="paramtype">size_t&nbsp;</td>
    125. 

  125.           <td class="paramname"> <em>interest_msg_size</em>, </td>
    126. 

  126.         </tr>
    127. 

  127.         <tr>
    128. 

  128.           <td class="paramkey"></td>
    129. 

  129.           <td></td>
    130. 

  130.           <td class="paramtype">const struct <a class="el" href="structccn__parsed__interest.html">ccn_parsed_interest</a> *&nbsp;</td>
    131. 

  131.           <td class="paramname"> <em>pi</em></td><td>&nbsp;</td>
    132. 

  132.         </tr>
    133. 

  133.         <tr>
    134. 

  134.           <td></td>
    135. 

  135.           <td>)</td>
    136. 

  136.           <td></td><td></td><td></td>
    137. 

  137.         </tr>
    138. 

  138.       </table>
    139. 

  139. </div>
    140. 

  140. <div class="memdoc">
    141. 

  141. 

  142. <p>
    143. 

  143. Test for a match between a ContentObject and an Interest. 
    144. 

  144. <p>
    145. 

  145. <dl compact><dt><b>Parameters:</b></dt><dd>
    146. 

  146.   <table border="0" cellspacing="2" cellpadding="0">
    147. 

  147.     <tr><td valign="top"></td><td valign="top"><em>content_object</em>&nbsp;</td><td>ccnb-encoded ContentObject </td></tr>
    148. 

  148.     <tr><td valign="top"></td><td valign="top"><em>content_object_size</em>&nbsp;</td><td>its size in bytes </td></tr>
    149. 

  149.     <tr><td valign="top"></td><td valign="top"><em>implicit_content_digest</em>&nbsp;</td><td>boolean indicating whether the final name component is implicit (as in the on-wire format) or explicit (as within ccnd's content store). </td></tr>
    150. 

  150.     <tr><td valign="top"></td><td valign="top"><em>pc</em>&nbsp;</td><td>Valid parse information may be provided to speed things up. If NULL it will be reconstructed internally. </td></tr>
    151. 

  151.     <tr><td valign="top"></td><td valign="top"><em>interest_msg</em>&nbsp;</td><td>ccnb-encoded Interest </td></tr>
    152. 

  152.     <tr><td valign="top"></td><td valign="top"><em>interest_msg_size</em>&nbsp;</td><td>its size in bytes </td></tr>
    153. 

  153.     <tr><td valign="top"></td><td valign="top"><em>pi</em>&nbsp;</td><td>see _pc_</td></tr>
    154. 

  154.   </table>
    155. 

  155. </dl>
    156. 

  156. <dl class="return" compact><dt><b>Returns:</b></dt><dd>1 if the ccnb-encoded content_object matches the ccnb-encoded interest_msg, otherwise 0. </dd></dl>
    157. 

  157. 

  158. <p>Definition at line <a class="el" href="ccn__match_8c-source.html#l00110">110</a> of file <a class="el" href="ccn__match_8c-source.html">ccn_match.c</a>.</p>
    159. 

  159. 

  160. <p>Referenced by <a class="el" href="ccn__client_8c-source.html#l01153">ccn_dispatch_message()</a>, <a class="el" href="ccnd__internal__client_8c-source.html#l00127">ccnd_answer_req()</a>, <a class="el" href="ccnd_8c-source.html#l01354">consume_matching_interests()</a>, <a class="el" href="ccnput_8c-source.html#l00078">incoming_interest()</a>, <a class="el" href="dataresponsetest_8c-source.html#l00212">interest_handler()</a>, <a class="el" href="ccnd_8c-source.html#l03524">process_incoming_interest()</a>, and <a class="el" href="ccn__seqwriter_8c-source.html#l00063">seqw_incoming_interest()</a>.</p>
    161. 

  161. 

  162. </div>
    163. 

  163. </div><p>
    164. 

  164. <a class="anchor" name="fb9d2587d92fdbb92b7b1eee41bd7aab"></a><!-- doxytag: member="ccn_match.c::ccn_digest_ContentObject" ref="fb9d2587d92fdbb92b7b1eee41bd7aab" args="(const unsigned char *content_object, struct ccn_parsed_ContentObject *pc)" -->
    165. 

  165. <div class="memitem">
    166. 

  166. <div class="memproto">
    167. 

  167.       <table class="memname">
    168. 

  168.         <tr>
    169. 

  169.           <td class="memname">void ccn_digest_ContentObject           </td>
    170. 

  170.           <td>(</td>
    171. 

  171.           <td class="paramtype">const unsigned char *&nbsp;</td>
    172. 

  172.           <td class="paramname"> <em>content_object</em>, </td>
    173. 

  173.         </tr>
    174. 

  174.         <tr>
    175. 

  175.           <td class="paramkey"></td>
    176. 

  176.           <td></td>
    177. 

  177.           <td class="paramtype">struct <a class="el" href="structccn__parsed___content_object.html">ccn_parsed_ContentObject</a> *&nbsp;</td>
    178. 

  178.           <td class="paramname"> <em>pc</em></td><td>&nbsp;</td>
    179. 

  179.         </tr>
    180. 

  180.         <tr>
    181. 

  181.           <td></td>
    182. 

  182.           <td>)</td>
    183. 

  183.           <td></td><td></td><td></td>
    184. 

  184.         </tr>
    185. 

  185.       </table>
    186. 

  186. </div>
    187. 

  187. <div class="memdoc">
    188. 

  188. 

  189. <p>
    190. 

  190. Compute the digest of the entire ContentObject if necessary, caching the result in pc-&gt;digest, pc-&gt;digest_bytes. 
    191. 

  191. <p>
    192. 

  192. 

  193. <p>Definition at line <a class="el" href="ccn__match_8c-source.html#l00033">33</a> of file <a class="el" href="ccn__match_8c-source.html">ccn_match.c</a>.</p>
    194. 

  194. 

  195. <p>Referenced by <a class="el" href="ccn__match_8c-source.html#l00110">ccn_content_matches_interest()</a>, <a class="el" href="ccnls_8c-source.html#l00052">incoming_content()</a>, and <a class="el" href="ccnd_8c-source.html#l03783">process_incoming_content()</a>.</p>
    196. 

  196. 

  197. </div>
    198. 

  198. </div><p>
    199. 

  199. <a class="anchor" name="e0c8eb0ebf1238cc623dd735b91be527"></a><!-- doxytag: member="ccn_match.c::ccn_pubid_matches" ref="e0c8eb0ebf1238cc623dd735b91be527" args="(const unsigned char *content_object, struct ccn_parsed_ContentObject *pc, const unsigned char *interest_msg, const struct ccn_parsed_interest *pi)" -->
    200. 

  200. <div class="memitem">
    201. 

  201. <div class="memproto">
    202. 

  202.       <table class="memname">
    203. 

  203.         <tr>
    204. 

  204.           <td class="memname">static int ccn_pubid_matches           </td>
    205. 

  205.           <td>(</td>
    206. 

  206.           <td class="paramtype">const unsigned char *&nbsp;</td>
    207. 

  207.           <td class="paramname"> <em>content_object</em>, </td>
    208. 

  208.         </tr>
    209. 

  209.         <tr>
    210. 

  210.           <td class="paramkey"></td>
    211. 

  211.           <td></td>
    212. 

  212.           <td class="paramtype">struct <a class="el" href="structccn__parsed___content_object.html">ccn_parsed_ContentObject</a> *&nbsp;</td>
    213. 

  213.           <td class="paramname"> <em>pc</em>, </td>
    214. 

  214.         </tr>
    215. 

  215.         <tr>
    216. 

  216.           <td class="paramkey"></td>
    217. 

  217.           <td></td>
    218. 

  218.           <td class="paramtype">const unsigned char *&nbsp;</td>
    219. 

  219.           <td class="paramname"> <em>interest_msg</em>, </td>
    220. 

  220.         </tr>
    221. 

  221.         <tr>
    222. 

  222.           <td class="paramkey"></td>
    223. 

  223.           <td></td>
    224. 

  224.           <td class="paramtype">const struct <a class="el" href="structccn__parsed__interest.html">ccn_parsed_interest</a> *&nbsp;</td>
    225. 

  225.           <td class="paramname"> <em>pi</em></td><td>&nbsp;</td>
    226. 

  226.         </tr>
    227. 

  227.         <tr>
    228. 

  228.           <td></td>
    229. 

  229.           <td>)</td>
    230. 

  230.           <td></td><td></td><td><code> [static]</code></td>
    231. 

  231.         </tr>
    232. 

  232.       </table>
    233. 

  233. </div>
    234. 

  234. <div class="memdoc">
    235. 

  235. 

  236. <p>
    237. 

  237. 

  238. <p>Definition at line <a class="el" href="ccn__match_8c-source.html#l00055">55</a> of file <a class="el" href="ccn__match_8c-source.html">ccn_match.c</a>.</p>
    239. 

  239. 

  240. <p>Referenced by <a class="el" href="ccn__match_8c-source.html#l00110">ccn_content_matches_interest()</a>.</p>
    241. 

  241. 

  242. </div>
    243. 

  243. </div><p>
    244. 

  244. </div>
    245. 

  245. <hr size="1"><address style="text-align: right;"><small>Generated on Wed Sep 14 12:44:16 2011 for Content-Centric Networking in C by&nbsp;
    246. 

  246. <a href="http://www.doxygen.org/index.html">
    247. 

  247. <img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.6 </small></address>
    248. 

  248. </body>
    249. 

  249. </html>
    250. 

  250.