Debian Codegraph @

upstream/debian-unstable/man1/openssl-crl2pkcs7.1ssl

raw
1 .\" -*- mode: troff; coding: utf-8 -*-
2 .\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
3 .\"
4 .\" Standard preamble:
5 .\" ========================================================================
6 .de Sp \" Vertical space (when we can't use .PP)
7 .if t .sp .5v
8 .if n .sp
9 ..
10 .de Vb \" Begin verbatim text
11 .ft CW
12 .nf
13 .ne \\$1
14 ..
15 .de Ve \" End verbatim text
16 .ft R
17 .fi
18 ..
19 .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
20 .ie n \{\
21 . ds C` ""
22 . ds C' ""
23 'br\}
24 .el\{\
25 . ds C`
26 . ds C'
27 'br\}
28 .\"
29 .\" Escape single quotes in literal strings from groff's Unicode transform.
30 .ie \n(.g .ds Aq \(aq
31 .el .ds Aq '
32 .\"
33 .\" If the F register is >0, we'll generate index entries on stderr for
34 .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
35 .\" entries marked with X<> in POD. Of course, you'll have to process the
36 .\" output yourself in some meaningful fashion.
37 .\"
38 .\" Avoid warning from groff about undefined register 'F'.
39 .de IX
40 ..
41 .nr rF 0
42 .if \n(.g .if rF .nr rF 1
43 .if (\n(rF:(\n(.g==0)) \{\
44 . if \nF \{\
45 . de IX
46 . tm Index:\\$1\t\\n%\t"\\$2"
47 ..
48 . if !\nF==2 \{\
49 . nr % 0
50 . nr F 2
51 . \}
52 . \}
53 .\}
54 .rr rF
55 .\" ========================================================================
56 .\"
57 .IX Title "OPENSSL-CRL2PKCS7 1SSL"
58 .TH OPENSSL-CRL2PKCS7 1SSL 2026-04-07 3.6.2 OpenSSL
59 .\" For nroff, turn off justification. Always turn off hyphenation; it makes
60 .\" way too many mistakes in technical documents.
61 .if n .ad l
62 .nh
63 .SH NAME
64 openssl\-crl2pkcs7 \- Create a PKCS#7 structure from a CRL and certificates
65 .SH SYNOPSIS
66 .IX Header "SYNOPSIS"
67 \&\fBopenssl\fR \fBcrl2pkcs7\fR
68 [\fB\-help\fR]
69 [\fB\-inform\fR \fBDER\fR|\fBPEM\fR]
70 [\fB\-outform\fR \fBDER\fR|\fBPEM\fR]
71 [\fB\-in\fR \fIfilename\fR]
72 [\fB\-out\fR \fIfilename\fR]
73 [\fB\-certfile\fR \fIfilename\fR]
74 [\fB\-nocrl\fR]
75 [\fB\-provider\fR \fIname\fR]
76 [\fB\-provider\-path\fR \fIpath\fR]
77 [\fB\-provparam\fR \fI[name:]key=value\fR]
78 [\fB\-propquery\fR \fIpropq\fR]
79 .SH DESCRIPTION
80 .IX Header "DESCRIPTION"
81 This command takes an optional CRL and one or more
82 certificates and converts them into a PKCS#7 degenerate "certificates
83 only" structure.
84 .SH OPTIONS
85 .IX Header "OPTIONS"
86 .IP \fB\-help\fR 4
87 .IX Item "-help"
88 Print out a usage message.
89 .IP "\fB\-inform\fR \fBDER\fR|\fBPEM\fR" 4
90 .IX Item "-inform DER|PEM"
91 The input format of the CRL; the default is \fBPEM\fR.
92 See \fBopenssl\-format\-options\fR\|(1) for details.
93 .IP "\fB\-outform\fR \fBDER\fR|\fBPEM\fR" 4
94 .IX Item "-outform DER|PEM"
95 The output format of the PKCS#7 object; the default is \fBPEM\fR.
96 See \fBopenssl\-format\-options\fR\|(1) for details.
97 .IP "\fB\-in\fR \fIfilename\fR" 4
98 .IX Item "-in filename"
99 This specifies the input filename to read a CRL from or standard input if this
100 option is not specified.
101 .IP "\fB\-out\fR \fIfilename\fR" 4
102 .IX Item "-out filename"
103 Specifies the output filename to write the PKCS#7 structure to or standard
104 output by default.
105 .IP "\fB\-certfile\fR \fIfilename\fR" 4
106 .IX Item "-certfile filename"
107 Specifies a filename containing one or more certificates in \fBPEM\fR format.
108 All certificates in the file will be added to the PKCS#7 structure. This
109 option can be used more than once to read certificates from multiple
110 files.
111 .IP \fB\-nocrl\fR 4
112 .IX Item "-nocrl"
113 Normally a CRL is included in the output file. With this option no CRL is
114 included in the output file and a CRL is not read from the input file.
115 .IP "\fB\-provider\fR \fIname\fR" 4
116 .IX Item "-provider name"
117 .PD 0
118 .IP "\fB\-provider\-path\fR \fIpath\fR" 4
119 .IX Item "-provider-path path"
120 .IP "\fB\-provparam\fR \fI[name:]key=value\fR" 4
121 .IX Item "-provparam [name:]key=value"
122 .IP "\fB\-propquery\fR \fIpropq\fR" 4
123 .IX Item "-propquery propq"
124 .PD
125 See "Provider Options" in \fBopenssl\fR\|(1), \fBprovider\fR\|(7), and \fBproperty\fR\|(7).
126 .SH EXAMPLES
127 .IX Header "EXAMPLES"
128 Create a PKCS#7 structure from a certificate and CRL:
129 .PP
130 .Vb 1
131 \& openssl crl2pkcs7 \-in crl.pem \-certfile cert.pem \-out p7.pem
132 .Ve
133 .PP
134 Creates a PKCS#7 structure in DER format with no CRL from several
135 different certificates:
136 .PP
137 .Vb 2
138 \& openssl crl2pkcs7 \-nocrl \-certfile newcert.pem
139 \& \-certfile demoCA/cacert.pem \-outform DER \-out p7.der
140 .Ve
141 .SH NOTES
142 .IX Header "NOTES"
143 The output file is a PKCS#7 signed data structure containing no signers and
144 just certificates and an optional CRL.
145 .PP
146 This command can be used to send certificates and CAs to Netscape as part of
147 the certificate enrollment process. This involves sending the DER encoded output
148 as MIME type application/x\-x509\-user\-cert.
149 .PP
150 The \fBPEM\fR encoded form with the header and footer lines removed can be used to
151 install user certificates and CAs in MSIE using the Xenroll control.
152 .SH "SEE ALSO"
153 .IX Header "SEE ALSO"
154 \&\fBopenssl\fR\|(1),
155 \&\fBopenssl\-pkcs7\fR\|(1)
156 .SH COPYRIGHT
157 .IX Header "COPYRIGHT"
158 Copyright 2000\-2021 The OpenSSL Project Authors. All Rights Reserved.
159 .PP
160 Licensed under the Apache License 2.0 (the "License"). You may not use
161 this file except in compliance with the License. You can obtain a copy
162 in the file LICENSE in the source distribution or at
163 <https://www.openssl.org/source/license.html>.