1yhsm-linux-add-entropy(1)   General Commands Manual  yhsm-linux-add-entropy(1)
2
3
4

NAME

6       yhsm-linux-add-entropy  ‐  Seed  the  Linux entropy pool with data from
7       YubiHSM TRNG
8
9

SYNOPSIS

11       yhsm-linux-add-entropy [options]
12
13

DESCRIPTION

15       The YubiHSM uses "Avalanche Noise" TRNG together with  USB  SOF  jitter
16       sampling  to feed a DRBG_CTR algorithm (NIST publication SP800-90). The
17       result has been verified as being random data of  good  quality  by  at
18       least one third party cryptographer.  ⟨http://sartryck.idg.se/Art/
19       Yubihsm_1_TW072011.html⟩
20
21       Use this program to add random data from the  YubiHSM  to  the  entropy
22       pool  of  your  Linux operating system. This is useful whenever lots of
23       random data is needed, such  as  when  generating  chryptographic  keys
24       (GPG-keys), on a server terminating SSL sessions etc.
25
26       You  may  run  this  script from cron, or in a while-loop. Make sure it
27       does not run at the same time as something else accessing  the  YubiHSM
28       though,  or  the  two  tasks may interrupt each other ‐ probably making
29       both fail.
30
31

OPTIONS

33       -D, --device
34              device file name (default: /dev/ttyACM0).
35
36       -v, --verbose
37              enable verbose operation.
38
39       -c, --count
40              number of iterations to run (default: 100).
41
42       -r, --ratio
43              bits per byte read to use. 8 is probably fine, but as a  conser‐
44              vative default 2 is used.
45
46       --debug
47              enable debug printout, including all data sent to/from YubiHSM.
48
49

EXIT STATUS

51       0   Entropy added successfully
52
53       1   Failure
54
55

BUGS

57       Report python-pyhsm/yhsm-linux-add-entropy bugs in the issue tracker
58       ⟨https://github.com/Yubico/python-pyhsm/issues/⟩
59
60

SEE ALSO

62       The home page ⟨https://developers.yubico.com/python-pyhsm/⟩
63
64       YubiHSMs can be obtained from Yubico ⟨http://www.yubico.com/⟩.
65
66
67
68python-pyhsm                     December 2011       yhsm-linux-add-entropy(1)
Impressum