Copy an access control list.
A list of #GnomeKeyringAccessControl pointers.
Free an access control list.
A list of #GnomeKeyringAccessControl pointers.
Copy a list of item attributes.
Create a new #GnomeKeyringAttributeList.
Create #GList of #GnomeKeyringAttribute pointers from attributes
. This is
mostly useful in language bindings which cannot directly use a #GArray.
Cancel an asynchronous request.
If a callback was registered when making the asynchronous request, that callback function will be called with a result of %GNOME_KEYRING_RESULT_CANCELLED
The request returned from the asynchronous call function.
Change the password for keyring
. In most cases you would specify %NULL for
both the original
and password
arguments and allow the user to type the
correct passwords.
For an asynchronous version of this function see gnome_keyring_change_password().
The name of the keyring to change the password for. Cannot be %NULL
The old keyring password, or %NULL to prompt the user for it.
The new keyring password, or %NULL to prompt the user for it.
Create a new keyring with the specified name. In most cases %NULL will be
passed in as the password,
which will prompt the user to enter a password
of their choice.
For an asynchronous version of this function see gnome_keyring_create().
The new keyring name. Must not be %NULL
The password for the new keyring. If %NULL user will be prompted.
Delete keyring
. Once a keyring is deleted there is no mechanism for
recovery of its contents.
For an asynchronous version of this function see gnome_keyring_delete().
The name of the keyring to delete. Cannot be %NULL
Searches through all keyrings for items that match the attributes
and type
.
The matches are for exact equality.
A %GList of GnomeKeyringFound structures is returned in found
. The list may
have zero items if nothing matched the criteria. The list should be freed
using gnome_keyring_found_list_free().
The user may have been prompted to unlock necessary keyrings, and user will have been prompted for access to the items if needed.
For an asynchronous version of this function see gnome_keyring_find_items().
The type of items to find.
A list of attributes to search for. This cannot be an empty list.
Find a previously stored network password. Searches all keyrings.
A %GList of #GnomeKeyringNetworkPasswordData structures are returned in the
out_list
argument. The list should be freed with gnome_keyring_network_password_list_free()
The user may have been prompted to unlock necessary keyrings, and user will have been prompted for access to the items if needed.
Network passwords are items with the item type %GNOME_KEYRING_ITEM_NETWORK_PASSWORD
The user name or %NULL.
The domain name or %NULL.
The server or %NULL.
The remote object or %NULL.
The network protocol or %NULL.
The authentication type or %NULL.
The network port or zero.
Free the memory used by the #GnomeKeyringFound items in found_list
.
a #GList of #GnomeKeyringFound
Clears the memory used by password by filling with '\0' and frees the memory after doing this. You should use this function instead of g_free() for secret information.
the password to be freed
Get the default keyring name.
The string returned in keyring
must be freed with g_free().
For an asynchronous version of this function see gnome_keyring_get_default_keyring().
Get information about keyring
.
The #GnomeKeyringInfo structure returned in info
must be freed with
gnome_keyring_info_free().
For an asynchronous version of this function see gnome_keyring_get_info().
The name of the keyring, or %NULL for the default keyring.
Check whether you can communicate with a gnome-keyring-daemon.
Get the application access rights for the access control.
A #GnomeKeyringAccessControl pointer.
Get the access control application's display name.
A #GnomeKeyringAccessControl pointer.
Get the access control application's full path name.
A #GnomeKeyringAccessControl pointer.
Set the application access rights for the access control.
A #GnomeKeyringAccessControl pointer.
The new access rights.
Set the access control application's display name.
A #GnomeKeyringAccessControl pointer.
The new application display name.
Set the access control application's full path name.
A #GnomeKeyringAccessControl pointer
The new application full path.
Create a new item in a keyring.
The secret
must be a null terminated string. It should be allocated using secure
memory whenever possible. See gnome_keyring_memory_strdup()
The user may have been prompted to unlock necessary keyrings. If %NULL is
specified as the keyring
and no default keyring exists, the user will be
prompted to create a new keyring.
When update_if_exists
is set to %TRUE, the user may be prompted for access
to the previously existing item.
For an asynchronous version of this function see gnome_keyring_item_create().
The name of the keyring in which to create the item, or %NULL for the default keyring.
The item type.
The name of the item. This will be displayed to the user where necessary.
A (possibly empty) list of attributes to store with the item.
The password or secret of the item.
If true, then another item matching the type, and attributes will be updated instead of creating a new item.
Delete an item in a keyring.
The user may be prompted if the calling application doesn't have necessary access to delete the item.
For an asynchronous version of this function see gnome_keyring_item_delete().
The name of the keyring from which to delete the item, or %NULL for the default keyring.
The id of the item
Get all attributes for an item.
A #GnomeKeyringAttributeList will be returned in attributes
. This should be
freed using gnome_keyring_attribute_list_free().
For an asynchronous version of this function see gnome_keyring_item_get_attributes().
The name of the keyring in which the item exists, or %NULL for the default keyring.
The id of the item
The location to return a pointer to the attribute list.
Get information about an item, optionally retrieving its secret.
If flags
includes %GNOME_KEYRING_ITEM_INFO_SECRET then the user may be
prompted if the calling application doesn't have necessary access to read
the item with its secret.
A #GnomeKeyringItemInfo structure will be returned in info
. Certain fields
of this structure may be %NULL or zero if they were not specified in flags
.
This must be freed using gnome_keyring_item_info_free().
For an asynchronous version of this function see gnome_keyring_item_get_info_full().
The name of the keyring in which the item exists, or %NULL for the default keyring.
The id of the item
The parts of the item to retrieve.
Get information about an item and its secret.
The user may be prompted if the calling application doesn't have necessary access to read the item with its secret.
A #GnomeKeyringItemInfo structure will be returned in info
. This must be
freed using gnome_keyring_item_info_free().
For an asynchronous version of this function see gnome_keyring_item_get_info().
The name of the keyring in which the item exists, or %NULL for the default keyring.
The id of the item
Will grant the application access rights to the item, provided callee has write access to said item.
The keyring name, or %NULL for the default keyring.
The display name for the application, as returned by g_get_application_name().
The full filepath to the application.
The id of the item to grant access to.
The type of rights to grant.
Set all the attributes for an item. This will replace any previous attributes set on the item.
For an asynchronous version of this function see gnome_keyring_item_set_attributes().
The name of the keyring in which the item exists, or %NULL for the default keyring.
The id of the item
The full list of attributes to set on the item.
Set information on an item, like its display name, secret etc...
Only the fields in the info
pointer that are non-null or non-zero will be
set on the item.
For an asynchronous version of this function see gnome_keyring_item_set_info().
The name of the keyring in which the item exists, or %NULL for the default keyring.
The id of the item
The item info to save into the item.
Get a list of all the ids for items in keyring
.
Use GPOINTER_TO_UINT() on the list to access the integer ids. The list should be freed with g_list_free().
For an asynchronous version of this function see gnome_keyring_list_item_ids().
The name of the keyring, or %NULL for the default keyring.
Get a list of keyring names.
The list returned in in keyrings
must be freed using
gnome_keyring_string_list_free().
For an asynchronous version of this function see gnome_keyring_list_keyring_names().
Lock all the keyrings, so that their contents may not eb accessed without first unlocking them with a password.
For an asynchronous version of this function see gnome_keyring_lock_all().
Lock a keyring,
so that its contents may not be accessed without first
supplying a password.
Most keyring opretaions involving items require that you first unlock the keyring. One exception is gnome_keyring_find_items_sync() and related functions.
For an asynchronous version of this function see gnome_keyring_lock().
The name of the keyring to lock, or %NULL for the default keyring.
Free a network password data pointer. If %NULL is passed in, nothing happens.
A #GnomeKeyringNetworkPasswordData pointer.
Free a list of network password data.
A list of #GnomeKeyringNetworkPasswordData pointers.
The #GNOME_KEYRING_RESULT_OK and #GNOME_KEYRING_RESULT_CANCELLED codes will return an empty string.
Note that there are some results for which the application will need to take appropriate action rather than just display an error message to the user.
A #GnomeKeyringResult
Change the default keyring.
For an asynchronous version of this function see gnome_keyring_set_default_keyring().
The keyring to make default
Set flags and info for keyring
. The only fields in info
that are used
are lock_on_idle and lock_timeout.
For an asynchronous version of this function see gnome_keyring_set_info().
The name of the keyring, or %NULL for the default keyring.
A structure containing flags and info for the keyring.
Store a network password.
If an item already exists for with this network info (ie: user, server etc...) then it will be updated.
The created or updated item id will be returned in item_id
.
Network passwords are items with the item type %GNOME_KEYRING_ITEM_NETWORK_PASSWORD
The keyring to store the password in, or %NULL for the default keyring.
The user name or %NULL.
The domain name or %NULL.
The server or %NULL.
The remote object or %NULL.
The network protocol or %NULL.
The authentication type or %NULL.
The network port or zero.
The password to store, must not be %NULL.
Free a list of string pointers.
A %GList of string pointers.
Unlock a keyring,
so that its contents may be accessed. In most cases %NULL
will be passed in as the password,
which will prompt the user to enter the
correct password.
Most keyring opretaions involving items require that yo ufirst unlock the keyring. One exception is gnome_keyring_find_items_sync() and related functions.
For an asynchronous version of this function see gnome_keyring_unlock().
The name of the keyring to unlock, or %NULL for the default keyring.
The password to unlock the keyring with, or %NULL to prompt the user.