NAME

       gnutls_pkcs11_obj_list_import_url4 - API function

SYNOPSIS

       #include <gnutls/pkcs11.h>

       int  gnutls_pkcs11_obj_list_import_url4(gnutls_pkcs11_obj_t  **  p_list,  unsigned  int  *
       n_list, const char * url, unsigned int flags);

ARGUMENTS

       gnutls_pkcs11_obj_t ** p_list
                   An uninitialized object list (may be NULL)

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

       const char * url
                   A PKCS 11 url identifying a set of objects

       unsigned int flags
                   Or sequence of GNUTLS_PKCS11_OBJ_* flags

DESCRIPTION

       This function will initialize and set values to  an  object  list  by  using  all  objects
       identified  by  the  PKCS  11  URL.  The  output  is  stored  in   p_list  , which will be
       initialized.

       All returned objects must be deinitialized using gnutls_pkcs11_obj_deinit(),  and   p_list
       must be free'd using gnutls_free().

       The    supported    in    this    function     flags   are   GNUTLS_PKCS11_OBJ_FLAG_LOGIN,
       GNUTLS_PKCS11_OBJ_FLAG_LOGIN_SO,         GNUTLS_PKCS11_OBJ_FLAG_PRESENT_IN_TRUSTED_MODULE,
       GNUTLS_PKCS11_OBJ_FLAG_CRT, GNUTLS_PKCS11_OBJ_FLAG_PUBKEY, GNUTLS_PKCS11_OBJ_FLAG_PRIVKEY,
       GNUTLS_PKCS11_OBJ_FLAG_WITH_PRIVKEY,                       GNUTLS_PKCS11_OBJ_FLAG_MARK_CA,
       GNUTLS_PKCS11_OBJ_FLAG_MARK_TRUSTED.

RETURNS

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

SINCE

       3.4.0

REPORTING BUGS

       Report bugs to <bugs@gnutls.org>.
       Home page: http://www.gnutls.org

COPYRIGHT

       Copyright © 2001-2021 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

       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

       http://www.gnutls.org/manual/