| 1 |
|
| 2 |
|
| 3 |
|
| 4 |
|
| 5 |
@deftypefun {void} {gnutls_dh_set_prime_bits} (gnutls_session_t @var{session}, unsigned int @var{bits}) |
| 6 |
@var{session}: is a @code{gnutls_session_t} type. |
| 7 |
|
| 8 |
@var{bits}: is the number of bits |
| 9 |
|
| 10 |
This function sets the number of bits, for use in a Diffie-Hellman |
| 11 |
key exchange. This is used both in DH ephemeral and DH anonymous |
| 12 |
cipher suites. This will set the minimum size of the prime that |
| 13 |
will be used for the handshake. |
| 14 |
|
| 15 |
In the client side it sets the minimum accepted number of bits. If |
| 16 |
a server sends a prime with less bits than that |
| 17 |
@code{GNUTLS_E_DH_PRIME_UNACCEPTABLE} will be returned by the handshake. |
| 18 |
|
| 19 |
Note that this function will warn via the audit log for value that |
| 20 |
are believed to be weak. |
| 21 |
|
| 22 |
The function has no effect in server side. |
| 23 |
|
| 24 |
Note that since 3.1.7 this function is deprecated. The minimum |
| 25 |
number of bits is set by the priority string level. |
| 26 |
Also this function must be called after @code{gnutls_priority_set_direct()} |
| 27 |
or the set value may be overridden by the selected priority options. |
| 28 |
@end deftypefun |