Trang chủ Khám phá Trợ giúp
Đăng nhập
SoftwareDesign
/
csu3_am335x
8
0
Fork 0
Các tập tin Các vấn đề 0 Yêu cầu kéo về 0 Wiki
Branch: master
Branches Tags
csu3_am335x
/
EVSE
/
GPL
/
tpm2-tss-3.2.0
/
doxygen-doc
/
html
/
group__fapi__crypto.html

group__fapi__crypto.html 54 KB
Permalink Lịch sử Raw

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127 
  1. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
    2. 

  2. <html xmlns="http://www.w3.org/1999/xhtml">
    3. 

  3. <head>
    4. 

  4. <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
    5. 

  5. <meta http-equiv="X-UA-Compatible" content="IE=9"/>
    6. 

  6. <meta name="generator" content="Doxygen 1.8.13"/>
    7. 

  7. <meta name="viewport" content="width=device-width, initial-scale=1"/>
    8. 

  8. <title>tpm2-tss: Internal Cryptographic Backend</title>
    9. 

  9. <link href="tabs.css" rel="stylesheet" type="text/css"/>
    10. 

  10. <script type="text/javascript" src="jquery.js"></script>
    11. 

  11. <script type="text/javascript" src="dynsections.js"></script>
    12. 

  12. <link href="navtree.css" rel="stylesheet" type="text/css"/>
    13. 

  13. <script type="text/javascript" src="resize.js"></script>
    14. 

  14. <script type="text/javascript" src="navtreedata.js"></script>
    15. 

  15. <script type="text/javascript" src="navtree.js"></script>
    16. 

  16. <script type="text/javascript">
    17. 

  17.   $(document).ready(initResizable);
    18. 

  18. </script>
    19. 

  19. <link href="doxygen.css" rel="stylesheet" type="text/css" />
    20. 

  20. </head>
    21. 

  21. <body>
    22. 

  22. <div id="top"><!-- do not remove this div, it is closed by doxygen! -->
    23. 

  23. <div id="titlearea">
    24. 

  24. <table cellspacing="0" cellpadding="0">
    25. 

  25.  <tbody>
    26. 

  26.  <tr style="height: 56px;">
    27. 

  27.   <td id="projectalign" style="padding-left: 0.5em;">
    28. 

  28.    <div id="projectname">tpm2-tss
    29. 

  29.    &#160;<span id="projectnumber">3.2.0</span>
    30. 

  30.    </div>
    31. 

  31.    <div id="projectbrief">TPM Software stack 2.0 TCG spec compliant implementation</div>
    32. 

  32.   </td>
    33. 

  33.  </tr>
    34. 

  34.  </tbody>
    35. 

  35. </table>
    36. 

  36. </div>
    37. 

  37. <!-- end header part -->
    38. 

  38. <!-- Generated by Doxygen 1.8.13 -->
    39. 

  39. <script type="text/javascript" src="menudata.js"></script>
    40. 

  40. <script type="text/javascript" src="menu.js"></script>
    41. 

  41. <script type="text/javascript">
    42. 

  42. $(function() {
    43. 

  43.   initMenu('',false,false,'search.php','Search');
    44. 

  44. });
    45. 

  45. </script>
    46. 

  46. <div id="main-nav"></div>
    47. 

  47. </div><!-- top -->
    48. 

  48. <div id="side-nav" class="ui-resizable side-nav-resizable">
    49. 

  49.   <div id="nav-tree">
    50. 

  50.     <div id="nav-tree-contents">
    51. 

  51.       <div id="nav-sync" class="sync"></div>
    52. 

  52.     </div>
    53. 

  53.   </div>
    54. 

  54.   <div id="splitbar" style="-moz-user-select:none;" 
    55. 

  55.        class="ui-resizable-handle">
    56. 

  56.   </div>
    57. 

  57. </div>
    58. 

  58. <script type="text/javascript">
    59. 

  59. $(document).ready(function(){initNavTree('group__fapi__crypto.html','');});
    60. 

  60. </script>
    61. 

  61. <div id="doc-content">
    62. 

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

  63.   <div class="summary">
    64. 

  64. <a href="#func-members">Functions</a>  </div>
    65. 

  65.   <div class="headertitle">
    66. 

  66. <div class="title">Internal Cryptographic Backend<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. 

  67. </div><!--header-->
    68. 

  68. <div class="contents">
    69. 

  69. <table class="memberdecls">
    70. 

  70. <tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="func-members"></a>
    71. 

  71. Functions</h2></td></tr>
    72. 

  72. <tr class="memitem:gaf7e99f1f5064793629b00608c1567d9e"><td class="memItemLeft" align="right" valign="top">TSS2_RC&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__fapi__crypto.html#gaf7e99f1f5064793629b00608c1567d9e">get_crl_from_cert</a> (X509 *cert, X509_CRL **crl)</td></tr>
    73. 

  73. <tr class="separator:gaf7e99f1f5064793629b00608c1567d9e"><td class="memSeparator" colspan="2">&#160;</td></tr>
    74. 

  74. <tr class="memitem:ga335ce751f0d6d9288608568872cec24b"><td class="memItemLeft" align="right" valign="top">TSS2_RC&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__fapi__crypto.html#ga335ce751f0d6d9288608568872cec24b">ifapi_cert_to_pem</a> (const uint8_t *certBuffer, size_t certBufferSize, char **pemCert, TPM2_ALG_ID *certAlgorithmId, TPM2B_PUBLIC *tpmPublic)</td></tr>
    75. 

  75. <tr class="separator:ga335ce751f0d6d9288608568872cec24b"><td class="memSeparator" colspan="2">&#160;</td></tr>
    76. 

  76. <tr class="memitem:ga037db3129ad84c8a032e1f3ac3233f0d"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__fapi__crypto.html#ga037db3129ad84c8a032e1f3ac3233f0d">ifapi_crypto_hash_abort</a> (<a class="el" href="struct___i_f_a_p_i___c_r_y_p_t_o___c_o_n_t_e_x_t.html">IFAPI_CRYPTO_CONTEXT_BLOB</a> **context)</td></tr>
    77. 

  77. <tr class="separator:ga037db3129ad84c8a032e1f3ac3233f0d"><td class="memSeparator" colspan="2">&#160;</td></tr>
    78. 

  78. <tr class="memitem:gae2feeff96f78225620819f2f6217964e"><td class="memItemLeft" align="right" valign="top">TSS2_RC&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__fapi__crypto.html#gae2feeff96f78225620819f2f6217964e">ifapi_crypto_hash_finish</a> (<a class="el" href="struct___i_f_a_p_i___c_r_y_p_t_o___c_o_n_t_e_x_t.html">IFAPI_CRYPTO_CONTEXT_BLOB</a> **context, uint8_t *digest, size_t *digestSize)</td></tr>
    79. 

  79. <tr class="separator:gae2feeff96f78225620819f2f6217964e"><td class="memSeparator" colspan="2">&#160;</td></tr>
    80. 

  80. <tr class="memitem:ga1bae9ed161278e58f8e39d70f110b046"><td class="memItemLeft" align="right" valign="top">TSS2_RC&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__fapi__crypto.html#ga1bae9ed161278e58f8e39d70f110b046">ifapi_crypto_hash_start</a> (<a class="el" href="struct___i_f_a_p_i___c_r_y_p_t_o___c_o_n_t_e_x_t.html">IFAPI_CRYPTO_CONTEXT_BLOB</a> **context, TPM2_ALG_ID hashAlgorithm)</td></tr>
    81. 

  81. <tr class="separator:ga1bae9ed161278e58f8e39d70f110b046"><td class="memSeparator" colspan="2">&#160;</td></tr>
    82. 

  82. <tr class="memitem:gaf9c318cab007a23adef270f9c4a606b4"><td class="memItemLeft" align="right" valign="top">TSS2_RC&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__fapi__crypto.html#gaf9c318cab007a23adef270f9c4a606b4">ifapi_crypto_hash_update</a> (<a class="el" href="struct___i_f_a_p_i___c_r_y_p_t_o___c_o_n_t_e_x_t.html">IFAPI_CRYPTO_CONTEXT_BLOB</a> *context, const uint8_t *buffer, size_t size)</td></tr>
    83. 

  83. <tr class="separator:gaf9c318cab007a23adef270f9c4a606b4"><td class="memSeparator" colspan="2">&#160;</td></tr>
    84. 

  84. <tr class="memitem:ga487ac222f6bd4074c34128627af14825"><td class="memItemLeft" align="right" valign="top">TSS2_RC&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__fapi__crypto.html#ga487ac222f6bd4074c34128627af14825">ifapi_der_sig_to_tpm</a> (const TPMT_PUBLIC *tpmPublic, const unsigned char *signature, size_t signatureSize, TPMI_ALG_HASH hashAlgorithm, TPMT_SIGNATURE *tpmSignature)</td></tr>
    85. 

  85. <tr class="separator:ga487ac222f6bd4074c34128627af14825"><td class="memSeparator" colspan="2">&#160;</td></tr>
    86. 

  86. <tr class="memitem:gac56f0fce6cbb0ff4e4cba9c398f695df"><td class="memItemLeft" align="right" valign="top">TSS2_RC&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__fapi__crypto.html#gac56f0fce6cbb0ff4e4cba9c398f695df">ifapi_get_hash_alg_for_size</a> (uint16_t size, TPMI_ALG_HASH *hashAlgorithm)</td></tr>
    87. 

  87. <tr class="separator:gac56f0fce6cbb0ff4e4cba9c398f695df"><td class="memSeparator" colspan="2">&#160;</td></tr>
    88. 

  88. <tr class="memitem:gaa97941ce97a4bc07441db3cd6b7d47f6"><td class="memItemLeft" align="right" valign="top">TPM2_RC&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__fapi__crypto.html#gaa97941ce97a4bc07441db3cd6b7d47f6">ifapi_get_profile_sig_scheme</a> (const <a class="el" href="struct_i_f_a_p_i___p_r_o_f_i_l_e.html">IFAPI_PROFILE</a> *profile, const TPMT_PUBLIC *tpmPublic, TPMT_SIG_SCHEME *signatureScheme)</td></tr>
    89. 

  89. <tr class="separator:gaa97941ce97a4bc07441db3cd6b7d47f6"><td class="memSeparator" colspan="2">&#160;</td></tr>
    90. 

  90. <tr class="memitem:gaf713079ae0eaa00544909915b126e4b7"><td class="memItemLeft" align="right" valign="top">TSS2_RC&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__fapi__crypto.html#gaf713079ae0eaa00544909915b126e4b7">ifapi_get_public_from_pem_cert</a> (const char *pem_cert, TPM2B_PUBLIC *tpm_public)</td></tr>
    91. 

  91. <tr class="separator:gaf713079ae0eaa00544909915b126e4b7"><td class="memSeparator" colspan="2">&#160;</td></tr>
    92. 

  92. <tr class="memitem:ga2749271fc949a0587ea33fd35b20c651"><td class="memItemLeft" align="right" valign="top">TPM2_ALG_ID&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__fapi__crypto.html#ga2749271fc949a0587ea33fd35b20c651">ifapi_get_signature_algorithm_from_pem</a> (const char *pemKey)</td></tr>
    93. 

  93. <tr class="separator:ga2749271fc949a0587ea33fd35b20c651"><td class="memSeparator" colspan="2">&#160;</td></tr>
    94. 

  94. <tr class="memitem:gaf0acb921826dd121e027f6a7ffe2e6ca"><td class="memItemLeft" align="right" valign="top">TSS2_RC&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__fapi__crypto.html#gaf0acb921826dd121e027f6a7ffe2e6ca">ifapi_get_tpm2b_public_from_pem</a> (const char *pemKey, TPM2B_PUBLIC *tpmPublic)</td></tr>
    95. 

  95. <tr class="separator:gaf0acb921826dd121e027f6a7ffe2e6ca"><td class="memSeparator" colspan="2">&#160;</td></tr>
    96. 

  96. <tr class="memitem:ga30a2dbc9555d38d2cc07ae8039d52d42"><td class="memItemLeft" align="right" valign="top">TSS2_RC&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__fapi__crypto.html#ga30a2dbc9555d38d2cc07ae8039d52d42">ifapi_get_tpm_key_fingerprint</a> (const TPM2B_PUBLIC *tpmPublicKey, TPMI_ALG_HASH hashAlg, TPM2B_DIGEST *fingerprint)</td></tr>
    97. 

  97. <tr class="separator:ga30a2dbc9555d38d2cc07ae8039d52d42"><td class="memSeparator" colspan="2">&#160;</td></tr>
    98. 

  98. <tr class="memitem:ga817996f764dc590b0fcde8b2479ebd14"><td class="memItemLeft" align="right" valign="top">size_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__fapi__crypto.html#ga817996f764dc590b0fcde8b2479ebd14">ifapi_hash_get_digest_size</a> (TPM2_ALG_ID hashAlgorithm)</td></tr>
    99. 

  99. <tr class="separator:ga817996f764dc590b0fcde8b2479ebd14"><td class="memSeparator" colspan="2">&#160;</td></tr>
    100. 

  100. <tr class="memitem:gaca515b7a38f631d79c814709f8506e0e"><td class="memItemLeft" align="right" valign="top">TSS2_RC&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__fapi__crypto.html#gaca515b7a38f631d79c814709f8506e0e">ifapi_initialize_sign_public</a> (TPM2_ALG_ID signatureAlgorithm, TPM2B_PUBLIC *public)</td></tr>
    101. 

  101. <tr class="separator:gaca515b7a38f631d79c814709f8506e0e"><td class="memSeparator" colspan="2">&#160;</td></tr>
    102. 

  102. <tr class="memitem:ga67cac597edb51e7aeab416e3b3d46194"><td class="memItemLeft" align="right" valign="top">TSS2_RC&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__fapi__crypto.html#ga67cac597edb51e7aeab416e3b3d46194">ifapi_pub_pem_key_from_tpm</a> (const TPM2B_PUBLIC *tpmPublicKey, char **pemKey, int *pemKeySize)</td></tr>
    103. 

  103. <tr class="separator:ga67cac597edb51e7aeab416e3b3d46194"><td class="memSeparator" colspan="2">&#160;</td></tr>
    104. 

  104. <tr class="memitem:ga48d5eaba0929c2509a637e7e6a35990d"><td class="memItemLeft" align="right" valign="top">TSS2_RC&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__fapi__crypto.html#ga48d5eaba0929c2509a637e7e6a35990d">ifapi_tpm_ecc_sig_to_der</a> (const TPMT_SIGNATURE *tpmSignature, uint8_t **signature, size_t *signatureSize)</td></tr>
    105. 

  105. <tr class="separator:ga48d5eaba0929c2509a637e7e6a35990d"><td class="memSeparator" colspan="2">&#160;</td></tr>
    106. 

  106. <tr class="memitem:gaad2a4c24b2a55638bcb84fca8b5fc2f6"><td class="memItemLeft" align="right" valign="top">TSS2_RC&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__fapi__crypto.html#gaad2a4c24b2a55638bcb84fca8b5fc2f6">ifapi_verify_ek_cert</a> (char *root_cert_pem, char *intermed_cert_pem, char *ek_cert_pem)</td></tr>
    107. 

  107. <tr class="separator:gaad2a4c24b2a55638bcb84fca8b5fc2f6"><td class="memSeparator" colspan="2">&#160;</td></tr>
    108. 

  108. <tr class="memitem:gae1b2637abec3a461a863360c0e76cc35"><td class="memItemLeft" align="right" valign="top">TSS2_RC&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__fapi__crypto.html#gae1b2637abec3a461a863360c0e76cc35">ifapi_verify_signature</a> (const <a class="el" href="struct___i_f_a_p_i___o_b_j_e_c_t.html">IFAPI_OBJECT</a> *keyObject, const uint8_t *signature, size_t signatureSize, const uint8_t *digest, size_t digestSize)</td></tr>
    109. 

  109. <tr class="separator:gae1b2637abec3a461a863360c0e76cc35"><td class="memSeparator" colspan="2">&#160;</td></tr>
    110. 

  110. <tr class="memitem:gaf974aab23bced5dd22e422b5ad5cbb51"><td class="memItemLeft" align="right" valign="top">TSS2_RC&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__fapi__crypto.html#gaf974aab23bced5dd22e422b5ad5cbb51">ifapi_verify_signature_quote</a> (const <a class="el" href="struct___i_f_a_p_i___o_b_j_e_c_t.html">IFAPI_OBJECT</a> *keyObject, const uint8_t *signature, size_t signatureSize, const uint8_t *digest, size_t digestSize, const TPMT_SIG_SCHEME *signatureScheme)</td></tr>
    111. 

  111. <tr class="separator:gaf974aab23bced5dd22e422b5ad5cbb51"><td class="memSeparator" colspan="2">&#160;</td></tr>
    112. 

  112. </table>
    113. 

  113. <a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
    114. 

  114. <p>The types and functions used internally by FAPI for cryptographic operations. Multiple implementations of these functions for different cryptographic backends may exist. </p>
    115. 

  115. <h2 class="groupheader">Function Documentation</h2>
    116. 

  116. <a id="gaf7e99f1f5064793629b00608c1567d9e"></a>
    117. 

  117. <h2 class="memtitle"><span class="permalink"><a href="#gaf7e99f1f5064793629b00608c1567d9e">&#9670;&nbsp;</a></span>get_crl_from_cert()</h2>
    118. 

  118. 

  119. <div class="memitem">
    120. 

  120. <div class="memproto">
    121. 

  121.       <table class="memname">
    122. 

  122.         <tr>
    123. 

  123.           <td class="memname">TSS2_RC get_crl_from_cert </td>
    124. 

  124.           <td>(</td>
    125. 

  125.           <td class="paramtype">X509 *&#160;</td>
    126. 

  126.           <td class="paramname"><em>cert</em>, </td>
    127. 

  127.         </tr>
    128. 

  128.         <tr>
    129. 

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

  130.           <td></td>
    131. 

  131.           <td class="paramtype">X509_CRL **&#160;</td>
    132. 

  132.           <td class="paramname"><em>crl</em>&#160;</td>
    133. 

  133.         </tr>
    134. 

  134.         <tr>
    135. 

  135.           <td></td>
    136. 

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

  137.           <td></td><td></td>
    138. 

  138.         </tr>
    139. 

  139.       </table>
    140. 

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

  141. <p>Get url to download crl from certificate. </p><dl class="retval"><dt>Return values</dt><dd>
    142. 

  142.   <table class="retval">
    143. 

  143.     <tr><td class="paramname">TSS2_FAPI_RC_MEMORY</td><td>if not enough memory can be allocated. </td></tr>
    144. 

  144.     <tr><td class="paramname">TSS2_FAPI_RC_BAD_VALUE</td><td>if an invalid value was passed into the function. </td></tr>
    145. 

  145.     <tr><td class="paramname">TSS2_FAPI_RC_GENERAL_FAILURE</td><td>if an internal error occurred. </td></tr>
    146. 

  146.     <tr><td class="paramname">TSS2_FAPI_RC_NO_CERT</td><td>if an error did occur during certificate downloading. </td></tr>
    147. 

  147.   </table>
    148. 

  148.   </dd>
    149. 

  149. </dl>
    150. 

  150. 

  151. </div>
    152. 

  152. </div>
    153. 

  153. <a id="ga335ce751f0d6d9288608568872cec24b"></a>
    154. 

  154. <h2 class="memtitle"><span class="permalink"><a href="#ga335ce751f0d6d9288608568872cec24b">&#9670;&nbsp;</a></span>ifapi_cert_to_pem()</h2>
    155. 

  155. 

  156. <div class="memitem">
    157. 

  157. <div class="memproto">
    158. 

  158.       <table class="memname">
    159. 

  159.         <tr>
    160. 

  160.           <td class="memname">TSS2_RC ifapi_cert_to_pem </td>
    161. 

  161.           <td>(</td>
    162. 

  162.           <td class="paramtype">const uint8_t *&#160;</td>
    163. 

  163.           <td class="paramname"><em>certBuffer</em>, </td>
    164. 

  164.         </tr>
    165. 

  165.         <tr>
    166. 

  166.           <td class="paramkey"></td>
    167. 

  167.           <td></td>
    168. 

  168.           <td class="paramtype">size_t&#160;</td>
    169. 

  169.           <td class="paramname"><em>certBufferSize</em>, </td>
    170. 

  170.         </tr>
    171. 

  171.         <tr>
    172. 

  172.           <td class="paramkey"></td>
    173. 

  173.           <td></td>
    174. 

  174.           <td class="paramtype">char **&#160;</td>
    175. 

  175.           <td class="paramname"><em>pemCert</em>, </td>
    176. 

  176.         </tr>
    177. 

  177.         <tr>
    178. 

  178.           <td class="paramkey"></td>
    179. 

  179.           <td></td>
    180. 

  180.           <td class="paramtype">TPM2_ALG_ID *&#160;</td>
    181. 

  181.           <td class="paramname"><em>certAlgorithmId</em>, </td>
    182. 

  182.         </tr>
    183. 

  183.         <tr>
    184. 

  184.           <td class="paramkey"></td>
    185. 

  185.           <td></td>
    186. 

  186.           <td class="paramtype">TPM2B_PUBLIC *&#160;</td>
    187. 

  187.           <td class="paramname"><em>tpmPublic</em>&#160;</td>
    188. 

  188.         </tr>
    189. 

  189.         <tr>
    190. 

  190.           <td></td>
    191. 

  191.           <td>)</td>
    192. 

  192.           <td></td><td></td>
    193. 

  193.         </tr>
    194. 

  194.       </table>
    195. 

  195. </div><div class="memdoc">
    196. 

  196. <p>Converts a TPM certificate buffer to the PEM format.</p>
    197. 

  197. <dl class="params"><dt>Parameters</dt><dd>
    198. 

  198.   <table class="params">
    199. 

  199.     <tr><td class="paramdir">[in]</td><td class="paramname">certBuffer</td><td>A byte buffer holding the certificate </td></tr>
    200. 

  200.     <tr><td class="paramdir">[in]</td><td class="paramname">certBufferSize</td><td>The size of certBuffer in bytes </td></tr>
    201. 

  201.     <tr><td class="paramdir">[out]</td><td class="paramname">pemCert</td><td>A byte buffer where the PEM-formatted certificate is stored </td></tr>
    202. 

  202.     <tr><td class="paramdir">[out]</td><td class="paramname">certAlgorithmId</td><td>The key type of the certified key </td></tr>
    203. 

  203.     <tr><td class="paramdir">[out]</td><td class="paramname">tpmPublic</td><td>The public key of the certificate in TPM format.</td></tr>
    204. 

  204.   </table>
    205. 

  205.   </dd>
    206. 

  206. </dl>
    207. 

  207. <dl class="retval"><dt>Return values</dt><dd>
    208. 

  208.   <table class="retval">
    209. 

  209.     <tr><td class="paramname">TSS2_RC_SUCCESS</td><td>on success </td></tr>
    210. 

  210.     <tr><td class="paramname">TSS2_FAPI_RC_BAD_REFERENCE</td><td>if certBuffer or pemCert is NULL </td></tr>
    211. 

  211.     <tr><td class="paramname">TSS2_FAPI_RC_MEMORY</td><td>if memory could not be allocated </td></tr>
    212. 

  212.     <tr><td class="paramname">TSS2_FAPI_RC_BAD_VALUE</td><td>if the certificate is invalid </td></tr>
    213. 

  213.     <tr><td class="paramname">TSS2_FAPI_RC_GENERAL_FAILURE</td><td>if an error occurs in the crypto library </td></tr>
    214. 

  214.   </table>
    215. 

  215.   </dd>
    216. 

  216. </dl>
    217. 

  217. 

  218. </div>
    219. 

  219. </div>
    220. 

  220. <a id="ga037db3129ad84c8a032e1f3ac3233f0d"></a>
    221. 

  221. <h2 class="memtitle"><span class="permalink"><a href="#ga037db3129ad84c8a032e1f3ac3233f0d">&#9670;&nbsp;</a></span>ifapi_crypto_hash_abort()</h2>
    222. 

  222. 

  223. <div class="memitem">
    224. 

  224. <div class="memproto">
    225. 

  225.       <table class="memname">
    226. 

  226.         <tr>
    227. 

  227.           <td class="memname">void ifapi_crypto_hash_abort </td>
    228. 

  228.           <td>(</td>
    229. 

  229.           <td class="paramtype"><a class="el" href="struct___i_f_a_p_i___c_r_y_p_t_o___c_o_n_t_e_x_t.html">IFAPI_CRYPTO_CONTEXT_BLOB</a> **&#160;</td>
    230. 

  230.           <td class="paramname"><em>context</em></td><td>)</td>
    231. 

  231.           <td></td>
    232. 

  232.         </tr>
    233. 

  233.       </table>
    234. 

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

  235. <p>Aborts a hash operation and finalizes the hash context. It will be set to NULL.</p>
    236. 

  236. <dl class="params"><dt>Parameters</dt><dd>
    237. 

  237.   <table class="params">
    238. 

  238.     <tr><td class="paramdir">[in,out]</td><td class="paramname">context</td><td>The context of the digest object. </td></tr>
    239. 

  239.   </table>
    240. 

  240.   </dd>
    241. 

  241. </dl>
    242. 

  242. 

  243. </div>
    244. 

  244. </div>
    245. 

  245. <a id="gae2feeff96f78225620819f2f6217964e"></a>
    246. 

  246. <h2 class="memtitle"><span class="permalink"><a href="#gae2feeff96f78225620819f2f6217964e">&#9670;&nbsp;</a></span>ifapi_crypto_hash_finish()</h2>
    247. 

  247. 

  248. <div class="memitem">
    249. 

  249. <div class="memproto">
    250. 

  250.       <table class="memname">
    251. 

  251.         <tr>
    252. 

  252.           <td class="memname">TSS2_RC ifapi_crypto_hash_finish </td>
    253. 

  253.           <td>(</td>
    254. 

  254.           <td class="paramtype"><a class="el" href="struct___i_f_a_p_i___c_r_y_p_t_o___c_o_n_t_e_x_t.html">IFAPI_CRYPTO_CONTEXT_BLOB</a> **&#160;</td>
    255. 

  255.           <td class="paramname"><em>context</em>, </td>
    256. 

  256.         </tr>
    257. 

  257.         <tr>
    258. 

  258.           <td class="paramkey"></td>
    259. 

  259.           <td></td>
    260. 

  260.           <td class="paramtype">uint8_t *&#160;</td>
    261. 

  261.           <td class="paramname"><em>digest</em>, </td>
    262. 

  262.         </tr>
    263. 

  263.         <tr>
    264. 

  264.           <td class="paramkey"></td>
    265. 

  265.           <td></td>
    266. 

  266.           <td class="paramtype">size_t *&#160;</td>
    267. 

  267.           <td class="paramname"><em>digestSize</em>&#160;</td>
    268. 

  268.         </tr>
    269. 

  269.         <tr>
    270. 

  270.           <td></td>
    271. 

  271.           <td>)</td>
    272. 

  272.           <td></td><td></td>
    273. 

  273.         </tr>
    274. 

  274.       </table>
    275. 

  275. </div><div class="memdoc">
    276. 

  276. <p>Gets the digest value from a hash context and closes it.</p>
    277. 

  277. <dl class="params"><dt>Parameters</dt><dd>
    278. 

  278.   <table class="params">
    279. 

  279.     <tr><td class="paramdir">[in,out]</td><td class="paramname">context</td><td>The hash context that is released </td></tr>
    280. 

  280.     <tr><td class="paramdir">[out]</td><td class="paramname">digest</td><td>The buffer for the digest value </td></tr>
    281. 

  281.     <tr><td class="paramdir">[out]</td><td class="paramname">digestSize</td><td>The size of digest in bytes. Can be NULL</td></tr>
    282. 

  282.   </table>
    283. 

  283.   </dd>
    284. 

  284. </dl>
    285. 

  285. <dl class="retval"><dt>Return values</dt><dd>
    286. 

  286.   <table class="retval">
    287. 

  287.     <tr><td class="paramname">TSS2_RC_SUCCESS</td><td>on success </td></tr>
    288. 

  288.     <tr><td class="paramname">TSS2_FAPI_RC_BAD_REFERENCE</td><td>if context or digest is NULL </td></tr>
    289. 

  289.     <tr><td class="paramname">TSS2_FAPI_RC_GENERAL_FAILURE</td><td>if an error occurs in the crypto library </td></tr>
    290. 

  290.   </table>
    291. 

  291.   </dd>
    292. 

  292. </dl>
    293. 

  293. 

  294. </div>
    295. 

  295. </div>
    296. 

  296. <a id="ga1bae9ed161278e58f8e39d70f110b046"></a>
    297. 

  297. <h2 class="memtitle"><span class="permalink"><a href="#ga1bae9ed161278e58f8e39d70f110b046">&#9670;&nbsp;</a></span>ifapi_crypto_hash_start()</h2>
    298. 

  298. 

  299. <div class="memitem">
    300. 

  300. <div class="memproto">
    301. 

  301.       <table class="memname">
    302. 

  302.         <tr>
    303. 

  303.           <td class="memname">TSS2_RC ifapi_crypto_hash_start </td>
    304. 

  304.           <td>(</td>
    305. 

  305.           <td class="paramtype"><a class="el" href="struct___i_f_a_p_i___c_r_y_p_t_o___c_o_n_t_e_x_t.html">IFAPI_CRYPTO_CONTEXT_BLOB</a> **&#160;</td>
    306. 

  306.           <td class="paramname"><em>context</em>, </td>
    307. 

  307.         </tr>
    308. 

  308.         <tr>
    309. 

  309.           <td class="paramkey"></td>
    310. 

  310.           <td></td>
    311. 

  311.           <td class="paramtype">TPM2_ALG_ID&#160;</td>
    312. 

  312.           <td class="paramname"><em>hashAlgorithm</em>&#160;</td>
    313. 

  313.         </tr>
    314. 

  314.         <tr>
    315. 

  315.           <td></td>
    316. 

  316.           <td>)</td>
    317. 

  317.           <td></td><td></td>
    318. 

  318.         </tr>
    319. 

  319.       </table>
    320. 

  320. </div><div class="memdoc">
    321. 

  321. <p>Starts the computation of a hash digest.</p>
    322. 

  322. <dl class="params"><dt>Parameters</dt><dd>
    323. 

  323.   <table class="params">
    324. 

  324.     <tr><td class="paramdir">[out]</td><td class="paramname">context</td><td>The created hash context (callee-allocated). </td></tr>
    325. 

  325.     <tr><td class="paramdir">[in]</td><td class="paramname">hashAlgorithm</td><td>The TSS hash identifier for the hash algorithm to use.</td></tr>
    326. 

  326.   </table>
    327. 

  327.   </dd>
    328. 

  328. </dl>
    329. 

  329. <dl class="retval"><dt>Return values</dt><dd>
    330. 

  330.   <table class="retval">
    331. 

  331.     <tr><td class="paramname">TSS2_RC_SUCCESS</td><td>on success. </td></tr>
    332. 

  332.     <tr><td class="paramname">TSS2_FAPI_RC_BAD_VALUE</td><td>if hashAlgorithm is invalid </td></tr>
    333. 

  333.     <tr><td class="paramname">TSS2_FAPI_RC_BAD_REFERENCE</td><td>if context is NULL </td></tr>
    334. 

  334.     <tr><td class="paramname">TSS2_FAPI_RC_MEMORY</td><td>if memory cannot be allocated </td></tr>
    335. 

  335.     <tr><td class="paramname">TSS2_FAPI_RC_GENERAL_FAILURE</td><td>if an error occurs in the crypto library </td></tr>
    336. 

  336.   </table>
    337. 

  337.   </dd>
    338. 

  338. </dl>
    339. 

  339. 

  340. </div>
    341. 

  341. </div>
    342. 

  342. <a id="gaf9c318cab007a23adef270f9c4a606b4"></a>
    343. 

  343. <h2 class="memtitle"><span class="permalink"><a href="#gaf9c318cab007a23adef270f9c4a606b4">&#9670;&nbsp;</a></span>ifapi_crypto_hash_update()</h2>
    344. 

  344. 

  345. <div class="memitem">
    346. 

  346. <div class="memproto">
    347. 

  347.       <table class="memname">
    348. 

  348.         <tr>
    349. 

  349.           <td class="memname">TSS2_RC ifapi_crypto_hash_update </td>
    350. 

  350.           <td>(</td>
    351. 

  351.           <td class="paramtype"><a class="el" href="struct___i_f_a_p_i___c_r_y_p_t_o___c_o_n_t_e_x_t.html">IFAPI_CRYPTO_CONTEXT_BLOB</a> *&#160;</td>
    352. 

  352.           <td class="paramname"><em>context</em>, </td>
    353. 

  353.         </tr>
    354. 

  354.         <tr>
    355. 

  355.           <td class="paramkey"></td>
    356. 

  356.           <td></td>
    357. 

  357.           <td class="paramtype">const uint8_t *&#160;</td>
    358. 

  358.           <td class="paramname"><em>buffer</em>, </td>
    359. 

  359.         </tr>
    360. 

  360.         <tr>
    361. 

  361.           <td class="paramkey"></td>
    362. 

  362.           <td></td>
    363. 

  363.           <td class="paramtype">size_t&#160;</td>
    364. 

  364.           <td class="paramname"><em>size</em>&#160;</td>
    365. 

  365.         </tr>
    366. 

  366.         <tr>
    367. 

  367.           <td></td>
    368. 

  368.           <td>)</td>
    369. 

  369.           <td></td><td></td>
    370. 

  370.         </tr>
    371. 

  371.       </table>
    372. 

  372. </div><div class="memdoc">
    373. 

  373. <p>Updates the digest value of a hash object with data from a byte buffer.</p>
    374. 

  374. <dl class="params"><dt>Parameters</dt><dd>
    375. 

  375.   <table class="params">
    376. 

  376.     <tr><td class="paramdir">[in,out]</td><td class="paramname">context</td><td>The hash context that will be updated </td></tr>
    377. 

  377.     <tr><td class="paramdir">[in]</td><td class="paramname">buffer</td><td>The data for the update </td></tr>
    378. 

  378.     <tr><td class="paramdir">[in]</td><td class="paramname">size</td><td>The size of data in bytes</td></tr>
    379. 

  379.   </table>
    380. 

  380.   </dd>
    381. 

  381. </dl>
    382. 

  382. <dl class="retval"><dt>Return values</dt><dd>
    383. 

  383.   <table class="retval">
    384. 

  384.     <tr><td class="paramname">TSS2_RC_SUCCESS</td><td>on success. </td></tr>
    385. 

  385.     <tr><td class="paramname">TSS2_FAPI_RC_BAD_REFERENCE</td><td>for invalid parameters. </td></tr>
    386. 

  386.     <tr><td class="paramname">TSS2_FAPI_RC_GENERAL_FAILURE</td><td>if an error occurs in the crypto library </td></tr>
    387. 

  387.   </table>
    388. 

  388.   </dd>
    389. 

  389. </dl>
    390. 

  390. 

  391. </div>
    392. 

  392. </div>
    393. 

  393. <a id="ga487ac222f6bd4074c34128627af14825"></a>
    394. 

  394. <h2 class="memtitle"><span class="permalink"><a href="#ga487ac222f6bd4074c34128627af14825">&#9670;&nbsp;</a></span>ifapi_der_sig_to_tpm()</h2>
    395. 

  395. 

  396. <div class="memitem">
    397. 

  397. <div class="memproto">
    398. 

  398.       <table class="memname">
    399. 

  399.         <tr>
    400. 

  400.           <td class="memname">TSS2_RC ifapi_der_sig_to_tpm </td>
    401. 

  401.           <td>(</td>
    402. 

  402.           <td class="paramtype">const TPMT_PUBLIC *&#160;</td>
    403. 

  403.           <td class="paramname"><em>tpmPublic</em>, </td>
    404. 

  404.         </tr>
    405. 

  405.         <tr>
    406. 

  406.           <td class="paramkey"></td>
    407. 

  407.           <td></td>
    408. 

  408.           <td class="paramtype">const unsigned char *&#160;</td>
    409. 

  409.           <td class="paramname"><em>signature</em>, </td>
    410. 

  410.         </tr>
    411. 

  411.         <tr>
    412. 

  412.           <td class="paramkey"></td>
    413. 

  413.           <td></td>
    414. 

  414.           <td class="paramtype">size_t&#160;</td>
    415. 

  415.           <td class="paramname"><em>signatureSize</em>, </td>
    416. 

  416.         </tr>
    417. 

  417.         <tr>
    418. 

  418.           <td class="paramkey"></td>
    419. 

  419.           <td></td>
    420. 

  420.           <td class="paramtype">TPMI_ALG_HASH&#160;</td>
    421. 

  421.           <td class="paramname"><em>hashAlgorithm</em>, </td>
    422. 

  422.         </tr>
    423. 

  423.         <tr>
    424. 

  424.           <td class="paramkey"></td>
    425. 

  425.           <td></td>
    426. 

  426.           <td class="paramtype">TPMT_SIGNATURE *&#160;</td>
    427. 

  427.           <td class="paramname"><em>tpmSignature</em>&#160;</td>
    428. 

  428.         </tr>
    429. 

  429.         <tr>
    430. 

  430.           <td></td>
    431. 

  431.           <td>)</td>
    432. 

  432.           <td></td><td></td>
    433. 

  433.         </tr>
    434. 

  434.       </table>
    435. 

  435. </div><div class="memdoc">
    436. 

  436. <p>Convert signature from DER to TPM format.</p>
    437. 

  437. <p>The signature in DER format is converted to TPM format to enable verification by the TPM.</p>
    438. 

  438. <dl class="params"><dt>Parameters</dt><dd>
    439. 

  439.   <table class="params">
    440. 

  440.     <tr><td class="paramdir">[in]</td><td class="paramname">tpmPublic</td><td>The public information of the signature key </td></tr>
    441. 

  441.     <tr><td class="paramdir">[in]</td><td class="paramname">signature</td><td>A byte buffer holding the DER encoded signature </td></tr>
    442. 

  442.     <tr><td class="paramdir">[in]</td><td class="paramname">signatureSize</td><td>The size of signature in bytes </td></tr>
    443. 

  443.     <tr><td class="paramdir">[in]</td><td class="paramname">hashAlgorithm</td><td>The TSS identifier for the hash algorithm used to compute the digest </td></tr>
    444. 

  444.     <tr><td class="paramdir">[out]</td><td class="paramname">tpmSignature</td><td>The signature in TPM format</td></tr>
    445. 

  445.   </table>
    446. 

  446.   </dd>
    447. 

  447. </dl>
    448. 

  448. <dl class="retval"><dt>Return values</dt><dd>
    449. 

  449.   <table class="retval">
    450. 

  450.     <tr><td class="paramname">TSS2_RC_SUCCESS</td><td>on success </td></tr>
    451. 

  451.     <tr><td class="paramname">TSS2_FAPI_RC_GENERAL_FAILURE</td><td>if an error occurs in the crypto library </td></tr>
    452. 

  452.     <tr><td class="paramname">TSS2_FAPI_RC_BAD_REFERENCE</td><td>if tpmPublic, signature or tpmSignature is NULL </td></tr>
    453. 

  453.     <tr><td class="paramname">TSS2_FAPI_RC_MEMORY</td><td>if memory could not be allocated </td></tr>
    454. 

  454.     <tr><td class="paramname">TSS2_FAPI_RC_BAD_VALUE</td><td>if an invalid value was passed into the function. </td></tr>
    455. 

  455.   </table>
    456. 

  456.   </dd>
    457. 

  457. </dl>
    458. 

  458. 

  459. </div>
    460. 

  460. </div>
    461. 

  461. <a id="gac56f0fce6cbb0ff4e4cba9c398f695df"></a>
    462. 

  462. <h2 class="memtitle"><span class="permalink"><a href="#gac56f0fce6cbb0ff4e4cba9c398f695df">&#9670;&nbsp;</a></span>ifapi_get_hash_alg_for_size()</h2>
    463. 

  463. 

  464. <div class="memitem">
    465. 

  465. <div class="memproto">
    466. 

  466.       <table class="memname">
    467. 

  467.         <tr>
    468. 

  468.           <td class="memname">TSS2_RC ifapi_get_hash_alg_for_size </td>
    469. 

  469.           <td>(</td>
    470. 

  470.           <td class="paramtype">uint16_t&#160;</td>
    471. 

  471.           <td class="paramname"><em>size</em>, </td>
    472. 

  472.         </tr>
    473. 

  473.         <tr>
    474. 

  474.           <td class="paramkey"></td>
    475. 

  475.           <td></td>
    476. 

  476.           <td class="paramtype">TPMI_ALG_HASH *&#160;</td>
    477. 

  477.           <td class="paramname"><em>hashAlgorithm</em>&#160;</td>
    478. 

  478.         </tr>
    479. 

  479.         <tr>
    480. 

  480.           <td></td>
    481. 

  481.           <td>)</td>
    482. 

  482.           <td></td><td></td>
    483. 

  483.         </tr>
    484. 

  484.       </table>
    485. 

  485. </div><div class="memdoc">
    486. 

  486. <p>Returns a suitable hash algorithm for a given digest size.</p>
    487. 

  487. <dl class="params"><dt>Parameters</dt><dd>
    488. 

  488.   <table class="params">
    489. 

  489.     <tr><td class="paramdir">[in]</td><td class="paramname">size</td><td>The size of the digest </td></tr>
    490. 

  490.     <tr><td class="paramdir">[out]</td><td class="paramname">hashAlgorithm</td><td>A suitable hash algorithm for the digest size</td></tr>
    491. 

  491.   </table>
    492. 

  492.   </dd>
    493. 

  493. </dl>
    494. 

  494. <dl class="retval"><dt>Return values</dt><dd>
    495. 

  495.   <table class="retval">
    496. 

  496.     <tr><td class="paramname">TSS2_RC_SUCCESS</td><td>on success </td></tr>
    497. 

  497.     <tr><td class="paramname">TSS2_FAPI_RC_BAD_REFERENCE</td><td>if hashAlgorithm is NULL </td></tr>
    498. 

  498.     <tr><td class="paramname">TSS2_FAPI_RC_BAD_VALUE</td><td>if the digest size is invalid </td></tr>
    499. 

  499.   </table>
    500. 

  500.   </dd>
    501. 

  501. </dl>
    502. 

  502. 

  503. </div>
    504. 

  504. </div>
    505. 

  505. <a id="gaa97941ce97a4bc07441db3cd6b7d47f6"></a>
    506. 

  506. <h2 class="memtitle"><span class="permalink"><a href="#gaa97941ce97a4bc07441db3cd6b7d47f6">&#9670;&nbsp;</a></span>ifapi_get_profile_sig_scheme()</h2>
    507. 

  507. 

  508. <div class="memitem">
    509. 

  509. <div class="memproto">
    510. 

  510.       <table class="memname">
    511. 

  511.         <tr>
    512. 

  512.           <td class="memname">TPM2_RC ifapi_get_profile_sig_scheme </td>
    513. 

  513.           <td>(</td>
    514. 

  514.           <td class="paramtype">const <a class="el" href="struct_i_f_a_p_i___p_r_o_f_i_l_e.html">IFAPI_PROFILE</a> *&#160;</td>
    515. 

  515.           <td class="paramname"><em>profile</em>, </td>
    516. 

  516.         </tr>
    517. 

  517.         <tr>
    518. 

  518.           <td class="paramkey"></td>
    519. 

  519.           <td></td>
    520. 

  520.           <td class="paramtype">const TPMT_PUBLIC *&#160;</td>
    521. 

  521.           <td class="paramname"><em>tpmPublic</em>, </td>
    522. 

  522.         </tr>
    523. 

  523.         <tr>
    524. 

  524.           <td class="paramkey"></td>
    525. 

  525.           <td></td>
    526. 

  526.           <td class="paramtype">TPMT_SIG_SCHEME *&#160;</td>
    527. 

  527.           <td class="paramname"><em>signatureScheme</em>&#160;</td>
    528. 

  528.         </tr>
    529. 

  529.         <tr>
    530. 

  530.           <td></td>
    531. 

  531.           <td>)</td>
    532. 

  532.           <td></td><td></td>
    533. 

  533.         </tr>
    534. 

  534.       </table>
    535. 

  535. </div><div class="memdoc">
    536. 

  536. <p>Returns the signature scheme that is currently used in the FAPI context.</p>
    537. 

  537. <dl class="params"><dt>Parameters</dt><dd>
    538. 

  538.   <table class="params">
    539. 

  539.     <tr><td class="paramdir">[in]</td><td class="paramname">profile</td><td>The FAPI profile from which the signing scheme is retrieved </td></tr>
    540. 

  540.     <tr><td class="paramdir">[in]</td><td class="paramname">tpmPublic</td><td>The public key for which the signing key is fetched from the FAPI </td></tr>
    541. 

  541.     <tr><td class="paramdir">[out]</td><td class="paramname">signatureScheme</td><td>The currently used signature scheme</td></tr>
    542. 

  542.   </table>
    543. 

  543.   </dd>
    544. 

  544. </dl>
    545. 

  545. <dl class="retval"><dt>Return values</dt><dd>
    546. 

  546.   <table class="retval">
    547. 

  547.     <tr><td class="paramname">TSS2_RC_SUCCESS</td><td>if the signature scheme was successfully fetched </td></tr>
    548. 

  548.     <tr><td class="paramname">TSS2_FAPI_RC_BAD_REFERENCE</td><td>if one of the parameters is NULL </td></tr>
    549. 

  549.     <tr><td class="paramname">TSS2_FAPI_RC_BAD_VALUE</td><td>if the key type is not TPM2_ALG_RSA or TPM2_ALG_ECC </td></tr>
    550. 

  550.   </table>
    551. 

  551.   </dd>
    552. 

  552. </dl>
    553. 

  553. 

  554. </div>
    555. 

  555. </div>
    556. 

  556. <a id="gaf713079ae0eaa00544909915b126e4b7"></a>
    557. 

  557. <h2 class="memtitle"><span class="permalink"><a href="#gaf713079ae0eaa00544909915b126e4b7">&#9670;&nbsp;</a></span>ifapi_get_public_from_pem_cert()</h2>
    558. 

  558. 

  559. <div class="memitem">
    560. 

  560. <div class="memproto">
    561. 

  561.       <table class="memname">
    562. 

  562.         <tr>
    563. 

  563.           <td class="memname">TSS2_RC ifapi_get_public_from_pem_cert </td>
    564. 

  564.           <td>(</td>
    565. 

  565.           <td class="paramtype">const char *&#160;</td>
    566. 

  566.           <td class="paramname"><em>pem_cert</em>, </td>
    567. 

  567.         </tr>
    568. 

  568.         <tr>
    569. 

  569.           <td class="paramkey"></td>
    570. 

  570.           <td></td>
    571. 

  571.           <td class="paramtype">TPM2B_PUBLIC *&#160;</td>
    572. 

  572.           <td class="paramname"><em>tpm_public</em>&#160;</td>
    573. 

  573.         </tr>
    574. 

  574.         <tr>
    575. 

  575.           <td></td>
    576. 

  576.           <td>)</td>
    577. 

  577.           <td></td><td></td>
    578. 

  578.         </tr>
    579. 

  579.       </table>
    580. 

  580. </div><div class="memdoc">
    581. 

  581. <p>Get public information for key of a pem certificate.</p>
    582. 

  582. <dl class="params"><dt>Parameters</dt><dd>
    583. 

  583.   <table class="params">
    584. 

  584.     <tr><td class="paramdir">[in]</td><td class="paramname">pem_cert</td><td>The pem certificate. </td></tr>
    585. 

  585.     <tr><td class="paramdir">[out]</td><td class="paramname">tpm_public</td><td>The public information of the key in TPM format.</td></tr>
    586. 

  586.   </table>
    587. 

  587.   </dd>
    588. 

  588. </dl>
    589. 

  589. <dl class="retval"><dt>Return values</dt><dd>
    590. 

  590.   <table class="retval">
    591. 

  591.     <tr><td class="paramname">TSS2_RC_SUCCESS</td><td>on success </td></tr>
    592. 

  592.     <tr><td class="paramname">TSS2_FAPI_RC_BAD_VALUE</td><td>if the conversion fails. </td></tr>
    593. 

  593.     <tr><td class="paramname">TSS2_FAPI_RC_GENERAL_FAILURE</td><td>if openssl errors occur. </td></tr>
    594. 

  594.     <tr><td class="paramname">TSS2_FAPI_RC_BAD_REFERENCE</td><td>a invalid null pointer is passed. </td></tr>
    595. 

  595.     <tr><td class="paramname">TSS2_FAPI_RC_MEMORY</td><td>if not enough memory can be allocated. </td></tr>
    596. 

  596.   </table>
    597. 

  597.   </dd>
    598. 

  598. </dl>
    599. 

  599. 

  600. </div>
    601. 

  601. </div>
    602. 

  602. <a id="ga2749271fc949a0587ea33fd35b20c651"></a>
    603. 

  603. <h2 class="memtitle"><span class="permalink"><a href="#ga2749271fc949a0587ea33fd35b20c651">&#9670;&nbsp;</a></span>ifapi_get_signature_algorithm_from_pem()</h2>
    604. 

  604. 

  605. <div class="memitem">
    606. 

  606. <div class="memproto">
    607. 

  607.       <table class="memname">
    608. 

  608.         <tr>
    609. 

  609.           <td class="memname">TPM2_ALG_ID ifapi_get_signature_algorithm_from_pem </td>
    610. 

  610.           <td>(</td>
    611. 

  611.           <td class="paramtype">const char *&#160;</td>
    612. 

  612.           <td class="paramname"><em>pemKey</em></td><td>)</td>
    613. 

  613.           <td></td>
    614. 

  614.         </tr>
    615. 

  615.       </table>
    616. 

  616. </div><div class="memdoc">
    617. 

  617. <p>Returns the TPM algorithm identifier that matches to the signature algorithm of a given PEM key.</p>
    618. 

  618. <dl class="params"><dt>Parameters</dt><dd>
    619. 

  619.   <table class="params">
    620. 

  620.     <tr><td class="paramdir">[in]</td><td class="paramname">pemKey</td><td>The public key from which the signature algorithm is retrieved</td></tr>
    621. 

  621.   </table>
    622. 

  622.   </dd>
    623. 

  623. </dl>
    624. 

  624. <dl class="retval"><dt>Return values</dt><dd>
    625. 

  625.   <table class="retval">
    626. 

  626.     <tr><td class="paramname">TPM2_ALG_RSA</td><td>if pemKey holds an RSA key </td></tr>
    627. 

  627.     <tr><td class="paramname">TPM2_ALG_ECC</td><td>if pemKey holds an ECC key </td></tr>
    628. 

  628.     <tr><td class="paramname">TPM2_ALG_ERROR</td><td>if the signature algorithm could not be determined </td></tr>
    629. 

  629.     <tr><td class="paramname">TSS2_FAPI_RC_BAD_REFERENCE</td><td>a invalid null pointer is passed. </td></tr>
    630. 

  630.     <tr><td class="paramname">TSS2_FAPI_RC_MEMORY</td><td>if not enough memory can be allocated. </td></tr>
    631. 

  631.     <tr><td class="paramname">TSS2_FAPI_RC_BAD_VALUE</td><td>if an invalid value was passed into the function. </td></tr>
    632. 

  632.   </table>
    633. 

  633.   </dd>
    634. 

  634. </dl>
    635. 

  635. 

  636. </div>
    637. 

  637. </div>
    638. 

  638. <a id="gaf0acb921826dd121e027f6a7ffe2e6ca"></a>
    639. 

  639. <h2 class="memtitle"><span class="permalink"><a href="#gaf0acb921826dd121e027f6a7ffe2e6ca">&#9670;&nbsp;</a></span>ifapi_get_tpm2b_public_from_pem()</h2>
    640. 

  640. 

  641. <div class="memitem">
    642. 

  642. <div class="memproto">
    643. 

  643.       <table class="memname">
    644. 

  644.         <tr>
    645. 

  645.           <td class="memname">TSS2_RC ifapi_get_tpm2b_public_from_pem </td>
    646. 

  646.           <td>(</td>
    647. 

  647.           <td class="paramtype">const char *&#160;</td>
    648. 

  648.           <td class="paramname"><em>pemKey</em>, </td>
    649. 

  649.         </tr>
    650. 

  650.         <tr>
    651. 

  651.           <td class="paramkey"></td>
    652. 

  652.           <td></td>
    653. 

  653.           <td class="paramtype">TPM2B_PUBLIC *&#160;</td>
    654. 

  654.           <td class="paramname"><em>tpmPublic</em>&#160;</td>
    655. 

  655.         </tr>
    656. 

  656.         <tr>
    657. 

  657.           <td></td>
    658. 

  658.           <td>)</td>
    659. 

  659.           <td></td><td></td>
    660. 

  660.         </tr>
    661. 

  661.       </table>
    662. 

  662. </div><div class="memdoc">
    663. 

  663. <p>Gets an object with the TPM-relevant public information of a PEM encoded public key. The information is gathered from the key itself and the currently used FAPI profile.</p>
    664. 

  664. <dl class="params"><dt>Parameters</dt><dd>
    665. 

  665.   <table class="params">
    666. 

  666.     <tr><td class="paramdir">[in]</td><td class="paramname">pemKey</td><td>A byte buffer holding the PEM encoded public key for which the public information is retrieved </td></tr>
    667. 

  667.     <tr><td class="paramdir">[out]</td><td class="paramname">tpmPublic</td><td>The public information of pemKey</td></tr>
    668. 

  668.   </table>
    669. 

  669.   </dd>
    670. 

  670. </dl>
    671. 

  671. <dl class="retval"><dt>Return values</dt><dd>
    672. 

  672.   <table class="retval">
    673. 

  673.     <tr><td class="paramname">TSS2_RC_SUCCESS</td><td>on success </td></tr>
    674. 

  674.     <tr><td class="paramname">TSS2_FAPI_RC_BAD_REFERENCE</td><td>if profile, pemKey or tpmPublic is NULL </td></tr>
    675. 

  675.     <tr><td class="paramname">TSS2_FAPI_RC_MEMORY</td><td>if memory could not be allocated </td></tr>
    676. 

  676.     <tr><td class="paramname">TSS2_FAPI_RC_GENERAL_FAILURE</td><td>if an error occurs in the crypto library </td></tr>
    677. 

  677.     <tr><td class="paramname">TSS2_FAPI_RC_BAD_VALUE</td><td>if an invalid value was passed into the function. </td></tr>
    678. 

  678.   </table>
    679. 

  679.   </dd>
    680. 

  680. </dl>
    681. 

  681. 

  682. </div>
    683. 

  683. </div>
    684. 

  684. <a id="ga30a2dbc9555d38d2cc07ae8039d52d42"></a>
    685. 

  685. <h2 class="memtitle"><span class="permalink"><a href="#ga30a2dbc9555d38d2cc07ae8039d52d42">&#9670;&nbsp;</a></span>ifapi_get_tpm_key_fingerprint()</h2>
    686. 

  686. 

  687. <div class="memitem">
    688. 

  688. <div class="memproto">
    689. 

  689.       <table class="memname">
    690. 

  690.         <tr>
    691. 

  691.           <td class="memname">TSS2_RC ifapi_get_tpm_key_fingerprint </td>
    692. 

  692.           <td>(</td>
    693. 

  693.           <td class="paramtype">const TPM2B_PUBLIC *&#160;</td>
    694. 

  694.           <td class="paramname"><em>tpmPublicKey</em>, </td>
    695. 

  695.         </tr>
    696. 

  696.         <tr>
    697. 

  697.           <td class="paramkey"></td>
    698. 

  698.           <td></td>
    699. 

  699.           <td class="paramtype">TPMI_ALG_HASH&#160;</td>
    700. 

  700.           <td class="paramname"><em>hashAlg</em>, </td>
    701. 

  701.         </tr>
    702. 

  702.         <tr>
    703. 

  703.           <td class="paramkey"></td>
    704. 

  704.           <td></td>
    705. 

  705.           <td class="paramtype">TPM2B_DIGEST *&#160;</td>
    706. 

  706.           <td class="paramname"><em>fingerprint</em>&#160;</td>
    707. 

  707.         </tr>
    708. 

  708.         <tr>
    709. 

  709.           <td></td>
    710. 

  710.           <td>)</td>
    711. 

  711.           <td></td><td></td>
    712. 

  712.         </tr>
    713. 

  713.       </table>
    714. 

  714. </div><div class="memdoc">
    715. 

  715. <p>Compute the fingerprint of a TPM public key.</p>
    716. 

  716. <dl class="params"><dt>Parameters</dt><dd>
    717. 

  717.   <table class="params">
    718. 

  718.     <tr><td class="paramdir">[in]</td><td class="paramname">tpmPublicKey</td><td>The public key created by the TPM </td></tr>
    719. 

  719.     <tr><td class="paramdir">[in]</td><td class="paramname">hashAlg</td><td>The hash algorithm used for fingerprint computation. </td></tr>
    720. 

  720.     <tr><td class="paramdir">[out]</td><td class="paramname">fingerprint</td><td>The fingerprint digest.</td></tr>
    721. 

  721.   </table>
    722. 

  722.   </dd>
    723. 

  723. </dl>
    724. 

  724. <dl class="retval"><dt>Return values</dt><dd>
    725. 

  725.   <table class="retval">
    726. 

  726.     <tr><td class="paramname">TSS2_RC_SUCCESS</td><td>on success </td></tr>
    727. 

  727.     <tr><td class="paramname">TSS2_FAPI_RC_GENERAL_FAILURE</td><td>if an error occurs in the crypto library </td></tr>
    728. 

  728.     <tr><td class="paramname">TSS2_FAPI_RC_MEMORY</td><td>if memory could not be allocated </td></tr>
    729. 

  729.     <tr><td class="paramname">TSS2_FAPI_BAD_REFERENCE</td><td>if tpmPublicKey or pemKeySize are NULL </td></tr>
    730. 

  730.     <tr><td class="paramname">TSS2_FAPI_RC_BAD_REFERENCE</td><td>a invalid null pointer is passed. </td></tr>
    731. 

  731.     <tr><td class="paramname">TSS2_FAPI_RC_BAD_VALUE</td><td>if an invalid value was passed into the function. </td></tr>
    732. 

  732.   </table>
    733. 

  733.   </dd>
    734. 

  734. </dl>
    735. 

  735. 

  736. </div>
    737. 

  737. </div>
    738. 

  738. <a id="ga817996f764dc590b0fcde8b2479ebd14"></a>
    739. 

  739. <h2 class="memtitle"><span class="permalink"><a href="#ga817996f764dc590b0fcde8b2479ebd14">&#9670;&nbsp;</a></span>ifapi_hash_get_digest_size()</h2>
    740. 

  740. 

  741. <div class="memitem">
    742. 

  742. <div class="memproto">
    743. 

  743.       <table class="memname">
    744. 

  744.         <tr>
    745. 

  745.           <td class="memname">size_t ifapi_hash_get_digest_size </td>
    746. 

  746.           <td>(</td>
    747. 

  747.           <td class="paramtype">TPM2_ALG_ID&#160;</td>
    748. 

  748.           <td class="paramname"><em>hashAlgorithm</em></td><td>)</td>
    749. 

  749.           <td></td>
    750. 

  750.         </tr>
    751. 

  751.       </table>
    752. 

  752. </div><div class="memdoc">
    753. 

  753. <p>Returns the digest size of a given hash algorithm.</p>
    754. 

  754. <dl class="params"><dt>Parameters</dt><dd>
    755. 

  755.   <table class="params">
    756. 

  756.     <tr><td class="paramdir">[in]</td><td class="paramname">hashAlgorithm</td><td>The TSS identifier of the hash algorithm</td></tr>
    757. 

  757.   </table>
    758. 

  758.   </dd>
    759. 

  759. </dl>
    760. 

  760. <dl class="section return"><dt>Returns</dt><dd>The size of the digest produced by the hash algorithm if hashAlgorithm is valid </dd></dl>
    761. 

  761. <dl class="retval"><dt>Return values</dt><dd>
    762. 

  762.   <table class="retval">
    763. 

  763.     <tr><td class="paramname">0</td><td>if hashAlgorithm is invalid </td></tr>
    764. 

  764.   </table>
    765. 

  765.   </dd>
    766. 

  766. </dl>
    767. 

  767. 

  768. </div>
    769. 

  769. </div>
    770. 

  770. <a id="gaca515b7a38f631d79c814709f8506e0e"></a>
    771. 

  771. <h2 class="memtitle"><span class="permalink"><a href="#gaca515b7a38f631d79c814709f8506e0e">&#9670;&nbsp;</a></span>ifapi_initialize_sign_public()</h2>
    772. 

  772. 

  773. <div class="memitem">
    774. 

  774. <div class="memproto">
    775. 

  775.       <table class="memname">
    776. 

  776.         <tr>
    777. 

  777.           <td class="memname">TSS2_RC ifapi_initialize_sign_public </td>
    778. 

  778.           <td>(</td>
    779. 

  779.           <td class="paramtype">TPM2_ALG_ID&#160;</td>
    780. 

  780.           <td class="paramname"><em>signatureAlgorithm</em>, </td>
    781. 

  781.         </tr>
    782. 

  782.         <tr>
    783. 

  783.           <td class="paramkey"></td>
    784. 

  784.           <td></td>
    785. 

  785.           <td class="paramtype">TPM2B_PUBLIC *&#160;</td>
    786. 

  786.           <td class="paramname"><em>public</em>&#160;</td>
    787. 

  787.         </tr>
    788. 

  788.         <tr>
    789. 

  789.           <td></td>
    790. 

  790.           <td>)</td>
    791. 

  791.           <td></td><td></td>
    792. 

  792.         </tr>
    793. 

  793.       </table>
    794. 

  794. </div><div class="memdoc">
    795. 

  795. <p>Initializes a FAPI key template for a given signature algorithm.</p>
    796. 

  796. <dl class="params"><dt>Parameters</dt><dd>
    797. 

  797.   <table class="params">
    798. 

  798.     <tr><td class="paramdir">[in]</td><td class="paramname">signatureAlgorithm</td><td>The signature algorithm to use. Must be TPM2_ALG_RSA or TPM2_ALG_ECC </td></tr>
    799. 

  799.     <tr><td class="paramdir">[out]</td><td class="paramname">public</td><td>The template to initialize</td></tr>
    800. 

  800.   </table>
    801. 

  801.   </dd>
    802. 

  802. </dl>
    803. 

  803. <dl class="retval"><dt>Return values</dt><dd>
    804. 

  804.   <table class="retval">
    805. 

  805.     <tr><td class="paramname">TSS2_RC_SUCCESS</td><td>on success </td></tr>
    806. 

  806.     <tr><td class="paramname">TSS2_FAPI_RC_BAD_REFERENCE</td><td>if template is NULL </td></tr>
    807. 

  807.     <tr><td class="paramname">TSS2_FAPI_RC_BAD_VALUE</td><td>if signatureAlgorithm is not TPM2_ALG_RSA or TPM2_ALG_ECC </td></tr>
    808. 

  808.   </table>
    809. 

  809.   </dd>
    810. 

  810. </dl>
    811. 

  811. 

  812. </div>
    813. 

  813. </div>
    814. 

  814. <a id="ga67cac597edb51e7aeab416e3b3d46194"></a>
    815. 

  815. <h2 class="memtitle"><span class="permalink"><a href="#ga67cac597edb51e7aeab416e3b3d46194">&#9670;&nbsp;</a></span>ifapi_pub_pem_key_from_tpm()</h2>
    816. 

  816. 

  817. <div class="memitem">
    818. 

  818. <div class="memproto">
    819. 

  819.       <table class="memname">
    820. 

  820.         <tr>
    821. 

  821.           <td class="memname">TSS2_RC ifapi_pub_pem_key_from_tpm </td>
    822. 

  822.           <td>(</td>
    823. 

  823.           <td class="paramtype">const TPM2B_PUBLIC *&#160;</td>
    824. 

  824.           <td class="paramname"><em>tpmPublicKey</em>, </td>
    825. 

  825.         </tr>
    826. 

  826.         <tr>
    827. 

  827.           <td class="paramkey"></td>
    828. 

  828.           <td></td>
    829. 

  829.           <td class="paramtype">char **&#160;</td>
    830. 

  830.           <td class="paramname"><em>pemKey</em>, </td>
    831. 

  831.         </tr>
    832. 

  832.         <tr>
    833. 

  833.           <td class="paramkey"></td>
    834. 

  834.           <td></td>
    835. 

  835.           <td class="paramtype">int *&#160;</td>
    836. 

  836.           <td class="paramname"><em>pemKeySize</em>&#160;</td>
    837. 

  837.         </tr>
    838. 

  838.         <tr>
    839. 

  839.           <td></td>
    840. 

  840.           <td>)</td>
    841. 

  841.           <td></td><td></td>
    842. 

  842.         </tr>
    843. 

  843.       </table>
    844. 

  844. </div><div class="memdoc">
    845. 

  845. <p>Convert a TPM public key into a PEM formatted byte buffer. This can be used by TLS libraries.</p>
    846. 

  846. <dl class="params"><dt>Parameters</dt><dd>
    847. 

  847.   <table class="params">
    848. 

  848.     <tr><td class="paramdir">[in]</td><td class="paramname">tpmPublicKey</td><td>The public key created by the TPM </td></tr>
    849. 

  849.     <tr><td class="paramdir">[out]</td><td class="paramname">pemKey</td><td>A byte buffer that will hold the PEM representation of the public key (callee allocated) </td></tr>
    850. 

  850.     <tr><td class="paramdir">[out]</td><td class="paramname">pemKeySize</td><td>The size of pemKey in bytes</td></tr>
    851. 

  851.   </table>
    852. 

  852.   </dd>
    853. 

  853. </dl>
    854. 

  854. <dl class="retval"><dt>Return values</dt><dd>
    855. 

  855.   <table class="retval">
    856. 

  856.     <tr><td class="paramname">TSS2_RC_SUCCESS</td><td>on success </td></tr>
    857. 

  857.     <tr><td class="paramname">TSS2_FAPI_RC_GENERAL_FAILURE</td><td>if an error occurs in the crypto library </td></tr>
    858. 

  858.     <tr><td class="paramname">TSS2_FAPI_RC_MEMORY</td><td>if memory could not be allocated </td></tr>
    859. 

  859.     <tr><td class="paramname">TSS2_FAPI_BAD_REFERENCE</td><td>if tpmPublicKey or pemKeySize are NULL </td></tr>
    860. 

  860.     <tr><td class="paramname">TSS2_FAPI_RC_BAD_REFERENCE</td><td>a invalid null pointer is passed. </td></tr>
    861. 

  861.     <tr><td class="paramname">TSS2_FAPI_RC_BAD_VALUE</td><td>if an invalid value was passed into the function. </td></tr>
    862. 

  862.   </table>
    863. 

  863.   </dd>
    864. 

  864. </dl>
    865. 

  865. 

  866. </div>
    867. 

  867. </div>
    868. 

  868. <a id="ga48d5eaba0929c2509a637e7e6a35990d"></a>
    869. 

  869. <h2 class="memtitle"><span class="permalink"><a href="#ga48d5eaba0929c2509a637e7e6a35990d">&#9670;&nbsp;</a></span>ifapi_tpm_ecc_sig_to_der()</h2>
    870. 

  870. 

  871. <div class="memitem">
    872. 

  872. <div class="memproto">
    873. 

  873.       <table class="memname">
    874. 

  874.         <tr>
    875. 

  875.           <td class="memname">TSS2_RC ifapi_tpm_ecc_sig_to_der </td>
    876. 

  876.           <td>(</td>
    877. 

  877.           <td class="paramtype">const TPMT_SIGNATURE *&#160;</td>
    878. 

  878.           <td class="paramname"><em>tpmSignature</em>, </td>
    879. 

  879.         </tr>
    880. 

  880.         <tr>
    881. 

  881.           <td class="paramkey"></td>
    882. 

  882.           <td></td>
    883. 

  883.           <td class="paramtype">uint8_t **&#160;</td>
    884. 

  884.           <td class="paramname"><em>signature</em>, </td>
    885. 

  885.         </tr>
    886. 

  886.         <tr>
    887. 

  887.           <td class="paramkey"></td>
    888. 

  888.           <td></td>
    889. 

  889.           <td class="paramtype">size_t *&#160;</td>
    890. 

  890.           <td class="paramname"><em>signatureSize</em>&#160;</td>
    891. 

  891.         </tr>
    892. 

  892.         <tr>
    893. 

  893.           <td></td>
    894. 

  894.           <td>)</td>
    895. 

  895.           <td></td><td></td>
    896. 

  896.         </tr>
    897. 

  897.       </table>
    898. 

  898. </div><div class="memdoc">
    899. 

  899. <p>Convert a TPM ECDSA signature into a DER formatted byte buffer. This can be used by TLS libraries.</p>
    900. 

  900. <dl class="params"><dt>Parameters</dt><dd>
    901. 

  901.   <table class="params">
    902. 

  902.     <tr><td class="paramdir">[in]</td><td class="paramname">tpmSignature</td><td>The signature created by the TPM </td></tr>
    903. 

  903.     <tr><td class="paramdir">[out]</td><td class="paramname">signature</td><td>A byte buffer that will hold the DER representation of the signature (callee allocated) </td></tr>
    904. 

  904.     <tr><td class="paramdir">[out]</td><td class="paramname">signatureSize</td><td>The size of signature in bytes. May be NULL</td></tr>
    905. 

  905.   </table>
    906. 

  906.   </dd>
    907. 

  907. </dl>
    908. 

  908. <dl class="retval"><dt>Return values</dt><dd>
    909. 

  909.   <table class="retval">
    910. 

  910.     <tr><td class="paramname">TSS2_RC_SUCCESS</td><td>on success </td></tr>
    911. 

  911.     <tr><td class="paramname">TSS2_FAPI_RC_BAD_REFERENCE</td><td>if tpmSignature is NULL </td></tr>
    912. 

  912.     <tr><td class="paramname">TSS2_FAPI_RC_MEMORY</td><td>if memory could not be allocated </td></tr>
    913. 

  913.     <tr><td class="paramname">TSS2_FAPI_RC_GENERAL_FAILURE</td><td>if an error occurs in the crypto library </td></tr>
    914. 

  914.   </table>
    915. 

  915.   </dd>
    916. 

  916. </dl>
    917. 

  917. 

  918. </div>
    919. 

  919. </div>
    920. 

  920. <a id="gaad2a4c24b2a55638bcb84fca8b5fc2f6"></a>
    921. 

  921. <h2 class="memtitle"><span class="permalink"><a href="#gaad2a4c24b2a55638bcb84fca8b5fc2f6">&#9670;&nbsp;</a></span>ifapi_verify_ek_cert()</h2>
    922. 

  922. 

  923. <div class="memitem">
    924. 

  924. <div class="memproto">
    925. 

  925.       <table class="memname">
    926. 

  926.         <tr>
    927. 

  927.           <td class="memname">TSS2_RC ifapi_verify_ek_cert </td>
    928. 

  928.           <td>(</td>
    929. 

  929.           <td class="paramtype">char *&#160;</td>
    930. 

  930.           <td class="paramname"><em>root_cert_pem</em>, </td>
    931. 

  931.         </tr>
    932. 

  932.         <tr>
    933. 

  933.           <td class="paramkey"></td>
    934. 

  934.           <td></td>
    935. 

  935.           <td class="paramtype">char *&#160;</td>
    936. 

  936.           <td class="paramname"><em>intermed_cert_pem</em>, </td>
    937. 

  937.         </tr>
    938. 

  938.         <tr>
    939. 

  939.           <td class="paramkey"></td>
    940. 

  940.           <td></td>
    941. 

  941.           <td class="paramtype">char *&#160;</td>
    942. 

  942.           <td class="paramname"><em>ek_cert_pem</em>&#160;</td>
    943. 

  943.         </tr>
    944. 

  944.         <tr>
    945. 

  945.           <td></td>
    946. 

  946.           <td>)</td>
    947. 

  947.           <td></td><td></td>
    948. 

  948.         </tr>
    949. 

  949.       </table>
    950. 

  950. </div><div class="memdoc">
    951. 

  951. <p>Verify EK certificate read from TPM.</p>
    952. 

  952. <dl class="params"><dt>Parameters</dt><dd>
    953. 

  953.   <table class="params">
    954. 

  954.     <tr><td class="paramdir">[in]</td><td class="paramname">root_cert_pem</td><td>The vendor root certificate. </td></tr>
    955. 

  955.     <tr><td class="paramdir">[in]</td><td class="paramname">intermed_cert_pem</td><td>The vendor intermediate certificate. </td></tr>
    956. 

  956.     <tr><td class="paramdir">[in]</td><td class="paramname">ek_cert_pem</td><td>The ek certificate from TPM.</td></tr>
    957. 

  957.   </table>
    958. 

  958.   </dd>
    959. 

  959. </dl>
    960. 

  960. <dl class="retval"><dt>Return values</dt><dd>
    961. 

  961.   <table class="retval">
    962. 

  962.     <tr><td class="paramname">TSS2_RC_SUCCESS</td><td>on success </td></tr>
    963. 

  963.     <tr><td class="paramname">TSS2_FAPI_RC_BAD_VALUE</td><td>if the verification was no successful. </td></tr>
    964. 

  964.     <tr><td class="paramname">TSS2_FAPI_RC_NO_CERT</td><td>if an error did occur during certificate downloading. </td></tr>
    965. 

  965.     <tr><td class="paramname">TSS2_FAPI_RC_GENERAL_FAILURE</td><td>if an internal error occurred. </td></tr>
    966. 

  966.     <tr><td class="paramname">TSS2_FAPI_RC_MEMORY</td><td>if not enough memory can be allocated. </td></tr>
    967. 

  967.   </table>
    968. 

  968.   </dd>
    969. 

  969. </dl>
    970. 

  970. 

  971. </div>
    972. 

  972. </div>
    973. 

  973. <a id="gae1b2637abec3a461a863360c0e76cc35"></a>
    974. 

  974. <h2 class="memtitle"><span class="permalink"><a href="#gae1b2637abec3a461a863360c0e76cc35">&#9670;&nbsp;</a></span>ifapi_verify_signature()</h2>
    975. 

  975. 

  976. <div class="memitem">
    977. 

  977. <div class="memproto">
    978. 

  978.       <table class="memname">
    979. 

  979.         <tr>
    980. 

  980.           <td class="memname">TSS2_RC ifapi_verify_signature </td>
    981. 

  981.           <td>(</td>
    982. 

  982.           <td class="paramtype">const <a class="el" href="struct___i_f_a_p_i___o_b_j_e_c_t.html">IFAPI_OBJECT</a> *&#160;</td>
    983. 

  983.           <td class="paramname"><em>keyObject</em>, </td>
    984. 

  984.         </tr>
    985. 

  985.         <tr>
    986. 

  986.           <td class="paramkey"></td>
    987. 

  987.           <td></td>
    988. 

  988.           <td class="paramtype">const uint8_t *&#160;</td>
    989. 

  989.           <td class="paramname"><em>signature</em>, </td>
    990. 

  990.         </tr>
    991. 

  991.         <tr>
    992. 

  992.           <td class="paramkey"></td>
    993. 

  993.           <td></td>
    994. 

  994.           <td class="paramtype">size_t&#160;</td>
    995. 

  995.           <td class="paramname"><em>signatureSize</em>, </td>
    996. 

  996.         </tr>
    997. 

  997.         <tr>
    998. 

  998.           <td class="paramkey"></td>
    999. 

  999.           <td></td>
    1000. 

  1000.           <td class="paramtype">const uint8_t *&#160;</td>
    1001. 

  1001.           <td class="paramname"><em>digest</em>, </td>
    1002. 

  1002.         </tr>
    1003. 

  1003.         <tr>
    1004. 

  1004.           <td class="paramkey"></td>
    1005. 

  1005.           <td></td>
    1006. 

  1006.           <td class="paramtype">size_t&#160;</td>
    1007. 

  1007.           <td class="paramname"><em>digestSize</em>&#160;</td>
    1008. 

  1008.         </tr>
    1009. 

  1009.         <tr>
    1010. 

  1010.           <td></td>
    1011. 

  1011.           <td>)</td>
    1012. 

  1012.           <td></td><td></td>
    1013. 

  1013.         </tr>
    1014. 

  1014.       </table>
    1015. 

  1015. </div><div class="memdoc">
    1016. 

  1016. <p>Verifies a signature using a given FAPI public key.</p>
    1017. 

  1017. <dl class="params"><dt>Parameters</dt><dd>
    1018. 

  1018.   <table class="params">
    1019. 

  1019.     <tr><td class="paramdir">[in]</td><td class="paramname">keyObject</td><td>The FAPI public key used for verification </td></tr>
    1020. 

  1020.     <tr><td class="paramdir">[in]</td><td class="paramname">signature</td><td>The signature to verify </td></tr>
    1021. 

  1021.     <tr><td class="paramdir">[in]</td><td class="paramname">signatureSize</td><td>The size of signature in bytes </td></tr>
    1022. 

  1022.     <tr><td class="paramdir">[in]</td><td class="paramname">digest</td><td>The digest of the signature </td></tr>
    1023. 

  1023.     <tr><td class="paramdir">[in]</td><td class="paramname">digestSize</td><td>The size of digest in bytes</td></tr>
    1024. 

  1024.   </table>
    1025. 

  1025.   </dd>
    1026. 

  1026. </dl>
    1027. 

  1027. <dl class="retval"><dt>Return values</dt><dd>
    1028. 

  1028.   <table class="retval">
    1029. 

  1029.     <tr><td class="paramname">TSS2_RC_SUCCESS</td><td>In case of success </td></tr>
    1030. 

  1030.     <tr><td class="paramname">TSS2_FAPI_RC_BAD_REFERENCE</td><td>if keyObject, signature or digest is NULL </td></tr>
    1031. 

  1031.     <tr><td class="paramname">TSS2_FAPI_RC_BAD_VALUE</td><td>if the type of the key is wrong </td></tr>
    1032. 

  1032.     <tr><td class="paramname">TSS2_FAPI_RC_MEMORY</td><td>if memory could not be allocated </td></tr>
    1033. 

  1033.     <tr><td class="paramname">TSS2_FAPI_RC_GENERAL_FAILURE</td><td>if an error occurs in the crypto library </td></tr>
    1034. 

  1034.     <tr><td class="paramname">TSS2_FAPI_RC_SIGNATURE_VERIFICATION_FAILED</td><td>if the verification of the signature fails </td></tr>
    1035. 

  1035.   </table>
    1036. 

  1036.   </dd>
    1037. 

  1037. </dl>
    1038. 

  1038. 

  1039. </div>
    1040. 

  1040. </div>
    1041. 

  1041. <a id="gaf974aab23bced5dd22e422b5ad5cbb51"></a>
    1042. 

  1042. <h2 class="memtitle"><span class="permalink"><a href="#gaf974aab23bced5dd22e422b5ad5cbb51">&#9670;&nbsp;</a></span>ifapi_verify_signature_quote()</h2>
    1043. 

  1043. 

  1044. <div class="memitem">
    1045. 

  1045. <div class="memproto">
    1046. 

  1046.       <table class="memname">
    1047. 

  1047.         <tr>
    1048. 

  1048.           <td class="memname">TSS2_RC ifapi_verify_signature_quote </td>
    1049. 

  1049.           <td>(</td>
    1050. 

  1050.           <td class="paramtype">const <a class="el" href="struct___i_f_a_p_i___o_b_j_e_c_t.html">IFAPI_OBJECT</a> *&#160;</td>
    1051. 

  1051.           <td class="paramname"><em>keyObject</em>, </td>
    1052. 

  1052.         </tr>
    1053. 

  1053.         <tr>
    1054. 

  1054.           <td class="paramkey"></td>
    1055. 

  1055.           <td></td>
    1056. 

  1056.           <td class="paramtype">const uint8_t *&#160;</td>
    1057. 

  1057.           <td class="paramname"><em>signature</em>, </td>
    1058. 

  1058.         </tr>
    1059. 

  1059.         <tr>
    1060. 

  1060.           <td class="paramkey"></td>
    1061. 

  1061.           <td></td>
    1062. 

  1062.           <td class="paramtype">size_t&#160;</td>
    1063. 

  1063.           <td class="paramname"><em>signatureSize</em>, </td>
    1064. 

  1064.         </tr>
    1065. 

  1065.         <tr>
    1066. 

  1066.           <td class="paramkey"></td>
    1067. 

  1067.           <td></td>
    1068. 

  1068.           <td class="paramtype">const uint8_t *&#160;</td>
    1069. 

  1069.           <td class="paramname"><em>digest</em>, </td>
    1070. 

  1070.         </tr>
    1071. 

  1071.         <tr>
    1072. 

  1072.           <td class="paramkey"></td>
    1073. 

  1073.           <td></td>
    1074. 

  1074.           <td class="paramtype">size_t&#160;</td>
    1075. 

  1075.           <td class="paramname"><em>digestSize</em>, </td>
    1076. 

  1076.         </tr>
    1077. 

  1077.         <tr>
    1078. 

  1078.           <td class="paramkey"></td>
    1079. 

  1079.           <td></td>
    1080. 

  1080.           <td class="paramtype">const TPMT_SIG_SCHEME *&#160;</td>
    1081. 

  1081.           <td class="paramname"><em>signatureScheme</em>&#160;</td>
    1082. 

  1082.         </tr>
    1083. 

  1083.         <tr>
    1084. 

  1084.           <td></td>
    1085. 

  1085.           <td>)</td>
    1086. 

  1086.           <td></td><td></td>
    1087. 

  1087.         </tr>
    1088. 

  1088.       </table>
    1089. 

  1089. </div><div class="memdoc">
    1090. 

  1090. <p>Verifies the signature created by a Quote command.</p>
    1091. 

  1091. <dl class="params"><dt>Parameters</dt><dd>
    1092. 

  1092.   <table class="params">
    1093. 

  1093.     <tr><td class="paramdir">[in]</td><td class="paramname">keyObject</td><td>A FAPI key with which the signature is verified </td></tr>
    1094. 

  1094.     <tr><td class="paramdir">[in]</td><td class="paramname">signature</td><td>A byte buffer holding the signature </td></tr>
    1095. 

  1095.     <tr><td class="paramdir">[in]</td><td class="paramname">signatureSize</td><td>The size of signature in bytes </td></tr>
    1096. 

  1096.     <tr><td class="paramdir">[in]</td><td class="paramname">digest</td><td>The digest of the signature </td></tr>
    1097. 

  1097.     <tr><td class="paramdir">[in]</td><td class="paramname">digestSize</td><td>The size of digest in bytes </td></tr>
    1098. 

  1098.     <tr><td class="paramdir">[in]</td><td class="paramname">signatureScheme</td><td>The signature scheme</td></tr>
    1099. 

  1099.   </table>
    1100. 

  1100.   </dd>
    1101. 

  1101. </dl>
    1102. 

  1102. <dl class="retval"><dt>Return values</dt><dd>
    1103. 

  1103.   <table class="retval">
    1104. 

  1104.     <tr><td class="paramname">TSS2_RC_SUCCESS</td><td>on success </td></tr>
    1105. 

  1105.     <tr><td class="paramname">TSS2_FAPI_RC_BAD_REFERENCE</td><td>if keyObject, signature, digest or signatureScheme is NULL </td></tr>
    1106. 

  1106.     <tr><td class="paramname">TSS2_FAPI_RC_MEMORY</td><td>if memory could not be allocated </td></tr>
    1107. 

  1107.     <tr><td class="paramname">TSS2_FAPI_RC_BAD_VALUE</td><td>if the PEM encoded key could not be decoded </td></tr>
    1108. 

  1108.     <tr><td class="paramname">TSS2_FAPI_RC_GENERAL_FAILURE</td><td>if an error occurs in the crypto library </td></tr>
    1109. 

  1109.     <tr><td class="paramname">TSS2_FAPI_RC_SIGNATURE_VERIFICATION_FAILED</td><td>if the verification of the signature fails </td></tr>
    1110. 

  1110.   </table>
    1111. 

  1111.   </dd>
    1112. 

  1112. </dl>
    1113. 

  1113. 

  1114. </div>
    1115. 

  1115. </div>
    1116. 

  1116. </div><!-- contents -->
    1117. 

  1117. </div><!-- doc-content -->
    1118. 

  1118. <!-- start footer part -->
    1119. 

  1119. <div id="nav-path" class="navpath"><!-- id is needed for treeview function! -->
    1120. 

  1120.   <ul>
    1121. 

  1121.     <li class="footer">Generated by
    1122. 

  1122.     <a href="http://www.doxygen.org/index.html">
    1123. 

  1123.     <img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.8.13 </li>
    1124. 

  1124.   </ul>
    1125. 

  1125. </div>
    1126. 

  1126. </body>
    1127. 

  1127. </html>
    1128.