diff options
author | Pauli <paul.dale@oracle.com> | 2020-01-30 07:23:39 +1000 |
---|---|---|
committer | Pauli <paul.dale@oracle.com> | 2020-02-12 08:52:41 +1000 |
commit | f41ac0eeab9d2889d44e3acf6ff1e8274d03d73e (patch) | |
tree | ba3620a537ece73983886b7449eab118e5869223 /doc | |
parent | 7f6deaf68e42e979a2084989db2c32193825d1b3 (diff) |
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')
-rw-r--r-- | doc/man3/DSA_meth_new.pod | 12 | ||||
-rw-r--r-- | doc/man3/DSA_size.pod | 15 | ||||
-rw-r--r-- | doc/man3/RSA_print.pod | 24 |
3 files changed, 49 insertions, 2 deletions
diff --git a/doc/man3/DSA_meth_new.pod b/doc/man3/DSA_meth_new.pod index c5e6ccd052..1e23c0e694 100644 --- a/doc/man3/DSA_meth_new.pod +++ b/doc/man3/DSA_meth_new.pod @@ -16,6 +16,10 @@ DSA_meth_set_keygen - Routines to build up DSA methods #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)>: + DSA_METHOD *DSA_meth_new(const char *name, int flags); void DSA_meth_free(DSA_METHOD *dsam); @@ -86,6 +90,10 @@ DSA_meth_set_keygen - Routines to build up DSA methods =head1 DESCRIPTION +All of the functions described on this page are deprecated. +Applications and extension implementations should instead use the +OSSL_PROVIDER APIs. + The B<DSA_METHOD> type is a structure used for the provision of custom DSA implementations. It provides a set of functions used by OpenSSL for the implementation of the various DSA capabilities. @@ -200,11 +208,13 @@ L<DSA_sign(3)>, L<DSA_size(3)>, L<DSA_get0_pqg(3)> =head1 HISTORY +The functions described here were deprecated in OpenSSL 3.0. + The functions described here were added in OpenSSL 1.1.0. =head1 COPYRIGHT -Copyright 2016-2018 The OpenSSL Project Authors. All Rights Reserved. +Copyright 2016-2020 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 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. diff --git a/doc/man3/RSA_print.pod b/doc/man3/RSA_print.pod index a0904b66b0..8318b5528b 100644 --- a/doc/man3/RSA_print.pod +++ b/doc/man3/RSA_print.pod @@ -10,11 +10,19 @@ DHparams_print, DHparams_print_fp - print cryptographic parameters #include <openssl/rsa.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 RSA_print(BIO *bp, RSA *x, int offset); int RSA_print_fp(FILE *fp, RSA *x, int offset); #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 DSAparams_print(BIO *bp, DSA *x); int DSAparams_print_fp(FILE *fp, DSA *x); int DSA_print(BIO *bp, DSA *x, int offset); @@ -22,11 +30,19 @@ DHparams_print, DHparams_print_fp - print cryptographic parameters #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 DHparams_print(BIO *bp, DH *x); int DHparams_print_fp(FILE *fp, DH *x); =head1 DESCRIPTION +All of the functions described on this page are deprecated. +Applications should instead use L<EVP_PKEY_print_params(3)> and +L<EVP_PKEY_print_private(3)>. + A human-readable hexadecimal output of the components of the RSA key, DSA parameters or key or DH parameters is printed to B<bp> or B<fp>. @@ -38,7 +54,13 @@ These functions return 1 on success, 0 on error. =head1 SEE ALSO -L<BN_bn2bin(3)> + L<EVP_PKEY_print_params(3)>, + L<EVP_PKEY_print_private(3)>, + L<BN_bn2bin(3)> + +=head1 HISTORY + +All of these functions were deprecated in OpenSSL 3.0. =head1 COPYRIGHT |