From 804762513590f41c1b78252a3d44d2c96c3d6139 Mon Sep 17 00:00:00 2001 From: tb <> Date: Sun, 19 Nov 2023 10:34:26 +0000 Subject: Strip mention of ENGINE out of *_set_method.3 --- src/lib/libcrypto/man/DH_set_method.3 | 40 ++++++++--------------------------- 1 file changed, 9 insertions(+), 31 deletions(-) (limited to 'src/lib/libcrypto/man/DH_set_method.3') diff --git a/src/lib/libcrypto/man/DH_set_method.3 b/src/lib/libcrypto/man/DH_set_method.3 index e89fdc64a5..70cf367c9d 100644 --- a/src/lib/libcrypto/man/DH_set_method.3 +++ b/src/lib/libcrypto/man/DH_set_method.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: DH_set_method.3,v 1.8 2022/01/15 23:38:50 jsg Exp $ +.\" $OpenBSD: DH_set_method.3,v 1.9 2023/11/19 10:34:26 tb Exp $ .\" OpenSSL b97fdb57 Nov 11 09:33:09 2016 +0100 .\" .\" This file was written by Ulf Moeller . @@ -48,7 +48,7 @@ .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED .\" OF THE POSSIBILITY OF SUCH DAMAGE. .\" -.Dd $Mdocdate: January 15 2022 $ +.Dd $Mdocdate: November 19 2023 $ .Dt DH_SET_METHOD 3 .Os .Sh NAME @@ -98,16 +98,9 @@ selects as the default method for all .Vt DH structures created later. -If any -.Vt ENGINE -was registered with -.Xr ENGINE_register_DH 3 -that can be successfully initialized, it overrides the default. .Pp .Fn DH_get_default_method -returns a pointer to the current default method, -even if it is actually overridden by an -.Vt ENGINE . +returns a pointer to the current default method. .Pp .Fn DH_set_method selects @@ -118,17 +111,12 @@ This replaces the .Vt DH_METHOD used by the .Fa dh -key and if the previous method was supplied by an -.Vt ENGINE , -.Xr ENGINE_finish 3 -is called on it. +key. It is possible to have .Vt DH keys that only work with certain .Vt DH_METHOD -implementations (e.g. from an -.Vt ENGINE -module that supports embedded hardware-protected keys), +implementations, and in such cases attempting to change the .Vt DH_METHOD for the key can have unexpected results. @@ -136,17 +124,10 @@ for the key can have unexpected results. .Fn DH_new_method allocates and initializes a .Vt DH -structure so that -.Fa engine -is used for the DH operations. -If +structure. +The .Fa engine -is -.Dv NULL , -.Xr ENGINE_get_default_DH 3 -is used. -If that returns -.Dv NULL , +argument is ignored and the default method controlled by .Fn DH_set_default_method is used. @@ -202,10 +183,7 @@ and sets an error code that can be obtained by if the allocation fails. Otherwise it returns a pointer to the newly allocated structure. .Sh SEE ALSO -.Xr DH_new 3 , -.Xr ENGINE_get_default_DH 3 , -.Xr ENGINE_register_DH 3 , -.Xr ENGINE_set_default_DH 3 +.Xr DH_new 3 .Sh HISTORY .Fn DH_set_default_method , .Fn DH_get_default_method , -- cgit v1.2.3-55-g6feb