Top |
Functions
GckModule * | gck_module_initialize () |
void | gck_module_initialize_async () |
GckModule * | gck_module_initialize_finish () |
GckModule * | gck_module_new () |
gboolean | gck_module_equal () |
guint | gck_module_hash () |
gboolean | gck_module_match () |
const gchar * | gck_module_get_path () |
CK_FUNCTION_LIST_PTR | gck_module_get_functions () |
GckModuleInfo * | gck_module_get_info () |
GList * | gck_module_get_slots () |
GckModuleInfo * | gck_module_info_copy () |
void | gck_module_info_free () |
Description
A GckModule object holds a loaded PKCS#11 module. A PKCS#11 module is a shared library.
You can load and initialize a PKCS#11 module with the gck_module_initialize()
call. If you already
have a loaded and initialized module that you'd like to use with the various gck functions, then
you can use gck_module_new()
.
Functions
gck_module_initialize ()
GckModule * gck_module_initialize (const gchar *path
,GCancellable *cancellable
,GError **error
);
Load and initialize a PKCS#11 module represented by a GckModule object.
gck_module_initialize_async ()
void gck_module_initialize_async (const gchar *path
,GCancellable *cancellable
,GAsyncReadyCallback callback
,gpointer user_data
);
Asynchronously load and initialize a PKCS#11 module represented by a GckModule object.
gck_module_initialize_finish ()
GckModule * gck_module_initialize_finish (GAsyncResult *result
,GError **error
);
Finishes the asynchronous initialize operation.
gck_module_new ()
GckModule *
gck_module_new (CK_FUNCTION_LIST_PTR funcs
);
Create a GckModule representing a PKCS#11 module. It is assumed that this the module is already initialized. In addition it will not be finalized when complete.
[skip]
gck_module_equal ()
gboolean gck_module_equal (gconstpointer module1
,gconstpointer module2
);
Checks equality of two modules. Two GckModule objects can point to the same underlying PKCS#11 module.
gck_module_hash ()
guint
gck_module_hash (gconstpointer module
);
Create a hash value for the GckModule.
This function is intended for easily hashing a GckModule to add to a GHashTable or similar data structure.
gck_module_match ()
gboolean gck_module_match (GckModule *self
,GckUriData *uri
);
Check whether the PKCS#11 URI matches the module
gck_module_get_path ()
const gchar *
gck_module_get_path (GckModule *self
);
Get the file path of this module. This may not be an absolute path, and
usually reflects the path passed to gck_module_initialize()
.
gck_module_get_functions ()
CK_FUNCTION_LIST_PTR
gck_module_get_functions (GckModule *self
);
Get the PKCS#11 function list for the module.
[skip]
gck_module_get_info ()
GckModuleInfo *
gck_module_get_info (GckModule *self
);
Get the info about a PKCS#11 module.
gck_module_get_slots ()
GList * gck_module_get_slots (GckModule *self
,gboolean token_present
);
Get the GckSlot objects for a given module.
Parameters
self |
The module for which to get the slots. |
|
token_present |
Whether to limit only to slots with a token present. |
Returns
The possibly empty
list of slots. Release this with gck_list_unref_free()
.
[element-type Gck.Slot][transfer full]
gck_module_info_copy ()
GckModuleInfo *
gck_module_info_copy (GckModuleInfo *module_info
);
Make a copy of the module info.
gck_module_info_free ()
void
gck_module_info_free (GckModuleInfo *module_info
);
Free a GckModuleInfo structure.
Types and Values
struct GckModuleInfo
struct GckModuleInfo { guint8 pkcs11_version_major; guint8 pkcs11_version_minor; gchar *manufacturer_id; gulong flags; gchar *library_description; guint8 library_version_major; guint8 library_version_minor; };
Holds information about the PKCS#11 module.
This structure corresponds to CK_MODULE_INFO in the PKCS#11 standard. The strings are NULL terminated for easier use.
Use gck_module_info_free()
to release this structure when done with it.
Property Details
The “functions”
property
“functions” gpointer
The raw PKCS#11 function list for the module.
This points to a CK_FUNCTION_LIST structure.
Flags: Read / Write / Construct Only
The “path”
property
“path” gchar *
The PKCS#11 module file path.
This may be set to NULL if this object was created from an already
initialized module via the gck_module_new()
function.
Flags: Read / Write / Construct Only
Default value: NULL
Signal Details
The “authenticate-object”
signal
gboolean user_function (GckModule *module, GckObject *object, gchar *label, gpointer password, gpointer user_data)
Use gck_session_set_interaction()
instead of connecting to this signal.
GckModule::authenticate-object
is deprecated and should not be used in newly-written code.
Since 3.4
Parameters
module |
The module. |
|
object |
The object to be authenticated. |
|
label |
A displayable label which describes the object. |
|
password |
A gchar** where a password should be returned. |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
The “authenticate-slot”
signal
gboolean user_function (GckModule *module, GckSlot *slot, gchar *string, gpointer password, gpointer user_data)
Use gck_session_set_interaction()
instead of connecting to this signal.
GckModule::authenticate-slot
is deprecated and should not be used in newly-written code.
Since 3.4
Parameters
module |
The module |
|
slot |
The slot to be authenticated. |
|
string |
A displayable label which describes the object. |
|
password |
A gchar** where a password should be returned. |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last