<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>crypto_rng_reset</title><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="Linux Kernel Crypto API"><link rel="up" href="ch04s14.html" title="Crypto API Random Number API"><link rel="prev" href="API-crypto-rng-get-bytes.html" title="crypto_rng_get_bytes"><link rel="next" href="API-crypto-rng-seedsize.html" title="crypto_rng_seedsize"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center"><span class="phrase">crypto_rng_reset</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-crypto-rng-get-bytes.html">Prev</a> </td><th width="60%" align="center">Crypto API Random Number API</th><td width="20%" align="right"> <a accesskey="n" href="API-crypto-rng-seedsize.html">Next</a></td></tr></table><hr></div><div class="refentry"><a name="API-crypto-rng-reset"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>crypto_rng_reset —
re-initialize the RNG
</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">crypto_rng_reset </b>(</code></td><td>struct crypto_rng * <var class="pdparam">tfm</var>, </td></tr><tr><td> </td><td>u8 * <var class="pdparam">seed</var>, </td></tr><tr><td> </td><td>unsigned int <var class="pdparam">slen</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div></div></div><div class="refsect1"><a name="idp329019300"></a><h2>Arguments</h2><div class="variablelist"><dl class="variablelist"><dt><span class="term"><em class="parameter"><code>tfm</code></em></span></dt><dd><p>
cipher handle
</p></dd><dt><span class="term"><em class="parameter"><code>seed</code></em></span></dt><dd><p>
seed input data
</p></dd><dt><span class="term"><em class="parameter"><code>slen</code></em></span></dt><dd><p>
length of the seed input data
</p></dd></dl></div></div><div class="refsect1"><a name="idp329022940"></a><h2>Description</h2><p>
The reset function completely re-initializes the random number generator
referenced by the cipher handle by clearing the current state. The new state
is initialized with the caller provided seed or automatically, depending
on the random number generator type (the ANSI X9.31 RNG requires
caller-provided seed, the SP800-90A DRBGs perform an automatic seeding).
The seed is provided as a parameter to this function call. The provided seed
should have the length of the seed size defined for the random number
generator as defined by crypto_rng_seedsize.
</p></div><div class="refsect1"><a name="idp329024116"></a><h2>Return</h2><p>
0 if the setting of the key was successful; < 0 if an error occurred
</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-crypto-rng-get-bytes.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ch04s14.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-crypto-rng-seedsize.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span class="phrase">crypto_rng_get_bytes</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span class="phrase">crypto_rng_seedsize</span></td></tr></table></div></body></html>
