~ubuntu-branches/debian/squeeze/polarssl/squeeze

« back to all changes in this revision

Viewing changes to doxygen/input/doc_rng.h

  • Committer: Package Import Robot
  • Author(s): Roland Stigge
  • Date: 2013-10-16 20:04:47 UTC
  • mfrom: (1.3.1) (3.1.13 sid)
  • Revision ID: package-import@ubuntu.com-20131016200447-x0hfc8ysrgkjyji2
Tags: 1.2.9-1~deb6u1
* New upstream release
  - Fixes CVE-2013-5914 CVE-2013-5915 (Closes: #725359)

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
/**
 
2
 * @file
 
3
 * Random number generator (RNG) module documentation file.
 
4
 */
 
5
 
 
6
/**
 
7
 * @addtogroup rng_module Random number generator (RNG) module
 
8
 * 
 
9
 * The Random number generator (RNG) module provides random number
 
10
 * generation, see \c ctr_dbrg_random() or \c havege_random().
 
11
 *
 
12
 * The former uses the block-cipher counter-mode based deterministic random
 
13
 * bit generator (CTR_DBRG) as specified in NIST SP800-90. It needs an external
 
14
 * source of entropy. For these purposes \c entropy_func() can be used. This is
 
15
 * an implementation based on a simple entropy accumulator design.
 
16
 *
 
17
 * The latter random number generator uses the HAVEGE (HArdware Volatile
 
18
 * Entropy Gathering and Expansion) software heuristic which is claimed 
 
19
 * to be an unpredictable or empirically strong* random number generation.
 
20
 *
 
21
 * \* Meaning that there seems to be no practical algorithm that can guess
 
22
 * the next bit with a probability larger than 1/2 in an output sequence.
 
23
 *
 
24
 * This module can be used to generate random numbers.
 
25
 */