blob: 4b0eed0d9fcec6870fa7b26757b6f99c83a24c67 [file] [log] [blame]
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<meta name="generator" content="Doxygen 1.8.15"/>
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<title>AMCL: mpin_BLS461.h File Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="search/searchdata.js"></script>
<script type="text/javascript" src="search/search.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td id="projectalign" style="padding-left: 0.5em;">
<div id="projectname">AMCL
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.15 -->
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&amp;dn=gpl-2.0.txt GPL-v2 */
var searchBox = new SearchBox("searchBox", "search",false,'Search');
/* @license-end */
</script>
<script type="text/javascript" src="menudata.js"></script>
<script type="text/javascript" src="menu.js"></script>
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&amp;dn=gpl-2.0.txt GPL-v2 */
$(function() {
initMenu('',true,false,'search.php','Search');
$(document).ready(function() { init_search(); });
});
/* @license-end */</script>
<div id="main-nav"></div>
<!-- window showing the filter options -->
<div id="MSearchSelectWindow"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
onkeydown="return searchBox.OnSearchSelectKey(event)">
</div>
<!-- iframe showing the search results (closed by default) -->
<div id="MSearchResultsWindow">
<iframe src="javascript:void(0)" frameborder="0"
name="MSearchResults" id="MSearchResults">
</iframe>
</div>
<div id="nav-path" class="navpath">
<ul>
<li class="navelem"><a class="el" href="dir_df7310d1a865926cc859bcfb1880083f.html">include</a></li> </ul>
</div>
</div><!-- top -->
<div class="header">
<div class="summary">
<a href="#define-members">Macros</a> &#124;
<a href="#func-members">Functions</a> </div>
<div class="headertitle">
<div class="title">mpin_BLS461.h File Reference</div> </div>
</div><!--header-->
<div class="contents">
<p>M-Pin Header file.
<a href="#details">More...</a></p>
<div class="textblock"><code>#include &quot;<a class="el" href="pair__BLS461_8h_source.html">pair_BLS461.h</a>&quot;</code><br />
<code>#include &quot;<a class="el" href="pbc__support_8h_source.html">pbc_support.h</a>&quot;</code><br />
</div>
<p><a href="mpin__BLS461_8h_source.html">Go to the source code of this file.</a></p>
<table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="define-members"></a>
Macros</h2></td></tr>
<tr class="memitem:afd95bf14e2ce880d29112519b4897c40"><td class="memItemLeft" align="right" valign="top">#define&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="mpin__BLS461_8h.html#afd95bf14e2ce880d29112519b4897c40">PGS_BLS461</a>&#160;&#160;&#160;<a class="el" href="config__big__464__60_8h.html#a442cabbdb66ae413e2c26865230cf955">MODBYTES_464_60</a></td></tr>
<tr class="separator:afd95bf14e2ce880d29112519b4897c40"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a758124ce1e525b20369db6823d88e103"><td class="memItemLeft" align="right" valign="top">#define&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="mpin__BLS461_8h.html#a758124ce1e525b20369db6823d88e103">PFS_BLS461</a>&#160;&#160;&#160;<a class="el" href="config__big__464__60_8h.html#a442cabbdb66ae413e2c26865230cf955">MODBYTES_464_60</a></td></tr>
<tr class="separator:a758124ce1e525b20369db6823d88e103"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a5bdbc339b8d614c9c4912a6b6040f4ec"><td class="memItemLeft" align="right" valign="top">#define&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="mpin__BLS461_8h.html#a5bdbc339b8d614c9c4912a6b6040f4ec">MPIN_OK</a>&#160;&#160;&#160;0</td></tr>
<tr class="separator:a5bdbc339b8d614c9c4912a6b6040f4ec"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a1735b73fd12586e70fc971c85e088ffc"><td class="memItemLeft" align="right" valign="top">#define&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="mpin__BLS461_8h.html#a1735b73fd12586e70fc971c85e088ffc">MPIN_INVALID_POINT</a>&#160;&#160;&#160;-14</td></tr>
<tr class="separator:a1735b73fd12586e70fc971c85e088ffc"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ad558e3e4522f6846ba98a0d3820faebd"><td class="memItemLeft" align="right" valign="top">#define&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="mpin__BLS461_8h.html#ad558e3e4522f6846ba98a0d3820faebd">MPIN_BAD_PIN</a>&#160;&#160;&#160;-19</td></tr>
<tr class="separator:ad558e3e4522f6846ba98a0d3820faebd"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a0497a29b4ff3af7cecba9ea4140af442"><td class="memItemLeft" align="right" valign="top">#define&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="mpin__BLS461_8h.html#a0497a29b4ff3af7cecba9ea4140af442">MPIN_PAS</a>&#160;&#160;&#160;16</td></tr>
<tr class="separator:a0497a29b4ff3af7cecba9ea4140af442"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a15c5084bd08109c7edebf50db273e494"><td class="memItemLeft" align="right" valign="top">#define&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="mpin__BLS461_8h.html#a15c5084bd08109c7edebf50db273e494">MAXPIN</a>&#160;&#160;&#160;10000</td></tr>
<tr class="separator:a15c5084bd08109c7edebf50db273e494"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a1bc47461f3417c96da72488c6030447e"><td class="memItemLeft" align="right" valign="top">#define&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="mpin__BLS461_8h.html#a1bc47461f3417c96da72488c6030447e">PBLEN</a>&#160;&#160;&#160;14</td></tr>
<tr class="separator:a1bc47461f3417c96da72488c6030447e"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:aeca90e1c1c62b70670514ffc18c9dfd4"><td class="memItemLeft" align="right" valign="top">#define&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="mpin__BLS461_8h.html#aeca90e1c1c62b70670514ffc18c9dfd4">MESSAGE_SIZE</a>&#160;&#160;&#160;256</td></tr>
<tr class="separator:aeca90e1c1c62b70670514ffc18c9dfd4"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:af37871f31f0cf745c50f996792988a19"><td class="memItemLeft" align="right" valign="top">#define&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="mpin__BLS461_8h.html#af37871f31f0cf745c50f996792988a19">M_SIZE_BLS461</a>&#160;&#160;&#160;(<a class="el" href="mpin__FP512BN_8h.html#aeca90e1c1c62b70670514ffc18c9dfd4">MESSAGE_SIZE</a>+2*<a class="el" href="mpin__BLS461_8h.html#a758124ce1e525b20369db6823d88e103">PFS_BLS461</a>+1)</td></tr>
<tr class="separator:af37871f31f0cf745c50f996792988a19"><td class="memSeparator" colspan="2">&#160;</td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="func-members"></a>
Functions</h2></td></tr>
<tr class="memitem:afed7a304c1087b5db1162d65f3291d55"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="mpin__BLS461_8h.html#afed7a304c1087b5db1162d65f3291d55">MPIN_BLS461_GET_Y</a> (int h, int t, <a class="el" href="structoctet.html">octet</a> *O, <a class="el" href="structoctet.html">octet</a> *Y)</td></tr>
<tr class="memdesc:afed7a304c1087b5db1162d65f3291d55"><td class="mdescLeft">&#160;</td><td class="mdescRight">Generate Y=H(s,O), where s is epoch time, O is an octet, and H(.) is a hash function. <a href="#afed7a304c1087b5db1162d65f3291d55">More...</a><br /></td></tr>
<tr class="separator:afed7a304c1087b5db1162d65f3291d55"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a7d91874a939ba545791739c2b5a7d983"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="mpin__BLS461_8h.html#a7d91874a939ba545791739c2b5a7d983">MPIN_BLS461_EXTRACT_FACTOR</a> (int h, <a class="el" href="structoctet.html">octet</a> *ID, int factor, int facbits, <a class="el" href="structoctet.html">octet</a> *CS)</td></tr>
<tr class="memdesc:a7d91874a939ba545791739c2b5a7d983"><td class="mdescLeft">&#160;</td><td class="mdescRight">Extract a PIN number from a client secret. <a href="#a7d91874a939ba545791739c2b5a7d983">More...</a><br /></td></tr>
<tr class="separator:a7d91874a939ba545791739c2b5a7d983"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ad4c14453027ca0d6f38c8d8175b9915f"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="mpin__BLS461_8h.html#ad4c14453027ca0d6f38c8d8175b9915f">MPIN_BLS461_RESTORE_FACTOR</a> (int h, <a class="el" href="structoctet.html">octet</a> *ID, int factor, int facbits, <a class="el" href="structoctet.html">octet</a> *CS)</td></tr>
<tr class="memdesc:ad4c14453027ca0d6f38c8d8175b9915f"><td class="mdescLeft">&#160;</td><td class="mdescRight">Extract a PIN number from a client secret. <a href="#ad4c14453027ca0d6f38c8d8175b9915f">More...</a><br /></td></tr>
<tr class="separator:ad4c14453027ca0d6f38c8d8175b9915f"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a9f34545e493a759d090228cb69698dcf"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="mpin__BLS461_8h.html#a9f34545e493a759d090228cb69698dcf">MPIN_BLS461_EXTRACT_PIN</a> (int h, <a class="el" href="structoctet.html">octet</a> *ID, int pin, <a class="el" href="structoctet.html">octet</a> *CS)</td></tr>
<tr class="memdesc:a9f34545e493a759d090228cb69698dcf"><td class="mdescLeft">&#160;</td><td class="mdescRight">Extract a PIN number from a client secret. <a href="#a9f34545e493a759d090228cb69698dcf">More...</a><br /></td></tr>
<tr class="separator:a9f34545e493a759d090228cb69698dcf"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ac706eaf61bf21db68b8da63df51363ec"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="mpin__BLS461_8h.html#ac706eaf61bf21db68b8da63df51363ec">MPIN_BLS461_CLIENT</a> (int h, int d, <a class="el" href="structoctet.html">octet</a> *ID, <a class="el" href="structcsprng.html">csprng</a> *R, <a class="el" href="structoctet.html">octet</a> *x, int pin, <a class="el" href="structoctet.html">octet</a> *T, <a class="el" href="structoctet.html">octet</a> *V, <a class="el" href="structoctet.html">octet</a> *U, <a class="el" href="structoctet.html">octet</a> *UT, <a class="el" href="structoctet.html">octet</a> *TP, <a class="el" href="structoctet.html">octet</a> *MESSAGE, int t, <a class="el" href="structoctet.html">octet</a> *y)</td></tr>
<tr class="memdesc:ac706eaf61bf21db68b8da63df51363ec"><td class="mdescLeft">&#160;</td><td class="mdescRight">Perform client side of the one-pass version of the M-Pin protocol. <a href="#ac706eaf61bf21db68b8da63df51363ec">More...</a><br /></td></tr>
<tr class="separator:ac706eaf61bf21db68b8da63df51363ec"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:acf41b82003ae09745478e21c14686183"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="mpin__BLS461_8h.html#acf41b82003ae09745478e21c14686183">MPIN_BLS461_CLIENT_1</a> (int h, int d, <a class="el" href="structoctet.html">octet</a> *ID, <a class="el" href="structcsprng.html">csprng</a> *R, <a class="el" href="structoctet.html">octet</a> *x, int pin, <a class="el" href="structoctet.html">octet</a> *T, <a class="el" href="structoctet.html">octet</a> *S, <a class="el" href="structoctet.html">octet</a> *U, <a class="el" href="structoctet.html">octet</a> *UT, <a class="el" href="structoctet.html">octet</a> *TP)</td></tr>
<tr class="memdesc:acf41b82003ae09745478e21c14686183"><td class="mdescLeft">&#160;</td><td class="mdescRight">Perform first pass of the client side of the 3-pass version of the M-Pin protocol. <a href="#acf41b82003ae09745478e21c14686183">More...</a><br /></td></tr>
<tr class="separator:acf41b82003ae09745478e21c14686183"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a2d6d702b8607e4bc982eb48c019f3396"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="mpin__BLS461_8h.html#a2d6d702b8607e4bc982eb48c019f3396">MPIN_BLS461_RANDOM_GENERATE</a> (<a class="el" href="structcsprng.html">csprng</a> *R, <a class="el" href="structoctet.html">octet</a> *S)</td></tr>
<tr class="memdesc:a2d6d702b8607e4bc982eb48c019f3396"><td class="mdescLeft">&#160;</td><td class="mdescRight">Generate a random group element. <a href="#a2d6d702b8607e4bc982eb48c019f3396">More...</a><br /></td></tr>
<tr class="separator:a2d6d702b8607e4bc982eb48c019f3396"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a75acf08fa18080a0feb6e0c7e76628ec"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="mpin__BLS461_8h.html#a75acf08fa18080a0feb6e0c7e76628ec">MPIN_BLS461_CLIENT_2</a> (<a class="el" href="structoctet.html">octet</a> *x, <a class="el" href="structoctet.html">octet</a> *y, <a class="el" href="structoctet.html">octet</a> *V)</td></tr>
<tr class="memdesc:a75acf08fa18080a0feb6e0c7e76628ec"><td class="mdescLeft">&#160;</td><td class="mdescRight">Perform second pass of the client side of the 3-pass version of the M-Pin protocol. <a href="#a75acf08fa18080a0feb6e0c7e76628ec">More...</a><br /></td></tr>
<tr class="separator:a75acf08fa18080a0feb6e0c7e76628ec"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a5c6554014fc53e3dfcaf6f88532c2124"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="mpin__BLS461_8h.html#a5c6554014fc53e3dfcaf6f88532c2124">MPIN_BLS461_SERVER</a> (int h, int d, <a class="el" href="structoctet.html">octet</a> *HID, <a class="el" href="structoctet.html">octet</a> *HTID, <a class="el" href="structoctet.html">octet</a> *y, <a class="el" href="structoctet.html">octet</a> *SS, <a class="el" href="structoctet.html">octet</a> *U, <a class="el" href="structoctet.html">octet</a> *UT, <a class="el" href="structoctet.html">octet</a> *V, <a class="el" href="structoctet.html">octet</a> *E, <a class="el" href="structoctet.html">octet</a> *F, <a class="el" href="structoctet.html">octet</a> *ID, <a class="el" href="structoctet.html">octet</a> *MESSAGE, int t, <a class="el" href="structoctet.html">octet</a> *Pa)</td></tr>
<tr class="memdesc:a5c6554014fc53e3dfcaf6f88532c2124"><td class="mdescLeft">&#160;</td><td class="mdescRight">Perform server side of the one-pass version of the M-Pin protocol. <a href="#a5c6554014fc53e3dfcaf6f88532c2124">More...</a><br /></td></tr>
<tr class="separator:a5c6554014fc53e3dfcaf6f88532c2124"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:aee187c1fc5ffb0f036391f16b7e902ad"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="mpin__BLS461_8h.html#aee187c1fc5ffb0f036391f16b7e902ad">MPIN_BLS461_SERVER_1</a> (int h, int d, <a class="el" href="structoctet.html">octet</a> *ID, <a class="el" href="structoctet.html">octet</a> *HID, <a class="el" href="structoctet.html">octet</a> *HTID)</td></tr>
<tr class="memdesc:aee187c1fc5ffb0f036391f16b7e902ad"><td class="mdescLeft">&#160;</td><td class="mdescRight">Perform first pass of the server side of the 3-pass version of the M-Pin protocol. <a href="#aee187c1fc5ffb0f036391f16b7e902ad">More...</a><br /></td></tr>
<tr class="separator:aee187c1fc5ffb0f036391f16b7e902ad"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:abd9ba6260b4418edda0e7bd6584d8c6c"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="mpin__BLS461_8h.html#abd9ba6260b4418edda0e7bd6584d8c6c">MPIN_BLS461_SERVER_2</a> (int d, <a class="el" href="structoctet.html">octet</a> *HID, <a class="el" href="structoctet.html">octet</a> *HTID, <a class="el" href="structoctet.html">octet</a> *y, <a class="el" href="structoctet.html">octet</a> *SS, <a class="el" href="structoctet.html">octet</a> *U, <a class="el" href="structoctet.html">octet</a> *UT, <a class="el" href="structoctet.html">octet</a> *V, <a class="el" href="structoctet.html">octet</a> *E, <a class="el" href="structoctet.html">octet</a> *F, <a class="el" href="structoctet.html">octet</a> *Pa)</td></tr>
<tr class="memdesc:abd9ba6260b4418edda0e7bd6584d8c6c"><td class="mdescLeft">&#160;</td><td class="mdescRight">Perform third pass on the server side of the 3-pass version of the M-Pin protocol. <a href="#abd9ba6260b4418edda0e7bd6584d8c6c">More...</a><br /></td></tr>
<tr class="separator:abd9ba6260b4418edda0e7bd6584d8c6c"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:acd1706c6affadd577a54d7c0a70ae2d9"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="mpin__BLS461_8h.html#acd1706c6affadd577a54d7c0a70ae2d9">MPIN_BLS461_RECOMBINE_G1</a> (<a class="el" href="structoctet.html">octet</a> *Q1, <a class="el" href="structoctet.html">octet</a> *Q2, <a class="el" href="structoctet.html">octet</a> *Q)</td></tr>
<tr class="memdesc:acd1706c6affadd577a54d7c0a70ae2d9"><td class="mdescLeft">&#160;</td><td class="mdescRight">Add two members from the group G1. <a href="#acd1706c6affadd577a54d7c0a70ae2d9">More...</a><br /></td></tr>
<tr class="separator:acd1706c6affadd577a54d7c0a70ae2d9"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ac217b662770e09d47f6317f4096d1f65"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="mpin__BLS461_8h.html#ac217b662770e09d47f6317f4096d1f65">MPIN_BLS461_RECOMBINE_G2</a> (<a class="el" href="structoctet.html">octet</a> *P1, <a class="el" href="structoctet.html">octet</a> *P2, <a class="el" href="structoctet.html">octet</a> *P)</td></tr>
<tr class="memdesc:ac217b662770e09d47f6317f4096d1f65"><td class="mdescLeft">&#160;</td><td class="mdescRight">Add two members from the group G2. <a href="#ac217b662770e09d47f6317f4096d1f65">More...</a><br /></td></tr>
<tr class="separator:ac217b662770e09d47f6317f4096d1f65"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a32ef77411171216549ef459753097759"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="mpin__BLS461_8h.html#a32ef77411171216549ef459753097759">MPIN_BLS461_KANGAROO</a> (<a class="el" href="structoctet.html">octet</a> *E, <a class="el" href="structoctet.html">octet</a> *F)</td></tr>
<tr class="memdesc:a32ef77411171216549ef459753097759"><td class="mdescLeft">&#160;</td><td class="mdescRight">Use Kangaroos to find PIN error. <a href="#a32ef77411171216549ef459753097759">More...</a><br /></td></tr>
<tr class="separator:a32ef77411171216549ef459753097759"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ad0d804358e2f08db8cc99405bd90f33b"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="mpin__BLS461_8h.html#ad0d804358e2f08db8cc99405bd90f33b">MPIN_BLS461_ENCODING</a> (<a class="el" href="structcsprng.html">csprng</a> *R, <a class="el" href="structoctet.html">octet</a> *TP)</td></tr>
<tr class="memdesc:ad0d804358e2f08db8cc99405bd90f33b"><td class="mdescLeft">&#160;</td><td class="mdescRight">Encoding of a Time Permit to make it indistinguishable from a random string. <a href="#ad0d804358e2f08db8cc99405bd90f33b">More...</a><br /></td></tr>
<tr class="separator:ad0d804358e2f08db8cc99405bd90f33b"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ac6c3294037548ae1f0a2431cf6083bc7"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="mpin__BLS461_8h.html#ac6c3294037548ae1f0a2431cf6083bc7">MPIN_BLS461_DECODING</a> (<a class="el" href="structoctet.html">octet</a> *TP)</td></tr>
<tr class="memdesc:ac6c3294037548ae1f0a2431cf6083bc7"><td class="mdescLeft">&#160;</td><td class="mdescRight">Encoding of an obfuscated Time Permit. <a href="#ac6c3294037548ae1f0a2431cf6083bc7">More...</a><br /></td></tr>
<tr class="separator:ac6c3294037548ae1f0a2431cf6083bc7"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a2f73b7affcf44db226442bfd5c4fa3c3"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="mpin__BLS461_8h.html#a2f73b7affcf44db226442bfd5c4fa3c3">MPIN_BLS461_GET_G1_MULTIPLE</a> (<a class="el" href="structcsprng.html">csprng</a> *R, int type, <a class="el" href="structoctet.html">octet</a> *x, <a class="el" href="structoctet.html">octet</a> *G, <a class="el" href="structoctet.html">octet</a> *W)</td></tr>
<tr class="memdesc:a2f73b7affcf44db226442bfd5c4fa3c3"><td class="mdescLeft">&#160;</td><td class="mdescRight">Find a random multiple of a point in G1. <a href="#a2f73b7affcf44db226442bfd5c4fa3c3">More...</a><br /></td></tr>
<tr class="separator:a2f73b7affcf44db226442bfd5c4fa3c3"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a80aa31e02d55531d26bb0de8a274dcc3"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="mpin__BLS461_8h.html#a80aa31e02d55531d26bb0de8a274dcc3">MPIN_BLS461_GET_G2_MULTIPLE</a> (<a class="el" href="structcsprng.html">csprng</a> *R, int type, <a class="el" href="structoctet.html">octet</a> *x, <a class="el" href="structoctet.html">octet</a> *G, <a class="el" href="structoctet.html">octet</a> *W)</td></tr>
<tr class="memdesc:a80aa31e02d55531d26bb0de8a274dcc3"><td class="mdescLeft">&#160;</td><td class="mdescRight">Find a random multiple of a point in G1. <a href="#a80aa31e02d55531d26bb0de8a274dcc3">More...</a><br /></td></tr>
<tr class="separator:a80aa31e02d55531d26bb0de8a274dcc3"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a647e7ea2e2b106d7045e17bd435b25e7"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="mpin__BLS461_8h.html#a647e7ea2e2b106d7045e17bd435b25e7">MPIN_BLS461_GET_CLIENT_SECRET</a> (<a class="el" href="structoctet.html">octet</a> *S, <a class="el" href="structoctet.html">octet</a> *ID, <a class="el" href="structoctet.html">octet</a> *CS)</td></tr>
<tr class="memdesc:a647e7ea2e2b106d7045e17bd435b25e7"><td class="mdescLeft">&#160;</td><td class="mdescRight">Create a client secret in G1 from a master secret and the client ID. <a href="#a647e7ea2e2b106d7045e17bd435b25e7">More...</a><br /></td></tr>
<tr class="separator:a647e7ea2e2b106d7045e17bd435b25e7"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a9ab386f2aca1de92c8db9961c102cc1a"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="mpin__BLS461_8h.html#a9ab386f2aca1de92c8db9961c102cc1a">MPIN_BLS461_GET_CLIENT_PERMIT</a> (int h, int d, <a class="el" href="structoctet.html">octet</a> *S, <a class="el" href="structoctet.html">octet</a> *ID, <a class="el" href="structoctet.html">octet</a> *TP)</td></tr>
<tr class="memdesc:a9ab386f2aca1de92c8db9961c102cc1a"><td class="mdescLeft">&#160;</td><td class="mdescRight">Create a Time Permit in G1 from a master secret and the client ID. <a href="#a9ab386f2aca1de92c8db9961c102cc1a">More...</a><br /></td></tr>
<tr class="separator:a9ab386f2aca1de92c8db9961c102cc1a"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:af37ed7ada8db694da68fe9b349c73b79"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="mpin__BLS461_8h.html#af37ed7ada8db694da68fe9b349c73b79">MPIN_BLS461_GET_SERVER_SECRET</a> (<a class="el" href="structoctet.html">octet</a> *S, <a class="el" href="structoctet.html">octet</a> *SS)</td></tr>
<tr class="memdesc:af37ed7ada8db694da68fe9b349c73b79"><td class="mdescLeft">&#160;</td><td class="mdescRight">Create a server secret in G2 from a master secret. <a href="#af37ed7ada8db694da68fe9b349c73b79">More...</a><br /></td></tr>
<tr class="separator:af37ed7ada8db694da68fe9b349c73b79"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:aa3149c7f8e17f0095398aa4cf795177b"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="mpin__BLS461_8h.html#aa3149c7f8e17f0095398aa4cf795177b">MPIN_BLS461_PRECOMPUTE</a> (<a class="el" href="structoctet.html">octet</a> *T, <a class="el" href="structoctet.html">octet</a> *ID, <a class="el" href="structoctet.html">octet</a> *CP, <a class="el" href="structoctet.html">octet</a> *g1, <a class="el" href="structoctet.html">octet</a> *g2)</td></tr>
<tr class="memdesc:aa3149c7f8e17f0095398aa4cf795177b"><td class="mdescLeft">&#160;</td><td class="mdescRight">Precompute values for use by the client side of M-Pin Full. <a href="#aa3149c7f8e17f0095398aa4cf795177b">More...</a><br /></td></tr>
<tr class="separator:aa3149c7f8e17f0095398aa4cf795177b"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a8ecdeeaccac76b6288600781c00c9df5"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="mpin__BLS461_8h.html#a8ecdeeaccac76b6288600781c00c9df5">MPIN_BLS461_SERVER_KEY</a> (int h, <a class="el" href="structoctet.html">octet</a> *Z, <a class="el" href="structoctet.html">octet</a> *SS, <a class="el" href="structoctet.html">octet</a> *w, <a class="el" href="structoctet.html">octet</a> *p, <a class="el" href="structoctet.html">octet</a> *I, <a class="el" href="structoctet.html">octet</a> *U, <a class="el" href="structoctet.html">octet</a> *UT, <a class="el" href="structoctet.html">octet</a> *K)</td></tr>
<tr class="memdesc:a8ecdeeaccac76b6288600781c00c9df5"><td class="mdescLeft">&#160;</td><td class="mdescRight">Calculate Key on Server side for M-Pin Full. <a href="#a8ecdeeaccac76b6288600781c00c9df5">More...</a><br /></td></tr>
<tr class="separator:a8ecdeeaccac76b6288600781c00c9df5"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ab9f726e6610bc64e22702e866faa28f2"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="mpin__BLS461_8h.html#ab9f726e6610bc64e22702e866faa28f2">MPIN_BLS461_CLIENT_KEY</a> (int h, <a class="el" href="structoctet.html">octet</a> *g1, <a class="el" href="structoctet.html">octet</a> *g2, int pin, <a class="el" href="structoctet.html">octet</a> *r, <a class="el" href="structoctet.html">octet</a> *x, <a class="el" href="structoctet.html">octet</a> *p, <a class="el" href="structoctet.html">octet</a> *T, <a class="el" href="structoctet.html">octet</a> *K)</td></tr>
<tr class="memdesc:ab9f726e6610bc64e22702e866faa28f2"><td class="mdescLeft">&#160;</td><td class="mdescRight">Calculate Key on Client side for M-Pin Full. <a href="#ab9f726e6610bc64e22702e866faa28f2">More...</a><br /></td></tr>
<tr class="separator:ab9f726e6610bc64e22702e866faa28f2"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a63da65940b2130072e615eab8580e4e3"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="mpin__BLS461_8h.html#a63da65940b2130072e615eab8580e4e3">MPIN_BLS461_GET_DVS_KEYPAIR</a> (<a class="el" href="structcsprng.html">csprng</a> *R, <a class="el" href="structoctet.html">octet</a> *Z, <a class="el" href="structoctet.html">octet</a> *Pa)</td></tr>
<tr class="memdesc:a63da65940b2130072e615eab8580e4e3"><td class="mdescLeft">&#160;</td><td class="mdescRight">Generates a random public key for the client z.Q. <a href="#a63da65940b2130072e615eab8580e4e3">More...</a><br /></td></tr>
<tr class="separator:a63da65940b2130072e615eab8580e4e3"><td class="memSeparator" colspan="2">&#160;</td></tr>
</table>
<a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
<div class="textblock"><dl class="section author"><dt>Author</dt><dd>Mike Scott </dd></dl>
</div><h2 class="groupheader">Macro Definition Documentation</h2>
<a id="af37871f31f0cf745c50f996792988a19"></a>
<h2 class="memtitle"><span class="permalink"><a href="#af37871f31f0cf745c50f996792988a19">&#9670;&nbsp;</a></span>M_SIZE_BLS461</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define M_SIZE_BLS461&#160;&#160;&#160;(<a class="el" href="mpin__FP512BN_8h.html#aeca90e1c1c62b70670514ffc18c9dfd4">MESSAGE_SIZE</a>+2*<a class="el" href="mpin__BLS461_8h.html#a758124ce1e525b20369db6823d88e103">PFS_BLS461</a>+1)</td>
</tr>
</table>
</div><div class="memdoc">
<p>Signature message size and G1 size </p>
</div>
</div>
<a id="a15c5084bd08109c7edebf50db273e494"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a15c5084bd08109c7edebf50db273e494">&#9670;&nbsp;</a></span>MAXPIN</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define MAXPIN&#160;&#160;&#160;10000</td>
</tr>
</table>
</div><div class="memdoc">
<p>max PIN </p>
</div>
</div>
<a id="aeca90e1c1c62b70670514ffc18c9dfd4"></a>
<h2 class="memtitle"><span class="permalink"><a href="#aeca90e1c1c62b70670514ffc18c9dfd4">&#9670;&nbsp;</a></span>MESSAGE_SIZE</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define MESSAGE_SIZE&#160;&#160;&#160;256</td>
</tr>
</table>
</div><div class="memdoc">
<p>Signature message size </p>
</div>
</div>
<a id="ad558e3e4522f6846ba98a0d3820faebd"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ad558e3e4522f6846ba98a0d3820faebd">&#9670;&nbsp;</a></span>MPIN_BAD_PIN</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define MPIN_BAD_PIN&#160;&#160;&#160;-19</td>
</tr>
</table>
</div><div class="memdoc">
<p>Bad PIN number entered </p>
</div>
</div>
<a id="a1735b73fd12586e70fc971c85e088ffc"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a1735b73fd12586e70fc971c85e088ffc">&#9670;&nbsp;</a></span>MPIN_INVALID_POINT</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define MPIN_INVALID_POINT&#160;&#160;&#160;-14</td>
</tr>
</table>
</div><div class="memdoc">
<p>Point is NOT on the curve </p>
</div>
</div>
<a id="a5bdbc339b8d614c9c4912a6b6040f4ec"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a5bdbc339b8d614c9c4912a6b6040f4ec">&#9670;&nbsp;</a></span>MPIN_OK</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define MPIN_OK&#160;&#160;&#160;0</td>
</tr>
</table>
</div><div class="memdoc">
<p>Function completed without error </p>
</div>
</div>
<a id="a0497a29b4ff3af7cecba9ea4140af442"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a0497a29b4ff3af7cecba9ea4140af442">&#9670;&nbsp;</a></span>MPIN_PAS</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define MPIN_PAS&#160;&#160;&#160;16</td>
</tr>
</table>
</div><div class="memdoc">
<p>MPIN Symmetric Key Size </p>
</div>
</div>
<a id="a1bc47461f3417c96da72488c6030447e"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a1bc47461f3417c96da72488c6030447e">&#9670;&nbsp;</a></span>PBLEN</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define PBLEN&#160;&#160;&#160;14</td>
</tr>
</table>
</div><div class="memdoc">
<p>max length of PIN in bits </p>
</div>
</div>
<a id="a758124ce1e525b20369db6823d88e103"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a758124ce1e525b20369db6823d88e103">&#9670;&nbsp;</a></span>PFS_BLS461</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define PFS_BLS461&#160;&#160;&#160;<a class="el" href="config__big__464__60_8h.html#a442cabbdb66ae413e2c26865230cf955">MODBYTES_464_60</a></td>
</tr>
</table>
</div><div class="memdoc">
<p>MPIN Field Size </p>
</div>
</div>
<a id="afd95bf14e2ce880d29112519b4897c40"></a>
<h2 class="memtitle"><span class="permalink"><a href="#afd95bf14e2ce880d29112519b4897c40">&#9670;&nbsp;</a></span>PGS_BLS461</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define PGS_BLS461&#160;&#160;&#160;<a class="el" href="config__big__464__60_8h.html#a442cabbdb66ae413e2c26865230cf955">MODBYTES_464_60</a></td>
</tr>
</table>
</div><div class="memdoc">
<p>MPIN Group Size </p>
</div>
</div>
<h2 class="groupheader">Function Documentation</h2>
<a id="ac706eaf61bf21db68b8da63df51363ec"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ac706eaf61bf21db68b8da63df51363ec">&#9670;&nbsp;</a></span>MPIN_BLS461_CLIENT()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int MPIN_BLS461_CLIENT </td>
<td>(</td>
<td class="paramtype">int&#160;</td>
<td class="paramname"><em>h</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int&#160;</td>
<td class="paramname"><em>d</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>ID</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structcsprng.html">csprng</a> *&#160;</td>
<td class="paramname"><em>R</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>x</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int&#160;</td>
<td class="paramname"><em>pin</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>T</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>V</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>U</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>UT</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>TP</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>MESSAGE</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int&#160;</td>
<td class="paramname"><em>t</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>y</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>If Time Permits are disabled, set d = 0, and UT is not generated and can be set to NULL. If Time Permits are enabled, and PIN error detection is OFF, U is not generated and can be set to NULL. If Time Permits are enabled, and PIN error detection is ON, U and UT are both generated. </p><dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">h</td><td>is the hash type </td></tr>
<tr><td class="paramname">d</td><td>is input date, in days since the epoch. Set to 0 if Time permits disabled </td></tr>
<tr><td class="paramname">ID</td><td>is the input client identity </td></tr>
<tr><td class="paramname">R</td><td>is a pointer to a cryptographically secure random number generator </td></tr>
<tr><td class="paramname">x</td><td>an output internally randomly generated if R!=NULL, otherwise must be provided as an input </td></tr>
<tr><td class="paramname">pin</td><td>is the input PIN number </td></tr>
<tr><td class="paramname">T</td><td>is the input M-Pin token (the client secret with PIN portion removed) </td></tr>
<tr><td class="paramname">V</td><td>is output = -(x+y)(CS+TP), where CS is the reconstructed client secret, and TP is the time permit </td></tr>
<tr><td class="paramname">U</td><td>is output = x.H(ID) </td></tr>
<tr><td class="paramname">UT</td><td>is output = x.(H(ID)+H(d|H(ID))) </td></tr>
<tr><td class="paramname">TP</td><td>is the input time permit </td></tr>
<tr><td class="paramname">MESSAGE</td><td>is the message to be signed </td></tr>
<tr><td class="paramname">t</td><td>is input epoch time in seconds - a timestamp </td></tr>
<tr><td class="paramname">y</td><td>is output H(t|U) or H(t|UT) if Time Permits enabled </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>0 or an error code </dd></dl>
</div>
</div>
<a id="acf41b82003ae09745478e21c14686183"></a>
<h2 class="memtitle"><span class="permalink"><a href="#acf41b82003ae09745478e21c14686183">&#9670;&nbsp;</a></span>MPIN_BLS461_CLIENT_1()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int MPIN_BLS461_CLIENT_1 </td>
<td>(</td>
<td class="paramtype">int&#160;</td>
<td class="paramname"><em>h</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int&#160;</td>
<td class="paramname"><em>d</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>ID</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structcsprng.html">csprng</a> *&#160;</td>
<td class="paramname"><em>R</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>x</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int&#160;</td>
<td class="paramname"><em>pin</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>T</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>S</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>U</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>UT</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>TP</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>If Time Permits are disabled, set d = 0, and UT is not generated and can be set to NULL. If Time Permits are enabled, and PIN error detection is OFF, U is not generated and can be set to NULL. If Time Permits are enabled, and PIN error detection is ON, U and UT are both generated. </p><dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">h</td><td>is the hash type </td></tr>
<tr><td class="paramname">d</td><td>is input date, in days since the epoch. Set to 0 if Time permits disabled </td></tr>
<tr><td class="paramname">ID</td><td>is the input client identity </td></tr>
<tr><td class="paramname">R</td><td>is a pointer to a cryptographically secure random number generator </td></tr>
<tr><td class="paramname">x</td><td>an output internally randomly generated if R!=NULL, otherwise must be provided as an input </td></tr>
<tr><td class="paramname">pin</td><td>is the input PIN number </td></tr>
<tr><td class="paramname">T</td><td>is the input M-Pin token (the client secret with PIN portion removed) </td></tr>
<tr><td class="paramname">S</td><td>is output = CS+TP, where CS=is the reconstructed client secret, and TP is the time permit </td></tr>
<tr><td class="paramname">U</td><td>is output = x.H(ID) </td></tr>
<tr><td class="paramname">UT</td><td>is output = x.(H(ID)+H(d|H(ID))) </td></tr>
<tr><td class="paramname">TP</td><td>is the input time permit </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>0 or an error code </dd></dl>
</div>
</div>
<a id="a75acf08fa18080a0feb6e0c7e76628ec"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a75acf08fa18080a0feb6e0c7e76628ec">&#9670;&nbsp;</a></span>MPIN_BLS461_CLIENT_2()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int MPIN_BLS461_CLIENT_2 </td>
<td>(</td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>x</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>y</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>V</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">x</td><td>an input, a locally generated random number </td></tr>
<tr><td class="paramname">y</td><td>an input random challenge from the server </td></tr>
<tr><td class="paramname">V</td><td>on output = -(x+y).V </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>0 or an error code </dd></dl>
</div>
</div>
<a id="ab9f726e6610bc64e22702e866faa28f2"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ab9f726e6610bc64e22702e866faa28f2">&#9670;&nbsp;</a></span>MPIN_BLS461_CLIENT_KEY()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int MPIN_BLS461_CLIENT_KEY </td>
<td>(</td>
<td class="paramtype">int&#160;</td>
<td class="paramname"><em>h</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>g1</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>g2</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int&#160;</td>
<td class="paramname"><em>pin</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>r</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>x</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>p</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>T</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>K</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">h</td><td>is the hash type </td></tr>
<tr><td class="paramname">g1</td><td>precomputed input </td></tr>
<tr><td class="paramname">g2</td><td>precomputed input </td></tr>
<tr><td class="paramname">pin</td><td>is the input PIN number </td></tr>
<tr><td class="paramname">r</td><td>is an input, a locally generated random number </td></tr>
<tr><td class="paramname">x</td><td>is an input, a locally generated random number </td></tr>
<tr><td class="paramname">p</td><td>is an input, hash of the protocol transcript </td></tr>
<tr><td class="paramname">T</td><td>is the input Server-side Diffie-Hellman component </td></tr>
<tr><td class="paramname">K</td><td>is the output calculated shared key </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>0 or an error code </dd></dl>
</div>
</div>
<a id="ac6c3294037548ae1f0a2431cf6083bc7"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ac6c3294037548ae1f0a2431cf6083bc7">&#9670;&nbsp;</a></span>MPIN_BLS461_DECODING()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int MPIN_BLS461_DECODING </td>
<td>(</td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>TP</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">TP</td><td>is the input obfuscated time permit, restored on output </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>0 or an error code </dd></dl>
</div>
</div>
<a id="ad0d804358e2f08db8cc99405bd90f33b"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ad0d804358e2f08db8cc99405bd90f33b">&#9670;&nbsp;</a></span>MPIN_BLS461_ENCODING()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int MPIN_BLS461_ENCODING </td>
<td>(</td>
<td class="paramtype"><a class="el" href="structcsprng.html">csprng</a> *&#160;</td>
<td class="paramname"><em>R</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>TP</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">R</td><td>is a pointer to a cryptographically secure random number generator </td></tr>
<tr><td class="paramname">TP</td><td>is the input time permit, obfuscated on output </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>0 or an error code </dd></dl>
</div>
</div>
<a id="a7d91874a939ba545791739c2b5a7d983"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a7d91874a939ba545791739c2b5a7d983">&#9670;&nbsp;</a></span>MPIN_BLS461_EXTRACT_FACTOR()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int MPIN_BLS461_EXTRACT_FACTOR </td>
<td>(</td>
<td class="paramtype">int&#160;</td>
<td class="paramname"><em>h</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>ID</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int&#160;</td>
<td class="paramname"><em>factor</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int&#160;</td>
<td class="paramname"><em>facbits</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>CS</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">h</td><td>is the hash type </td></tr>
<tr><td class="paramname">ID</td><td>is the input client identity </td></tr>
<tr><td class="paramname">factor</td><td>is an input factor </td></tr>
<tr><td class="paramname">facbits</td><td>is the number of bits in the factor </td></tr>
<tr><td class="paramname">CS</td><td>is the client secret from which the factor is to be extracted </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>0 or an error code </dd></dl>
</div>
</div>
<a id="a9f34545e493a759d090228cb69698dcf"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a9f34545e493a759d090228cb69698dcf">&#9670;&nbsp;</a></span>MPIN_BLS461_EXTRACT_PIN()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int MPIN_BLS461_EXTRACT_PIN </td>
<td>(</td>
<td class="paramtype">int&#160;</td>
<td class="paramname"><em>h</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>ID</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int&#160;</td>
<td class="paramname"><em>pin</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>CS</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">h</td><td>is the hash type </td></tr>
<tr><td class="paramname">ID</td><td>is the input client identity </td></tr>
<tr><td class="paramname">pin</td><td>is an input PIN number </td></tr>
<tr><td class="paramname">CS</td><td>is the client secret from which the PIN is to be extracted </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>0 or an error code </dd></dl>
</div>
</div>
<a id="a9ab386f2aca1de92c8db9961c102cc1a"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a9ab386f2aca1de92c8db9961c102cc1a">&#9670;&nbsp;</a></span>MPIN_BLS461_GET_CLIENT_PERMIT()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int MPIN_BLS461_GET_CLIENT_PERMIT </td>
<td>(</td>
<td class="paramtype">int&#160;</td>
<td class="paramname"><em>h</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int&#160;</td>
<td class="paramname"><em>d</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>S</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>ID</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>TP</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">h</td><td>is the hash type </td></tr>
<tr><td class="paramname">d</td><td>is input date, in days since the epoch. </td></tr>
<tr><td class="paramname">S</td><td>is an input master secret </td></tr>
<tr><td class="paramname">ID</td><td>is the input client identity </td></tr>
<tr><td class="paramname">TP</td><td>is a Time Permit for the given date = s.H(d|H(ID)) </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>0 or an error code </dd></dl>
</div>
</div>
<a id="a647e7ea2e2b106d7045e17bd435b25e7"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a647e7ea2e2b106d7045e17bd435b25e7">&#9670;&nbsp;</a></span>MPIN_BLS461_GET_CLIENT_SECRET()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int MPIN_BLS461_GET_CLIENT_SECRET </td>
<td>(</td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>S</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>ID</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>CS</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">S</td><td>is an input master secret </td></tr>
<tr><td class="paramname">ID</td><td>is the input client identity </td></tr>
<tr><td class="paramname">CS</td><td>is the full client secret = s.H(ID) </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>0 or an error code </dd></dl>
</div>
</div>
<a id="a63da65940b2130072e615eab8580e4e3"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a63da65940b2130072e615eab8580e4e3">&#9670;&nbsp;</a></span>MPIN_BLS461_GET_DVS_KEYPAIR()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int MPIN_BLS461_GET_DVS_KEYPAIR </td>
<td>(</td>
<td class="paramtype"><a class="el" href="structcsprng.html">csprng</a> *&#160;</td>
<td class="paramname"><em>R</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>Z</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>Pa</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<pre class="fragment">@param R is a pointer to a cryptographically secure random number generator
@param Z an output internally randomly generated if R!=NULL, otherwise it must be provided as an input
@param Pa the output public key for the client
</pre>
</div>
</div>
<a id="a2f73b7affcf44db226442bfd5c4fa3c3"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a2f73b7affcf44db226442bfd5c4fa3c3">&#9670;&nbsp;</a></span>MPIN_BLS461_GET_G1_MULTIPLE()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int MPIN_BLS461_GET_G1_MULTIPLE </td>
<td>(</td>
<td class="paramtype"><a class="el" href="structcsprng.html">csprng</a> *&#160;</td>
<td class="paramname"><em>R</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int&#160;</td>
<td class="paramname"><em>type</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>x</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>G</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>W</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">R</td><td>is a pointer to a cryptographically secure random number generator </td></tr>
<tr><td class="paramname">type</td><td>determines type of action to be taken </td></tr>
<tr><td class="paramname">x</td><td>an output internally randomly generated if R!=NULL, otherwise must be provided as an input </td></tr>
<tr><td class="paramname">G</td><td>if type=0 a point in G1, else an octet to be mapped to G1 </td></tr>
<tr><td class="paramname">W</td><td>the output =x.G or x.M(G), where M(.) is a mapping </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>0 or an error code </dd></dl>
</div>
</div>
<a id="a80aa31e02d55531d26bb0de8a274dcc3"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a80aa31e02d55531d26bb0de8a274dcc3">&#9670;&nbsp;</a></span>MPIN_BLS461_GET_G2_MULTIPLE()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int MPIN_BLS461_GET_G2_MULTIPLE </td>
<td>(</td>
<td class="paramtype"><a class="el" href="structcsprng.html">csprng</a> *&#160;</td>
<td class="paramname"><em>R</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int&#160;</td>
<td class="paramname"><em>type</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>x</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>G</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>W</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">R</td><td>is a pointer to a cryptographically secure random number generator </td></tr>
<tr><td class="paramname">type</td><td>determines type of action to betaken </td></tr>
<tr><td class="paramname">x</td><td>an output internally randomly generated if R!=NULL, otherwise must be provided as an input </td></tr>
<tr><td class="paramname">G</td><td>a point in G2 </td></tr>
<tr><td class="paramname">W</td><td>the output =x.G or (1/x).G </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>0 or an error code </dd></dl>
</div>
</div>
<a id="af37ed7ada8db694da68fe9b349c73b79"></a>
<h2 class="memtitle"><span class="permalink"><a href="#af37ed7ada8db694da68fe9b349c73b79">&#9670;&nbsp;</a></span>MPIN_BLS461_GET_SERVER_SECRET()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int MPIN_BLS461_GET_SERVER_SECRET </td>
<td>(</td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>S</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>SS</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">S</td><td>is an input master secret </td></tr>
<tr><td class="paramname">SS</td><td>is the server secret = s.Q where Q is a fixed generator of G2 </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>0 or an error code </dd></dl>
</div>
</div>
<a id="afed7a304c1087b5db1162d65f3291d55"></a>
<h2 class="memtitle"><span class="permalink"><a href="#afed7a304c1087b5db1162d65f3291d55">&#9670;&nbsp;</a></span>MPIN_BLS461_GET_Y()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void MPIN_BLS461_GET_Y </td>
<td>(</td>
<td class="paramtype">int&#160;</td>
<td class="paramname"><em>h</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int&#160;</td>
<td class="paramname"><em>t</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>O</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>Y</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">h</td><td>is the hash type </td></tr>
<tr><td class="paramname">t</td><td>is epoch time in seconds </td></tr>
<tr><td class="paramname">O</td><td>is an input octet </td></tr>
<tr><td class="paramname">Y</td><td>is the output octet </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a id="a32ef77411171216549ef459753097759"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a32ef77411171216549ef459753097759">&#9670;&nbsp;</a></span>MPIN_BLS461_KANGAROO()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int MPIN_BLS461_KANGAROO </td>
<td>(</td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>E</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>F</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">E</td><td>a member of the group GT </td></tr>
<tr><td class="paramname">F</td><td>a member of the group GT = E^e </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>0 if Kangaroos failed, or the PIN error e </dd></dl>
</div>
</div>
<a id="aa3149c7f8e17f0095398aa4cf795177b"></a>
<h2 class="memtitle"><span class="permalink"><a href="#aa3149c7f8e17f0095398aa4cf795177b">&#9670;&nbsp;</a></span>MPIN_BLS461_PRECOMPUTE()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int MPIN_BLS461_PRECOMPUTE </td>
<td>(</td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>T</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>ID</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>CP</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>g1</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>g2</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">T</td><td>is the input M-Pin token (the client secret with PIN portion removed) </td></tr>
<tr><td class="paramname">ID</td><td>is the input client identity </td></tr>
<tr><td class="paramname">CP</td><td>is Public Key (or NULL) </td></tr>
<tr><td class="paramname">g1</td><td>precomputed output </td></tr>
<tr><td class="paramname">g2</td><td>precomputed output </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>0 or an error code </dd></dl>
</div>
</div>
<a id="a2d6d702b8607e4bc982eb48c019f3396"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a2d6d702b8607e4bc982eb48c019f3396">&#9670;&nbsp;</a></span>MPIN_BLS461_RANDOM_GENERATE()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int MPIN_BLS461_RANDOM_GENERATE </td>
<td>(</td>
<td class="paramtype"><a class="el" href="structcsprng.html">csprng</a> *&#160;</td>
<td class="paramname"><em>R</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>S</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">R</td><td>is a pointer to a cryptographically secure random number generator </td></tr>
<tr><td class="paramname">S</td><td>is the output random octet </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>0 or an error code </dd></dl>
</div>
</div>
<a id="acd1706c6affadd577a54d7c0a70ae2d9"></a>
<h2 class="memtitle"><span class="permalink"><a href="#acd1706c6affadd577a54d7c0a70ae2d9">&#9670;&nbsp;</a></span>MPIN_BLS461_RECOMBINE_G1()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int MPIN_BLS461_RECOMBINE_G1 </td>
<td>(</td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>Q1</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>Q2</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>Q</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">Q1</td><td>an input member of G1 </td></tr>
<tr><td class="paramname">Q2</td><td>an input member of G1 </td></tr>
<tr><td class="paramname">Q</td><td>an output member of G1 = Q1+Q2 </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>0 or an error code </dd></dl>
</div>
</div>
<a id="ac217b662770e09d47f6317f4096d1f65"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ac217b662770e09d47f6317f4096d1f65">&#9670;&nbsp;</a></span>MPIN_BLS461_RECOMBINE_G2()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int MPIN_BLS461_RECOMBINE_G2 </td>
<td>(</td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>P1</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>P2</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>P</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">P1</td><td>an input member of G2 </td></tr>
<tr><td class="paramname">P2</td><td>an input member of G2 </td></tr>
<tr><td class="paramname">P</td><td>an output member of G2 = P1+P2 </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>0 or an error code </dd></dl>
</div>
</div>
<a id="ad4c14453027ca0d6f38c8d8175b9915f"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ad4c14453027ca0d6f38c8d8175b9915f">&#9670;&nbsp;</a></span>MPIN_BLS461_RESTORE_FACTOR()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int MPIN_BLS461_RESTORE_FACTOR </td>
<td>(</td>
<td class="paramtype">int&#160;</td>
<td class="paramname"><em>h</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>ID</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int&#160;</td>
<td class="paramname"><em>factor</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int&#160;</td>
<td class="paramname"><em>facbits</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>CS</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">h</td><td>is the hash type </td></tr>
<tr><td class="paramname">ID</td><td>is the input client identity </td></tr>
<tr><td class="paramname">factor</td><td>is an input factor </td></tr>
<tr><td class="paramname">facbits</td><td>is the number of bits in the factor </td></tr>
<tr><td class="paramname">CS</td><td>is the client secret to which the factor is to be added </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>0 or an error code </dd></dl>
</div>
</div>
<a id="a5c6554014fc53e3dfcaf6f88532c2124"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a5c6554014fc53e3dfcaf6f88532c2124">&#9670;&nbsp;</a></span>MPIN_BLS461_SERVER()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int MPIN_BLS461_SERVER </td>
<td>(</td>
<td class="paramtype">int&#160;</td>
<td class="paramname"><em>h</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int&#160;</td>
<td class="paramname"><em>d</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>HID</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>HTID</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>y</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>SS</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>U</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>UT</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>V</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>E</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>F</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>ID</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>MESSAGE</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int&#160;</td>
<td class="paramname"><em>t</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>Pa</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>If Time Permits are disabled, set d = 0, and UT and HTID are not generated and can be set to NULL. If Time Permits are enabled, and PIN error detection is OFF, U and HID are not needed and can be set to NULL. If Time Permits are enabled, and PIN error detection is ON, U, UT, HID and HTID are all required. </p><dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">h</td><td>is the hash type </td></tr>
<tr><td class="paramname">d</td><td>is input date, in days since the epoch. Set to 0 if Time permits disabled </td></tr>
<tr><td class="paramname">HID</td><td>is output H(ID), a hash of the client ID </td></tr>
<tr><td class="paramname">HTID</td><td>is output H(ID)+H(d|H(ID)) </td></tr>
<tr><td class="paramname">y</td><td>is output H(t|U) or H(t|UT) if Time Permits enabled </td></tr>
<tr><td class="paramname">SS</td><td>is the input server secret </td></tr>
<tr><td class="paramname">U</td><td>is input from the client = x.H(ID) </td></tr>
<tr><td class="paramname">UT</td><td>is input from the client= x.(H(ID)+H(d|H(ID))) </td></tr>
<tr><td class="paramname">V</td><td>is an input from the client </td></tr>
<tr><td class="paramname">E</td><td>is an output to help the Kangaroos to find the PIN error, or NULL if not required </td></tr>
<tr><td class="paramname">F</td><td>is an output to help the Kangaroos to find the PIN error, or NULL if not required </td></tr>
<tr><td class="paramname">ID</td><td>is the input claimed client identity </td></tr>
<tr><td class="paramname">MESSAGE</td><td>is the message to be signed </td></tr>
<tr><td class="paramname">t</td><td>is input epoch time in seconds - a timestamp </td></tr>
<tr><td class="paramname">Pa</td><td>is input from the client z.Q or NULL if the key-escrow less scheme is not used </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>0 or an error code </dd></dl>
</div>
</div>
<a id="aee187c1fc5ffb0f036391f16b7e902ad"></a>
<h2 class="memtitle"><span class="permalink"><a href="#aee187c1fc5ffb0f036391f16b7e902ad">&#9670;&nbsp;</a></span>MPIN_BLS461_SERVER_1()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void MPIN_BLS461_SERVER_1 </td>
<td>(</td>
<td class="paramtype">int&#160;</td>
<td class="paramname"><em>h</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int&#160;</td>
<td class="paramname"><em>d</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>ID</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>HID</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>HTID</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">h</td><td>is the hash type </td></tr>
<tr><td class="paramname">d</td><td>is input date, in days since the epoch. Set to 0 if Time permits disabled </td></tr>
<tr><td class="paramname">ID</td><td>is the input claimed client identity </td></tr>
<tr><td class="paramname">HID</td><td>is output H(ID), a hash of the client ID </td></tr>
<tr><td class="paramname">HTID</td><td>is output H(ID)+H(d|H(ID)) </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>0 or an error code </dd></dl>
</div>
</div>
<a id="abd9ba6260b4418edda0e7bd6584d8c6c"></a>
<h2 class="memtitle"><span class="permalink"><a href="#abd9ba6260b4418edda0e7bd6584d8c6c">&#9670;&nbsp;</a></span>MPIN_BLS461_SERVER_2()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int MPIN_BLS461_SERVER_2 </td>
<td>(</td>
<td class="paramtype">int&#160;</td>
<td class="paramname"><em>d</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>HID</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>HTID</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>y</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>SS</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>U</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>UT</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>V</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>E</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>F</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>Pa</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>If Time Permits are disabled, set d = 0, and UT and HTID are not needed and can be set to NULL. If Time Permits are enabled, and PIN error detection is OFF, U and HID are not needed and can be set to NULL. If Time Permits are enabled, and PIN error detection is ON, U, UT, HID and HTID are all required. </p><dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">d</td><td>is input date, in days since the epoch. Set to 0 if Time permits disabled </td></tr>
<tr><td class="paramname">HID</td><td>is input H(ID), a hash of the client ID </td></tr>
<tr><td class="paramname">HTID</td><td>is input H(ID)+H(d|H(ID)) </td></tr>
<tr><td class="paramname">y</td><td>is the input server's randomly generated challenge </td></tr>
<tr><td class="paramname">SS</td><td>is the input server secret </td></tr>
<tr><td class="paramname">U</td><td>is input from the client = x.H(ID) </td></tr>
<tr><td class="paramname">UT</td><td>is input from the client= x.(H(ID)+H(d|H(ID))) </td></tr>
<tr><td class="paramname">V</td><td>is an input from the client </td></tr>
<tr><td class="paramname">E</td><td>is an output to help the Kangaroos to find the PIN error, or NULL if not required </td></tr>
<tr><td class="paramname">F</td><td>is an output to help the Kangaroos to find the PIN error, or NULL if not required </td></tr>
<tr><td class="paramname">Pa</td><td>is the input public key from the client, z.Q or NULL if the client uses regular mpin </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>0 or an error code </dd></dl>
</div>
</div>
<a id="a8ecdeeaccac76b6288600781c00c9df5"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a8ecdeeaccac76b6288600781c00c9df5">&#9670;&nbsp;</a></span>MPIN_BLS461_SERVER_KEY()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int MPIN_BLS461_SERVER_KEY </td>
<td>(</td>
<td class="paramtype">int&#160;</td>
<td class="paramname"><em>h</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>Z</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>SS</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>w</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>p</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>I</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>U</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>UT</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structoctet.html">octet</a> *&#160;</td>
<td class="paramname"><em>K</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Uses UT internally for the key calculation, unless not available in which case U is used </p><dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">h</td><td>is the hash type </td></tr>
<tr><td class="paramname">Z</td><td>is the input Client-side Diffie-Hellman component </td></tr>
<tr><td class="paramname">SS</td><td>is the input server secret </td></tr>
<tr><td class="paramname">w</td><td>is an input random number generated by the server </td></tr>
<tr><td class="paramname">p</td><td>is an input, hash of the protocol transcript </td></tr>
<tr><td class="paramname">I</td><td>is the hashed input client ID = H(ID) </td></tr>
<tr><td class="paramname">U</td><td>is input from the client = x.H(ID) </td></tr>
<tr><td class="paramname">UT</td><td>is input from the client= x.(H(ID)+H(d|H(ID))) </td></tr>
<tr><td class="paramname">K</td><td>is the output calculated shared key </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>0 or an error code </dd></dl>
</div>
</div>
</div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
Generated by &#160;<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/>
</a> 1.8.15
</small></address>
</body>
</html>