Changes in random_adaptor_example.c

1d386b48 - Remove $FreeBSD$: one-line .c pattern

Wed, 16 Aug 2023 17:54:42 +0000

Remove $FreeBSD$: one-line .c patternRemove /^[\s*]*__FBSDID$"\$FreeBSD\$"$;?\s*\n/ List of files: /freebsd-14.2/share/examples/kld/random_adaptor/random_adaptor_example.c

4d846d26 - spdx: The BSD-2-Clause-FreeBSD identifier is obsolete, drop -FreeBSD

Wed, 10 May 2023 15:40:58 +0000

spdx: The BSD-2-Clause-FreeBSD identifier is obsolete, drop -FreeBSDThe SPDX folks have obsoleted the BSD-2-Clause-FreeBSD identifier. Catchup to that fact and revert to their recommended match of BSD-2-Clause.Discussed with: pfgMFC After: 3 daysSponsored by: Netflix List of files: /freebsd-14.2/share/examples/kld/random_adaptor/random_adaptor_example.c

f0cfa1b1 - share and pc-sysinstall: adoption of SPDX licensing ID tags.

Mon, 27 Nov 2017 15:28:26 +0000

share and pc-sysinstall: adoption of SPDX licensing ID tags.Mainly focus on files that use BSD 2-Clause license, however the tool Iwas using misidentified many licenses so this was mostly a manual - errorprone - task.The Software Package Data Exchange (SPDX) group provides a specificationto make it easier for automated tools to detect and summarize well knownopensource licenses. We are gradually adopting the specification, notingthat the tags are considered only advisory and do not, in any way,superceed or replace the license texts.Commit these apart because compile testing doesn't guarantee I didn't madesome nasty mistake. No functional change intended. List of files: /freebsd-14.2/share/examples/kld/random_adaptor/random_adaptor_example.c

10cb2424 - This is the much-discussed major upgrade to the random(4) device, known to you all as /dev/random.

Thu, 30 Oct 2014 21:21:53 +0000

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) List of files: /freebsd-14.2/share/examples/kld/random_adaptor/random_adaptor_example.c

f02e47dc - Snapshot. This passes the build test, but has not yet been finished or debugged.

Fri, 04 Oct 2013 06:55:06 +0000

Snapshot. This passes the build test, but has not yet been finished or debugged.Contains:* Refactor the hardware RNG CPU instruction sources to feed intothe software mixer. This is unfinished. The actual harvesting needsto be sorted out. Modified by me (see below).* Remove 'frac' parameter from random_harvest(). This was neverused and adds extra code for no good reason.* Remove device write entropy harvesting. This provided a weakattack vector, was not very good at bootstrapping the device. Tofollow will be a replacement explicit reseed knob.* Separate out all the RANDOM_PURE sources into separate harvestentities. This adds some secuity in the case where more than oneis present.* Review all the code and fix anything obviously messy or inconsistent.Address som review concerns while I'm here, like rename the pseudo-rngto 'dummy'.Submitted by: Arthur Mesh (the first item) List of files: /freebsd-14.2/share/examples/kld/random_adaptor/random_adaptor_example.c

7737ec41 - Remove short-lived idea; thread to harvest (eg) RDRAND enropy into the usual harvest queues. It was a nifty idea, but too heavyweight.

Fri, 30 Aug 2013 17:47:53 +0000

Remove short-lived idea; thread to harvest (eg) RDRAND enropy into the usual harvest queues. It was a nifty idea, but too heavyweight.Submitted by: Arthur Mesh List of files: /freebsd-14.2/share/examples/kld/random_adaptor/random_adaptor_example.c

ddbfa6b1 - 1) example (partially humorous random_adaptor, that I call "EXAMPLE")

Sat, 24 Aug 2013 13:54:56 +0000

1) example (partially humorous random_adaptor, that I call "EXAMPLE") * It's not meant to be used in a real system, it's there to show how the basics of how to create interfaces for random_adaptors. Perhaps it should belong in a manual page2) Move probe.c's functionality in to random_adaptors.c * rename random_ident_hardware() to random_adaptor_choose()3) Introduce a new way to choose (or select) random_adaptors via tunable"rngs_want" It's a list of comma separated names of adaptors, orderedby preferences. I.e.:rngs_want="yarrow,rdrand"Such setting would cause yarrow to be preferred to rdrand. If neither ofthem are available (or registered), then system will default tosomething reasonable (currently yarrow). If yarrow is not present, thenwe fall back to the adaptor that's first on the list of registeredadaptors.4) Introduce a way where RNGs can play a role of entropy source. This ismostly useful for HW rngs.The way I envision this is that every HW RNG will use thisfunctionality by default. Functionality to disable this is also present.I have an example of how to use this in random_adaptor_example.c (seemodload event, and init function)5) fix kern.random.adaptors fromkern.random.adaptors: yarrowpanicblocktokern.random.adaptors: yarrow,panic,block6) add kern.random.active_adaptor to indicate currently selectedadaptor:root@freebsd04:~ # sysctl kern.random.active_adaptorkern.random.active_adaptor: yarrowSubmitted by: Arthur Mesh List of files: /freebsd-14.2/share/examples/kld/random_adaptor/random_adaptor_example.c