'\" t
.\" Title: cryptoflex-tool
.\" Author: [see the "Authors" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot
.\" Date: 04/05/2024
.\" Manual: OpenSC Tools
.\" Source: opensc
.\" Language: English
.\"
.TH "CRYPTOFLEX\-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"
cryptoflex-tool \- utility for manipulating Schlumberger Cryptoflex data structures
.SH "SYNOPSIS"
.HP \w'\fBcryptoflex\-tool\fR\ 'u
\fBcryptoflex\-tool\fR [\fIOPTIONS\fR]
.SH "DESCRIPTION"
.PP
\fBcryptoflex\-tool\fR
is used to manipulate PKCS data structures on Schlumberger Cryptoflex smart cards\&. Users can create, list and read PINs and keys stored on the smart card\&. User PIN authentication is performed for those operations that require it\&.
.SH "OPTIONS"
.PP
.PP
\fB\-\-app\-df\fR \fInum\fR, \fB\-a\fR \fInum\fR
.RS 4
Specifies the DF to operate in
.RE
.PP
\fB\-\-create\-key\-files\fR \fIarg\fR, \fB\-c\fR \fIarg\fR
.RS 4
Creates new RSA key files for
\fIarg\fR
keys
.RE
.PP
\fB\-\-create\-pin\-files\fR \fIid\fR, \fB\-P\fR \fIid\fR
.RS 4
Creates new PIN file for CHV\fIid\fR
.RE
.PP
\fB\-\-exponent\fR \fIexp\fR, \fB\-e\fR \fIexp\fR
.RS 4
Specifies the RSA exponent,
\fIexp\fR, to use in key generation\&. The default value is 3\&.
.RE
.PP
\fB\-\-generate\-key\fR, \fB\-g\fR
.RS 4
Generate a new RSA key pair
.RE
.PP
\fB\-\-key\-num\fR \fInum\fR, \fB\-k\fR \fInum\fR
.RS 4
Specifies the key number to operate on\&. The default is key number 1\&.
.RE
.PP
\fB\-\-list\-keys\fR, \fB\-l\fR
.RS 4
Lists all keys stored in a public key file
.RE
.PP
\fB\-\-modulus\-length\fR \fIlength\fR, \fB\-m\fR \fIlength\fR
.RS 4
Specifies the modulus
\fIlength\fR
to use in key generation\&. The default value is 1024\&.
.RE
.PP
\fB\-\-prkey\-file\fR \fIid\fR, \fB\-p\fR \fIid\fR
.RS 4
Specifies the private key file id,
\fIid\fR, to use
.RE
.PP
\fB\-\-pubkey\-file\fR \fIid\fR, \fB\-u\fR \fIid\fR
.RS 4
Specifies the public key file id,
\fIid\fR, to use
.RE
.PP
\fB\-\-read\-key\fR, \fB\-R\fR
.RS 4
Reads a public key from the card, allowing the user to extract and store or use the public key
.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\-\-verbose\fR, \fB\-v\fR
.RS 4
Causes
\fBcryptoflex\-tool\fR
to be more verbose\&. Specify this flag several times to enable debug output in the opensc library\&.
.RE
.PP
\fB\-\-verify\-pin\fR, \fB\-V\fR
.RS 4
Verifies CHV1 before issuing commands
.RE
.PP
\fB\-\-wait\fR, \fB\-w\fR
.RS 4
Causes
\fBcryptoflex\-tool\fR
to wait for a card insertion\&.
.RE
.SH "SEE ALSO"
.PP
\fBpkcs15-tool\fR(1)
.SH "AUTHORS"
.PP
\fBcryptoflex\-tool\fR
was written by Juha Yrjölä
\&.