2005-07-20 00:43:38 +00:00
|
|
|
<?xml version="1.0" encoding="UTF-8"?>
|
|
|
|
<refentry id="opensc-tool">
|
|
|
|
<refmeta>
|
|
|
|
<refentrytitle>opensc-tool</refentrytitle>
|
|
|
|
<manvolnum>1</manvolnum>
|
2011-08-14 21:27:55 +00:00
|
|
|
<refmiscinfo class="productname">OpenSC</refmiscinfo>
|
|
|
|
<refmiscinfo class="manual">OpenSC Tools</refmiscinfo>
|
|
|
|
<refmiscinfo class="source">opensc</refmiscinfo>
|
2005-07-20 00:43:38 +00:00
|
|
|
</refmeta>
|
|
|
|
|
|
|
|
<refnamediv>
|
|
|
|
<refname>opensc-tool</refname>
|
|
|
|
<refpurpose>generic smart card utility</refpurpose>
|
|
|
|
</refnamediv>
|
|
|
|
|
2011-08-14 19:52:02 +00:00
|
|
|
<refsynopsisdiv>
|
|
|
|
<cmdsynopsis>
|
|
|
|
<command>opensc-tool</command>
|
|
|
|
<arg choice="opt"><replaceable class="option">OPTIONS</replaceable></arg>
|
|
|
|
</cmdsynopsis>
|
|
|
|
</refsynopsisdiv>
|
2005-07-20 00:43:38 +00:00
|
|
|
|
|
|
|
<refsect1>
|
|
|
|
<title>Description</title>
|
|
|
|
<para>
|
2011-08-15 08:40:57 +00:00
|
|
|
The <command>opensc-tool</command> utility can be used from the command line to perform
|
|
|
|
miscellaneous smart card operations such as getting the card ATR or
|
2005-07-20 00:43:38 +00:00
|
|
|
sending arbitrary APDU commands to a card.
|
|
|
|
</para>
|
|
|
|
</refsect1>
|
|
|
|
|
|
|
|
<refsect1>
|
|
|
|
<title>Options</title>
|
|
|
|
<para>
|
|
|
|
<variablelist>
|
2016-03-01 10:41:00 +00:00
|
|
|
<varlistentry>
|
|
|
|
<term>
|
|
|
|
<option>--version</option>,
|
|
|
|
</term>
|
|
|
|
<listitem><para>Print the OpenSC package release version.</para></listitem>
|
|
|
|
</varlistentry>
|
2005-07-20 00:43:38 +00:00
|
|
|
<varlistentry>
|
2011-08-15 14:58:01 +00:00
|
|
|
<term>
|
|
|
|
<option>--atr</option>,
|
|
|
|
<option>-a</option>
|
|
|
|
</term>
|
2011-08-21 11:20:28 +00:00
|
|
|
<listitem><para>Print the Answer To Reset (ATR) of the card.
|
|
|
|
Output is in hex byte format</para></listitem>
|
2005-07-20 00:43:38 +00:00
|
|
|
</varlistentry>
|
2009-11-13 14:51:32 +00:00
|
|
|
<varlistentry>
|
2011-08-15 14:58:01 +00:00
|
|
|
<term>
|
2011-08-21 11:20:28 +00:00
|
|
|
<option>--card-driver</option> <replaceable>driver</replaceable>,
|
|
|
|
<option>-c</option> <replaceable>driver</replaceable>
|
2011-08-15 14:58:01 +00:00
|
|
|
</term>
|
2011-08-21 11:20:28 +00:00
|
|
|
<listitem><para>Use the given card driver.
|
|
|
|
The default is auto-detected.</para></listitem>
|
2009-11-13 14:51:32 +00:00
|
|
|
</varlistentry>
|
2018-04-27 07:18:13 +00:00
|
|
|
<varlistentry>
|
|
|
|
<term>
|
|
|
|
<option>--list-algorithms</option>,
|
|
|
|
</term>
|
|
|
|
<listitem><para>Lists algorithms supported by card</para></listitem>
|
|
|
|
</varlistentry>
|
2005-07-20 00:43:38 +00:00
|
|
|
<varlistentry>
|
2011-08-15 14:58:01 +00:00
|
|
|
<term>
|
2011-08-21 11:20:28 +00:00
|
|
|
<option>--info</option>,
|
|
|
|
<option>-i</option>
|
2011-08-15 14:58:01 +00:00
|
|
|
</term>
|
2011-08-21 11:20:28 +00:00
|
|
|
<listitem><para>Print information about OpenSC, such as version and enabled components.</para></listitem>
|
2005-07-20 00:43:38 +00:00
|
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
2011-08-15 14:58:01 +00:00
|
|
|
<term>
|
2011-08-21 11:20:28 +00:00
|
|
|
<option>--list-drivers</option>,
|
|
|
|
<option>-D</option>
|
2011-08-15 14:58:01 +00:00
|
|
|
</term>
|
2011-08-21 11:20:28 +00:00
|
|
|
<listitem><para>List all installed card drivers.</para></listitem>
|
2005-07-20 00:43:38 +00:00
|
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
2011-08-15 14:58:01 +00:00
|
|
|
<term>
|
|
|
|
<option>--list-files</option>,
|
|
|
|
<option>-f</option>
|
|
|
|
</term>
|
2011-08-21 11:20:28 +00:00
|
|
|
<listitem><para>Recursively list all files stored on card.</para></listitem>
|
2005-07-20 00:43:38 +00:00
|
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
2011-08-15 14:58:01 +00:00
|
|
|
<term>
|
|
|
|
<option>--list-readers</option>,
|
|
|
|
<option>-l</option>
|
|
|
|
</term>
|
2011-08-21 11:20:28 +00:00
|
|
|
<listitem><para>List all configured readers.</para></listitem>
|
2005-07-20 00:43:38 +00:00
|
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
2011-08-15 14:58:01 +00:00
|
|
|
<term>
|
2011-08-21 11:20:28 +00:00
|
|
|
<option>--name</option>,
|
|
|
|
<option>-n</option>
|
2011-08-15 14:58:01 +00:00
|
|
|
</term>
|
2011-08-21 11:20:28 +00:00
|
|
|
<listitem><para>Print the name of the inserted card (driver).</para></listitem>
|
2005-07-20 00:43:38 +00:00
|
|
|
</varlistentry>
|
2018-04-27 07:18:13 +00:00
|
|
|
<varlistentry>
|
|
|
|
<term>
|
|
|
|
<option>--get-conf-entry</option> <replaceable>conf</replaceable>,
|
|
|
|
<option>-G</option> <replaceable>conf</replaceable>
|
|
|
|
</term>
|
|
|
|
<listitem><para>Get configuration key, format: section:name:key</para></listitem>
|
|
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<term>
|
|
|
|
<option>--set-conf-entry</option> <replaceable>conf</replaceable>,
|
|
|
|
<option>-S</option> <replaceable>conf</replaceable>
|
|
|
|
</term>
|
|
|
|
<listitem><para>Get configuration key, format: section:name:key:value</para></listitem>
|
|
|
|
</varlistentry>
|
2005-07-20 00:43:38 +00:00
|
|
|
<varlistentry>
|
2011-08-15 14:58:01 +00:00
|
|
|
<term>
|
2018-12-05 00:38:54 +00:00
|
|
|
<option>--reader</option> <replaceable>arg</replaceable>,
|
|
|
|
<option>-r</option> <replaceable>arg</replaceable>
|
2011-08-15 14:58:01 +00:00
|
|
|
</term>
|
2018-05-04 21:22:45 +00:00
|
|
|
<listitem>
|
|
|
|
<para>
|
2018-12-05 00:38:54 +00:00
|
|
|
Number of the reader to use. By default, the first
|
2018-05-04 21:22:45 +00:00
|
|
|
reader with a present card is used. If
|
2018-12-05 00:38:54 +00:00
|
|
|
<replaceable>arg</replaceable> is an ATR, the
|
2018-05-04 21:22:45 +00:00
|
|
|
reader with a matching card will be chosen.
|
|
|
|
</para>
|
|
|
|
</listitem>
|
2005-07-20 00:43:38 +00:00
|
|
|
</varlistentry>
|
2016-08-23 11:25:56 +00:00
|
|
|
<varlistentry>
|
|
|
|
<term>
|
2018-05-26 19:05:55 +00:00
|
|
|
<option>--reset</option> <arg choice="opt"><replaceable>type</replaceable></arg>,
|
2016-08-23 11:25:56 +00:00
|
|
|
</term>
|
|
|
|
<listitem><para>Resets the card in reader.
|
2018-05-26 19:05:55 +00:00
|
|
|
The default reset type is <literal>cold</literal>,
|
|
|
|
but <literal>warm</literal> reset is also possible.</para></listitem>
|
2016-08-23 11:25:56 +00:00
|
|
|
</varlistentry>
|
2005-07-20 00:43:38 +00:00
|
|
|
<varlistentry>
|
2011-08-15 14:58:01 +00:00
|
|
|
<term>
|
2011-08-21 11:20:28 +00:00
|
|
|
<option>--send-apdu</option> <replaceable>apdu</replaceable>,
|
|
|
|
<option>-s</option> <replaceable>apdu</replaceable>
|
2011-08-15 14:58:01 +00:00
|
|
|
</term>
|
2011-08-21 11:20:28 +00:00
|
|
|
<listitem><para>Sends an arbitrary APDU to the card in the format
|
|
|
|
<code>AA:BB:CC:DD:EE:FF...</code>.</para></listitem>
|
2005-07-20 00:43:38 +00:00
|
|
|
</varlistentry>
|
2009-11-13 14:51:32 +00:00
|
|
|
<varlistentry>
|
2011-08-15 14:58:01 +00:00
|
|
|
<term>
|
2011-08-21 11:20:28 +00:00
|
|
|
<option>--serial</option>
|
2011-08-15 14:58:01 +00:00
|
|
|
</term>
|
2011-08-21 11:20:28 +00:00
|
|
|
<listitem><para>Print the card serial number (normally the ICCSN).
|
|
|
|
Output is in hex byte format</para></listitem>
|
2009-11-13 14:51:32 +00:00
|
|
|
</varlistentry>
|
2005-07-20 00:43:38 +00:00
|
|
|
<varlistentry>
|
2011-08-15 14:58:01 +00:00
|
|
|
<term>
|
|
|
|
<option>--verbose</option>,
|
|
|
|
<option>-v</option>
|
|
|
|
</term>
|
2011-08-21 11:20:28 +00:00
|
|
|
<listitem><para>Causes <command>opensc-tool</command> to be more verbose.
|
|
|
|
Specify this flag several times to enable debug output in the opensc library.</para></listitem>
|
|
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<term>
|
|
|
|
<option>--wait</option>,
|
|
|
|
<option>-w</option>
|
|
|
|
</term>
|
|
|
|
<listitem><para>Wait for a card to be inserted.</para></listitem>
|
2005-07-20 00:43:38 +00:00
|
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
|
|
</para>
|
|
|
|
</refsect1>
|
2011-08-15 08:40:57 +00:00
|
|
|
|
2005-07-20 00:43:38 +00:00
|
|
|
<refsect1>
|
|
|
|
<title>See also</title>
|
2011-08-14 20:31:31 +00:00
|
|
|
<para>
|
|
|
|
<citerefentry>
|
|
|
|
<refentrytitle>opensc-explorer</refentrytitle>
|
|
|
|
<manvolnum>1</manvolnum>
|
|
|
|
</citerefentry>
|
|
|
|
</para>
|
2005-07-20 00:43:38 +00:00
|
|
|
</refsect1>
|
|
|
|
|
2018-05-08 06:25:15 +00:00
|
|
|
<refsect1>
|
|
|
|
<title>Authors</title>
|
|
|
|
<para><command>opensc-tool</command> was written by
|
|
|
|
Juha Yrjölä <email>juha.yrjola@iki.fi</email>.</para>
|
|
|
|
</refsect1>
|
|
|
|
|
2005-07-20 00:43:38 +00:00
|
|
|
</refentry>
|