Some tools to play with GnuPG’s smartcard daemon and OpenPGP smartcards.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
scdtools/man/scdrand.1.in

92 lines
1.7 KiB

.TH SCDRAND 11/08/2014 "scdtools @PACKAGE_VERSION@"
.SH NAME
scdrand \- Extract random numbers from a smartcard
.SH SYNOPSIS
.SY scdrand
.RB [ \-h | --help ]
.RB [ \-v | --version ]
.RB [ \-l | --loop ]
.RB [ \-L | --max-loop
.IR N ]
.RB [ \-i | --interval
.IR N ]
.RB [ \-t | --threshold
.IR N ]
.RB [ \-e | --entropy-bits
.IR N ]
.RB [ nbytes ]
.YS
.SH DESCRIPTION
.PP
.B scdrand
fetches random bytes from a ISO7816-compliant smartcard
and feeds them to the Linux kernel entropy pool.
.PP
The program depends on
.I scdaemon
(part of GnuPG) to interact with a card reader and the
card itself.
.SH OPTIONS
.TP
.BR -h ", " --help
Display the help message.
.TP
.BR -v ", " --version
Display the version message.
.TP
.BR -l ", " --loop
Loop indefinitely.
.TP
.BR -L ", " --max-loop " " \fiN\fR
Loop for
.I N
iterations.
.TP
.BR -i ", " --interval " " \fiN\fR
Sleep for
.I N
seconds between iterations.
.TP
.BR -t ", " --threshold " " \fiN\fR
Feed the kernel entropy pool only if it contains less than
.I N
bits of entropy.
.TP
.BR -e ", " --entropy-bits " " \fiN\fR
Define the entropic value of a single random byte.
.I N
must be comprised between 1 and 8, inclusive.
.SH EXAMPLES
.PP
Check the kernel entropy pool every 5 seconds, and feed it with
64 bytes of random data if there is less than 512 bits of
entropy available:
.PP
.nf
$ scdrand -l -i 5 -t 512 64
.SH REPORTING BUGS
.PP
Report bugs to
.MT @PACKAGE_BUGREPORT@
Damien Goutte-Gattat
.ME .
.SH SEE ALSO
.BR scdaemon (1),
.BR random (4)
.SH COPYRIGHT
.ad l
.PP
Copyright \(co 2014, 2015 Damien Goutte-Gattat
.PP
This program is released under the GNU General Public License.
See the COPYING file in the source distribution or
.UR http://www.gnu.org/licenses/gpl.html
.UE .