| Top |  |
 |
 |
 |
Functions
| GList * | gck_modules_initialize_registered () |
| void | gck_modules_initialize_registered_async () |
| GList * | gck_modules_initialize_registered_finish () |
| GckEnumerator * | gck_modules_enumerate_objects () |
| GckEnumerator * | gck_modules_enumerate_uri () |
| GList * | gck_modules_get_slots () |
| GckObject * | gck_modules_object_for_uri () |
| GList * | gck_modules_objects_for_uri () |
| GckSlot * | gck_modules_token_for_uri () |
| GList * | gck_modules_tokens_for_uri () |
Description
These functions are useful for dealing with lists of modules, and performing operations on all of them.
Functions
gck_modules_initialize_registered ()
GList * gck_modules_initialize_registered (GCancellable *cancellable,GError **error);
Load and initialize all the registered modules.
Parameters
cancellable |
optional cancellation object. |
[allow-none] |
error |
location to place an error on failure. |
[allow-none] |
Returns
A newly allocated list
of GckModule objects, which should be released with gck_list_unref_free().
[transfer full][element-type Gck.Module]
gck_modules_initialize_registered_async ()
void gck_modules_initialize_registered_async (GCancellable *cancellable,GAsyncReadyCallback callback,gpointer user_data);
Load and initialize all the registered modules asynchronously.
gck_modules_initialize_registered_finish ()
GList * gck_modules_initialize_registered_finish (GAsyncResult *result,GError **error);
Finishes the asynchronous operation to initialize the registered PKCS#11 modules.
gck_modules_enumerate_objects ()
GckEnumerator * gck_modules_enumerate_objects (GList *modules,GckAttributes *attrs,GckSessionOptions session_options);
Setup an enumerator for listing matching objects on the modules.
This call will not block but will return an enumerator immediately.
If the attrs
GckAttributes is floating, it is consumed.
gck_modules_enumerate_uri ()
GckEnumerator * gck_modules_enumerate_uri (GList *modules,const gchar *uri,GckSessionOptions session_options,GError **error);
Enumerate objects that match a URI.
This call will not block. Use the GckEnumerator functions in order to get at the actual objects that match.
gck_modules_get_slots ()
GList * gck_modules_get_slots (GList *modules,gboolean token_present);
Get a list of slots for across all of the modules.
Parameters
modules |
The modules. |
[element-type Gck.Module] |
token_present |
Whether to only list slots with token present |
Returns
A list of GckSlot
objects, which should be freed with gck_list_unref_free().
[transfer full][element-type Gck.Slot]
gck_modules_object_for_uri ()
GckObject * gck_modules_object_for_uri (GList *modules,const gchar *uri,GckSessionOptions session_options,GError **error);
Find an object that matches a URI.
This call can block. Use gck_modules_enumerate_uri() for a non-blocking
version.
Parameters
modules |
The modules. |
[element-type Gck.Module] |
uri |
The URI the objects must match |
|
session_options |
Options from GckSessionOptions |
|
error |
A location to raise an error on failure. |
Returns
A new GckObject which should be released with
g_object_unref(), or NULL if no matching object was found.
[transfer full][allow-none]
gck_modules_objects_for_uri ()
GList * gck_modules_objects_for_uri (GList *modules,const gchar *uri,GckSessionOptions session_options,GError **error);
Find objects that match a URI.
This call can block. Use gck_modules_enumerate_uri() for a non-blocking
version.
Parameters
modules |
The modules. |
[element-type Gck.Module] |
uri |
The URI the objects must match |
|
session_options |
Options from GckSessionOptions |
|
error |
A location to raise an error on failure. |
Returns
A list of GckObject which
should be released with gck_list_unref_free(), or NULL if no matching object
was found.
[transfer full][element-type Gck.Object]
gck_modules_token_for_uri ()
GckSlot * gck_modules_token_for_uri (GList *modules,const gchar *uri,GError **error);
Lookup a token that matches the URI.
gck_modules_tokens_for_uri ()
GList * gck_modules_tokens_for_uri (GList *modules,const gchar *uri,GError **error);
Lookup a token that matches the URI.
Parameters
modules |
The modules. |
[element-type Gck.Module] |
uri |
The URI that the token must match |
|
error |
A location to raise an error on failure |
Returns
A list of newly allocated
GckSlot objects. Use gck_list_unref_free() to release the list once you're
done with it.
[transfer full][element-type Gck.Slot]