diff options
author | schwarze <> | 2018-03-18 13:06:36 +0000 |
---|---|---|
committer | schwarze <> | 2018-03-18 13:06:36 +0000 |
commit | ac5e5a82694c6e8870a59db61d2d5a41c8b614b4 (patch) | |
tree | 82fc44948c57a5d70071500c33b2409011a815cf | |
parent | 93551066da4405c7e070acc4f1811fa018881e1a (diff) | |
download | openbsd-ac5e5a82694c6e8870a59db61d2d5a41c8b614b4.tar.gz openbsd-ac5e5a82694c6e8870a59db61d2d5a41c8b614b4.tar.bz2 openbsd-ac5e5a82694c6e8870a59db61d2d5a41c8b614b4.zip |
In rsa.h rev. 1.38 2018/03/17 15:12:56 and dsa.h rev. 1.30 2018/03/17
15:19:12, tb@ provided a subset of the DSA_meth_*(3) and RSA_meth_*(3)
functions. Merge the relevant parts of the manual pages from
OpenSSL, heavily tweaked by me, in particular for conciseness.
-rw-r--r-- | src/lib/libcrypto/man/DSA_do_sign.3 | 5 | ||||
-rw-r--r-- | src/lib/libcrypto/man/DSA_meth_new.3 | 183 | ||||
-rw-r--r-- | src/lib/libcrypto/man/DSA_new.3 | 5 | ||||
-rw-r--r-- | src/lib/libcrypto/man/DSA_set_method.3 | 5 | ||||
-rw-r--r-- | src/lib/libcrypto/man/Makefile | 4 | ||||
-rw-r--r-- | src/lib/libcrypto/man/RSA_meth_new.3 | 193 | ||||
-rw-r--r-- | src/lib/libcrypto/man/RSA_new.3 | 5 | ||||
-rw-r--r-- | src/lib/libcrypto/man/RSA_private_encrypt.3 | 5 | ||||
-rw-r--r-- | src/lib/libcrypto/man/RSA_public_encrypt.3 | 5 | ||||
-rw-r--r-- | src/lib/libcrypto/man/RSA_set_method.3 | 5 |
10 files changed, 400 insertions, 15 deletions
diff --git a/src/lib/libcrypto/man/DSA_do_sign.3 b/src/lib/libcrypto/man/DSA_do_sign.3 index 9d0696e44b..8d0a6cbb8a 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.6 2018/02/17 16:59:48 schwarze Exp $ | 1 | .\" $OpenBSD: DSA_do_sign.3,v 1.7 2018/03/18 13:06:36 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: February 17 2018 $ | 51 | .Dd $Mdocdate: March 18 2018 $ |
52 | .Dt DSA_DO_SIGN 3 | 52 | .Dt DSA_DO_SIGN 3 |
53 | .Os | 53 | .Os |
54 | .Sh NAME | 54 | .Sh NAME |
@@ -107,6 +107,7 @@ The 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_get0_key 3 , |
110 | .Xr DSA_meth_set_sign 3 , | ||
110 | .Xr DSA_new 3 , | 111 | .Xr DSA_new 3 , |
111 | .Xr DSA_SIG_new 3 , | 112 | .Xr DSA_SIG_new 3 , |
112 | .Xr DSA_sign 3 , | 113 | .Xr DSA_sign 3 , |
diff --git a/src/lib/libcrypto/man/DSA_meth_new.3 b/src/lib/libcrypto/man/DSA_meth_new.3 new file mode 100644 index 0000000000..41f4382422 --- /dev/null +++ b/src/lib/libcrypto/man/DSA_meth_new.3 | |||
@@ -0,0 +1,183 @@ | |||
1 | .\" $OpenBSD: DSA_meth_new.3,v 1.1 2018/03/18 13:06:36 schwarze Exp $ | ||
2 | .\" selective merge up to: OpenSSL a970b14f Jul 31 18:58:40 2017 -0400 | ||
3 | .\" | ||
4 | .\" This file is a derived work. | ||
5 | .\" The changes are covered by the following Copyright and license: | ||
6 | .\" | ||
7 | .\" Copyright (c) 2018 Ingo Schwarze <schwarze@openbsd.org> | ||
8 | .\" | ||
9 | .\" Permission to use, copy, modify, and distribute this software for any | ||
10 | .\" purpose with or without fee is hereby granted, provided that the above | ||
11 | .\" copyright notice and this permission notice appear in all copies. | ||
12 | .\" | ||
13 | .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES | ||
14 | .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF | ||
15 | .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR | ||
16 | .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES | ||
17 | .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN | ||
18 | .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF | ||
19 | .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. | ||
20 | .\" | ||
21 | .\" The original file was written by Matt Caswell <matt@openssl.org>. | ||
22 | .\" Copyright (c) 2016 The OpenSSL Project. All rights reserved. | ||
23 | .\" | ||
24 | .\" Redistribution and use in source and binary forms, with or without | ||
25 | .\" modification, are permitted provided that the following conditions | ||
26 | .\" are met: | ||
27 | .\" | ||
28 | .\" 1. Redistributions of source code must retain the above copyright | ||
29 | .\" notice, this list of conditions and the following disclaimer. | ||
30 | .\" | ||
31 | .\" 2. Redistributions in binary form must reproduce the above copyright | ||
32 | .\" notice, this list of conditions and the following disclaimer in | ||
33 | .\" the documentation and/or other materials provided with the | ||
34 | .\" distribution. | ||
35 | .\" | ||
36 | .\" 3. All advertising materials mentioning features or use of this | ||
37 | .\" software must display the following acknowledgment: | ||
38 | .\" "This product includes software developed by the OpenSSL Project | ||
39 | .\" for use in the OpenSSL Toolkit. (http://www.openssl.org/)" | ||
40 | .\" | ||
41 | .\" 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to | ||
42 | .\" endorse or promote products derived from this software without | ||
43 | .\" prior written permission. For written permission, please contact | ||
44 | .\" openssl-core@openssl.org. | ||
45 | .\" | ||
46 | .\" 5. Products derived from this software may not be called "OpenSSL" | ||
47 | .\" nor may "OpenSSL" appear in their names without prior written | ||
48 | .\" permission of the OpenSSL Project. | ||
49 | .\" | ||
50 | .\" 6. Redistributions of any form whatsoever must retain the following | ||
51 | .\" acknowledgment: | ||
52 | .\" "This product includes software developed by the OpenSSL Project | ||
53 | .\" for use in the OpenSSL Toolkit (http://www.openssl.org/)" | ||
54 | .\" | ||
55 | .\" THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY | ||
56 | .\" EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE | ||
57 | .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR | ||
58 | .\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR | ||
59 | .\" ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, | ||
60 | .\" SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT | ||
61 | .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; | ||
62 | .\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | ||
63 | .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, | ||
64 | .\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) | ||
65 | .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED | ||
66 | .\" OF THE POSSIBILITY OF SUCH DAMAGE. | ||
67 | .\" | ||
68 | .Dd $Mdocdate: March 18 2018 $ | ||
69 | .Dt DSA_METH_NEW 3 | ||
70 | .Os | ||
71 | .Sh NAME | ||
72 | .Nm DSA_meth_new , | ||
73 | .Nm DSA_meth_free , | ||
74 | .Nm DSA_meth_dup , | ||
75 | .Nm DSA_meth_set_sign , | ||
76 | .Nm DSA_meth_set_finish | ||
77 | .Nd build up DSA methods | ||
78 | .Sh SYNOPSIS | ||
79 | .In openssl/dsa.h | ||
80 | .Ft DSA_METHOD * | ||
81 | .Fo DSA_meth_new | ||
82 | .Fa "const char *name" | ||
83 | .Fa "int flags" | ||
84 | .Fc | ||
85 | .Ft void | ||
86 | .Fo DSA_meth_free | ||
87 | .Fa "DSA_METHOD *meth" | ||
88 | .Fc | ||
89 | .Ft DSA_METHOD * | ||
90 | .Fo DSA_meth_dup | ||
91 | .Fa "const DSA_METHOD *meth" | ||
92 | .Fc | ||
93 | .Ft int | ||
94 | .Fo DSA_meth_set_sign | ||
95 | .Fa "DSA_METHOD *meth" | ||
96 | .Fa "DSA_SIG *(*sign)(const unsigned char *, int, DSA *)" | ||
97 | .Fc | ||
98 | .Ft int | ||
99 | .Fo DSA_meth_set_finish | ||
100 | .Fa "DSA_METHOD *meth" | ||
101 | .Fa "int (*finish)(DSA *)" | ||
102 | .Fc | ||
103 | .Sh DESCRIPTION | ||
104 | The | ||
105 | .Vt DSA_METHOD | ||
106 | structure holds function pinters for custom DSA implementations. | ||
107 | .Pp | ||
108 | .Fn DSA_meth_new | ||
109 | creates a new | ||
110 | .Vt DSA_METHOD | ||
111 | structure. | ||
112 | A copy of the NUL-terminated | ||
113 | .Fa name | ||
114 | is stored in the new | ||
115 | .Vt DSA_METHOD | ||
116 | object. | ||
117 | Any new | ||
118 | .Vt DSA | ||
119 | object constructed from this | ||
120 | .Vt DSA_METHOD | ||
121 | will have the given | ||
122 | .Fa flags | ||
123 | set by default. | ||
124 | .Pp | ||
125 | .Fn DSA_meth_dup | ||
126 | creates a deep copy of | ||
127 | .Fa meth . | ||
128 | This might be useful for creating a new | ||
129 | .Vt DSA_METHOD | ||
130 | based on an existing one, but with some differences. | ||
131 | .Pp | ||
132 | .Fn DSA_meth_free | ||
133 | destroys | ||
134 | .Fa meth | ||
135 | and frees any memory associated with it. | ||
136 | .Pp | ||
137 | .Fn DSA_meth_set_sign | ||
138 | sets the function used for creating a DSA signature. | ||
139 | This function will be called from | ||
140 | .Xr DSA_do_sign 3 | ||
141 | and indirectly from | ||
142 | .Xr DSA_sign 3 . | ||
143 | The parameters of | ||
144 | .Fa sign | ||
145 | have the same meaning as for | ||
146 | .Xr DSA_do_sign 3 . | ||
147 | .Pp | ||
148 | .Fn DSA_meth_set_finish | ||
149 | sets an optional function for destroying a | ||
150 | .Vt DSA | ||
151 | object. | ||
152 | Unless | ||
153 | .Fa finish | ||
154 | is | ||
155 | .Dv NULL , | ||
156 | it will be called from | ||
157 | .Xr DSA_free 3 . | ||
158 | It takes the same argument | ||
159 | and is intended to do DSA implementation specific cleanup. | ||
160 | The memory used by the | ||
161 | .Vt DSA | ||
162 | object itself should not be freed by the | ||
163 | .Fa finish | ||
164 | function. | ||
165 | .Sh RETURN VALUES | ||
166 | .Fn DSA_meth_new | ||
167 | and | ||
168 | .Fn DSA_meth_dup | ||
169 | return the newly allocated DSA_METHOD object or NULL on failure. | ||
170 | .Pp | ||
171 | All | ||
172 | .Fn DSA_meth_set_* | ||
173 | functions return 1 on success or 0 on failure. | ||
174 | .Sh SEE ALSO | ||
175 | .Xr DSA_do_sign 3 , | ||
176 | .Xr DSA_new 3 , | ||
177 | .Xr DSA_set_method 3 , | ||
178 | .Xr DSA_SIG_new 3 , | ||
179 | .Xr DSA_sign 3 | ||
180 | .Sh HISTORY | ||
181 | These functions first appeared in OpenSSL 1.1.0 | ||
182 | and have been available since | ||
183 | .Ox 6.3 . | ||
diff --git a/src/lib/libcrypto/man/DSA_new.3 b/src/lib/libcrypto/man/DSA_new.3 index 817671093c..f85234e4f4 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.6 2018/02/17 16:59:48 schwarze Exp $ | 1 | .\" $OpenBSD: DSA_new.3,v 1.7 2018/03/18 13:06:36 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: February 17 2018 $ | 51 | .Dd $Mdocdate: March 18 2018 $ |
52 | .Dt DSA_NEW 3 | 52 | .Dt DSA_NEW 3 |
53 | .Os | 53 | .Os |
54 | .Sh NAME | 54 | .Sh NAME |
@@ -101,6 +101,7 @@ Otherwise it returns a pointer to the newly allocated structure. | |||
101 | .Xr DSA_generate_parameters 3 , | 101 | .Xr DSA_generate_parameters 3 , |
102 | .Xr DSA_get0_pqg 3 , | 102 | .Xr DSA_get0_pqg 3 , |
103 | .Xr DSA_get_ex_new_index 3 , | 103 | .Xr DSA_get_ex_new_index 3 , |
104 | .Xr DSA_meth_new 3 , | ||
104 | .Xr DSA_print 3 , | 105 | .Xr DSA_print 3 , |
105 | .Xr DSA_set_method 3 , | 106 | .Xr DSA_set_method 3 , |
106 | .Xr DSA_SIG_new 3 , | 107 | .Xr DSA_SIG_new 3 , |
diff --git a/src/lib/libcrypto/man/DSA_set_method.3 b/src/lib/libcrypto/man/DSA_set_method.3 index 344ec7c9b0..9b8412426a 100644 --- a/src/lib/libcrypto/man/DSA_set_method.3 +++ b/src/lib/libcrypto/man/DSA_set_method.3 | |||
@@ -1,4 +1,4 @@ | |||
1 | .\" $OpenBSD: DSA_set_method.3,v 1.6 2016/12/10 22:47:49 schwarze Exp $ | 1 | .\" $OpenBSD: DSA_set_method.3,v 1.7 2018/03/18 13:06:36 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: March 18 2018 $ |
52 | .Dt DSA_SET_METHOD 3 | 52 | .Dt DSA_SET_METHOD 3 |
53 | .Os | 53 | .Os |
54 | .Sh NAME | 54 | .Sh NAME |
@@ -223,6 +223,7 @@ and sets an error code that can be obtained by | |||
223 | if the allocation fails. | 223 | if the allocation fails. |
224 | Otherwise it returns a pointer to the newly allocated structure. | 224 | Otherwise it returns a pointer to the newly allocated structure. |
225 | .Sh SEE ALSO | 225 | .Sh SEE ALSO |
226 | .Xr DSA_meth_new 3 , | ||
226 | .Xr DSA_new 3 | 227 | .Xr DSA_new 3 |
227 | .Sh HISTORY | 228 | .Sh HISTORY |
228 | .Fn DSA_set_default_method , | 229 | .Fn DSA_set_default_method , |
diff --git a/src/lib/libcrypto/man/Makefile b/src/lib/libcrypto/man/Makefile index 8d2e242f31..0405a06663 100644 --- a/src/lib/libcrypto/man/Makefile +++ b/src/lib/libcrypto/man/Makefile | |||
@@ -1,4 +1,4 @@ | |||
1 | # $OpenBSD: Makefile,v 1.137 2018/03/17 18:52:42 schwarze Exp $ | 1 | # $OpenBSD: Makefile,v 1.138 2018/03/18 13:06:36 schwarze Exp $ |
2 | 2 | ||
3 | .include <bsd.own.mk> | 3 | .include <bsd.own.mk> |
4 | 4 | ||
@@ -85,6 +85,7 @@ MAN= \ | |||
85 | DSA_generate_parameters.3 \ | 85 | DSA_generate_parameters.3 \ |
86 | DSA_get_ex_new_index.3 \ | 86 | DSA_get_ex_new_index.3 \ |
87 | DSA_get0_pqg.3 \ | 87 | DSA_get0_pqg.3 \ |
88 | DSA_meth_new.3 \ | ||
88 | DSA_new.3 \ | 89 | DSA_new.3 \ |
89 | DSA_set_method.3 \ | 90 | DSA_set_method.3 \ |
90 | DSA_sign.3 \ | 91 | DSA_sign.3 \ |
@@ -192,6 +193,7 @@ MAN= \ | |||
192 | RSA_generate_key.3 \ | 193 | RSA_generate_key.3 \ |
193 | RSA_get_ex_new_index.3 \ | 194 | RSA_get_ex_new_index.3 \ |
194 | RSA_get0_key.3 \ | 195 | RSA_get0_key.3 \ |
196 | RSA_meth_new.3 \ | ||
195 | RSA_new.3 \ | 197 | RSA_new.3 \ |
196 | RSA_padding_add_PKCS1_type_1.3 \ | 198 | RSA_padding_add_PKCS1_type_1.3 \ |
197 | RSA_print.3 \ | 199 | RSA_print.3 \ |
diff --git a/src/lib/libcrypto/man/RSA_meth_new.3 b/src/lib/libcrypto/man/RSA_meth_new.3 new file mode 100644 index 0000000000..ae3ca88adb --- /dev/null +++ b/src/lib/libcrypto/man/RSA_meth_new.3 | |||
@@ -0,0 +1,193 @@ | |||
1 | .\" $OpenBSD: RSA_meth_new.3,v 1.1 2018/03/18 13:06:36 schwarze Exp $ | ||
2 | .\" selective merge up to: OpenSSL a970b14f Jul 31 18:58:40 2017 -0400 | ||
3 | .\" | ||
4 | .\" This file is a derived work. | ||
5 | .\" The changes are covered by the following Copyright and license: | ||
6 | .\" | ||
7 | .\" Copyright (c) 2018 Ingo Schwarze <schwarze@openbsd.org> | ||
8 | .\" | ||
9 | .\" Permission to use, copy, modify, and distribute this software for any | ||
10 | .\" purpose with or without fee is hereby granted, provided that the above | ||
11 | .\" copyright notice and this permission notice appear in all copies. | ||
12 | .\" | ||
13 | .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES | ||
14 | .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF | ||
15 | .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR | ||
16 | .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES | ||
17 | .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN | ||
18 | .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF | ||
19 | .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. | ||
20 | .\" | ||
21 | .\" The original file was written by Richard Levitte <levitte@openssl.org>. | ||
22 | .\" Copyright (c) 2016 The OpenSSL Project. All rights reserved. | ||
23 | .\" | ||
24 | .\" Redistribution and use in source and binary forms, with or without | ||
25 | .\" modification, are permitted provided that the following conditions | ||
26 | .\" are met: | ||
27 | .\" | ||
28 | .\" 1. Redistributions of source code must retain the above copyright | ||
29 | .\" notice, this list of conditions and the following disclaimer. | ||
30 | .\" | ||
31 | .\" 2. Redistributions in binary form must reproduce the above copyright | ||
32 | .\" notice, this list of conditions and the following disclaimer in | ||
33 | .\" the documentation and/or other materials provided with the | ||
34 | .\" distribution. | ||
35 | .\" | ||
36 | .\" 3. All advertising materials mentioning features or use of this | ||
37 | .\" software must display the following acknowledgment: | ||
38 | .\" "This product includes software developed by the OpenSSL Project | ||
39 | .\" for use in the OpenSSL Toolkit. (http://www.openssl.org/)" | ||
40 | .\" | ||
41 | .\" 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to | ||
42 | .\" endorse or promote products derived from this software without | ||
43 | .\" prior written permission. For written permission, please contact | ||
44 | .\" openssl-core@openssl.org. | ||
45 | .\" | ||
46 | .\" 5. Products derived from this software may not be called "OpenSSL" | ||
47 | .\" nor may "OpenSSL" appear in their names without prior written | ||
48 | .\" permission of the OpenSSL Project. | ||
49 | .\" | ||
50 | .\" 6. Redistributions of any form whatsoever must retain the following | ||
51 | .\" acknowledgment: | ||
52 | .\" "This product includes software developed by the OpenSSL Project | ||
53 | .\" for use in the OpenSSL Toolkit (http://www.openssl.org/)" | ||
54 | .\" | ||
55 | .\" THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY | ||
56 | .\" EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE | ||
57 | .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR | ||
58 | .\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR | ||
59 | .\" ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, | ||
60 | .\" SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT | ||
61 | .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; | ||
62 | .\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | ||
63 | .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, | ||
64 | .\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) | ||
65 | .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED | ||
66 | .\" OF THE POSSIBILITY OF SUCH DAMAGE. | ||
67 | .\" | ||
68 | .Dd $Mdocdate: March 18 2018 $ | ||
69 | .Dt RSA_METH_NEW 3 | ||
70 | .Os | ||
71 | .Sh NAME | ||
72 | .Nm RSA_meth_new , | ||
73 | .Nm RSA_meth_free , | ||
74 | .Nm RSA_meth_dup , | ||
75 | .Nm RSA_meth_set_finish , | ||
76 | .Nm RSA_meth_set_priv_enc , | ||
77 | .Nm RSA_meth_set_priv_dec | ||
78 | .Nd build up RSA methods | ||
79 | .Sh SYNOPSIS | ||
80 | .In openssl/rsa.h | ||
81 | .Ft RSA_METHOD * | ||
82 | .Fo RSA_meth_new | ||
83 | .Fa "const char *name" | ||
84 | .Fa "int flags" | ||
85 | .Fc | ||
86 | .Ft void | ||
87 | .Fo RSA_meth_free | ||
88 | .Fa "RSA_METHOD *meth" | ||
89 | .Fc | ||
90 | .Ft RSA_METHOD * | ||
91 | .Fo RSA_meth_dup | ||
92 | .Fa "const RSA_METHOD *meth" | ||
93 | .Fc | ||
94 | .Ft int | ||
95 | .Fo RSA_meth_set_finish | ||
96 | .Fa "RSA_METHOD *meth" | ||
97 | .Fa "int (*finish)(RSA *rsa)" | ||
98 | .Fc | ||
99 | .Ft int | ||
100 | .Fo RSA_meth_set_priv_enc | ||
101 | .Fa "RSA_METHOD *meth" | ||
102 | .Fa "int (*priv_enc)(int flen, const unsigned char *from,\ | ||
103 | unsigned char *to, RSA *rsa, int padding)" | ||
104 | .Fc | ||
105 | .Ft int | ||
106 | .Fo RSA_meth_set_priv_dec | ||
107 | .Fa "RSA_METHOD *meth" | ||
108 | .Fa "int (*priv_dec)(int flen, const unsigned char *from,\ | ||
109 | unsigned char *to, RSA *rsa, int padding)" | ||
110 | .Fc | ||
111 | .Sh DESCRIPTION | ||
112 | The | ||
113 | .Vt RSA_METHOD | ||
114 | structure holds function pointers for custom RSA implementations. | ||
115 | .Pp | ||
116 | .Fn RSA_meth_new | ||
117 | creates a new | ||
118 | .Vt RSA_METHOD | ||
119 | structure. | ||
120 | A copy of the NUL-terminated | ||
121 | .Fa name | ||
122 | is stored in the new | ||
123 | .Vt RSA_METHOD | ||
124 | object. | ||
125 | Any new | ||
126 | .Vt RSA | ||
127 | object constructed from this | ||
128 | .Vt RSA_METHOD | ||
129 | will have the given | ||
130 | .Fa flags | ||
131 | set by default. | ||
132 | .Pp | ||
133 | .Fn RSA_meth_dup | ||
134 | creates a deep copy of | ||
135 | .Fa meth . | ||
136 | This might be useful for creating a new | ||
137 | .Vt RSA_METHOD | ||
138 | based on an existing one, but with some differences. | ||
139 | .Pp | ||
140 | .Fn RSA_meth_free | ||
141 | destroys | ||
142 | .Fa meth | ||
143 | and frees any memory associated with it. | ||
144 | .Pp | ||
145 | .Fn RSA_meth_set_finish | ||
146 | sets an optional function for destroying an | ||
147 | .Vt RSA | ||
148 | object. | ||
149 | Unless | ||
150 | .Fa finish | ||
151 | is | ||
152 | .Dv NULL , | ||
153 | it will be called from | ||
154 | .Xr RSA_free 3 . | ||
155 | It takes the same argument | ||
156 | and is intended to do RSA implementation specific cleanup. | ||
157 | The memory used by the | ||
158 | .Vt RSA | ||
159 | object itself should not be freed by the | ||
160 | .Fa finish | ||
161 | function. | ||
162 | .Pp | ||
163 | .Fn RSA_meth_set_priv_enc | ||
164 | and | ||
165 | .Fn RSA_meth_set_priv_dec | ||
166 | set the functions used for private key encryption and decryption. | ||
167 | These functions will be called from | ||
168 | .Xr RSA_private_decrypt 3 | ||
169 | and | ||
170 | .Xr RSA_private_encrypt 3 | ||
171 | and take the same parameters as those. | ||
172 | .Sh RETURN VALUES | ||
173 | .Fn RSA_meth_new | ||
174 | and | ||
175 | .Fn RSA_meth_dup | ||
176 | return the newly allocated | ||
177 | .Vt RSA_METHOD | ||
178 | object or | ||
179 | .Dv NULL | ||
180 | on failure. | ||
181 | .Pp | ||
182 | All | ||
183 | .Fn RSA_meth_set_* | ||
184 | functions return 1 on success or 0 on failure. | ||
185 | .Sh SEE ALSO | ||
186 | .Xr RSA_new 3 , | ||
187 | .Xr RSA_private_decrypt 3 , | ||
188 | .Xr RSA_private_encrypt 3 , | ||
189 | .Xr RSA_set_method 3 | ||
190 | .Sh HISTORY | ||
191 | These functions first appeared in OpenSSL 1.1.0 | ||
192 | and have been available since | ||
193 | .Ox 6.3 . | ||
diff --git a/src/lib/libcrypto/man/RSA_new.3 b/src/lib/libcrypto/man/RSA_new.3 index 820c472751..250d46c1dc 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.5 2018/02/17 16:59:48 schwarze Exp $ | 1 | .\" $OpenBSD: RSA_new.3,v 1.6 2018/03/18 13:06:36 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: February 17 2018 $ | 52 | .Dd $Mdocdate: March 18 2018 $ |
53 | .Dt RSA_NEW 3 | 53 | .Dt RSA_NEW 3 |
54 | .Os | 54 | .Os |
55 | .Sh NAME | 55 | .Sh NAME |
@@ -162,6 +162,7 @@ Otherwise it returns a pointer to the newly allocated structure. | |||
162 | .Xr RSA_generate_key 3 , | 162 | .Xr RSA_generate_key 3 , |
163 | .Xr RSA_get0_key 3 , | 163 | .Xr RSA_get0_key 3 , |
164 | .Xr RSA_get_ex_new_index 3 , | 164 | .Xr RSA_get_ex_new_index 3 , |
165 | .Xr RSA_meth_new 3 , | ||
165 | .Xr RSA_padding_add_PKCS1_type_1 3 , | 166 | .Xr RSA_padding_add_PKCS1_type_1 3 , |
166 | .Xr RSA_print 3 , | 167 | .Xr RSA_print 3 , |
167 | .Xr RSA_private_encrypt 3 , | 168 | .Xr RSA_private_encrypt 3 , |
diff --git a/src/lib/libcrypto/man/RSA_private_encrypt.3 b/src/lib/libcrypto/man/RSA_private_encrypt.3 index 385c11694e..8171ff7823 100644 --- a/src/lib/libcrypto/man/RSA_private_encrypt.3 +++ b/src/lib/libcrypto/man/RSA_private_encrypt.3 | |||
@@ -1,4 +1,4 @@ | |||
1 | .\" $OpenBSD: RSA_private_encrypt.3,v 1.6 2017/03/25 18:14:17 schwarze Exp $ | 1 | .\" $OpenBSD: RSA_private_encrypt.3,v 1.7 2018/03/18 13:06:36 schwarze Exp $ |
2 | .\" OpenSSL RSA_private_encrypt.pod b41f6b64 Mar 10 15:49:04 2017 +0000 | 2 | .\" OpenSSL RSA_private_encrypt.pod b41f6b64 Mar 10 15:49:04 2017 +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: March 25 2017 $ | 51 | .Dd $Mdocdate: March 18 2018 $ |
52 | .Dt RSA_PRIVATE_ENCRYPT 3 | 52 | .Dt RSA_PRIVATE_ENCRYPT 3 |
53 | .Os | 53 | .Os |
54 | .Sh NAME | 54 | .Sh NAME |
@@ -136,6 +136,7 @@ On error, -1 is returned; the error codes can be obtained by | |||
136 | .Xr ERR_get_error 3 . | 136 | .Xr ERR_get_error 3 . |
137 | .Sh SEE ALSO | 137 | .Sh SEE ALSO |
138 | .Xr ERR_get_error 3 , | 138 | .Xr ERR_get_error 3 , |
139 | .Xr RSA_meth_set_priv_enc 3 , | ||
139 | .Xr RSA_new 3 , | 140 | .Xr RSA_new 3 , |
140 | .Xr RSA_sign 3 , | 141 | .Xr RSA_sign 3 , |
141 | .Xr RSA_verify 3 | 142 | .Xr RSA_verify 3 |
diff --git a/src/lib/libcrypto/man/RSA_public_encrypt.3 b/src/lib/libcrypto/man/RSA_public_encrypt.3 index be90fb12d8..0b23381d9a 100644 --- a/src/lib/libcrypto/man/RSA_public_encrypt.3 +++ b/src/lib/libcrypto/man/RSA_public_encrypt.3 | |||
@@ -1,4 +1,4 @@ | |||
1 | .\" $OpenBSD: RSA_public_encrypt.3,v 1.8 2017/08/28 17:41:59 jsing Exp $ | 1 | .\" $OpenBSD: RSA_public_encrypt.3,v 1.9 2018/03/18 13:06:36 schwarze Exp $ |
2 | .\" OpenSSL RSA_public_encrypt.pod 1e3f62a3 Jul 17 16:47:13 2017 +0200 | 2 | .\" OpenSSL RSA_public_encrypt.pod 1e3f62a3 Jul 17 16:47:13 2017 +0200 |
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: August 28 2017 $ | 51 | .Dd $Mdocdate: March 18 2018 $ |
52 | .Dt RSA_PUBLIC_ENCRYPT 3 | 52 | .Dt RSA_PUBLIC_ENCRYPT 3 |
53 | .Os | 53 | .Os |
54 | .Sh NAME | 54 | .Sh NAME |
@@ -143,6 +143,7 @@ On error, -1 is returned; the error codes can be obtained by | |||
143 | .Xr ERR_get_error 3 . | 143 | .Xr ERR_get_error 3 . |
144 | .Sh SEE ALSO | 144 | .Sh SEE ALSO |
145 | .Xr ERR_get_error 3 , | 145 | .Xr ERR_get_error 3 , |
146 | .Xr RSA_meth_set_priv_dec 3 , | ||
146 | .Xr RSA_new 3 , | 147 | .Xr RSA_new 3 , |
147 | .Xr RSA_size 3 | 148 | .Xr RSA_size 3 |
148 | .Sh STANDARDS | 149 | .Sh STANDARDS |
diff --git a/src/lib/libcrypto/man/RSA_set_method.3 b/src/lib/libcrypto/man/RSA_set_method.3 index f9ec19f97b..46cdbc379e 100644 --- a/src/lib/libcrypto/man/RSA_set_method.3 +++ b/src/lib/libcrypto/man/RSA_set_method.3 | |||
@@ -1,4 +1,4 @@ | |||
1 | .\" $OpenBSD: RSA_set_method.3,v 1.5 2016/12/11 12:21:48 schwarze Exp $ | 1 | .\" $OpenBSD: RSA_set_method.3,v 1.6 2018/03/18 13:06:36 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> |
@@ -50,7 +50,7 @@ | |||
50 | .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED | 50 | .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED |
51 | .\" OF THE POSSIBILITY OF SUCH DAMAGE. | 51 | .\" OF THE POSSIBILITY OF SUCH DAMAGE. |
52 | .\" | 52 | .\" |
53 | .Dd $Mdocdate: December 11 2016 $ | 53 | .Dd $Mdocdate: March 18 2018 $ |
54 | .Dt RSA_SET_METHOD 3 | 54 | .Dt RSA_SET_METHOD 3 |
55 | .Os | 55 | .Os |
56 | .Sh NAME | 56 | .Sh NAME |
@@ -300,6 +300,7 @@ and sets an error code that can be obtained by | |||
300 | if the allocation fails. | 300 | if the allocation fails. |
301 | Otherwise it returns a pointer to the newly allocated structure. | 301 | Otherwise it returns a pointer to the newly allocated structure. |
302 | .Sh SEE ALSO | 302 | .Sh SEE ALSO |
303 | .Xr RSA_meth_new 3 , | ||
303 | .Xr RSA_new 3 | 304 | .Xr RSA_new 3 |
304 | .Sh HISTORY | 305 | .Sh HISTORY |
305 | .Fn RSA_new_method | 306 | .Fn RSA_new_method |