Name

gnutls_dh_params_export_pkcs3 — export DH params to a pkcs3 structure

Synopsis

#include <gnutls/gnutls.h>
int gnutls_dh_params_export_pkcs3( gnutls_dh_params_t   params,
  gnutls_x509_crt_fmt_t   format,
  unsigned char *   params_data,
  size_t *   params_data_size);

ARGUMENTS

gnutls_dh_params_t params

Holds the DH parameters

gnutls_x509_crt_fmt_t format

the format of output params. One of PEM or DER.

unsigned char * params_data

will contain a PKCS3 DHParams structure PEM or DER encoded

size_t * params_data_size

holds the size of params_data (and will be replaced by the actual size of parameters)

DESCRIPTION

This function will export the given dh parameters to a PKCS3 DHParams structure. This is the format generated by "openssl dhparam" tool. If the buffer provided is not long enough to hold the output, then GNUTLS_E_SHORT_MEMORY_BUFFER will be returned.

If the structure is PEM encoded, it will have a header of "BEGIN DH PARAMETERS".

In case of failure a negative value will be returned, and 0 on success.

REPORTING BUGS

Report bugs to <bug-gnutls@gnu.org>.

SEE ALSO

The full documentation for gnutls is maintained as a Texinfo manual. If the info and gnutls programs are properly installed at your site, the command

info gnutls

should give you access to the complete manual.

COPYRIGHT

Copyright © 2008 Free Software Foundation.

Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice are preserved on all copies.