summaryrefslogtreecommitdiffstats
path: root/system/bit-babbler/README
blob: bc9635f364f27c5fdffe64740fe86419909a7009 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
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 and Black BB devices.

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.)

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

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!