summaryrefslogtreecommitdiffstats
path: root/doc/man3/DSA_size.pod
diff options
context:
space:
mode:
authorPauli <paul.dale@oracle.com>2020-01-29 22:23:39 +0100
committerPauli <paul.dale@oracle.com>2020-02-11 23:52:41 +0100
commitf41ac0eeab9d2889d44e3acf6ff1e8274d03d73e (patch)
treeba3620a537ece73983886b7449eab118e5869223 /doc/man3/DSA_size.pod
parentdsa.h: fix preprocessor indentation (diff)
downloadopenssl-f41ac0eeab9d2889d44e3acf6ff1e8274d03d73e.tar.xz
openssl-f41ac0eeab9d2889d44e3acf6ff1e8274d03d73e.zip
Deprecate the low level DSA functions.
Use of the low level DSA functions has been informally discouraged for a long time. We now formally deprecate them. Reviewed-by: Matt Caswell <matt@openssl.org> (Merged from https://github.com/openssl/openssl/pull/10977)
Diffstat (limited to 'doc/man3/DSA_size.pod')
-rw-r--r--doc/man3/DSA_size.pod15
1 files changed, 15 insertions, 0 deletions
diff --git a/doc/man3/DSA_size.pod b/doc/man3/DSA_size.pod
index e74b32580f..473ab985ff 100644
--- a/doc/man3/DSA_size.pod
+++ b/doc/man3/DSA_size.pod
@@ -8,12 +8,20 @@ DSA_size, DSA_bits, DSA_security_bits - get DSA signature size, key bits or secu
#include <openssl/dsa.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 DSA_size(const DSA *dsa);
int DSA_bits(const DSA *dsa);
int DSA_security_bits(const DSA *dsa);
=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)>.
+
DSA_size() returns the maximum size of an ASN.1 encoded DSA signature
for key B<dsa> in bytes. It can be used to determine how much memory must
be allocated for a DSA signature.
@@ -34,8 +42,15 @@ DSA_bits() returns the number of bits in the key.
=head1 SEE ALSO
+L<EVP_PKEY_bits(3)>,
+L<EVP_PKEY_security_bits(3)>,
+L<EVP_PKEY_size(3)>,
L<DSA_new(3)>, L<DSA_sign(3)>
+=head1 HISTORY
+
+All of these functions were deprecated in OpenSSL 3.0.
+
=head1 COPYRIGHT
Copyright 2000-2018 The OpenSSL Project Authors. All Rights Reserved.