From 997a89d149add597cd7ff706d7a911ef2a87c7b1 Mon Sep 17 00:00:00 2001
From: schwarze <>
Date: Tue, 27 Aug 2019 10:00:41 +0000
Subject: document OCSP_cert_status_str(3)

---
 src/lib/libcrypto/man/OCSP_resp_find_status.3 | 22 +++++++++++++++++++---
 1 file changed, 19 insertions(+), 3 deletions(-)

(limited to 'src/lib')

diff --git a/src/lib/libcrypto/man/OCSP_resp_find_status.3 b/src/lib/libcrypto/man/OCSP_resp_find_status.3
index a32019c4d6..bcfefb5754 100644
--- a/src/lib/libcrypto/man/OCSP_resp_find_status.3
+++ b/src/lib/libcrypto/man/OCSP_resp_find_status.3
@@ -1,11 +1,11 @@
-.\" $OpenBSD: OCSP_resp_find_status.3,v 1.9 2019/03/15 11:15:33 schwarze Exp $
+.\" $OpenBSD: OCSP_resp_find_status.3,v 1.10 2019/08/27 10:00:41 schwarze Exp $
 .\" full merge up to: OpenSSL c952780c Jun 21 07:03:34 2016 -0400
 .\" selective merge up to: OpenSSL 1212818e Sep 11 13:22:14 2018 +0100
 .\"
 .\" This file is a derived work.
 .\" The changes are covered by the following Copyright and license:
 .\"
-.\" Copyright (c) 2016, 2018 Ingo Schwarze <schwarze@openbsd.org>
+.\" Copyright (c) 2016, 2018, 2019 Ingo Schwarze <schwarze@openbsd.org>
 .\"
 .\" Permission to use, copy, modify, and distribute this software for any
 .\" purpose with or without fee is hereby granted, provided that the above
@@ -67,7 +67,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
 .\" OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: March 15 2019 $
+.Dd $Mdocdate: August 27 2019 $
 .Dt OCSP_RESP_FIND_STATUS 3
 .Os
 .Sh NAME
@@ -78,6 +78,7 @@
 .Nm OCSP_REVOKEDINFO_new ,
 .Nm OCSP_REVOKEDINFO_free ,
 .Nm OCSP_resp_find_status ,
+.Nm OCSP_cert_status_str ,
 .Nm OCSP_resp_count ,
 .Nm OCSP_resp_get0 ,
 .Nm OCSP_resp_find ,
@@ -110,6 +111,10 @@
 .Fa "ASN1_GENERALIZEDTIME **thisupd"
 .Fa "ASN1_GENERALIZEDTIME **nextupd"
 .Fc
+.Ft const char *
+.Fo OCSP_cert_status_str
+.Fa "long status"
+.Fc
 .Ft int
 .Fo OCSP_resp_count
 .Fa "OCSP_BASICRESP *bs"
@@ -233,6 +238,13 @@ field will be set to the revocation reason which will be one of
 or
 .Dv OCSP_REVOKED_STATUS_REMOVEFROMCRL .
 .Pp
+.Fn OCSP_cert_status_str
+converts one of the
+.Fa status
+codes retrieved by
+.Fn OCSP_resp_find_status
+to a string consisting of one word.
+.Pp
 .Fn OCSP_resp_count
 returns the number of
 .Vt OCSP_SINGLERESP
@@ -410,6 +422,9 @@ is found in
 .Fa bs
 or 0 otherwise.
 .Pp
+.Fn OCSP_cert_status_str
+returns a pointer to a static string.
+.Pp
 .Fn OCSP_resp_count
 returns the total number of
 .Vt OCSP_SINGLERESP
@@ -464,6 +479,7 @@ Status Protocol, section 4.2: Response Syntax
 .Fn OCSP_REVOKEDINFO_new ,
 .Fn OCSP_REVOKEDINFO_free ,
 .Fn OCSP_resp_find_status ,
+.Fn OCSP_cert_status_str ,
 .Fn OCSP_resp_count ,
 .Fn OCSP_resp_get0 ,
 .Fn OCSP_resp_find ,
-- 
cgit v1.2.3-55-g6feb