[BACK]Return to sectok.1 CVS log [TXT][DIR] Up to [local] / src / usr.bin / sectok

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.