openssl-prebuild/linux_amd64/share/doc/openssl/html/man1/crl2pkcs7.html

150 lines
4.9 KiB
HTML

<?xml version="1.0" ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>crl2pkcs7</title>
<meta http-equiv="content-type" content="text/html; charset=utf-8" />
<link rev="made" href="mailto:root@localhost" />
</head>
<body style="background-color: white">
<!-- INDEX BEGIN -->
<div name="index">
<p><a name="__index__"></a></p>
<ul>
<li><a href="#name">NAME</a></li>
<li><a href="#synopsis">SYNOPSIS</a></li>
<li><a href="#description">DESCRIPTION</a></li>
<li><a href="#options">OPTIONS</a></li>
<li><a href="#examples">EXAMPLES</a></li>
<li><a href="#notes">NOTES</a></li>
<li><a href="#see_also">SEE ALSO</a></li>
<li><a href="#copyright">COPYRIGHT</a></li>
</ul>
<hr name="index" />
</div>
<!-- INDEX END -->
<p>
</p>
<hr />
<h1><a name="name">NAME</a></h1>
<p>openssl-crl2pkcs7,
crl2pkcs7 - Create a PKCS#7 structure from a CRL and certificates</p>
<p>
</p>
<hr />
<h1><a name="synopsis">SYNOPSIS</a></h1>
<p><strong>openssl</strong> <strong>crl2pkcs7</strong>
[<strong>-help</strong>]
[<strong>-inform PEM|DER</strong>]
[<strong>-outform PEM|DER</strong>]
[<strong>-in filename</strong>]
[<strong>-out filename</strong>]
[<strong>-certfile filename</strong>]
[<strong>-nocrl</strong>]</p>
<p>
</p>
<hr />
<h1><a name="description">DESCRIPTION</a></h1>
<p>The <strong>crl2pkcs7</strong> command takes an optional CRL and one or more
certificates and converts them into a PKCS#7 degenerate &quot;certificates
only&quot; structure.</p>
<p>
</p>
<hr />
<h1><a name="options">OPTIONS</a></h1>
<dl>
<dt><strong><a name="help" class="item"><strong>-help</strong></a></strong></dt>
<dd>
<p>Print out a usage message.</p>
</dd>
<dt><strong><a name="inform_der_pem" class="item"><strong>-inform DER|PEM</strong></a></strong></dt>
<dd>
<p>This specifies the CRL input format. <strong>DER</strong> format is DER encoded CRL
structure.<strong>PEM</strong> (the default) is a base64 encoded version of
the DER form with header and footer lines. The default format is PEM.</p>
</dd>
<dt><strong><a name="outform_der_pem" class="item"><strong>-outform DER|PEM</strong></a></strong></dt>
<dd>
<p>This specifies the PKCS#7 structure output format. <strong>DER</strong> format is DER
encoded PKCS#7 structure.<strong>PEM</strong> (the default) is a base64 encoded version of
the DER form with header and footer lines. The default format is PEM.</p>
</dd>
<dt><strong><a name="in_filename" class="item"><strong>-in filename</strong></a></strong></dt>
<dd>
<p>This specifies the input filename to read a CRL from or standard input if this
option is not specified.</p>
</dd>
<dt><strong><a name="out_filename" class="item"><strong>-out filename</strong></a></strong></dt>
<dd>
<p>Specifies the output filename to write the PKCS#7 structure to or standard
output by default.</p>
</dd>
<dt><strong><a name="certfile_filename" class="item"><strong>-certfile filename</strong></a></strong></dt>
<dd>
<p>Specifies a filename containing one or more certificates in <strong>PEM</strong> format.
All certificates in the file will be added to the PKCS#7 structure. This
option can be used more than once to read certificates form multiple
files.</p>
</dd>
<dt><strong><a name="nocrl" class="item"><strong>-nocrl</strong></a></strong></dt>
<dd>
<p>Normally a CRL is included in the output file. With this option no CRL is
included in the output file and a CRL is not read from the input file.</p>
</dd>
</dl>
<p>
</p>
<hr />
<h1><a name="examples">EXAMPLES</a></h1>
<p>Create a PKCS#7 structure from a certificate and CRL:</p>
<pre>
openssl crl2pkcs7 -in crl.pem -certfile cert.pem -out p7.pem</pre>
<p>Creates a PKCS#7 structure in DER format with no CRL from several
different certificates:</p>
<pre>
openssl crl2pkcs7 -nocrl -certfile newcert.pem
-certfile demoCA/cacert.pem -outform DER -out p7.der</pre>
<p>
</p>
<hr />
<h1><a name="notes">NOTES</a></h1>
<p>The output file is a PKCS#7 signed data structure containing no signers and
just certificates and an optional CRL.</p>
<p>This utility can be used to send certificates and CAs to Netscape as part of
the certificate enrollment process. This involves sending the DER encoded output
as MIME type application/x-x509-user-cert.</p>
<p>The <strong>PEM</strong> encoded form with the header and footer lines removed can be used to
install user certificates and CAs in MSIE using the Xenroll control.</p>
<p>
</p>
<hr />
<h1><a name="see_also">SEE ALSO</a></h1>
<p><em>pkcs7(1)</em></p>
<p>
</p>
<hr />
<h1><a name="copyright">COPYRIGHT</a></h1>
<p>Copyright 2000-2017 The OpenSSL Project Authors. All Rights Reserved.</p>
<p>Licensed under the OpenSSL license (the &quot;License&quot;). You may not use
this file except in compliance with the License. You can obtain a copy
in the file LICENSE in the source distribution or at
<a href="https://www.openssl.org/source/license.html">https://www.openssl.org/source/license.html</a>.</p>
</body>
</html>