From: tb <tb@openbsd.org>
Date: Fri, 21 Jul 2023 04:29:27 +0000 (+0000)
Subject: Document ENGINE_{get,set}_EC
X-Git-Url: http://artulab.com/gitweb/?a=commitdiff_plain;h=0c28aecff9d4dbde241cb876f4ad5f56119e33e9;p=openbsd

Document ENGINE_{get,set}_EC

ENGINE_{get,set}_{ECDH,ECDSA} will go away and won't come back. Replace
their documentation with the missing ENGINE_{get,set}_EC. In the unlikely
event that we will need to bring back ENGINE after the next bump, this
manual will not be outdated and incomplete.
---

diff --git a/lib/libcrypto/man/ENGINE_set_RSA.3 b/lib/libcrypto/man/ENGINE_set_RSA.3
index 4bf12defc3f..b2cec473bd5 100644
--- a/lib/libcrypto/man/ENGINE_set_RSA.3
+++ b/lib/libcrypto/man/ENGINE_set_RSA.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: ENGINE_set_RSA.3,v 1.6 2023/07/20 09:28:30 tb Exp $
+.\" $OpenBSD: ENGINE_set_RSA.3,v 1.7 2023/07/21 04:29:27 tb Exp $
 .\" content checked up to:
 .\" OpenSSL ENGINE_add 1f13ad31 Dec 25 17:50:39 2017 +0800
 .\"
@@ -16,7 +16,7 @@
 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 .\"
-.Dd $Mdocdate: July 20 2023 $
+.Dd $Mdocdate: July 21 2023 $
 .Dt ENGINE_SET_RSA 3
 .Os
 .Sh NAME
@@ -24,10 +24,8 @@
 .Nm ENGINE_get_RSA ,
 .Nm ENGINE_set_DSA ,
 .Nm ENGINE_get_DSA ,
-.Nm ENGINE_set_ECDH ,
-.Nm ENGINE_get_ECDH ,
-.Nm ENGINE_set_ECDSA ,
-.Nm ENGINE_get_ECDSA ,
+.Nm ENGINE_set_EC ,
+.Nm ENGINE_get_EC ,
 .Nm ENGINE_set_DH ,
 .Nm ENGINE_get_DH ,
 .Nm ENGINE_set_RAND ,
@@ -62,21 +60,12 @@
 .Fa "const ENGINE *e"
 .Fc
 .Ft int
-.Fo ENGINE_set_ECDH
+.Fo ENGINE_set_EC
 .Fa "ENGINE *e"
-.Fa "const ECDH_METHOD *dh_meth"
+.Fa "const EC_KEY_METHOD *ec_meth"
 .Fc
-.Ft const ECDH_METHOD *
-.Fo ENGINE_get_ECDH
-.Fa "const ENGINE *e"
-.Fc
-.Ft int
-.Fo ENGINE_set_ECDSA
-.Fa "ENGINE *e"
-.Fa "const ECDSA_METHOD *dh_meth"
-.Fc
-.Ft const ECDSA_METHOD *
-.Fo ENGINE_get_ECDSA
+.Ft const EC_KEY_METHOD *
+.Fo ENGINE_get_EC
 .Fa "const ENGINE *e"
 .Fc
 .Ft int
@@ -159,8 +148,7 @@ Partial information about the various method objects is available from
 .Xr RSA_get_default_method 3 ,
 .Xr DSA_meth_new 3 ,
 .Xr DSA_get_default_method 3 ,
-.Fn ECDH_get_default_method ,
-.Xr ECDSA_get_default_method 3 ,
+.Xr EC_KEY_get_default_method 3 ,
 .Xr DH_get_default_method 3 ,
 .Xr RAND_get_rand_method 3 ,
 .Xr EVP_get_cipherbynid 3 ,
@@ -237,9 +225,8 @@ as shown in the following table:
 .It Accessor: Ta Called by:
 .It Fn ENGINE_get_RSA Ta Xr RSA_new_method 3 , Xr RSA_new 3
 .It Fn ENGINE_get_DSA Ta Xr DSA_new_method 3 , Xr DSA_new 3
-.It Fn ENGINE_get_ECDH Ta Fn ECDH_set_method , Fn ECDH_compute_key
-.It Fn ENGINE_get_ECDSA Ta Xr ECDSA_set_method 3 ,
-.Xr ECDSA_do_sign 3 , Xr ECDSA_do_verify 3
+.It Fn ENGINE_get_EC Ta Xr EC_KEY_new_method 3 , Xr EC_KEY_new 3 ,
+.Xr EC_KEY_new_by_curve_name 3
 .It Fn ENGINE_get_DH Ta Xr DH_new_method 3 , Xr DH_new 3
 .It Fn ENGINE_get_RAND Ta unused
 .It Fn ENGINE_get_STORE Ta unused
@@ -318,12 +305,13 @@ and
 first appeared in OpenSSL 0.9.7 and have been available since
 .Ox 3.2 .
 .Pp
-.Fn ENGINE_set_ECDH ,
-.Fn ENGINE_get_ECDH ,
-.Fn ENGINE_set_ECDSA ,
-.Fn ENGINE_get_ECDSA ,
-.Fn ENGINE_set_STORE ,
+.Fn ENGINE_set_STORE
 and
 .Fn ENGINE_get_STORE
 first appeared in OpenSSL 0.9.8 and have been available since
 .Ox 4.5 .
+.Fn ENGINE_set_EC
+and
+.Fn ENGINE_get_EC
+first appeared in OpenSSL 1.1.0 and have been available since
+.Ox 6.5 .