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