diff options
author | Nicola Tuveri <nic.tuv@gmail.com> | 2018-06-12 04:27:28 +0300 |
---|---|---|
committer | Matt Caswell <matt@openssl.org> | 2018-06-12 13:29:33 +0100 |
commit | cd396d2a4767f186cc12e8c111599caeb35893bc (patch) | |
tree | 01426f8d4825ce17d049a4cffeb989a8b8d620ea | |
parent | ea7abeeabf92b7aca160bdd0208636d4da69f4f4 (diff) |
Deprecate DSA_sign_setup() in the documentation
Reviewed-by: Rich Salz <rsalz@openssl.org>
Reviewed-by: Matt Caswell <matt@openssl.org>
(Merged from https://github.com/openssl/openssl/pull/6460)
(cherry picked from commit 8fe4c0b001f85c5a918c6a6d4687813ea3d2945f)
-rw-r--r-- | doc/crypto/DSA_sign.pod | 13 |
1 files changed, 6 insertions, 7 deletions
diff --git a/doc/crypto/DSA_sign.pod b/doc/crypto/DSA_sign.pod index ba0f6b863e..2c50708250 100644 --- a/doc/crypto/DSA_sign.pod +++ b/doc/crypto/DSA_sign.pod @@ -24,13 +24,12 @@ digest B<dgst> using the private key B<dsa> and places its ASN.1 DER encoding at B<sigret>. The length of the signature is places in *B<siglen>. B<sigret> must point to DSA_size(B<dsa>) bytes of memory. -DSA_sign_setup() may be used to precompute part of the signing -operation in case signature generation is time-critical. It expects -B<dsa> to contain DSA parameters. It places the precomputed values -in newly allocated B<BIGNUM>s at *B<kinvp> and *B<rp>, after freeing -the old ones unless *B<kinvp> and *B<rp> are NULL. These values may -be passed to DSA_sign() in B<dsa-E<gt>kinv> and B<dsa-E<gt>r>. -B<ctx> is a pre-allocated B<BN_CTX> or NULL. +DSA_sign_setup() is defined only for backward binary compatibility and +should not be used. +Since OpenSSL 1.1.0 the DSA type is opaque and the output of +DSA_sign_setup() cannot be used anyway: calling this function will only +cause overhead, and does not affect the actual signature +(pre-)computation. DSA_verify() verifies that the signature B<sigbuf> of size B<siglen> matches a given message digest B<dgst> of size B<len>. |