aboutsummaryrefslogtreecommitdiff
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 d81f09fdda33a..bc9635f364f27 100644
--- a/system/bit-babbler/README
+++ b/system/bit-babbler/README
@@ -1,31 +1,33 @@
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:
+White and Black BB devices.
-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"). Beside root, only members of this designated group
-will be able to directly access BB devices on your system.
+After installing this package, you'll need to addgroup "bit-babbler"
+OR: put a modified copy of
+ /lib/udev/rules.d/90-bit-babbler.rules
+into /etc/udev/rules.d that uses an existing group (e.g., "wheel").
+(So long as the filename is the same, the modified rules file in this
+directory will override the original installed by this package.)
-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:
+To also have your BitBabbler device(s) start feeding entropy to the
+kernel at boot:
+
+1) Add the following lines to /etc/rc.d/rc.local:
# Start BitBabbler TRNG.
if [ -x /etc/rc.d/rc.seedd ]; then
. /etc/rc.d/rc.seedd start
fi
-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:
+2) And add the following to /etc/rc.d/rc.local_shutdown:
# Stop BitBabbler TRNG.
if [ -x /etc/rc.d/rc.seedd ]; then
. /etc/rc.d/rc.seedd stop
fi
+3) Then be sure the execute bit is set (chmod) for rc.local,
+rc.local_shutdown, and rc.seedd.
+
Enjoy!