gnutls_x509_crt_list_import_url(3) — Linux manual page



NAME         top

       gnutls_x509_crt_list_import_url - API function

SYNOPSIS         top

       #include <gnutls/x509.h>

       int gnutls_x509_crt_list_import_url(gnutls_x509_crt_t ** certs,
       unsigned int * size, const char * url, gnutls_pin_callback_t
       pin_fn, void * pin_fn_userdata, unsigned int flags);

ARGUMENTS         top

       gnutls_x509_crt_t ** certs
                   Will hold the allocated certificate list.

       unsigned int * size
                   It will contain the size of the list.

       const char * url
                   A PKCS 11 url

       gnutls_pin_callback_t pin_fn
                   a PIN callback if not globally set

       void * pin_fn_userdata
                   parameter for the PIN callback

       unsigned int flags
                   One of GNUTLS_PKCS11_OBJ_* flags for PKCS11 URLs or
                   zero otherwise

DESCRIPTION         top

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

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

RETURNS         top

       On success, GNUTLS_E_SUCCESS (0) is returned, otherwise a
       negative error value.

SINCE         top


REPORTING BUGS         top

       Report bugs to <>.
       Home page:

COPYRIGHT         top

       Copyright © 2001- Free Software Foundation, Inc., and others.
       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.

SEE ALSO         top

       The full documentation for gnutls is maintained as a Texinfo
       manual.  If the /usr/share/doc/gnutls/ directory does not contain
       the HTML form visit 

COLOPHON         top

       This page is part of the GnuTLS (GnuTLS Transport Layer Security
       Library) project.  Information about the project can be found at
       ⟨⟩.  If you have a bug report for this
       manual page, send it to  This page was obtained
       from the tarball gnutls-3.7.8.tar.xz fetched from
       ⟨⟩ on 2022-12-17.  If you
       discover any rendering problems in this HTML version of the page,
       or you believe there is a better or more up-to-date source for
       the page, or you have corrections or improvements to the
       information in this COLOPHON (which is not part of the original
       manual page), send a mail to

gnutls                            3.7.8gnutls_x509_crt_list_import_url(3)