NAME
westcos-tool - utility for manipulating data structure on westcos smart
card and similar security tokens
SYNOPSIS
westcos-tool [OPTIONS]
DESCRIPTION
The westcos-tool utility is used to manipulate the westcos data
structures on 2 Ko smart cards. Users can create PINs, keys and
certificates stored on the token. User PIN authentication is performed
for those operations that require it.
OPTIONS
-G
Generate a private key on smart card. The smart card must be not
finalized and pin installed (ig. file for pin must be created, see
option -i). By default key length is 1536 bits. User authentication
is required for this operation.
-L length
Change the length of private key, use with -G.
-i
Install pin file in token, you must provide pin value with -pin.
-pin value
set value of pin.
-puk value
set value of puk (or value of new pin for change pin command see
-n).
-n
Changes a PIN stored on the token. User authentication is required
for this operation.
-u
Unblocks a PIN stored on the token. Knowledge of the Pin Unblock
Key (PUK) is required for this operation.
-cert file
Write certificate file in pem format on the card. User
authentication is required for this operation.
-F
Finalize the card, once finalize default key is invalidate so pin
and puk can'be changed anymore without user authentification.
Warning, smart cards not finalized are unsecure because pin can be
changed without user authentification (knowledge of default key is
enougth).
-r n
Forces westcos-tool to use reader number n for operations.
-gf path
Get the file path the file is written on disk with path name. User
authentication is required for this operation.
-pf path
Put the file with name path from disk to card the file is written
in path. User authentication is required for this operation.
-v
Causes westcos-tool to be more verbose. Specify this flag several
times to enable debug output in the OpenSC library.
-h
Print help message on screen.
SEE ALSO
opensc(7)
AUTHORS
westcos-tool was written by Francois Leblanc
francois.leblanc@cev-sa.com.