summaryrefslogtreecommitdiffstats
path: root/system/bit-babbler/README
diff options
context:
space:
mode:
Diffstat (limited to 'system/bit-babbler/README')
-rw-r--r--system/bit-babbler/README28
1 files changed, 15 insertions, 13 deletions
diff --git a/system/bit-babbler/README b/system/bit-babbler/README
index 81e5a69cbe..d81f09fdda 100644
--- a/system/bit-babbler/README
+++ b/system/bit-babbler/README
@@ -1,15 +1,15 @@
-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.
+The BitBabbler is a hardware True Random Number Generator (TRNG)
+manufactured by Voicetronix of Australia. This package installs the
+software necessary to control and perform basic health checks on both
+"white" or "black" varieties of BB devices. After installing this
+package:
-After installing the package, "groupadd bit-babbler", or adjust
+1. Add group "bit-babbler", or modify
/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.
+"wheel" or "adm"). Beside root, only members of this designated group
+will be able to directly access BB devices on your system.
-Typically, you'll probably want your BitBabbler device(s) to start
+2a. 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:
@@ -18,12 +18,14 @@ 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:
+2b. 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
+
+Enjoy!