NAME

vicc - manual page for vicc 0.9

DESCRIPTION

usage: vicc [-h] [-t {iso7816,cryptoflex,ePass,nPA,relay,handler_test}] [-v]

: [-f FILE] [-H HOSTNAME] [-P PORT] [-R] [--version] [--reader READER] [--mitm MITM] [--ef-cardaccess EF_CARDACCESS] [--ef-cardsecurity EF_CARDSECURITY] [--cvca CVCA] [--disable-ta-checks] [--ca-key CA_KEY] [-d DATASETFILE] [--esign-cert ESIGN_CERT] [--esign-ca-cert ESIGN_CA_CERT]

Virtual Smart Card 0.9: Smart card emulator written in Python. The emulator connects to the virtual smart card reader reader (vpcd). Smart card applications can access the Virtual Smart Card through the vpcd via PC/SC.

options:

-h, --help: show this help message and exit
-t {iso7816,cryptoflex,ePass,nPA,relay,handler_test}, --type {iso7816,cryptoflex,ePass,nPA,relay,handler_test}: type of smart card to emulate (default: iso7816)
-v, --verbose: Use (several times) to be more verbose
-f FILE, --file FILE: load a saved smart card image
-H HOSTNAME, --hostname HOSTNAME: specifiy vpcd's host name if vicc shall connect to it. (default: localhost)
-P PORT, --port PORT: port of connection establishment (default: 35963)
-R, --reversed: use reversed connection mode. vicc will wait for an incoming connection from vpcd. (default: False)
--version: show program's version number and exit

Relaying a local smart card (`--type=relay`):

--reader READER: number of the reader containing the card to be relayed (default: 0)
--mitm MITM: relative path to a file containing a Man-in-the-Middle class that is supposed to be used with the relay

Emulation of German identity card (`--type=nPA`):

--ef-cardaccess EF_CARDACCESS: the card's EF.CardAccess (default: use file from first generation nPA)
--ef-cardsecurity EF_CARDSECURITY: the card's EF.CardSecurity (default: use file from first generation nPA)
--cvca CVCA: trust anchor for verifying certificates in TA (default: use libeac's trusted certificates)
--disable-ta-checks: disable checking the validity period of CV certifcates (default: False)
--ca-key CA_KEY: the chip's private key for CA (default: randomly generated, invalidates signature of EF.CardSecurity)
-d DATASETFILE, --datasetfile DATASETFILE: Load the smartcard's data groups (DGs) from the specified dataset file. For DGs not in dataset file default values are used. The data groups in the data set file must have the following syntax: --------------------------------------------------- Datagroupname=Datagroupvalue --------------------------------------------------- For Example: GivenNames=GERTRUD. The following Dataset Elements may be used in the dataset file: DocumentType, IssuingState, DateOfExpiry, GivenNames, FamilyNames, ReligiousArtisticName, AcademicTitle, DateOfBirth, PlaceOfBirth, Nationality, Sex, BirthName, Country, City, ZIP, Street, CommunityID, ResidencePermit1, ResidencePermit2, dg12, dg14, dg15, dg16, dg21.
--esign-cert ESIGN_CERT: the card holder's certificate for QES
--esign-ca-cert ESIGN_CA_CERT: the CA's certificate for QES

REPORTING BUGS

Report bugs to https://github.com/frankmorgner/vsmartcard/issues

vicc(1)