Update documentation on EVP_PKEY_ASN1_METHOD deprecation

Signed-off-by: Norbert Pocs <norbertp@openssl.org>
Reviewed-by: Saša Nedvědický <sashan@openssl.org>
Reviewed-by: Neil Horman <nhorman@openssl.org>
(Merged from https://github.com/openssl/openssl/pull/27727)

diff --git a/doc/man3/EVP_PKEY_ASN1_METHOD.pod b/doc/man3/EVP_PKEY_ASN1_METHOD.pod
index 41f058fe54ee410b161dc34d5f56f2e465250c0b..da17c568f2fdbbf0de44f7cad42efd535fa3dd33 100644 (file)
--- a/doc/man3/EVP_PKEY_ASN1_METHOD.pod
+++ b/doc/man3/EVP_PKEY_ASN1_METHOD.pod
@@ -28,6 +28,10 @@ EVP_PKEY_get0_asn1
 
 =head1 SYNOPSIS
 
+The following functions have been deprecated since OpenSSL 3.6, and can be
+hidden entirely by defining B<OPENSSL_API_COMPAT> with a suitable version value,
+see L<openssl_user_macros(7)>; use the provider API instead.
+
  #include <openssl/evp.h>
 
  typedef struct evp_pkey_asn1_method_st EVP_PKEY_ASN1_METHOD;
@@ -437,6 +441,8 @@ The signature of the I<pub_decode> functional argument of
 EVP_PKEY_asn1_set_public() has changed in OpenSSL 3.0 so its I<pub>
 parameter is now constified.
 
+All of these functions were deprecated in OpenSSL 3.6.
+
 =head1 COPYRIGHT
 
 Copyright 2017-2024 The OpenSSL Project Authors. All Rights Reserved.

diff --git a/doc/man3/EVP_PKEY_asn1_get_count.pod b/doc/man3/EVP_PKEY_asn1_get_count.pod
index 19d1e36454b29318513536b2137f0566019f2717..fdd2166ef2e6a6b8cddb24d0764680d24ed5aba1 100644 (file)
--- a/doc/man3/EVP_PKEY_asn1_get_count.pod
+++ b/doc/man3/EVP_PKEY_asn1_get_count.pod
@@ -11,6 +11,10 @@ EVP_PKEY_asn1_get0_info
 
 =head1 SYNOPSIS
 
+The following functions have been deprecated since OpenSSL 3.6, and can be
+hidden entirely by defining B<OPENSSL_API_COMPAT> with a suitable version value,
+see L<openssl_user_macros(7)>; use the provider API instead.
+
  #include <openssl/evp.h>
 
  int EVP_PKEY_asn1_get_count(void);
@@ -68,6 +72,10 @@ EVP_PKEY_asn1_get0_info() returns 0 on failure, 1 on success.
 
 L<EVP_PKEY_asn1_new(3)>, L<EVP_PKEY_asn1_add0(3)>
 
+=head1 HISTORY
+
+These functions were deprecated in OpenSSL 3.6.
+
 =head1 COPYRIGHT
 
 Copyright 2017 The OpenSSL Project Authors. All Rights Reserved.

diff --git a/doc/man7/ossl-guide-migration.pod b/doc/man7/ossl-guide-migration.pod
index aa60c129baa412e1c25cbb3073f36a0bb57a66d7..41b0f90ffe9aa24eef63357b6a036fb1d377548c 100644 (file)
--- a/doc/man7/ossl-guide-migration.pod
+++ b/doc/man7/ossl-guide-migration.pod
@@ -17,6 +17,14 @@ L<https://github.com/openssl/openssl/blob/master/CHANGES.md>.
 For an overview of some of the key concepts introduced in OpenSSL 3.0 see
 L<crypto(7)>.
 
+=head1 OPENSSL 3.6
+
+=head2 Main Changes from OpenSSL 3.5
+
+The functions EVP_PKEY_asn1_*() and L<EVP_PKEY_get0_asn1(3)> were deprecated in
+favour of the provider API. EVP_PKEY_assign_[DSA|SIPHASH]() were also deprecated.
+Please use the new high level and provider API.
+
 =head1 OPENSSL 3.1
 
 =head2 Main Changes from OpenSSL 3.0