首頁 探索 說明
登入
SoftwareDesign
/
csu3_am335x
8
0
複刻 0
檔案 問題管理 0 合併請求 0 Wiki
分支: master
分支列表 標籤列表
csu3_am335x
/
EVSE
/
GPL
/
tpm2-tss-3.2.0
/
doxygen-doc
/
html
/
group__iesys__crypto.html

group__iesys__crypto.html 68 KB
永久連結 文件歷史 原始文件

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417 
  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__iesys__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__esys.html">Enhanced System API</a> &raquo; <a class="el" href="group__iesys.html">Internals of Enhanced System 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:gaecbc62627049d1806648c9ecf8a52196"><td class="memItemLeft" align="right" valign="top">TSS2_RC&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__iesys__crypto.html#gaecbc62627049d1806648c9ecf8a52196">iesys_crypto_hash_get_digest_size</a> (TPM2_ALG_ID hashAlg, size_t *size)</td></tr>
    73. 

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

  74. <tr class="memitem:ga8a00762587e4d99700ad80ad448922b6"><td class="memItemLeft" align="right" valign="top">TSS2_RC&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__iesys__crypto.html#ga8a00762587e4d99700ad80ad448922b6">iesys_cryptossl_hash_start</a> (<a class="el" href="struct___i_e_s_y_s___c_r_y_p_t_o___c_o_n_t_e_x_t.html">IESYS_CRYPTO_CONTEXT_BLOB</a> **context, TPM2_ALG_ID hashAlg)</td></tr>
    75. 

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

  76. <tr class="memitem:ga7db67b4e462804deb312b578dd7d23b3"><td class="memItemLeft" align="right" valign="top">TSS2_RC&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__iesys__crypto.html#ga7db67b4e462804deb312b578dd7d23b3">iesys_cryptossl_hash_update</a> (<a class="el" href="struct___i_e_s_y_s___c_r_y_p_t_o___c_o_n_t_e_x_t.html">IESYS_CRYPTO_CONTEXT_BLOB</a> *context, const uint8_t *buffer, size_t size)</td></tr>
    77. 

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

  78. <tr class="memitem:ga16999a8a80afd7a4c3c6a91c457e9ed3"><td class="memItemLeft" align="right" valign="top">TSS2_RC&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__iesys__crypto.html#ga16999a8a80afd7a4c3c6a91c457e9ed3">iesys_cryptossl_hash_update2b</a> (<a class="el" href="struct___i_e_s_y_s___c_r_y_p_t_o___c_o_n_t_e_x_t.html">IESYS_CRYPTO_CONTEXT_BLOB</a> *context, TPM2B *b)</td></tr>
    79. 

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

  80. <tr class="memitem:ga35e28a2962a090e231bb4a8395a449d3"><td class="memItemLeft" align="right" valign="top">TSS2_RC&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__iesys__crypto.html#ga35e28a2962a090e231bb4a8395a449d3">iesys_cryptossl_hash_finish</a> (<a class="el" href="struct___i_e_s_y_s___c_r_y_p_t_o___c_o_n_t_e_x_t.html">IESYS_CRYPTO_CONTEXT_BLOB</a> **context, uint8_t *buffer, size_t *size)</td></tr>
    81. 

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

  82. <tr class="memitem:ga82c55cd4b4a10b6f861d0e7299c3a56f"><td class="memItemLeft" align="right" valign="top">TSS2_RC&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__iesys__crypto.html#ga82c55cd4b4a10b6f861d0e7299c3a56f">iesys_cryptossl_hash_finish2b</a> (<a class="el" href="struct___i_e_s_y_s___c_r_y_p_t_o___c_o_n_t_e_x_t.html">IESYS_CRYPTO_CONTEXT_BLOB</a> **context, TPM2B *b)</td></tr>
    83. 

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

  84. <tr class="memitem:ga0d7703e693a61c7786b654021b138461"><td class="memItemLeft" align="right" valign="top">TSS2_RC&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__iesys__crypto.html#ga0d7703e693a61c7786b654021b138461">iesys_cryptossl_hmac_start</a> (<a class="el" href="struct___i_e_s_y_s___c_r_y_p_t_o___c_o_n_t_e_x_t.html">IESYS_CRYPTO_CONTEXT_BLOB</a> **context, TPM2_ALG_ID hashAlg, const uint8_t *key, size_t size)</td></tr>
    85. 

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

  86. <tr class="memitem:ga16cf8a0028c642060629ba0e3571874d"><td class="memItemLeft" align="right" valign="top"><a id="ga16cf8a0028c642060629ba0e3571874d"></a>
    87. 

  87. TSS2_RC&#160;</td><td class="memItemRight" valign="bottom"><b>iesys_cryptossl_hmac_start2b</b> (<a class="el" href="struct___i_e_s_y_s___c_r_y_p_t_o___c_o_n_t_e_x_t.html">IESYS_CRYPTO_CONTEXT_BLOB</a> **context, TPM2_ALG_ID hmacAlg, TPM2B *b)</td></tr>
    88. 

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

  89. <tr class="memitem:ga38c55dcb7af1740f2c88c6a13714d0f4"><td class="memItemLeft" align="right" valign="top">TSS2_RC&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__iesys__crypto.html#ga38c55dcb7af1740f2c88c6a13714d0f4">iesys_cryptossl_hmac_update</a> (<a class="el" href="struct___i_e_s_y_s___c_r_y_p_t_o___c_o_n_t_e_x_t.html">IESYS_CRYPTO_CONTEXT_BLOB</a> *context, const uint8_t *buffer, size_t size)</td></tr>
    90. 

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

  91. <tr class="memitem:ga293339e25fee12b919a656c8f4b66f90"><td class="memItemLeft" align="right" valign="top">TSS2_RC&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__iesys__crypto.html#ga293339e25fee12b919a656c8f4b66f90">iesys_cryptossl_hmac_update2b</a> (<a class="el" href="struct___i_e_s_y_s___c_r_y_p_t_o___c_o_n_t_e_x_t.html">IESYS_CRYPTO_CONTEXT_BLOB</a> *context, TPM2B *b)</td></tr>
    92. 

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

  93. <tr class="memitem:ga139ec4dc810310a89bf60fa28f146e96"><td class="memItemLeft" align="right" valign="top">TSS2_RC&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__iesys__crypto.html#ga139ec4dc810310a89bf60fa28f146e96">iesys_cryptossl_hmac_finish</a> (<a class="el" href="struct___i_e_s_y_s___c_r_y_p_t_o___c_o_n_t_e_x_t.html">IESYS_CRYPTO_CONTEXT_BLOB</a> **context, uint8_t *buffer, size_t *size)</td></tr>
    94. 

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

  95. <tr class="memitem:ga7c38dee8ff84865ea817637906a1705b"><td class="memItemLeft" align="right" valign="top">TSS2_RC&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__iesys__crypto.html#ga7c38dee8ff84865ea817637906a1705b">iesys_cryptossl_hmac_finish2b</a> (<a class="el" href="struct___i_e_s_y_s___c_r_y_p_t_o___c_o_n_t_e_x_t.html">IESYS_CRYPTO_CONTEXT_BLOB</a> **context, TPM2B *hmac)</td></tr>
    96. 

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

  97. <tr class="memitem:ga55c3c4be43371ff9dc984434c686831c"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__iesys__crypto.html#ga55c3c4be43371ff9dc984434c686831c">iesys_cryptossl_hmac_abort</a> (<a class="el" href="struct___i_e_s_y_s___c_r_y_p_t_o___c_o_n_t_e_x_t.html">IESYS_CRYPTO_CONTEXT_BLOB</a> **context)</td></tr>
    98. 

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

  99. <tr class="memitem:ga868c435530ad744767e1c72b1002639c"><td class="memItemLeft" align="right" valign="top">TSS2_RC&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__iesys__crypto.html#ga868c435530ad744767e1c72b1002639c">iesys_crypto_pHash</a> (TPM2_ALG_ID alg, const uint8_t rcBuffer[4], const uint8_t ccBuffer[4], const TPM2B_NAME *name1, const TPM2B_NAME *name2, const TPM2B_NAME *name3, const uint8_t *pBuffer, size_t pBuffer_size, uint8_t *pHash, size_t *pHash_size)</td></tr>
    100. 

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

  101. <tr class="memitem:gadff77df69cec057dd6895596a3995be1"><td class="memItemLeft" align="right" valign="top">TSS2_RC&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__iesys__crypto.html#gadff77df69cec057dd6895596a3995be1">iesys_crypto_authHmac</a> (TPM2_ALG_ID alg, uint8_t *hmacKey, size_t hmacKeySize, const uint8_t *pHash, size_t pHash_size, const TPM2B_NONCE *nonceNewer, const TPM2B_NONCE *nonceOlder, const TPM2B_NONCE *nonceDecrypt, const TPM2B_NONCE *nonceEncrypt, TPMA_SESSION sessionAttributes, TPM2B_AUTH *hmac)</td></tr>
    102. 

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

  103. <tr class="memitem:ga7d954265e28d2891f6700fa514df3f10"><td class="memItemLeft" align="right" valign="top">TSS2_RC&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__iesys__crypto.html#ga7d954265e28d2891f6700fa514df3f10">iesys_cryptossl_random2b</a> (TPM2B_NONCE *nonce, size_t num_bytes)</td></tr>
    104. 

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

  105. <tr class="memitem:gab23845f7778d674b6c08d6d1f2ed1bce"><td class="memItemLeft" align="right" valign="top">TSS2_RC&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__iesys__crypto.html#gab23845f7778d674b6c08d6d1f2ed1bce">iesys_cryptossl_pk_encrypt</a> (TPM2B_PUBLIC *pub_tpm_key, size_t in_size, BYTE *in_buffer, size_t max_out_size, BYTE *out_buffer, size_t *out_size, const char *label)</td></tr>
    106. 

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

  107. <tr class="memitem:ga60a41b048b2b032ad14fd5b0d4ab3416"><td class="memItemLeft" align="right" valign="top">TSS2_RC&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__iesys__crypto.html#ga60a41b048b2b032ad14fd5b0d4ab3416">iesys_crypto_KDFaHmac</a> (TPM2_ALG_ID alg, uint8_t *hmacKey, size_t hmacKeySize, uint32_t counter, const char *label, TPM2B_NONCE *contextU, TPM2B_NONCE *contextV, uint32_t bitlength, uint8_t *hmac, size_t *hmacSize)</td></tr>
    108. 

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

  109. <tr class="memitem:ga08456301649c3335e660f6674fd227b5"><td class="memItemLeft" align="right" valign="top">TSS2_RC&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__iesys__crypto.html#ga08456301649c3335e660f6674fd227b5">iesys_crypto_KDFa</a> (TPM2_ALG_ID hashAlg, uint8_t *hmacKey, size_t hmacKeySize, const char *label, TPM2B_NONCE *contextU, TPM2B_NONCE *contextV, uint32_t bitLength, uint32_t *counterInOut, BYTE *outKey, BOOL use_digest_size)</td></tr>
    110. 

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

  111. <tr class="memitem:ga457c585adbb8703ba5941eb0d6cc6a43"><td class="memItemLeft" align="right" valign="top">TSS2_RC&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__iesys__crypto.html#ga457c585adbb8703ba5941eb0d6cc6a43">iesys_crypto_KDFe</a> (TPM2_ALG_ID hashAlg, TPM2B_ECC_PARAMETER *Z, const char *label, TPM2B_ECC_PARAMETER *partyUInfo, TPM2B_ECC_PARAMETER *partyVInfo, UINT32 bit_size, BYTE *key)</td></tr>
    112. 

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

  113. <tr class="memitem:gaae1d6a57770b8e1b665bf27a06899bc6"><td class="memItemLeft" align="right" valign="top">TSS2_RC&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__iesys__crypto.html#gaae1d6a57770b8e1b665bf27a06899bc6">iesys_xor_parameter_obfuscation</a> (TPM2_ALG_ID hash_alg, uint8_t *key, size_t key_size, TPM2B_NONCE *contextU, TPM2B_NONCE *contextV, BYTE *data, size_t data_size)</td></tr>
    114. 

  114. <tr class="separator:gaae1d6a57770b8e1b665bf27a06899bc6"><td class="memSeparator" colspan="2">&#160;</td></tr>
    115. 

  115. <tr class="memitem:gacc3d21e92aa154a09a3e8273de9f525e"><td class="memItemLeft" align="right" valign="top">TSS2_RC&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__iesys__crypto.html#gacc3d21e92aa154a09a3e8273de9f525e">iesys_cryptossl_get_ecdh_point</a> (TPM2B_PUBLIC *key, size_t max_out_size, TPM2B_ECC_PARAMETER *Z, TPMS_ECC_POINT *Q, BYTE *out_buffer, size_t *out_size)</td></tr>
    116. 

  116. <tr class="separator:gacc3d21e92aa154a09a3e8273de9f525e"><td class="memSeparator" colspan="2">&#160;</td></tr>
    117. 

  117. </table>
    118. 

  118. <a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
    119. 

  119. <p>The types and functions used internally by ESAPI for cryptographic operations. Multiple implementations of these functions may exist for different cryptographic backends. </p>
    120. 

  120. <h2 class="groupheader">Function Documentation</h2>
    121. 

  121. <a id="gadff77df69cec057dd6895596a3995be1"></a>
    122. 

  122. <h2 class="memtitle"><span class="permalink"><a href="#gadff77df69cec057dd6895596a3995be1">&#9670;&nbsp;</a></span>iesys_crypto_authHmac()</h2>
    123. 

  123. 

  124. <div class="memitem">
    125. 

  125. <div class="memproto">
    126. 

  126.       <table class="memname">
    127. 

  127.         <tr>
    128. 

  128.           <td class="memname">TSS2_RC iesys_crypto_authHmac </td>
    129. 

  129.           <td>(</td>
    130. 

  130.           <td class="paramtype">TPM2_ALG_ID&#160;</td>
    131. 

  131.           <td class="paramname"><em>alg</em>, </td>
    132. 

  132.         </tr>
    133. 

  133.         <tr>
    134. 

  134.           <td class="paramkey"></td>
    135. 

  135.           <td></td>
    136. 

  136.           <td class="paramtype">uint8_t *&#160;</td>
    137. 

  137.           <td class="paramname"><em>hmacKey</em>, </td>
    138. 

  138.         </tr>
    139. 

  139.         <tr>
    140. 

  140.           <td class="paramkey"></td>
    141. 

  141.           <td></td>
    142. 

  142.           <td class="paramtype">size_t&#160;</td>
    143. 

  143.           <td class="paramname"><em>hmacKeySize</em>, </td>
    144. 

  144.         </tr>
    145. 

  145.         <tr>
    146. 

  146.           <td class="paramkey"></td>
    147. 

  147.           <td></td>
    148. 

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

  149.           <td class="paramname"><em>pHash</em>, </td>
    150. 

  150.         </tr>
    151. 

  151.         <tr>
    152. 

  152.           <td class="paramkey"></td>
    153. 

  153.           <td></td>
    154. 

  154.           <td class="paramtype">size_t&#160;</td>
    155. 

  155.           <td class="paramname"><em>pHash_size</em>, </td>
    156. 

  156.         </tr>
    157. 

  157.         <tr>
    158. 

  158.           <td class="paramkey"></td>
    159. 

  159.           <td></td>
    160. 

  160.           <td class="paramtype">const TPM2B_NONCE *&#160;</td>
    161. 

  161.           <td class="paramname"><em>nonceNewer</em>, </td>
    162. 

  162.         </tr>
    163. 

  163.         <tr>
    164. 

  164.           <td class="paramkey"></td>
    165. 

  165.           <td></td>
    166. 

  166.           <td class="paramtype">const TPM2B_NONCE *&#160;</td>
    167. 

  167.           <td class="paramname"><em>nonceOlder</em>, </td>
    168. 

  168.         </tr>
    169. 

  169.         <tr>
    170. 

  170.           <td class="paramkey"></td>
    171. 

  171.           <td></td>
    172. 

  172.           <td class="paramtype">const TPM2B_NONCE *&#160;</td>
    173. 

  173.           <td class="paramname"><em>nonceDecrypt</em>, </td>
    174. 

  174.         </tr>
    175. 

  175.         <tr>
    176. 

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

  177.           <td></td>
    178. 

  178.           <td class="paramtype">const TPM2B_NONCE *&#160;</td>
    179. 

  179.           <td class="paramname"><em>nonceEncrypt</em>, </td>
    180. 

  180.         </tr>
    181. 

  181.         <tr>
    182. 

  182.           <td class="paramkey"></td>
    183. 

  183.           <td></td>
    184. 

  184.           <td class="paramtype">TPMA_SESSION&#160;</td>
    185. 

  185.           <td class="paramname"><em>sessionAttributes</em>, </td>
    186. 

  186.         </tr>
    187. 

  187.         <tr>
    188. 

  188.           <td class="paramkey"></td>
    189. 

  189.           <td></td>
    190. 

  190.           <td class="paramtype">TPM2B_AUTH *&#160;</td>
    191. 

  191.           <td class="paramname"><em>hmac</em>&#160;</td>
    192. 

  192.         </tr>
    193. 

  193.         <tr>
    194. 

  194.           <td></td>
    195. 

  195.           <td>)</td>
    196. 

  196.           <td></td><td></td>
    197. 

  197.         </tr>
    198. 

  198.       </table>
    199. 

  199. </div><div class="memdoc">
    200. 

  200. <p>Compute the HMAC for authorization.</p>
    201. 

  201. <p>Based on the session nonces, caller nonce, TPM nonce, if used encryption and decryption nonce, the command parameter hash, and the session attributes the HMAC used for authorization is computed. </p><dl class="params"><dt>Parameters</dt><dd>
    202. 

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

  203.     <tr><td class="paramdir">[in]</td><td class="paramname">alg</td><td>The hash algorithm used for HMAC computation. </td></tr>
    204. 

  204.     <tr><td class="paramdir">[in]</td><td class="paramname">hmacKey</td><td>The HMAC key byte buffer. </td></tr>
    205. 

  205.     <tr><td class="paramdir">[in]</td><td class="paramname">hmacKeySize</td><td>The size of the HMAC key byte buffer. </td></tr>
    206. 

  206.     <tr><td class="paramdir">[in]</td><td class="paramname">pHash</td><td>The command parameter hash byte buffer. </td></tr>
    207. 

  207.     <tr><td class="paramdir">[in]</td><td class="paramname">pHash_size</td><td>The size of the command parameter hash byte buffer. </td></tr>
    208. 

  208.     <tr><td class="paramdir">[in]</td><td class="paramname">nonceNewer</td><td>The TPM nonce. </td></tr>
    209. 

  209.     <tr><td class="paramdir">[in]</td><td class="paramname">nonceOlder</td><td>The caller nonce. </td></tr>
    210. 

  210.     <tr><td class="paramdir">[in]</td><td class="paramname">nonceDecrypt</td><td>The decrypt nonce (NULL if not used). </td></tr>
    211. 

  211.     <tr><td class="paramdir">[in]</td><td class="paramname">nonceEncrypt</td><td>The encrypt nonce (NULL if not used). </td></tr>
    212. 

  212.     <tr><td class="paramdir">[in]</td><td class="paramname">sessionAttributes</td><td>The attributes used for the current authentication. </td></tr>
    213. 

  213.     <tr><td class="paramdir">[out]</td><td class="paramname">hmac</td><td>The computed HMAC. </td></tr>
    214. 

  214.   </table>
    215. 

  215.   </dd>
    216. 

  216. </dl>
    217. 

  217. <dl class="retval"><dt>Return values</dt><dd>
    218. 

  218.   <table class="retval">
    219. 

  219.     <tr><td class="paramname">TSS2_RC_SUCCESS</td><td>on success </td></tr>
    220. 

  220.     <tr><td class="paramname">TSS2_ESYS_RC_BAD_REFERENCE</td><td>If a pointer is invalid. </td></tr>
    221. 

  221.   </table>
    222. 

  222.   </dd>
    223. 

  223. </dl>
    224. 

  224. 

  225. </div>
    226. 

  226. </div>
    227. 

  227. <a id="gaecbc62627049d1806648c9ecf8a52196"></a>
    228. 

  228. <h2 class="memtitle"><span class="permalink"><a href="#gaecbc62627049d1806648c9ecf8a52196">&#9670;&nbsp;</a></span>iesys_crypto_hash_get_digest_size()</h2>
    229. 

  229. 

  230. <div class="memitem">
    231. 

  231. <div class="memproto">
    232. 

  232.       <table class="memname">
    233. 

  233.         <tr>
    234. 

  234.           <td class="memname">TSS2_RC iesys_crypto_hash_get_digest_size </td>
    235. 

  235.           <td>(</td>
    236. 

  236.           <td class="paramtype">TPM2_ALG_ID&#160;</td>
    237. 

  237.           <td class="paramname"><em>hashAlg</em>, </td>
    238. 

  238.         </tr>
    239. 

  239.         <tr>
    240. 

  240.           <td class="paramkey"></td>
    241. 

  241.           <td></td>
    242. 

  242.           <td class="paramtype">size_t *&#160;</td>
    243. 

  243.           <td class="paramname"><em>size</em>&#160;</td>
    244. 

  244.         </tr>
    245. 

  245.         <tr>
    246. 

  246.           <td></td>
    247. 

  247.           <td>)</td>
    248. 

  248.           <td></td><td></td>
    249. 

  249.         </tr>
    250. 

  250.       </table>
    251. 

  251. </div><div class="memdoc">
    252. 

  252. <p>Provide the digest size for a given hash algorithm.</p>
    253. 

  253. <p>This function provides the size of the digest for a given hash algorithm.</p>
    254. 

  254. <dl class="params"><dt>Parameters</dt><dd>
    255. 

  255.   <table class="params">
    256. 

  256.     <tr><td class="paramdir">[in]</td><td class="paramname">hashAlg</td><td>The hash algorithm to get the size for. </td></tr>
    257. 

  257.     <tr><td class="paramdir">[out]</td><td class="paramname">size</td><td>The side of a digest of the hash algorithm. </td></tr>
    258. 

  258.   </table>
    259. 

  259.   </dd>
    260. 

  260. </dl>
    261. 

  261. <dl class="retval"><dt>Return values</dt><dd>
    262. 

  262.   <table class="retval">
    263. 

  263.     <tr><td class="paramname">TSS2_RC_SUCCESS</td><td>on success. </td></tr>
    264. 

  264.     <tr><td class="paramname">TSS2_ESYS_RC_BAD_VALUE</td><td>if hashAlg is unknown or unsupported. </td></tr>
    265. 

  265.   </table>
    266. 

  266.   </dd>
    267. 

  267. </dl>
    268. 

  268. 

  269. </div>
    270. 

  270. </div>
    271. 

  271. <a id="ga08456301649c3335e660f6674fd227b5"></a>
    272. 

  272. <h2 class="memtitle"><span class="permalink"><a href="#ga08456301649c3335e660f6674fd227b5">&#9670;&nbsp;</a></span>iesys_crypto_KDFa()</h2>
    273. 

  273. 

  274. <div class="memitem">
    275. 

  275. <div class="memproto">
    276. 

  276.       <table class="memname">
    277. 

  277.         <tr>
    278. 

  278.           <td class="memname">TSS2_RC iesys_crypto_KDFa </td>
    279. 

  279.           <td>(</td>
    280. 

  280.           <td class="paramtype">TPM2_ALG_ID&#160;</td>
    281. 

  281.           <td class="paramname"><em>hashAlg</em>, </td>
    282. 

  282.         </tr>
    283. 

  283.         <tr>
    284. 

  284.           <td class="paramkey"></td>
    285. 

  285.           <td></td>
    286. 

  286.           <td class="paramtype">uint8_t *&#160;</td>
    287. 

  287.           <td class="paramname"><em>hmacKey</em>, </td>
    288. 

  288.         </tr>
    289. 

  289.         <tr>
    290. 

  290.           <td class="paramkey"></td>
    291. 

  291.           <td></td>
    292. 

  292.           <td class="paramtype">size_t&#160;</td>
    293. 

  293.           <td class="paramname"><em>hmacKeySize</em>, </td>
    294. 

  294.         </tr>
    295. 

  295.         <tr>
    296. 

  296.           <td class="paramkey"></td>
    297. 

  297.           <td></td>
    298. 

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

  299.           <td class="paramname"><em>label</em>, </td>
    300. 

  300.         </tr>
    301. 

  301.         <tr>
    302. 

  302.           <td class="paramkey"></td>
    303. 

  303.           <td></td>
    304. 

  304.           <td class="paramtype">TPM2B_NONCE *&#160;</td>
    305. 

  305.           <td class="paramname"><em>contextU</em>, </td>
    306. 

  306.         </tr>
    307. 

  307.         <tr>
    308. 

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

  309.           <td></td>
    310. 

  310.           <td class="paramtype">TPM2B_NONCE *&#160;</td>
    311. 

  311.           <td class="paramname"><em>contextV</em>, </td>
    312. 

  312.         </tr>
    313. 

  313.         <tr>
    314. 

  314.           <td class="paramkey"></td>
    315. 

  315.           <td></td>
    316. 

  316.           <td class="paramtype">uint32_t&#160;</td>
    317. 

  317.           <td class="paramname"><em>bitLength</em>, </td>
    318. 

  318.         </tr>
    319. 

  319.         <tr>
    320. 

  320.           <td class="paramkey"></td>
    321. 

  321.           <td></td>
    322. 

  322.           <td class="paramtype">uint32_t *&#160;</td>
    323. 

  323.           <td class="paramname"><em>counterInOut</em>, </td>
    324. 

  324.         </tr>
    325. 

  325.         <tr>
    326. 

  326.           <td class="paramkey"></td>
    327. 

  327.           <td></td>
    328. 

  328.           <td class="paramtype">BYTE *&#160;</td>
    329. 

  329.           <td class="paramname"><em>outKey</em>, </td>
    330. 

  330.         </tr>
    331. 

  331.         <tr>
    332. 

  332.           <td class="paramkey"></td>
    333. 

  333.           <td></td>
    334. 

  334.           <td class="paramtype">BOOL&#160;</td>
    335. 

  335.           <td class="paramname"><em>use_digest_size</em>&#160;</td>
    336. 

  336.         </tr>
    337. 

  337.         <tr>
    338. 

  338.           <td></td>
    339. 

  339.           <td>)</td>
    340. 

  340.           <td></td><td></td>
    341. 

  341.         </tr>
    342. 

  342.       </table>
    343. 

  343. </div><div class="memdoc">
    344. 

  344. <p>KDFa Key derivation.</p>
    345. 

  345. <p>Except of ECDH this function is used for key derivation. </p><dl class="params"><dt>Parameters</dt><dd>
    346. 

  346.   <table class="params">
    347. 

  347.     <tr><td class="paramdir">[in]</td><td class="paramname">hashAlg</td><td>The hash algorithm to use. </td></tr>
    348. 

  348.     <tr><td class="paramdir">[in]</td><td class="paramname">hmacKey</td><td>The hmacKey used in KDFa. </td></tr>
    349. 

  349.     <tr><td class="paramdir">[in]</td><td class="paramname">hmacKeySize</td><td>The size of the HMAC key. </td></tr>
    350. 

  350.     <tr><td class="paramdir">[in]</td><td class="paramname">label</td><td>Indicates the use of the produced key. </td></tr>
    351. 

  351.     <tr><td class="paramdir">[in]</td><td class="paramname">contextU,contextV</td><td>are used for construction of a binary string containing information related to the derived key. </td></tr>
    352. 

  352.     <tr><td class="paramdir">[in]</td><td class="paramname">bitLength</td><td>The size of generated key in bits. </td></tr>
    353. 

  353.     <tr><td class="paramdir">[in,out]</td><td class="paramname">counterInOut</td><td>Counter for the KDFa iterations. If set, the value will be used for the firt iteration step. The final counter value will be written to counterInOut. </td></tr>
    354. 

  354.     <tr><td class="paramdir">[out]</td><td class="paramname">outKey</td><td>Byte buffer for the derived key (caller-allocated). </td></tr>
    355. 

  355.     <tr><td class="paramdir">[in]</td><td class="paramname">use_digest_size</td><td>Indicate whether the digest size of hashAlg is used as size of the generated key or the bitLength parameter is used. </td></tr>
    356. 

  356.   </table>
    357. 

  357.   </dd>
    358. 

  358. </dl>
    359. 

  359. <dl class="retval"><dt>Return values</dt><dd>
    360. 

  360.   <table class="retval">
    361. 

  361.     <tr><td class="paramname">TSS2_RC_SUCCESS</td><td>on success. </td></tr>
    362. 

  362.     <tr><td class="paramname">TSS2_ESYS_RC_BAD_VALUE</td><td>if hashAlg is unknown or unsupported. </td></tr>
    363. 

  363.   </table>
    364. 

  364.   </dd>
    365. 

  365. </dl>
    366. 

  366. 

  367. </div>
    368. 

  368. </div>
    369. 

  369. <a id="ga60a41b048b2b032ad14fd5b0d4ab3416"></a>
    370. 

  370. <h2 class="memtitle"><span class="permalink"><a href="#ga60a41b048b2b032ad14fd5b0d4ab3416">&#9670;&nbsp;</a></span>iesys_crypto_KDFaHmac()</h2>
    371. 

  371. 

  372. <div class="memitem">
    373. 

  373. <div class="memproto">
    374. 

  374.       <table class="memname">
    375. 

  375.         <tr>
    376. 

  376.           <td class="memname">TSS2_RC iesys_crypto_KDFaHmac </td>
    377. 

  377.           <td>(</td>
    378. 

  378.           <td class="paramtype">TPM2_ALG_ID&#160;</td>
    379. 

  379.           <td class="paramname"><em>alg</em>, </td>
    380. 

  380.         </tr>
    381. 

  381.         <tr>
    382. 

  382.           <td class="paramkey"></td>
    383. 

  383.           <td></td>
    384. 

  384.           <td class="paramtype">uint8_t *&#160;</td>
    385. 

  385.           <td class="paramname"><em>hmacKey</em>, </td>
    386. 

  386.         </tr>
    387. 

  387.         <tr>
    388. 

  388.           <td class="paramkey"></td>
    389. 

  389.           <td></td>
    390. 

  390.           <td class="paramtype">size_t&#160;</td>
    391. 

  391.           <td class="paramname"><em>hmacKeySize</em>, </td>
    392. 

  392.         </tr>
    393. 

  393.         <tr>
    394. 

  394.           <td class="paramkey"></td>
    395. 

  395.           <td></td>
    396. 

  396.           <td class="paramtype">uint32_t&#160;</td>
    397. 

  397.           <td class="paramname"><em>counter</em>, </td>
    398. 

  398.         </tr>
    399. 

  399.         <tr>
    400. 

  400.           <td class="paramkey"></td>
    401. 

  401.           <td></td>
    402. 

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

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

  404.         </tr>
    405. 

  405.         <tr>
    406. 

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

  407.           <td></td>
    408. 

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

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

  410.         </tr>
    411. 

  411.         <tr>
    412. 

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

  413.           <td></td>
    414. 

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

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

  416.         </tr>
    417. 

  417.         <tr>
    418. 

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

  419.           <td></td>
    420. 

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

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

  422.         </tr>
    423. 

  423.         <tr>
    424. 

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

  425.           <td></td>
    426. 

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

  427.           <td class="paramname"><em>hmac</em>, </td>
    428. 

  428.         </tr>
    429. 

  429.         <tr>
    430. 

  430.           <td class="paramkey"></td>
    431. 

  431.           <td></td>
    432. 

  432.           <td class="paramtype">size_t *&#160;</td>
    433. 

  433.           <td class="paramname"><em>hmacSize</em>&#160;</td>
    434. 

  434.         </tr>
    435. 

  435.         <tr>
    436. 

  436.           <td></td>
    437. 

  437.           <td>)</td>
    438. 

  438.           <td></td><td></td>
    439. 

  439.         </tr>
    440. 

  440.       </table>
    441. 

  441. </div><div class="memdoc">
    442. 

  442. <p>HMAC computation for inner loop of KDFa key derivation.</p>
    443. 

  443. <p>Except of ECDH this function is used for key derivation. </p><dl class="params"><dt>Parameters</dt><dd>
    444. 

  444.   <table class="params">
    445. 

  445.     <tr><td class="paramdir">[in]</td><td class="paramname">alg</td><td>The algorithm used for the HMAC. </td></tr>
    446. 

  446.     <tr><td class="paramdir">[in]</td><td class="paramname">hmacKey</td><td>The hmacKey used in KDFa. </td></tr>
    447. 

  447.     <tr><td class="paramdir">[in]</td><td class="paramname">hmacKeySize</td><td>The size of the HMAC key. </td></tr>
    448. 

  448.     <tr><td class="paramdir">[in]</td><td class="paramname">counter</td><td>The curren iteration step. </td></tr>
    449. 

  449.     <tr><td class="paramdir">[in]</td><td class="paramname">label</td><td>Indicates the use of the produced key. </td></tr>
    450. 

  450.     <tr><td class="paramdir">[in]</td><td class="paramname">contextU,contextV</td><td>are used for construction of a binary string containing information related to the derived key. </td></tr>
    451. 

  451.     <tr><td class="paramdir">[in]</td><td class="paramname">bitlength</td><td>The size of the generated key in bits. </td></tr>
    452. 

  452.     <tr><td class="paramdir">[out]</td><td class="paramname">hmac</td><td>Byte buffer for the generated HMAC key (caller-allocated). </td></tr>
    453. 

  453.     <tr><td class="paramdir">[out]</td><td class="paramname">hmacSize</td><td>Size of the generated HMAC key. </td></tr>
    454. 

  454.   </table>
    455. 

  455.   </dd>
    456. 

  456. </dl>
    457. 

  457. <dl class="retval"><dt>Return values</dt><dd>
    458. 

  458.   <table class="retval">
    459. 

  459.     <tr><td class="paramname">TSS2_RC_SUCCESS</td><td>on success. </td></tr>
    460. 

  460.     <tr><td class="paramname">TSS2_ESYS_RC_BAD_REFERENCE</td><td>for invalid parameters. </td></tr>
    461. 

  461.   </table>
    462. 

  462.   </dd>
    463. 

  463. </dl>
    464. 

  464. 

  465. </div>
    466. 

  466. </div>
    467. 

  467. <a id="ga457c585adbb8703ba5941eb0d6cc6a43"></a>
    468. 

  468. <h2 class="memtitle"><span class="permalink"><a href="#ga457c585adbb8703ba5941eb0d6cc6a43">&#9670;&nbsp;</a></span>iesys_crypto_KDFe()</h2>
    469. 

  469. 

  470. <div class="memitem">
    471. 

  471. <div class="memproto">
    472. 

  472.       <table class="memname">
    473. 

  473.         <tr>
    474. 

  474.           <td class="memname">TSS2_RC iesys_crypto_KDFe </td>
    475. 

  475.           <td>(</td>
    476. 

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

  477.           <td class="paramname"><em>hashAlg</em>, </td>
    478. 

  478.         </tr>
    479. 

  479.         <tr>
    480. 

  480.           <td class="paramkey"></td>
    481. 

  481.           <td></td>
    482. 

  482.           <td class="paramtype">TPM2B_ECC_PARAMETER *&#160;</td>
    483. 

  483.           <td class="paramname"><em>Z</em>, </td>
    484. 

  484.         </tr>
    485. 

  485.         <tr>
    486. 

  486.           <td class="paramkey"></td>
    487. 

  487.           <td></td>
    488. 

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

  489.           <td class="paramname"><em>label</em>, </td>
    490. 

  490.         </tr>
    491. 

  491.         <tr>
    492. 

  492.           <td class="paramkey"></td>
    493. 

  493.           <td></td>
    494. 

  494.           <td class="paramtype">TPM2B_ECC_PARAMETER *&#160;</td>
    495. 

  495.           <td class="paramname"><em>partyUInfo</em>, </td>
    496. 

  496.         </tr>
    497. 

  497.         <tr>
    498. 

  498.           <td class="paramkey"></td>
    499. 

  499.           <td></td>
    500. 

  500.           <td class="paramtype">TPM2B_ECC_PARAMETER *&#160;</td>
    501. 

  501.           <td class="paramname"><em>partyVInfo</em>, </td>
    502. 

  502.         </tr>
    503. 

  503.         <tr>
    504. 

  504.           <td class="paramkey"></td>
    505. 

  505.           <td></td>
    506. 

  506.           <td class="paramtype">UINT32&#160;</td>
    507. 

  507.           <td class="paramname"><em>bit_size</em>, </td>
    508. 

  508.         </tr>
    509. 

  509.         <tr>
    510. 

  510.           <td class="paramkey"></td>
    511. 

  511.           <td></td>
    512. 

  512.           <td class="paramtype">BYTE *&#160;</td>
    513. 

  513.           <td class="paramname"><em>key</em>&#160;</td>
    514. 

  514.         </tr>
    515. 

  515.         <tr>
    516. 

  516.           <td></td>
    517. 

  517.           <td>)</td>
    518. 

  518.           <td></td><td></td>
    519. 

  519.         </tr>
    520. 

  520.       </table>
    521. 

  521. </div><div class="memdoc">
    522. 

  522. <p>Compute KDFe as described in TPM spec part 1 C 6.1</p>
    523. 

  523. <dl class="params"><dt>Parameters</dt><dd>
    524. 

  524.   <table class="params">
    525. 

  525.     <tr><td class="paramname">hashAlg</td><td>[in] The nameAlg of the recipient key. </td></tr>
    526. 

  526.     <tr><td class="paramname">Z</td><td>[in] the x coordinate (xP) of the product (P) of a public point and a private key. </td></tr>
    527. 

  527.     <tr><td class="paramname">label</td><td>[in] KDF label. </td></tr>
    528. 

  528.     <tr><td class="paramname">partyUInfo</td><td>[in] The x-coordinate of the secret exchange value (Qe,U). </td></tr>
    529. 

  529.     <tr><td class="paramname">partyVInfo</td><td>[in] The x-coordinate of a public key (Qs,V). </td></tr>
    530. 

  530.     <tr><td class="paramname">bit_size</td><td>[in] Bit size of generated key. </td></tr>
    531. 

  531.     <tr><td class="paramname">key</td><td>[out] Key buffer. </td></tr>
    532. 

  532.   </table>
    533. 

  533.   </dd>
    534. 

  534. </dl>
    535. 

  535. <dl class="retval"><dt>Return values</dt><dd>
    536. 

  536.   <table class="retval">
    537. 

  537.     <tr><td class="paramname">TSS2_RC_SUCCESS</td><td>on success </td></tr>
    538. 

  538.     <tr><td class="paramname">TSS2_ESYS_RC_BAD_REFERENCE</td><td>for invalid parameters </td></tr>
    539. 

  539.     <tr><td class="paramname">TSS2_ESYS_RC_MEMORY</td><td>Memory cannot be allocated. </td></tr>
    540. 

  540.   </table>
    541. 

  541.   </dd>
    542. 

  542. </dl>
    543. 

  543. 

  544. </div>
    545. 

  545. </div>
    546. 

  546. <a id="ga868c435530ad744767e1c72b1002639c"></a>
    547. 

  547. <h2 class="memtitle"><span class="permalink"><a href="#ga868c435530ad744767e1c72b1002639c">&#9670;&nbsp;</a></span>iesys_crypto_pHash()</h2>
    548. 

  548. 

  549. <div class="memitem">
    550. 

  550. <div class="memproto">
    551. 

  551.       <table class="memname">
    552. 

  552.         <tr>
    553. 

  553.           <td class="memname">TSS2_RC iesys_crypto_pHash </td>
    554. 

  554.           <td>(</td>
    555. 

  555.           <td class="paramtype">TPM2_ALG_ID&#160;</td>
    556. 

  556.           <td class="paramname"><em>alg</em>, </td>
    557. 

  557.         </tr>
    558. 

  558.         <tr>
    559. 

  559.           <td class="paramkey"></td>
    560. 

  560.           <td></td>
    561. 

  561.           <td class="paramtype">const uint8_t&#160;</td>
    562. 

  562.           <td class="paramname"><em>rcBuffer</em>[4], </td>
    563. 

  563.         </tr>
    564. 

  564.         <tr>
    565. 

  565.           <td class="paramkey"></td>
    566. 

  566.           <td></td>
    567. 

  567.           <td class="paramtype">const uint8_t&#160;</td>
    568. 

  568.           <td class="paramname"><em>ccBuffer</em>[4], </td>
    569. 

  569.         </tr>
    570. 

  570.         <tr>
    571. 

  571.           <td class="paramkey"></td>
    572. 

  572.           <td></td>
    573. 

  573.           <td class="paramtype">const TPM2B_NAME *&#160;</td>
    574. 

  574.           <td class="paramname"><em>name1</em>, </td>
    575. 

  575.         </tr>
    576. 

  576.         <tr>
    577. 

  577.           <td class="paramkey"></td>
    578. 

  578.           <td></td>
    579. 

  579.           <td class="paramtype">const TPM2B_NAME *&#160;</td>
    580. 

  580.           <td class="paramname"><em>name2</em>, </td>
    581. 

  581.         </tr>
    582. 

  582.         <tr>
    583. 

  583.           <td class="paramkey"></td>
    584. 

  584.           <td></td>
    585. 

  585.           <td class="paramtype">const TPM2B_NAME *&#160;</td>
    586. 

  586.           <td class="paramname"><em>name3</em>, </td>
    587. 

  587.         </tr>
    588. 

  588.         <tr>
    589. 

  589.           <td class="paramkey"></td>
    590. 

  590.           <td></td>
    591. 

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

  592.           <td class="paramname"><em>pBuffer</em>, </td>
    593. 

  593.         </tr>
    594. 

  594.         <tr>
    595. 

  595.           <td class="paramkey"></td>
    596. 

  596.           <td></td>
    597. 

  597.           <td class="paramtype">size_t&#160;</td>
    598. 

  598.           <td class="paramname"><em>pBuffer_size</em>, </td>
    599. 

  599.         </tr>
    600. 

  600.         <tr>
    601. 

  601.           <td class="paramkey"></td>
    602. 

  602.           <td></td>
    603. 

  603.           <td class="paramtype">uint8_t *&#160;</td>
    604. 

  604.           <td class="paramname"><em>pHash</em>, </td>
    605. 

  605.         </tr>
    606. 

  606.         <tr>
    607. 

  607.           <td class="paramkey"></td>
    608. 

  608.           <td></td>
    609. 

  609.           <td class="paramtype">size_t *&#160;</td>
    610. 

  610.           <td class="paramname"><em>pHash_size</em>&#160;</td>
    611. 

  611.         </tr>
    612. 

  612.         <tr>
    613. 

  613.           <td></td>
    614. 

  614.           <td>)</td>
    615. 

  615.           <td></td><td></td>
    616. 

  616.         </tr>
    617. 

  617.       </table>
    618. 

  618. </div><div class="memdoc">
    619. 

  619. <p>Compute the command or response parameter hash.</p>
    620. 

  620. <p>These hashes are needed for the computation of the HMAC used for the authorization of commands, or for the HMAC used for checking the responses. The name parameters are only used for the command parameter hash (cp) and must be NULL for the computation of the response parameter rp hash (rp). </p><dl class="params"><dt>Parameters</dt><dd>
    621. 

  621.   <table class="params">
    622. 

  622.     <tr><td class="paramdir">[in]</td><td class="paramname">alg</td><td>The hash algorithm. </td></tr>
    623. 

  623.     <tr><td class="paramdir">[in]</td><td class="paramname">rcBuffer</td><td>The response code in marshaled form. </td></tr>
    624. 

  624.     <tr><td class="paramdir">[in]</td><td class="paramname">ccBuffer</td><td>The command code in marshaled form. </td></tr>
    625. 

  625.     <tr><td class="paramdir">[in]</td><td class="paramname">name1,name2,name3</td><td>The names associated with the corresponding handle. Must be NULL if no handle is passed. </td></tr>
    626. 

  626.     <tr><td class="paramdir">[in]</td><td class="paramname">pBuffer</td><td>The byte buffer or the command or the response. </td></tr>
    627. 

  627.     <tr><td class="paramdir">[in]</td><td class="paramname">pBuffer_size</td><td>The size of the command or response. </td></tr>
    628. 

  628.     <tr><td class="paramdir">[out]</td><td class="paramname">pHash</td><td>The result digest. </td></tr>
    629. 

  629.     <tr><td class="paramdir">[out]</td><td class="paramname">pHash_size</td><td>The size of the result digest. </td></tr>
    630. 

  630.   </table>
    631. 

  631.   </dd>
    632. 

  632. </dl>
    633. 

  633. <dl class="retval"><dt>Return values</dt><dd>
    634. 

  634.   <table class="retval">
    635. 

  635.     <tr><td class="paramname">TSS2_RC_SUCCESS</td><td>on success. </td></tr>
    636. 

  636.     <tr><td class="paramname">TSS2_ESYS_RC_BAD_REFERENCE</td><td>for invalid parameters. </td></tr>
    637. 

  637.   </table>
    638. 

  638.   </dd>
    639. 

  639. </dl>
    640. 

  640. 

  641. </div>
    642. 

  642. </div>
    643. 

  643. <a id="gacc3d21e92aa154a09a3e8273de9f525e"></a>
    644. 

  644. <h2 class="memtitle"><span class="permalink"><a href="#gacc3d21e92aa154a09a3e8273de9f525e">&#9670;&nbsp;</a></span>iesys_cryptossl_get_ecdh_point()</h2>
    645. 

  645. 

  646. <div class="memitem">
    647. 

  647. <div class="memproto">
    648. 

  648.       <table class="memname">
    649. 

  649.         <tr>
    650. 

  650.           <td class="memname">TSS2_RC iesys_cryptossl_get_ecdh_point </td>
    651. 

  651.           <td>(</td>
    652. 

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

  653.           <td class="paramname"><em>key</em>, </td>
    654. 

  654.         </tr>
    655. 

  655.         <tr>
    656. 

  656.           <td class="paramkey"></td>
    657. 

  657.           <td></td>
    658. 

  658.           <td class="paramtype">size_t&#160;</td>
    659. 

  659.           <td class="paramname"><em>max_out_size</em>, </td>
    660. 

  660.         </tr>
    661. 

  661.         <tr>
    662. 

  662.           <td class="paramkey"></td>
    663. 

  663.           <td></td>
    664. 

  664.           <td class="paramtype">TPM2B_ECC_PARAMETER *&#160;</td>
    665. 

  665.           <td class="paramname"><em>Z</em>, </td>
    666. 

  666.         </tr>
    667. 

  667.         <tr>
    668. 

  668.           <td class="paramkey"></td>
    669. 

  669.           <td></td>
    670. 

  670.           <td class="paramtype">TPMS_ECC_POINT *&#160;</td>
    671. 

  671.           <td class="paramname"><em>Q</em>, </td>
    672. 

  672.         </tr>
    673. 

  673.         <tr>
    674. 

  674.           <td class="paramkey"></td>
    675. 

  675.           <td></td>
    676. 

  676.           <td class="paramtype">BYTE *&#160;</td>
    677. 

  677.           <td class="paramname"><em>out_buffer</em>, </td>
    678. 

  678.         </tr>
    679. 

  679.         <tr>
    680. 

  680.           <td class="paramkey"></td>
    681. 

  681.           <td></td>
    682. 

  682.           <td class="paramtype">size_t *&#160;</td>
    683. 

  683.           <td class="paramname"><em>out_size</em>&#160;</td>
    684. 

  684.         </tr>
    685. 

  685.         <tr>
    686. 

  686.           <td></td>
    687. 

  687.           <td>)</td>
    688. 

  688.           <td></td><td></td>
    689. 

  689.         </tr>
    690. 

  690.       </table>
    691. 

  691. </div><div class="memdoc">
    692. 

  692. <p>Computation of ephemeral ECC key and shared secret Z.</p>
    693. 

  693. <p>According to the description in TPM spec part 1 C 6.1 a shared secret between application and TPM is computed (ECDH). An ephemeral ECC key and a TPM keyare used for the ECDH key exchange. </p><dl class="params"><dt>Parameters</dt><dd>
    694. 

  694.   <table class="params">
    695. 

  695.     <tr><td class="paramdir">[in]</td><td class="paramname">key</td><td>The key to be used for ECDH key exchange. </td></tr>
    696. 

  696.     <tr><td class="paramdir">[in]</td><td class="paramname">max_out_size</td><td>the max size for the output of the public key of the computed ephemeral key. </td></tr>
    697. 

  697.     <tr><td class="paramdir">[out]</td><td class="paramname">Z</td><td>The computed shared secret. </td></tr>
    698. 

  698.     <tr><td class="paramdir">[out]</td><td class="paramname">Q</td><td>The public part of the ephemeral key in TPM format. </td></tr>
    699. 

  699.     <tr><td class="paramdir">[out]</td><td class="paramname">out_buffer</td><td>The public part of the ephemeral key will be marshaled to this buffer. </td></tr>
    700. 

  700.     <tr><td class="paramdir">[out]</td><td class="paramname">out_size</td><td>The size of the marshaled output. </td></tr>
    701. 

  701.   </table>
    702. 

  702.   </dd>
    703. 

  703. </dl>
    704. 

  704. <dl class="retval"><dt>Return values</dt><dd>
    705. 

  705.   <table class="retval">
    706. 

  706.     <tr><td class="paramname">TSS2_RC_SUCCESS</td><td>on success </td></tr>
    707. 

  707.     <tr><td class="paramname">TSS2_ESYS_RC_BAD_VALUE</td><td>The algorithm of key is not implemented. </td></tr>
    708. 

  708.     <tr><td class="paramname">TSS2_ESYS_RC_GENERAL_FAILURE</td><td>The internal crypto engine failed. </td></tr>
    709. 

  709.   </table>
    710. 

  710.   </dd>
    711. 

  711. </dl>
    712. 

  712. 

  713. </div>
    714. 

  714. </div>
    715. 

  715. <a id="ga35e28a2962a090e231bb4a8395a449d3"></a>
    716. 

  716. <h2 class="memtitle"><span class="permalink"><a href="#ga35e28a2962a090e231bb4a8395a449d3">&#9670;&nbsp;</a></span>iesys_cryptossl_hash_finish()</h2>
    717. 

  717. 

  718. <div class="memitem">
    719. 

  719. <div class="memproto">
    720. 

  720.       <table class="memname">
    721. 

  721.         <tr>
    722. 

  722.           <td class="memname">TSS2_RC iesys_cryptossl_hash_finish </td>
    723. 

  723.           <td>(</td>
    724. 

  724.           <td class="paramtype"><a class="el" href="struct___i_e_s_y_s___c_r_y_p_t_o___c_o_n_t_e_x_t.html">IESYS_CRYPTO_CONTEXT_BLOB</a> **&#160;</td>
    725. 

  725.           <td class="paramname"><em>context</em>, </td>
    726. 

  726.         </tr>
    727. 

  727.         <tr>
    728. 

  728.           <td class="paramkey"></td>
    729. 

  729.           <td></td>
    730. 

  730.           <td class="paramtype">uint8_t *&#160;</td>
    731. 

  731.           <td class="paramname"><em>buffer</em>, </td>
    732. 

  732.         </tr>
    733. 

  733.         <tr>
    734. 

  734.           <td class="paramkey"></td>
    735. 

  735.           <td></td>
    736. 

  736.           <td class="paramtype">size_t *&#160;</td>
    737. 

  737.           <td class="paramname"><em>size</em>&#160;</td>
    738. 

  738.         </tr>
    739. 

  739.         <tr>
    740. 

  740.           <td></td>
    741. 

  741.           <td>)</td>
    742. 

  742.           <td></td><td></td>
    743. 

  743.         </tr>
    744. 

  744.       </table>
    745. 

  745. </div><div class="memdoc">
    746. 

  746. <p>Get the digest value of a digest object and close the context.</p>
    747. 

  747. <p>The digest value will written to a passed buffer and the resources of the digest object are released. </p><dl class="params"><dt>Parameters</dt><dd>
    748. 

  748.   <table class="params">
    749. 

  749.     <tr><td class="paramdir">[in,out]</td><td class="paramname">context</td><td>The context of the digest object to be released </td></tr>
    750. 

  750.     <tr><td class="paramdir">[out]</td><td class="paramname">buffer</td><td>The buffer for the digest value (caller-allocated). </td></tr>
    751. 

  751.     <tr><td class="paramdir">[out]</td><td class="paramname">size</td><td>The size of the digest. </td></tr>
    752. 

  752.   </table>
    753. 

  753.   </dd>
    754. 

  754. </dl>
    755. 

  755. <dl class="retval"><dt>Return values</dt><dd>
    756. 

  756.   <table class="retval">
    757. 

  757.     <tr><td class="paramname">TSS2_RC_SUCCESS</td><td>on success. </td></tr>
    758. 

  758.     <tr><td class="paramname">TSS2_ESYS_RC_BAD_REFERENCE</td><td>for invalid parameters. </td></tr>
    759. 

  759.     <tr><td class="paramname">TSS2_ESYS_RC_GENERAL_FAILURE</td><td>for errors of the crypto library. </td></tr>
    760. 

  760.   </table>
    761. 

  761.   </dd>
    762. 

  762. </dl>
    763. 

  763. 

  764. </div>
    765. 

  765. </div>
    766. 

  766. <a id="ga82c55cd4b4a10b6f861d0e7299c3a56f"></a>
    767. 

  767. <h2 class="memtitle"><span class="permalink"><a href="#ga82c55cd4b4a10b6f861d0e7299c3a56f">&#9670;&nbsp;</a></span>iesys_cryptossl_hash_finish2b()</h2>
    768. 

  768. 

  769. <div class="memitem">
    770. 

  770. <div class="memproto">
    771. 

  771.       <table class="memname">
    772. 

  772.         <tr>
    773. 

  773.           <td class="memname">TSS2_RC iesys_cryptossl_hash_finish2b </td>
    774. 

  774.           <td>(</td>
    775. 

  775.           <td class="paramtype"><a class="el" href="struct___i_e_s_y_s___c_r_y_p_t_o___c_o_n_t_e_x_t.html">IESYS_CRYPTO_CONTEXT_BLOB</a> **&#160;</td>
    776. 

  776.           <td class="paramname"><em>context</em>, </td>
    777. 

  777.         </tr>
    778. 

  778.         <tr>
    779. 

  779.           <td class="paramkey"></td>
    780. 

  780.           <td></td>
    781. 

  781.           <td class="paramtype">TPM2B *&#160;</td>
    782. 

  782.           <td class="paramname"><em>b</em>&#160;</td>
    783. 

  783.         </tr>
    784. 

  784.         <tr>
    785. 

  785.           <td></td>
    786. 

  786.           <td>)</td>
    787. 

  787.           <td></td><td></td>
    788. 

  788.         </tr>
    789. 

  789.       </table>
    790. 

  790. </div><div class="memdoc">
    791. 

  791. <p>void iesys_cryptossl_hash_abort(IESYS_CRYPTO_CONTEXT_BLOB **context) </p>
    792. 

  792. 

  793. </div>
    794. 

  794. </div>
    795. 

  795. <a id="ga8a00762587e4d99700ad80ad448922b6"></a>
    796. 

  796. <h2 class="memtitle"><span class="permalink"><a href="#ga8a00762587e4d99700ad80ad448922b6">&#9670;&nbsp;</a></span>iesys_cryptossl_hash_start()</h2>
    797. 

  797. 

  798. <div class="memitem">
    799. 

  799. <div class="memproto">
    800. 

  800.       <table class="memname">
    801. 

  801.         <tr>
    802. 

  802.           <td class="memname">TSS2_RC iesys_cryptossl_hash_start </td>
    803. 

  803.           <td>(</td>
    804. 

  804.           <td class="paramtype"><a class="el" href="struct___i_e_s_y_s___c_r_y_p_t_o___c_o_n_t_e_x_t.html">IESYS_CRYPTO_CONTEXT_BLOB</a> **&#160;</td>
    805. 

  805.           <td class="paramname"><em>context</em>, </td>
    806. 

  806.         </tr>
    807. 

  807.         <tr>
    808. 

  808.           <td class="paramkey"></td>
    809. 

  809.           <td></td>
    810. 

  810.           <td class="paramtype">TPM2_ALG_ID&#160;</td>
    811. 

  811.           <td class="paramname"><em>hashAlg</em>&#160;</td>
    812. 

  812.         </tr>
    813. 

  813.         <tr>
    814. 

  814.           <td></td>
    815. 

  815.           <td>)</td>
    816. 

  816.           <td></td><td></td>
    817. 

  817.         </tr>
    818. 

  818.       </table>
    819. 

  819. </div><div class="memdoc">
    820. 

  820. <p>Provide the context for the computation of a hash digest.</p>
    821. 

  821. <p>The context will be created and initialized according to the hash function. </p><dl class="params"><dt>Parameters</dt><dd>
    822. 

  822.   <table class="params">
    823. 

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

  824.     <tr><td class="paramdir">[in]</td><td class="paramname">hashAlg</td><td>The hash algorithm for the creation of the context. </td></tr>
    825. 

  825.   </table>
    826. 

  826.   </dd>
    827. 

  827. </dl>
    828. 

  828. <dl class="retval"><dt>Return values</dt><dd>
    829. 

  829.   <table class="retval">
    830. 

  830.     <tr><td class="paramname">TSS2_RC_SUCCESS</td><td>on success. </td></tr>
    831. 

  831.     <tr><td class="paramname">TSS2_ESYS_RC_BAD_VALUE</td><td>or TSS2_ESYS_RC_BAD_REFERENCE for invalid parameters. </td></tr>
    832. 

  832.     <tr><td class="paramname">TSS2_ESYS_RC_MEMORY</td><td>Memory cannot be allocated. </td></tr>
    833. 

  833.     <tr><td class="paramname">TSS2_ESYS_RC_GENERAL_FAILURE</td><td>for errors of the crypto library. </td></tr>
    834. 

  834.   </table>
    835. 

  835.   </dd>
    836. 

  836. </dl>
    837. 

  837. 

  838. </div>
    839. 

  839. </div>
    840. 

  840. <a id="ga7db67b4e462804deb312b578dd7d23b3"></a>
    841. 

  841. <h2 class="memtitle"><span class="permalink"><a href="#ga7db67b4e462804deb312b578dd7d23b3">&#9670;&nbsp;</a></span>iesys_cryptossl_hash_update()</h2>
    842. 

  842. 

  843. <div class="memitem">
    844. 

  844. <div class="memproto">
    845. 

  845.       <table class="memname">
    846. 

  846.         <tr>
    847. 

  847.           <td class="memname">TSS2_RC iesys_cryptossl_hash_update </td>
    848. 

  848.           <td>(</td>
    849. 

  849.           <td class="paramtype"><a class="el" href="struct___i_e_s_y_s___c_r_y_p_t_o___c_o_n_t_e_x_t.html">IESYS_CRYPTO_CONTEXT_BLOB</a> *&#160;</td>
    850. 

  850.           <td class="paramname"><em>context</em>, </td>
    851. 

  851.         </tr>
    852. 

  852.         <tr>
    853. 

  853.           <td class="paramkey"></td>
    854. 

  854.           <td></td>
    855. 

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

  856.           <td class="paramname"><em>buffer</em>, </td>
    857. 

  857.         </tr>
    858. 

  858.         <tr>
    859. 

  859.           <td class="paramkey"></td>
    860. 

  860.           <td></td>
    861. 

  861.           <td class="paramtype">size_t&#160;</td>
    862. 

  862.           <td class="paramname"><em>size</em>&#160;</td>
    863. 

  863.         </tr>
    864. 

  864.         <tr>
    865. 

  865.           <td></td>
    866. 

  866.           <td>)</td>
    867. 

  867.           <td></td><td></td>
    868. 

  868.         </tr>
    869. 

  869.       </table>
    870. 

  870. </div><div class="memdoc">
    871. 

  871. <p>Update the digest value of a digest object from a byte buffer.</p>
    872. 

  872. <p>The context of a digest object will be updated according to the hash algorithm of the context. &lt; </p><dl class="params"><dt>Parameters</dt><dd>
    873. 

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

  874.     <tr><td class="paramdir">[in,out]</td><td class="paramname">context</td><td>The context of the digest object which will be updated. </td></tr>
    875. 

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

  876.     <tr><td class="paramdir">[in]</td><td class="paramname">size</td><td>The size of the data buffer. </td></tr>
    877. 

  877.   </table>
    878. 

  878.   </dd>
    879. 

  879. </dl>
    880. 

  880. <dl class="retval"><dt>Return values</dt><dd>
    881. 

  881.   <table class="retval">
    882. 

  882.     <tr><td class="paramname">TSS2_RC_SUCCESS</td><td>on success. </td></tr>
    883. 

  883.     <tr><td class="paramname">TSS2_ESYS_RC_BAD_REFERENCE</td><td>for invalid parameters. </td></tr>
    884. 

  884.   </table>
    885. 

  885.   </dd>
    886. 

  886. </dl>
    887. 

  887. 

  888. </div>
    889. 

  889. </div>
    890. 

  890. <a id="ga16999a8a80afd7a4c3c6a91c457e9ed3"></a>
    891. 

  891. <h2 class="memtitle"><span class="permalink"><a href="#ga16999a8a80afd7a4c3c6a91c457e9ed3">&#9670;&nbsp;</a></span>iesys_cryptossl_hash_update2b()</h2>
    892. 

  892. 

  893. <div class="memitem">
    894. 

  894. <div class="memproto">
    895. 

  895.       <table class="memname">
    896. 

  896.         <tr>
    897. 

  897.           <td class="memname">TSS2_RC iesys_cryptossl_hash_update2b </td>
    898. 

  898.           <td>(</td>
    899. 

  899.           <td class="paramtype"><a class="el" href="struct___i_e_s_y_s___c_r_y_p_t_o___c_o_n_t_e_x_t.html">IESYS_CRYPTO_CONTEXT_BLOB</a> *&#160;</td>
    900. 

  900.           <td class="paramname"><em>context</em>, </td>
    901. 

  901.         </tr>
    902. 

  902.         <tr>
    903. 

  903.           <td class="paramkey"></td>
    904. 

  904.           <td></td>
    905. 

  905.           <td class="paramtype">TPM2B *&#160;</td>
    906. 

  906.           <td class="paramname"><em>b</em>&#160;</td>
    907. 

  907.         </tr>
    908. 

  908.         <tr>
    909. 

  909.           <td></td>
    910. 

  910.           <td>)</td>
    911. 

  911.           <td></td><td></td>
    912. 

  912.         </tr>
    913. 

  913.       </table>
    914. 

  914. </div><div class="memdoc">
    915. 

  915. <p>Update the digest value of a digest object from a TPM2B object.</p>
    916. 

  916. <p>The context of a digest object will be updated according to the hash algorithm of the context. </p><dl class="params"><dt>Parameters</dt><dd>
    917. 

  917.   <table class="params">
    918. 

  918.     <tr><td class="paramdir">[in,out]</td><td class="paramname">context</td><td>The context of the digest object which will be updated. </td></tr>
    919. 

  919.     <tr><td class="paramdir">[in]</td><td class="paramname">b</td><td>The TPM2B object for the update. </td></tr>
    920. 

  920.   </table>
    921. 

  921.   </dd>
    922. 

  922. </dl>
    923. 

  923. <dl class="retval"><dt>Return values</dt><dd>
    924. 

  924.   <table class="retval">
    925. 

  925.     <tr><td class="paramname">TSS2_RC_SUCCESS</td><td>on success. </td></tr>
    926. 

  926.     <tr><td class="paramname">TSS2_ESYS_RC_BAD_REFERENCE</td><td>for invalid parameters. </td></tr>
    927. 

  927.   </table>
    928. 

  928.   </dd>
    929. 

  929. </dl>
    930. 

  930. 

  931. </div>
    932. 

  932. </div>
    933. 

  933. <a id="ga55c3c4be43371ff9dc984434c686831c"></a>
    934. 

  934. <h2 class="memtitle"><span class="permalink"><a href="#ga55c3c4be43371ff9dc984434c686831c">&#9670;&nbsp;</a></span>iesys_cryptossl_hmac_abort()</h2>
    935. 

  935. 

  936. <div class="memitem">
    937. 

  937. <div class="memproto">
    938. 

  938.       <table class="memname">
    939. 

  939.         <tr>
    940. 

  940.           <td class="memname">void iesys_cryptossl_hmac_abort </td>
    941. 

  941.           <td>(</td>
    942. 

  942.           <td class="paramtype"><a class="el" href="struct___i_e_s_y_s___c_r_y_p_t_o___c_o_n_t_e_x_t.html">IESYS_CRYPTO_CONTEXT_BLOB</a> **&#160;</td>
    943. 

  943.           <td class="paramname"><em>context</em></td><td>)</td>
    944. 

  944.           <td></td>
    945. 

  945.         </tr>
    946. 

  946.       </table>
    947. 

  947. </div><div class="memdoc">
    948. 

  948. <p>Release the resources of an HAMC object.</p>
    949. 

  949. <p>The assigned resources will be released and the context will be set to NULL. </p><dl class="params"><dt>Parameters</dt><dd>
    950. 

  950.   <table class="params">
    951. 

  951.     <tr><td class="paramdir">[in,out]</td><td class="paramname">context</td><td>The context of the HMAC object. </td></tr>
    952. 

  952.   </table>
    953. 

  953.   </dd>
    954. 

  954. </dl>
    955. 

  955. 

  956. </div>
    957. 

  957. </div>
    958. 

  958. <a id="ga139ec4dc810310a89bf60fa28f146e96"></a>
    959. 

  959. <h2 class="memtitle"><span class="permalink"><a href="#ga139ec4dc810310a89bf60fa28f146e96">&#9670;&nbsp;</a></span>iesys_cryptossl_hmac_finish()</h2>
    960. 

  960. 

  961. <div class="memitem">
    962. 

  962. <div class="memproto">
    963. 

  963.       <table class="memname">
    964. 

  964.         <tr>
    965. 

  965.           <td class="memname">TSS2_RC iesys_cryptossl_hmac_finish </td>
    966. 

  966.           <td>(</td>
    967. 

  967.           <td class="paramtype"><a class="el" href="struct___i_e_s_y_s___c_r_y_p_t_o___c_o_n_t_e_x_t.html">IESYS_CRYPTO_CONTEXT_BLOB</a> **&#160;</td>
    968. 

  968.           <td class="paramname"><em>context</em>, </td>
    969. 

  969.         </tr>
    970. 

  970.         <tr>
    971. 

  971.           <td class="paramkey"></td>
    972. 

  972.           <td></td>
    973. 

  973.           <td class="paramtype">uint8_t *&#160;</td>
    974. 

  974.           <td class="paramname"><em>buffer</em>, </td>
    975. 

  975.         </tr>
    976. 

  976.         <tr>
    977. 

  977.           <td class="paramkey"></td>
    978. 

  978.           <td></td>
    979. 

  979.           <td class="paramtype">size_t *&#160;</td>
    980. 

  980.           <td class="paramname"><em>size</em>&#160;</td>
    981. 

  981.         </tr>
    982. 

  982.         <tr>
    983. 

  983.           <td></td>
    984. 

  984.           <td>)</td>
    985. 

  985.           <td></td><td></td>
    986. 

  986.         </tr>
    987. 

  987.       </table>
    988. 

  988. </div><div class="memdoc">
    989. 

  989. <p>Write the HMAC digest value to a byte buffer and close the context.</p>
    990. 

  990. <p>The digest value will written to a passed buffer and the resources of the HMAC object are released. </p><dl class="params"><dt>Parameters</dt><dd>
    991. 

  991.   <table class="params">
    992. 

  992.     <tr><td class="paramdir">[in,out]</td><td class="paramname">context</td><td>The context of the HMAC object. </td></tr>
    993. 

  993.     <tr><td class="paramdir">[out]</td><td class="paramname">buffer</td><td>The buffer for the digest value (caller-allocated). </td></tr>
    994. 

  994.     <tr><td class="paramdir">[out]</td><td class="paramname">size</td><td>The size of the digest. </td></tr>
    995. 

  995.   </table>
    996. 

  996.   </dd>
    997. 

  997. </dl>
    998. 

  998. <dl class="retval"><dt>Return values</dt><dd>
    999. 

  999.   <table class="retval">
    1000. 

  1000.     <tr><td class="paramname">TSS2_RC_SUCCESS</td><td>on success. </td></tr>
    1001. 

  1001.     <tr><td class="paramname">TSS2_ESYS_RC_BAD_REFERENCE</td><td>for invalid parameters. </td></tr>
    1002. 

  1002.     <tr><td class="paramname">TSS2_ESYS_RC_BAD_SIZE</td><td>If the size passed is lower than the HMAC length. </td></tr>
    1003. 

  1003.     <tr><td class="paramname">TSS2_ESYS_RC_GENERAL_FAILURE</td><td>for errors of the crypto library. </td></tr>
    1004. 

  1004.   </table>
    1005. 

  1005.   </dd>
    1006. 

  1006. </dl>
    1007. 

  1007. 

  1008. </div>
    1009. 

  1009. </div>
    1010. 

  1010. <a id="ga7c38dee8ff84865ea817637906a1705b"></a>
    1011. 

  1011. <h2 class="memtitle"><span class="permalink"><a href="#ga7c38dee8ff84865ea817637906a1705b">&#9670;&nbsp;</a></span>iesys_cryptossl_hmac_finish2b()</h2>
    1012. 

  1012. 

  1013. <div class="memitem">
    1014. 

  1014. <div class="memproto">
    1015. 

  1015.       <table class="memname">
    1016. 

  1016.         <tr>
    1017. 

  1017.           <td class="memname">TSS2_RC iesys_cryptossl_hmac_finish2b </td>
    1018. 

  1018.           <td>(</td>
    1019. 

  1019.           <td class="paramtype"><a class="el" href="struct___i_e_s_y_s___c_r_y_p_t_o___c_o_n_t_e_x_t.html">IESYS_CRYPTO_CONTEXT_BLOB</a> **&#160;</td>
    1020. 

  1020.           <td class="paramname"><em>context</em>, </td>
    1021. 

  1021.         </tr>
    1022. 

  1022.         <tr>
    1023. 

  1023.           <td class="paramkey"></td>
    1024. 

  1024.           <td></td>
    1025. 

  1025.           <td class="paramtype">TPM2B *&#160;</td>
    1026. 

  1026.           <td class="paramname"><em>hmac</em>&#160;</td>
    1027. 

  1027.         </tr>
    1028. 

  1028.         <tr>
    1029. 

  1029.           <td></td>
    1030. 

  1030.           <td>)</td>
    1031. 

  1031.           <td></td><td></td>
    1032. 

  1032.         </tr>
    1033. 

  1033.       </table>
    1034. 

  1034. </div><div class="memdoc">
    1035. 

  1035. <p>Write the HMAC digest value to a TPM2B object and close the context.</p>
    1036. 

  1036. <p>The digest value will written to a passed TPM2B object and the resources of the HMAC object are released. </p><dl class="params"><dt>Parameters</dt><dd>
    1037. 

  1037.   <table class="params">
    1038. 

  1038.     <tr><td class="paramdir">[in,out]</td><td class="paramname">context</td><td>The context of the HMAC object. </td></tr>
    1039. 

  1039.     <tr><td class="paramdir">[out]</td><td class="paramname">hmac</td><td>The buffer for the digest value (caller-allocated). </td></tr>
    1040. 

  1040.   </table>
    1041. 

  1041.   </dd>
    1042. 

  1042. </dl>
    1043. 

  1043. <dl class="retval"><dt>Return values</dt><dd>
    1044. 

  1044.   <table class="retval">
    1045. 

  1045.     <tr><td class="paramname">TSS2_RC_SUCCESS</td><td>on success. </td></tr>
    1046. 

  1046.     <tr><td class="paramname">TSS2_ESYS_RC_BAD_REFERENCE</td><td>for invalid parameters. </td></tr>
    1047. 

  1047.     <tr><td class="paramname">TSS2_ESYS_RC_BAD_SIZE</td><td>if the size passed is lower than the HMAC length. </td></tr>
    1048. 

  1048.     <tr><td class="paramname">TSS2_ESYS_RC_GENERAL_FAILURE</td><td>for errors of the crypto library. </td></tr>
    1049. 

  1049.   </table>
    1050. 

  1050.   </dd>
    1051. 

  1051. </dl>
    1052. 

  1052. 

  1053. </div>
    1054. 

  1054. </div>
    1055. 

  1055. <a id="ga0d7703e693a61c7786b654021b138461"></a>
    1056. 

  1056. <h2 class="memtitle"><span class="permalink"><a href="#ga0d7703e693a61c7786b654021b138461">&#9670;&nbsp;</a></span>iesys_cryptossl_hmac_start()</h2>
    1057. 

  1057. 

  1058. <div class="memitem">
    1059. 

  1059. <div class="memproto">
    1060. 

  1060.       <table class="memname">
    1061. 

  1061.         <tr>
    1062. 

  1062.           <td class="memname">TSS2_RC iesys_cryptossl_hmac_start </td>
    1063. 

  1063.           <td>(</td>
    1064. 

  1064.           <td class="paramtype"><a class="el" href="struct___i_e_s_y_s___c_r_y_p_t_o___c_o_n_t_e_x_t.html">IESYS_CRYPTO_CONTEXT_BLOB</a> **&#160;</td>
    1065. 

  1065.           <td class="paramname"><em>context</em>, </td>
    1066. 

  1066.         </tr>
    1067. 

  1067.         <tr>
    1068. 

  1068.           <td class="paramkey"></td>
    1069. 

  1069.           <td></td>
    1070. 

  1070.           <td class="paramtype">TPM2_ALG_ID&#160;</td>
    1071. 

  1071.           <td class="paramname"><em>hashAlg</em>, </td>
    1072. 

  1072.         </tr>
    1073. 

  1073.         <tr>
    1074. 

  1074.           <td class="paramkey"></td>
    1075. 

  1075.           <td></td>
    1076. 

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

  1077.           <td class="paramname"><em>key</em>, </td>
    1078. 

  1078.         </tr>
    1079. 

  1079.         <tr>
    1080. 

  1080.           <td class="paramkey"></td>
    1081. 

  1081.           <td></td>
    1082. 

  1082.           <td class="paramtype">size_t&#160;</td>
    1083. 

  1083.           <td class="paramname"><em>size</em>&#160;</td>
    1084. 

  1084.         </tr>
    1085. 

  1085.         <tr>
    1086. 

  1086.           <td></td>
    1087. 

  1087.           <td>)</td>
    1088. 

  1088.           <td></td><td></td>
    1089. 

  1089.         </tr>
    1090. 

  1090.       </table>
    1091. 

  1091. </div><div class="memdoc">
    1092. 

  1092. <p>Provide the context an HMAC digest object from a byte buffer key.</p>
    1093. 

  1093. <p>The context will be created and initialized according to the hash function and the used HMAC key. </p><dl class="params"><dt>Parameters</dt><dd>
    1094. 

  1094.   <table class="params">
    1095. 

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

  1096.     <tr><td class="paramdir">[in]</td><td class="paramname">hashAlg</td><td>The hash algorithm for the HMAC computation. </td></tr>
    1097. 

  1097.     <tr><td class="paramdir">[in]</td><td class="paramname">key</td><td>The byte buffer of the HMAC key. </td></tr>
    1098. 

  1098.     <tr><td class="paramdir">[in]</td><td class="paramname">size</td><td>The size of the HMAC key. </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_ESYS_RC_BAD_REFERENCE</td><td>for invalid parameters. </td></tr>
    1106. 

  1106.     <tr><td class="paramname">TSS2_ESYS_RC_MEMORY</td><td>Memory cannot be allocated. </td></tr>
    1107. 

  1107.     <tr><td class="paramname">TSS2_ESYS_RC_GENERAL_FAILURE</td><td>for errors of the crypto library. </td></tr>
    1108. 

  1108.   </table>
    1109. 

  1109.   </dd>
    1110. 

  1110. </dl>
    1111. 

  1111. 

  1112. </div>
    1113. 

  1113. </div>
    1114. 

  1114. <a id="ga38c55dcb7af1740f2c88c6a13714d0f4"></a>
    1115. 

  1115. <h2 class="memtitle"><span class="permalink"><a href="#ga38c55dcb7af1740f2c88c6a13714d0f4">&#9670;&nbsp;</a></span>iesys_cryptossl_hmac_update()</h2>
    1116. 

  1116. 

  1117. <div class="memitem">
    1118. 

  1118. <div class="memproto">
    1119. 

  1119.       <table class="memname">
    1120. 

  1120.         <tr>
    1121. 

  1121.           <td class="memname">TSS2_RC iesys_cryptossl_hmac_update </td>
    1122. 

  1122.           <td>(</td>
    1123. 

  1123.           <td class="paramtype"><a class="el" href="struct___i_e_s_y_s___c_r_y_p_t_o___c_o_n_t_e_x_t.html">IESYS_CRYPTO_CONTEXT_BLOB</a> *&#160;</td>
    1124. 

  1124.           <td class="paramname"><em>context</em>, </td>
    1125. 

  1125.         </tr>
    1126. 

  1126.         <tr>
    1127. 

  1127.           <td class="paramkey"></td>
    1128. 

  1128.           <td></td>
    1129. 

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

  1130.           <td class="paramname"><em>buffer</em>, </td>
    1131. 

  1131.         </tr>
    1132. 

  1132.         <tr>
    1133. 

  1133.           <td class="paramkey"></td>
    1134. 

  1134.           <td></td>
    1135. 

  1135.           <td class="paramtype">size_t&#160;</td>
    1136. 

  1136.           <td class="paramname"><em>size</em>&#160;</td>
    1137. 

  1137.         </tr>
    1138. 

  1138.         <tr>
    1139. 

  1139.           <td></td>
    1140. 

  1140.           <td>)</td>
    1141. 

  1141.           <td></td><td></td>
    1142. 

  1142.         </tr>
    1143. 

  1143.       </table>
    1144. 

  1144. </div><div class="memdoc">
    1145. 

  1145. <p>Update and HMAC digest value from a byte buffer.</p>
    1146. 

  1146. <p>The context of a digest object will be updated according to the hash algorithm and the key of the context. </p><dl class="params"><dt>Parameters</dt><dd>
    1147. 

  1147.   <table class="params">
    1148. 

  1148.     <tr><td class="paramdir">[in,out]</td><td class="paramname">context</td><td>The context of the digest object which will be updated. </td></tr>
    1149. 

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

  1150.     <tr><td class="paramdir">[in]</td><td class="paramname">size</td><td>The size of the data buffer. </td></tr>
    1151. 

  1151.   </table>
    1152. 

  1152.   </dd>
    1153. 

  1153. </dl>
    1154. 

  1154. <dl class="retval"><dt>Return values</dt><dd>
    1155. 

  1155.   <table class="retval">
    1156. 

  1156.     <tr><td class="paramname">TSS2_RC_SUCCESS</td><td>on success. </td></tr>
    1157. 

  1157.     <tr><td class="paramname">TSS2_ESYS_RC_BAD_REFERENCE</td><td>for invalid parameters. </td></tr>
    1158. 

  1158.   </table>
    1159. 

  1159.   </dd>
    1160. 

  1160. </dl>
    1161. 

  1161. 

  1162. </div>
    1163. 

  1163. </div>
    1164. 

  1164. <a id="ga293339e25fee12b919a656c8f4b66f90"></a>
    1165. 

  1165. <h2 class="memtitle"><span class="permalink"><a href="#ga293339e25fee12b919a656c8f4b66f90">&#9670;&nbsp;</a></span>iesys_cryptossl_hmac_update2b()</h2>
    1166. 

  1166. 

  1167. <div class="memitem">
    1168. 

  1168. <div class="memproto">
    1169. 

  1169.       <table class="memname">
    1170. 

  1170.         <tr>
    1171. 

  1171.           <td class="memname">TSS2_RC iesys_cryptossl_hmac_update2b </td>
    1172. 

  1172.           <td>(</td>
    1173. 

  1173.           <td class="paramtype"><a class="el" href="struct___i_e_s_y_s___c_r_y_p_t_o___c_o_n_t_e_x_t.html">IESYS_CRYPTO_CONTEXT_BLOB</a> *&#160;</td>
    1174. 

  1174.           <td class="paramname"><em>context</em>, </td>
    1175. 

  1175.         </tr>
    1176. 

  1176.         <tr>
    1177. 

  1177.           <td class="paramkey"></td>
    1178. 

  1178.           <td></td>
    1179. 

  1179.           <td class="paramtype">TPM2B *&#160;</td>
    1180. 

  1180.           <td class="paramname"><em>b</em>&#160;</td>
    1181. 

  1181.         </tr>
    1182. 

  1182.         <tr>
    1183. 

  1183.           <td></td>
    1184. 

  1184.           <td>)</td>
    1185. 

  1185.           <td></td><td></td>
    1186. 

  1186.         </tr>
    1187. 

  1187.       </table>
    1188. 

  1188. </div><div class="memdoc">
    1189. 

  1189. <p>Update and HMAC digest value from a TPM2B object.</p>
    1190. 

  1190. <p>The context of a digest object will be updated according to the hash algorithm and the key of the context. </p><dl class="params"><dt>Parameters</dt><dd>
    1191. 

  1191.   <table class="params">
    1192. 

  1192.     <tr><td class="paramdir">[in,out]</td><td class="paramname">context</td><td>The context of the digest object which will be updated. </td></tr>
    1193. 

  1193.     <tr><td class="paramdir">[in]</td><td class="paramname">b</td><td>The TPM2B object for the update. </td></tr>
    1194. 

  1194.   </table>
    1195. 

  1195.   </dd>
    1196. 

  1196. </dl>
    1197. 

  1197. <dl class="retval"><dt>Return values</dt><dd>
    1198. 

  1198.   <table class="retval">
    1199. 

  1199.     <tr><td class="paramname">TSS2_RC_SUCCESS</td><td>on success. </td></tr>
    1200. 

  1200.     <tr><td class="paramname">TSS2_ESYS_RC_BAD_REFERENCE</td><td>for invalid parameters. </td></tr>
    1201. 

  1201.   </table>
    1202. 

  1202.   </dd>
    1203. 

  1203. </dl>
    1204. 

  1204. 

  1205. </div>
    1206. 

  1206. </div>
    1207. 

  1207. <a id="gab23845f7778d674b6c08d6d1f2ed1bce"></a>
    1208. 

  1208. <h2 class="memtitle"><span class="permalink"><a href="#gab23845f7778d674b6c08d6d1f2ed1bce">&#9670;&nbsp;</a></span>iesys_cryptossl_pk_encrypt()</h2>
    1209. 

  1209. 

  1210. <div class="memitem">
    1211. 

  1211. <div class="memproto">
    1212. 

  1212.       <table class="memname">
    1213. 

  1213.         <tr>
    1214. 

  1214.           <td class="memname">TSS2_RC iesys_cryptossl_pk_encrypt </td>
    1215. 

  1215.           <td>(</td>
    1216. 

  1216.           <td class="paramtype">TPM2B_PUBLIC *&#160;</td>
    1217. 

  1217.           <td class="paramname"><em>pub_tpm_key</em>, </td>
    1218. 

  1218.         </tr>
    1219. 

  1219.         <tr>
    1220. 

  1220.           <td class="paramkey"></td>
    1221. 

  1221.           <td></td>
    1222. 

  1222.           <td class="paramtype">size_t&#160;</td>
    1223. 

  1223.           <td class="paramname"><em>in_size</em>, </td>
    1224. 

  1224.         </tr>
    1225. 

  1225.         <tr>
    1226. 

  1226.           <td class="paramkey"></td>
    1227. 

  1227.           <td></td>
    1228. 

  1228.           <td class="paramtype">BYTE *&#160;</td>
    1229. 

  1229.           <td class="paramname"><em>in_buffer</em>, </td>
    1230. 

  1230.         </tr>
    1231. 

  1231.         <tr>
    1232. 

  1232.           <td class="paramkey"></td>
    1233. 

  1233.           <td></td>
    1234. 

  1234.           <td class="paramtype">size_t&#160;</td>
    1235. 

  1235.           <td class="paramname"><em>max_out_size</em>, </td>
    1236. 

  1236.         </tr>
    1237. 

  1237.         <tr>
    1238. 

  1238.           <td class="paramkey"></td>
    1239. 

  1239.           <td></td>
    1240. 

  1240.           <td class="paramtype">BYTE *&#160;</td>
    1241. 

  1241.           <td class="paramname"><em>out_buffer</em>, </td>
    1242. 

  1242.         </tr>
    1243. 

  1243.         <tr>
    1244. 

  1244.           <td class="paramkey"></td>
    1245. 

  1245.           <td></td>
    1246. 

  1246.           <td class="paramtype">size_t *&#160;</td>
    1247. 

  1247.           <td class="paramname"><em>out_size</em>, </td>
    1248. 

  1248.         </tr>
    1249. 

  1249.         <tr>
    1250. 

  1250.           <td class="paramkey"></td>
    1251. 

  1251.           <td></td>
    1252. 

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

  1253.           <td class="paramname"><em>label</em>&#160;</td>
    1254. 

  1254.         </tr>
    1255. 

  1255.         <tr>
    1256. 

  1256.           <td></td>
    1257. 

  1257.           <td>)</td>
    1258. 

  1258.           <td></td><td></td>
    1259. 

  1259.         </tr>
    1260. 

  1260.       </table>
    1261. 

  1261. </div><div class="memdoc">
    1262. 

  1262. <p>Encryption of a buffer using a public (RSA) key.</p>
    1263. 

  1263. <p>Encrypting a buffer using a public key is used for example during Esys_StartAuthSession in order to encrypt the salt value. </p><dl class="params"><dt>Parameters</dt><dd>
    1264. 

  1264.   <table class="params">
    1265. 

  1265.     <tr><td class="paramdir">[in]</td><td class="paramname">pub_tpm_key</td><td>The key to be used for encryption. </td></tr>
    1266. 

  1266.     <tr><td class="paramdir">[in]</td><td class="paramname">in_size</td><td>The size of the buffer to be encrypted. </td></tr>
    1267. 

  1267.     <tr><td class="paramdir">[in]</td><td class="paramname">in_buffer</td><td>The data buffer to be encrypted. </td></tr>
    1268. 

  1268.     <tr><td class="paramdir">[in]</td><td class="paramname">max_out_size</td><td>The maximum size for the output encrypted buffer. </td></tr>
    1269. 

  1269.     <tr><td class="paramdir">[out]</td><td class="paramname">out_buffer</td><td>The encrypted buffer. </td></tr>
    1270. 

  1270.     <tr><td class="paramdir">[out]</td><td class="paramname">out_size</td><td>The size of the encrypted output. </td></tr>
    1271. 

  1271.     <tr><td class="paramdir">[in]</td><td class="paramname">label</td><td>The label used in the encryption scheme. </td></tr>
    1272. 

  1272.   </table>
    1273. 

  1273.   </dd>
    1274. 

  1274. </dl>
    1275. 

  1275. <dl class="retval"><dt>Return values</dt><dd>
    1276. 

  1276.   <table class="retval">
    1277. 

  1277.     <tr><td class="paramname">TSS2_RC_SUCCESS</td><td>on success </td></tr>
    1278. 

  1278.     <tr><td class="paramname">TSS2_ESYS_RC_BAD_VALUE</td><td>The algorithm of key is not implemented. </td></tr>
    1279. 

  1279.     <tr><td class="paramname">TSS2_ESYS_RC_GENERAL_FAILURE</td><td>The internal crypto engine failed. </td></tr>
    1280. 

  1280.   </table>
    1281. 

  1281.   </dd>
    1282. 

  1282. </dl>
    1283. 

  1283. 

  1284. </div>
    1285. 

  1285. </div>
    1286. 

  1286. <a id="ga7d954265e28d2891f6700fa514df3f10"></a>
    1287. 

  1287. <h2 class="memtitle"><span class="permalink"><a href="#ga7d954265e28d2891f6700fa514df3f10">&#9670;&nbsp;</a></span>iesys_cryptossl_random2b()</h2>
    1288. 

  1288. 

  1289. <div class="memitem">
    1290. 

  1290. <div class="memproto">
    1291. 

  1291.       <table class="memname">
    1292. 

  1292.         <tr>
    1293. 

  1293.           <td class="memname">TSS2_RC iesys_cryptossl_random2b </td>
    1294. 

  1294.           <td>(</td>
    1295. 

  1295.           <td class="paramtype">TPM2B_NONCE *&#160;</td>
    1296. 

  1296.           <td class="paramname"><em>nonce</em>, </td>
    1297. 

  1297.         </tr>
    1298. 

  1298.         <tr>
    1299. 

  1299.           <td class="paramkey"></td>
    1300. 

  1300.           <td></td>
    1301. 

  1301.           <td class="paramtype">size_t&#160;</td>
    1302. 

  1302.           <td class="paramname"><em>num_bytes</em>&#160;</td>
    1303. 

  1303.         </tr>
    1304. 

  1304.         <tr>
    1305. 

  1305.           <td></td>
    1306. 

  1306.           <td>)</td>
    1307. 

  1307.           <td></td><td></td>
    1308. 

  1308.         </tr>
    1309. 

  1309.       </table>
    1310. 

  1310. </div><div class="memdoc">
    1311. 

  1311. <p>Compute random TPM2B data.</p>
    1312. 

  1312. <p>The random data will be generated and written to a passed TPM2B structure. </p><dl class="params"><dt>Parameters</dt><dd>
    1313. 

  1313.   <table class="params">
    1314. 

  1314.     <tr><td class="paramdir">[out]</td><td class="paramname">nonce</td><td>The TPM2B structure for the random data (caller-allocated). </td></tr>
    1315. 

  1315.     <tr><td class="paramdir">[in]</td><td class="paramname">num_bytes</td><td>The number of bytes to be generated. </td></tr>
    1316. 

  1316.   </table>
    1317. 

  1317.   </dd>
    1318. 

  1318. </dl>
    1319. 

  1319. <dl class="retval"><dt>Return values</dt><dd>
    1320. 

  1320.   <table class="retval">
    1321. 

  1321.     <tr><td class="paramname">TSS2_RC_SUCCESS</td><td>on success.</td></tr>
    1322. 

  1322.   </table>
    1323. 

  1323.   </dd>
    1324. 

  1324. </dl>
    1325. 

  1325. <p>NOTE: the TPM should not be used to obtain the random data </p>
    1326. 

  1326. 

  1327. </div>
    1328. 

  1328. </div>
    1329. 

  1329. <a id="gaae1d6a57770b8e1b665bf27a06899bc6"></a>
    1330. 

  1330. <h2 class="memtitle"><span class="permalink"><a href="#gaae1d6a57770b8e1b665bf27a06899bc6">&#9670;&nbsp;</a></span>iesys_xor_parameter_obfuscation()</h2>
    1331. 

  1331. 

  1332. <div class="memitem">
    1333. 

  1333. <div class="memproto">
    1334. 

  1334.       <table class="memname">
    1335. 

  1335.         <tr>
    1336. 

  1336.           <td class="memname">TSS2_RC iesys_xor_parameter_obfuscation </td>
    1337. 

  1337.           <td>(</td>
    1338. 

  1338.           <td class="paramtype">TPM2_ALG_ID&#160;</td>
    1339. 

  1339.           <td class="paramname"><em>hash_alg</em>, </td>
    1340. 

  1340.         </tr>
    1341. 

  1341.         <tr>
    1342. 

  1342.           <td class="paramkey"></td>
    1343. 

  1343.           <td></td>
    1344. 

  1344.           <td class="paramtype">uint8_t *&#160;</td>
    1345. 

  1345.           <td class="paramname"><em>key</em>, </td>
    1346. 

  1346.         </tr>
    1347. 

  1347.         <tr>
    1348. 

  1348.           <td class="paramkey"></td>
    1349. 

  1349.           <td></td>
    1350. 

  1350.           <td class="paramtype">size_t&#160;</td>
    1351. 

  1351.           <td class="paramname"><em>key_size</em>, </td>
    1352. 

  1352.         </tr>
    1353. 

  1353.         <tr>
    1354. 

  1354.           <td class="paramkey"></td>
    1355. 

  1355.           <td></td>
    1356. 

  1356.           <td class="paramtype">TPM2B_NONCE *&#160;</td>
    1357. 

  1357.           <td class="paramname"><em>contextU</em>, </td>
    1358. 

  1358.         </tr>
    1359. 

  1359.         <tr>
    1360. 

  1360.           <td class="paramkey"></td>
    1361. 

  1361.           <td></td>
    1362. 

  1362.           <td class="paramtype">TPM2B_NONCE *&#160;</td>
    1363. 

  1363.           <td class="paramname"><em>contextV</em>, </td>
    1364. 

  1364.         </tr>
    1365. 

  1365.         <tr>
    1366. 

  1366.           <td class="paramkey"></td>
    1367. 

  1367.           <td></td>
    1368. 

  1368.           <td class="paramtype">BYTE *&#160;</td>
    1369. 

  1369.           <td class="paramname"><em>data</em>, </td>
    1370. 

  1370.         </tr>
    1371. 

  1371.         <tr>
    1372. 

  1372.           <td class="paramkey"></td>
    1373. 

  1373.           <td></td>
    1374. 

  1374.           <td class="paramtype">size_t&#160;</td>
    1375. 

  1375.           <td class="paramname"><em>data_size</em>&#160;</td>
    1376. 

  1376.         </tr>
    1377. 

  1377.         <tr>
    1378. 

  1378.           <td></td>
    1379. 

  1379.           <td>)</td>
    1380. 

  1380.           <td></td><td></td>
    1381. 

  1381.         </tr>
    1382. 

  1382.       </table>
    1383. 

  1383. </div><div class="memdoc">
    1384. 

  1384. <p>Encryption/Decryption using XOR obfuscation.</p>
    1385. 

  1385. <p>The application of this function to data encrypted with this function will produce the origin data. The key for XOR obfuscation will be derived with KDFa form the passed key the session nonces, and the hash algorithm. </p><dl class="params"><dt>Parameters</dt><dd>
    1386. 

  1386.   <table class="params">
    1387. 

  1387.     <tr><td class="paramdir">[in]</td><td class="paramname">hash_alg</td><td>The algorithm used for key derivation. </td></tr>
    1388. 

  1388.     <tr><td class="paramdir">[in]</td><td class="paramname">key</td><td>key used for obfuscation </td></tr>
    1389. 

  1389.     <tr><td class="paramdir">[in]</td><td class="paramname">key_size</td><td>Key size in bits. </td></tr>
    1390. 

  1390.     <tr><td class="paramdir">[in]</td><td class="paramname">contextU,contextV</td><td>are used for construction of a binary string containing information related to the derived key. </td></tr>
    1391. 

  1391.     <tr><td class="paramdir">[in,out]</td><td class="paramname">data</td><td>Data to be encrypted/decrypted the result will be will be stored in this buffer. </td></tr>
    1392. 

  1392.     <tr><td class="paramdir">[in]</td><td class="paramname">data_size</td><td>size of data to be encrypted/decrypted. </td></tr>
    1393. 

  1393.   </table>
    1394. 

  1394.   </dd>
    1395. 

  1395. </dl>
    1396. 

  1396. <dl class="retval"><dt>Return values</dt><dd>
    1397. 

  1397.   <table class="retval">
    1398. 

  1398.     <tr><td class="paramname">TSS2_RC_SUCCESS</td><td>on success, or TSS2_ESYS_RC_BAD_VALUE and </td></tr>
    1399. 

  1399.     <tr><td class="paramname">TSS2_ESYS_RC_BAD_REFERENCE</td><td>for invalid parameters. </td></tr>
    1400. 

  1400.   </table>
    1401. 

  1401.   </dd>
    1402. 

  1402. </dl>
    1403. 

  1403. 

  1404. </div>
    1405. 

  1405. </div>
    1406. 

  1406. </div><!-- contents -->
    1407. 

  1407. </div><!-- doc-content -->
    1408. 

  1408. <!-- start footer part -->
    1409. 

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

  1410.   <ul>
    1411. 

  1411.     <li class="footer">Generated by
    1412. 

  1412.     <a href="http://www.doxygen.org/index.html">
    1413. 

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

  1414.   </ul>
    1415. 

  1415. </div>
    1416. 

  1416. </body>
    1417. 

  1417. </html>
    1418.