]>
Commit | Line | Data |
---|---|---|
61af3de3 JG |
1 | .\" Copyright (C) 2001 Jeff Garzik -- jgarzik@pobox.com |
2 | .\" | |
3 | .TH RNGD 8 "March 2001" "@PACKAGE@ @VERSION@" | |
4 | ||
5 | .SH NAME | |
6 | rngd \- Check and feed random data from hardware device to kernel random device | |
7 | ||
8 | .SH SYNOPSIS | |
9 | .B rngd | |
10 | [\fB\-b\fR, \fB\-\-background\fR] | |
11 | [\fB\-f\fR, \fB\-\-foreground\fR] | |
12 | [\fB\-o\fR, \fB\-\-random-device=\fIfile\fR] | |
c192b4cf | 13 | [\fB\-p\fR, \fB\-\-pid-file=\fIfile\fR] |
61af3de3 JG |
14 | [\fB\-r\fR, \fB\-\-rng-device=\fIfile\fR] |
15 | [\fB\-s\fR, \fB\-\-random-step=\fInnn\fR] | |
16 | [\fB\-W\fR, \fB\-\-fill-watermark=\fInnn\fR] | |
2a014536 | 17 | [\fB\-d\fR, \fB\-\-no-drng=\fI1|0\fR] |
e42da63c BH |
18 | [\fB\-n\fR, \fB\-\-no-tpm=\fI1|0\fR] |
19 | [\fB\-q\fR, \fB\-\-quiet\fR] | |
20 | [\fB\-v\fR, \fB\-\-verbose\fR] | |
61af3de3 JG |
21 | [\fB\-?\fR, \fB\-\-help\fR] |
22 | [\fB\-V\fR, \fB\-\-version\fR] | |
23 | .RI | |
24 | ||
25 | .SH DESCRIPTION | |
26 | This daemon feeds data from a random number generator to the kernel's | |
27 | random number entropy pool, after first checking the data to ensure that | |
28 | it is properly random. | |
29 | .PP | |
30 | The \fB\-f\fR or \fB\-\-foreground\fR options can be used to tell | |
31 | \fBrngd\fR to avoid forking on startup. This is typically used for | |
e42da63c | 32 | debugging. The \fB\-b\fR or \fB\-\-background\fR options, which fork and put |
61af3de3 JG |
33 | \fBrngd\fR into the background automatically, are the default. |
34 | .PP | |
35 | The \fB\-r\fR or \fB\-\-rng-device\fR options can be used to select an | |
36 | alternate source of input, besides the default /dev/hwrandom. | |
37 | The \fB\-o\fR or \fB\-\-random-device\fR options can be used to select | |
38 | an alternate entropy output device, besides the default /dev/random. | |
39 | Note that this device must support the Linux kernel /dev/random | |
40 | ioctl API. | |
41 | .PP | |
61af3de3 JG |
42 | |
43 | .SH OPTIONS | |
44 | .TP | |
45 | \fB\-b\fR, \fB\-\-background\fR | |
46 | Become a daemon (default) | |
47 | .TP | |
48 | \fB\-f\fR, \fB\-\-foreground\fR | |
49 | Do not fork and become a daemon | |
50 | .TP | |
c192b4cf JG |
51 | \fB\-p\fI file\fR, \fB\-\-pid-file=\fIfile\fR |
52 | File used for recording daemon PID, and multiple exclusion | |
53 | (default: /var/run/rngd.pid) | |
54 | .TP | |
61af3de3 JG |
55 | \fB\-o\fI file\fR, \fB\-\-random-device=\fIfile\fR |
56 | Kernel device used for random number output | |
57 | (default: /dev/random) | |
58 | .TP | |
59 | \fB\-r\fI file\fR, \fB\-\-rng-device=\fIfile\fR | |
60 | Kernel device used for random number input | |
61 | (default: /dev/hwrandom) | |
62 | .TP | |
63 | \fB\-s\fI nnn\fR, \fB\-\-random-step=\fInnn\fR | |
64 | Number of bytes written to random-device at a time (default: 64) | |
65 | .TP | |
66 | \fB\-W\fI n\fR, \fB\-\-fill\-watermark=\fInnn\fR | |
67 | Once we start doing it, feed entropy to \fIrandom-device\fR until at least | |
68 | \fIfill-watermark\fR bits of entropy are available in its entropy pool (default: 2048). | |
69 | Setting this too high will cause \fIrngd\fR to dominate the contents of the | |
70 | entropy pool. Low values will hurt system performance during entropy | |
71 | starves. Do not set \fIfill-watermark\fR above the size of the | |
72 | entropy pool (usually 4096 bits). | |
73 | .TP | |
2a014536 BH |
74 | \fB\-d\fI 1|0\fR, \fB\-\-no-drng=\fI1|0\fR |
75 | Do not use drng as a source of random number input (default:0) | |
76 | .TP | |
e42da63c BH |
77 | \fB\-n\fI 1|0\fR, \fB\-\-no-tpm=\fI1|0\fR |
78 | Do not use tpm as a source of random number input (default:0) | |
79 | .TP | |
80 | \fB\-q\fR, \fB\-\-quiet\fR | |
81 | Suppress error messages | |
82 | .TP | |
83 | \fB\-v\fR, \fB\-\-verbose\fR | |
84 | Report available entropy sources | |
85 | .TP | |
61af3de3 JG |
86 | \fB\-?\fR, \fB\-\-help\fR |
87 | Give a short summary of all program options. | |
88 | .TP | |
89 | \fB\-V\fR, \fB\-\-version\fR | |
90 | Print program version | |
91 | ||
92 | .SH AUTHORS | |
93 | Philipp Rumpf | |
94 | .br | |
95 | Jeff Garzik \- jgarzik@pobox.com | |
96 | .br | |
97 | Matt Sottek | |
e42da63c BH |
98 | .br |
99 | Brad Hill |