manpagez: man pages & more
man gnutls_pkcs11_obj_list_import_url4(3)
Home | html | info | man
gnutls_pkcs11_obj_list_import_url4(3)



NAME

       gnutls_pkcs11_obj_list_import_url4 - API function


SYNOPSIS

       #include <gnutls/pkcs11.h>

       gnutls_pkcs11_obj_list_import_url4(3)  ** 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 enumerate all the objects specified  by  the  PKCS11
       URL  provided.  It will initialize and set values to the object pointer
       list ( p_list ) provided. To obtain a list of all available objects use
       a  url of 'pkcs11:'.

       All     returned     objects     must     be     deinitialized    using
       gnutls_pkcs11_obj_deinit(), and  p_list  must  be  deinitialized  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,
       and since 3.5.1 the GNUTLS_PKCS11_OBJ_FLAG_OVERWRITE_TRUSTMOD_EXT.

       On  versions  of  GnuTLS  prior  to  3.4.0  the equivalent function was
       gnutls_pkcs11_obj_list_import_url2(). That is also  available  on  this
       version as a macro which maps to this function.


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 (C) 2001-2017 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/




gnutls                               gnutls_pkcs11_obj_list_import_url4(3)

gnutls 3.5.8 - Generated Mon Jan 9 21:18:36 CST 2017
© manpagez.com 2000-2024
Individual documents may contain additional copyright information.