![]() |
![]() |
![]() |
Gck Library Reference Manual | ![]() |
---|---|---|---|---|
Top | Description |
enum GckError; GList * gck_list_ref_copy (GList *reflist
); void gck_list_unref_free (GList *reflist
); gchar * gck_string_from_chars (const guchar *data
,gsize max
); gboolean gck_string_to_chars (guchar *data
,gsize max
,const gchar *string
); gboolean gck_value_to_boolean (const guchar *value
,gsize length
,gboolean *result
); gboolean gck_value_to_ulong (const guchar *value
,gsize length
,gulong *result
); #define GCK_INVALID
A few supporting functions that come in handy when dealing with the gck library or PKCS11 in general.
typedef enum { GCK_ERROR_MODULE_PROBLEM = (CKR_VENDOR_DEFINED | (GCK_VENDOR_CODE + 1)), } GckError;
Various error codes. All the CKR_XXX error codes from PKCS#11 are also relevant error codes.
GList * gck_list_ref_copy (GList *reflist
);
Copy a list of GObject based pointers. All objects in the list will be reffed and the list will be copied.
|
list of GObject reference counted objects. [element-type GLib.Object] |
Returns : |
the copied and
reffed list, when done, free it with gck_list_unref_free() . [transfer full][element-type GLib.Object]
|
void gck_list_unref_free (GList *reflist
);
Free a list of GObject based pointers. All objects in the list will be unreffed and then the list itself will be freed.
|
list of Gobject reference counted pointers. [element-type GLib.Object] |
gchar * gck_string_from_chars (const guchar *data
,gsize max
);
Create a string from a set of PKCS#11 characters. This is similar to g_strndup, except for that it also strips trailing spaces. These space padded strings are often used in PKCS#11 structures.
If the space padded string is filled with null characters then
this function will return NULL
.
|
The character data to turn into a null terminated string. |
|
The maximum length of the charater data. |
Returns : |
The null terminated string. |
gboolean gck_string_to_chars (guchar *data
,gsize max
,const gchar *string
);
Create a space padded PKCS#11 string from a null terminated string.
The string must be shorter than the buffer or FALSE
will be
returned.
If a NULL
string is passed, then the space padded string will be
set to zero characters.
|
The character buffer to place string into. |
|
The maximum length of the charater buffer. |
|
The string to place in the buffer. |
Returns : |
The null terminated string. |
gboolean gck_value_to_boolean (const guchar *value
,gsize length
,gboolean *result
);
Convert CK_BBOOL type memory to a boolean.
|
memory to convert. [array length=length] |
|
length of memory |
|
A location to store the result |
Returns : |
Whether the conversion was successful. |
gboolean gck_value_to_ulong (const guchar *value
,gsize length
,gulong *result
);
Convert CK_ULONG type memory to a boolean.
|
memory to convert. [array length=length] |
|
length of memory |
|
A location to store the result |
Returns : |
Whether the conversion was successful. |