group__ifapi__configuration.html 8.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173
  1. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
  2. <html xmlns="http://www.w3.org/1999/xhtml">
  3. <head>
  4. <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
  5. <meta http-equiv="X-UA-Compatible" content="IE=9"/>
  6. <meta name="generator" content="Doxygen 1.8.13"/>
  7. <meta name="viewport" content="width=device-width, initial-scale=1"/>
  8. <title>tpm2-tss: Configuration utilities.</title>
  9. <link href="tabs.css" rel="stylesheet" type="text/css"/>
  10. <script type="text/javascript" src="jquery.js"></script>
  11. <script type="text/javascript" src="dynsections.js"></script>
  12. <link href="navtree.css" rel="stylesheet" type="text/css"/>
  13. <script type="text/javascript" src="resize.js"></script>
  14. <script type="text/javascript" src="navtreedata.js"></script>
  15. <script type="text/javascript" src="navtree.js"></script>
  16. <script type="text/javascript">
  17. $(document).ready(initResizable);
  18. </script>
  19. <link href="doxygen.css" rel="stylesheet" type="text/css" />
  20. </head>
  21. <body>
  22. <div id="top"><!-- do not remove this div, it is closed by doxygen! -->
  23. <div id="titlearea">
  24. <table cellspacing="0" cellpadding="0">
  25. <tbody>
  26. <tr style="height: 56px;">
  27. <td id="projectalign" style="padding-left: 0.5em;">
  28. <div id="projectname">tpm2-tss
  29. &#160;<span id="projectnumber">3.2.0</span>
  30. </div>
  31. <div id="projectbrief">TPM Software stack 2.0 TCG spec compliant implementation</div>
  32. </td>
  33. </tr>
  34. </tbody>
  35. </table>
  36. </div>
  37. <!-- end header part -->
  38. <!-- Generated by Doxygen 1.8.13 -->
  39. <script type="text/javascript" src="menudata.js"></script>
  40. <script type="text/javascript" src="menu.js"></script>
  41. <script type="text/javascript">
  42. $(function() {
  43. initMenu('',false,false,'search.php','Search');
  44. });
  45. </script>
  46. <div id="main-nav"></div>
  47. </div><!-- top -->
  48. <div id="side-nav" class="ui-resizable side-nav-resizable">
  49. <div id="nav-tree">
  50. <div id="nav-tree-contents">
  51. <div id="nav-sync" class="sync"></div>
  52. </div>
  53. </div>
  54. <div id="splitbar" style="-moz-user-select:none;"
  55. class="ui-resizable-handle">
  56. </div>
  57. </div>
  58. <script type="text/javascript">
  59. $(document).ready(function(){initNavTree('group__ifapi__configuration.html','');});
  60. </script>
  61. <div id="doc-content">
  62. <div class="header">
  63. <div class="summary">
  64. <a href="#func-members">Functions</a> </div>
  65. <div class="headertitle">
  66. <div class="title">Configuration utilities.<div class="ingroups"><a class="el" href="group__fapi.html">Feature API</a> &raquo; <a class="el" href="group__ifapi.html">Internals of Feature API</a></div></div> </div>
  67. </div><!--header-->
  68. <div class="contents">
  69. <table class="memberdecls">
  70. <tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="func-members"></a>
  71. Functions</h2></td></tr>
  72. <tr class="memitem:ga989f3cb142db689a98cb0a98959badbc"><td class="memItemLeft" align="right" valign="top">TSS2_RC&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__ifapi__configuration.html#ga989f3cb142db689a98cb0a98959badbc">ifapi_config_initialize_async</a> (<a class="el" href="struct_i_f_a_p_i___i_o.html">IFAPI_IO</a> *io)</td></tr>
  73. <tr class="separator:ga989f3cb142db689a98cb0a98959badbc"><td class="memSeparator" colspan="2">&#160;</td></tr>
  74. <tr class="memitem:ga6ab46258a0124cfedb42d3a736da8f19"><td class="memItemLeft" align="right" valign="top">TSS2_RC&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__ifapi__configuration.html#ga6ab46258a0124cfedb42d3a736da8f19">ifapi_config_initialize_finish</a> (<a class="el" href="struct_i_f_a_p_i___i_o.html">IFAPI_IO</a> *io, <a class="el" href="struct_i_f_a_p_i___c_o_n_f_i_g.html">IFAPI_CONFIG</a> *config)</td></tr>
  75. <tr class="separator:ga6ab46258a0124cfedb42d3a736da8f19"><td class="memSeparator" colspan="2">&#160;</td></tr>
  76. </table>
  77. <a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
  78. <p>Provides internal fapi functions for deserialization of the configuration data and the initialization of the configuration. </p>
  79. <h2 class="groupheader">Function Documentation</h2>
  80. <a id="ga989f3cb142db689a98cb0a98959badbc"></a>
  81. <h2 class="memtitle"><span class="permalink"><a href="#ga989f3cb142db689a98cb0a98959badbc">&#9670;&nbsp;</a></span>ifapi_config_initialize_async()</h2>
  82. <div class="memitem">
  83. <div class="memproto">
  84. <table class="memname">
  85. <tr>
  86. <td class="memname">TSS2_RC ifapi_config_initialize_async </td>
  87. <td>(</td>
  88. <td class="paramtype"><a class="el" href="struct_i_f_a_p_i___i_o.html">IFAPI_IO</a> *&#160;</td>
  89. <td class="paramname"><em>io</em></td><td>)</td>
  90. <td></td>
  91. </tr>
  92. </table>
  93. </div><div class="memdoc">
  94. <p>Starts the initialization of the FAPI configuration.</p>
  95. <dl class="params"><dt>Parameters</dt><dd>
  96. <table class="params">
  97. <tr><td class="paramdir">[in]</td><td class="paramname">io</td><td>An IO object for file system access</td></tr>
  98. </table>
  99. </dd>
  100. </dl>
  101. <dl class="retval"><dt>Return values</dt><dd>
  102. <table class="retval">
  103. <tr><td class="paramname">TSS2_RC_SUCCESS</td><td>on success </td></tr>
  104. <tr><td class="paramname">TSS2_FAPI_RC_BAD_REFERENCE</td><td>if io is NULL </td></tr>
  105. <tr><td class="paramname">TSS2_FAPI_RC_IO_ERROR</td><td>if an error occurred while accessing the object store. </td></tr>
  106. <tr><td class="paramname">TSS2_FAPI_RC_MEMORY</td><td>if not enough memory can be allocated. </td></tr>
  107. </table>
  108. </dd>
  109. </dl>
  110. </div>
  111. </div>
  112. <a id="ga6ab46258a0124cfedb42d3a736da8f19"></a>
  113. <h2 class="memtitle"><span class="permalink"><a href="#ga6ab46258a0124cfedb42d3a736da8f19">&#9670;&nbsp;</a></span>ifapi_config_initialize_finish()</h2>
  114. <div class="memitem">
  115. <div class="memproto">
  116. <table class="memname">
  117. <tr>
  118. <td class="memname">TSS2_RC ifapi_config_initialize_finish </td>
  119. <td>(</td>
  120. <td class="paramtype"><a class="el" href="struct_i_f_a_p_i___i_o.html">IFAPI_IO</a> *&#160;</td>
  121. <td class="paramname"><em>io</em>, </td>
  122. </tr>
  123. <tr>
  124. <td class="paramkey"></td>
  125. <td></td>
  126. <td class="paramtype"><a class="el" href="struct_i_f_a_p_i___c_o_n_f_i_g.html">IFAPI_CONFIG</a> *&#160;</td>
  127. <td class="paramname"><em>config</em>&#160;</td>
  128. </tr>
  129. <tr>
  130. <td></td>
  131. <td>)</td>
  132. <td></td><td></td>
  133. </tr>
  134. </table>
  135. </div><div class="memdoc">
  136. <p>Finishes the initialization of the FAPI configuration. </p><dl class="params"><dt>Parameters</dt><dd>
  137. <table class="params">
  138. <tr><td class="paramdir">[in]</td><td class="paramname">io</td><td>An IO object for file system access </td></tr>
  139. <tr><td class="paramdir">[out]</td><td class="paramname">config</td><td>The configuration that is initialized</td></tr>
  140. </table>
  141. </dd>
  142. </dl>
  143. <dl class="retval"><dt>Return values</dt><dd>
  144. <table class="retval">
  145. <tr><td class="paramname">TSS2_RC_SUCCESS</td><td>on success </td></tr>
  146. <tr><td class="paramname">TSS2_FAPI_RC_BAD_REFERENCE</td><td>if config or io is NULL </td></tr>
  147. <tr><td class="paramname">TSS2_FAPI_RC_BAD_VALUE</td><td>if the read configuration file does not hold a valid configuration </td></tr>
  148. <tr><td class="paramname">TSS2_FAPI_RC_GENERAL_FAILURE</td><td>if JSON parsing fails </td></tr>
  149. <tr><td class="paramname">TSS2_FAPI_RC_BAD_PATH</td><td>if the configuration path is invalid </td></tr>
  150. <tr><td class="paramname">TSS2_FAPI_RC_TRY_AGAIN</td><td>if an I/O operation is not finished yet and this function needs to be called again. </td></tr>
  151. <tr><td class="paramname">TSS2_FAPI_RC_IO_ERROR</td><td>if an error occurred while accessing the object store. </td></tr>
  152. <tr><td class="paramname">TSS2_FAPI_RC_MEMORY</td><td>if not enough memory can be allocated. </td></tr>
  153. </table>
  154. </dd>
  155. </dl>
  156. </div>
  157. </div>
  158. </div><!-- contents -->
  159. </div><!-- doc-content -->
  160. <!-- start footer part -->
  161. <div id="nav-path" class="navpath"><!-- id is needed for treeview function! -->
  162. <ul>
  163. <li class="footer">Generated by
  164. <a href="http://www.doxygen.org/index.html">
  165. <img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.8.13 </li>
  166. </ul>
  167. </div>
  168. </body>
  169. </html>