|  |  |  | gnome-keyring Reference Manual | |
|---|---|---|---|---|
#define gnome_keyring_memory_new (type, n_objects) gpointer gnome_keyring_memory_alloc (gulong sz); gpointer gnome_keyring_memory_try_alloc (gulong sz); gpointer gnome_keyring_memory_realloc (gpointer p, gulong sz); gpointer gnome_keyring_memory_try_realloc (gpointer p, gulong sz); void gnome_keyring_memory_free (gpointer p); gboolean gnome_keyring_memory_is_secure (gpointer p); gchar* gnome_keyring_memory_strdup (const gchar *str);
#define gnome_keyring_memory_new(type, n_objects)
Allocate objects in non-pageable gnome-keyring memory.
| type: | The C type of the objects to allocate | 
| n_objects: | The number of objects to allocate. | 
gpointer gnome_keyring_memory_alloc (gulong sz);
Allocate a block of gnome-keyring non-pageable memory.
If non-pageable memory cannot be allocated then normal memory will be returned.
| sz: | The new desired size of the memory block. | 
| Returns : | The new memory block which should be freed with gnome_keyring_memory_free() | 
gpointer gnome_keyring_memory_try_alloc (gulong sz);
Allocate a block of gnome-keyring non-pageable memory.
If non-pageable memory cannot be allocated, then NULL is returned.
| sz: | The new desired size of the memory block. | 
| Returns : | The new block, or NULL if memory cannot be allocated.
The memory block should be freed with gnome_keyring_memory_free() | 
gpointer            gnome_keyring_memory_realloc        (gpointer p,
                                                         gulong sz);
Reallocate a block of gnome-keyring non-pageable memory.
Glib memory is also reallocated correctly. If called with a null pointer, then a new block of memory is allocated. If called with a zero size, then the block of memory is freed.
If non-pageable memory cannot be allocated then normal memory will be returned.
| p: | The pointer to reallocate or NULL to allocate a new block. | 
| sz: | The new desired size of the memory block, or 0 to free the memory. | 
| Returns : | The new block, or NULL if the block was freed.
The memory block should be freed with gnome_keyring_memory_free() | 
gpointer            gnome_keyring_memory_try_realloc    (gpointer p,
                                                         gulong sz);
Reallocate a block of gnome-keyring non-pageable memory.
Glib memory is also reallocated correctly when passed to this function. If called with a null pointer, then a new block of memory is allocated. If called with a zero size, then the block of memory is freed.
If memory cannot be allocated, NULL is returned and the original block of memory remains intact.
| p: | The pointer to reallocate or NULL to allocate a new block. | 
| sz: | The new desired size of the memory block. | 
| Returns : | The new block, or NULL if memory cannot be allocated.
The memory block should be freed with gnome_keyring_memory_free() | 
void gnome_keyring_memory_free (gpointer p);
Free a block of gnome-keyring non-pageable memory.
Glib memory is also freed correctly when passed to this function. If called with a null pointer then no action is taken.
| p: | The pointer to the beginning of the block of memory to free. | 
gboolean gnome_keyring_memory_is_secure (gpointer p);
Check if a pointer is in non-pageable memory allocated by gnome-keyring.
| p: | The pointer to check | 
| Returns : | Whether the memory is non-pageable or not | 
gchar* gnome_keyring_memory_strdup (const gchar *str);
Copy a string into non-pageable memory.
| str: | The null terminated string to copy | 
| Returns : | The copied string, should be freed with gnome_keyring_memory_free() |