<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://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.5"/> <title>PolarSSL v1.3.8: ctr_drbg.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="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 style="padding-left: 0.5em;"> <div id="projectname">PolarSSL v1.3.8 </div> </td> </tr> </tbody> </table> </div> <!-- end header part --> <!-- Generated by Doxygen 1.8.5 --> <div id="navrow1" class="tabs"> <ul class="tablist"> <li><a href="index.html"><span>Main Page</span></a></li> <li><a href="modules.html"><span>Modules</span></a></li> <li><a href="annotated.html"><span>Data Structures</span></a></li> <li class="current"><a href="files.html"><span>Files</span></a></li> </ul> </div> <div id="navrow2" class="tabs2"> <ul class="tablist"> <li><a href="files.html"><span>File List</span></a></li> <li><a href="globals.html"><span>Globals</span></a></li> </ul> </div> <div id="nav-path" class="navpath"> <ul> <li class="navelem"><a class="el" href="dir_6a9bbd12bf4e19a18c45e270f8fae3fd.html">include</a></li><li class="navelem"><a class="el" href="dir_04272d44da4745cf8b8bfc767d6c6523.html">polarssl</a></li> </ul> </div> </div><!-- top --> <div class="header"> <div class="summary"> <a href="#nested-classes">Data Structures</a> | <a href="#define-members">Macros</a> | <a href="#func-members">Functions</a> </div> <div class="headertitle"> <div class="title">ctr_drbg.h File Reference</div> </div> </div><!--header--> <div class="contents"> <p>CTR_DRBG based on AES-256 (NIST SP 800-90) <a href="#details">More...</a></p> <div class="textblock"><code>#include <string.h></code><br/> <code>#include "<a class="el" href="aes_8h_source.html">aes.h</a>"</code><br/> </div><div class="textblock"><div class="dynheader"> Include dependency graph for ctr_drbg.h:</div> <div class="dyncontent"> <div class="center"><img src="ctr__drbg_8h__incl.png" border="0" usemap="#ctr__drbg_8h" alt=""/></div> <map name="ctr__drbg_8h" id="ctr__drbg_8h"> </map> </div> </div> <p><a href="ctr__drbg_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="nested-classes"></a> Data Structures</h2></td></tr> <tr class="memitem:"><td class="memItemLeft" align="right" valign="top">struct  </td><td class="memItemRight" valign="bottom"><a class="el" href="structctr__drbg__context.html">ctr_drbg_context</a></td></tr> <tr class="memdesc:"><td class="mdescLeft"> </td><td class="mdescRight">CTR_DRBG context structure. <a href="structctr__drbg__context.html#details">More...</a><br/></td></tr> <tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr> </table><table class="memberdecls"> <tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="define-members"></a> Macros</h2></td></tr> <tr class="memitem:a29337787324ee83801279c2bb3debfb3"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="ctr__drbg_8h.html#a29337787324ee83801279c2bb3debfb3">POLARSSL_ERR_CTR_DRBG_ENTROPY_SOURCE_FAILED</a>   -0x0034</td></tr> <tr class="memdesc:a29337787324ee83801279c2bb3debfb3"><td class="mdescLeft"> </td><td class="mdescRight">The entropy source failed. <a href="#a29337787324ee83801279c2bb3debfb3">More...</a><br/></td></tr> <tr class="separator:a29337787324ee83801279c2bb3debfb3"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a4ec9724247956f9b2004beb3998cbf4b"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="ctr__drbg_8h.html#a4ec9724247956f9b2004beb3998cbf4b">POLARSSL_ERR_CTR_DRBG_REQUEST_TOO_BIG</a>   -0x0036</td></tr> <tr class="memdesc:a4ec9724247956f9b2004beb3998cbf4b"><td class="mdescLeft"> </td><td class="mdescRight">Too many random requested in single call. <a href="#a4ec9724247956f9b2004beb3998cbf4b">More...</a><br/></td></tr> <tr class="separator:a4ec9724247956f9b2004beb3998cbf4b"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:ad2ebdb67b7c42e990590e1b5d6cbadf4"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="ctr__drbg_8h.html#ad2ebdb67b7c42e990590e1b5d6cbadf4">POLARSSL_ERR_CTR_DRBG_INPUT_TOO_BIG</a>   -0x0038</td></tr> <tr class="memdesc:ad2ebdb67b7c42e990590e1b5d6cbadf4"><td class="mdescLeft"> </td><td class="mdescRight">Input too large (Entropy + additional). <a href="#ad2ebdb67b7c42e990590e1b5d6cbadf4">More...</a><br/></td></tr> <tr class="separator:ad2ebdb67b7c42e990590e1b5d6cbadf4"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:ac24b26db879708ddef6840f37a1c94aa"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="ctr__drbg_8h.html#ac24b26db879708ddef6840f37a1c94aa">POLARSSL_ERR_CTR_DRBG_FILE_IO_ERROR</a>   -0x003A</td></tr> <tr class="memdesc:ac24b26db879708ddef6840f37a1c94aa"><td class="mdescLeft"> </td><td class="mdescRight">Read/write error in file. <a href="#ac24b26db879708ddef6840f37a1c94aa">More...</a><br/></td></tr> <tr class="separator:ac24b26db879708ddef6840f37a1c94aa"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a907251d56e7adb3d795bfe04e1f36865"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="ctr__drbg_8h.html#a907251d56e7adb3d795bfe04e1f36865">CTR_DRBG_BLOCKSIZE</a>   16</td></tr> <tr class="memdesc:a907251d56e7adb3d795bfe04e1f36865"><td class="mdescLeft"> </td><td class="mdescRight">Block size used by the cipher. <a href="#a907251d56e7adb3d795bfe04e1f36865">More...</a><br/></td></tr> <tr class="separator:a907251d56e7adb3d795bfe04e1f36865"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a7e724588e94f73bd3fb7623e3f191913"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="ctr__drbg_8h.html#a7e724588e94f73bd3fb7623e3f191913">CTR_DRBG_KEYSIZE</a>   32</td></tr> <tr class="memdesc:a7e724588e94f73bd3fb7623e3f191913"><td class="mdescLeft"> </td><td class="mdescRight">Key size used by the cipher. <a href="#a7e724588e94f73bd3fb7623e3f191913">More...</a><br/></td></tr> <tr class="separator:a7e724588e94f73bd3fb7623e3f191913"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:ad7fddfff369d259329ff0f7c64063da0"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="ctr__drbg_8h.html#ad7fddfff369d259329ff0f7c64063da0">CTR_DRBG_KEYBITS</a>   ( <a class="el" href="ctr__drbg_8h.html#a7e724588e94f73bd3fb7623e3f191913">CTR_DRBG_KEYSIZE</a> * 8 )</td></tr> <tr class="separator:ad7fddfff369d259329ff0f7c64063da0"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:ab2109628bba8f8548bf5f0d18bf18cd8"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="ctr__drbg_8h.html#ab2109628bba8f8548bf5f0d18bf18cd8">CTR_DRBG_SEEDLEN</a>   ( <a class="el" href="ctr__drbg_8h.html#a7e724588e94f73bd3fb7623e3f191913">CTR_DRBG_KEYSIZE</a> + <a class="el" href="ctr__drbg_8h.html#a907251d56e7adb3d795bfe04e1f36865">CTR_DRBG_BLOCKSIZE</a> )</td></tr> <tr class="memdesc:ab2109628bba8f8548bf5f0d18bf18cd8"><td class="mdescLeft"> </td><td class="mdescRight">The seed length (counter + AES key) <a href="#ab2109628bba8f8548bf5f0d18bf18cd8">More...</a><br/></td></tr> <tr class="separator:ab2109628bba8f8548bf5f0d18bf18cd8"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:ad15c071c711a60200f5dcbbcb191c9eb"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="ctr__drbg_8h.html#ad15c071c711a60200f5dcbbcb191c9eb">CTR_DRBG_PR_OFF</a>   0</td></tr> <tr class="memdesc:ad15c071c711a60200f5dcbbcb191c9eb"><td class="mdescLeft"> </td><td class="mdescRight">No prediction resistance. <a href="#ad15c071c711a60200f5dcbbcb191c9eb">More...</a><br/></td></tr> <tr class="separator:ad15c071c711a60200f5dcbbcb191c9eb"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:ac689b93ae32164241a48cee742a8fc74"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="ctr__drbg_8h.html#ac689b93ae32164241a48cee742a8fc74">CTR_DRBG_PR_ON</a>   1</td></tr> <tr class="memdesc:ac689b93ae32164241a48cee742a8fc74"><td class="mdescLeft"> </td><td class="mdescRight">Prediction resistance enabled. <a href="#ac689b93ae32164241a48cee742a8fc74">More...</a><br/></td></tr> <tr class="separator:ac689b93ae32164241a48cee742a8fc74"><td class="memSeparator" colspan="2"> </td></tr> <tr><td colspan="2"><div class="groupHeader">SECTION: Module settings</div></td></tr> <tr><td colspan="2"><div class="groupText"><p>The configuration options you can set for this module are in this section.</p> <p>Either change them in <a class="el" href="config_8h.html" title="Configuration options (set of defines) ">config.h</a> or define them on the compiler command line. </p> </div></td></tr> <tr class="memitem:aad464fda72b082db273843523b6de363"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="ctr__drbg_8h.html#aad464fda72b082db273843523b6de363">CTR_DRBG_ENTROPY_LEN</a>   48</td></tr> <tr class="memdesc:aad464fda72b082db273843523b6de363"><td class="mdescLeft"> </td><td class="mdescRight">Amount of entropy used per seed by default (48 with SHA-512, 32 with SHA-256) <a href="#aad464fda72b082db273843523b6de363">More...</a><br/></td></tr> <tr class="separator:aad464fda72b082db273843523b6de363"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:aada2905e3923ac30ff08869396fa715a"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="ctr__drbg_8h.html#aada2905e3923ac30ff08869396fa715a">CTR_DRBG_RESEED_INTERVAL</a>   10000</td></tr> <tr class="memdesc:aada2905e3923ac30ff08869396fa715a"><td class="mdescLeft"> </td><td class="mdescRight">Interval before reseed is performed by default. <a href="#aada2905e3923ac30ff08869396fa715a">More...</a><br/></td></tr> <tr class="separator:aada2905e3923ac30ff08869396fa715a"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:aa422ee06cd5836113c0068996fa9560c"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="ctr__drbg_8h.html#aa422ee06cd5836113c0068996fa9560c">CTR_DRBG_MAX_INPUT</a>   256</td></tr> <tr class="memdesc:aa422ee06cd5836113c0068996fa9560c"><td class="mdescLeft"> </td><td class="mdescRight">Maximum number of additional input bytes. <a href="#aa422ee06cd5836113c0068996fa9560c">More...</a><br/></td></tr> <tr class="separator:aa422ee06cd5836113c0068996fa9560c"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a97273e0c80ab6111bf79f05834f174bf"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="ctr__drbg_8h.html#a97273e0c80ab6111bf79f05834f174bf">CTR_DRBG_MAX_REQUEST</a>   1024</td></tr> <tr class="memdesc:a97273e0c80ab6111bf79f05834f174bf"><td class="mdescLeft"> </td><td class="mdescRight">Maximum number of requested bytes per call. <a href="#a97273e0c80ab6111bf79f05834f174bf">More...</a><br/></td></tr> <tr class="separator:a97273e0c80ab6111bf79f05834f174bf"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:aeeb6d3716faa516c3b90d6587de119dc"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="ctr__drbg_8h.html#aeeb6d3716faa516c3b90d6587de119dc">CTR_DRBG_MAX_SEED_INPUT</a>   384</td></tr> <tr class="memdesc:aeeb6d3716faa516c3b90d6587de119dc"><td class="mdescLeft"> </td><td class="mdescRight">Maximum size of (re)seed buffer. <a href="#aeeb6d3716faa516c3b90d6587de119dc">More...</a><br/></td></tr> <tr class="separator:aeeb6d3716faa516c3b90d6587de119dc"><td class="memSeparator" colspan="2"> </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:a0e27d989ba78d2a5a40166d68a1b7bdb"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="ctr__drbg_8h.html#a0e27d989ba78d2a5a40166d68a1b7bdb">ctr_drbg_init</a> (<a class="el" href="structctr__drbg__context.html">ctr_drbg_context</a> *ctx, int(*f_entropy)(void *, unsigned char *, size_t), void *p_entropy, const unsigned char *custom, size_t len)</td></tr> <tr class="memdesc:a0e27d989ba78d2a5a40166d68a1b7bdb"><td class="mdescLeft"> </td><td class="mdescRight">CTR_DRBG initialization. <a href="#a0e27d989ba78d2a5a40166d68a1b7bdb">More...</a><br/></td></tr> <tr class="separator:a0e27d989ba78d2a5a40166d68a1b7bdb"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:af58c0660e33c9f98a934e01e1e9a9d0b"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="ctr__drbg_8h.html#af58c0660e33c9f98a934e01e1e9a9d0b">ctr_drbg_free</a> (<a class="el" href="structctr__drbg__context.html">ctr_drbg_context</a> *ctx)</td></tr> <tr class="memdesc:af58c0660e33c9f98a934e01e1e9a9d0b"><td class="mdescLeft"> </td><td class="mdescRight">Clear CTR_CRBG context data. <a href="#af58c0660e33c9f98a934e01e1e9a9d0b">More...</a><br/></td></tr> <tr class="separator:af58c0660e33c9f98a934e01e1e9a9d0b"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a0a4b47f2f9c153ca84ff3f27193dcfec"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="ctr__drbg_8h.html#a0a4b47f2f9c153ca84ff3f27193dcfec">ctr_drbg_set_prediction_resistance</a> (<a class="el" href="structctr__drbg__context.html">ctr_drbg_context</a> *ctx, int resistance)</td></tr> <tr class="memdesc:a0a4b47f2f9c153ca84ff3f27193dcfec"><td class="mdescLeft"> </td><td class="mdescRight">Enable / disable prediction resistance (Default: Off) <a href="#a0a4b47f2f9c153ca84ff3f27193dcfec">More...</a><br/></td></tr> <tr class="separator:a0a4b47f2f9c153ca84ff3f27193dcfec"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a48c1d04815d90f4d191e848209483ffd"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="ctr__drbg_8h.html#a48c1d04815d90f4d191e848209483ffd">ctr_drbg_set_entropy_len</a> (<a class="el" href="structctr__drbg__context.html">ctr_drbg_context</a> *ctx, size_t len)</td></tr> <tr class="memdesc:a48c1d04815d90f4d191e848209483ffd"><td class="mdescLeft"> </td><td class="mdescRight">Set the amount of entropy grabbed on each (re)seed (Default: CTR_DRBG_ENTROPY_LEN) <a href="#a48c1d04815d90f4d191e848209483ffd">More...</a><br/></td></tr> <tr class="separator:a48c1d04815d90f4d191e848209483ffd"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a2ce2d084b5c2a25d7dafb912c73b24a6"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="ctr__drbg_8h.html#a2ce2d084b5c2a25d7dafb912c73b24a6">ctr_drbg_set_reseed_interval</a> (<a class="el" href="structctr__drbg__context.html">ctr_drbg_context</a> *ctx, int interval)</td></tr> <tr class="memdesc:a2ce2d084b5c2a25d7dafb912c73b24a6"><td class="mdescLeft"> </td><td class="mdescRight">Set the reseed interval (Default: CTR_DRBG_RESEED_INTERVAL) <a href="#a2ce2d084b5c2a25d7dafb912c73b24a6">More...</a><br/></td></tr> <tr class="separator:a2ce2d084b5c2a25d7dafb912c73b24a6"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:af958b326a8a3f7c168867d999a9b6b55"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="ctr__drbg_8h.html#af958b326a8a3f7c168867d999a9b6b55">ctr_drbg_reseed</a> (<a class="el" href="structctr__drbg__context.html">ctr_drbg_context</a> *ctx, const unsigned char *additional, size_t len)</td></tr> <tr class="memdesc:af958b326a8a3f7c168867d999a9b6b55"><td class="mdescLeft"> </td><td class="mdescRight">CTR_DRBG reseeding (extracts data from entropy source) <a href="#af958b326a8a3f7c168867d999a9b6b55">More...</a><br/></td></tr> <tr class="separator:af958b326a8a3f7c168867d999a9b6b55"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a62b4daaff672263de0827dbe150f21fe"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="ctr__drbg_8h.html#a62b4daaff672263de0827dbe150f21fe">ctr_drbg_update</a> (<a class="el" href="structctr__drbg__context.html">ctr_drbg_context</a> *ctx, const unsigned char *additional, size_t add_len)</td></tr> <tr class="memdesc:a62b4daaff672263de0827dbe150f21fe"><td class="mdescLeft"> </td><td class="mdescRight">CTR_DRBG update state. <a href="#a62b4daaff672263de0827dbe150f21fe">More...</a><br/></td></tr> <tr class="separator:a62b4daaff672263de0827dbe150f21fe"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a7484335f1f0e7460c06e0e949e6a5a95"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="ctr__drbg_8h.html#a7484335f1f0e7460c06e0e949e6a5a95">ctr_drbg_random_with_add</a> (void *p_rng, unsigned char *output, size_t output_len, const unsigned char *additional, size_t add_len)</td></tr> <tr class="memdesc:a7484335f1f0e7460c06e0e949e6a5a95"><td class="mdescLeft"> </td><td class="mdescRight">CTR_DRBG generate random with additional update input. <a href="#a7484335f1f0e7460c06e0e949e6a5a95">More...</a><br/></td></tr> <tr class="separator:a7484335f1f0e7460c06e0e949e6a5a95"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a2625d0bebed2f8e1d9f4257e4ed3a02c"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="ctr__drbg_8h.html#a2625d0bebed2f8e1d9f4257e4ed3a02c">ctr_drbg_random</a> (void *p_rng, unsigned char *output, size_t output_len)</td></tr> <tr class="memdesc:a2625d0bebed2f8e1d9f4257e4ed3a02c"><td class="mdescLeft"> </td><td class="mdescRight">CTR_DRBG generate random. <a href="#a2625d0bebed2f8e1d9f4257e4ed3a02c">More...</a><br/></td></tr> <tr class="separator:a2625d0bebed2f8e1d9f4257e4ed3a02c"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a1fbf41eb924ef6d0cabfdf586696ccd0"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="ctr__drbg_8h.html#a1fbf41eb924ef6d0cabfdf586696ccd0">ctr_drbg_write_seed_file</a> (<a class="el" href="structctr__drbg__context.html">ctr_drbg_context</a> *ctx, const char *path)</td></tr> <tr class="memdesc:a1fbf41eb924ef6d0cabfdf586696ccd0"><td class="mdescLeft"> </td><td class="mdescRight">Write a seed file. <a href="#a1fbf41eb924ef6d0cabfdf586696ccd0">More...</a><br/></td></tr> <tr class="separator:a1fbf41eb924ef6d0cabfdf586696ccd0"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a0aaede25b684a60113dd1d0dc86b0267"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="ctr__drbg_8h.html#a0aaede25b684a60113dd1d0dc86b0267">ctr_drbg_update_seed_file</a> (<a class="el" href="structctr__drbg__context.html">ctr_drbg_context</a> *ctx, const char *path)</td></tr> <tr class="memdesc:a0aaede25b684a60113dd1d0dc86b0267"><td class="mdescLeft"> </td><td class="mdescRight">Read and update a seed file. <a href="#a0aaede25b684a60113dd1d0dc86b0267">More...</a><br/></td></tr> <tr class="separator:a0aaede25b684a60113dd1d0dc86b0267"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:aa1bdc01be25861d3b5f51565a7604c6a"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="ctr__drbg_8h.html#aa1bdc01be25861d3b5f51565a7604c6a">ctr_drbg_self_test</a> (int verbose)</td></tr> <tr class="memdesc:aa1bdc01be25861d3b5f51565a7604c6a"><td class="mdescLeft"> </td><td class="mdescRight">Checkup routine. <a href="#aa1bdc01be25861d3b5f51565a7604c6a">More...</a><br/></td></tr> <tr class="separator:aa1bdc01be25861d3b5f51565a7604c6a"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a15775822b651b6201d796fab79ce7fd5"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="ctr__drbg_8h.html#a15775822b651b6201d796fab79ce7fd5">ctr_drbg_init_entropy_len</a> (<a class="el" href="structctr__drbg__context.html">ctr_drbg_context</a> *, int(*)(void *, unsigned char *, size_t), void *, const unsigned char *, size_t, size_t)</td></tr> <tr class="separator:a15775822b651b6201d796fab79ce7fd5"><td class="memSeparator" colspan="2"> </td></tr> </table> <a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2> <div class="textblock"><p>CTR_DRBG based on AES-256 (NIST SP 800-90) </p> <p>Copyright (C) 2006-2014, Brainspark B.V.</p> <p>This file is part of PolarSSL (<a href="http://www.polarssl.org">http://www.polarssl.org</a>) Lead Maintainer: Paul Bakker <polarssl_maintainer at polarssl.org></p> <p>All rights reserved.</p> <p>This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.</p> <p>This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.</p> <p>You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. </p> <p>Definition in file <a class="el" href="ctr__drbg_8h_source.html">ctr_drbg.h</a>.</p> </div><h2 class="groupheader">Macro Definition Documentation</h2> <a class="anchor" id="a907251d56e7adb3d795bfe04e1f36865"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">#define CTR_DRBG_BLOCKSIZE   16</td> </tr> </table> </div><div class="memdoc"> <p>Block size used by the cipher. </p> <p>Definition at line <a class="el" href="ctr__drbg_8h_source.html#l00039">39</a> of file <a class="el" href="ctr__drbg_8h_source.html">ctr_drbg.h</a>.</p> </div> </div> <a class="anchor" id="aad464fda72b082db273843523b6de363"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">#define CTR_DRBG_ENTROPY_LEN   48</td> </tr> </table> </div><div class="memdoc"> <p>Amount of entropy used per seed by default (48 with SHA-512, 32 with SHA-256) </p> <p>Definition at line <a class="el" href="ctr__drbg_8h_source.html#l00055">55</a> of file <a class="el" href="ctr__drbg_8h_source.html">ctr_drbg.h</a>.</p> </div> </div> <a class="anchor" id="ad7fddfff369d259329ff0f7c64063da0"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">#define CTR_DRBG_KEYBITS   ( <a class="el" href="ctr__drbg_8h.html#a7e724588e94f73bd3fb7623e3f191913">CTR_DRBG_KEYSIZE</a> * 8 )</td> </tr> </table> </div><div class="memdoc"> <p>Definition at line <a class="el" href="ctr__drbg_8h_source.html#l00041">41</a> of file <a class="el" href="ctr__drbg_8h_source.html">ctr_drbg.h</a>.</p> </div> </div> <a class="anchor" id="a7e724588e94f73bd3fb7623e3f191913"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">#define CTR_DRBG_KEYSIZE   32</td> </tr> </table> </div><div class="memdoc"> <p>Key size used by the cipher. </p> <p>Definition at line <a class="el" href="ctr__drbg_8h_source.html#l00040">40</a> of file <a class="el" href="ctr__drbg_8h_source.html">ctr_drbg.h</a>.</p> </div> </div> <a class="anchor" id="aa422ee06cd5836113c0068996fa9560c"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">#define CTR_DRBG_MAX_INPUT   256</td> </tr> </table> </div><div class="memdoc"> <p>Maximum number of additional input bytes. </p> <p>Definition at line <a class="el" href="ctr__drbg_8h_source.html#l00066">66</a> of file <a class="el" href="ctr__drbg_8h_source.html">ctr_drbg.h</a>.</p> </div> </div> <a class="anchor" id="a97273e0c80ab6111bf79f05834f174bf"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">#define CTR_DRBG_MAX_REQUEST   1024</td> </tr> </table> </div><div class="memdoc"> <p>Maximum number of requested bytes per call. </p> <p>Definition at line <a class="el" href="ctr__drbg_8h_source.html#l00070">70</a> of file <a class="el" href="ctr__drbg_8h_source.html">ctr_drbg.h</a>.</p> </div> </div> <a class="anchor" id="aeeb6d3716faa516c3b90d6587de119dc"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">#define CTR_DRBG_MAX_SEED_INPUT   384</td> </tr> </table> </div><div class="memdoc"> <p>Maximum size of (re)seed buffer. </p> <p>Definition at line <a class="el" href="ctr__drbg_8h_source.html#l00074">74</a> of file <a class="el" href="ctr__drbg_8h_source.html">ctr_drbg.h</a>.</p> </div> </div> <a class="anchor" id="ad15c071c711a60200f5dcbbcb191c9eb"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">#define CTR_DRBG_PR_OFF   0</td> </tr> </table> </div><div class="memdoc"> <p>No prediction resistance. </p> <p>Definition at line <a class="el" href="ctr__drbg_8h_source.html#l00079">79</a> of file <a class="el" href="ctr__drbg_8h_source.html">ctr_drbg.h</a>.</p> </div> </div> <a class="anchor" id="ac689b93ae32164241a48cee742a8fc74"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">#define CTR_DRBG_PR_ON   1</td> </tr> </table> </div><div class="memdoc"> <p>Prediction resistance enabled. </p> <p>Definition at line <a class="el" href="ctr__drbg_8h_source.html#l00080">80</a> of file <a class="el" href="ctr__drbg_8h_source.html">ctr_drbg.h</a>.</p> </div> </div> <a class="anchor" id="aada2905e3923ac30ff08869396fa715a"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">#define CTR_DRBG_RESEED_INTERVAL   10000</td> </tr> </table> </div><div class="memdoc"> <p>Interval before reseed is performed by default. </p> <p>Definition at line <a class="el" href="ctr__drbg_8h_source.html#l00062">62</a> of file <a class="el" href="ctr__drbg_8h_source.html">ctr_drbg.h</a>.</p> </div> </div> <a class="anchor" id="ab2109628bba8f8548bf5f0d18bf18cd8"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">#define CTR_DRBG_SEEDLEN   ( <a class="el" href="ctr__drbg_8h.html#a7e724588e94f73bd3fb7623e3f191913">CTR_DRBG_KEYSIZE</a> + <a class="el" href="ctr__drbg_8h.html#a907251d56e7adb3d795bfe04e1f36865">CTR_DRBG_BLOCKSIZE</a> )</td> </tr> </table> </div><div class="memdoc"> <p>The seed length (counter + AES key) </p> <p>Definition at line <a class="el" href="ctr__drbg_8h_source.html#l00042">42</a> of file <a class="el" href="ctr__drbg_8h_source.html">ctr_drbg.h</a>.</p> </div> </div> <a class="anchor" id="a29337787324ee83801279c2bb3debfb3"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">#define POLARSSL_ERR_CTR_DRBG_ENTROPY_SOURCE_FAILED   -0x0034</td> </tr> </table> </div><div class="memdoc"> <p>The entropy source failed. </p> <p>Definition at line <a class="el" href="ctr__drbg_8h_source.html#l00034">34</a> of file <a class="el" href="ctr__drbg_8h_source.html">ctr_drbg.h</a>.</p> </div> </div> <a class="anchor" id="ac24b26db879708ddef6840f37a1c94aa"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">#define POLARSSL_ERR_CTR_DRBG_FILE_IO_ERROR   -0x003A</td> </tr> </table> </div><div class="memdoc"> <p>Read/write error in file. </p> <p>Definition at line <a class="el" href="ctr__drbg_8h_source.html#l00037">37</a> of file <a class="el" href="ctr__drbg_8h_source.html">ctr_drbg.h</a>.</p> </div> </div> <a class="anchor" id="ad2ebdb67b7c42e990590e1b5d6cbadf4"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">#define POLARSSL_ERR_CTR_DRBG_INPUT_TOO_BIG   -0x0038</td> </tr> </table> </div><div class="memdoc"> <p>Input too large (Entropy + additional). </p> <p>Definition at line <a class="el" href="ctr__drbg_8h_source.html#l00036">36</a> of file <a class="el" href="ctr__drbg_8h_source.html">ctr_drbg.h</a>.</p> </div> </div> <a class="anchor" id="a4ec9724247956f9b2004beb3998cbf4b"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">#define POLARSSL_ERR_CTR_DRBG_REQUEST_TOO_BIG   -0x0036</td> </tr> </table> </div><div class="memdoc"> <p>Too many random requested in single call. </p> <p>Definition at line <a class="el" href="ctr__drbg_8h_source.html#l00035">35</a> of file <a class="el" href="ctr__drbg_8h_source.html">ctr_drbg.h</a>.</p> </div> </div> <h2 class="groupheader">Function Documentation</h2> <a class="anchor" id="af58c0660e33c9f98a934e01e1e9a9d0b"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">void ctr_drbg_free </td> <td>(</td> <td class="paramtype"><a class="el" href="structctr__drbg__context.html">ctr_drbg_context</a> * </td> <td class="paramname"><em>ctx</em></td><td>)</td> <td></td> </tr> </table> </div><div class="memdoc"> <p>Clear CTR_CRBG context data. </p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">ctx</td><td>CTR_DRBG context to clear </td></tr> </table> </dd> </dl> </div> </div> <a class="anchor" id="a0e27d989ba78d2a5a40166d68a1b7bdb"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">int ctr_drbg_init </td> <td>(</td> <td class="paramtype"><a class="el" href="structctr__drbg__context.html">ctr_drbg_context</a> * </td> <td class="paramname"><em>ctx</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">int(*)(void *, unsigned char *, size_t) </td> <td class="paramname"><em>f_entropy</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">void * </td> <td class="paramname"><em>p_entropy</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">const unsigned char * </td> <td class="paramname"><em>custom</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">size_t </td> <td class="paramname"><em>len</em> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td></td> </tr> </table> </div><div class="memdoc"> <p>CTR_DRBG initialization. </p> <p>Note: Personalization data can be provided in addition to the more generic entropy source to make this instantiation as unique as possible.</p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">ctx</td><td>CTR_DRBG context to be initialized </td></tr> <tr><td class="paramname">f_entropy</td><td>Entropy callback (p_entropy, buffer to fill, buffer length) </td></tr> <tr><td class="paramname">p_entropy</td><td>Entropy context </td></tr> <tr><td class="paramname">custom</td><td>Personalization data (Device specific identifiers) (Can be NULL) </td></tr> <tr><td class="paramname">len</td><td>Length of personalization data</td></tr> </table> </dd> </dl> <dl class="section return"><dt>Returns</dt><dd>0 if successful, or POLARSSL_ERR_CTR_DRBG_ENTROPY_SOURCE_FAILED </dd></dl> </div> </div> <a class="anchor" id="a15775822b651b6201d796fab79ce7fd5"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">int ctr_drbg_init_entropy_len </td> <td>(</td> <td class="paramtype"><a class="el" href="structctr__drbg__context.html">ctr_drbg_context</a> * </td> <td class="paramname">, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">int(*)(void *, unsigned char *, size_t) </td> <td class="paramname">, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">void * </td> <td class="paramname">, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">const unsigned char * </td> <td class="paramname">, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">size_t </td> <td class="paramname">, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">size_t </td> <td class="paramname"> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td></td> </tr> </table> </div><div class="memdoc"> </div> </div> <a class="anchor" id="a2625d0bebed2f8e1d9f4257e4ed3a02c"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">int ctr_drbg_random </td> <td>(</td> <td class="paramtype">void * </td> <td class="paramname"><em>p_rng</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">unsigned char * </td> <td class="paramname"><em>output</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">size_t </td> <td class="paramname"><em>output_len</em> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td></td> </tr> </table> </div><div class="memdoc"> <p>CTR_DRBG generate random. </p> <p>Note: Automatically reseeds if reseed_counter is reached.</p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">p_rng</td><td>CTR_DRBG context </td></tr> <tr><td class="paramname">output</td><td>Buffer to fill </td></tr> <tr><td class="paramname">output_len</td><td>Length of the buffer</td></tr> </table> </dd> </dl> <dl class="section return"><dt>Returns</dt><dd>0 if successful, or POLARSSL_ERR_CTR_DRBG_ENTROPY_SOURCE_FAILED, or POLARSSL_ERR_CTR_DRBG_REQUEST_TOO_BIG </dd></dl> </div> </div> <a class="anchor" id="a7484335f1f0e7460c06e0e949e6a5a95"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">int ctr_drbg_random_with_add </td> <td>(</td> <td class="paramtype">void * </td> <td class="paramname"><em>p_rng</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">unsigned char * </td> <td class="paramname"><em>output</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">size_t </td> <td class="paramname"><em>output_len</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">const unsigned char * </td> <td class="paramname"><em>additional</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">size_t </td> <td class="paramname"><em>add_len</em> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td></td> </tr> </table> </div><div class="memdoc"> <p>CTR_DRBG generate random with additional update input. </p> <p>Note: Automatically reseeds if reseed_counter is reached.</p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">p_rng</td><td>CTR_DRBG context </td></tr> <tr><td class="paramname">output</td><td>Buffer to fill </td></tr> <tr><td class="paramname">output_len</td><td>Length of the buffer </td></tr> <tr><td class="paramname">additional</td><td>Additional data to update with (Can be NULL) </td></tr> <tr><td class="paramname">add_len</td><td>Length of additional data</td></tr> </table> </dd> </dl> <dl class="section return"><dt>Returns</dt><dd>0 if successful, or POLARSSL_ERR_CTR_DRBG_ENTROPY_SOURCE_FAILED, or POLARSSL_ERR_CTR_DRBG_REQUEST_TOO_BIG </dd></dl> </div> </div> <a class="anchor" id="af958b326a8a3f7c168867d999a9b6b55"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">int ctr_drbg_reseed </td> <td>(</td> <td class="paramtype"><a class="el" href="structctr__drbg__context.html">ctr_drbg_context</a> * </td> <td class="paramname"><em>ctx</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">const unsigned char * </td> <td class="paramname"><em>additional</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">size_t </td> <td class="paramname"><em>len</em> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td></td> </tr> </table> </div><div class="memdoc"> <p>CTR_DRBG reseeding (extracts data from entropy source) </p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">ctx</td><td>CTR_DRBG context </td></tr> <tr><td class="paramname">additional</td><td>Additional data to add to state (Can be NULL) </td></tr> <tr><td class="paramname">len</td><td>Length of additional data</td></tr> </table> </dd> </dl> <dl class="section return"><dt>Returns</dt><dd>0 if successful, or POLARSSL_ERR_CTR_DRBG_ENTROPY_SOURCE_FAILED </dd></dl> </div> </div> <a class="anchor" id="aa1bdc01be25861d3b5f51565a7604c6a"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">int ctr_drbg_self_test </td> <td>(</td> <td class="paramtype">int </td> <td class="paramname"><em>verbose</em></td><td>)</td> <td></td> </tr> </table> </div><div class="memdoc"> <p>Checkup routine. </p> <dl class="section return"><dt>Returns</dt><dd>0 if successful, or 1 if the test failed </dd></dl> </div> </div> <a class="anchor" id="a48c1d04815d90f4d191e848209483ffd"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">void ctr_drbg_set_entropy_len </td> <td>(</td> <td class="paramtype"><a class="el" href="structctr__drbg__context.html">ctr_drbg_context</a> * </td> <td class="paramname"><em>ctx</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">size_t </td> <td class="paramname"><em>len</em> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td></td> </tr> </table> </div><div class="memdoc"> <p>Set the amount of entropy grabbed on each (re)seed (Default: CTR_DRBG_ENTROPY_LEN) </p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">ctx</td><td>CTR_DRBG context </td></tr> <tr><td class="paramname">len</td><td>Amount of entropy to grab </td></tr> </table> </dd> </dl> </div> </div> <a class="anchor" id="a0a4b47f2f9c153ca84ff3f27193dcfec"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">void ctr_drbg_set_prediction_resistance </td> <td>(</td> <td class="paramtype"><a class="el" href="structctr__drbg__context.html">ctr_drbg_context</a> * </td> <td class="paramname"><em>ctx</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">int </td> <td class="paramname"><em>resistance</em> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td></td> </tr> </table> </div><div class="memdoc"> <p>Enable / disable prediction resistance (Default: Off) </p> <p>Note: If enabled, entropy is used for ctx->entropy_len before each call! Only use this if you have ample supply of good entropy!</p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">ctx</td><td>CTR_DRBG context </td></tr> <tr><td class="paramname">resistance</td><td>CTR_DRBG_PR_ON or CTR_DRBG_PR_OFF </td></tr> </table> </dd> </dl> </div> </div> <a class="anchor" id="a2ce2d084b5c2a25d7dafb912c73b24a6"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">void ctr_drbg_set_reseed_interval </td> <td>(</td> <td class="paramtype"><a class="el" href="structctr__drbg__context.html">ctr_drbg_context</a> * </td> <td class="paramname"><em>ctx</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">int </td> <td class="paramname"><em>interval</em> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td></td> </tr> </table> </div><div class="memdoc"> <p>Set the reseed interval (Default: CTR_DRBG_RESEED_INTERVAL) </p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">ctx</td><td>CTR_DRBG context </td></tr> <tr><td class="paramname">interval</td><td>Reseed interval </td></tr> </table> </dd> </dl> </div> </div> <a class="anchor" id="a62b4daaff672263de0827dbe150f21fe"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">void ctr_drbg_update </td> <td>(</td> <td class="paramtype"><a class="el" href="structctr__drbg__context.html">ctr_drbg_context</a> * </td> <td class="paramname"><em>ctx</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">const unsigned char * </td> <td class="paramname"><em>additional</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">size_t </td> <td class="paramname"><em>add_len</em> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td></td> </tr> </table> </div><div class="memdoc"> <p>CTR_DRBG update state. </p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">ctx</td><td>CTR_DRBG context </td></tr> <tr><td class="paramname">additional</td><td>Additional data to update state with </td></tr> <tr><td class="paramname">add_len</td><td>Length of additional data </td></tr> </table> </dd> </dl> </div> </div> <a class="anchor" id="a0aaede25b684a60113dd1d0dc86b0267"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">int ctr_drbg_update_seed_file </td> <td>(</td> <td class="paramtype"><a class="el" href="structctr__drbg__context.html">ctr_drbg_context</a> * </td> <td class="paramname"><em>ctx</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">const char * </td> <td class="paramname"><em>path</em> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td></td> </tr> </table> </div><div class="memdoc"> <p>Read and update a seed file. </p> <p>Seed is added to this instance</p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">ctx</td><td>CTR_DRBG context </td></tr> <tr><td class="paramname">path</td><td>Name of the file</td></tr> </table> </dd> </dl> <dl class="section return"><dt>Returns</dt><dd>0 if successful, POLARSSL_ERR_CTR_DRBG_FILE_IO_ERROR on file error, POLARSSL_ERR_CTR_DRBG_ENTROPY_SOURCE_FAILED or POLARSSL_ERR_CTR_DRBG_INPUT_TOO_BIG </dd></dl> </div> </div> <a class="anchor" id="a1fbf41eb924ef6d0cabfdf586696ccd0"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">int ctr_drbg_write_seed_file </td> <td>(</td> <td class="paramtype"><a class="el" href="structctr__drbg__context.html">ctr_drbg_context</a> * </td> <td class="paramname"><em>ctx</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">const char * </td> <td class="paramname"><em>path</em> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td></td> </tr> </table> </div><div class="memdoc"> <p>Write a seed file. </p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">ctx</td><td>CTR_DRBG context </td></tr> <tr><td class="paramname">path</td><td>Name of the file</td></tr> </table> </dd> </dl> <dl class="section return"><dt>Returns</dt><dd>0 if successful, POLARSSL_ERR_CTR_DRBG_FILE_IO_ERROR on file error, or POLARSSL_ERR_CTR_DRBG_ENTROPY_SOURCE_FAILED </dd></dl> </div> </div> </div><!-- contents --> <!-- start footer part --> <hr class="footer"/><address class="footer"><small> Generated on Thu Jul 31 2014 11:35:55 for PolarSSL v1.3.8 by  <a href="http://www.doxygen.org/index.html"> <img class="footer" src="doxygen.png" alt="doxygen"/> </a> 1.8.5 </small></address> </body> </html>