From f86b82fe933b5698893ec827e2c05c6e54522e7d Mon Sep 17 00:00:00 2001 From: schwarze <> Date: Fri, 6 Dec 2024 13:10:43 +0000 Subject: Delete the manual page EVP_PKEY_check(3). All three functions documented in this page were deleted from the API by tb@ in evp.h rev. 1.136 on August 31 this year. --- src/lib/libcrypto/man/EVP_PKEY_CTX_new.3 | 5 +- src/lib/libcrypto/man/EVP_PKEY_check.3 | 149 ------------------------------- src/lib/libcrypto/man/EVP_PKEY_new.3 | 3 +- src/lib/libcrypto/man/Makefile | 3 +- src/lib/libcrypto/man/evp.3 | 3 +- 5 files changed, 5 insertions(+), 158 deletions(-) delete mode 100644 src/lib/libcrypto/man/EVP_PKEY_check.3 (limited to 'src') diff --git a/src/lib/libcrypto/man/EVP_PKEY_CTX_new.3 b/src/lib/libcrypto/man/EVP_PKEY_CTX_new.3 index cc0f5f16dc..6d9a94d108 100644 --- a/src/lib/libcrypto/man/EVP_PKEY_CTX_new.3 +++ b/src/lib/libcrypto/man/EVP_PKEY_CTX_new.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: EVP_PKEY_CTX_new.3,v 1.14 2024/07/21 08:36:43 tb Exp $ +.\" $OpenBSD: EVP_PKEY_CTX_new.3,v 1.15 2024/12/06 13:10:43 schwarze Exp $ .\" full merge up to: OpenSSL df75c2bf Dec 9 01:02:36 2018 +0100 .\" .\" This file is a derived work. @@ -65,7 +65,7 @@ .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED .\" OF THE POSSIBILITY OF SUCH DAMAGE. .\" -.Dd $Mdocdate: July 21 2024 $ +.Dd $Mdocdate: December 6 2024 $ .Dt EVP_PKEY_CTX_NEW 3 .Os .Sh NAME @@ -154,7 +154,6 @@ if an error occurred. .Xr EVP_DigestSignInit 3 , .Xr EVP_DigestVerifyInit 3 , .Xr EVP_PKEY_base_id 3 , -.Xr EVP_PKEY_check 3 , .Xr EVP_PKEY_CTX_ctrl 3 , .Xr EVP_PKEY_CTX_get_operation 3 , .Xr EVP_PKEY_CTX_hkdf_mode 3 , diff --git a/src/lib/libcrypto/man/EVP_PKEY_check.3 b/src/lib/libcrypto/man/EVP_PKEY_check.3 deleted file mode 100644 index 5a78e3512e..0000000000 --- a/src/lib/libcrypto/man/EVP_PKEY_check.3 +++ /dev/null @@ -1,149 +0,0 @@ -.\" $OpenBSD: EVP_PKEY_check.3,v 1.2 2022/07/14 14:49:09 tb Exp $ -.\" -.\" Copyright (c) 2022 Ingo Schwarze -.\" -.\" Permission to use, copy, modify, and distribute this software for any -.\" purpose with or without fee is hereby granted, provided that the above -.\" copyright notice and this permission notice appear in all copies. -.\" -.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES -.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF -.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR -.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES -.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN -.\" 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 14 2022 $ -.Dt EVP_PKEY_CHECK 3 -.Os -.Sh NAME -.Nm EVP_PKEY_check , -.Nm EVP_PKEY_public_check , -.Nm EVP_PKEY_param_check -.Nd key and parameter check functions -.Sh SYNOPSIS -.In openssl/evp.h -.Ft int -.Fn EVP_PKEY_check "EVP_PKEY_CTX *ctx" -.Ft int -.Fn EVP_PKEY_public_check "EVP_PKEY_CTX *ctx" -.Ft int -.Fn EVP_PKEY_param_check "EVP_PKEY_CTX *ctx" -.Sh DESCRIPTION -.Fn EVP_PKEY_check -performs various sanity checks on the key contained in -.Fa ctx -but only supports a small number of key types by default. -It preferably uses the function -.Fa check -configured for -.Fa ctx -with -.Xr EVP_PKEY_meth_set_check 3 . -It falls back to the function -.Fa pkey_check -configured for the private key contained in -.Fa ctx -with -.Xr EVP_PKEY_asn1_set_check 3 . -If that wasn't configured either, it attempts to use the following -check functions: -.Pp -.Bl -tag -width 3n -compact -offset -indent -.It DH -not supported, return value \-2 -.It EC -.Xr EC_KEY_check_key 3 -.It RSA -.Xr RSA_check_key 3 -.El -.Pp -.Fn EVP_PKEY_public_check -performs various sanity checks on the public key contained in -.Fa ctx -but only supports a small number of key types by default. -It preferably uses the function -.Fa public_check -configured for -.Fa ctx -with -.Xr EVP_PKEY_meth_set_public_check 3 . -It falls back to the function -.Fa pkey_public_check -configured for the private key contained in -.Fa ctx -with -.Xr EVP_PKEY_asn1_set_public_check 3 . -If that wasn't configured either, it attempts to use the following -check functions: -.Pp -.Bl -tag -width 3n -compact -offset -indent -.It DH -.Xr DH_check_pub_key 3 -.It EC -.Xr EC_KEY_check_key 3 -.It RSA -not supported, return value \-2 -.El -.Pp -.Fn EVP_PKEY_param_check -performs various sanity checks on the key parameters contained in -.Fa ctx -but only supports a small number of key types by default. -It preferably uses the function -.Fa check -configured for -.Fa ctx -with -.Xr EVP_PKEY_meth_set_param_check 3 . -It falls back to the function -.Fa pkey_check -configured for the private key contained in -.Fa ctx -with -.Xr EVP_PKEY_asn1_set_param_check 3 . -If that wasn't configured either, it attempts to use the following -check functions: -.Pp -.Bl -tag -width 3n -compact -offset -indent -.It DH -.Xr DH_check 3 -.It EC -.Xr EC_GROUP_check 3 -.It RSA -not supported, return value \-2 -.El -.Sh RETURN VALUES -These functions return 1 if the check was performed and no problem -was found, 0 if a problem was found or if the check could not be -performed, for example because -.Fa ctx -does not contain an -.Vt EVP_PKEY -object, or \-2 if the required check function is neither configured for -.Fa ctx -nor for the -.Vt PKEY -contained therein, and the check in question is not supported by default -for the algorithm in question either. -.Sh SEE ALSO -.Xr DH_check 3 , -.Xr EC_GROUP_check 3 , -.Xr EC_KEY_new 3 , -.Xr EVP_PKEY_asn1_new 3 , -.Xr EVP_PKEY_CTX_new 3 , -.Xr EVP_PKEY_meth_new 3 , -.Xr EVP_PKEY_new 3 , -.Xr RSA_check_key 3 -.Sh HISTORY -These functions first appeared in OpenSSL 1.1.1 -and have been available since -.Ox 7.1 . -.Sh BUGS -For EC keys, -.Fn EVP_PKEY_public_check -also checks the -.Em private -key and fails if there is a problem with any of the private -components, even if no problem is found with the public key. diff --git a/src/lib/libcrypto/man/EVP_PKEY_new.3 b/src/lib/libcrypto/man/EVP_PKEY_new.3 index 4090db990b..d21f177ca8 100644 --- a/src/lib/libcrypto/man/EVP_PKEY_new.3 +++ b/src/lib/libcrypto/man/EVP_PKEY_new.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: EVP_PKEY_new.3,v 1.23 2024/12/06 12:51:13 schwarze Exp $ +.\" $OpenBSD: EVP_PKEY_new.3,v 1.24 2024/12/06 13:10:43 schwarze Exp $ .\" full merge up to: OpenSSL 4dcfdfce May 27 11:50:05 2020 +0100 .\" .\" This file is a derived work. @@ -311,7 +311,6 @@ with .Xr d2i_PrivateKey 3 , .Xr evp 3 , .Xr EVP_PKCS82PKEY 3 , -.Xr EVP_PKEY_check 3 , .Xr EVP_PKEY_cmp 3 , .Xr EVP_PKEY_CTX_new 3 , .Xr EVP_PKEY_get_default_digest_nid 3 , diff --git a/src/lib/libcrypto/man/Makefile b/src/lib/libcrypto/man/Makefile index da93f14a43..22cf0ad171 100644 --- a/src/lib/libcrypto/man/Makefile +++ b/src/lib/libcrypto/man/Makefile @@ -1,4 +1,4 @@ -# $OpenBSD: Makefile,v 1.297 2024/12/06 12:51:13 schwarze Exp $ +# $OpenBSD: Makefile,v 1.298 2024/12/06 13:10:43 schwarze Exp $ .include @@ -178,7 +178,6 @@ MAN= \ EVP_PKEY_CTX_set_hkdf_md.3 \ EVP_PKEY_CTX_set_tls1_prf_md.3 \ EVP_PKEY_asn1_get_count.3 \ - EVP_PKEY_check.3 \ EVP_PKEY_cmp.3 \ EVP_PKEY_decrypt.3 \ EVP_PKEY_derive.3 \ diff --git a/src/lib/libcrypto/man/evp.3 b/src/lib/libcrypto/man/evp.3 index 0168d95875..4f05cc2b2a 100644 --- a/src/lib/libcrypto/man/evp.3 +++ b/src/lib/libcrypto/man/evp.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: evp.3,v 1.34 2024/12/06 12:51:13 schwarze Exp $ +.\" $OpenBSD: evp.3,v 1.35 2024/12/06 13:10:43 schwarze Exp $ .\" full merge up to: OpenSSL man7/evp 24a535ea Sep 22 13:14:20 2020 +0100 .\" .\" This file was written by Ulf Moeller , @@ -204,7 +204,6 @@ family of functions provides base64 encoding and decoding. .Xr EVP_OpenInit 3 , .Xr EVP_PKCS82PKEY 3 , .Xr EVP_PKEY_asn1_get_count 3 , -.Xr EVP_PKEY_check 3 , .Xr EVP_PKEY_cmp 3 , .Xr EVP_PKEY_CTX_ctrl 3 , .Xr EVP_PKEY_CTX_get_operation 3 , -- cgit v1.2.3-55-g6feb