diff options
author | Shane Lontis <shane.lontis@oracle.com> | 2021-04-23 10:53:03 +1000 |
---|---|---|
committer | Shane Lontis <shane.lontis@oracle.com> | 2021-04-27 09:45:53 +1000 |
commit | c85c5e1a5327379306f4c3f8248ace740c64c338 (patch) | |
tree | ddd316056c2eb911db89ebfc5eed68910991473f /doc/man3 | |
parent | 990aa405dbf5899cc24c167b4c0a29a3db58e343 (diff) |
Deprecate EVP_PKEY_cmp() and EVP_PKEY_cmp_parameters().
The replacement functions EVP_PKEY_eq() and EVP_PKEY_parameters_eq()
already exist.
Reviewed-by: Richard Levitte <levitte@openssl.org>
Reviewed-by: David von Oheimb <david.von.oheimb@siemens.com>
(Merged from https://github.com/openssl/openssl/pull/14997)
Diffstat (limited to 'doc/man3')
-rw-r--r-- | doc/man3/EVP_PKEY_copy_parameters.pod | 25 |
1 files changed, 15 insertions, 10 deletions
diff --git a/doc/man3/EVP_PKEY_copy_parameters.pod b/doc/man3/EVP_PKEY_copy_parameters.pod index 742418cf10..1ca38f8ae9 100644 --- a/doc/man3/EVP_PKEY_copy_parameters.pod +++ b/doc/man3/EVP_PKEY_copy_parameters.pod @@ -14,8 +14,13 @@ EVP_PKEY_cmp - public key parameter and comparison functions int EVP_PKEY_copy_parameters(EVP_PKEY *to, const EVP_PKEY *from); int EVP_PKEY_parameters_eq(const EVP_PKEY *a, const EVP_PKEY *b); - int EVP_PKEY_cmp_parameters(const EVP_PKEY *a, const EVP_PKEY *b); int EVP_PKEY_eq(const EVP_PKEY *a, const EVP_PKEY *b); + +Deprecated since OpenSSL 3.0, can be hidden entirely by defining +B<OPENSSL_API_COMPAT> with a suitable version value, see +L<openssl_user_macros(7)>: + + int EVP_PKEY_cmp_parameters(const EVP_PKEY *a, const EVP_PKEY *b); int EVP_PKEY_cmp(const EVP_PKEY *a, const EVP_PKEY *b); =head1 DESCRIPTION @@ -46,10 +51,9 @@ Since OpenSSL private keys contain public key components too the function EVP_PKEY_eq() can also be used to determine if a private key matches a public key. -EVP_PKEY_cmp() and EVP_PKEY_cmp_parameters() differ in their return values -compared to other _cmp() functions. They are aliases for EVP_PKEY_eq() and -EVP_PKEY_parameters_eq() functions provided for backwards compatibility -with existing applications. +The deprecated functions EVP_PKEY_cmp() and EVP_PKEY_cmp_parameters() differ in +their return values compared to other _cmp() functions. They are aliases for +EVP_PKEY_eq() and EVP_PKEY_parameters_eq(). =head1 RETURN VALUES @@ -72,14 +76,15 @@ L<EVP_PKEY_keygen(3)> =head1 HISTORY -EVP_PKEY_eq() and EVP_PKEY_parameters_eq() were added in OpenSSL 3.0 to -avoid confusion on the return values of EVP_PKEY_cmp() and -EVP_PKEY_cmp_parameters() which unlike other _cmp() -functions do not return 0 in case their arguments are equal. +The EVP_PKEY_cmp() and EVP_PKEY_cmp_parameters() functions were deprecated in +OpenSSL 3.0. + +The EVP_PKEY_eq() and EVP_PKEY_parameters_eq() were added in OpenSSL 3.0 to +replace EVP_PKEY_cmp() and EVP_PKEY_cmp_parameters(). =head1 COPYRIGHT -Copyright 2006-2020 The OpenSSL Project Authors. All Rights Reserved. +Copyright 2006-2021 The OpenSSL Project Authors. All Rights Reserved. Licensed under the Apache License 2.0 (the "License"). You may not use this file except in compliance with the License. You can obtain a copy |