summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorschwarze <>2018-02-17 16:59:48 +0000
committerschwarze <>2018-02-17 16:59:48 +0000
commit3bbb479de12bd8e6e1b3f23565ef278bafa57d51 (patch)
tree24af7c3335ede1f4046a631a9ba506a3c96762e5
parentc65f1d5336d2fc48bd39e9eec37ea975c4b3d24d (diff)
downloadopenbsd-3bbb479de12bd8e6e1b3f23565ef278bafa57d51.tar.gz
openbsd-3bbb479de12bd8e6e1b3f23565ef278bafa57d51.tar.bz2
openbsd-3bbb479de12bd8e6e1b3f23565ef278bafa57d51.zip
Merge documentation for {DH,DSA}_get0_{key,pqg}(3),
EVP_PKEY_get0_{DH,DSA,RSA}(3), and RSA_{g,s}et0_key(3) that tb@ just provided.
-rw-r--r--src/lib/libcrypto/man/DH_generate_key.35
-rw-r--r--src/lib/libcrypto/man/DH_generate_parameters.35
-rw-r--r--src/lib/libcrypto/man/DH_get0_pqg.3121
-rw-r--r--src/lib/libcrypto/man/DH_new.38
-rw-r--r--src/lib/libcrypto/man/DH_size.35
-rw-r--r--src/lib/libcrypto/man/DSA_do_sign.35
-rw-r--r--src/lib/libcrypto/man/DSA_dup_DH.35
-rw-r--r--src/lib/libcrypto/man/DSA_generate_key.35
-rw-r--r--src/lib/libcrypto/man/DSA_generate_parameters.35
-rw-r--r--src/lib/libcrypto/man/DSA_get0_pqg.3124
-rw-r--r--src/lib/libcrypto/man/DSA_new.36
-rw-r--r--src/lib/libcrypto/man/DSA_sign.35
-rw-r--r--src/lib/libcrypto/man/DSA_size.35
-rw-r--r--src/lib/libcrypto/man/EC_KEY_new.37
-rw-r--r--src/lib/libcrypto/man/EVP_PKEY_set1_RSA.341
-rw-r--r--src/lib/libcrypto/man/Makefile5
-rw-r--r--src/lib/libcrypto/man/RSA_check_key.35
-rw-r--r--src/lib/libcrypto/man/RSA_generate_key.35
-rw-r--r--src/lib/libcrypto/man/RSA_get0_key.3148
-rw-r--r--src/lib/libcrypto/man/RSA_new.35
-rw-r--r--src/lib/libcrypto/man/RSA_print.37
-rw-r--r--src/lib/libcrypto/man/RSA_size.35
22 files changed, 489 insertions, 43 deletions
diff --git a/src/lib/libcrypto/man/DH_generate_key.3 b/src/lib/libcrypto/man/DH_generate_key.3
index 870cfdeff9..832a70bcf2 100644
--- a/src/lib/libcrypto/man/DH_generate_key.3
+++ b/src/lib/libcrypto/man/DH_generate_key.3
@@ -1,4 +1,4 @@
1.\" $OpenBSD: DH_generate_key.3,v 1.6 2016/12/10 22:22:59 schwarze Exp $ 1.\" $OpenBSD: DH_generate_key.3,v 1.7 2018/02/17 16:59:48 schwarze Exp $
2.\" OpenSSL b97fdb57 Nov 11 09:33:09 2016 +0100 2.\" OpenSSL b97fdb57 Nov 11 09:33:09 2016 +0100
3.\" 3.\"
4.\" This file was written by Ulf Moeller <ulf@openssl.org>. 4.\" This file was written by Ulf Moeller <ulf@openssl.org>.
@@ -48,7 +48,7 @@
48.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED 48.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
49.\" OF THE POSSIBILITY OF SUCH DAMAGE. 49.\" OF THE POSSIBILITY OF SUCH DAMAGE.
50.\" 50.\"
51.Dd $Mdocdate: December 10 2016 $ 51.Dd $Mdocdate: February 17 2018 $
52.Dt DH_GENERATE_KEY 3 52.Dt DH_GENERATE_KEY 3
53.Os 53.Os
54.Sh NAME 54.Sh NAME
@@ -110,6 +110,7 @@ returns the size of the shared secret on success, or -1 on error.
110The error codes can be obtained by 110The error codes can be obtained by
111.Xr ERR_get_error 3 . 111.Xr ERR_get_error 3 .
112.Sh SEE ALSO 112.Sh SEE ALSO
113.Xr DH_get0_key 3 ,
113.Xr DH_new 3 , 114.Xr DH_new 3 ,
114.Xr DH_size 3 , 115.Xr DH_size 3 ,
115.Xr ERR_get_error 3 , 116.Xr ERR_get_error 3 ,
diff --git a/src/lib/libcrypto/man/DH_generate_parameters.3 b/src/lib/libcrypto/man/DH_generate_parameters.3
index a13699d072..0de2541ed7 100644
--- a/src/lib/libcrypto/man/DH_generate_parameters.3
+++ b/src/lib/libcrypto/man/DH_generate_parameters.3
@@ -1,4 +1,4 @@
1.\" $OpenBSD: DH_generate_parameters.3,v 1.7 2017/06/10 13:10:52 schwarze Exp $ 1.\" $OpenBSD: DH_generate_parameters.3,v 1.8 2018/02/17 16:59:48 schwarze Exp $
2.\" OpenSSL 05ea606a May 20 20:52:46 2016 -0400 2.\" OpenSSL 05ea606a May 20 20:52:46 2016 -0400
3.\" 3.\"
4.\" This file was written by Ulf Moeller <ulf@openssl.org>. 4.\" This file was written by Ulf Moeller <ulf@openssl.org>.
@@ -48,7 +48,7 @@
48.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED 48.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
49.\" OF THE POSSIBILITY OF SUCH DAMAGE. 49.\" OF THE POSSIBILITY OF SUCH DAMAGE.
50.\" 50.\"
51.Dd $Mdocdate: June 10 2017 $ 51.Dd $Mdocdate: February 17 2018 $
52.Dt DH_GENERATE_PARAMETERS 3 52.Dt DH_GENERATE_PARAMETERS 3
53.Os 53.Os
54.Sh NAME 54.Sh NAME
@@ -146,6 +146,7 @@ if the parameter generation fails.
146The error codes can be obtained by 146The error codes can be obtained by
147.Xr ERR_get_error 3 . 147.Xr ERR_get_error 3 .
148.Sh SEE ALSO 148.Sh SEE ALSO
149.Xr DH_get0_pqg 3 ,
149.Xr DH_new 3 , 150.Xr DH_new 3 ,
150.Xr ERR_get_error 3 , 151.Xr ERR_get_error 3 ,
151.Xr RAND_bytes 3 152.Xr RAND_bytes 3
diff --git a/src/lib/libcrypto/man/DH_get0_pqg.3 b/src/lib/libcrypto/man/DH_get0_pqg.3
new file mode 100644
index 0000000000..3d8087dcfc
--- /dev/null
+++ b/src/lib/libcrypto/man/DH_get0_pqg.3
@@ -0,0 +1,121 @@
1.\" $OpenBSD: DH_get0_pqg.3,v 1.1 2018/02/17 16:59:48 schwarze Exp $
2.\" selective merge up to: OpenSSL 7966101e Sep 18 11:58:24 2017 -0400
3.\"
4.\" This file was written by Matt Caswell <matt@openssl.org>.
5.\" Copyright (c) 2016 The OpenSSL Project. All rights reserved.
6.\"
7.\" Redistribution and use in source and binary forms, with or without
8.\" modification, are permitted provided that the following conditions
9.\" are met:
10.\"
11.\" 1. Redistributions of source code must retain the above copyright
12.\" notice, this list of conditions and the following disclaimer.
13.\"
14.\" 2. Redistributions in binary form must reproduce the above copyright
15.\" notice, this list of conditions and the following disclaimer in
16.\" the documentation and/or other materials provided with the
17.\" distribution.
18.\"
19.\" 3. All advertising materials mentioning features or use of this
20.\" software must display the following acknowledgment:
21.\" "This product includes software developed by the OpenSSL Project
22.\" for use in the OpenSSL Toolkit. (http://www.openssl.org/)"
23.\"
24.\" 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to
25.\" endorse or promote products derived from this software without
26.\" prior written permission. For written permission, please contact
27.\" openssl-core@openssl.org.
28.\"
29.\" 5. Products derived from this software may not be called "OpenSSL"
30.\" nor may "OpenSSL" appear in their names without prior written
31.\" permission of the OpenSSL Project.
32.\"
33.\" 6. Redistributions of any form whatsoever must retain the following
34.\" acknowledgment:
35.\" "This product includes software developed by the OpenSSL Project
36.\" for use in the OpenSSL Toolkit (http://www.openssl.org/)"
37.\"
38.\" THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY
39.\" EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
40.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
41.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR
42.\" ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
43.\" SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
44.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
45.\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
46.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
47.\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
48.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
49.\" OF THE POSSIBILITY OF SUCH DAMAGE.
50.\"
51.Dd $Mdocdate: February 17 2018 $
52.Dt DH_GET0_PQG 3
53.Os
54.Sh NAME
55.Nm DH_get0_pqg ,
56.Nm DH_get0_key
57.Nd get data from a DH object
58.Sh SYNOPSIS
59.In openssl/dh.h
60.Ft void
61.Fo DH_get0_pqg
62.Fa "const DH *dh"
63.Fa "const BIGNUM **p"
64.Fa "const BIGNUM **q"
65.Fa "const BIGNUM **g"
66.Fc
67.Ft void
68.Fo DH_get0_key
69.Fa "const DH *dh"
70.Fa "const BIGNUM **pub_key"
71.Fa "const BIGNUM **priv_key"
72.Fc
73.Sh DESCRIPTION
74A
75.Vt DH
76object contains the parameters
77.Fa p ,
78.Fa q ,
79and optionally
80.Fa g .
81It also contains a public key
82.Fa pub_key
83and an optional private key
84.Fa priv_key .
85.Pp
86The
87.Fa p ,
88.Fa q ,
89and
90.Fa g
91parameters can be obtained by calling
92.Fn DH_get0_pqg .
93If the parameters have not yet been set, then
94.Pf * Fa p ,
95.Pf * Fa q ,
96and
97.Pf * Fa g
98are set to
99.Dv NULL .
100Otherwise, they are set to pointers to the internal representations
101of the values that should not be freed by the application.
102.Pp
103The
104.Fn DH_get0_key
105function stores pointers to the internal representations
106of the public key in
107.Pf * Fa pub_key
108and to the private key in
109.Pf * Fa priv_key .
110Either may be
111.Dv NULL
112if it has not yet been set.
113If the private key has been set, then the public key must be.
114.Sh SEE ALSO
115.Xr DH_generate_key 3 ,
116.Xr DH_generate_parameters 3 ,
117.Xr DH_new 3 ,
118.Xr DH_size 3 ,
119.Xr DHparams_print 3
120.Sh HISTORY
121These functions first appeared in OpenSSL 1.1.0.
diff --git a/src/lib/libcrypto/man/DH_new.3 b/src/lib/libcrypto/man/DH_new.3
index 28f1888c01..58cde65469 100644
--- a/src/lib/libcrypto/man/DH_new.3
+++ b/src/lib/libcrypto/man/DH_new.3
@@ -1,4 +1,4 @@
1.\" $OpenBSD: DH_new.3,v 1.4 2016/12/10 22:30:54 schwarze Exp $ 1.\" $OpenBSD: DH_new.3,v 1.5 2018/02/17 16:59:48 schwarze Exp $
2.\" OpenSSL b97fdb57 Nov 11 09:33:09 2016 +0100 2.\" OpenSSL b97fdb57 Nov 11 09:33:09 2016 +0100
3.\" 3.\"
4.\" This file was written by Ulf Moeller <ulf@openssl.org>. 4.\" This file was written by Ulf Moeller <ulf@openssl.org>.
@@ -48,7 +48,7 @@
48.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED 48.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
49.\" OF THE POSSIBILITY OF SUCH DAMAGE. 49.\" OF THE POSSIBILITY OF SUCH DAMAGE.
50.\" 50.\"
51.Dd $Mdocdate: December 10 2016 $ 51.Dd $Mdocdate: February 17 2018 $
52.Dt DH_NEW 3 52.Dt DH_NEW 3
53.Os 53.Os
54.Sh NAME 54.Sh NAME
@@ -94,12 +94,14 @@ Otherwise it returns a pointer to the newly allocated structure.
94.Xr d2i_DHparams 3 , 94.Xr d2i_DHparams 3 ,
95.Xr DH_generate_key 3 , 95.Xr DH_generate_key 3 ,
96.Xr DH_generate_parameters 3 , 96.Xr DH_generate_parameters 3 ,
97.Xr DH_get0_pqg 3 ,
97.Xr DH_get_ex_new_index 3 , 98.Xr DH_get_ex_new_index 3 ,
98.Xr DH_set_method 3 , 99.Xr DH_set_method 3 ,
99.Xr DH_size 3 , 100.Xr DH_size 3 ,
100.Xr DHparams_print 3 , 101.Xr DHparams_print 3 ,
101.Xr DSA_dup_DH 3 , 102.Xr DSA_dup_DH 3 ,
102.Xr ERR_get_error 3 103.Xr ERR_get_error 3 ,
104.Xr EVP_PKEY_set1_DH 3
103.Sh HISTORY 105.Sh HISTORY
104.Fn DH_new 106.Fn DH_new
105and 107and
diff --git a/src/lib/libcrypto/man/DH_size.3 b/src/lib/libcrypto/man/DH_size.3
index ea59035734..e566e52357 100644
--- a/src/lib/libcrypto/man/DH_size.3
+++ b/src/lib/libcrypto/man/DH_size.3
@@ -1,4 +1,4 @@
1.\" $OpenBSD: DH_size.3,v 1.4 2016/12/10 22:22:59 schwarze Exp $ 1.\" $OpenBSD: DH_size.3,v 1.5 2018/02/17 16:59:48 schwarze Exp $
2.\" OpenSSL 4d524e10 Feb 24 11:55:57 2000 +0000 2.\" OpenSSL 4d524e10 Feb 24 11:55:57 2000 +0000
3.\" 3.\"
4.\" This file was written by Ulf Moeller <ulf@openssl.org>. 4.\" This file was written by Ulf Moeller <ulf@openssl.org>.
@@ -48,7 +48,7 @@
48.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED 48.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
49.\" OF THE POSSIBILITY OF SUCH DAMAGE. 49.\" OF THE POSSIBILITY OF SUCH DAMAGE.
50.\" 50.\"
51.Dd $Mdocdate: December 10 2016 $ 51.Dd $Mdocdate: February 17 2018 $
52.Dt DH_SIZE 3 52.Dt DH_SIZE 3
53.Os 53.Os
54.Sh NAME 54.Sh NAME
@@ -76,6 +76,7 @@ The size in bytes.
76.Sh SEE ALSO 76.Sh SEE ALSO
77.Xr BN_num_bytes 3 , 77.Xr BN_num_bytes 3 ,
78.Xr DH_generate_key 3 , 78.Xr DH_generate_key 3 ,
79.Xr DH_get0_key 3 ,
79.Xr DH_new 3 80.Xr DH_new 3
80.Sh HISTORY 81.Sh HISTORY
81.Fn DH_size 82.Fn DH_size
diff --git a/src/lib/libcrypto/man/DSA_do_sign.3 b/src/lib/libcrypto/man/DSA_do_sign.3
index c229c2b629..9d0696e44b 100644
--- a/src/lib/libcrypto/man/DSA_do_sign.3
+++ b/src/lib/libcrypto/man/DSA_do_sign.3
@@ -1,4 +1,4 @@
1.\" $OpenBSD: DSA_do_sign.3,v 1.5 2016/12/10 22:47:49 schwarze Exp $ 1.\" $OpenBSD: DSA_do_sign.3,v 1.6 2018/02/17 16:59:48 schwarze Exp $
2.\" OpenSSL b97fdb57 Nov 11 09:33:09 2016 +0100 2.\" OpenSSL b97fdb57 Nov 11 09:33:09 2016 +0100
3.\" 3.\"
4.\" This file was written by Ulf Moeller <ulf@openssl.org>. 4.\" This file was written by Ulf Moeller <ulf@openssl.org>.
@@ -48,7 +48,7 @@
48.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED 48.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
49.\" OF THE POSSIBILITY OF SUCH DAMAGE. 49.\" OF THE POSSIBILITY OF SUCH DAMAGE.
50.\" 50.\"
51.Dd $Mdocdate: December 10 2016 $ 51.Dd $Mdocdate: February 17 2018 $
52.Dt DSA_DO_SIGN 3 52.Dt DSA_DO_SIGN 3
53.Os 53.Os
54.Sh NAME 54.Sh NAME
@@ -106,6 +106,7 @@ and -1 on error.
106The error codes can be obtained by 106The error codes can be obtained by
107.Xr ERR_get_error 3 . 107.Xr ERR_get_error 3 .
108.Sh SEE ALSO 108.Sh SEE ALSO
109.Xr DSA_get0_key 3 ,
109.Xr DSA_new 3 , 110.Xr DSA_new 3 ,
110.Xr DSA_SIG_new 3 , 111.Xr DSA_SIG_new 3 ,
111.Xr DSA_sign 3 , 112.Xr DSA_sign 3 ,
diff --git a/src/lib/libcrypto/man/DSA_dup_DH.3 b/src/lib/libcrypto/man/DSA_dup_DH.3
index a1a67640c5..e8bc872d55 100644
--- a/src/lib/libcrypto/man/DSA_dup_DH.3
+++ b/src/lib/libcrypto/man/DSA_dup_DH.3
@@ -1,4 +1,4 @@
1.\" $OpenBSD: DSA_dup_DH.3,v 1.5 2016/12/10 22:47:49 schwarze Exp $ 1.\" $OpenBSD: DSA_dup_DH.3,v 1.6 2018/02/17 16:59:48 schwarze Exp $
2.\" OpenSSL b97fdb57 Nov 11 09:33:09 2016 +0100 2.\" OpenSSL b97fdb57 Nov 11 09:33:09 2016 +0100
3.\" 3.\"
4.\" This file was written by Ulf Moeller <ulf@openssl.org>. 4.\" This file was written by Ulf Moeller <ulf@openssl.org>.
@@ -48,7 +48,7 @@
48.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED 48.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
49.\" OF THE POSSIBILITY OF SUCH DAMAGE. 49.\" OF THE POSSIBILITY OF SUCH DAMAGE.
50.\" 50.\"
51.Dd $Mdocdate: December 10 2016 $ 51.Dd $Mdocdate: February 17 2018 $
52.Dt DSA_DUP_DH 3 52.Dt DSA_DUP_DH 3
53.Os 53.Os
54.Sh NAME 54.Sh NAME
@@ -82,6 +82,7 @@ The error codes can be obtained by
82.Xr ERR_get_error 3 . 82.Xr ERR_get_error 3 .
83.Sh SEE ALSO 83.Sh SEE ALSO
84.Xr DH_new 3 , 84.Xr DH_new 3 ,
85.Xr DSA_get0_pqg 3 ,
85.Xr DSA_new 3 , 86.Xr DSA_new 3 ,
86.Xr ERR_get_error 3 87.Xr ERR_get_error 3
87.Sh HISTORY 88.Sh HISTORY
diff --git a/src/lib/libcrypto/man/DSA_generate_key.3 b/src/lib/libcrypto/man/DSA_generate_key.3
index f9a1681cff..39cff88646 100644
--- a/src/lib/libcrypto/man/DSA_generate_key.3
+++ b/src/lib/libcrypto/man/DSA_generate_key.3
@@ -1,4 +1,4 @@
1.\" $OpenBSD: DSA_generate_key.3,v 1.5 2016/12/10 22:47:49 schwarze Exp $ 1.\" $OpenBSD: DSA_generate_key.3,v 1.6 2018/02/17 16:59:48 schwarze Exp $
2.\" OpenSSL b97fdb57 Nov 11 09:33:09 2016 +0100 2.\" OpenSSL b97fdb57 Nov 11 09:33:09 2016 +0100
3.\" 3.\"
4.\" This file was written by Ulf Moeller <ulf@openssl.org>. 4.\" This file was written by Ulf Moeller <ulf@openssl.org>.
@@ -48,7 +48,7 @@
48.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED 48.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
49.\" OF THE POSSIBILITY OF SUCH DAMAGE. 49.\" OF THE POSSIBILITY OF SUCH DAMAGE.
50.\" 50.\"
51.Dd $Mdocdate: December 10 2016 $ 51.Dd $Mdocdate: February 17 2018 $
52.Dt DSA_GENERATE_KEY 3 52.Dt DSA_GENERATE_KEY 3
53.Os 53.Os
54.Sh NAME 54.Sh NAME
@@ -76,6 +76,7 @@ The error codes can be obtained by
76.Xr ERR_get_error 3 . 76.Xr ERR_get_error 3 .
77.Sh SEE ALSO 77.Sh SEE ALSO
78.Xr DSA_generate_parameters 3 , 78.Xr DSA_generate_parameters 3 ,
79.Xr DSA_get0_key 3 ,
79.Xr DSA_new 3 , 80.Xr DSA_new 3 ,
80.Xr ERR_get_error 3 , 81.Xr ERR_get_error 3 ,
81.Xr RAND_bytes 3 82.Xr RAND_bytes 3
diff --git a/src/lib/libcrypto/man/DSA_generate_parameters.3 b/src/lib/libcrypto/man/DSA_generate_parameters.3
index e6e6d90dce..46827cf687 100644
--- a/src/lib/libcrypto/man/DSA_generate_parameters.3
+++ b/src/lib/libcrypto/man/DSA_generate_parameters.3
@@ -1,4 +1,4 @@
1.\" $OpenBSD: DSA_generate_parameters.3,v 1.5 2016/12/10 22:47:49 schwarze Exp $ 1.\" $OpenBSD: DSA_generate_parameters.3,v 1.6 2018/02/17 16:59:48 schwarze Exp $
2.\" OpenSSL 9b86974e Aug 7 22:14:47 2015 -0400 2.\" OpenSSL 9b86974e Aug 7 22:14:47 2015 -0400
3.\" 3.\"
4.\" This file was written by Ulf Moeller <ulf@openssl.org>, 4.\" This file was written by Ulf Moeller <ulf@openssl.org>,
@@ -49,7 +49,7 @@
49.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED 49.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
50.\" OF THE POSSIBILITY OF SUCH DAMAGE. 50.\" OF THE POSSIBILITY OF SUCH DAMAGE.
51.\" 51.\"
52.Dd $Mdocdate: December 10 2016 $ 52.Dd $Mdocdate: February 17 2018 $
53.Dt DSA_GENERATE_PARAMETERS 3 53.Dt DSA_GENERATE_PARAMETERS 3
54.Os 54.Os
55.Sh NAME 55.Sh NAME
@@ -198,6 +198,7 @@ The error codes can be obtained by
198.Xr ERR_get_error 3 . 198.Xr ERR_get_error 3 .
199.Sh SEE ALSO 199.Sh SEE ALSO
200.Xr BN_generate_prime 3 , 200.Xr BN_generate_prime 3 ,
201.Xr DSA_get0_pqg 3 ,
201.Xr DSA_new 3 , 202.Xr DSA_new 3 ,
202.Xr ERR_get_error 3 , 203.Xr ERR_get_error 3 ,
203.Xr RAND_bytes 3 204.Xr RAND_bytes 3
diff --git a/src/lib/libcrypto/man/DSA_get0_pqg.3 b/src/lib/libcrypto/man/DSA_get0_pqg.3
new file mode 100644
index 0000000000..f3dbe0ce8d
--- /dev/null
+++ b/src/lib/libcrypto/man/DSA_get0_pqg.3
@@ -0,0 +1,124 @@
1.\" $OpenBSD: DSA_get0_pqg.3,v 1.1 2018/02/17 16:59:48 schwarze Exp $
2.\" selective merge up to: OpenSSL e90fc053 Jul 15 09:39:45 2017 -0400
3.\"
4.\" This file was written by Matt Caswell <matt@openssl.org>.
5.\" Copyright (c) 2016 The OpenSSL Project. All rights reserved.
6.\"
7.\" Redistribution and use in source and binary forms, with or without
8.\" modification, are permitted provided that the following conditions
9.\" are met:
10.\"
11.\" 1. Redistributions of source code must retain the above copyright
12.\" notice, this list of conditions and the following disclaimer.
13.\"
14.\" 2. Redistributions in binary form must reproduce the above copyright
15.\" notice, this list of conditions and the following disclaimer in
16.\" the documentation and/or other materials provided with the
17.\" distribution.
18.\"
19.\" 3. All advertising materials mentioning features or use of this
20.\" software must display the following acknowledgment:
21.\" "This product includes software developed by the OpenSSL Project
22.\" for use in the OpenSSL Toolkit. (http://www.openssl.org/)"
23.\"
24.\" 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to
25.\" endorse or promote products derived from this software without
26.\" prior written permission. For written permission, please contact
27.\" openssl-core@openssl.org.
28.\"
29.\" 5. Products derived from this software may not be called "OpenSSL"
30.\" nor may "OpenSSL" appear in their names without prior written
31.\" permission of the OpenSSL Project.
32.\"
33.\" 6. Redistributions of any form whatsoever must retain the following
34.\" acknowledgment:
35.\" "This product includes software developed by the OpenSSL Project
36.\" for use in the OpenSSL Toolkit (http://www.openssl.org/)"
37.\"
38.\" THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY
39.\" EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
40.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
41.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR
42.\" ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
43.\" SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
44.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
45.\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
46.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
47.\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
48.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
49.\" OF THE POSSIBILITY OF SUCH DAMAGE.
50.\"
51.Dd $Mdocdate: February 17 2018 $
52.Dt DSA_GET0_PQG 3
53.Os
54.Sh NAME
55.Nm DSA_get0_pqg ,
56.Nm DSA_get0_key
57.Nd get data from a DSA object
58.Sh SYNOPSIS
59.In openssl/dsa.h
60.Ft void
61.Fo DSA_get0_pqg
62.Fa "const DSA *d"
63.Fa "const BIGNUM **p"
64.Fa "const BIGNUM **q"
65.Fa "const BIGNUM **g"
66.Fc
67.Ft void
68.Fo DSA_get0_key
69.Fa "const DSA *d"
70.Fa "const BIGNUM **pub_key"
71.Fa "const BIGNUM **priv_key"
72.Fc
73.Sh DESCRIPTION
74A
75.Vt DSA
76object contains the parameters
77.Fa p ,
78.Fa q ,
79and
80.Fa g .
81It also contains a public key
82.Fa pub_key
83and an optional private key
84.Fa priv_key .
85.Pp
86The
87.Fa p ,
88.Fa q ,
89and
90.Fa g
91parameters can be obtained by calling
92.Fn DSA_get0_pqg .
93If the parameters have not yet been set, then
94.Pf * Fa p ,
95.Pf * Fa q ,
96and
97.Pf * Fa g
98are set to
99.Dv NULL .
100Otherwise, they are set to pointers to the internal representations
101of the values that should not be freed by the application.
102.Pp
103The
104.Fn DSA_get0_key
105function stores pointers to the internal representations
106of the public key in
107.Pf * Fa pub_key
108and to the private key in
109.Pf * Fa priv_key .
110Either may be
111.Dv NULL
112if it has not yet been set.
113If the private key has been set, then the public key must be.
114.Sh SEE ALSO
115.Xr DSA_do_sign 3 ,
116.Xr DSA_dup_DH 3 ,
117.Xr DSA_generate_key 3 ,
118.Xr DSA_generate_parameters 3 ,
119.Xr DSA_new 3 ,
120.Xr DSA_print 3 ,
121.Xr DSA_sign 3 ,
122.Xr DSA_size 3
123.Sh HISTORY
124These functions first appeared in OpenSSL 1.1.0.
diff --git a/src/lib/libcrypto/man/DSA_new.3 b/src/lib/libcrypto/man/DSA_new.3
index c7339ceff1..817671093c 100644
--- a/src/lib/libcrypto/man/DSA_new.3
+++ b/src/lib/libcrypto/man/DSA_new.3
@@ -1,4 +1,4 @@
1.\" $OpenBSD: DSA_new.3,v 1.5 2016/12/11 09:57:57 jmc Exp $ 1.\" $OpenBSD: DSA_new.3,v 1.6 2018/02/17 16:59:48 schwarze Exp $
2.\" OpenSSL b97fdb57 Nov 11 09:33:09 2016 +0100 2.\" OpenSSL b97fdb57 Nov 11 09:33:09 2016 +0100
3.\" 3.\"
4.\" This file was written by Ulf Moeller <ulf@openssl.org>. 4.\" This file was written by Ulf Moeller <ulf@openssl.org>.
@@ -48,7 +48,7 @@
48.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED 48.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
49.\" OF THE POSSIBILITY OF SUCH DAMAGE. 49.\" OF THE POSSIBILITY OF SUCH DAMAGE.
50.\" 50.\"
51.Dd $Mdocdate: December 11 2016 $ 51.Dd $Mdocdate: February 17 2018 $
52.Dt DSA_NEW 3 52.Dt DSA_NEW 3
53.Os 53.Os
54.Sh NAME 54.Sh NAME
@@ -99,6 +99,7 @@ Otherwise it returns a pointer to the newly allocated structure.
99.Xr DSA_dup_DH 3 , 99.Xr DSA_dup_DH 3 ,
100.Xr DSA_generate_key 3 , 100.Xr DSA_generate_key 3 ,
101.Xr DSA_generate_parameters 3 , 101.Xr DSA_generate_parameters 3 ,
102.Xr DSA_get0_pqg 3 ,
102.Xr DSA_get_ex_new_index 3 , 103.Xr DSA_get_ex_new_index 3 ,
103.Xr DSA_print 3 , 104.Xr DSA_print 3 ,
104.Xr DSA_set_method 3 , 105.Xr DSA_set_method 3 ,
@@ -107,6 +108,7 @@ Otherwise it returns a pointer to the newly allocated structure.
107.Xr DSA_size 3 , 108.Xr DSA_size 3 ,
108.Xr engine 3 , 109.Xr engine 3 ,
109.Xr ERR_get_error 3 , 110.Xr ERR_get_error 3 ,
111.Xr EVP_PKEY_set1_DSA 3 ,
110.Xr RSA_new 3 112.Xr RSA_new 3
111.Sh STANDARDS 113.Sh STANDARDS
112US Federal Information Processing Standard FIPS 186 (Digital Signature 114US Federal Information Processing Standard FIPS 186 (Digital Signature
diff --git a/src/lib/libcrypto/man/DSA_sign.3 b/src/lib/libcrypto/man/DSA_sign.3
index 8c85127681..1b3750bc6c 100644
--- a/src/lib/libcrypto/man/DSA_sign.3
+++ b/src/lib/libcrypto/man/DSA_sign.3
@@ -1,4 +1,4 @@
1.\" $OpenBSD: DSA_sign.3,v 1.5 2016/12/10 22:47:49 schwarze Exp $ 1.\" $OpenBSD: DSA_sign.3,v 1.6 2018/02/17 16:59:48 schwarze Exp $
2.\" OpenSSL b97fdb57 Nov 11 09:33:09 2016 +0100 2.\" OpenSSL b97fdb57 Nov 11 09:33:09 2016 +0100
3.\" 3.\"
4.\" This file was written by Ulf Moeller <ulf@openssl.org>. 4.\" This file was written by Ulf Moeller <ulf@openssl.org>.
@@ -48,7 +48,7 @@
48.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED 48.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
49.\" OF THE POSSIBILITY OF SUCH DAMAGE. 49.\" OF THE POSSIBILITY OF SUCH DAMAGE.
50.\" 50.\"
51.Dd $Mdocdate: December 10 2016 $ 51.Dd $Mdocdate: February 17 2018 $
52.Dt DSA_SIGN 3 52.Dt DSA_SIGN 3
53.Os 53.Os
54.Sh NAME 54.Sh NAME
@@ -157,6 +157,7 @@ The error codes can be obtained by
157.Xr ERR_get_error 3 . 157.Xr ERR_get_error 3 .
158.Sh SEE ALSO 158.Sh SEE ALSO
159.Xr DSA_do_sign 3 , 159.Xr DSA_do_sign 3 ,
160.Xr DSA_get0_key 3 ,
160.Xr DSA_new 3 , 161.Xr DSA_new 3 ,
161.Xr ERR_get_error 3 , 162.Xr ERR_get_error 3 ,
162.Xr RAND_bytes 3 163.Xr RAND_bytes 3
diff --git a/src/lib/libcrypto/man/DSA_size.3 b/src/lib/libcrypto/man/DSA_size.3
index 373b142c79..4ed0d68b02 100644
--- a/src/lib/libcrypto/man/DSA_size.3
+++ b/src/lib/libcrypto/man/DSA_size.3
@@ -1,4 +1,4 @@
1.\" $OpenBSD: DSA_size.3,v 1.4 2016/12/10 22:47:49 schwarze Exp $ 1.\" $OpenBSD: DSA_size.3,v 1.5 2018/02/17 16:59:48 schwarze Exp $
2.\" OpenSSL 05ea606a May 20 20:52:46 2016 -0400 2.\" OpenSSL 05ea606a May 20 20:52:46 2016 -0400
3.\" 3.\"
4.\" This file was written by Ulf Moeller <ulf@openssl.org>. 4.\" This file was written by Ulf Moeller <ulf@openssl.org>.
@@ -48,7 +48,7 @@
48.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED 48.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
49.\" OF THE POSSIBILITY OF SUCH DAMAGE. 49.\" OF THE POSSIBILITY OF SUCH DAMAGE.
50.\" 50.\"
51.Dd $Mdocdate: December 10 2016 $ 51.Dd $Mdocdate: February 17 2018 $
52.Dt DSA_SIZE 3 52.Dt DSA_SIZE 3
53.Os 53.Os
54.Sh NAME 54.Sh NAME
@@ -72,6 +72,7 @@ must not be
72.Sh RETURN VALUES 72.Sh RETURN VALUES
73The size in bytes. 73The size in bytes.
74.Sh SEE ALSO 74.Sh SEE ALSO
75.Xr DSA_get0_pqg 3 ,
75.Xr DSA_new 3 , 76.Xr DSA_new 3 ,
76.Xr DSA_sign 3 77.Xr DSA_sign 3
77.Sh HISTORY 78.Sh HISTORY
diff --git a/src/lib/libcrypto/man/EC_KEY_new.3 b/src/lib/libcrypto/man/EC_KEY_new.3
index 742be773ee..7767fb55e9 100644
--- a/src/lib/libcrypto/man/EC_KEY_new.3
+++ b/src/lib/libcrypto/man/EC_KEY_new.3
@@ -1,4 +1,4 @@
1.\" $OpenBSD: EC_KEY_new.3,v 1.8 2016/12/11 14:22:43 schwarze Exp $ 1.\" $OpenBSD: EC_KEY_new.3,v 1.9 2018/02/17 16:59:48 schwarze Exp $
2.\" OpenSSL d900a015 Oct 8 14:40:42 2015 +0200 2.\" OpenSSL d900a015 Oct 8 14:40:42 2015 +0200
3.\" 3.\"
4.\" This file was written by Matt Caswell <matt@openssl.org>. 4.\" This file was written by Matt Caswell <matt@openssl.org>.
@@ -48,7 +48,7 @@
48.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED 48.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
49.\" OF THE POSSIBILITY OF SUCH DAMAGE. 49.\" OF THE POSSIBILITY OF SUCH DAMAGE.
50.\" 50.\"
51.Dd $Mdocdate: December 11 2016 $ 51.Dd $Mdocdate: February 17 2018 $
52.Dt EC_KEY_NEW 3 52.Dt EC_KEY_NEW 3
53.Os 53.Os
54.Sh NAME 54.Sh NAME
@@ -524,4 +524,5 @@ returns the point_conversion_form for the
524.Xr EC_GROUP_new 3 , 524.Xr EC_GROUP_new 3 ,
525.Xr EC_POINT_add 3 , 525.Xr EC_POINT_add 3 ,
526.Xr EC_POINT_new 3 , 526.Xr EC_POINT_new 3 ,
527.Xr ECDSA_SIG_new 3 527.Xr ECDSA_SIG_new 3 ,
528.Xr EVP_PKEY_set1_EC_KEY 3
diff --git a/src/lib/libcrypto/man/EVP_PKEY_set1_RSA.3 b/src/lib/libcrypto/man/EVP_PKEY_set1_RSA.3
index 851184ae3c..e897dacf68 100644
--- a/src/lib/libcrypto/man/EVP_PKEY_set1_RSA.3
+++ b/src/lib/libcrypto/man/EVP_PKEY_set1_RSA.3
@@ -1,5 +1,6 @@
1.\" $OpenBSD: EVP_PKEY_set1_RSA.3,v 1.5 2016/12/11 12:21:48 schwarze Exp $ 1.\" $OpenBSD: EVP_PKEY_set1_RSA.3,v 1.6 2018/02/17 16:59:48 schwarze Exp $
2.\" OpenSSL 9b86974e Aug 17 15:21:33 2015 -0400 2.\" full merge up to: OpenSSL 9b86974e Aug 17 15:21:33 2015 -0400
3.\" selective merge up to: OpenSSL 99d63d46 Oct 26 13:56:48 2016 -0400
3.\" 4.\"
4.\" This file was written by Dr. Stephen Henson <steve@openssl.org>. 5.\" This file was written by Dr. Stephen Henson <steve@openssl.org>.
5.\" Copyright (c) 2002, 2014, 2016 The OpenSSL Project. All rights reserved. 6.\" Copyright (c) 2002, 2014, 2016 The OpenSSL Project. All rights reserved.
@@ -48,7 +49,7 @@
48.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED 49.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
49.\" OF THE POSSIBILITY OF SUCH DAMAGE. 50.\" OF THE POSSIBILITY OF SUCH DAMAGE.
50.\" 51.\"
51.Dd $Mdocdate: December 11 2016 $ 52.Dd $Mdocdate: February 17 2018 $
52.Dt EVP_PKEY_SET1_RSA 3 53.Dt EVP_PKEY_SET1_RSA 3
53.Os 54.Os
54.Sh NAME 55.Sh NAME
@@ -60,6 +61,9 @@
60.Nm EVP_PKEY_get1_DSA , 61.Nm EVP_PKEY_get1_DSA ,
61.Nm EVP_PKEY_get1_DH , 62.Nm EVP_PKEY_get1_DH ,
62.Nm EVP_PKEY_get1_EC_KEY , 63.Nm EVP_PKEY_get1_EC_KEY ,
64.Nm EVP_PKEY_get0_RSA ,
65.Nm EVP_PKEY_get0_DSA ,
66.Nm EVP_PKEY_get0_DH ,
63.Nm EVP_PKEY_assign_RSA , 67.Nm EVP_PKEY_assign_RSA ,
64.Nm EVP_PKEY_assign_DSA , 68.Nm EVP_PKEY_assign_DSA ,
65.Nm EVP_PKEY_assign_DH , 69.Nm EVP_PKEY_assign_DH ,
@@ -106,6 +110,18 @@
106.Fo EVP_PKEY_get1_EC_KEY 110.Fo EVP_PKEY_get1_EC_KEY
107.Fa "EVP_PKEY *pkey" 111.Fa "EVP_PKEY *pkey"
108.Fc 112.Fc
113.Ft RSA *
114.Fo EVP_PKEY_get0_RSA
115.Fa "EVP_PKEY *pkey"
116.Fc
117.Ft DSA *
118.Fo EVP_PKEY_get0_DSA
119.Fa "EVP_PKEY *pkey"
120.Fc
121.Ft DH *
122.Fo EVP_PKEY_get0_DH
123.Fa "EVP_PKEY *pkey"
124.Fc
109.Ft int 125.Ft int
110.Fo EVP_PKEY_assign_RSA 126.Fo EVP_PKEY_assign_RSA
111.Fa "EVP_PKEY *pkey" 127.Fa "EVP_PKEY *pkey"
@@ -155,11 +171,18 @@ to
155and 171and
156.Fn EVP_PKEY_get1_EC_KEY 172.Fn EVP_PKEY_get1_EC_KEY
157return the key referenced in 173return the key referenced in
158.Fa pkey 174.Fa pkey ,
159or 175incrementing its reference count by 1, or
160.Dv NULL 176.Dv NULL
161if the key is not of the correct type. 177if the key is not of the correct type.
162.Pp 178.Pp
179.Fn EVP_PKEY_get0_RSA ,
180.Fn EVP_PKEY_get0_DSA ,
181and
182.Fn EVP_PKEY_get0_DH
183are identical except that they do not increment the reference count.
184Consequently, the returned key must not be freed by the caller.
185.Pp
163.Fn EVP_PKEY_assign_RSA , 186.Fn EVP_PKEY_assign_RSA ,
164.Fn EVP_PKEY_assign_DSA , 187.Fn EVP_PKEY_assign_DSA ,
165.Fn EVP_PKEY_assign_DH , 188.Fn EVP_PKEY_assign_DH ,
@@ -235,8 +258,11 @@ return 1 for success or 0 for failure.
235.Fn EVP_PKEY_get1_RSA , 258.Fn EVP_PKEY_get1_RSA ,
236.Fn EVP_PKEY_get1_DSA , 259.Fn EVP_PKEY_get1_DSA ,
237.Fn EVP_PKEY_get1_DH , 260.Fn EVP_PKEY_get1_DH ,
261.Fn EVP_PKEY_get1_EC_KEY ,
262.Fn EVP_PKEY_get0_RSA ,
263.Fn EVP_PKEY_get0_DSA ,
238and 264and
239.Fn EVP_PKEY_get1_EC_KEY 265.Fn EVP_PKEY_get0_DH
240return the referenced key or 266return the referenced key or
241.Dv NULL 267.Dv NULL
242if an error occurred. 268if an error occurred.
@@ -258,5 +284,8 @@ return a key type or
258.Dv EVP_PKEY_NONE ) 284.Dv EVP_PKEY_NONE )
259on error. 285on error.
260.Sh SEE ALSO 286.Sh SEE ALSO
287.Xr DH_new 3 ,
288.Xr DSA_new 3 ,
289.Xr EC_KEY_new 3 ,
261.Xr EVP_PKEY_new 3 , 290.Xr EVP_PKEY_new 3 ,
262.Xr RSA_new 3 291.Xr RSA_new 3
diff --git a/src/lib/libcrypto/man/Makefile b/src/lib/libcrypto/man/Makefile
index 7043c8397b..77a6519685 100644
--- a/src/lib/libcrypto/man/Makefile
+++ b/src/lib/libcrypto/man/Makefile
@@ -1,4 +1,4 @@
1# $OpenBSD: Makefile,v 1.129 2018/02/15 14:52:16 schwarze Exp $ 1# $OpenBSD: Makefile,v 1.130 2018/02/17 16:59:48 schwarze Exp $
2 2
3.include <bsd.own.mk> 3.include <bsd.own.mk>
4 4
@@ -71,6 +71,7 @@ MAN= \
71 DH_generate_key.3 \ 71 DH_generate_key.3 \
72 DH_generate_parameters.3 \ 72 DH_generate_parameters.3 \
73 DH_get_ex_new_index.3 \ 73 DH_get_ex_new_index.3 \
74 DH_get0_pqg.3 \
74 DH_new.3 \ 75 DH_new.3 \
75 DH_set_method.3 \ 76 DH_set_method.3 \
76 DH_size.3 \ 77 DH_size.3 \
@@ -81,6 +82,7 @@ MAN= \
81 DSA_generate_key.3 \ 82 DSA_generate_key.3 \
82 DSA_generate_parameters.3 \ 83 DSA_generate_parameters.3 \
83 DSA_get_ex_new_index.3 \ 84 DSA_get_ex_new_index.3 \
85 DSA_get0_pqg.3 \
84 DSA_new.3 \ 86 DSA_new.3 \
85 DSA_set_method.3 \ 87 DSA_set_method.3 \
86 DSA_sign.3 \ 88 DSA_sign.3 \
@@ -185,6 +187,7 @@ MAN= \
185 RSA_check_key.3 \ 187 RSA_check_key.3 \
186 RSA_generate_key.3 \ 188 RSA_generate_key.3 \
187 RSA_get_ex_new_index.3 \ 189 RSA_get_ex_new_index.3 \
190 RSA_get0_key.3 \
188 RSA_new.3 \ 191 RSA_new.3 \
189 RSA_padding_add_PKCS1_type_1.3 \ 192 RSA_padding_add_PKCS1_type_1.3 \
190 RSA_print.3 \ 193 RSA_print.3 \
diff --git a/src/lib/libcrypto/man/RSA_check_key.3 b/src/lib/libcrypto/man/RSA_check_key.3
index cfce0bbbf8..691ee7a6eb 100644
--- a/src/lib/libcrypto/man/RSA_check_key.3
+++ b/src/lib/libcrypto/man/RSA_check_key.3
@@ -1,4 +1,4 @@
1.\" $OpenBSD: RSA_check_key.3,v 1.4 2016/12/11 12:21:48 schwarze Exp $ 1.\" $OpenBSD: RSA_check_key.3,v 1.5 2018/02/17 16:59:48 schwarze Exp $
2.\" OpenSSL 6859cf74 Sep 25 13:33:28 2002 +0000 2.\" OpenSSL 6859cf74 Sep 25 13:33:28 2002 +0000
3.\" 3.\"
4.\" This file was written by Ulf Moeller <ulf@openssl.org> and 4.\" This file was written by Ulf Moeller <ulf@openssl.org> and
@@ -49,7 +49,7 @@
49.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED 49.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
50.\" OF THE POSSIBILITY OF SUCH DAMAGE. 50.\" OF THE POSSIBILITY OF SUCH DAMAGE.
51.\" 51.\"
52.Dd $Mdocdate: December 11 2016 $ 52.Dd $Mdocdate: February 17 2018 $
53.Dt RSA_CHECK_KEY 3 53.Dt RSA_CHECK_KEY 3
54.Os 54.Os
55.Sh NAME 55.Sh NAME
@@ -126,6 +126,7 @@ obtained using
126.Sh SEE ALSO 126.Sh SEE ALSO
127.Xr BN_is_prime_ex 3 , 127.Xr BN_is_prime_ex 3 ,
128.Xr ERR_get_error 3 , 128.Xr ERR_get_error 3 ,
129.Xr RSA_get0_key 3 ,
129.Xr RSA_new 3 130.Xr RSA_new 3
130.Sh HISTORY 131.Sh HISTORY
131.Fn RSA_check_key 132.Fn RSA_check_key
diff --git a/src/lib/libcrypto/man/RSA_generate_key.3 b/src/lib/libcrypto/man/RSA_generate_key.3
index 838b10e2a9..ac6e5693dc 100644
--- a/src/lib/libcrypto/man/RSA_generate_key.3
+++ b/src/lib/libcrypto/man/RSA_generate_key.3
@@ -1,4 +1,4 @@
1.\" $OpenBSD: RSA_generate_key.3,v 1.6 2017/03/25 18:08:48 schwarze Exp $ 1.\" $OpenBSD: RSA_generate_key.3,v 1.7 2018/02/17 16:59:48 schwarze Exp $
2.\" OpenSSL RSA_generate_key.pod bb6c5e7f Feb 5 10:29:22 2017 -0500 2.\" OpenSSL RSA_generate_key.pod bb6c5e7f Feb 5 10:29:22 2017 -0500
3.\" 3.\"
4.\" This file was written by Ulf Moeller <ulf@openssl.org>. 4.\" This file was written by Ulf Moeller <ulf@openssl.org>.
@@ -48,7 +48,7 @@
48.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED 48.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
49.\" OF THE POSSIBILITY OF SUCH DAMAGE. 49.\" OF THE POSSIBILITY OF SUCH DAMAGE.
50.\" 50.\"
51.Dd $Mdocdate: March 25 2017 $ 51.Dd $Mdocdate: February 17 2018 $
52.Dt RSA_GENERATE_KEY 3 52.Dt RSA_GENERATE_KEY 3
53.Os 53.Os
54.Sh NAME 54.Sh NAME
@@ -143,6 +143,7 @@ The error codes can be obtained by
143.Sh SEE ALSO 143.Sh SEE ALSO
144.Xr BN_generate_prime 3 , 144.Xr BN_generate_prime 3 ,
145.Xr ERR_get_error 3 , 145.Xr ERR_get_error 3 ,
146.Xr RSA_get0_key 3 ,
146.Xr RSA_new 3 147.Xr RSA_new 3
147.Sh HISTORY 148.Sh HISTORY
148The 149The
diff --git a/src/lib/libcrypto/man/RSA_get0_key.3 b/src/lib/libcrypto/man/RSA_get0_key.3
new file mode 100644
index 0000000000..213dba396d
--- /dev/null
+++ b/src/lib/libcrypto/man/RSA_get0_key.3
@@ -0,0 +1,148 @@
1.\" $OpenBSD: RSA_get0_key.3,v 1.1 2018/02/17 16:59:48 schwarze Exp $
2.\" selective merge up to: OpenSSL 665d899f Aug 2 02:19:43 2017 +0800
3.\"
4.\" This file was written by Richard Levitte <levitte@openssl.org>
5.\" Copyright (c) 2016 The OpenSSL Project. All rights reserved.
6.\"
7.\" Redistribution and use in source and binary forms, with or without
8.\" modification, are permitted provided that the following conditions
9.\" are met:
10.\"
11.\" 1. Redistributions of source code must retain the above copyright
12.\" notice, this list of conditions and the following disclaimer.
13.\"
14.\" 2. Redistributions in binary form must reproduce the above copyright
15.\" notice, this list of conditions and the following disclaimer in
16.\" the documentation and/or other materials provided with the
17.\" distribution.
18.\"
19.\" 3. All advertising materials mentioning features or use of this
20.\" software must display the following acknowledgment:
21.\" "This product includes software developed by the OpenSSL Project
22.\" for use in the OpenSSL Toolkit. (http://www.openssl.org/)"
23.\"
24.\" 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to
25.\" endorse or promote products derived from this software without
26.\" prior written permission. For written permission, please contact
27.\" openssl-core@openssl.org.
28.\"
29.\" 5. Products derived from this software may not be called "OpenSSL"
30.\" nor may "OpenSSL" appear in their names without prior written
31.\" permission of the OpenSSL Project.
32.\"
33.\" 6. Redistributions of any form whatsoever must retain the following
34.\" acknowledgment:
35.\" "This product includes software developed by the OpenSSL Project
36.\" for use in the OpenSSL Toolkit (http://www.openssl.org/)"
37.\"
38.\" THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY
39.\" EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
40.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
41.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR
42.\" ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
43.\" SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
44.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
45.\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
46.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
47.\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
48.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
49.\" OF THE POSSIBILITY OF SUCH DAMAGE.
50.\"
51.Dd $Mdocdate: February 17 2018 $
52.Dt RSA_GET0_KEY 3
53.Os
54.Sh NAME
55.Nm RSA_get0_key ,
56.Nm RSA_set0_key
57.Nd get and set data in an RSA object
58.Sh SYNOPSIS
59.In openssl/rsa.h
60.Ft void
61.Fo RSA_get0_key
62.Fa "const RSA *r"
63.Fa "const BIGNUM **n"
64.Fa "const BIGNUM **e"
65.Fa "const BIGNUM **d"
66.Fc
67.Ft int
68.Fo RSA_set0_key
69.Fa "RSA *r"
70.Fa "BIGNUM *n"
71.Fa "BIGNUM *e"
72.Fa "BIGNUM *d"
73.Fc
74.Sh DESCRIPTION
75An
76.Vt RSA
77object contains the components for the public and private key.
78.Fa n
79is the modulus common to both public and private key,
80.Fa e
81is the public exponent and
82.Fa d
83is the private exponent.
84These parameters can be obtained by calling
85.Fn RSA_get0_key .
86If they have not been set yet, then
87.Pf * Fa n ,
88.Pf * Fa e ,
89and
90.Pf * Fa d
91will be set to
92.Dv NULL .
93Otherwise, they are set to pointers to the internal representations
94of the values that should not be freed by the caller.
95If any of the arguments is
96.Dv NULL ,
97the respective parameter is not retrieved.
98.Pp
99The
100.Fa n ,
101.Fa e ,
102and
103.Fa d
104parameter values can be set by calling
105.Fn RSA_set0_key .
106The values
107.Fa n
108and
109.Fa e
110must be
111.Pf non- Dv NULL
112the first time this function is called on a given
113.Vt RSA
114object.
115The value
116.Fa d
117may be
118.Dv NULL .
119On subsequent calls, any of these values may be
120.Dv NULL ,
121which means that the corresponding field is left untouched.
122Calling this function transfers the memory management of the values to
123the RSA object.
124Therefore, the values that have been passed in
125should not be freed by the caller.
126.Pp
127Values retrieved with
128.Fn RSA_get0_key
129are owned by the
130.Vt RSA
131object used in the call and may therefore
132.Em not
133be passed to
134.Fn RSA_set0_key .
135If needed, duplicate the received value using
136.Xr BN_dup 3
137and pass the duplicate.
138.Sh RETURN VALUES
139.Fn RSA_set0_key
140returns 1 on success or 0 on failure.
141.Sh SEE ALSO
142.Xr RSA_check_key 3 ,
143.Xr RSA_generate_key 3 ,
144.Xr RSA_new 3 ,
145.Xr RSA_print 3 ,
146.Xr RSA_size 3
147.Sh HISTORY
148These functions first appeared in OpenSSL 1.1.0.
diff --git a/src/lib/libcrypto/man/RSA_new.3 b/src/lib/libcrypto/man/RSA_new.3
index 9e43f03f1d..820c472751 100644
--- a/src/lib/libcrypto/man/RSA_new.3
+++ b/src/lib/libcrypto/man/RSA_new.3
@@ -1,4 +1,4 @@
1.\" $OpenBSD: RSA_new.3,v 1.4 2016/12/11 12:52:28 schwarze Exp $ 1.\" $OpenBSD: RSA_new.3,v 1.5 2018/02/17 16:59:48 schwarze Exp $
2.\" OpenSSL doc/man3/RSA_new.pod 99d63d46 Oct 26 13:56:48 2016 -0400 2.\" OpenSSL doc/man3/RSA_new.pod 99d63d46 Oct 26 13:56:48 2016 -0400
3.\" OpenSSL doc/crypto/rsa.pod 35d2e327 Jun 3 16:19:49 2016 -0400 3.\" OpenSSL doc/crypto/rsa.pod 35d2e327 Jun 3 16:19:49 2016 -0400
4.\" 4.\"
@@ -49,7 +49,7 @@
49.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED 49.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
50.\" OF THE POSSIBILITY OF SUCH DAMAGE. 50.\" OF THE POSSIBILITY OF SUCH DAMAGE.
51.\" 51.\"
52.Dd $Mdocdate: December 11 2016 $ 52.Dd $Mdocdate: February 17 2018 $
53.Dt RSA_NEW 3 53.Dt RSA_NEW 3
54.Os 54.Os
55.Sh NAME 55.Sh NAME
@@ -160,6 +160,7 @@ Otherwise it returns a pointer to the newly allocated structure.
160.Xr RSA_blinding_on 3 , 160.Xr RSA_blinding_on 3 ,
161.Xr RSA_check_key 3 , 161.Xr RSA_check_key 3 ,
162.Xr RSA_generate_key 3 , 162.Xr RSA_generate_key 3 ,
163.Xr RSA_get0_key 3 ,
163.Xr RSA_get_ex_new_index 3 , 164.Xr RSA_get_ex_new_index 3 ,
164.Xr RSA_padding_add_PKCS1_type_1 3 , 165.Xr RSA_padding_add_PKCS1_type_1 3 ,
165.Xr RSA_print 3 , 166.Xr RSA_print 3 ,
diff --git a/src/lib/libcrypto/man/RSA_print.3 b/src/lib/libcrypto/man/RSA_print.3
index de53af64dc..90c47a42fd 100644
--- a/src/lib/libcrypto/man/RSA_print.3
+++ b/src/lib/libcrypto/man/RSA_print.3
@@ -1,4 +1,4 @@
1.\" $OpenBSD: RSA_print.3,v 1.5 2016/12/11 12:21:48 schwarze Exp $ 1.\" $OpenBSD: RSA_print.3,v 1.6 2018/02/17 16:59:48 schwarze Exp $
2.\" OpenSSL 99d63d46 Oct 26 13:56:48 2016 -0400 2.\" OpenSSL 99d63d46 Oct 26 13:56:48 2016 -0400
3.\" 3.\"
4.\" This file was written by Ulf Moeller <ulf@openssl.org>. 4.\" This file was written by Ulf Moeller <ulf@openssl.org>.
@@ -48,7 +48,7 @@
48.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED 48.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
49.\" OF THE POSSIBILITY OF SUCH DAMAGE. 49.\" OF THE POSSIBILITY OF SUCH DAMAGE.
50.\" 50.\"
51.Dd $Mdocdate: December 11 2016 $ 51.Dd $Mdocdate: February 17 2018 $
52.Dt RSA_PRINT 3 52.Dt RSA_PRINT 3
53.Os 53.Os
54.Sh NAME 54.Sh NAME
@@ -123,6 +123,9 @@ spaces.
123These functions return 1 on success or 0 on error. 123These functions return 1 on success or 0 on error.
124.Sh SEE ALSO 124.Sh SEE ALSO
125.Xr BN_bn2bin 3 , 125.Xr BN_bn2bin 3 ,
126.Xr DH_get0_pqg 3 ,
127.Xr DSA_get0_pqg 3 ,
128.Xr RSA_get0_key 3 ,
126.Xr RSA_new 3 129.Xr RSA_new 3
127.Sh HISTORY 130.Sh HISTORY
128.Fn RSA_print , 131.Fn RSA_print ,
diff --git a/src/lib/libcrypto/man/RSA_size.3 b/src/lib/libcrypto/man/RSA_size.3
index fdd105158c..ffed9a109e 100644
--- a/src/lib/libcrypto/man/RSA_size.3
+++ b/src/lib/libcrypto/man/RSA_size.3
@@ -1,4 +1,4 @@
1.\" $OpenBSD: RSA_size.3,v 1.4 2016/12/11 12:21:48 schwarze Exp $ 1.\" $OpenBSD: RSA_size.3,v 1.5 2018/02/17 16:59:48 schwarze Exp $
2.\" OpenSSL 5bf73873 Aug 5 16:27:01 2002 +0000 2.\" OpenSSL 5bf73873 Aug 5 16:27:01 2002 +0000
3.\" 3.\"
4.\" This file was written by Ulf Moeller <ulf@openssl.org>. 4.\" This file was written by Ulf Moeller <ulf@openssl.org>.
@@ -48,7 +48,7 @@
48.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED 48.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
49.\" OF THE POSSIBILITY OF SUCH DAMAGE. 49.\" OF THE POSSIBILITY OF SUCH DAMAGE.
50.\" 50.\"
51.Dd $Mdocdate: December 11 2016 $ 51.Dd $Mdocdate: February 17 2018 $
52.Dt RSA_SIZE 3 52.Dt RSA_SIZE 3
53.Os 53.Os
54.Sh NAME 54.Sh NAME
@@ -73,6 +73,7 @@ must not be
73.Sh RETURN VALUES 73.Sh RETURN VALUES
74The size in bytes. 74The size in bytes.
75.Sh SEE ALSO 75.Sh SEE ALSO
76.Xr RSA_get0_key 3 ,
76.Xr RSA_new 3 77.Xr RSA_new 3
77.Sh HISTORY 78.Sh HISTORY
78.Fn RSA_size 79.Fn RSA_size