freebsd-nq/share/examples
Mark Murray 10cb24248a This is the much-discussed major upgrade to the random(4) device, known to you all as /dev/random.
This code has had an extensive rewrite and a good series of reviews, both by the author and other parties. This means a lot of code has been simplified. Pluggable structures for high-rate entropy generators are available, and it is most definitely not the case that /dev/random can be driven by only a hardware souce any more. This has been designed out of the device. Hardware sources are stirred into the CSPRNG (Yarrow, Fortuna) like any other entropy source. Pluggable modules may be written by third parties for additional sources.

The harvesting structures and consequently the locking have been simplified. Entropy harvesting is done in a more general way (the documentation for this will follow). There is some GREAT entropy to be had in the UMA allocator, but it is disabled for now as messing with that is likely to annoy many people.

The venerable (but effective) Yarrow algorithm, which is no longer supported by its authors now has an alternative, Fortuna. For now, Yarrow is retained as the default algorithm, but this may be changed using a kernel option. It is intended to make Fortuna the default algorithm for 11.0. Interested parties are encouraged to read ISBN 978-0-470-47424-2 "Cryptography Engineering" By Ferguson, Schneier and Kohno for Fortuna's gory details. Heck, read it anyway.

Many thanks to Arthur Mesh who did early grunt work, and who got caught in the crossfire rather more than he deserved to.

My thanks also to folks who helped me thresh this out on whiteboards and in the odd "Hallway track", or otherwise.

My Nomex pants are on. Let the feedback commence!

Reviewed by:	trasz,des(partial),imp(partial?),rwatson(partial?)
Approved by:	so(des)
2014-10-30 21:21:53 +00:00
..
bhyve Use '-e' to check if the virtio backing file has already been created. 2014-10-14 18:34:15 +00:00
bootforth
BSD_daemon Add an alternate version of beastie to the examples directory. 2013-04-28 02:23:39 +00:00
csh Add a bunch more example completions. 2012-10-16 02:52:30 +00:00
diskless Correct double "the the" 2012-09-14 21:28:56 +00:00
dma Add the makefile forgotten in previous commit 2014-03-10 15:59:50 +00:00
drivers Update to use DEVMETHOD_END. 2011-11-22 21:49:29 +00:00
etc Remove ia64. 2014-07-07 00:27:09 +00:00
find_interface NO_MAN= has been deprecated in favor of MAN= for some time, go ahead 2014-04-13 05:21:56 +00:00
FreeBSD_version NO_MAN= has been deprecated in favor of MAN= for some time, go ahead 2014-04-13 05:21:56 +00:00
hast
hwpmc Various style(9) and related fixes. 2014-07-31 18:02:38 +00:00
ibcs2
indent indent.pro example: put all options one per line 2010-04-05 09:26:03 +00:00
ipfilter
ipfw
IPv6
jails Add two scripts that demonstrate how to make and 2010-10-24 22:59:38 +00:00
kld This is the much-discussed major upgrade to the random(4) device, known to you all as /dev/random. 2014-10-30 21:21:53 +00:00
libusb20 - Use libusb20_strerror() function instead of custom usb_error() one. 2013-11-07 07:22:51 +00:00
libvgl NO_MAN= has been deprecated in favor of MAN= for some time, go ahead 2014-04-13 05:21:56 +00:00
mdoc use .Mt to mark up email addresses consistently (part1) 2014-06-20 09:40:43 +00:00
netgraph Fix more typos to be a good example. 2011-05-22 14:23:48 +00:00
perfmon NO_MAN= has been deprecated in favor of MAN= for some time, go ahead 2014-04-13 05:21:56 +00:00
pf Add the 'inet' keyword after the nat rule to avoid interfering with 2012-06-28 03:30:17 +00:00
ppi NO_MAN= has been deprecated in favor of MAN= for some time, go ahead 2014-04-13 05:21:56 +00:00
ppp A number of places in the source tree still reference cuad.* after 2012-12-08 22:16:36 +00:00
printing X11BASE has been deprecated for a long time and will die soon 2012-01-09 00:48:19 +00:00
scsi_target use .Mt to mark up email addresses consistently (part1) 2014-06-20 09:40:43 +00:00
ses Decode common state bits in getencstat output. 2012-11-06 01:29:26 +00:00
smbfs
sunrpc
tests Remove unnecessary svn:executable property from source file. 2014-03-14 12:55:06 +00:00
witness
Makefile Remove example cvsup config files. 2014-06-25 12:32:41 +00:00