Document ENGINE_get_default_EC
authortb <tb@openbsd.org>
Fri, 21 Jul 2023 04:35:36 +0000 (04:35 +0000)
committertb <tb@openbsd.org>
Fri, 21 Jul 2023 04:35:36 +0000 (04:35 +0000)
ENGINE_get_default_{ECDH,ECDSA} will go away and won't come back. Replace
their documentation with the missing ENGINE_get_defaulT_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.

lib/libcrypto/man/ENGINE_get_default_RSA.3

index ae63984..348f136 100644 (file)
@@ -1,4 +1,4 @@
-.\" $OpenBSD: ENGINE_get_default_RSA.3,v 1.3 2023/07/20 09:28:30 tb Exp $
+.\" $OpenBSD: ENGINE_get_default_RSA.3,v 1.4 2023/07/21 04:35:36 tb Exp $
 .\" content checked up to:
 .\" OpenSSL ENGINE_add 1f13ad31 Dec 25 17:50:39 2017 +0800
 .\"
 .\" 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_GET_DEFAULT_RSA 3
 .Os
 .Sh NAME
 .Nm ENGINE_get_default_RSA ,
 .Nm ENGINE_get_default_DSA ,
-.Nm ENGINE_get_default_ECDH ,
-.Nm ENGINE_get_default_ECDSA ,
+.Nm ENGINE_get_default_EC ,
 .Nm ENGINE_get_default_DH ,
 .Nm ENGINE_get_default_RAND ,
 .Nm ENGINE_get_cipher_engine ,
@@ -38,9 +37,7 @@
 .Ft ENGINE *
 .Fn ENGINE_get_default_DSA void
 .Ft ENGINE *
-.Fn ENGINE_get_default_ECDH void
-.Ft ENGINE *
-.Fn ENGINE_get_default_ECDSA void
+.Fn ENGINE_get_default_EC void
 .Ft ENGINE *
 .Fn ENGINE_get_default_DH void
 .Ft ENGINE *
@@ -104,11 +101,7 @@ Application programs rarely need to call these functions because
 they are called automatically when needed, in particular from
 .Xr RSA_new 3 ,
 .Xr DSA_new 3 ,
-.Fn ECDH_set_method ,
-.Fn ECDH_compute_key ,
-.Xr ECDSA_set_method 3 ,
-.Xr ECDSA_do_sign 3 ,
-.Xr ECDSA_do_verify 3 ,
+.Xr EC_KEY_new 3 ,
 .Xr DH_new 3 ,
 .Xr EVP_CipherInit_ex 3 ,
 and
@@ -153,8 +146,6 @@ and
 first appeared in OpenSSL 0.9.7 and have been available since
 .Ox 3.2 .
 .Pp
-.Fn ENGINE_get_default_ECDH
-and
-.Fn ENGINE_get_default_ECDSA
-first appeared in OpenSSL 0.9.8 and have been available since
-.Ox 4.5 .
+.Fn ENGINE_get_default_EC
+first appeared in OpenSSL 1.1.0 and has been available since
+.Ox 6.5 .