|  |  |  | 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. |