Name

gnutls_x509_crt_list_import — This function will import a PEM encoded certificate list

Synopsis

#include <gnutls/x509.h>
int gnutls_x509_crt_list_import( gnutls_x509_crt_t *   certs,
  unsigned int *   cert_max,
  const gnutls_datum_t *   data,
  gnutls_x509_crt_fmt_t   format,
  unsigned int   flags);

ARGUMENTS

gnutls_x509_crt_t * certs

The structures to store the parsed certificate. Must not be initialized.

unsigned int * cert_max

Initially must hold the maximum number of certs. It will be updated with the number of certs available.

const gnutls_datum_t * data

The PEM encoded certificate.

gnutls_x509_crt_fmt_t format

One of DER or PEM.

unsigned int flags

must be zero or an OR'd sequence of gnutls_certificate_import_flags.

DESCRIPTION

This function will convert the given PEM encoded certificate list to the native gnutls_x509_crt_t format. The output will be stored in certs. They will be automatically initialized.

If the Certificate is PEM encoded it should have a header of "X509 CERTIFICATE", or "CERTIFICATE".

RETURNS

the number of certificates read or a negative error value.

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.