1gnutls_pkcs11_obj_list_import_url4(3)gnutlsgnutls_pkcs11_obj_list_import_url4(3)
2
3
4

NAME

6       gnutls_pkcs11_obj_list_import_url4 - API function
7

SYNOPSIS

9       #include <gnutls/pkcs11.h>
10
11       int  gnutls_pkcs11_obj_list_import_url4(gnutls_pkcs11_obj_t  ** p_list,
12       unsigned int * n_list, const char * url, unsigned int flags);
13

ARGUMENTS

15       gnutls_pkcs11_obj_t ** p_list
16                   An uninitialized object list (may be NULL)
17
18       unsigned int * n_list
19                   It will contain the size of the list.
20
21       const char * url
22                   A PKCS 11 url identifying a set of objects
23
24       unsigned int flags
25                   Or sequence of GNUTLS_PKCS11_OBJ_* flags
26

DESCRIPTION

28       This function will enumerate all the objects specified  by  the  PKCS11
29       URL  provided.  It will initialize and set values to the object pointer
30       list ( p_list ) provided. To obtain a list of all available objects use
31       a  url of 'pkcs11:'.
32
33       All     returned     objects     must     be     deinitialized    using
34       gnutls_pkcs11_obj_deinit(), and  p_list  must  be  deinitialized  using
35       gnutls_free().
36
37       The supported in this function  flags are GNUTLS_PKCS11_OBJ_FLAG_LOGIN,
38       GNUTLS_PKCS11_OBJ_FLAG_LOGIN_SO,
39       GNUTLS_PKCS11_OBJ_FLAG_PRESENT_IN_TRUSTED_MODULE,
40       GNUTLS_PKCS11_OBJ_FLAG_CRT,              GNUTLS_PKCS11_OBJ_FLAG_PUBKEY,
41       GNUTLS_PKCS11_OBJ_FLAG_PRIVKEY,    GNUTLS_PKCS11_OBJ_FLAG_WITH_PRIVKEY,
42       GNUTLS_PKCS11_OBJ_FLAG_MARK_CA,    GNUTLS_PKCS11_OBJ_FLAG_MARK_TRUSTED,
43       and since 3.5.1 the GNUTLS_PKCS11_OBJ_FLAG_OVERWRITE_TRUSTMOD_EXT.
44
45       On  versions  of  GnuTLS  prior  to  3.4.0  the equivalent function was
46       gnutls_pkcs11_obj_list_import_url2(). That is also  available  on  this
47       version as a macro which maps to this function.
48

RETURNS

50       On  success, GNUTLS_E_SUCCESS (0) is returned, otherwise a negative er‐
51       ror value.
52

SINCE

54       3.4.0
55

REPORTING BUGS

57       Report bugs to <bugs@gnutls.org>.
58       Home page: https://www.gnutls.org
59
60
62       Copyright © 2001- Free Software Foundation, Inc., and others.
63       Copying and distribution of this file, with  or  without  modification,
64       are  permitted in any medium without royalty provided the copyright no‐
65       tice and this notice are preserved.
66

SEE ALSO

68       The full documentation for gnutls is maintained as  a  Texinfo  manual.
69       If  the /usr/share/doc/gnutls/ directory does not contain the HTML form
70       visit
71
72       https://www.gnutls.org/manual/
73
74gnutls                               3.7.2gnutls_pkcs11_obj_list_import_url4(3)
Impressum