1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
|
@deftypefun {int} {gnutls_pkcs11_obj_list_import_url4} (gnutls_pkcs11_obj_t ** @var{p_list}, unsigned int * @var{n_list}, const char * @var{url}, unsigned int @var{flags})
@var{p_list}: An uninitialized object list (may be NULL)
@var{n_list}: It will contain the size of the list.
@var{url}: A PKCS 11 url identifying a set of objects
@var{flags}: Or sequence of GNUTLS_PKCS11_OBJ_* flags
This function will enumerate all the objects specified by the PKCS@code{11} URL
provided. It will initialize and set values to the object pointer list ( @code{p_list} )
provided. To obtain a list of all available objects use a @code{url} of 'pkcs11:'.
All returned objects must be deinitialized using @code{gnutls_pkcs11_obj_deinit()} ,
and @code{p_list} must be deinitialized using @code{gnutls_free()} .
The supported in this function @code{flags} are @code{GNUTLS_PKCS11_OBJ_FLAG_LOGIN} ,
@code{GNUTLS_PKCS11_OBJ_FLAG_LOGIN_SO} , @code{GNUTLS_PKCS11_OBJ_FLAG_PRESENT_IN_TRUSTED_MODULE} ,
@code{GNUTLS_PKCS11_OBJ_FLAG_CRT} , @code{GNUTLS_PKCS11_OBJ_FLAG_PUBKEY} , @code{GNUTLS_PKCS11_OBJ_FLAG_PRIVKEY} ,
@code{GNUTLS_PKCS11_OBJ_FLAG_WITH_PRIVKEY} , @code{GNUTLS_PKCS11_OBJ_FLAG_MARK_CA} ,
@code{GNUTLS_PKCS11_OBJ_FLAG_MARK_TRUSTED} , and since 3.5.1 the @code{GNUTLS_PKCS11_OBJ_FLAG_OVERWRITE_TRUSTMOD_EXT} .
On versions of GnuTLS prior to 3.4.0 the equivalent function was
@code{gnutls_pkcs11_obj_list_import_url2()} . That is also available on this version
as a macro which maps to this function.
@strong{Returns:} On success, @code{GNUTLS_E_SUCCESS} (0) is returned, otherwise a
negative error value.
@strong{Since:} 3.4.0
@end deftypefun
|
