@deftypefun {int} {gnutls_x509_crt_list_import} (gnutls_x509_crt_t * @var{certs}, unsigned int * @var{cert_max}, const gnutls_datum_t * @var{data}, gnutls_x509_crt_fmt_t @var{format}, unsigned int @var{flags})

@var{certs}: Indicates where the parsed list will be copied to. Must not be initialized.

@var{cert_max}: Initially must hold the maximum number of certs. It will be updated with the number of certs available.

@var{data}: The PEM encoded certificate.

@var{format}: One of DER or PEM.

@var{flags}: must be (0) or an OR'd sequence of gnutls_certificate_import_flags.

This function will convert the given PEM encoded certificate list

to the native gnutls_x509_crt_t format. The output will be stored

in  @code{certs} .  They will be automatically initialized.

The flag @code{GNUTLS_X509_CRT_LIST_IMPORT_FAIL_IF_EXCEED}  will cause

import to fail if the certificates in the provided buffer are more

than the available structures. The @code{GNUTLS_X509_CRT_LIST_FAIL_IF_UNSORTED} 

flag will cause the function to fail if the provided list is not

sorted from subject to issuer.

If the Certificate is PEM encoded it should have a header of "X509

CERTIFICATE", or "CERTIFICATE".

@strong{Returns:} the number of certificates read or a negative error value.

@end deftypefun