xref: /freebsd/crypto/openssl/doc/man3/DSA_dup_DH.pod (revision b077aed33b7b6aefca7b17ddb250cf521f938613)
1e71b7053SJung-uk Kim=pod
2e71b7053SJung-uk Kim
3e71b7053SJung-uk Kim=head1 NAME
4e71b7053SJung-uk Kim
5e71b7053SJung-uk KimDSA_dup_DH - create a DH structure out of DSA structure
6e71b7053SJung-uk Kim
7e71b7053SJung-uk Kim=head1 SYNOPSIS
8e71b7053SJung-uk Kim
9e71b7053SJung-uk Kim #include <openssl/dsa.h>
10e71b7053SJung-uk Kim
11*b077aed3SPierre ProncheryThe following functions have been deprecated since OpenSSL 3.0, and can be
12*b077aed3SPierre Proncheryhidden entirely by defining B<OPENSSL_API_COMPAT> with a suitable version value,
13*b077aed3SPierre Proncherysee L<openssl_user_macros(7)>:
14*b077aed3SPierre Pronchery
15e71b7053SJung-uk Kim DH *DSA_dup_DH(const DSA *r);
16e71b7053SJung-uk Kim
17e71b7053SJung-uk Kim=head1 DESCRIPTION
18e71b7053SJung-uk Kim
19*b077aed3SPierre ProncheryThe function described on this page is deprecated. There is no direct
20*b077aed3SPierre Proncheryreplacement, applications should use the EVP_PKEY APIs for Diffie-Hellman
21*b077aed3SPierre Proncheryoperations.
22*b077aed3SPierre Pronchery
23e71b7053SJung-uk KimDSA_dup_DH() duplicates DSA parameters/keys as DH parameters/keys. q
24e71b7053SJung-uk Kimis lost during that conversion, but the resulting DH parameters
25e71b7053SJung-uk Kimcontain its length.
26e71b7053SJung-uk Kim
27e71b7053SJung-uk Kim=head1 RETURN VALUES
28e71b7053SJung-uk Kim
29e71b7053SJung-uk KimDSA_dup_DH() returns the new B<DH> structure, and NULL on error. The
30e71b7053SJung-uk Kimerror codes can be obtained by L<ERR_get_error(3)>.
31e71b7053SJung-uk Kim
32e71b7053SJung-uk Kim=head1 NOTE
33e71b7053SJung-uk Kim
34e71b7053SJung-uk KimBe careful to avoid small subgroup attacks when using this.
35e71b7053SJung-uk Kim
36e71b7053SJung-uk Kim=head1 SEE ALSO
37e71b7053SJung-uk Kim
38e71b7053SJung-uk KimL<DH_new(3)>, L<DSA_new(3)>, L<ERR_get_error(3)>
39e71b7053SJung-uk Kim
40*b077aed3SPierre Pronchery=head1 HISTORY
41*b077aed3SPierre Pronchery
42*b077aed3SPierre ProncheryThis function was deprecated in OpenSSL 3.0.
43*b077aed3SPierre Pronchery
44e71b7053SJung-uk Kim=head1 COPYRIGHT
45e71b7053SJung-uk Kim
46*b077aed3SPierre ProncheryCopyright 2000-2021 The OpenSSL Project Authors. All Rights Reserved.
47e71b7053SJung-uk Kim
48*b077aed3SPierre ProncheryLicensed under the Apache License 2.0 (the "License").  You may not use
49e71b7053SJung-uk Kimthis file except in compliance with the License.  You can obtain a copy
50e71b7053SJung-uk Kimin the file LICENSE in the source distribution or at
51e71b7053SJung-uk KimL<https://www.openssl.org/source/license.html>.
52e71b7053SJung-uk Kim
53e71b7053SJung-uk Kim=cut
54