From f362866181391ed9baa3846125841900c15aac2f Mon Sep 17 00:00:00 2001 From: "Arthur W. Green" Date: Wed, 2 Nov 2016 22:51:11 +0700 Subject: system/bit-babbler: Added (Hardware True Random Number generator). Signed-off-by: Willy Sudiarto Raharjo --- system/bit-babbler/README | 29 +++++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) create mode 100644 system/bit-babbler/README (limited to 'system/bit-babbler/README') diff --git a/system/bit-babbler/README b/system/bit-babbler/README new file mode 100644 index 0000000000000..81e5a69cbe30e --- /dev/null +++ b/system/bit-babbler/README @@ -0,0 +1,29 @@ +The BitBabbler is a hardware-based True Random Number generator +(TRNG). It is offered in both "White" and "Black" varieties that are +functionally almost identical apart from throughput and cost. This +package installs the software necessary to control and perform basic +health checks on connected BB devices. + +After installing the package, "groupadd bit-babbler", or adjust +/etc/udev/rules.d/90-bit-babbler.rules to use an existing group (e.g., +wheel or adm) that will have permissions for the BB devices in your +system. + +Typically, you'll probably want your BitBabbler device(s) to start +feeding entropy to the kernel at boot. Include these lines in +/etc/rc.d/rc.local: + +# Start BitBabbler TRNG. +if [ -x /etc/rc.d/rc.seedd ]; then + . /etc/rc.d/rc.seedd start +fi + +It is also a good idea to stop your BB device from feeding entropy to +the kernel before capturing the random number seed on shutdown/reboot. +Put these lines in /etc/rc.d/rc.local_shutdown, which you'll need to +create if it doesn't already exist: + +# Stop BitBabbler TRNG. +if [ -x /etc/rc.d/rc.seedd ]; then + . /etc/rc.d/rc.seedd stop +fi -- cgit v1.2.3