Ulf Möller | 38e33ce | 2000-01-27 19:31:26 +0000 | [diff] [blame] | 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 | |
| 11 | DSA* DSA_new(void); |
| 12 | |
| 13 | void DSA_free(DSA *dsa); |
| 14 | |
| 15 | =head1 DESCRIPTION |
| 16 | |
Geoff Thorpe | 5bf7387 | 2002-08-05 16:27:01 +0000 | [diff] [blame] | 17 | DSA_new() allocates and initializes a B<DSA> structure. It is equivalent to |
| 18 | calling DSA_new_method(NULL). |
Ulf Möller | 38e33ce | 2000-01-27 19:31:26 +0000 | [diff] [blame] | 19 | |
| 20 | DSA_free() frees the B<DSA> structure and its components. The values are |
| 21 | erased before the memory is returned to the system. |
Rich Salz | d640708 | 2015-03-24 10:17:37 -0400 | [diff] [blame] | 22 | If B<dsa> is NULL nothing is done. |
Ulf Möller | 38e33ce | 2000-01-27 19:31:26 +0000 | [diff] [blame] | 23 | |
| 24 | =head1 RETURN VALUES |
| 25 | |
| 26 | If the allocation fails, DSA_new() returns B<NULL> and sets an error |
| 27 | code that can be obtained by |
Rich Salz | 9b86974 | 2015-08-17 15:21:33 -0400 | [diff] [blame] | 28 | L<ERR_get_error(3)>. Otherwise it returns a pointer |
Ulf Möller | 38e33ce | 2000-01-27 19:31:26 +0000 | [diff] [blame] | 29 | to the newly allocated structure. |
| 30 | |
| 31 | DSA_free() returns no value. |
| 32 | |
| 33 | =head1 SEE ALSO |
| 34 | |
Richard Levitte | b97fdb5 | 2016-11-11 09:33:09 +0100 | [diff] [blame] | 35 | L<DSA_new(3)>, L<ERR_get_error(3)>, |
Rich Salz | 9b86974 | 2015-08-17 15:21:33 -0400 | [diff] [blame] | 36 | L<DSA_generate_parameters(3)>, |
| 37 | L<DSA_generate_key(3)> |
Ulf Möller | 38e33ce | 2000-01-27 19:31:26 +0000 | [diff] [blame] | 38 | |
Rich Salz | e2f9261 | 2016-05-18 11:44:05 -0400 | [diff] [blame] | 39 | =head1 COPYRIGHT |
| 40 | |
| 41 | Copyright 2000-2016 The OpenSSL Project Authors. All Rights Reserved. |
| 42 | |
| 43 | Licensed under the OpenSSL license (the "License"). You may not use |
| 44 | this file except in compliance with the License. You can obtain a copy |
| 45 | in the file LICENSE in the source distribution or at |
| 46 | L<https://www.openssl.org/source/license.html>. |
| 47 | |
| 48 | =cut |