| 1 |
NAME |
| 2 |
|
| 3 |
Data::Entropy - entropy (randomness) management |
| 4 |
|
| 5 |
STATUS |
| 6 |
|
| 7 |
This module is deprecated. |
| 8 |
|
| 9 |
For most purposes (including cryptography and security), modules like |
| 10 |
Crypt::URandom, Crypt::SysRandom or Crypt::PRNG are more than |
| 11 |
adequate. |
| 12 |
|
| 13 |
Modern operating systems provide good sources of random bytes, and the |
| 14 |
above mentioned modules work on many kinds of systems, including |
| 15 |
Windows. |
| 16 |
|
| 17 |
There is no need to choose an entropy source, and some users of this |
| 18 |
module have omitted that step, and prior to version 0.008 they may |
| 19 |
have been relying on Perl's builtin "rand" function. |
| 20 |
|
| 21 |
Please see CPAN Author's Guide to Random Data for Security |
| 22 |
<https://security.metacpan.org/docs/guides/random-data-for-security.html>. |
| 23 |
|
| 24 |
DESCRIPTION |
| 25 |
|
| 26 |
This distribution includes modules relating to sources and use of entropy. |
| 27 |
They all interoperate, but can also be used independently. |
| 28 |
|
| 29 |
The Data::Entropy module maintains a concept of a current selection |
| 30 |
of entropy source. Algorithms that require entropy, such as those in |
| 31 |
Data::Entropy::Algorithms, can use the source nominated by this module, |
| 32 |
avoiding the need for entropy source objects to be explicitly passed |
| 33 |
around. This is convenient because usually one entropy source will |
| 34 |
be used for an entire program run and so an explicit entropy source |
| 35 |
parameter would rarely vary. There is also a default entropy source, |
| 36 |
avoiding the need to explicitly configure a source at all. |
| 37 |
|
| 38 |
The Data::Entropy::Source class manages the entropy coming from a |
| 39 |
particular source. Methods allow entropy to be dispensed in any quantity |
| 40 |
required, even fractional bits. This class acts as a layer over a raw |
| 41 |
entropy source, which may be a normal I/O handle or a special-purpose |
| 42 |
class. |
| 43 |
|
| 44 |
The Data::Entropy::RawSource::* classes provide fundamental sources |
| 45 |
of entropy. The sources specially supported are an OS-supplied entropy |
| 46 |
collector, downloads from servers on the Internet, and cryptographic |
| 47 |
fake entropy. |
| 48 |
|
| 49 |
The Data::Entropy::Algorithms module contains a collection of fundamental |
| 50 |
algorithms that use entropy. There are random number generators, and |
| 51 |
functions to shuffle arrays and perform related tasks. |
| 52 |
|
| 53 |
INSTALLATION |
| 54 |
|
| 55 |
perl Module.PL |
| 56 |
make |
| 57 |
make test |
| 58 |
make install |
| 59 |
|
| 60 |
AUTHOR |
| 61 |
|
| 62 |
Andrew Main (Zefram) <[email protected]> |
| 63 |
|
| 64 |
Maintained by Robert Rothenberg <[email protected]> |
| 65 |
|
| 66 |
COPYRIGHT |
| 67 |
|
| 68 |
Copyright (C) 2006, 2007, 2009, 2011, 2025 |
| 69 |
Andrew Main (Zefram) <[email protected]> |
| 70 |
|
| 71 |
LICENSE |
| 72 |
|
| 73 |
This module is free software; you can redistribute it and/or modify it |
| 74 |
under the same terms as Perl itself. |