![]() |
![]() |
![]() |
gnome-keyring Reference Manual | |
---|---|---|---|---|
enum GnomeKeyringResult; enum GnomeKeyringItemType; enum GnomeKeyringAccessRestriction; enum GnomeKeyringAttributeType; typedef GnomeKeyringAccessControl; typedef GnomeKeyringApplicationRef; typedef GnomeKeyringAttributeList; enum GnomeKeyringAccessType; typedef GnomeKeyringInfo; typedef GnomeKeyringItemInfo; enum GnomeKeyringItemInfoFlags; GnomeKeyringAttribute; GnomeKeyringFound; void (*GnomeKeyringOperationDoneCallback) (GnomeKeyringResult result, gpointer data); void (*GnomeKeyringOperationGetStringCallback) (GnomeKeyringResult result, const char *string, gpointer data); void (*GnomeKeyringOperationGetIntCallback) (GnomeKeyringResult result, guint32 val, gpointer data); void (*GnomeKeyringOperationGetListCallback) (GnomeKeyringResult result, GList *list, gpointer data); void (*GnomeKeyringOperationGetKeyringInfoCallback) (GnomeKeyringResult result, GnomeKeyringInfo *info, gpointer data); void (*GnomeKeyringOperationGetItemInfoCallback) (GnomeKeyringResult result, GnomeKeyringItemInfo *info, gpointer data); void (*GnomeKeyringOperationGetAttributesCallback) (GnomeKeyringResult result, GnomeKeyringAttributeList *attributes, gpointer data); #define gnome_keyring_attribute_list_index(a, i) #define gnome_keyring_attribute_list_new() void gnome_keyring_attribute_list_append_string (GnomeKeyringAttributeList *attributes, const char *attribute, const char *value); void gnome_keyring_attribute_list_append_uint32 (GnomeKeyringAttributeList *attributes, const char *attribute, guint32 value); void gnome_keyring_attribute_list_free (GnomeKeyringAttributeList *attributes); GnomeKeyringAttributeList* gnome_keyring_attribute_list_copy (GnomeKeyringAttributeList *attributes); gboolean gnome_keyring_is_available (void); void gnome_keyring_free_password (char *password); void gnome_keyring_found_free (GnomeKeyringFound *found); void gnome_keyring_found_list_free (GList *found_list); void gnome_keyring_cancel_request (gpointer request); gpointer gnome_keyring_set_default_keyring (const char *keyring, GnomeKeyringOperationDoneCallback callback, gpointer data, GDestroyNotify destroy_data); GnomeKeyringResult gnome_keyring_set_default_keyring_sync (const char *keyring); gpointer gnome_keyring_get_default_keyring (GnomeKeyringOperationGetStringCallback callback, gpointer data, GDestroyNotify destroy_data); GnomeKeyringResult gnome_keyring_get_default_keyring_sync (char **keyring); gpointer gnome_keyring_list_keyring_names (GnomeKeyringOperationGetListCallback callback, gpointer data, GDestroyNotify destroy_data); GnomeKeyringResult gnome_keyring_list_keyring_names_sync (GList **keyrings); gpointer gnome_keyring_lock_all (GnomeKeyringOperationDoneCallback callback, gpointer data, GDestroyNotify destroy_data); GnomeKeyringResult gnome_keyring_lock_all_sync (void); gpointer gnome_keyring_create (const char *keyring_name, const char *password, GnomeKeyringOperationDoneCallback callback, gpointer data, GDestroyNotify destroy_data); GnomeKeyringResult gnome_keyring_create_sync (const char *keyring_name, const char *password); gpointer gnome_keyring_unlock (const char *keyring, const char *password, GnomeKeyringOperationDoneCallback callback, gpointer data, GDestroyNotify destroy_data); GnomeKeyringResult gnome_keyring_unlock_sync (const char *keyring, const char *password); gpointer gnome_keyring_lock (const char *keyring, GnomeKeyringOperationDoneCallback callback, gpointer data, GDestroyNotify destroy_data); GnomeKeyringResult gnome_keyring_lock_sync (const char *keyring); gpointer gnome_keyring_delete (const char *keyring, GnomeKeyringOperationDoneCallback callback, gpointer data, GDestroyNotify destroy_data); GnomeKeyringResult gnome_keyring_delete_sync (const char *keyring); gpointer gnome_keyring_get_info (const char *keyring, GnomeKeyringOperationGetKeyringInfoCallback callback, gpointer data, GDestroyNotify destroy_data); GnomeKeyringResult gnome_keyring_get_info_sync (const char *keyring, GnomeKeyringInfo **info); gpointer gnome_keyring_set_info (const char *keyring, GnomeKeyringInfo *info, GnomeKeyringOperationDoneCallback callback, gpointer data, GDestroyNotify destroy_data); GnomeKeyringResult gnome_keyring_set_info_sync (const char *keyring, GnomeKeyringInfo *info); gpointer gnome_keyring_list_item_ids (const char *keyring, GnomeKeyringOperationGetListCallback callback, gpointer data, GDestroyNotify destroy_data); GnomeKeyringResult gnome_keyring_list_item_ids_sync (const char *keyring, GList **ids); void gnome_keyring_info_free (GnomeKeyringInfo *keyring_info); GnomeKeyringInfo* gnome_keyring_info_copy (GnomeKeyringInfo *keyring_info); void gnome_keyring_info_set_lock_on_idle (GnomeKeyringInfo *keyring_info, gboolean value); gboolean gnome_keyring_info_get_lock_on_idle (GnomeKeyringInfo *keyring_info); void gnome_keyring_info_set_lock_timeout (GnomeKeyringInfo *keyring_info, guint32 value); guint32 gnome_keyring_info_get_lock_timeout (GnomeKeyringInfo *keyring_info); time_t gnome_keyring_info_get_mtime (GnomeKeyringInfo *keyring_info); time_t gnome_keyring_info_get_ctime (GnomeKeyringInfo *keyring_info); gboolean gnome_keyring_info_get_is_locked (GnomeKeyringInfo *keyring_info); gpointer gnome_keyring_find_items (GnomeKeyringItemType type, GnomeKeyringAttributeList *attributes, GnomeKeyringOperationGetListCallback callback, gpointer data, GDestroyNotify destroy_data); gpointer gnome_keyring_find_itemsv (GnomeKeyringItemType type, GnomeKeyringOperationGetListCallback callback, gpointer data, GDestroyNotify destroy_data, ...); GnomeKeyringResult gnome_keyring_find_items_sync (GnomeKeyringItemType type, GnomeKeyringAttributeList *attributes, GList **found); GnomeKeyringResult gnome_keyring_find_itemsv_sync (GnomeKeyringItemType type, GList **found, ...); gpointer gnome_keyring_item_create (const char *keyring, GnomeKeyringItemType type, const char *display_name, GnomeKeyringAttributeList *attributes, const char *secret, gboolean update_if_exists, GnomeKeyringOperationGetIntCallback callback, gpointer data, GDestroyNotify destroy_data); GnomeKeyringResult gnome_keyring_item_create_sync (const char *keyring, GnomeKeyringItemType type, const char *display_name, GnomeKeyringAttributeList *attributes, const char *secret, gboolean update_if_exists, guint32 *item_id); gpointer gnome_keyring_item_delete (const char *keyring, guint32 id, GnomeKeyringOperationDoneCallback callback, gpointer data, GDestroyNotify destroy_data); GnomeKeyringResult gnome_keyring_item_delete_sync (const char *keyring, guint32 id); gpointer gnome_keyring_item_get_info (const char *keyring, guint32 id, GnomeKeyringOperationGetItemInfoCallback callback, gpointer data, GDestroyNotify destroy_data); gpointer gnome_keyring_item_get_info_full (const char *keyring, guint32 id, guint32 flags, GnomeKeyringOperationGetItemInfoCallback callback, gpointer data, GDestroyNotify destroy_data); GnomeKeyringResult gnome_keyring_item_get_info_full_sync (const char *keyring, guint32 id, guint32 flags, GnomeKeyringItemInfo **info); GnomeKeyringResult gnome_keyring_item_get_info_sync (const char *keyring, guint32 id, GnomeKeyringItemInfo **info); gpointer gnome_keyring_item_set_info (const char *keyring, guint32 id, GnomeKeyringItemInfo *info, GnomeKeyringOperationDoneCallback callback, gpointer data, GDestroyNotify destroy_data); GnomeKeyringResult gnome_keyring_item_set_info_sync (const char *keyring, guint32 id, GnomeKeyringItemInfo *info); gpointer gnome_keyring_item_get_attributes (const char *keyring, guint32 id, GnomeKeyringOperationGetAttributesCallback callback, gpointer data, GDestroyNotify destroy_data); GnomeKeyringResult gnome_keyring_item_get_attributes_sync (const char *keyring, guint32 id, GnomeKeyringAttributeList **attributes); gpointer gnome_keyring_item_set_attributes (const char *keyring, guint32 id, GnomeKeyringAttributeList *attributes, GnomeKeyringOperationDoneCallback callback, gpointer data, GDestroyNotify destroy_data); GnomeKeyringResult gnome_keyring_item_set_attributes_sync (const char *keyring, guint32 id, GnomeKeyringAttributeList *attributes); gpointer gnome_keyring_item_get_acl (const char *keyring, guint32 id, GnomeKeyringOperationGetListCallback callback, gpointer data, GDestroyNotify destroy_data); GnomeKeyringResult gnome_keyring_item_get_acl_sync (const char *keyring, guint32 id, GList **acl); gpointer gnome_keyring_item_set_acl (const char *keyring, guint32 id, GList *acl, GnomeKeyringOperationDoneCallback callback, gpointer data, GDestroyNotify destroy_data); GnomeKeyringResult gnome_keyring_item_set_acl_sync (const char *keyring, guint32 id, GList *acl); void gnome_keyring_item_info_free (GnomeKeyringItemInfo *item_info); GnomeKeyringItemInfo* gnome_keyring_item_info_new (void); GnomeKeyringItemInfo* gnome_keyring_item_info_copy (GnomeKeyringItemInfo *item_info); GnomeKeyringItemType gnome_keyring_item_info_get_type (GnomeKeyringItemInfo *item_info); void gnome_keyring_item_info_set_type (GnomeKeyringItemInfo *item_info, GnomeKeyringItemType type); char* gnome_keyring_item_info_get_secret (GnomeKeyringItemInfo *item_info); void gnome_keyring_item_info_set_secret (GnomeKeyringItemInfo *item_info, const char *value); char* gnome_keyring_item_info_get_display_name (GnomeKeyringItemInfo *item_info); void gnome_keyring_item_info_set_display_name (GnomeKeyringItemInfo *item_info, const char *value); time_t gnome_keyring_item_info_get_mtime (GnomeKeyringItemInfo *item_info); time_t gnome_keyring_item_info_get_ctime (GnomeKeyringItemInfo *item_info); GnomeKeyringApplicationRef* gnome_keyring_application_ref_new (void); GnomeKeyringApplicationRef* gnome_keyring_application_ref_copy (const GnomeKeyringApplicationRef *app); void gnome_keyring_application_ref_free (GnomeKeyringApplicationRef *app); GnomeKeyringAccessControl* gnome_keyring_access_control_new (const GnomeKeyringApplicationRef *application, GnomeKeyringAccessType types_allowed); GnomeKeyringAccessControl* gnome_keyring_access_control_copy (GnomeKeyringAccessControl *ac); void gnome_keyring_access_control_free (GnomeKeyringAccessControl *ac); GList* gnome_keyring_acl_copy (GList *list); void gnome_keyring_acl_free (GList *acl); char* gnome_keyring_item_ac_get_display_name (GnomeKeyringAccessControl *ac); void gnome_keyring_item_ac_set_display_name (GnomeKeyringAccessControl *ac, const char *value); char* gnome_keyring_item_ac_get_path_name (GnomeKeyringAccessControl *ac); void gnome_keyring_item_ac_set_path_name (GnomeKeyringAccessControl *ac, const char *value); GnomeKeyringAccessType gnome_keyring_item_ac_get_access_type (GnomeKeyringAccessControl *ac); void gnome_keyring_item_ac_set_access_type (GnomeKeyringAccessControl *ac, const GnomeKeyringAccessType value); GnomeKeyringNetworkPasswordData; void gnome_keyring_network_password_free (GnomeKeyringNetworkPasswordData *data); void gnome_keyring_network_password_list_free (GList *list); gpointer gnome_keyring_find_network_password (const char *user, const char *domain, const char *server, const char *object, const char *protocol, const char *authtype, guint32 port, GnomeKeyringOperationGetListCallback callback, gpointer data, GDestroyNotify destroy_data); GnomeKeyringResult gnome_keyring_find_network_password_sync (const char *user, const char *domain, const char *server, const char *object, const char *protocol, const char *authtype, guint32 port, GList **result); gpointer gnome_keyring_set_network_password (const char *keyring, const char *user, const char *domain, const char *server, const char *object, const char *protocol, const char *authtype, guint32 port, const char *password, GnomeKeyringOperationGetIntCallback callback, gpointer data, GDestroyNotify destroy_data); GnomeKeyringResult gnome_keyring_set_network_password_sync (const char *keyring, const char *user, const char *domain, const char *server, const char *object, const char *protocol, const char *authtype, guint32 port, const char *password, guint32 *item_id);
typedef enum { GNOME_KEYRING_RESULT_OK, GNOME_KEYRING_RESULT_DENIED, GNOME_KEYRING_RESULT_NO_KEYRING_DAEMON, GNOME_KEYRING_RESULT_ALREADY_UNLOCKED, GNOME_KEYRING_RESULT_NO_SUCH_KEYRING, GNOME_KEYRING_RESULT_BAD_ARGUMENTS, GNOME_KEYRING_RESULT_IO_ERROR, GNOME_KEYRING_RESULT_CANCELLED, GNOME_KEYRING_RESULT_ALREADY_EXISTS } GnomeKeyringResult;
typedef enum { /* The item types */ GNOME_KEYRING_ITEM_GENERIC_SECRET, GNOME_KEYRING_ITEM_NETWORK_PASSWORD, GNOME_KEYRING_ITEM_NOTE, /* Used internally */ GNOME_KEYRING_ITEM_LAST_TYPE, GNOME_KEYRING_ITEM_TYPE_MASK = 0x0000ffff, GNOME_KEYRING_ITEM_NO_TYPE = GNOME_KEYRING_ITEM_TYPE_MASK, /* Makes a item only for applications in ACL */ GNOME_KEYRING_ITEM_APPLICATION_SECRET = 0x01000000, } GnomeKeyringItemType;
typedef enum { GNOME_KEYRING_ACCESS_ASK, GNOME_KEYRING_ACCESS_DENY, GNOME_KEYRING_ACCESS_ALLOW } GnomeKeyringAccessRestriction;
typedef enum { GNOME_KEYRING_ATTRIBUTE_TYPE_STRING, GNOME_KEYRING_ATTRIBUTE_TYPE_UINT32 } GnomeKeyringAttributeType;
typedef enum { GNOME_KEYRING_ACCESS_READ = 1<<0, GNOME_KEYRING_ACCESS_WRITE = 1<<1, GNOME_KEYRING_ACCESS_REMOVE = 1<<2 } GnomeKeyringAccessType;
typedef enum { GNOME_KEYRING_ITEM_INFO_BASICS = 0, GNOME_KEYRING_ITEM_INFO_SECRET = 1<<0 } GnomeKeyringItemInfoFlags;
typedef struct { char *name; GnomeKeyringAttributeType type; union { char *string; guint32 integer; } value; } GnomeKeyringAttribute;
typedef struct { char *keyring; guint item_id; GnomeKeyringAttributeList *attributes; char *secret; } GnomeKeyringFound;
void (*GnomeKeyringOperationDoneCallback) (GnomeKeyringResult result, gpointer data);
result : |
|
data : |
void (*GnomeKeyringOperationGetStringCallback) (GnomeKeyringResult result, const char *string, gpointer data);
result : |
|
string : |
|
data : |
void (*GnomeKeyringOperationGetIntCallback) (GnomeKeyringResult result, guint32 val, gpointer data);
result : |
|
val : |
|
data : |
void (*GnomeKeyringOperationGetListCallback) (GnomeKeyringResult result, GList *list, gpointer data);
result : |
|
list : |
|
data : |
void (*GnomeKeyringOperationGetKeyringInfoCallback) (GnomeKeyringResult result, GnomeKeyringInfo *info, gpointer data);
result : |
|
info : |
|
data : |
void (*GnomeKeyringOperationGetItemInfoCallback) (GnomeKeyringResult result, GnomeKeyringItemInfo *info, gpointer data);
result : |
|
info : |
|
data : |
void (*GnomeKeyringOperationGetAttributesCallback) (GnomeKeyringResult result, GnomeKeyringAttributeList *attributes, gpointer data);
result : |
|
attributes : |
|
data : |
void gnome_keyring_attribute_list_append_string (GnomeKeyringAttributeList *attributes, const char *attribute, const char *value);
Store a key-value-pair with a string value in attributes
.
attributes : |
a GnomeKeyringAttributeList |
attribute : |
|
value : |
the value to store in attributes
|
void gnome_keyring_attribute_list_append_uint32 (GnomeKeyringAttributeList *attributes, const char *attribute, guint32 value);
attributes : |
|
attribute : |
|
value : |
void gnome_keyring_attribute_list_free (GnomeKeyringAttributeList *attributes);
Free the memory used by attributes
.
attributes : |
a GnomeKeyringAttributeList |
GnomeKeyringAttributeList* gnome_keyring_attribute_list_copy (GnomeKeyringAttributeList *attributes);
attributes : |
|
Returns : |
gboolean gnome_keyring_is_available (void);
Check whether you can communicate with a Gnome Keyring Daemon.
Returns : |
FALSE if you can't communicate with the daemon (so you can't load
and save passwords).
|
void gnome_keyring_free_password (char *password);
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.
password : |
void gnome_keyring_found_free (GnomeKeyringFound *found);
Free the memory used by a GnomeKeyringFound item.
You usually want to use gnome_keyring_found_list_free()
on the list of
results.
found : |
a GnomeKeyringFound |
void gnome_keyring_found_list_free (GList *found_list);
Free the memory used by the GnomeKeyringFound items in found_list
.
found_list : |
a GList of GnomeKeyringFound |
gpointer gnome_keyring_set_default_keyring (const char *keyring, GnomeKeyringOperationDoneCallback callback, gpointer data, GDestroyNotify destroy_data);
keyring : |
|
callback : |
|
data : |
|
destroy_data : |
|
Returns : |
GnomeKeyringResult gnome_keyring_set_default_keyring_sync (const char *keyring);
keyring : |
|
Returns : |
gpointer gnome_keyring_get_default_keyring (GnomeKeyringOperationGetStringCallback callback, gpointer data, GDestroyNotify destroy_data);
callback : |
|
data : |
|
destroy_data : |
|
Returns : |
GnomeKeyringResult gnome_keyring_get_default_keyring_sync (char **keyring);
keyring : |
|
Returns : |
gpointer gnome_keyring_list_keyring_names (GnomeKeyringOperationGetListCallback callback, gpointer data, GDestroyNotify destroy_data);
callback : |
|
data : |
|
destroy_data : |
|
Returns : |
GnomeKeyringResult gnome_keyring_list_keyring_names_sync (GList **keyrings);
keyrings : |
|
Returns : |
gpointer gnome_keyring_lock_all (GnomeKeyringOperationDoneCallback callback, gpointer data, GDestroyNotify destroy_data);
callback : |
|
data : |
|
destroy_data : |
|
Returns : |
gpointer gnome_keyring_create (const char *keyring_name, const char *password, GnomeKeyringOperationDoneCallback callback, gpointer data, GDestroyNotify destroy_data);
keyring_name : |
|
password : |
|
callback : |
|
data : |
|
destroy_data : |
|
Returns : |
GnomeKeyringResult gnome_keyring_create_sync (const char *keyring_name, const char *password);
keyring_name : |
|
password : |
|
Returns : |
gpointer gnome_keyring_unlock (const char *keyring, const char *password, GnomeKeyringOperationDoneCallback callback, gpointer data, GDestroyNotify destroy_data);
keyring : |
|
password : |
|
callback : |
|
data : |
|
destroy_data : |
|
Returns : |
GnomeKeyringResult gnome_keyring_unlock_sync (const char *keyring, const char *password);
keyring : |
|
password : |
|
Returns : |
gpointer gnome_keyring_lock (const char *keyring, GnomeKeyringOperationDoneCallback callback, gpointer data, GDestroyNotify destroy_data);
keyring : |
|
callback : |
|
data : |
|
destroy_data : |
|
Returns : |
GnomeKeyringResult gnome_keyring_lock_sync (const char *keyring);
keyring : |
|
Returns : |
gpointer gnome_keyring_delete (const char *keyring, GnomeKeyringOperationDoneCallback callback, gpointer data, GDestroyNotify destroy_data);
keyring : |
|
callback : |
|
data : |
|
destroy_data : |
|
Returns : |
GnomeKeyringResult gnome_keyring_delete_sync (const char *keyring);
keyring : |
|
Returns : |
gpointer gnome_keyring_get_info (const char *keyring, GnomeKeyringOperationGetKeyringInfoCallback callback, gpointer data, GDestroyNotify destroy_data);
keyring : |
|
callback : |
|
data : |
|
destroy_data : |
|
Returns : |
GnomeKeyringResult gnome_keyring_get_info_sync (const char *keyring, GnomeKeyringInfo **info);
keyring : |
|
info : |
|
Returns : |
gpointer gnome_keyring_set_info (const char *keyring, GnomeKeyringInfo *info, GnomeKeyringOperationDoneCallback callback, gpointer data, GDestroyNotify destroy_data);
keyring : |
|
info : |
|
callback : |
|
data : |
|
destroy_data : |
|
Returns : |
GnomeKeyringResult gnome_keyring_set_info_sync (const char *keyring, GnomeKeyringInfo *info);
keyring : |
|
info : |
|
Returns : |
gpointer gnome_keyring_list_item_ids (const char *keyring, GnomeKeyringOperationGetListCallback callback, gpointer data, GDestroyNotify destroy_data);
keyring : |
|
callback : |
|
data : |
|
destroy_data : |
|
Returns : |
GnomeKeyringResult gnome_keyring_list_item_ids_sync (const char *keyring, GList **ids);
keyring : |
|
ids : |
|
Returns : |
void gnome_keyring_info_free (GnomeKeyringInfo *keyring_info);
keyring_info : |
GnomeKeyringInfo* gnome_keyring_info_copy (GnomeKeyringInfo *keyring_info);
keyring_info : |
|
Returns : |
void gnome_keyring_info_set_lock_on_idle (GnomeKeyringInfo *keyring_info, gboolean value);
keyring_info : |
|
value : |
gboolean gnome_keyring_info_get_lock_on_idle (GnomeKeyringInfo *keyring_info);
keyring_info : |
|
Returns : |
void gnome_keyring_info_set_lock_timeout (GnomeKeyringInfo *keyring_info, guint32 value);
keyring_info : |
|
value : |
guint32 gnome_keyring_info_get_lock_timeout (GnomeKeyringInfo *keyring_info);
keyring_info : |
|
Returns : |
time_t gnome_keyring_info_get_mtime (GnomeKeyringInfo *keyring_info);
keyring_info : |
|
Returns : |
time_t gnome_keyring_info_get_ctime (GnomeKeyringInfo *keyring_info);
keyring_info : |
|
Returns : |
gboolean gnome_keyring_info_get_is_locked (GnomeKeyringInfo *keyring_info);
keyring_info : |
|
Returns : |
gpointer gnome_keyring_find_items (GnomeKeyringItemType type, GnomeKeyringAttributeList *attributes, GnomeKeyringOperationGetListCallback callback, gpointer data, GDestroyNotify destroy_data);
type : |
|
attributes : |
|
callback : |
|
data : |
|
destroy_data : |
|
Returns : |
gpointer gnome_keyring_find_itemsv (GnomeKeyringItemType type, GnomeKeyringOperationGetListCallback callback, gpointer data, GDestroyNotify destroy_data, ...);
type : |
|
callback : |
|
data : |
|
destroy_data : |
|
... : |
|
Returns : |
GnomeKeyringResult gnome_keyring_find_items_sync (GnomeKeyringItemType type, GnomeKeyringAttributeList *attributes, GList **found);
Find elements of type GnomeKeyring by matching attributes and type
.
type : |
a GnomeKeyringItemType |
attributes : |
a GnomeKeyringAttributeList |
found : |
a return location for the found items, must not be NULL
|
Returns : | GNOME_KEYRING_RESULT_OK if everythink went fine. A GList of
GnomeKeyringFound will be returned into found , free all results with
gnome_keyring_found_list_free() or every single item with
gnome_keyring_found_free()
|
GnomeKeyringResult gnome_keyring_find_itemsv_sync (GnomeKeyringItemType type, GList **found, ...);
type : |
|
found : |
|
... : |
|
Returns : |
gpointer gnome_keyring_item_create (const char *keyring, GnomeKeyringItemType type, const char *display_name, GnomeKeyringAttributeList *attributes, const char *secret, gboolean update_if_exists, GnomeKeyringOperationGetIntCallback callback, gpointer data, GDestroyNotify destroy_data);
keyring : |
|
type : |
|
display_name : |
|
attributes : |
|
secret : |
|
update_if_exists : |
|
callback : |
|
data : |
|
destroy_data : |
|
Returns : |
GnomeKeyringResult gnome_keyring_item_create_sync (const char *keyring, GnomeKeyringItemType type, const char *display_name, GnomeKeyringAttributeList *attributes, const char *secret, gboolean update_if_exists, guint32 *item_id);
Create (or update of update_if_exists
is set) a keyring item with the
specified type, attributes and secret.
keyring : |
the keyring name (NULL for default)
|
type : |
the GnomeKeyringItemType of the item to save |
display_name : |
the name for this item to be used in the password manager |
attributes : |
the attributes specifying the keyring item |
secret : |
the secret information (password, passphrase, pin, etc) to be saved |
update_if_exists : |
set to TRUE to update an existing item, if found. Create
a new one otherwise. Only item attributes are matched.
|
item_id : |
return location for the id of the created/updated keyring item. |
Returns : |
GNOME_KEYRING_RESULT_OK if everything went fine.
|
gpointer gnome_keyring_item_delete (const char *keyring, guint32 id, GnomeKeyringOperationDoneCallback callback, gpointer data, GDestroyNotify destroy_data);
keyring : |
|
id : |
|
callback : |
|
data : |
|
destroy_data : |
|
Returns : |
GnomeKeyringResult gnome_keyring_item_delete_sync (const char *keyring, guint32 id);
Deletes an item from your keyring. Obtain id
by calling a function like
gnome_keyring_find_items_sync()
or gnome_keyring_item_create_sync()
.
keyring : |
the keyring to work with (NULL for the default keyring)
|
id : |
the keyring item id to delete |
Returns : |
GNOME_KEYRING_RESULT_OK on success, the error code otherwise.
|
gpointer gnome_keyring_item_get_info (const char *keyring, guint32 id, GnomeKeyringOperationGetItemInfoCallback callback, gpointer data, GDestroyNotify destroy_data);
keyring : |
|
id : |
|
callback : |
|
data : |
|
destroy_data : |
|
Returns : |
gpointer gnome_keyring_item_get_info_full (const char *keyring, guint32 id, guint32 flags, GnomeKeyringOperationGetItemInfoCallback callback, gpointer data, GDestroyNotify destroy_data);
keyring : |
|
id : |
|
flags : |
|
callback : |
|
data : |
|
destroy_data : |
|
Returns : |
GnomeKeyringResult gnome_keyring_item_get_info_full_sync (const char *keyring, guint32 id, guint32 flags, GnomeKeyringItemInfo **info);
keyring : |
|
id : |
|
flags : |
|
info : |
|
Returns : |
GnomeKeyringResult gnome_keyring_item_get_info_sync (const char *keyring, guint32 id, GnomeKeyringItemInfo **info);
keyring : |
|
id : |
|
info : |
|
Returns : |
gpointer gnome_keyring_item_set_info (const char *keyring, guint32 id, GnomeKeyringItemInfo *info, GnomeKeyringOperationDoneCallback callback, gpointer data, GDestroyNotify destroy_data);
keyring : |
|
id : |
|
info : |
|
callback : |
|
data : |
|
destroy_data : |
|
Returns : |
GnomeKeyringResult gnome_keyring_item_set_info_sync (const char *keyring, guint32 id, GnomeKeyringItemInfo *info);
keyring : |
|
id : |
|
info : |
|
Returns : |
gpointer gnome_keyring_item_get_attributes (const char *keyring, guint32 id, GnomeKeyringOperationGetAttributesCallback callback, gpointer data, GDestroyNotify destroy_data);
keyring : |
|
id : |
|
callback : |
|
data : |
|
destroy_data : |
|
Returns : |
GnomeKeyringResult gnome_keyring_item_get_attributes_sync (const char *keyring, guint32 id, GnomeKeyringAttributeList **attributes);
keyring : |
|
id : |
|
attributes : |
|
Returns : |
gpointer gnome_keyring_item_set_attributes (const char *keyring, guint32 id, GnomeKeyringAttributeList *attributes, GnomeKeyringOperationDoneCallback callback, gpointer data, GDestroyNotify destroy_data);
keyring : |
|
id : |
|
attributes : |
|
callback : |
|
data : |
|
destroy_data : |
|
Returns : |
GnomeKeyringResult gnome_keyring_item_set_attributes_sync (const char *keyring, guint32 id, GnomeKeyringAttributeList *attributes);
keyring : |
|
id : |
|
attributes : |
|
Returns : |
gpointer gnome_keyring_item_get_acl (const char *keyring, guint32 id, GnomeKeyringOperationGetListCallback callback, gpointer data, GDestroyNotify destroy_data);
keyring : |
|
id : |
|
callback : |
|
data : |
|
destroy_data : |
|
Returns : |
GnomeKeyringResult gnome_keyring_item_get_acl_sync (const char *keyring, guint32 id, GList **acl);
keyring : |
|
id : |
|
acl : |
|
Returns : |
gpointer gnome_keyring_item_set_acl (const char *keyring, guint32 id, GList *acl, GnomeKeyringOperationDoneCallback callback, gpointer data, GDestroyNotify destroy_data);
keyring : |
|
id : |
|
acl : |
|
callback : |
|
data : |
|
destroy_data : |
|
Returns : |
GnomeKeyringResult gnome_keyring_item_set_acl_sync (const char *keyring, guint32 id, GList *acl);
keyring : |
|
id : |
|
acl : |
|
Returns : |
void gnome_keyring_item_info_free (GnomeKeyringItemInfo *item_info);
item_info : |
GnomeKeyringItemInfo* gnome_keyring_item_info_copy (GnomeKeyringItemInfo *item_info);
item_info : |
|
Returns : |
GnomeKeyringItemType gnome_keyring_item_info_get_type (GnomeKeyringItemInfo *item_info);
item_info : |
|
Returns : |
void gnome_keyring_item_info_set_type (GnomeKeyringItemInfo *item_info, GnomeKeyringItemType type);
item_info : |
|
type : |
char* gnome_keyring_item_info_get_secret (GnomeKeyringItemInfo *item_info);
item_info : |
|
Returns : |
void gnome_keyring_item_info_set_secret (GnomeKeyringItemInfo *item_info, const char *value);
item_info : |
|
value : |
char* gnome_keyring_item_info_get_display_name (GnomeKeyringItemInfo *item_info);
item_info : |
|
Returns : |
void gnome_keyring_item_info_set_display_name (GnomeKeyringItemInfo *item_info, const char *value);
item_info : |
|
value : |
time_t gnome_keyring_item_info_get_mtime (GnomeKeyringItemInfo *item_info);
item_info : |
|
Returns : |
time_t gnome_keyring_item_info_get_ctime (GnomeKeyringItemInfo *item_info);
item_info : |
|
Returns : |
GnomeKeyringApplicationRef* gnome_keyring_application_ref_new (void);
Returns : |
GnomeKeyringApplicationRef* gnome_keyring_application_ref_copy (const GnomeKeyringApplicationRef *app);
app : |
|
Returns : |
void gnome_keyring_application_ref_free (GnomeKeyringApplicationRef *app);
app : |
GnomeKeyringAccessControl* gnome_keyring_access_control_new (const GnomeKeyringApplicationRef *application, GnomeKeyringAccessType types_allowed);
application : |
|
types_allowed : |
|
Returns : |
GnomeKeyringAccessControl* gnome_keyring_access_control_copy (GnomeKeyringAccessControl *ac);
ac : |
|
Returns : |
void gnome_keyring_access_control_free (GnomeKeyringAccessControl *ac);
ac : |
char* gnome_keyring_item_ac_get_display_name (GnomeKeyringAccessControl *ac);
ac : |
|
Returns : |
void gnome_keyring_item_ac_set_display_name (GnomeKeyringAccessControl *ac, const char *value);
ac : |
|
value : |
char* gnome_keyring_item_ac_get_path_name (GnomeKeyringAccessControl *ac);
ac : |
|
Returns : |
void gnome_keyring_item_ac_set_path_name (GnomeKeyringAccessControl *ac, const char *value);
ac : |
|
value : |
GnomeKeyringAccessType gnome_keyring_item_ac_get_access_type (GnomeKeyringAccessControl *ac);
ac : |
|
Returns : |
void gnome_keyring_item_ac_set_access_type (GnomeKeyringAccessControl *ac, const GnomeKeyringAccessType value);
ac : |
|
value : |
typedef struct { char *keyring; guint32 item_id; char *protocol; char *server; char *object; char *authtype; guint32 port; char *user; char *domain; char *password; } GnomeKeyringNetworkPasswordData;
void gnome_keyring_network_password_free (GnomeKeyringNetworkPasswordData *data);
data : |
void gnome_keyring_network_password_list_free (GList *list);
list : |
gpointer gnome_keyring_find_network_password (const char *user, const char *domain, const char *server, const char *object, const char *protocol, const char *authtype, guint32 port, GnomeKeyringOperationGetListCallback callback, gpointer data, GDestroyNotify destroy_data);
user : |
|
domain : |
|
server : |
|
object : |
|
protocol : |
|
authtype : |
|
port : |
|
callback : |
|
data : |
|
destroy_data : |
|
Returns : |
GnomeKeyringResult gnome_keyring_find_network_password_sync (const char *user, const char *domain, const char *server, const char *object, const char *protocol, const char *authtype, guint32 port, GList **result);
user : |
|
domain : |
|
server : |
|
object : |
|
protocol : |
|
authtype : |
|
port : |
|
result : |
|
Returns : |
gpointer gnome_keyring_set_network_password (const char *keyring, const char *user, const char *domain, const char *server, const char *object, const char *protocol, const char *authtype, guint32 port, const char *password, GnomeKeyringOperationGetIntCallback callback, gpointer data, GDestroyNotify destroy_data);
keyring : |
|
user : |
|
domain : |
|
server : |
|
object : |
|
protocol : |
|
authtype : |
|
port : |
|
password : |
|
callback : |
|
data : |
|
destroy_data : |
|
Returns : |
GnomeKeyringResult gnome_keyring_set_network_password_sync (const char *keyring, const char *user, const char *domain, const char *server, const char *object, const char *protocol, const char *authtype, guint32 port, const char *password, guint32 *item_id);
keyring : |
|
user : |
|
domain : |
|
server : |
|
object : |
|
protocol : |
|
authtype : |
|
port : |
|
password : |
|
item_id : |
|
Returns : |