<html xmlns="http://www.w3.org/1999/xhtml" xmlns:html="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>
Tools – OpenSC
</title><style type="text/css">
@import url(trac.css);
</style></head><body><div id="content" class="wiki">
<div class="wikipage searchable">
<h1 id="OpenSCtools">OpenSC tools</h1>
<p>
OpenSC includes a number of command line tools to personalize, explore, debug and test smart cards. The tools are (with links to the online man pages):
</p>
<h2 id="lowleveltools">low level tools</h2>
<ul><li><a href="http://www.opensc-project.org/doc/opensc/html/tools.html#opensc-tool" shape="rect">opensc-tool</a> is the basic test tool. With "-l" you can see the readers, with "-n" you can see if opensc identifies the card correctly. Both are necessary for OpenSC to work.
</li><li><a href="http://www.opensc-project.org/doc/opensc/html/tools.html#opensc-explorer" shape="rect">opensc-explorer</a> is a small tool so you can browse your smart card with commands like ls, get information about files, read and write files and so on. Only works on some cards, as not all cards have the required functionality (for example no "ls"/"dir" command). Use pkcs15-tool (below) instead.
</li></ul><h2 id="highleveltools">high level tools</h2>
<ul><li><a href="http://www.opensc-project.org/doc/opensc/html/tools.html#pkcs15-init" shape="rect">pkcs15-init</a> can erase your smart card, initialize it, create pins, generate keys, store certificates and keys or complete p12 bundle files on the card.
</li><li><a href="http://www.opensc-project.org/doc/opensc/html/tools.html#pkcs15-tool" shape="rect">pkcs15-tool</a> will show you what is on your card, lets you browse pins, certificates and keys, and lets you unblock and change pins.
</li><li><a href="http://www.opensc-project.org/doc/opensc/html/tools.html#pkcs15-crypt" shape="rect">pkcs15-crypt</a> offers access to the crypto functionality, such as signing data or decrypting data.
</li><li><a href="http://www.opensc-project.org/doc/opensc/html/tools.html#pkcs11-tool" shape="rect">pkcs11-tool</a> does all these things too, but uses the OpenSC PKCS#11 module. As such it works like mozilla and thus is nice for testing. It also has a test mode to check most operations. pkcs11-tool uses OpenSC PKCS#11 module by default, but will work well with any other PKCS#11 implementation specified with "--module", too.
</li></ul><h2 id="cardspecifictools">card specific tools</h2>
<ul><li><a href="http://www.opensc-project.org/doc/opensc/html/tools.html#cardos-info" shape="rect">cardos-info</a> prints some information for Siemens CardOS/M4 cards. will not work at all with other cards.
</li><li><a href="http://www.opensc-project.org/doc/opensc/html/tools.html#cryptoflex-tool" shape="rect">cryptoflex-tool</a> can help you with cryptoflex cards, will not work with any other card.
</li><li><a href="http://www.opensc-project.org/doc/opensc/html/tools.html#eidenv" shape="rect">eidenv</a> lets you access the extra data on belgian eid cards, like card holder, photo, etc.
</li><li><a href="http://www.opensc-project.org/doc/opensc/html/tools.html#netkey-tool" shape="rect">netkey-tool</a> can help you with tcos cards in netkey format. will not work with any other card.
</li><li><a class="wiki" href="PivTool.html" shape="rect">piv-tool</a> used to do primative card administration operations on PIV cards. Some vendor's cards may have additional functions not handled by the piv-tool.
</li></ul><h2 id="developmenttools">development tools</h2>
<ul><li>(DEPRECATED) <a href="http://www.opensc-project.org/doc/opensc/html/tools.html#opensc-config" shape="rect">opensc-config</a> was meant to ease developing with opensc, but now we recommend to use pkg-config instead. Only provided for backwards compatibility.
</li></ul>
</div>
</div><div class="footer"><hr></hr><p><a href="index.html">Back to Index</a></p></div></body></html>
