xref: /freebsd/crypto/openssl/doc/man1/openssl-crl.pod.in (revision 0fca6ea1d4eea4c934cfff25ac9ee8ad6fe95583)
1=pod
2{- OpenSSL::safe::output_do_not_edit_headers(); -}
3
4=head1 NAME
5
6openssl-crl - CRL command
7
8=head1 SYNOPSIS
9
10B<openssl> B<crl>
11[B<-help>]
12[B<-inform> B<DER>|B<PEM>]
13[B<-outform> B<DER>|B<PEM>]
14[B<-key> I<filename>]
15[B<-keyform> B<DER>|B<PEM>|B<P12>]
16[B<-dateopt>]
17[B<-text>]
18[B<-in> I<filename>]
19[B<-out> I<filename>]
20[B<-gendelta> I<filename>]
21[B<-badsig>]
22[B<-verify>]
23[B<-noout>]
24[B<-hash>]
25[B<-hash_old>]
26[B<-fingerprint>]
27[B<-crlnumber>]
28[B<-issuer>]
29[B<-lastupdate>]
30[B<-nextupdate>]
31{- $OpenSSL::safe::opt_name_synopsis -}
32{- $OpenSSL::safe::opt_trust_synopsis -}
33{- $OpenSSL::safe::opt_provider_synopsis -}
34
35=head1 DESCRIPTION
36
37This command processes CRL files in DER or PEM format.
38
39=head1 OPTIONS
40
41=over 4
42
43=item B<-help>
44
45Print out a usage message.
46
47=item B<-inform> B<DER>|B<PEM>
48
49The CRL input format; unspecified by default.
50See L<openssl-format-options(1)> for details.
51
52=item B<-outform> B<DER>|B<PEM>
53
54The CRL output format; the default is B<PEM>.
55See L<openssl-format-options(1)> for details.
56
57=item B<-key> I<filename>
58
59The private key to be used to sign the CRL.
60
61=item B<-keyform> B<DER>|B<PEM>|B<P12>
62
63The format of the private key file; unspecified by default.
64See L<openssl-format-options(1)> for details.
65
66=item B<-in> I<filename>
67
68This specifies the input filename to read from or standard input if this
69option is not specified.
70
71=item B<-out> I<filename>
72
73Specifies the output filename to write to or standard output by
74default.
75
76=item B<-gendelta> I<filename>
77
78Output a comparison of the main CRL and the one specified here.
79
80=item B<-badsig>
81
82Corrupt the signature before writing it; this can be useful
83for testing.
84
85=item B<-dateopt>
86
87Specify the date output format. Values are: rfc_822 and iso_8601.
88Defaults to rfc_822.
89
90=item B<-text>
91
92Print out the CRL in text form.
93
94=item B<-verify>
95
96Verify the signature in the CRL.
97
98This option is implicitly enabled if any of B<-CApath>, B<-CAfile>
99or B<-CAstore> is specified.
100
101=item B<-noout>
102
103Don't output the encoded version of the CRL.
104
105=item B<-fingerprint>
106
107Output the fingerprint of the CRL.
108
109=item B<-crlnumber>
110
111Output the number of the CRL.
112
113=item B<-hash>
114
115Output a hash of the issuer name. This can be use to lookup CRLs in
116a directory by issuer name.
117
118=item B<-hash_old>
119
120Outputs the "hash" of the CRL issuer name using the older algorithm
121as used by OpenSSL before version 1.0.0.
122
123=item B<-issuer>
124
125Output the issuer name.
126
127=item B<-lastupdate>
128
129Output the lastUpdate field.
130
131=item B<-nextupdate>
132
133Output the nextUpdate field.
134
135{- $OpenSSL::safe::opt_name_item -}
136
137{- $OpenSSL::safe::opt_trust_item -}
138
139{- $OpenSSL::safe::opt_provider_item -}
140
141=back
142
143=head1 EXAMPLES
144
145Convert a CRL file from PEM to DER:
146
147 openssl crl -in crl.pem -outform DER -out crl.der
148
149Output the text form of a DER encoded certificate:
150
151 openssl crl -in crl.der -text -noout
152
153=head1 BUGS
154
155Ideally it should be possible to create a CRL using appropriate options
156and files too.
157
158=head1 SEE ALSO
159
160L<openssl(1)>,
161L<openssl-crl2pkcs7(1)>,
162L<openssl-ca(1)>,
163L<openssl-x509(1)>,
164L<ossl_store-file(7)>
165
166=head1 COPYRIGHT
167
168Copyright 2000-2024 The OpenSSL Project Authors. All Rights Reserved.
169
170Licensed under the Apache License 2.0 (the "License").  You may not use
171this file except in compliance with the License.  You can obtain a copy
172in the file LICENSE in the source distribution or at
173L<https://www.openssl.org/source/license.html>.
174
175=cut
176