Blob Blame History Raw




@deftypefun {int} {gnutls_x509_crt_list_import_url} (gnutls_x509_crt_t ** @var{certs}, unsigned int * @var{size}, const char * @var{url}, gnutls_pin_callback_t @var{pin_fn}, void * @var{pin_fn_userdata}, unsigned int @var{flags})
@var{certs}: Will hold the allocated certificate list.

@var{size}: It will contain the size of the list.

@var{url}: A PKCS 11 url

@var{pin_fn}: a PIN callback if not globally set

@var{pin_fn_userdata}: parameter for the PIN callback

@var{flags}: One of GNUTLS_PKCS11_OBJ_* flags for PKCS@code{11}  URLs or zero otherwise

This function will import a certificate chain present in a PKCS@code{11}  token
or any type of back-end that supports URLs. The certificates
must be deinitialized afterwards using @code{gnutls_x509_crt_deinit()} 
and the returned pointer must be freed using @code{gnutls_free()} .

The URI provided must be the first certificate in the chain; subsequent
certificates will be retrieved using @code{gnutls_pkcs11_get_raw_issuer()}  or
equivalent functionality for the supported URI.

@strong{Returns:} On success, @code{GNUTLS_E_SUCCESS}  (0) is returned, otherwise a
negative error value.

@strong{Since:} 3.6.3
@end deftypefun