5785N/A - Copyright (C) 2000-2015 Internet Systems Consortium, Inc. ("ISC") 5785N/A - This Source Code Form is subject to the terms of the Mozilla Public 5785N/A - License, v. 2.0. If a copy of the MPL was not distributed with this 5785N/A<
meta http-
equiv="Content-Type" content="text/html; charset=ISO-8859-1">
6982N/A<
title>pkcs11-keygen</
title>
6982N/A<
meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
6982N/A<
body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
6982N/A<
table width="100%" summary="Navigation header">
5785N/A<
tr><
th colspan="3" align="center"><
span class="application">pkcs11-keygen</
span></
th></
tr>
5785N/A<
td width="20%" align="left">
5785N/A<
th width="60%" align="center">Manual pages</
th>
5785N/A<
p><
span class="application">pkcs11-keygen</
span> — generate keys on a PKCS#11 device</
p>
5785N/A<
div class="refsynopsisdiv">
5785N/A<
div class="cmdsynopsis"><
p><
code class="command">pkcs11-keygen</
code> {-a <
em class="replaceable"><
code>algorithm</
code></
em>} [<
code class="option">-b <
em class="replaceable"><
code>keysize</
code></
em></
code>] [<
code class="option">-e</
code>] [<
code class="option">-i <
em class="replaceable"><
code>id</
code></
em></
code>] [<
code class="option">-m <
em class="replaceable"><
code>module</
code></
em></
code>] [<
code class="option">-P</
code>] [<
code class="option">-p <
em class="replaceable"><
code>PIN</
code></
em></
code>] [<
code class="option">-q</
code>] [<
code class="option">-S</
code>] [<
code class="option">-s <
em class="replaceable"><
code>slot</
code></
em></
code>] {label}</
p></
div>
5785N/A<
a name="id-1.14.36.7"></
a><
h2>DESCRIPTION</
h2>
5785N/A <
span class="command"><
strong>pkcs11-keygen</
strong></
span> causes a PKCS#11 device to generate
5785N/A a new key pair with the given <
code class="option">label</
code> (which must be
5785N/A unique) and with <
code class="option">keysize</
code> bits of prime.
5785N/A<
a name="id-1.14.36.8"></
a><
h2>ARGUMENTS</
h2>
5785N/A<
div class="variablelist"><
dl class="variablelist">
5785N/A<
dt><
span class="term">-a <
em class="replaceable"><
code>algorithm</
code></
em></
span></
dt>
5785N/A Specify the key algorithm class: Supported classes are RSA,
5785N/A DSA, DH, and ECC. In addition to these strings, the
5785N/A <
code class="option">algorithm</
code> can be specified as a DNSSEC
5785N/A signing algorithm that will be used with this key; for
5785N/A example, NSEC3RSASHA1 maps to RSA, and ECDSAP256SHA256 maps
5785N/A to ECC. The default class is "RSA".
5785N/A<
dt><
span class="term">-b <
em class="replaceable"><
code>keysize</
code></
em></
span></
dt>
5785N/A Create the key pair with <
code class="option">keysize</
code> bits of
5785N/A prime. For ECC keys, the only valid values are 256 and 384,
5785N/A<
dt><
span class="term">-e</
span></
dt>
5785N/A For RSA keys only, use a large exponent.
5785N/A<
dt><
span class="term">-i <
em class="replaceable"><
code>id</
code></
em></
span></
dt>
5785N/A Create key objects with id. The id is either
5785N/A an unsigned short 2 byte or an unsigned long 4 byte number.
5785N/A<
dt><
span class="term">-m <
em class="replaceable"><
code>module</
code></
em></
span></
dt>
5785N/A Specify the PKCS#11 provider module. This must be the full
5785N/A path to a shared library object implementing the PKCS#11 API
5785N/A<
dt><
span class="term">-P</
span></
dt>
5785N/A Set the new private key to be non-sensitive and extractable.
5785N/A The allows the private key data to be read from the PKCS#11
5785N/A device. The default is for private keys to be sensitive and
5785N/A<
dt><
span class="term">-p <
em class="replaceable"><
code>PIN</
code></
em></
span></
dt>
5785N/A Specify the PIN for the device. If no PIN is provided on
5785N/A the command line, <
span class="command"><
strong>pkcs11-keygen</
strong></
span> will
5785N/A<
dt><
span class="term">-q</
span></
dt>
5785N/A Quiet mode: suppress unnecessary output.
5785N/A<
dt><
span class="term">-S</
span></
dt>
5785N/A For Diffie-Hellman (DH) keys only, use a special prime of
5785N/A 768, 1024 or 1536 bit size and base (aka generator) 2.
5785N/A If not specified, bit size will default to 1024.
5785N/A<
dt><
span class="term">-s <
em class="replaceable"><
code>slot</
code></
em></
span></
dt>
5785N/A Open the session with the given PKCS#11 slot. The default is
5785N/A<
a name="id-1.14.36.9"></
a><
h2>SEE ALSO</
h2>
5785N/A <
span class="citerefentry"><
span class="refentrytitle">pkcs11-destroy</
span>(8)</
span>,
5785N/A <
span class="citerefentry"><
span class="refentrytitle">pkcs11-list</
span>(8)</
span>,
5785N/A <
span class="citerefentry"><
span class="refentrytitle">pkcs11-tokens</
span>(8)</
span>,
5785N/A <
span class="citerefentry"><
span class="refentrytitle">dnssec-keyfromlabel</
span>(8)</
span>
5785N/A<
table width="100%" summary="Navigation footer">
5785N/A<
td width="40%" align="left">
5785N/A<
td width="40%" align="left" valign="top">
5785N/A<
span class="application">pkcs11-list</
span>�</
td>
5785N/A<
td width="40%" align="right" valign="top">�<
span class="application">pkcs11-tokens</
span>