summaryrefslogtreecommitdiff
path: root/src/lib/libcrypto/man/RSA_set_method.3
diff options
context:
space:
mode:
Diffstat (limited to '')
-rw-r--r--src/lib/libcrypto/man/RSA_set_method.344
1 files changed, 8 insertions, 36 deletions
diff --git a/src/lib/libcrypto/man/RSA_set_method.3 b/src/lib/libcrypto/man/RSA_set_method.3
index 818b64823d..ffe22c116f 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.17 2023/05/14 09:33:19 tb Exp $ 1.\" $OpenBSD: RSA_set_method.3,v 1.18 2023/11/19 10:34:26 tb 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: May 14 2023 $ 53.Dd $Mdocdate: November 19 2023 $
54.Dt RSA_SET_METHOD 3 54.Dt RSA_SET_METHOD 3
55.Os 55.Os
56.Sh NAME 56.Sh NAME
@@ -105,16 +105,9 @@ selects
105as the default method for all 105as the default method for all
106.Vt RSA 106.Vt RSA
107structures created later. 107structures created later.
108If any
109.Vt ENGINE
110was registered with
111.Xr ENGINE_register_RSA 3
112that can be successfully initialized, it overrides the default.
113.Pp 108.Pp
114.Fn RSA_get_default_method 109.Fn RSA_get_default_method
115returns a pointer to the current default method, 110returns a pointer to the current default method.
116even if it is actually overridden by an
117.Vt ENGINE .
118.Pp 111.Pp
119.Fn RSA_set_method 112.Fn RSA_set_method
120selects 113selects
@@ -127,10 +120,7 @@ used by the RSA key, calling the
127.Fa finish 120.Fa finish
128function set up with 121function set up with
129.Xr RSA_meth_set_finish 3 122.Xr RSA_meth_set_finish 3
130if any, and if the previous method was supplied by an 123if any.
131.Vt ENGINE ,
132.Xr ENGINE_finish 3
133is called on it.
134If 124If
135.Fa meth 125.Fa meth
136contains an 126contains an
@@ -142,9 +132,7 @@ that function is called just before returning from
142.Pp 132.Pp
143It is possible to have RSA keys that only work with certain 133It is possible to have RSA keys that only work with certain
144.Vt RSA_METHOD 134.Vt RSA_METHOD
145implementations (e.g. from an 135implementations,
146.Vt ENGINE
147module that supports embedded hardware-protected keys),
148and in such cases attempting to change the 136and in such cases attempting to change the
149.Vt RSA_METHOD 137.Vt RSA_METHOD
150for the key can have unexpected results. 138for the key can have unexpected results.
@@ -154,12 +142,6 @@ returns a pointer to the
154.Vt RSA_METHOD 142.Vt RSA_METHOD
155being used by 143being used by
156.Fa rsa . 144.Fa rsa .
157This method may or may not be supplied by an
158.Vt ENGINE
159implementation but if it is, the return value can only be guaranteed
160to be valid as long as the RSA key itself is valid and does not
161have its implementation changed by
162.Fn RSA_set_method .
163.Pp 145.Pp
164The misleadingly named function 146The misleadingly named function
165.Fn RSA_flags 147.Fn RSA_flags
@@ -178,17 +160,10 @@ section for more details.
178.Fn RSA_new_method 160.Fn RSA_new_method
179allocates and initializes an 161allocates and initializes an
180.Vt RSA 162.Vt RSA
181structure so that 163structure.
182.Fa engine 164The
183is used for the RSA operations.
184If
185.Fa engine 165.Fa engine
186is 166argument is ignored and
187.Dv NULL ,
188.Xr ENGINE_get_default_RSA 3
189is used.
190If that returns
191.Dv NULL ,
192the default method controlled by 167the default method controlled by
193.Fn RSA_set_default_method 168.Fn RSA_set_default_method
194is used. 169is used.
@@ -224,9 +199,6 @@ and sets an error code that can be obtained by
224if the allocation fails. 199if the allocation fails.
225Otherwise it returns a pointer to the newly allocated structure. 200Otherwise it returns a pointer to the newly allocated structure.
226.Sh SEE ALSO 201.Sh SEE ALSO
227.Xr ENGINE_get_default_RSA 3 ,
228.Xr ENGINE_register_RSA 3 ,
229.Xr ENGINE_set_default_RSA 3 ,
230.Xr RSA_meth_new 3 , 202.Xr RSA_meth_new 3 ,
231.Xr RSA_new 3 203.Xr RSA_new 3
232.Sh HISTORY 204.Sh HISTORY