From c9ea52978f2d81736de6690fe108cdcecf14d3e5 Mon Sep 17 00:00:00 2001
From: schwarze <>
Date: Mon, 12 Dec 2016 13:58:46 +0000
Subject: Document DSAparams_dup(3).  It is in <openssl/dsa.h> and documented
 by OpenSSL, so it is clearly public.

OpenSSL documents it in doc/man3/X509_dup.pod, but with wrong header
file, wrong prototype, and misleading description.

While here, fix the wrong d2i_DSA_SIG(3) return type and document
those RETURN VALUES that i could easily figure out.
---
 src/lib/libcrypto/man/d2i_DSAPublicKey.3 | 37 ++++++++++++++++++++++++++++++--
 1 file changed, 35 insertions(+), 2 deletions(-)

(limited to 'src')

diff --git a/src/lib/libcrypto/man/d2i_DSAPublicKey.3 b/src/lib/libcrypto/man/d2i_DSAPublicKey.3
index 0c756b3fcb..421a6e5053 100644
--- a/src/lib/libcrypto/man/d2i_DSAPublicKey.3
+++ b/src/lib/libcrypto/man/d2i_DSAPublicKey.3
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: d2i_DSAPublicKey.3,v 1.5 2016/12/10 22:47:49 schwarze Exp $
+.\"	$OpenBSD: d2i_DSAPublicKey.3,v 1.6 2016/12/12 13:58:46 schwarze Exp $
 .\"	OpenSSL bb9ad09e Jun 6 00:43:05 2016 -0400
 .\"
 .\" This file was written by Dr. Stephen Henson <steve@openssl.org>.
@@ -49,7 +49,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
 .\" OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: December 10 2016 $
+.Dd $Mdocdate: December 12 2016 $
 .Dt D2I_DSAPUBLICKEY 3
 .Os
 .Sh NAME
@@ -65,6 +65,7 @@
 .Nm i2d_DSAPrivateKey ,
 .Nm d2i_DSAparams ,
 .Nm i2d_DSAparams ,
+.Nm DSAparams_dup ,
 .Nm d2i_DSA_SIG ,
 .Nm i2d_DSA_SIG
 .Nd DSA key encoding and parsing functions
@@ -136,6 +137,10 @@
 .Fa "unsigned char **pp"
 .Fc
 .Ft DSA *
+.Fo DSAparams_dup
+.Fa "DSA *dsa"
+.Fc
+.Ft DSA_SIG *
 .Fo d2i_DSA_SIG
 .Fa "DSA_SIG **a"
 .Fa "const unsigned char **pp"
@@ -184,6 +189,13 @@ and
 decode and encode the DSA parameters using a
 .Sy Dss-Parms
 structure as defined in RFC 2459.
+.Fn DSAparams_dup
+copies
+.Fa dsa
+by calling
+.Fn i2d_DSAparams
+and
+.Fn d2i_DSAparams .
 .Pp
 .Fn d2i_DSA_SIG
 and
@@ -245,6 +257,27 @@ SEQUENCE containing the
 and
 .Fa a->priv_key
 fields.
+.Sh RETURN VALUES
+.Fn d2i_DSAPublicKey ,
+.Fn d2i_DSA_PUBKEY ,
+.Fn d2i_DSA_PUBKEY_bio ,
+.Fn d2i_DSA_PUBKEY_fp ,
+.Fn d2i_DSAPrivateKey ,
+.Fn d2i_DSAparams ,
+and
+.Fn DSAparams_dup
+return a valid
+.Vt DSA
+structure or
+.Dv NULL
+if an error occurs.
+.Pp
+.Fn d2i_DSA_SIG
+returns a valid
+.Vt DSA_SIG
+structure or
+.Dv NULL
+if an error occurs.
 .Sh SEE ALSO
 .Xr d2i_X509 3 ,
 .Xr DSA_new 3
-- 
cgit v1.2.3-55-g6feb