Sophie

Sophie

distrib > Mageia > 6 > x86_64 > by-pkgid > 8304a303b9546a4919a1b507a88742d9 > files > 128

lib64apr-devel-1.5.2-2.1.mga6.x86_64.rpm

<!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.13"/>
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<title>Apache Portable Runtime: apr_random.h Source File</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">Apache Portable Runtime
   </div>
  </td>
 </tr>
 </tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.13 -->
<script type="text/javascript">
var searchBox = new SearchBox("searchBox", "search",false,'Search');
</script>
<script type="text/javascript" src="menudata.js"></script>
<script type="text/javascript" src="menu.js"></script>
<script type="text/javascript">
$(function() {
  initMenu('',true,false,'search.php','Search');
  $(document).ready(function() { init_search(); });
});
</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_d44c64559bbebec7f509842c48db8b23.html">include</a></li>  </ul>
</div>
</div><!-- top -->
<div class="header">
  <div class="headertitle">
<div class="title">apr_random.h</div>  </div>
</div><!--header-->
<div class="contents">
<a href="apr__random_8h.html">Go to the documentation of this file.</a><div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno">    1</span>&#160;<span class="comment">/* Licensed to the Apache Software Foundation (ASF) under one or more</span></div><div class="line"><a name="l00002"></a><span class="lineno">    2</span>&#160;<span class="comment"> * contributor license agreements.  See the NOTICE file distributed with</span></div><div class="line"><a name="l00003"></a><span class="lineno">    3</span>&#160;<span class="comment"> * this work for additional information regarding copyright ownership.</span></div><div class="line"><a name="l00004"></a><span class="lineno">    4</span>&#160;<span class="comment"> * The ASF licenses this file to You under the Apache License, Version 2.0</span></div><div class="line"><a name="l00005"></a><span class="lineno">    5</span>&#160;<span class="comment"> * (the &quot;License&quot;); you may not use this file except in compliance with</span></div><div class="line"><a name="l00006"></a><span class="lineno">    6</span>&#160;<span class="comment"> * the License.  You may obtain a copy of the License at</span></div><div class="line"><a name="l00007"></a><span class="lineno">    7</span>&#160;<span class="comment"> *</span></div><div class="line"><a name="l00008"></a><span class="lineno">    8</span>&#160;<span class="comment"> *     http://www.apache.org/licenses/LICENSE-2.0</span></div><div class="line"><a name="l00009"></a><span class="lineno">    9</span>&#160;<span class="comment"> *</span></div><div class="line"><a name="l00010"></a><span class="lineno">   10</span>&#160;<span class="comment"> * Unless required by applicable law or agreed to in writing, software</span></div><div class="line"><a name="l00011"></a><span class="lineno">   11</span>&#160;<span class="comment"> * distributed under the License is distributed on an &quot;AS IS&quot; BASIS,</span></div><div class="line"><a name="l00012"></a><span class="lineno">   12</span>&#160;<span class="comment"> * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.</span></div><div class="line"><a name="l00013"></a><span class="lineno">   13</span>&#160;<span class="comment"> * See the License for the specific language governing permissions and</span></div><div class="line"><a name="l00014"></a><span class="lineno">   14</span>&#160;<span class="comment"> * limitations under the License.</span></div><div class="line"><a name="l00015"></a><span class="lineno">   15</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l00016"></a><span class="lineno">   16</span>&#160;</div><div class="line"><a name="l00017"></a><span class="lineno">   17</span>&#160;<span class="preprocessor">#ifndef APR_RANDOM_H</span></div><div class="line"><a name="l00018"></a><span class="lineno">   18</span>&#160;<span class="preprocessor">#define APR_RANDOM_H</span></div><div class="line"><a name="l00019"></a><span class="lineno">   19</span>&#160;<span class="comment"></span></div><div class="line"><a name="l00020"></a><span class="lineno">   20</span>&#160;<span class="comment">/**</span></div><div class="line"><a name="l00021"></a><span class="lineno">   21</span>&#160;<span class="comment"> * @file apr_random.h</span></div><div class="line"><a name="l00022"></a><span class="lineno">   22</span>&#160;<span class="comment"> * @brief APR PRNG routines</span></div><div class="line"><a name="l00023"></a><span class="lineno">   23</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l00024"></a><span class="lineno">   24</span>&#160;</div><div class="line"><a name="l00025"></a><span class="lineno">   25</span>&#160;<span class="preprocessor">#include &quot;<a class="code" href="apr__pools_8h.html">apr_pools.h</a>&quot;</span></div><div class="line"><a name="l00026"></a><span class="lineno">   26</span>&#160;<span class="preprocessor">#include &quot;<a class="code" href="apr__thread__proc_8h.html">apr_thread_proc.h</a>&quot;</span></div><div class="line"><a name="l00027"></a><span class="lineno">   27</span>&#160;</div><div class="line"><a name="l00028"></a><span class="lineno">   28</span>&#160;<span class="preprocessor">#ifdef __cplusplus</span></div><div class="line"><a name="l00029"></a><span class="lineno">   29</span>&#160;<span class="keyword">extern</span> <span class="stringliteral">&quot;C&quot;</span> {</div><div class="line"><a name="l00030"></a><span class="lineno">   30</span>&#160;<span class="preprocessor">#endif </span><span class="comment">/* __cplusplus */</span><span class="preprocessor"></span></div><div class="line"><a name="l00031"></a><span class="lineno">   31</span>&#160;<span class="comment"></span></div><div class="line"><a name="l00032"></a><span class="lineno">   32</span>&#160;<span class="comment">/**</span></div><div class="line"><a name="l00033"></a><span class="lineno">   33</span>&#160;<span class="comment"> * @defgroup apr_random PRNG Routines</span></div><div class="line"><a name="l00034"></a><span class="lineno">   34</span>&#160;<span class="comment"> * @ingroup APR</span></div><div class="line"><a name="l00035"></a><span class="lineno">   35</span>&#160;<span class="comment"> * @{</span></div><div class="line"><a name="l00036"></a><span class="lineno">   36</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l00037"></a><span class="lineno">   37</span>&#160;</div><div class="line"><a name="l00038"></a><span class="lineno">   38</span>&#160;<span class="keyword">typedef</span> <span class="keyword">struct </span><a class="code" href="structapr__crypto__hash__t.html">apr_crypto_hash_t</a> <a class="code" href="structapr__crypto__hash__t.html">apr_crypto_hash_t</a>;</div><div class="line"><a name="l00039"></a><span class="lineno">   39</span>&#160;</div><div class="line"><a name="l00040"></a><span class="lineno">   40</span>&#160;<span class="keyword">typedef</span> <span class="keywordtype">void</span> apr_crypto_hash_init_t(<a class="code" href="structapr__crypto__hash__t.html">apr_crypto_hash_t</a> *hash);</div><div class="line"><a name="l00041"></a><span class="lineno">   41</span>&#160;<span class="keyword">typedef</span> <span class="keywordtype">void</span> apr_crypto_hash_add_t(<a class="code" href="structapr__crypto__hash__t.html">apr_crypto_hash_t</a> *hash, <span class="keyword">const</span> <span class="keywordtype">void</span> *data,</div><div class="line"><a name="l00042"></a><span class="lineno">   42</span>&#160;                                   apr_size_t bytes);</div><div class="line"><a name="l00043"></a><span class="lineno">   43</span>&#160;<span class="keyword">typedef</span> <span class="keywordtype">void</span> apr_crypto_hash_finish_t(<a class="code" href="structapr__crypto__hash__t.html">apr_crypto_hash_t</a> *hash,</div><div class="line"><a name="l00044"></a><span class="lineno">   44</span>&#160;                                      <span class="keywordtype">unsigned</span> <span class="keywordtype">char</span> *result);</div><div class="line"><a name="l00045"></a><span class="lineno">   45</span>&#160;</div><div class="line"><a name="l00046"></a><span class="lineno">   46</span>&#160;</div><div class="line"><a name="l00047"></a><span class="lineno">   47</span>&#160;<span class="comment">/* FIXME: make this opaque */</span></div><div class="line"><a name="l00048"></a><span class="lineno"><a class="line" href="structapr__crypto__hash__t.html">   48</a></span>&#160;<span class="keyword">struct </span><a class="code" href="structapr__crypto__hash__t.html">apr_crypto_hash_t</a> {</div><div class="line"><a name="l00049"></a><span class="lineno">   49</span>&#160;    apr_crypto_hash_init_t *init;</div><div class="line"><a name="l00050"></a><span class="lineno">   50</span>&#160;    apr_crypto_hash_add_t *add;</div><div class="line"><a name="l00051"></a><span class="lineno">   51</span>&#160;    apr_crypto_hash_finish_t *finish;</div><div class="line"><a name="l00052"></a><span class="lineno">   52</span>&#160;    apr_size_t size;</div><div class="line"><a name="l00053"></a><span class="lineno">   53</span>&#160;    <span class="keywordtype">void</span> *data;</div><div class="line"><a name="l00054"></a><span class="lineno">   54</span>&#160;};</div><div class="line"><a name="l00055"></a><span class="lineno">   55</span>&#160;<span class="comment"></span></div><div class="line"><a name="l00056"></a><span class="lineno">   56</span>&#160;<span class="comment">/**</span></div><div class="line"><a name="l00057"></a><span class="lineno">   57</span>&#160;<span class="comment"> * Allocate and initialize the SHA-256 context</span></div><div class="line"><a name="l00058"></a><span class="lineno">   58</span>&#160;<span class="comment"> * @param p The pool to allocate from</span></div><div class="line"><a name="l00059"></a><span class="lineno">   59</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l00060"></a><span class="lineno">   60</span>&#160;<a class="code" href="group__apr__platform.html#gad7b91b811a172bfa802603c2fb688f98">APR_DECLARE</a>(<a class="code" href="structapr__crypto__hash__t.html">apr_crypto_hash_t</a> *) <a class="code" href="group__apr__random.html#gae992c6f642e9661d2417cd8f2df8d345">apr_crypto_sha256_new</a>(<a class="code" href="group__apr__pools.html#gaf137f28edcf9a086cd6bc36c20d7cdfb">apr_pool_t</a> *p);</div><div class="line"><a name="l00061"></a><span class="lineno">   61</span>&#160;<span class="comment"></span></div><div class="line"><a name="l00062"></a><span class="lineno">   62</span>&#160;<span class="comment">/** Opaque PRNG structure. */</span></div><div class="line"><a name="l00063"></a><span class="lineno"><a class="line" href="group__apr__random.html#ga33073741e56b1bafe52ba58cefcbbf96">   63</a></span>&#160;<span class="keyword">typedef</span> <span class="keyword">struct </span><a class="code" href="group__apr__random.html#ga33073741e56b1bafe52ba58cefcbbf96">apr_random_t</a> <a class="code" href="group__apr__random.html#ga33073741e56b1bafe52ba58cefcbbf96">apr_random_t</a>;</div><div class="line"><a name="l00064"></a><span class="lineno">   64</span>&#160;<span class="comment"></span></div><div class="line"><a name="l00065"></a><span class="lineno">   65</span>&#160;<span class="comment">/**</span></div><div class="line"><a name="l00066"></a><span class="lineno">   66</span>&#160;<span class="comment"> * Initialize a PRNG state</span></div><div class="line"><a name="l00067"></a><span class="lineno">   67</span>&#160;<span class="comment"> * @param g The PRNG state</span></div><div class="line"><a name="l00068"></a><span class="lineno">   68</span>&#160;<span class="comment"> * @param p The pool to allocate from</span></div><div class="line"><a name="l00069"></a><span class="lineno">   69</span>&#160;<span class="comment"> * @param pool_hash Pool hash functions</span></div><div class="line"><a name="l00070"></a><span class="lineno">   70</span>&#160;<span class="comment"> * @param key_hash Key hash functions</span></div><div class="line"><a name="l00071"></a><span class="lineno">   71</span>&#160;<span class="comment"> * @param prng_hash PRNG hash functions</span></div><div class="line"><a name="l00072"></a><span class="lineno">   72</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l00073"></a><span class="lineno">   73</span>&#160;<a class="code" href="group__apr__platform.html#gad7b91b811a172bfa802603c2fb688f98">APR_DECLARE</a>(<span class="keywordtype">void</span>) <a class="code" href="group__apr__random.html#ga0184a90774212132f883c463811aacdc">apr_random_init</a>(<a class="code" href="group__apr__random.html#ga33073741e56b1bafe52ba58cefcbbf96">apr_random_t</a> *g, <a class="code" href="group__apr__pools.html#gaf137f28edcf9a086cd6bc36c20d7cdfb">apr_pool_t</a> *p,</div><div class="line"><a name="l00074"></a><span class="lineno">   74</span>&#160;                                  <a class="code" href="structapr__crypto__hash__t.html">apr_crypto_hash_t</a> *pool_hash,</div><div class="line"><a name="l00075"></a><span class="lineno">   75</span>&#160;                                  <a class="code" href="structapr__crypto__hash__t.html">apr_crypto_hash_t</a> *key_hash,</div><div class="line"><a name="l00076"></a><span class="lineno">   76</span>&#160;                                  <a class="code" href="structapr__crypto__hash__t.html">apr_crypto_hash_t</a> *prng_hash);<span class="comment"></span></div><div class="line"><a name="l00077"></a><span class="lineno">   77</span>&#160;<span class="comment">/**</span></div><div class="line"><a name="l00078"></a><span class="lineno">   78</span>&#160;<span class="comment"> * Allocate and initialize (apr_crypto_sha256_new) a new PRNG state.</span></div><div class="line"><a name="l00079"></a><span class="lineno">   79</span>&#160;<span class="comment"> * @param p The pool to allocate from</span></div><div class="line"><a name="l00080"></a><span class="lineno">   80</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l00081"></a><span class="lineno">   81</span>&#160;<a class="code" href="group__apr__platform.html#gad7b91b811a172bfa802603c2fb688f98">APR_DECLARE</a>(<a class="code" href="group__apr__random.html#ga33073741e56b1bafe52ba58cefcbbf96">apr_random_t</a> *) <a class="code" href="group__apr__random.html#ga7a73c9bcf026b63847aeae483c53191f">apr_random_standard_new</a>(<a class="code" href="group__apr__pools.html#gaf137f28edcf9a086cd6bc36c20d7cdfb">apr_pool_t</a> *p);</div><div class="line"><a name="l00082"></a><span class="lineno">   82</span>&#160;<span class="comment"></span></div><div class="line"><a name="l00083"></a><span class="lineno">   83</span>&#160;<span class="comment">/**</span></div><div class="line"><a name="l00084"></a><span class="lineno">   84</span>&#160;<span class="comment"> * Mix the randomness pools.</span></div><div class="line"><a name="l00085"></a><span class="lineno">   85</span>&#160;<span class="comment"> * @param g The PRNG state</span></div><div class="line"><a name="l00086"></a><span class="lineno">   86</span>&#160;<span class="comment"> * @param entropy_ Entropy buffer</span></div><div class="line"><a name="l00087"></a><span class="lineno">   87</span>&#160;<span class="comment"> * @param bytes Length of entropy_ in bytes</span></div><div class="line"><a name="l00088"></a><span class="lineno">   88</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l00089"></a><span class="lineno">   89</span>&#160;<a class="code" href="group__apr__platform.html#gad7b91b811a172bfa802603c2fb688f98">APR_DECLARE</a>(<span class="keywordtype">void</span>) <a class="code" href="group__apr__random.html#ga8cf2875644c1dffc0c336289bd370efb">apr_random_add_entropy</a>(<a class="code" href="group__apr__random.html#ga33073741e56b1bafe52ba58cefcbbf96">apr_random_t</a> *g,</div><div class="line"><a name="l00090"></a><span class="lineno">   90</span>&#160;                                         <span class="keyword">const</span> <span class="keywordtype">void</span> *entropy_,</div><div class="line"><a name="l00091"></a><span class="lineno">   91</span>&#160;                                         apr_size_t bytes);<span class="comment"></span></div><div class="line"><a name="l00092"></a><span class="lineno">   92</span>&#160;<span class="comment">/**</span></div><div class="line"><a name="l00093"></a><span class="lineno">   93</span>&#160;<span class="comment"> * Generate cryptographically insecure random bytes.</span></div><div class="line"><a name="l00094"></a><span class="lineno">   94</span>&#160;<span class="comment"> * @param g The RNG state</span></div><div class="line"><a name="l00095"></a><span class="lineno">   95</span>&#160;<span class="comment"> * @param random Buffer to fill with random bytes</span></div><div class="line"><a name="l00096"></a><span class="lineno">   96</span>&#160;<span class="comment"> * @param bytes Length of buffer in bytes</span></div><div class="line"><a name="l00097"></a><span class="lineno">   97</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l00098"></a><span class="lineno">   98</span>&#160;<a class="code" href="group__apr__platform.html#gad7b91b811a172bfa802603c2fb688f98">APR_DECLARE</a>(<a class="code" href="group__apr__errno.html#gaf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>) <a class="code" href="group__apr__random.html#gab9a63359bb9543d746e6fd46933b7256">apr_random_insecure_bytes</a>(<a class="code" href="group__apr__random.html#ga33073741e56b1bafe52ba58cefcbbf96">apr_random_t</a> *g,</div><div class="line"><a name="l00099"></a><span class="lineno">   99</span>&#160;                                                    <span class="keywordtype">void</span> *random,</div><div class="line"><a name="l00100"></a><span class="lineno">  100</span>&#160;                                                    apr_size_t bytes);</div><div class="line"><a name="l00101"></a><span class="lineno">  101</span>&#160;<span class="comment"></span></div><div class="line"><a name="l00102"></a><span class="lineno">  102</span>&#160;<span class="comment">/**</span></div><div class="line"><a name="l00103"></a><span class="lineno">  103</span>&#160;<span class="comment"> * Generate cryptographically secure random bytes.</span></div><div class="line"><a name="l00104"></a><span class="lineno">  104</span>&#160;<span class="comment"> * @param g The RNG state</span></div><div class="line"><a name="l00105"></a><span class="lineno">  105</span>&#160;<span class="comment"> * @param random Buffer to fill with random bytes</span></div><div class="line"><a name="l00106"></a><span class="lineno">  106</span>&#160;<span class="comment"> * @param bytes Length of buffer in bytes</span></div><div class="line"><a name="l00107"></a><span class="lineno">  107</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l00108"></a><span class="lineno">  108</span>&#160;<a class="code" href="group__apr__platform.html#gad7b91b811a172bfa802603c2fb688f98">APR_DECLARE</a>(<a class="code" href="group__apr__errno.html#gaf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>) <a class="code" href="group__apr__random.html#ga9f0607e06656a1c76cc5ee878fd94f09">apr_random_secure_bytes</a>(<a class="code" href="group__apr__random.html#ga33073741e56b1bafe52ba58cefcbbf96">apr_random_t</a> *g,</div><div class="line"><a name="l00109"></a><span class="lineno">  109</span>&#160;                                                  <span class="keywordtype">void</span> *random,</div><div class="line"><a name="l00110"></a><span class="lineno">  110</span>&#160;                                                  apr_size_t bytes);<span class="comment"></span></div><div class="line"><a name="l00111"></a><span class="lineno">  111</span>&#160;<span class="comment">/**</span></div><div class="line"><a name="l00112"></a><span class="lineno">  112</span>&#160;<span class="comment"> * Ensures that E bits of conditional entropy are mixed into the PRNG</span></div><div class="line"><a name="l00113"></a><span class="lineno">  113</span>&#160;<span class="comment"> * before any further randomness is extracted.</span></div><div class="line"><a name="l00114"></a><span class="lineno">  114</span>&#160;<span class="comment"> * @param g The RNG state</span></div><div class="line"><a name="l00115"></a><span class="lineno">  115</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l00116"></a><span class="lineno">  116</span>&#160;<a class="code" href="group__apr__platform.html#gad7b91b811a172bfa802603c2fb688f98">APR_DECLARE</a>(<span class="keywordtype">void</span>) <a class="code" href="group__apr__random.html#ga37d8d7529cf972c605ebce97c57f8825">apr_random_barrier</a>(<a class="code" href="group__apr__random.html#ga33073741e56b1bafe52ba58cefcbbf96">apr_random_t</a> *g);</div><div class="line"><a name="l00117"></a><span class="lineno">  117</span>&#160;<span class="comment"></span></div><div class="line"><a name="l00118"></a><span class="lineno">  118</span>&#160;<span class="comment">/**</span></div><div class="line"><a name="l00119"></a><span class="lineno">  119</span>&#160;<span class="comment"> * Return APR_SUCCESS if the cryptographic PRNG has been seeded with</span></div><div class="line"><a name="l00120"></a><span class="lineno">  120</span>&#160;<span class="comment"> * enough data, APR_ENOTENOUGHENTROPY otherwise.</span></div><div class="line"><a name="l00121"></a><span class="lineno">  121</span>&#160;<span class="comment"> * @param r The RNG state</span></div><div class="line"><a name="l00122"></a><span class="lineno">  122</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l00123"></a><span class="lineno">  123</span>&#160;<a class="code" href="group__apr__platform.html#gad7b91b811a172bfa802603c2fb688f98">APR_DECLARE</a>(<a class="code" href="group__apr__errno.html#gaf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>) <a class="code" href="group__apr__random.html#ga99d0c0722eeef2951e8ccede2e1451fa">apr_random_secure_ready</a>(<a class="code" href="group__apr__random.html#ga33073741e56b1bafe52ba58cefcbbf96">apr_random_t</a> *r);</div><div class="line"><a name="l00124"></a><span class="lineno">  124</span>&#160;<span class="comment"></span></div><div class="line"><a name="l00125"></a><span class="lineno">  125</span>&#160;<span class="comment">/**</span></div><div class="line"><a name="l00126"></a><span class="lineno">  126</span>&#160;<span class="comment"> * Return APR_SUCCESS if the PRNG has been seeded with enough data,</span></div><div class="line"><a name="l00127"></a><span class="lineno">  127</span>&#160;<span class="comment"> * APR_ENOTENOUGHENTROPY otherwise.</span></div><div class="line"><a name="l00128"></a><span class="lineno">  128</span>&#160;<span class="comment"> * @param r The PRNG state</span></div><div class="line"><a name="l00129"></a><span class="lineno">  129</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l00130"></a><span class="lineno">  130</span>&#160;<a class="code" href="group__apr__platform.html#gad7b91b811a172bfa802603c2fb688f98">APR_DECLARE</a>(<a class="code" href="group__apr__errno.html#gaf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>) <a class="code" href="group__apr__random.html#ga6465698bdc752d07abc8c515aac6e2c0">apr_random_insecure_ready</a>(<a class="code" href="group__apr__random.html#ga33073741e56b1bafe52ba58cefcbbf96">apr_random_t</a> *r);</div><div class="line"><a name="l00131"></a><span class="lineno">  131</span>&#160;<span class="comment"></span></div><div class="line"><a name="l00132"></a><span class="lineno">  132</span>&#160;<span class="comment">/**</span></div><div class="line"><a name="l00133"></a><span class="lineno">  133</span>&#160;<span class="comment"> * Mix the randomness pools after forking.</span></div><div class="line"><a name="l00134"></a><span class="lineno">  134</span>&#160;<span class="comment"> * @param proc The resulting process handle from apr_proc_fork()</span></div><div class="line"><a name="l00135"></a><span class="lineno">  135</span>&#160;<span class="comment"> * @remark Call this in the child after forking to mix the randomness</span></div><div class="line"><a name="l00136"></a><span class="lineno">  136</span>&#160;<span class="comment"> * pools. Note that its generally a bad idea to fork a process with a</span></div><div class="line"><a name="l00137"></a><span class="lineno">  137</span>&#160;<span class="comment"> * real PRNG in it - better to have the PRNG externally and get the</span></div><div class="line"><a name="l00138"></a><span class="lineno">  138</span>&#160;<span class="comment"> * randomness from there. However, if you really must do it, then you</span></div><div class="line"><a name="l00139"></a><span class="lineno">  139</span>&#160;<span class="comment"> * should supply all your entropy to all the PRNGs - don&#39;t worry, they</span></div><div class="line"><a name="l00140"></a><span class="lineno">  140</span>&#160;<span class="comment"> * won&#39;t produce the same output.</span></div><div class="line"><a name="l00141"></a><span class="lineno">  141</span>&#160;<span class="comment"> * @remark Note that apr_proc_fork() calls this for you, so only weird</span></div><div class="line"><a name="l00142"></a><span class="lineno">  142</span>&#160;<span class="comment"> * applications need ever call it themselves.</span></div><div class="line"><a name="l00143"></a><span class="lineno">  143</span>&#160;<span class="comment"> * @internal</span></div><div class="line"><a name="l00144"></a><span class="lineno">  144</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l00145"></a><span class="lineno">  145</span>&#160;<a class="code" href="group__apr__platform.html#gad7b91b811a172bfa802603c2fb688f98">APR_DECLARE</a>(<span class="keywordtype">void</span>) <a class="code" href="group__apr__random.html#gaa1ab9b8adeeb6e37bb29def249ff9e6a">apr_random_after_fork</a>(<a class="code" href="structapr__proc__t.html">apr_proc_t</a> *proc);</div><div class="line"><a name="l00146"></a><span class="lineno">  146</span>&#160;<span class="comment"></span></div><div class="line"><a name="l00147"></a><span class="lineno">  147</span>&#160;<span class="comment">/** @} */</span></div><div class="line"><a name="l00148"></a><span class="lineno">  148</span>&#160;</div><div class="line"><a name="l00149"></a><span class="lineno">  149</span>&#160;<span class="preprocessor">#ifdef __cplusplus</span></div><div class="line"><a name="l00150"></a><span class="lineno">  150</span>&#160;}</div><div class="line"><a name="l00151"></a><span class="lineno">  151</span>&#160;<span class="preprocessor">#endif</span></div><div class="line"><a name="l00152"></a><span class="lineno">  152</span>&#160;</div><div class="line"><a name="l00153"></a><span class="lineno">  153</span>&#160;<span class="preprocessor">#endif </span><span class="comment">/* !APR_RANDOM_H */</span><span class="preprocessor"></span></div><div class="ttc" id="group__apr__random_html_gaa1ab9b8adeeb6e37bb29def249ff9e6a"><div class="ttname"><a href="group__apr__random.html#gaa1ab9b8adeeb6e37bb29def249ff9e6a">apr_random_after_fork</a></div><div class="ttdeci">void apr_random_after_fork(apr_proc_t *proc)</div></div>
<div class="ttc" id="group__apr__random_html_ga33073741e56b1bafe52ba58cefcbbf96"><div class="ttname"><a href="group__apr__random.html#ga33073741e56b1bafe52ba58cefcbbf96">apr_random_t</a></div><div class="ttdeci">struct apr_random_t apr_random_t</div><div class="ttdef"><b>Definition:</b> apr_random.h:63</div></div>
<div class="ttc" id="structapr__proc__t_html"><div class="ttname"><a href="structapr__proc__t.html">apr_proc_t</a></div><div class="ttdef"><b>Definition:</b> apr_thread_proc.h:143</div></div>
<div class="ttc" id="group__apr__platform_html_gad7b91b811a172bfa802603c2fb688f98"><div class="ttname"><a href="group__apr__platform.html#gad7b91b811a172bfa802603c2fb688f98">APR_DECLARE</a></div><div class="ttdeci">#define APR_DECLARE(type)</div><div class="ttdef"><b>Definition:</b> apr.h:479</div></div>
<div class="ttc" id="apr__pools_8h_html"><div class="ttname"><a href="apr__pools_8h.html">apr_pools.h</a></div><div class="ttdoc">APR memory allocation. </div></div>
<div class="ttc" id="group__apr__random_html_ga6465698bdc752d07abc8c515aac6e2c0"><div class="ttname"><a href="group__apr__random.html#ga6465698bdc752d07abc8c515aac6e2c0">apr_random_insecure_ready</a></div><div class="ttdeci">apr_status_t apr_random_insecure_ready(apr_random_t *r)</div></div>
<div class="ttc" id="group__apr__random_html_ga99d0c0722eeef2951e8ccede2e1451fa"><div class="ttname"><a href="group__apr__random.html#ga99d0c0722eeef2951e8ccede2e1451fa">apr_random_secure_ready</a></div><div class="ttdeci">apr_status_t apr_random_secure_ready(apr_random_t *r)</div></div>
<div class="ttc" id="group__apr__random_html_ga37d8d7529cf972c605ebce97c57f8825"><div class="ttname"><a href="group__apr__random.html#ga37d8d7529cf972c605ebce97c57f8825">apr_random_barrier</a></div><div class="ttdeci">void apr_random_barrier(apr_random_t *g)</div></div>
<div class="ttc" id="group__apr__random_html_ga0184a90774212132f883c463811aacdc"><div class="ttname"><a href="group__apr__random.html#ga0184a90774212132f883c463811aacdc">apr_random_init</a></div><div class="ttdeci">void apr_random_init(apr_random_t *g, apr_pool_t *p, apr_crypto_hash_t *pool_hash, apr_crypto_hash_t *key_hash, apr_crypto_hash_t *prng_hash)</div></div>
<div class="ttc" id="group__apr__random_html_ga8cf2875644c1dffc0c336289bd370efb"><div class="ttname"><a href="group__apr__random.html#ga8cf2875644c1dffc0c336289bd370efb">apr_random_add_entropy</a></div><div class="ttdeci">void apr_random_add_entropy(apr_random_t *g, const void *entropy_, apr_size_t bytes)</div></div>
<div class="ttc" id="apr__thread__proc_8h_html"><div class="ttname"><a href="apr__thread__proc_8h.html">apr_thread_proc.h</a></div><div class="ttdoc">APR Thread and Process Library. </div></div>
<div class="ttc" id="group__apr__random_html_gae992c6f642e9661d2417cd8f2df8d345"><div class="ttname"><a href="group__apr__random.html#gae992c6f642e9661d2417cd8f2df8d345">apr_crypto_sha256_new</a></div><div class="ttdeci">apr_crypto_hash_t * apr_crypto_sha256_new(apr_pool_t *p)</div></div>
<div class="ttc" id="group__apr__random_html_gab9a63359bb9543d746e6fd46933b7256"><div class="ttname"><a href="group__apr__random.html#gab9a63359bb9543d746e6fd46933b7256">apr_random_insecure_bytes</a></div><div class="ttdeci">apr_status_t apr_random_insecure_bytes(apr_random_t *g, void *random, apr_size_t bytes)</div></div>
<div class="ttc" id="group__apr__pools_html_gaf137f28edcf9a086cd6bc36c20d7cdfb"><div class="ttname"><a href="group__apr__pools.html#gaf137f28edcf9a086cd6bc36c20d7cdfb">apr_pool_t</a></div><div class="ttdeci">struct apr_pool_t apr_pool_t</div><div class="ttdef"><b>Definition:</b> apr_pools.h:60</div></div>
<div class="ttc" id="group__apr__errno_html_gaf76ee4543247e9fb3f3546203e590a6c"><div class="ttname"><a href="group__apr__errno.html#gaf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a></div><div class="ttdeci">int apr_status_t</div><div class="ttdef"><b>Definition:</b> apr_errno.h:44</div></div>
<div class="ttc" id="group__apr__random_html_ga9f0607e06656a1c76cc5ee878fd94f09"><div class="ttname"><a href="group__apr__random.html#ga9f0607e06656a1c76cc5ee878fd94f09">apr_random_secure_bytes</a></div><div class="ttdeci">apr_status_t apr_random_secure_bytes(apr_random_t *g, void *random, apr_size_t bytes)</div></div>
<div class="ttc" id="structapr__crypto__hash__t_html"><div class="ttname"><a href="structapr__crypto__hash__t.html">apr_crypto_hash_t</a></div><div class="ttdef"><b>Definition:</b> apr_random.h:48</div></div>
<div class="ttc" id="group__apr__random_html_ga7a73c9bcf026b63847aeae483c53191f"><div class="ttname"><a href="group__apr__random.html#ga7a73c9bcf026b63847aeae483c53191f">apr_random_standard_new</a></div><div class="ttdeci">apr_random_t * apr_random_standard_new(apr_pool_t *p)</div></div>
</div><!-- fragment --></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.13
</small></address>
</body>
</html>