105 lines
3.1 KiB
Groff
105 lines
3.1 KiB
Groff
.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
|
||
.BR \-\-verbose ", " \-v
|
||
Causes \*(nm to be more verbose. Specify this flag several times
|
||
to enable debug output in the opensc library.
|
||
.SH COMMANDS
|
||
The following commands are supported at the \*(nm interactive prompt.
|
||
.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).
|