]>
Commit | Line | Data |
---|---|---|
4486d0cd UM |
1 | =pod |
2 | ||
3 | =head1 NAME | |
4 | ||
6a2da303 PY |
5 | DH_size, DH_bits, DH_security_bits - get Diffie-Hellman prime size and |
6 | security bits | |
4486d0cd UM |
7 | |
8 | =head1 SYNOPSIS | |
9 | ||
6a2da303 | 10 | #include <openssl/dh.h> |
4486d0cd | 11 | |
ada66e78 P |
12 | Deprecated since OpenSSL 3.0, can be hidden entirely by defining |
13 | B<OPENSSL_API_COMPAT> with a suitable version value, see | |
14 | L<openssl_user_macros(7)>: | |
15 | ||
6a2da303 | 16 | int DH_size(const DH *dh); |
26c79d56 | 17 | |
6a2da303 PY |
18 | int DH_bits(const DH *dh); |
19 | ||
20 | int DH_security_bits(const DH *dh); | |
4486d0cd UM |
21 | |
22 | =head1 DESCRIPTION | |
23 | ||
ada66e78 P |
24 | All of the functions described on this page are deprecated. |
25 | Applications should instead use L<EVP_PKEY_bits(3)>, | |
26 | L<EVP_PKEY_security_bits(3)> and L<EVP_PKEY_size(3)>. | |
27 | ||
26c79d56 | 28 | DH_size() returns the Diffie-Hellman prime size in bytes. It can be used |
4486d0cd | 29 | to determine how much memory must be allocated for the shared secret |
6a2da303 | 30 | computed by L<DH_compute_key(3)>. |
4486d0cd | 31 | |
26c79d56 KR |
32 | DH_bits() returns the number of significant bits. |
33 | ||
34 | B<dh> and B<dh-E<gt>p> must not be B<NULL>. | |
4486d0cd | 35 | |
6a2da303 PY |
36 | DH_security_bits() returns the number of security bits of the given B<dh> |
37 | key. See L<BN_security_bits(3)>. | |
38 | ||
1f13ad31 | 39 | =head1 RETURN VALUES |
4486d0cd | 40 | |
6a2da303 PY |
41 | DH_size() returns the prime size of Diffie-Hellman in bytes. |
42 | ||
43 | DH_bits() returns the number of bits in the key. | |
44 | ||
45 | DH_security_bits() returns the number of security bits. | |
4486d0cd UM |
46 | |
47 | =head1 SEE ALSO | |
48 | ||
ada66e78 | 49 | L<EVP_PKEY_bits(3)>, |
b97fdb57 | 50 | L<DH_new(3)>, L<DH_generate_key(3)>, |
9b86974e | 51 | L<BN_num_bits(3)> |
4486d0cd UM |
52 | |
53 | =head1 HISTORY | |
54 | ||
ada66e78 P |
55 | All of these functions were deprecated in OpenSSL 3.0. |
56 | ||
fc5ecadd | 57 | The DH_bits() function was added in OpenSSL 1.1.0. |
4486d0cd | 58 | |
e2f92610 RS |
59 | =head1 COPYRIGHT |
60 | ||
61f805c1 | 61 | Copyright 2000-2018 The OpenSSL Project Authors. All Rights Reserved. |
e2f92610 | 62 | |
4746f25a | 63 | Licensed under the Apache License 2.0 (the "License"). You may not use |
e2f92610 RS |
64 | this file except in compliance with the License. You can obtain a copy |
65 | in the file LICENSE in the source distribution or at | |
66 | L<https://www.openssl.org/source/license.html>. | |
67 | ||
68 | =cut |