From ff7ed2e302f257f714c9a35abc90862a1662746c Mon Sep 17 00:00:00 2001
From: tb <>
Date: Wed, 26 Jul 2023 19:30:43 +0000
Subject: Document CMS_SignerInfos_get_version and CMS_get_version which will
 be added in the upcoming bump.

---
 src/lib/libcrypto/man/CMS_get0_SignerInfos.3 | 25 +++++++++++++++++++++++--
 1 file changed, 23 insertions(+), 2 deletions(-)

(limited to 'src/lib/libcrypto/man/CMS_get0_SignerInfos.3')

diff --git a/src/lib/libcrypto/man/CMS_get0_SignerInfos.3 b/src/lib/libcrypto/man/CMS_get0_SignerInfos.3
index faf20c49d2..0be92d800f 100644
--- a/src/lib/libcrypto/man/CMS_get0_SignerInfos.3
+++ b/src/lib/libcrypto/man/CMS_get0_SignerInfos.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: CMS_get0_SignerInfos.3,v 1.7 2019/11/02 15:39:46 schwarze Exp $
+.\" $OpenBSD: CMS_get0_SignerInfos.3,v 1.8 2023/07/26 19:30:43 tb Exp $
 .\" full merge up to: OpenSSL 83cf7abf May 29 13:07:08 2018 +0100
 .\"
 .\" This file was written by Dr. Stephen Henson <steve@openssl.org>.
@@ -48,11 +48,12 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
 .\" OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: November 2 2019 $
+.Dd $Mdocdate: July 26 2023 $
 .Dt CMS_GET0_SIGNERINFOS 3
 .Os
 .Sh NAME
 .Nm CMS_get0_SignerInfos ,
+.Nm CMS_SignerInfo_get_version ,
 .Nm CMS_SignerInfo_get0_signer_id ,
 .Nm CMS_SignerInfo_get0_signature ,
 .Nm CMS_SignerInfo_cert_cmp ,
@@ -65,6 +66,11 @@
 .Fa "CMS_ContentInfo *cms"
 .Fc
 .Ft int
+.Fo CMS_SignerInfo_get_version
+.Fa "CMS_SignerInfo *si"
+.Fa "long *version"
+.Fc
+.Ft int
 .Fo CMS_SignerInfo_get0_signer_id
 .Fa "CMS_SignerInfo *si"
 .Fa "ASN1_OCTET_STRING **keyid"
@@ -94,6 +100,14 @@ structures associated with the
 structure
 .Fa cms .
 .Pp
+.Fn CMS_SignerInfo_get_version
+sets
+.Pf * Fa version
+to the syntax version number of the
+.Vt SignerInfo
+structure
+.Fa si .
+.Pp
 .Fn CMS_SignerInfo_get0_signer_id
 retrieves the certificate
 .Vt SignerIdentifier
@@ -157,6 +171,9 @@ if there are no signers or if
 is not of the type
 .Vt SignedData .
 .Pp
+.Fn CMS_SignerInfo_get_version
+always succeeds and returns 1.
+.Pp
 .Fn CMS_SignerInfo_get0_signer_id
 returns 1 for success or 0 for failure.
 .Pp
@@ -190,3 +207,7 @@ first appeared in OpenSSL 0.9.8h and
 in OpenSSL 1.0.2.
 These functions have been available since
 .Ox 6.7 .
+.Pp
+.Fn CMS_SignerInfo_get_version
+first appeared in
+.Ox 7.4 .
-- 
cgit v1.2.3-55-g6feb