In ocsp.h rev. 1.12 2018/03/17 14:44:34, jsing@ provided

OCSP_SINGLERESP_get0_id(3).  OpenSSL fails to document it,
so document it from scratch.

1 files changed, 14 insertions, 4 deletions

diff --git a/src/lib/libcrypto/man/OCSP_resp_find_status.3 b/src/lib/libcrypto/man/OCSP_resp_find_status.3
index d06540d716..a7412193a1 100644
--- a/src/lib/libcrypto/man/OCSP_resp_find_status.3
+++ b/src/lib/libcrypto/man/OCSP_resp_find_status.3
@@ -1,10 +1,10 @@
-.\"     $OpenBSD: OCSP_resp_find_status.3,v 1.5 2016/12/25 22:15:10 schwarze Exp $
-.\"     OpenSSL c952780c Jun 21 07:03:34 2016 -0400
+.\" $OpenBSD: OCSP_resp_find_status.3,v 1.6 2018/03/18 10:01:45 schwarze Exp $
+.\" full merge up to: OpenSSL c952780c Jun 21 07:03:34 2016 -0400
 .\"
 .\" This file is a derived work.
 .\" The changes are covered by the following Copyright and license:
 .\"
-.\" Copyright (c) 2016 Ingo Schwarze <schwarze@openbsd.org>
+.\" Copyright (c) 2016, 2018 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
@@ -65,7 +65,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
 .\" OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: December 25 2016 $
+.Dd $Mdocdate: March 18 2018 $
 .Dt OCSP_RESP_FIND_STATUS 3
 .Os
 .Sh NAME
@@ -79,6 +79,7 @@
 .Nm OCSP_resp_count ,
 .Nm OCSP_resp_get0 ,
 .Nm OCSP_resp_find ,
+.Nm OCSP_SINGLERESP_get0_id ,
 .Nm OCSP_single_get0_status ,
 .Nm OCSP_check_validity
 .Nd OCSP response utility functions
@@ -121,6 +122,10 @@
 .Fa "OCSP_CERTID *id"
 .Fa "int last"
 .Fc
+.Ft const OCSP_CERTID *
+.Fo OCSP_SINGLERESP_get0_id
+.Fa "const OCSP_SINGLERESP *single"
+.Fc
 .Ft int
 .Fo OCSP_single_get0_status
 .Fa "OCSP_SINGLERESP *single"
@@ -362,6 +367,11 @@ in
 .Fa id
 was not found.
 .Pp
+.Fn OCSP_SINGLERESP_get0_id
+returns an internal pointer to the certificate ID object used by
+.Fa single ;
+the returned pointer should not be freed by the caller.
+.Pp
 .Fn OCSP_single_get0_status
 returns the status of
 .Fa single