summaryrefslogtreecommitdiff
path: root/lib
diff options
context:
space:
mode:
authorIngo Schwarze <schwarze@cvs.openbsd.org>2016-12-12 13:58:47 +0000
committerIngo Schwarze <schwarze@cvs.openbsd.org>2016-12-12 13:58:47 +0000
commit996dc8c73578a9e7dd4920fd5af45b955170a99f (patch)
tree9371f029e5605f9d5ea7af4a7d819aae082ae019 /lib
parent0e4d6aef8362f6b313d26c69e69696ed74392a95 (diff)
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.
Diffstat (limited to 'lib')
-rw-r--r--lib/libcrypto/man/d2i_DSAPublicKey.337
1 files changed, 35 insertions, 2 deletions
diff --git a/lib/libcrypto/man/d2i_DSAPublicKey.3 b/lib/libcrypto/man/d2i_DSAPublicKey.3
index 0c756b3fcb6..421a6e50538 100644
--- a/lib/libcrypto/man/d2i_DSAPublicKey.3
+++ b/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