2002-11-28 15:58:52 +00:00
|
|
|
|
.PU
|
|
|
|
|
.ds nm \fBopensc-explorer\fR
|
|
|
|
|
.TH opensc-explorer 1 "September 3, 2002" "" OpenSC
|
|
|
|
|
.SH NAME
|
|
|
|
|
opensc-explorer \- generic interactive utility for accessing smart card and similar security token functions
|
|
|
|
|
.SH SYNOPSIS
|
|
|
|
|
\*(nm
|
|
|
|
|
.RI [OPTIONS]
|
|
|
|
|
.SH DESCRIPTION
|
|
|
|
|
The \*(nm utility can be used interactively to perform
|
|
|
|
|
miscellaneous operations such as exploring the
|
|
|
|
|
contents of or sending arbitrary APDU commands to a
|
|
|
|
|
smart card or similar security token.
|
|
|
|
|
.SH OPTIONS
|
|
|
|
|
The following are the command\-line options for \*(nm. There
|
|
|
|
|
are additional interactive commands available once it is running.
|
|
|
|
|
.PP
|
|
|
|
|
.TP
|
|
|
|
|
.BR "\-\-reader " \fInum\fP ", \-r " \fInum\fP
|
|
|
|
|
Use the given reader number. The default is 0, the first reader
|
|
|
|
|
in the system.
|
|
|
|
|
.TP
|
|
|
|
|
.BR "\-\-card\-driver " \fIdriver\fP ", \-D " \fIdriver\fP
|
|
|
|
|
Use the given card driver. The default is auto-detected.
|
|
|
|
|
.TP
|
2004-06-13 20:13:12 +00:00
|
|
|
|
.BR \-\-verbose ", " \-v
|
|
|
|
|
Causes \*(nm to be more verbose. Specify this flag several times
|
|
|
|
|
to enable debug output in the opensc library.
|
2002-11-28 15:58:52 +00:00
|
|
|
|
.SH COMMANDS
|
2004-07-28 20:02:07 +00:00
|
|
|
|
The following commands are supported at the \*(nm interactive prompt.
|
2002-11-28 15:58:52 +00:00
|
|
|
|
.PP
|
|
|
|
|
.TP
|
|
|
|
|
.BR ls
|
|
|
|
|
list all files in the current DF
|
|
|
|
|
.TP
|
|
|
|
|
.BR "cd \fIfile\-id\fP"
|
|
|
|
|
change to another DF specified by \fIfile\-id\fP
|
|
|
|
|
.TP
|
|
|
|
|
.BR cat
|
|
|
|
|
print the contents of the currently selected EF
|
|
|
|
|
.TP
|
|
|
|
|
.BR "info [\fIfile\-id\fP]"
|
|
|
|
|
display attributes of a file specified by \fIfile\-id\fP.
|
|
|
|
|
If \fIfile\-id\fP is not supplied, the attributes of the
|
|
|
|
|
current file are printed.
|
|
|
|
|
.TP
|
|
|
|
|
.BR "create \fIfile\-id\fP \fIsize\fP"
|
|
|
|
|
create a new EF. \fIfile\-id\fP specifies the
|
|
|
|
|
id number and \fIsize\fP is the size of the new file.
|
|
|
|
|
.TP
|
|
|
|
|
.BR "delete \fIfile\-id\fP"
|
|
|
|
|
remove the EF or DF specified by \fIfile\-id\fP.
|
|
|
|
|
.TP
|
|
|
|
|
.BR "verify \fIkey\-type\fP\fIkey\-id\fP [\fIkey\fP]"
|
|
|
|
|
present a PIN or key to the card.
|
|
|
|
|
Where \fIkey\-type\fP can be one of CHV, KEY or PRO.
|
|
|
|
|
\fIkey\-id\fP is a number representing the key or PIN number.
|
|
|
|
|
\fIkey\fP is the key or PIN to be verified in hex.
|
|
|
|
|
.PP
|
|
|
|
|
Example: verify CHV0 31:32:33:34:00:00:00:00
|
|
|
|
|
.TP
|
|
|
|
|
.BR "change CHV\fIid\fP [\fIold\-pin\fP] \fInew\-pin\fP"
|
|
|
|
|
change a PIN
|
|
|
|
|
.PP
|
|
|
|
|
Example: change CHV0 31:32:33:34:00:00:00:00 'secret'
|
|
|
|
|
.TP
|
|
|
|
|
.BR "put \fIfile\-id\fP [\fIinput\fP]"
|
|
|
|
|
copy a local file to the card.
|
|
|
|
|
The local file is specified by \fIinput\fP while the
|
|
|
|
|
card file is specified by \fIfile\-id\fP.
|
|
|
|
|
.TP
|
|
|
|
|
.BR "get \fIfile\-id\fP [\fIoutput\fP]"
|
|
|
|
|
copy an EF to a local file.
|
|
|
|
|
The local file is specified by \fIoutput\fP while the
|
|
|
|
|
card file is specified by \fIfile\-id\fP.
|
|
|
|
|
.TP
|
|
|
|
|
.BR "mkdir \fIfile\-id\fP \fIsize\fP"
|
|
|
|
|
create a DF. \fIfile\-id\fP specifies the
|
|
|
|
|
id number and \fIsize\fP is the size of the new file.
|
|
|
|
|
.TP
|
|
|
|
|
.BR pksign
|
|
|
|
|
create a public key signature. NOTE: This command is
|
|
|
|
|
currently not implemented.
|
|
|
|
|
.TP
|
|
|
|
|
.BR pkdecrypt
|
|
|
|
|
perform a public key decryption. NOTE: This command is
|
|
|
|
|
currently not implemented.
|
|
|
|
|
.TP
|
|
|
|
|
.BR erase
|
|
|
|
|
erase the card, if the card supports it.
|
|
|
|
|
.TP
|
|
|
|
|
.BR "debug [\fIlevel\fP]"
|
|
|
|
|
get or set the debug level
|
|
|
|
|
.TP
|
|
|
|
|
.BR quit
|
|
|
|
|
exit the program
|
|
|
|
|
|
|
|
|
|
.SH SEE ALSO
|
|
|
|
|
.BR opensc (7),
|
|
|
|
|
.BR opensc-tool (1)
|
|
|
|
|
.SH AUTHORS
|
|
|
|
|
\*(nm was written by Juha Yrj<72>l<EFBFBD> <juha.yrjola@iki.fi>.
|
|
|
|
|
This manpage was contributed by Joe Phillips <joe.phillips@innovationsw.com>
|
|
|
|
|
for the Debian GNU/Linux system (but may be used by others).
|