]>
Commit | Line | Data |
---|---|---|
38e33cef UM |
1 | =pod |
2 | ||
3 | =head1 NAME | |
4 | ||
4d524e10 | 5 | DSA_do_sign, DSA_do_verify - raw DSA signature operations |
38e33cef UM |
6 | |
7 | =head1 SYNOPSIS | |
8 | ||
9 | #include <openssl/dsa.h> | |
10 | ||
3dbf8243 MC |
11 | The following functions have been deprecated since OpenSSL 3.0, and can be |
12 | hidden entirely by defining B<OPENSSL_API_COMPAT> with a suitable version value, | |
13 | see L<openssl_user_macros(7)>: | |
e52b4215 | 14 | |
38e33cef UM |
15 | DSA_SIG *DSA_do_sign(const unsigned char *dgst, int dlen, DSA *dsa); |
16 | ||
17 | int DSA_do_verify(const unsigned char *dgst, int dgst_len, | |
e9b77246 | 18 | DSA_SIG *sig, DSA *dsa); |
38e33cef UM |
19 | |
20 | =head1 DESCRIPTION | |
21 | ||
e52b4215 SL |
22 | All of the functions described on this page are deprecated. |
23 | Applications should instead use L<EVP_PKEY_sign_init(3)>, L<EVP_PKEY_sign(3)>, | |
24 | L<EVP_PKEY_verify_init(3)> and L<EVP_PKEY_verify(3)>. | |
25 | ||
38e33cef UM |
26 | DSA_do_sign() computes a digital signature on the B<len> byte message |
27 | digest B<dgst> using the private key B<dsa> and returns it in a | |
28 | newly allocated B<DSA_SIG> structure. | |
29 | ||
9b86974e | 30 | L<DSA_sign_setup(3)> may be used to precompute part |
38e33cef UM |
31 | of the signing operation in case signature generation is |
32 | time-critical. | |
33 | ||
34 | DSA_do_verify() verifies that the signature B<sig> matches a given | |
35 | message digest B<dgst> of size B<len>. B<dsa> is the signer's public | |
36 | key. | |
37 | ||
38 | =head1 RETURN VALUES | |
39 | ||
40 | DSA_do_sign() returns the signature, NULL on error. DSA_do_verify() | |
41 | returns 1 for a valid signature, 0 for an incorrect signature and -1 | |
42 | on error. The error codes can be obtained by | |
9b86974e | 43 | L<ERR_get_error(3)>. |
38e33cef UM |
44 | |
45 | =head1 SEE ALSO | |
46 | ||
b97fdb57 | 47 | L<DSA_new(3)>, L<ERR_get_error(3)>, L<RAND_bytes(3)>, |
9b86974e RS |
48 | L<DSA_SIG_new(3)>, |
49 | L<DSA_sign(3)> | |
38e33cef | 50 | |
e52b4215 SL |
51 | =head1 HISTORY |
52 | ||
53 | All of these functions were deprecated in OpenSSL 3.0. | |
54 | ||
e2f92610 RS |
55 | =head1 COPYRIGHT |
56 | ||
e52b4215 | 57 | Copyright 2000-2021 The OpenSSL Project Authors. All Rights Reserved. |
e2f92610 | 58 | |
4746f25a | 59 | Licensed under the Apache License 2.0 (the "License"). You may not use |
e2f92610 RS |
60 | this file except in compliance with the License. You can obtain a copy |
61 | in the file LICENSE in the source distribution or at | |
62 | L<https://www.openssl.org/source/license.html>. | |
63 | ||
64 | =cut |