westcos-tool (1) - Linux Manuals

westcos-tool: utility for manipulating data structure on westcos smart card and similar security tokens

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.

AUTHORS

westcos-tool was written by Francois Leblanc <francois.leblanc [at] cev-sa.com>.