Use a function to generate do-not-edit comment
[oweals/openssl.git] / doc / man1 / openssl-crl.pod.in
1 =pod
2 {- OpenSSL::safe::output_do_not_edit_headers(); -}
3
4 =head1 NAME
5
6 openssl-crl - CRL utility
7
8 =head1 SYNOPSIS
9
10 B<openssl> B<crl>
11 [B<-help>]
12 [B<-inform> B<DER>|B<PEM>]
13 [B<-outform> B<DER>|B<PEM>]
14 [B<-keyform> B<DER>|B<PEM>|B<ENGINE>]
15 [B<-text>]
16 [B<-in> I<filename>]
17 [B<-out> I<filename>]
18 [B<-nameopt> I<option>]
19 [B<-noout>]
20 [B<-hash>]
21 [B<-issuer>]
22 [B<-lastupdate>]
23 [B<-nextupdate>]
24 {- $OpenSSL::safe::opt_trust_synopsis -}
25
26 =for openssl ifdef hash_old
27
28 =head1 DESCRIPTION
29
30 This command processes CRL files in DER or PEM format.
31
32 =head1 OPTIONS
33
34 =over 4
35
36 =item B<-help>
37
38 Print out a usage message.
39
40 =item B<-inform> B<DER>|B<PEM>, B<-outform> B<DER>|B<PEM>
41
42 The input and output formats of the CRL; the default is B<PEM>.
43 See L<openssl(1)/Format Options> for details.
44
45 =item B<-keyform> B<DER>|B<PEM>|B<ENGINE>
46
47 The format of the private key file; the default is B<PEM>.
48 See L<openssl(1)/Format Options> for details.
49
50 =item B<-in> I<filename>
51
52 This specifies the input filename to read from or standard input if this
53 option is not specified.
54
55 =item B<-out> I<filename>
56
57 Specifies the output filename to write to or standard output by
58 default.
59
60 =item B<-text>
61
62 Print out the CRL in text form.
63
64 =item B<-nameopt> I<option>
65
66 Option which determines how the subject or issuer names are displayed. See
67 the description of B<-nameopt> in L<openssl-x509(1)>.
68
69 =item B<-noout>
70
71 Don't output the encoded version of the CRL.
72
73 =item B<-hash>
74
75 Output a hash of the issuer name. This can be use to lookup CRLs in
76 a directory by issuer name.
77
78 =item B<-hash_old>
79
80 Outputs the "hash" of the CRL issuer name using the older algorithm
81 as used by OpenSSL before version 1.0.0.
82
83 =item B<-issuer>
84
85 Output the issuer name.
86
87 =item B<-lastupdate>
88
89 Output the lastUpdate field.
90
91 =item B<-nextupdate>
92
93 Output the nextUpdate field.
94
95 {- $OpenSSL::safe::opt_trust_item -}
96
97 =back
98
99 =head1 EXAMPLES
100
101 Convert a CRL file from PEM to DER:
102
103  openssl crl -in crl.pem -outform DER -out crl.der
104
105 Output the text form of a DER encoded certificate:
106
107  openssl crl -in crl.der -inform DER -text -noout
108
109 =head1 BUGS
110
111 Ideally it should be possible to create a CRL using appropriate options
112 and files too.
113
114 =head1 SEE ALSO
115
116 L<openssl(1)>,
117 L<openssl-crl2pkcs7(1)>,
118 L<openssl-ca(1)>,
119 L<openssl-x509(1)>,
120 L<ossl_store-file(7)>
121
122 =head1 COPYRIGHT
123
124 Copyright 2000-2019 The OpenSSL Project Authors. All Rights Reserved.
125
126 Licensed under the Apache License 2.0 (the "License").  You may not use
127 this file except in compliance with the License.  You can obtain a copy
128 in the file LICENSE in the source distribution or at
129 L<https://www.openssl.org/source/license.html>.
130
131 =cut