![]() |
![]() |
![]() |
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()
|