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

NAME

6       westcos-tool - utility for manipulating data structure on westcos smart
7       card and similar security tokens
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. Users can create PINs, keys and
15       certificates stored on the token. User PIN authentication is performed
16       for those operations that require it.
17

OPTIONS

19       -G
20           Generate a private key on smart card. The smart card must be not
21           finalized and pin installed (ig. file for pin must be created, see
22           option -i). By default key length is 1536 bits. User authentication
23           is required for this operation.
24
25       -L length
26           Change the length of private key, use with -G.
27
28       -i
29           Install pin file in token, you must provide pin value with -pin.
30
31       -pin value
32           set value of pin.
33
34       -puk value
35           set value of puk (or value of new pin for change pin command see
36           -n).
37
38       -n
39           Changes a PIN stored on the token. User authentication is required
40           for this operation.
41
42       -u
43           Unblocks a PIN stored on the token. Knowledge of the Pin Unblock
44           Key (PUK) is required for this operation.
45
46       -cert file
47           Write certificate file in pem format on the card. User
48           authentication is required for this operation.
49
50       -F
51           Finalize the card, once finalize default key is invalidate so pin
52           and puk can´be changed anymore without user authentification.
53           Warning, smart cards not finalized are unsecure because pin can be
54           changed without user authentification (knowledge of default key is
55           enougth).
56
57       -r n
58           Forces westcos-tool to use reader number n for operations.
59
60       -gf path
61           Get the file path the file is written on disk with path name. User
62           authentication is required for this operation.
63
64       -pf path
65           Put the file with name path from disk to card the file is written
66           in path. User authentication is required for this operation.
67
68       -v
69           Causes westcos-tool to be more verbose. Specify this flag several
70           times to enable debug output in the OpenSC library.
71
72       -h
73           Print help message on screen.
74

SEE ALSO

76       opensc(7)
77

AUTHORS

79       westcos-tool was written by Francois Leblanc
80       francois.leblanc@cev-sa.com.
81
82
83
84opensc                            02/16/2010                   WESTCOS-TOOL(1)