Debian Codegraph @

upstream/debian-unstable/man1/openssl-crl.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-CRL 1SSL"
58 .TH OPENSSL-CRL 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\-crl \- CRL command
65 .SH SYNOPSIS
66 .IX Header "SYNOPSIS"
67 \&\fBopenssl\fR \fBcrl\fR
68 [\fB\-help\fR]
69 [\fB\-inform\fR \fBDER\fR|\fBPEM\fR]
70 [\fB\-outform\fR \fBDER\fR|\fBPEM\fR]
71 [\fB\-key\fR \fIfilename\fR]
72 [\fB\-keyform\fR \fBDER\fR|\fBPEM\fR|\fBP12\fR]
73 [\fB\-dateopt\fR]
74 [\fB\-text\fR]
75 [\fB\-in\fR \fIfilename\fR]
76 [\fB\-out\fR \fIfilename\fR]
77 [\fB\-gendelta\fR \fIfilename\fR]
78 [\fB\-badsig\fR]
79 [\fB\-verify\fR]
80 [\fB\-noout\fR]
81 [\fB\-hash\fR]
82 [\fB\-hash_old\fR]
83 [\fB\-fingerprint\fR]
84 [\fB\-crlnumber\fR]
85 [\fB\-issuer\fR]
86 [\fB\-lastupdate\fR]
87 [\fB\-nextupdate\fR]
88 [\fB\-nameopt\fR \fIoption\fR]
89 [\fB\-CAfile\fR \fIfile\fR]
90 [\fB\-no\-CAfile\fR]
91 [\fB\-CApath\fR \fIdir\fR]
92 [\fB\-no\-CApath\fR]
93 [\fB\-CAstore\fR \fIuri\fR]
94 [\fB\-no\-CAstore\fR]
95 [\fB\-provider\fR \fIname\fR]
96 [\fB\-provider\-path\fR \fIpath\fR]
97 [\fB\-provparam\fR \fI[name:]key=value\fR]
98 [\fB\-propquery\fR \fIpropq\fR]
99 .SH DESCRIPTION
100 .IX Header "DESCRIPTION"
101 This command processes CRL files in DER or PEM format.
102 .SH OPTIONS
103 .IX Header "OPTIONS"
104 .IP \fB\-help\fR 4
105 .IX Item "-help"
106 Print out a usage message.
107 .IP "\fB\-inform\fR \fBDER\fR|\fBPEM\fR" 4
108 .IX Item "-inform DER|PEM"
109 The CRL input format; unspecified by default.
110 See \fBopenssl\-format\-options\fR\|(1) for details.
111 .IP "\fB\-outform\fR \fBDER\fR|\fBPEM\fR" 4
112 .IX Item "-outform DER|PEM"
113 The CRL output format; the default is \fBPEM\fR.
114 See \fBopenssl\-format\-options\fR\|(1) for details.
115 .IP "\fB\-key\fR \fIfilename\fR" 4
116 .IX Item "-key filename"
117 The private key to be used to sign the CRL.
118 .IP "\fB\-keyform\fR \fBDER\fR|\fBPEM\fR|\fBP12\fR" 4
119 .IX Item "-keyform DER|PEM|P12"
120 The format of the private key file; unspecified by default.
121 See \fBopenssl\-format\-options\fR\|(1) for details.
122 .IP "\fB\-in\fR \fIfilename\fR" 4
123 .IX Item "-in filename"
124 This specifies the input filename to read from or standard input if this
125 option is not specified.
126 .IP "\fB\-out\fR \fIfilename\fR" 4
127 .IX Item "-out filename"
128 Specifies the output filename to write to or standard output by
129 default.
130 .IP "\fB\-gendelta\fR \fIfilename\fR" 4
131 .IX Item "-gendelta filename"
132 Output a comparison of the main CRL and the one specified here.
133 .IP \fB\-badsig\fR 4
134 .IX Item "-badsig"
135 Corrupt the signature before writing it; this can be useful
136 for testing.
137 .IP \fB\-dateopt\fR 4
138 .IX Item "-dateopt"
139 Specify the date output format. Values are: rfc_822 and iso_8601.
140 Defaults to rfc_822.
141 .IP \fB\-text\fR 4
142 .IX Item "-text"
143 Print out the CRL in text form.
144 .IP \fB\-verify\fR 4
145 .IX Item "-verify"
146 Verify the signature in the CRL. If the verification fails,
147 the program will immediately exit, i.e. further option processing
148 (e.g. \fB\-gendelta\fR) is skipped.
149 .Sp
150 This option is implicitly enabled if any of \fB\-CApath\fR, \fB\-CAfile\fR
151 or \fB\-CAstore\fR is specified.
152 .IP \fB\-noout\fR 4
153 .IX Item "-noout"
154 Don't output the encoded version of the CRL.
155 .IP \fB\-fingerprint\fR 4
156 .IX Item "-fingerprint"
157 Output the fingerprint of the CRL.
158 .IP \fB\-crlnumber\fR 4
159 .IX Item "-crlnumber"
160 Output the number of the CRL.
161 .IP \fB\-hash\fR 4
162 .IX Item "-hash"
163 Output a hash of the issuer name. This can be use to lookup CRLs in
164 a directory by issuer name.
165 .IP \fB\-hash_old\fR 4
166 .IX Item "-hash_old"
167 Outputs the "hash" of the CRL issuer name using the older algorithm
168 as used by OpenSSL before version 1.0.0.
169 .IP \fB\-issuer\fR 4
170 .IX Item "-issuer"
171 Output the issuer name.
172 .IP \fB\-lastupdate\fR 4
173 .IX Item "-lastupdate"
174 Output the lastUpdate field.
175 .IP \fB\-nextupdate\fR 4
176 .IX Item "-nextupdate"
177 Output the nextUpdate field.
178 .IP "\fB\-nameopt\fR \fIoption\fR" 4
179 .IX Item "-nameopt option"
180 This specifies how the subject or issuer names are displayed.
181 See \fBopenssl\-namedisplay\-options\fR\|(1) for details.
182 .IP "\fB\-CAfile\fR \fIfile\fR, \fB\-no\-CAfile\fR, \fB\-CApath\fR \fIdir\fR, \fB\-no\-CApath\fR, \fB\-CAstore\fR \fIuri\fR, \fB\-no\-CAstore\fR" 4
183 .IX Item "-CAfile file, -no-CAfile, -CApath dir, -no-CApath, -CAstore uri, -no-CAstore"
184 See "Trusted Certificate Options" in \fBopenssl\-verification\-options\fR\|(1) for details.
185 .IP "\fB\-provider\fR \fIname\fR" 4
186 .IX Item "-provider name"
187 .PD 0
188 .IP "\fB\-provider\-path\fR \fIpath\fR" 4
189 .IX Item "-provider-path path"
190 .IP "\fB\-provparam\fR \fI[name:]key=value\fR" 4
191 .IX Item "-provparam [name:]key=value"
192 .IP "\fB\-propquery\fR \fIpropq\fR" 4
193 .IX Item "-propquery propq"
194 .PD
195 See "Provider Options" in \fBopenssl\fR\|(1), \fBprovider\fR\|(7), and \fBproperty\fR\|(7).
196 .SH EXAMPLES
197 .IX Header "EXAMPLES"
198 Convert a CRL file from PEM to DER:
199 .PP
200 .Vb 1
201 \& openssl crl \-in crl.pem \-outform DER \-out crl.der
202 .Ve
203 .PP
204 Output the text form of a DER encoded certificate:
205 .PP
206 .Vb 1
207 \& openssl crl \-in crl.der \-text \-noout
208 .Ve
209 .SH BUGS
210 .IX Header "BUGS"
211 Ideally it should be possible to create a CRL using appropriate options
212 and files too.
213 .SH "SEE ALSO"
214 .IX Header "SEE ALSO"
215 \&\fBopenssl\fR\|(1),
216 \&\fBopenssl\-crl2pkcs7\fR\|(1),
217 \&\fBopenssl\-ca\fR\|(1),
218 \&\fBopenssl\-x509\fR\|(1),
219 \&\fBossl_store\-file\fR\|(7)
220 .SH HISTORY
221 .IX Header "HISTORY"
222 Since OpenSSL 3.3, the \fB\-verify\fR option will exit with 1 on failure.
223 .SH COPYRIGHT
224 .IX Header "COPYRIGHT"
225 Copyright 2000\-2024 The OpenSSL Project Authors. All Rights Reserved.
226 .PP
227 Licensed under the Apache License 2.0 (the "License"). You may not use
228 this file except in compliance with the License. You can obtain a copy
229 in the file LICENSE in the source distribution or at
230 <https://www.openssl.org/source/license.html>.