Linux manual pages Section 3  

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".

RETURNS

On success, GNUTLS_E_SUCCESS (zero) is returned, otherwise an error code is returned.

REPORTING BUGS

Report bugs to <[email protected]>. GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/

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.

Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved.