/usr/share/doc/libgcrypt11-doc/html/Retrieving-random-numbers.html

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- This manual is for Libgcrypt
(version 1.5.3, 17 December 2013),
which is GNU's library of cryptographic building blocks.

Copyright (C) 2000, 2002, 2003, 2004, 2006, 2007, 2008, 2009, 2011 Free Software Foundation, Inc.

Permission is granted to copy, distribute and/or modify this document
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. The text of the license can be found in the
section entitled "GNU General Public License". -->
<!-- Created by GNU Texinfo 5.2, http://www.gnu.org/software/texinfo/ -->
<head>
<title>The Libgcrypt Reference Manual: Retrieving random numbers</title>

<meta name="description" content="The Libgcrypt Reference Manual: Retrieving random numbers">
<meta name="keywords" content="The Libgcrypt Reference Manual: Retrieving random numbers">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link href="index.html#Top" rel="start" title="Top">
<link href="Concept-Index.html#Concept-Index" rel="index" title="Concept Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="Random-Numbers.html#Random-Numbers" rel="up" title="Random Numbers">
<link href="S_002dexpressions.html#S_002dexpressions" rel="next" title="S-expressions">
<link href="Quality-of-random-numbers.html#Quality-of-random-numbers" rel="prev" title="Quality of random numbers">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.indentedblock {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
div.smalllisp {margin-left: 3.2em}
kbd {font-style:oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
pre.smalldisplay {font-family: inherit; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: inherit; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.nocodebreak {white-space:nowrap}
span.nolinebreak {white-space:nowrap}
span.roman {font-family:serif; font-weight:normal}
span.sansserif {font-family:sans-serif; font-weight:normal}
ul.no-bullet {list-style: none}
-->
</style>


</head>

<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
<a name="Retrieving-random-numbers"></a>
<div class="header">
<p>
Previous: <a href="Quality-of-random-numbers.html#Quality-of-random-numbers" accesskey="p" rel="prev">Quality of random numbers</a>, Up: <a href="Random-Numbers.html#Random-Numbers" accesskey="u" rel="up">Random Numbers</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Concept-Index.html#Concept-Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="Retrieving-random-numbers-1"></a>
<h3 class="section">9.2 Retrieving random numbers</h3>

<dl>
<dt><a name="index-gcry_005frandomize"></a>Function: <em>void</em> <strong>gcry_randomize</strong> <em>(unsigned char *<var>buffer</var>, size_t <var>length</var>, enum gcry_random_level <var>level</var>)</em></dt>
<dd>
<p>Fill <var>buffer</var> with <var>length</var> random bytes using a random quality
as defined by <var>level</var>.
</p></dd></dl>

<dl>
<dt><a name="index-gcry_005frandom_005fbytes"></a>Function: <em>void *</em> <strong>gcry_random_bytes</strong> <em>(size_t <var>nbytes</var>, enum gcry_random_level <var>level</var>)</em></dt>
<dd>
<p>Convenience function to allocate a memory block consisting of
<var>nbytes</var> fresh random bytes using a random quality as defined by
<var>level</var>.
</p></dd></dl>

<dl>
<dt><a name="index-gcry_005frandom_005fbytes_005fsecure"></a>Function: <em>void *</em> <strong>gcry_random_bytes_secure</strong> <em>(size_t <var>nbytes</var>, enum gcry_random_level <var>level</var>)</em></dt>
<dd>
<p>Convenience function to allocate a memory block consisting of
<var>nbytes</var> fresh random bytes using a random quality as defined by
<var>level</var>.  This function differs from <code>gcry_random_bytes</code> in
that the returned buffer is allocated in a &ldquo;secure&rdquo; area of the
memory.
</p></dd></dl>

<dl>
<dt><a name="index-gcry_005fcreate_005fnonce"></a>Function: <em>void</em> <strong>gcry_create_nonce</strong> <em>(unsigned char *<var>buffer</var>, size_t <var>length</var>)</em></dt>
<dd>
<p>Fill <var>buffer</var> with <var>length</var> unpredictable bytes.  This is
commonly called a nonce and may also be used for initialization
vectors and padding.  This is an extra function nearly independent of
the other random function for 3 reasons: It better protects the
regular random generator&rsquo;s internal state, provides better performance
and does not drain the precious entropy pool.
</p>
</dd></dl>






</body>
</html>
libgcrypt11-doc 1.5.3-2ubuntu4 / usr / share / doc / libgcrypt11-doc / html / Retrieving-random-numbers.html
