113d40330Schristos=pod 213d40330Schristos 313d40330Schristos=head1 NAME 413d40330Schristos 513d40330SchristosDSA_new, DSA_free - allocate and free DSA objects 613d40330Schristos 713d40330Schristos=head1 SYNOPSIS 813d40330Schristos 913d40330Schristos #include <openssl/dsa.h> 1013d40330Schristos 11*b0d17251SchristosThe following functions have been deprecated since OpenSSL 3.0, and can be 12*b0d17251Schristoshidden entirely by defining B<OPENSSL_API_COMPAT> with a suitable version value, 13*b0d17251Schristossee L<openssl_user_macros(7)>: 14*b0d17251Schristos 1513d40330Schristos DSA* DSA_new(void); 1613d40330Schristos 1713d40330Schristos void DSA_free(DSA *dsa); 1813d40330Schristos 1913d40330Schristos=head1 DESCRIPTION 2013d40330Schristos 21*b0d17251SchristosAll of the functions described on this page are deprecated. 22*b0d17251SchristosApplications should instead use L<EVP_PKEY_new(3)> and L<EVP_PKEY_free(3)>. 23*b0d17251Schristos 2413d40330SchristosDSA_new() allocates and initializes a B<DSA> structure. It is equivalent to 2513d40330Schristoscalling DSA_new_method(NULL). 2613d40330Schristos 2713d40330SchristosDSA_free() frees the B<DSA> structure and its components. The values are 2813d40330Schristoserased before the memory is returned to the system. 2913d40330SchristosIf B<dsa> is NULL nothing is done. 3013d40330Schristos 3113d40330Schristos=head1 RETURN VALUES 3213d40330Schristos 3313d40330SchristosIf the allocation fails, DSA_new() returns B<NULL> and sets an error 3413d40330Schristoscode that can be obtained by 3513d40330SchristosL<ERR_get_error(3)>. Otherwise it returns a pointer 3613d40330Schristosto the newly allocated structure. 3713d40330Schristos 3813d40330SchristosDSA_free() returns no value. 3913d40330Schristos 4013d40330Schristos=head1 SEE ALSO 4113d40330Schristos 42*b0d17251SchristosL<EVP_PKEY_new(3)>, L<EVP_PKEY_free(3)>, 4313d40330SchristosL<DSA_new(3)>, L<ERR_get_error(3)>, 4413d40330SchristosL<DSA_generate_parameters(3)>, 4513d40330SchristosL<DSA_generate_key(3)> 4613d40330Schristos 47*b0d17251Schristos=head1 HISTORY 48*b0d17251Schristos 49*b0d17251SchristosAll of these functions were deprecated in OpenSSL 3.0. 50*b0d17251Schristos 5113d40330Schristos=head1 COPYRIGHT 5213d40330Schristos 53*b0d17251SchristosCopyright 2000-2021 The OpenSSL Project Authors. All Rights Reserved. 5413d40330Schristos 55*b0d17251SchristosLicensed under the Apache License 2.0 (the "License"). You may not use 5613d40330Schristosthis file except in compliance with the License. You can obtain a copy 5713d40330Schristosin the file LICENSE in the source distribution or at 5813d40330SchristosL<https://www.openssl.org/source/license.html>. 5913d40330Schristos 6013d40330Schristos=cut 61