]>
Commit | Line | Data |
---|---|---|
38e33cef UM |
1 | =pod |
2 | ||
3 | =head1 NAME | |
4 | ||
5 | DSA_new, DSA_free - allocate and free DSA objects | |
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)>: | |
d6fff343 | 14 | |
38e33cef UM |
15 | DSA* DSA_new(void); |
16 | ||
17 | void DSA_free(DSA *dsa); | |
18 | ||
19 | =head1 DESCRIPTION | |
20 | ||
d6fff343 P |
21 | All of the functions described on this page are deprecated. |
22 | Applications should instead use L<EVP_PKEY_new(3)> and L<EVP_PKEY_free(3)>. | |
23 | ||
5bf73873 GT |
24 | DSA_new() allocates and initializes a B<DSA> structure. It is equivalent to |
25 | calling DSA_new_method(NULL). | |
38e33cef UM |
26 | |
27 | DSA_free() frees the B<DSA> structure and its components. The values are | |
28 | erased before the memory is returned to the system. | |
d6407083 | 29 | If B<dsa> is NULL nothing is done. |
38e33cef UM |
30 | |
31 | =head1 RETURN VALUES | |
32 | ||
33 | If the allocation fails, DSA_new() returns B<NULL> and sets an error | |
34 | code that can be obtained by | |
9b86974e | 35 | L<ERR_get_error(3)>. Otherwise it returns a pointer |
38e33cef UM |
36 | to the newly allocated structure. |
37 | ||
38 | DSA_free() returns no value. | |
39 | ||
40 | =head1 SEE ALSO | |
41 | ||
d6fff343 | 42 | L<EVP_PKEY_new(3)>, L<EVP_PKEY_free(3)>, |
b97fdb57 | 43 | L<DSA_new(3)>, L<ERR_get_error(3)>, |
9b86974e RS |
44 | L<DSA_generate_parameters(3)>, |
45 | L<DSA_generate_key(3)> | |
38e33cef | 46 | |
d6fff343 P |
47 | =head1 HISTORY |
48 | ||
49 | All of these functions were deprecated in OpenSSL 3.0. | |
50 | ||
e2f92610 RS |
51 | =head1 COPYRIGHT |
52 | ||
53 | Copyright 2000-2016 The OpenSSL Project Authors. All Rights Reserved. | |
54 | ||
4746f25a | 55 | Licensed under the Apache License 2.0 (the "License"). You may not use |
e2f92610 RS |
56 | this file except in compliance with the License. You can obtain a copy |
57 | in the file LICENSE in the source distribution or at | |
58 | L<https://www.openssl.org/source/license.html>. | |
59 | ||
60 | =cut |