openssl-crl(1ssl)

openssl-crl1ssl

Crl command

Usage

openssl crl [-help] [{-inform DER | PEM}] [{-outform DER | PEM}] [-key filename] [{-keyform DER | PEM | P12}] [-dateopt] [-text] [-in filename] [-out filename] [-gendelta filename] [-badsig] [-verify] [-noout] [-hash] [-hash_old] [-fingerprint] [-crlnumber] [-issuer] [-lastupdate] [-nextupdate] [-nameopt option] [-CAfile file] [-no-CAfile] [-CApath dir] [-no-CApath] [-CAstore uri] [-no-CAstore] [-provider name] [-provider-path path] [-provparam [name:] key=value] [-propquery propq]

Overview

This command processes CRL files in DER or PEM format.

Options

-help

Print out a usage message.

-inform DER|PEM

The CRL input format; unspecified by default. See openssl-format-options(1) for details.

-outform DER|PEM

The CRL output format; the default is PEM. See openssl-format-options(1) for details.

-key filename

The private key to be used to sign the CRL.

-keyform DER|PEM|P12

The format of the private key file; unspecified by default. See openssl-format-options(1) for details.

-in filename

This specifies the input filename to read from or standard input if this option is not specified.

-out filename

Specifies the output filename to write to or standard output by default.

-gendelta filename

Output a comparison of the main CRL and the one specified here.

-badsig

Corrupt the signature before writing it; this can be useful for testing.

-dateopt

Specify the date output format. Values are: rfc_822 and iso_8601. Defaults to rfc_822.

-text

Print out the CRL in text form.

-verify

Verify the signature in the CRL. If the verification fails, the program will immediately exit, i.e. further option processing (e.g. -gendelta) is skipped.

This option is implicitly enabled if any of -CApath, -CAfile or -CAstore is specified.

-noout

Don't output the encoded version of the CRL.

-fingerprint

Output the fingerprint of the CRL.

-crlnumber

Output the number of the CRL.

-hash

Output a hash of the issuer name. This can be use to lookup CRLs in a directory by issuer name.

-hash_old

Outputs the "hash" of the CRL issuer name using the older algorithm as used by OpenSSL before version 1.0.0.

-issuer

Output the issuer name.

-lastupdate

Output the lastUpdate field.

-nextupdate

Output the nextUpdate field.

-nameopt option

This specifies how the subject or issuer names are displayed. See openssl-namedisplay-options(1) for details.

-CAfile file, -no-CAfile, -CApath dir, -no-CApath, -CAstore uri, -no-CAstore

See "Trusted Certificate Options" in openssl-verification-options(1) for details.

-provider name
-provider-path path
-provparam [name:]key=value
-propquery propq

See "Provider Options" in openssl(1), provider(7), and property(7).

Examples

Convert a CRL file from PEM to DER:

 openssl crl -in crl.pem -outform DER -out crl.der

Output the text form of a DER encoded certificate:

 openssl crl -in crl.der -text -noout

Releases

6 releases since Debian 9 (Stretch); the text changed 5 times.

  1. 9
  2. 10
  3. 11
  4. 12
  5. 13
  6. Arch

-CAstore since Debian 12 (Bookworm); -badsig since Debian 12 (Bookworm); -crlnumber since Debian 12 (Bookworm); -dateopt since Debian 12 (Bookworm); -fingerprint since Debian 12 (Bookworm); -gendelta since Debian 12 (Bookworm); -key since Debian 12 (Bookworm); -keyform since Debian 12 (Bookworm); -no-CAfile since Debian 12 (Bookworm); -no-CApath since Debian 12 (Bookworm); -no-CAstore since Debian 12 (Bookworm); -propquery since Debian 12 (Bookworm); -provider since Debian 12 (Bookworm); -provider-path since Debian 12 (Bookworm); -provparam since Debian 13 (Trixie); -verify since Debian 12 (Bookworm).

Bugs

Ideally it should be possible to create a CRL using appropriate options and files too.

History

Since OpenSSL 3.3, the -verify option will exit with 1 on failure.

From openssl 3.6.5-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.