'\" t
.\"     Title: opensc-tool
.\"    Author: [see the "Authors" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 04/05/2024
.\"    Manual: OpenSC Tools
.\"    Source: opensc
.\"  Language: English
.\"
.TH "OPENSC\-TOOL" "1" "04/05/2024" "opensc" "OpenSC Tools"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
opensc-tool \- generic smart card utility
.SH "SYNOPSIS"
.HP \w'\fBopensc\-tool\fR\ 'u
\fBopensc\-tool\fR [\fIOPTIONS\fR]
.SH "DESCRIPTION"
.PP
The
\fBopensc\-tool\fR
utility can be used from the command line to perform miscellaneous smart card operations such as getting the card ATR or sending arbitrary APDU commands to a card\&.
.SH "OPTIONS"
.PP
.PP
\fB\-\-version\fR
.RS 4
Print the OpenSC package release version\&.
.RE
.PP
\fB\-\-atr\fR, \fB\-a\fR
.RS 4
Print the Answer To Reset (ATR) of the card\&. Output is in hex byte format
.RE
.PP
\fB\-\-card\-driver\fR \fIdriver\fR, \fB\-c\fR \fIdriver\fR
.RS 4
Use the given card driver\&. The default is to auto\-detect the correct card driver\&. The literal value
?
lists all available card drivers\&.
.RE
.PP
\fB\-\-list\-algorithms\fR,
.RS 4
Lists algorithms supported by card
.RE
.PP
\fB\-\-info\fR, \fB\-i\fR
.RS 4
Print information about OpenSC, such as version and enabled components\&.
.RE
.PP
\fB\-\-list\-drivers\fR, \fB\-D\fR
.RS 4
List all installed card drivers\&.
.RE
.PP
\fB\-\-list\-files\fR, \fB\-f\fR
.RS 4
Recursively list all files stored on card\&.
.RE
.PP
\fB\-\-list\-readers\fR, \fB\-l\fR
.RS 4
List all configured readers\&.
.RE
.PP
\fB\-\-name\fR, \fB\-n\fR
.RS 4
Print the name of the inserted card (driver)\&.
.RE
.PP
\fB\-\-get\-conf\-entry\fR \fIconf\fR, \fB\-G\fR \fIconf\fR
.RS 4
Get configuration key, format: section:name:key
.RE
.PP
\fB\-\-set\-conf\-entry\fR \fIconf\fR, \fB\-S\fR \fIconf\fR
.RS 4
Set configuration key, format: section:name:key:value
.RE
.PP
\fB\-\-reader\fR \fIarg\fR, \fB\-r\fR \fIarg\fR
.RS 4
Number of the reader to use\&. By default, the first reader with a present card is used\&. If
\fIarg\fR
is an ATR, the reader with a matching card will be chosen\&.
.RE
.PP
\fB\-\-reset\fR [\fItype\fR],
.RS 4
Resets the card in reader\&. The default reset type is
cold, but
warm
reset is also possible\&.
.RE
.PP
\fB\-\-send\-apdu\fR \fIapdu\fR, \fB\-s\fR \fIapdu\fR
.RS 4
Sends an arbitrary APDU to the card in the format
AA:BB:CC:DD:EE:FF\&.\&.\&.\&. Use this option multiple times to send more than one APDU\&.
.sp
The built\-in card drivers may send additional APDUs for detection and initialization\&. To avoid this behavior, you may additionally specify
\fB\-\-card\-driver\fR
default\&.
.RE
.PP
\fB\-\-serial\fR
.RS 4
Print the card serial number (normally the ICCSN)\&. Output is in hex byte format
.RE
.PP
\fB\-\-verbose\fR, \fB\-v\fR
.RS 4
Causes
\fBopensc\-tool\fR
to be more verbose\&. Specify this flag several times to enable debug output in the opensc library\&.
.RE
.PP
\fB\-\-wait\fR, \fB\-w\fR
.RS 4
Wait for a card to be inserted\&.
.RE
.SH "SEE ALSO"
.PP
\fBopensc-explorer\fR(1)
.SH "AUTHORS"
.PP
\fBopensc\-tool\fR
was written by Juha Yrjölä
<juha\&.yrjola@iki\&.fi>\&.