Deprecate the low level Diffie-Hellman functions.

[thirdparty/openssl.git] / doc / man3 / DH_size.pod

diff --git a/doc/man3/DH_size.pod b/doc/man3/DH_size.pod
index 3161ef3ee3bfcb1e1fed9377512beed11c435a9f..8a206f0ac4d02f9c18f6a1ba9ea3171c3e5a438f 100644 (file)
--- a/doc/man3/DH_size.pod
+++ b/doc/man3/DH_size.pod
@@ -9,6 +9,10 @@ security bits
 
  #include <openssl/dh.h>
 
+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 DH_size(const DH *dh);
 
  int DH_bits(const DH *dh);
@@ -17,6 +21,10 @@ security bits
 
 =head1 DESCRIPTION
 
+All of the functions described on this page are deprecated.
+Applications should instead use L<EVP_PKEY_bits(3)>,
+L<EVP_PKEY_security_bits(3)> and L<EVP_PKEY_size(3)>.
+
 DH_size() returns the Diffie-Hellman prime size in bytes. It can be used
 to determine how much memory must be allocated for the shared secret
 computed by L<DH_compute_key(3)>.
@@ -38,11 +46,14 @@ DH_security_bits() returns the number of security bits.
 
 =head1 SEE ALSO
 
+L<EVP_PKEY_bits(3)>,
 L<DH_new(3)>, L<DH_generate_key(3)>,
 L<BN_num_bits(3)>
 
 =head1 HISTORY
 
+All of these functions were deprecated in OpenSSL 3.0.
+
 The DH_bits() function was added in OpenSSL 1.1.0.
 
 =head1 COPYRIGHT