.TH "hbcicard" "1" "@rpm_version@" "Martin Preuss" "LibChipCard"
.SH "NAME"
.LP 
hbcicard \- A tool to manipulate data on a Home Banking Card.
.SH "SYNOPSIS"
.br 
\fI hbcicard \fR
COMMAND 
 [\fB \-C\fR configfile ]
 [\fB \-i\fR index ]
 [\fB \-p\fR pin1 ]
 [\fB \-P\fR pin2 ]
 [\fB \-k\fR ]
 [\fB \-\-logfile\fR file ]
 [\fB \-\-logtype\fR type ]
 [\fB \-\-loglevel\fR level ]
.br
.SH "DESCRIPTION"
.LP 
The hbcicard utility lets you inspect and set options of your HBCI (home
banking computer interface) chipcard. Supported card\-types currently are
DDV and RSA.
.BR 
.SH "COMMANDS"
The parameter COMMAND can be one of the following. Invoking without a
COMMAND parameter displays instructions.
.TP 
\fBtype
shows the card type (either DDV or RSA)
.TP 
\fBinfo
shows some basic information about the card (like serial number etc).
.TP 
\fBdump
dump entries on a card
.TP 
\fBset
change an entry on a card
.TP 
\fBchgpin
change the cardholder pin of a RSA card
.TP 
\fBinitpin
change the inital cardholder pin of a RSA card.
If you purchased a new RSA card then it uses an
initial pin (the serial number of the card).
You need THIS command to change that pin in order
to use the card. 
The switch "\-k" must not be used with \fBinitpin\fR
.TP 
\fBkeys
lists the keys stored on a RSA card
.SH "GENERAL OPTIONS"
.LP 
.TP 
\fB\-C\fR \fIconfigfile\fP
Uses the given configuration file. If omitted the file \fI@CHIPCARDD_CFGFILE@\fR is used.
.TP 
\fB\-i\fR \fIindex\fP
Number of the card's entry to use. If omitted and COMMAND is "dump" then all
entries are shown.
.TP 
\fB\-p\fR \fIpin1\fP
Pin 1 (used to get access to a card)
.TP 
\fB\-P\fR \fIpin2\fP
Pin 2 (new pin when changing the pin)
.TP 
\fB\-k\fR
Use keypad for secure pin input (cannot be used with the "initpin" command).
.TP 
\fB\-\-logfile\fR \fIlogfile\fP
Use the given file to store the log messages. 
It defaults to \f./Ihbcicard.log\fR. This only applies if the \fBlogtype\fR is \fIfile\fR (see below).
.TP 
\fB\-\-logtype\fR \fIlogtype\fP
Use the given log type. Currently the following \fIlogtypes\fR are
supported: \fIstderr\fR, \fIfile\fR. Default is \fIstderr\fR.
.TP 
\fB\-\-loglevel\fR \fIloglevel\fP
Sets the loglevel. Valid levels are: \fIemergency\fR, \fIalert\fR,
\fIcritical\fR, \fIerror\fR, \fIwarning\fR, \fInotice\fR, \fIinfo\fR, and
\fIdebug\fR. Default is \fIwarning\fR.
.SH "SPECIAL OPTIONS FOR SET COMMAND"
.LP 
.TP 
\fB\-s\fR \fIserver\fP
server address to set
.TP 
\fB\-u\fR \fIuser\fP
user id to set
.TP 
\fB\-c\fR \fIcountrycode\fP
country code (defaults to 280 for Germany)
.TP 
\fB\-b\fR \fIbankcode\fP
bank code (e.g. German Bankleitzahl)
.TP 
\fB\-q\fR \fIsequencenumber\fP
signature counter, this one is checked by your bank, each signature needs a
higher number than any signature before. You cannot set the sequence number
on a RSA card.
.SH "FILES"
.LP 
\fI@CHIPCARDD_CFGFILE@\fP
.br 
.SH "ENVIRONMENT VARIABLES"
.LP 
hbcicard does not use any environment variables
.BR 
.SH "EXAMPLE"
The simplest usage of this program is:
.LP 
hbcicard type
.LP 
This shows the type of the card (either DDV or RSA).
.SH "AUTHORS"
.LP 
Martin Preuss <martin@libchipcard.de>
.SH "SEE ALSO"
.LP 
libchipcard.conf(5) chipcardc.conf(5)