Annotation of src/usr.bin/sectok/sectok.1, Revision 1.3
1.3 ! jakob 1: .\" $OpenBSD: sectok.1,v 1.2 2001/07/25 20:28:57 jakob Exp $
1.1 rees 2: .\"
1.2 jakob 3: .\" Copyright (C) 2001, Jakob Schlyter. All rights reserved.
4: .\"
5: .\" Redistribution and use in source and binary forms, with or without
6: .\" modification, are permitted provided that the following conditions
7: .\" are met:
8: .\" 1. Redistributions of source code must retain the above copyright
9: .\" notice, this list of conditions and the following disclaimer.
10: .\" 2. Redistributions in binary form must reproduce the above copyright
11: .\" notice, this list of conditions and the following disclaimer in the
12: .\" documentation and/or other materials provided with the distribution.
13: .\" 3. Neither the name of the project nor the names of its contributors
14: .\" may be used to endorse or promote products derived from this software
15: .\" without specific prior written permission.
16: .\"
17: .\" THIS SOFTWARE IS PROVIDED BY THE PROJECT AND CONTRIBUTORS ``AS IS'' AND
18: .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
19: .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
20: .\" ARE DISCLAIMED. IN NO EVENT SHALL THE PROJECT OR CONTRIBUTORS BE LIABLE
21: .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
22: .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
23: .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
24: .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
25: .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
26: .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
27: .\" SUCH DAMAGE.
28: .\"
29: .Dd July 17, 2001
30: .Dt SECTOK 1
1.1 rees 31: .Os
32: .Sh NAME
1.2 jakob 33: .Nm sectok
1.1 rees 34: .Nd communicate with smartcards using iso7816
35: .Sh SYNOPSIS
1.2 jakob 36: .Nm sectok
37: .Op Fl 0123
38: .Op Fl f Ar scriptfile
39: .Op Fl s Ar sleeptime
1.1 rees 40: .Sh DESCRIPTION
41: .Nm
1.2 jakob 42: is a command-line-like interface for communicating with smartcards.
43: APDUs can be sent to the card, and results are displayed. Some
44: commands are card-specific, and focus on the Schlumberger Cyberflex
45: Access Javacards.
46: .Sh OPTIONS
47: .Bl -tag -width Ds
48: .It Fl 0123
49: Select port.
50: .Pp
51: .It Fl f Ar scriptfile
52: Run commands from scriptfile.
53: .Pp
54: .It Fl s Ar sleeptime
55: Set sleep between commands in the script.
1.3 ! jakob 56: .El
1.2 jakob 57: .Sh COMMANDS
58: .Ss Non-card commands
59: .Pp
60: .Bl -tag -width Ds
61: .It Xo
62: .Cm help
63: .Op command
64: .Xc
65: Show help for
66: .Ar command .
67: .It Xo
68: .Cm ?
69: .Op command
70: .Xc
71: Show help for
72: .Ar command .
73: .It Xo
74: .Cm reset
75: .Op Fl 0123ivf
76: .Xc
77: Reset smartcard.
78: .Bl -tag -width Ds
79: .It Fl 0123
80: select port
81: .It Fl i
82: don't wait for card insertion
83: .It Fl v
84: verbose
85: .It Fl f
86: open connection even if atr is bad
87: .El
88: .It Xo
89: .Cm open
90: .Op Fl 0123ivf
91: .Xc
92: Synonym for reset.
93: .It Xo
94: .Cm close
95: .Xc
96: Close smartcard connection.
97: .It Xo
98: .Cm quit
99: .Xc
100: Quit
101: .Nm Li .
102: .El
103: .Ss ISO 7816-4 commands
104: .Pp
105: .Bl -tag -width Ds
106: .It Xo
107: .Cm apdu
108: .Op Fl c Ar class
109: .Ar "ins p1 p2 p3 data ..."
110: .Xc
111: Send APDU to smartcard.
112: .It Xo
113: .Cm fid
114: .Op Fl v
115: .Ar fid
116: .Xc
117: Select file identified by
118: .Ar fid .
119: .Ar fid
120: can be a numeric fid such as 3f00 or a two character name.
121: .It Xo
122: .Cm isearch
123: .Xc
124: Try all 256 possible instructions and print results.
125: .It Xo
126: .Cm class
127: .Op Ar class
128: .Xc
129: .It Xo
130: .Cm read
131: .Op Fl x
132: .Ar filesize
133: .Xc
134: .It Xo
135: .Cm write
136: .Ar input-filename
137: .Xc
138: .El
139: .Ss Cyberflex commands
140: .Pp
141: .Bl -tag -width Ds
142: .It Xo
143: .Cm ls
144: .Op Fl l
145: .Xc
146: List all files in current DF.
147: .It Xo
148: .Cm acl
149: .Ar fid
150: .Op Ar principal: "r1 r2 ..."
151: .Xc
152: .Bl -tag -width Ds
153: .It principals
154: world, CHV1, CHV2, AUT0, AUT1, AUT2, AUT3, AUT4
155: .It f_rights
156: r, w, x/a, inval, rehab, dec, inc
157: .It d_rights
158: l, d, a, i, manage
159: .El
160: .It Xo
161: .Cm create
162: .Ar fid
163: .Ar size
164: .Xc
165: .It Xo
166: .Cm delete
167: .Ar fid
168: .Xc
169: .It Xo
170: .Cm jdefault
171: .Op Fl d
172: .Xc
173: Set default applet.
174: .Bl -tag -width Ds
175: .It Fl d
176: set default applet to default loader
177: .El
178: .It Xo
179: .Cm jatr
180: .Xc
181: Set java atr.
182: .It Xo
183: .Cm jdata
184: .Xc
185: Print useful info about the card
186: .It Xo
187: .Cm login
188: .Op Fl d
189: .Op Fl k Ar keyno
190: .Op Fl v
191: .Op Fl x Ar hex-aut0
192: .Xc
193: .It Xo
194: .Cm jload
195: .Op Fl p Ar progID
196: .Op Fl c Ar contID
197: .Op Fl s Ar cont_size
198: .Op Fl i Ar inst_size
199: .Op Fl v
200: .Op Fl a Ar filename
201: .Xc
202: .It Xo
203: .Cm jlogin
204: .Op Fl d
205: .Xc
206: "login" (verify AUT0 key)
207: .Bl -tag -width Ds
208: .It Fl d
209: use manufacturer's default AUT0 key
210: .El
211: .It Xo
212: .Cm junload
213: .Op Fl p Ar progID
214: .Op Fl c Ar contID
215: .Xc
216: .It Xo
217: .Cm jselect
218: .Op Fl a Ar aid
219: .Op Fl d
220: .Xc
221: Select applet.
222: .Bl -tag -width Ds
223: .It Fl d
224: select default loader
225: .El
226: .It Xo
227: .Cm setpass
228: .Op Fl d
229: .Op Fl x Ar hex-aut0
230: .Xc
231: .El
232: .Sh AUTHORS
1.1 rees 233: .Nm
1.2 jakob 234: was written by Jim Rees and others at University of Michigan.
235: .Sh HISTORY
1.1 rees 236: .Nm
1.2 jakob 237: first appeared in
238: .Ox 3.0 .
239: .Sh BUGS
240: Probably several.