Blame doc/functions/gnutls_dh_params_generate2
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
@deftypefun {int} {gnutls_dh_params_generate2} (gnutls_dh_params_t @var{dparams}, unsigned int @var{bits})
|
|
Packit Service |
4684c1 |
@var{dparams}: The parameters
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
@var{bits}: is the prime's number of bits
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
This function will generate a new pair of prime and generator for use in
|
|
Packit Service |
4684c1 |
the Diffie-Hellman key exchange. This may take long time.
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
It is recommended not to set the number of bits directly, but
|
|
Packit Service |
4684c1 |
use @code{gnutls_sec_param_to_pk_bits()} instead.
|
|
Packit Service |
4684c1 |
Also note that the DH parameters are only useful to servers.
|
|
Packit Service |
4684c1 |
Since clients use the parameters sent by the server, it's of
|
|
Packit Service |
4684c1 |
no use to call this in client side.
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
The parameters generated are of the DSA form. It also is possible
|
|
Packit Service |
4684c1 |
to generate provable parameters (following the Shawe-Taylor
|
|
Packit Service |
4684c1 |
algorithm), using @code{gnutls_x509_privkey_generate2()} with DSA option
|
|
Packit Service |
4684c1 |
and the @code{GNUTLS_PRIVKEY_FLAG_PROVABLE} flag set. These can the
|
|
Packit Service |
4684c1 |
be imported with @code{gnutls_dh_params_import_dsa()} .
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
It is no longer recommended for applications to generate parameters.
|
|
Packit Service |
4684c1 |
See the "Parameter generation" section in the manual.
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
@strong{Returns:} On success, @code{GNUTLS_E_SUCCESS} (0) is returned,
|
|
Packit Service |
4684c1 |
otherwise a negative error code is returned.
|
|
Packit Service |
4684c1 |
@end deftypefun
|