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.
 
 
 

91 lines
2.0 KiB

.TH SCDTOTP @BUILD_DATE@ "scdtools @PACKAGE_VERSION@"
.SH NAME
scdtotp \- Generate one-time passwords from an OpenPGP smartcard
.SH SYNOPSIS
.SY scdtotp
.RB [ \-h | --help ]
.RB [ \-v | --version ]
.RB [ \-t | --time
.IR seconds ]
.RB [ \-p | --period
.IR seconds ]
.RB [ \-w | --window
.IR N ]
.RB [ \-d | --digits
.IR N ]
.RB [ \-m | --mac-algo
.IR algo ]
.RB [ \-n | --private-do
.IR N ]
.YS
.SH DESCRIPTION
.PP
.B scdtotp
generates time-based one-time passwords (TOTP) as per
RFC 6238 derived from a key it finds in a Private Data
Object (Private DO) of an OpenPGP smartcard.
.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 -t ", " --time " " \fiseconds\fR
Generate password for the specified time in seconds
instead of current time.
.TP
.BR -p ", " --period " " \fiN\fR
Force a period of \fiN\fR seconds. The default period
is 30 seconds, unless specified otherwise on the card.
.TP
.BR -w ", " --window " " \fiN\fR
Generate password for \fiN\fR time window around the
current time.
.TP
.BR -d ", " --digits " " \fiN\fR
Output a password of
.I N
digits. The default value is 6, unless another
value is specified on the smartcard.
.TP
.BR -m ", " --mac-algo " " \fialgo\fR
Select the HMAC algorithm to use among
\fisha1\fR, \fisha256\fR, or \fisha512\fR.
The default is \fisha1\fR, unless another
algorithm is specified on the smartcard.
.TP
.BR -n ", " --private-do " " \fiN\fR
Read key from private DO slot #\fiN\fR
(default is @DEFAULT_PRIVATE_DO@.)
.SH REPORTING BUGS
.PP
Report bugs to
.MT @PACKAGE_BUGREPORT@
Damien Goutte-Gattat
.ME .
.SH SEE ALSO
.BR scdaemon (1),
.BR oathtool (1)
.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 .