OCSPCHECK(8)
π OCSPCHECK(8) β the "is this cert still valid bestie" check
okay so real talk, this is ocspcheck from section 8 of the System Manager's Manual, and she's here to ask an OCSP responder if a certificate is still valid. no cap. let's get into it π
β¨ NAME β¨
ocspcheck β check a certificate for validity against its OCSP responder π
πΈ SYNOPSIS πΈ
ocspcheck [-Nv] [-C CAfile] [-i staplefile] [-o staplefile] file
π¦ DESCRIPTION π¦
The ocspcheck utility validates a PEM format certificate against the OCSP responder encoded in the certificate specified by the file argument. That's the whole vibe. β¨
Normally it should be used for checking server certificates and maintaining saved OCSP responses to be used for OCSP stapling. like, that's her moment to shine, that's her main character energy π
The options are as follows:
π OPTIONS π
-CCAfile β Tell her which PEM format root certificate bundle to use for the validation of requests. By default no certificates are used beyond those in the certificate chain provided by the file argument. so like, no extra trust anchors unless you hand her some π«Ά-istaplefile β Give her an input filename to read a DER-encoded OCSP response from, instead of fetching it from the OCSP server. A filename of-will read the response from standard input. very "don't talk to the server, just read the file" of you π-Nβ Do not use a nonce value in the OCSP request, or validate that the nonce was returned in the OCSP response. By default a nonce is always used and validated when retrieving a response from an OCSP server.
β οΈ SECURITY RISK ALERT β οΈ the use of this flag is a security risk as it will allow OCSP responses to be replayed. It should not be used unless the OCSP server does not support the use of OCSP nonces. fr fr, only if you have literally no other choice π
-ostaplefile β Specify an output filename where the DER encoded response from the OCSP server will be written, if the OCSP response validates. A filename of-will write the response to standard output. By default the response is not saved. no file, no stress π-vβ Increase verbosity. This flag may be specified multiple times to get more verbose output. The default behaviour is to be silent unless something goes wrong. she's lowkey quiet by default, iconic π
π₯ EXIT STATUS π₯
The ocspcheck utility exits 0 if the OCSP response validates for the certificate in file and all output is successfully written out.
ocspcheck exits >0 if an error occurs or the OCSP response fails to validate. not the slay we wanted π
π SEE ALSO π
nc(1), tls_config_set_ocsp_staple_file(3), tls_config_set_ocsp_staple_mem(3), httpd(8)
β STANDARDS β
X.509 Internet Public Key Infrastructure Online Certificate Status Protocol, RFC 6960. yes bestie, there's a whole RFC for this and she respects it π
π§ HISTORY π§
The ocspcheck utility first appeared in OpenBSD 6.1. a certified vintage β¨
π AUTHORS π
ocspcheck was written by Bob Beck. thank you Bob, king behavior π«Ά
π CAVEATS π
While ocspcheck could possibly be used in scripts to query responders for server certificates seen on client connections, this is almost always a bad idea. God kills a kitten every time you make an OCSP query from the client side of a TLS connection. π±π like she said what she said, do NOT do this bestie
π BUGS π
ocspcheck will create the output file if it does not exist. On failure a newly created output file will not be removed. so if it flops, that little file is just... still there. living its life. π
okay that's the whole page!! this was ocspcheck(8) from the Debian edition, dated September 17, 2026 β go validate those certs responsibly, mwah πβ¨π
π¦ where this page comes from
- arch rolling: libressl 4.4.0-1 Β· ISC AND custom:OpenSSL
- Copyright (c) 2017 Bob Beck <beck@openbsd.org>
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on : a language model's rewrite of the original, under its terms