1WESTCOS-TOOL(1)                  OpenSC Tools                  WESTCOS-TOOL(1)
2
3
4

NAME

6       westcos-tool - utility for manipulating data structures on westcos
7       smart cards
8

SYNOPSIS

10       westcos-tool [OPTIONS]
11

DESCRIPTION

13       The westcos-tool utility is used to manipulate the westcos data
14       structures on 2 Ko smart cards / tokens. Users can create PINs, keys
15       and certificates stored on the card / token. User PIN authentication is
16       performed for those operations that require it.
17

OPTIONS

19       --change-pin, -n
20           Changes a PIN stored on the card. User authentication is required
21           for this operation.
22
23       --certificate file, -t file
24           Write certificate file file in PEM format to the card. User
25           authentication is required for this operation.
26
27       --finalize, -f
28           Finalize the card. Once finalized the default key is invalidated,
29           so PIN and PUK cannot be changed anymore without user
30           authentication.
31
32           Warning, un-finalized are insecure because PIN can be changed
33           without user authentication (knowledge of default key is enough).
34
35       --generate-key, -g
36           Generate a private key on the card. The card must not have been
37           finalized and a PIN must be installed (ie. the file for ithe PIN
38           must havei been created, see option -i). By default the key length
39           is 1536 bits. User authentication is required for this operation.
40
41       --help, -h
42           Print help message on screen.
43
44       --install-pin, -i
45           Install PIN file in on the card. You must provide a PIN value with
46           -x.
47
48       --key-length length, -l length
49           Change the length of private key. Use with -g.
50
51       --overwrite-key, -o
52           Overwrite the key if there is already a key on the card.
53
54       --pin-value value, -x value
55           Set value of PIN. If set to env:VARIABLE, the value of the
56           environment variable VARIABLE is used.
57
58       --puk-value value, -y value
59           set value of PUK (or value of new PIN for change PIN command see
60           -n). If set to env:VARIABLE, the value of the environment variable
61           VARIABLE is used.
62
63       --read-file path, -j path
64           Read the file path from the card. The file is written on disk with
65           name path. User authentication is required for this operation.
66
67       --reader num, -r num
68           Use the given reader. The default is the first reader with a card.
69
70       --unblock-pin, -u
71           Unblocks a PIN stored on the card. Knowledge of the PIN Unblock Key
72           (PUK) is required for this operation.
73
74       -v
75           Causes westcos-tool to be more verbose. Specify this flag several
76           times to enable debug output in the OpenSC library.
77
78       --wait, -w
79           Wait for a card to be inserted.
80
81       --write-file path, -k path
82           Put the file with name path from disk to card. On the card the file
83           is written in path. User authentication is required for this
84           operation.
85

AUTHORS

87       westcos-tool was written by Francois Leblanc
88       <francois.leblanc@cev-sa.com>.
89
90
91
92opensc                            10/30/2018                   WESTCOS-TOOL(1)
Impressum