OPENSSL-CRL(1SSL)

πŸ’– OPENSSL-CRL πŸ’–

aka the openssl crl command, my beloved

okay so bestie, welcome to the CRL glow-up page πŸ’… this is the manual for openssl-crl(1ssl) and we're gonna get you fully fluent, no gatekeeping, periodt.


✨ SYNOPSIS ✨

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]

🌸 DESCRIPTION 🌸

So basically this command processes CRL files β€” and it handles them in either DER or PEM format. That's the whole job description. She's focused. She's slaying. πŸŽ€


πŸ‘‘ OPTIONS πŸ‘‘

every single one, babes. no skips. we're listing all of them fr fr.

  • -help β€” prints out a usage message. cute little "here's how to use me" moment 🫢
  • -inform DER|PEM β€” the format of the CRL you're feeding in. it's unspecified by default, so if you don't say, she'll figure it out. full details live in openssl-format-options(1) πŸ“–
  • -outform DER|PEM β€” the format you want the CRL spat back out in. default is PEM. again, openssl-format-options(1) has the lore ✨
  • -key filename β€” the private key you're gonna use to sign the CRL πŸ”‘
  • -keyform DER|PEM|P12 β€” what format that private key file is in. unspecified by default. openssl-format-options(1), as always πŸ’…
  • -in filename β€” the input file to read from. if you just... don't specify it? she reads from standard input. no pressure πŸ’–
  • -out filename β€” the file to write to. defaults to standard output if you don't name one ✨
  • -gendelta filename β€” outputs a comparison between the main CRL and the one you point at here. side-by-side tea β˜•
  • -badsig β€” corrupts the signature before writing it. which sounds unhinged but it's genuinely useful for testing πŸ™ˆ
  • -dateopt β€” sets the date output format. the values are: rfc_822 and iso_8601. defaults to rfc_822 πŸ“…
  • -text β€” prints the CRL out in text form. human-readable era 🌸
  • -verify β€” verifies the signature inside the CRL. if verification fails, the program immediately exits, meaning any further option processing (hi, -gendelta) gets skipped entirely. bye πŸ‘‹

this option is implicitly enabled if you specify any of -CApath, -CAfile or -CAstore.

  • -noout β€” don't output the encoded version of the CRL. she stays quiet 🀫
  • -fingerprint β€” outputs the fingerprint of the CRL πŸ«†
  • -crlnumber β€” outputs the number of the CRL πŸ”’
  • -hash β€” outputs a hash of the issuer name. useful for looking up CRLs in a directory by issuer name πŸ”
  • -hash_old β€” outputs the "hash" of the CRL issuer name using the older algorithm, the one OpenSSL used before version 1.0.0. vintage, but make it functional πŸ•°οΈ
  • -issuer β€” outputs the issuer name 🏷️
  • -lastupdate β€” outputs the lastUpdate field ⏰
  • -nextupdate β€” outputs the nextUpdate field ⏭️
  • -nameopt option β€” specifies how subject or issuer names get displayed. openssl-namedisplay-options(1) for the full menu πŸŽ€
  • -CAfile file, -no-CAfile, -CApath dir, -no-CApath, -CAstore uri, -no-CAstore β€” for the details, go read "Trusted Certificate Options" in openssl-verification-options(1) πŸ›‘οΈ
  • -provider name
  • -provider-path path
  • -provparam [name:]key=value
  • -propquery propq β€” all the provider lore lives in "Provider Options" in openssl(1), plus 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

πŸ’€ BUGS πŸ’€

ngl, ideally you'd be able to create a CRL using the appropriate options and files too. that would be the dream. we're not there yet 😭


πŸ¦‹ SEE ALSO πŸ¦‹

openssl(1), openssl-crl2pkcs7(1), openssl-ca(1), openssl-x509(1), ossl_store-file(7)


πŸ“œ HISTORY πŸ“œ

since OpenSSL 3.3, -verify will exit with 1 on failure. noted, bestie πŸ“


Copyright 2000-2024 The OpenSSL Project Authors. All Rights Reserved.

Licensed under the Apache License 2.0 (the "License"). You may not use this file except in compliance with the License. You can obtain a copy in the file LICENSE in the source distribution or at <https://www.openssl.org/source/license.html>.


okay that's the whole page, you ate that πŸ’… this was OpenSSL 4.0.3, dated 2026-09-29 β€” the OPENSSL-CRL(1SSL) era, and you were there for it. go forth and slay your CRLs, bestie πŸ’–βœ¨πŸ«Ά

πŸ“¦ where this page comes from