Debian Codegraph @

README

raw
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.