Packages
gnome-keyring-1
GnomeKeyring
Stays crunchy ...
... even in milk.
Valadoc
Vala
Tutorial
Vala Journal
API-References
Markup
About
gnome-keyring-1
Description:
Content:
Namespaces:
GnomeKeyring
-
Classes:
AccessControl
-
A structure which contains access control information.
ApplicationRef
-
AttributeList
-
Found
-
A found structure returned by a found operation.
Info
-
ItemInfo
-
NetworkPasswordData
-
Network password info.
PasswordSchema
-
Describes a password schema.
Structs:
Attribute
-
An item attribute.
Enums:
AccessRestriction
-
Type of access restriction.
AccessType
-
Type of access.
AttributeType
-
ItemInfoFlags
-
ItemType
-
The types of items.
Result
-
Various result codes returned by functions.
Constants:
public
const
unowned
string
DEFAULT
public
const
unowned
string
SESSION
Delegates:
public
delegate
void
OperationDoneCallback
(
Result
result)
public
delegate
void
OperationGetAttributesCallback
(
Result
result,
AttributeList
attributes)
public
delegate
void
OperationGetIntCallback
(
Result
result,
uint32
val)
public
delegate
void
OperationGetItemInfoCallback
(
Result
result,
ItemInfo
info)
public
delegate
void
OperationGetKeyringInfoCallback
(
Result
result,
Info
info)
public
delegate
void
OperationGetListCallback
(
Result
result,
List
<
NetworkPasswordData
> list)
public
delegate
void
OperationGetStringCallback
(
Result
result,
string
? str)
Methods:
public
List
<
AccessControl
>
acl_copy
(
List
<
AccessControl
> list)
Copy an access control list.
public
void
cancel_request
(
void
* request)
Cancel an asynchronous request.
public
void
*
change_password
(
string
keyring,
string
? original,
string
? password,
owned
OperationDoneCallback
callback)
Change the password for a
keyring
.
public
Result
change_password_sync
(
string
keyring,
string
? original,
string
? password)
Change the password for
keyring
.
public
void
*
create
(
string
keyring_name,
string
? password,
owned
OperationDoneCallback
callback)
Create a new keyring with the specified name.
public
Result
create_sync
(
string
keyring_name,
string
? password)
Create a new keyring with the specified name.
public
Result
daemon_prepare_environment_sync
()
Deprecated.
public
Result
daemon_set_display_sync
(
string
display)
Deprecated.
public
void
*
@delete
(
string
keyring,
OperationDoneCallback
callback,
void
* data,
DestroyNotify
destroy_data)
Delete
keyring
.
public
void
*
delete_password
(
PasswordSchema
schema,
owned
OperationDoneCallback
callback, ...)
Delete a password that matches a given set of attributes.
public
Result
delete_password_sync
(
PasswordSchema
schema, ...)
Delete a password that matches a given set of attributes.
public
Result
delete_sync
(
string
keyring)
Delete
keyring
.
public
void
*
find_items
(
ItemType
type,
AttributeList
attributes,
owned
OperationGetListCallback
callback)
Searches through all keyrings for items that match the
attributes
.
public
Result
find_items_sync
(
ItemType
type,
AttributeList
attributes,
out
List
<
Found
> found)
Searches through all keyrings for items that match the
attributes
and
type
.
public
void
*
find_itemsv
(
ItemType
type,
owned
OperationGetListCallback
callback, ...)
Searches through all keyrings for items that match the specified attributes.
public
Result
find_itemsv_sync
(
ItemType
type,
out
List
<
Found
> found, ...)
Searches through all keyrings for items that match the
attributes
and
type
.
public
void
*
find_network_password
(
string
? user,
string
? domain,
string
? server,
string
? object,
string
? protocol,
string
? authtype,
uint32
port,
owned
OperationGetListCallback
callback)
Find a previously stored network password.
public
Result
find_network_password_sync
(
string
? user,
string
? domain,
string
? server,
string
? object,
string
? protocol,
string
? authtype,
uint32
port,
out
List
<
NetworkPasswordData
> results)
Find a previously stored network password.
public
void
*
find_password
(
PasswordSchema
schema,
owned
OperationGetStringCallback
callback, ...)
Find a password that matches a given set of attributes.
public
Result
find_password_sync
(
PasswordSchema
schema,
out
string
password, ...)
Find a password that matches a given set of attributes.
public
void
free_password
(
string
password)
Clears the memory used by password by filling with '\0' and frees the memory after doing this.
public
void
*
get_default_keyring
(
owned
OperationGetStringCallback
callback)
Get the default keyring name, which will be passed to the
callback
.
public
Result
get_default_keyring_sync
(
out
string
keyring)
Get the default keyring name.
public
void
*
get_info
(
string
? keyring,
owned
OperationGetKeyringInfoCallback
callback)
Get information about the
keyring
.
public
Result
get_info_sync
(
string
? keyring,
out
Info
info)
Get information about
keyring
.
public
bool
is_available
()
Check whether you can communicate with a gnome-keyring-daemon.
public
AccessType
item_ac_get_access_type
(
AccessControl
ac)
Get the application access rights for the access control.
public
unowned
string
item_ac_get_display_name
(
AccessControl
ac)
Get the access control application's display name.
public
unowned
string
item_ac_get_path_name
(
AccessControl
ac)
Get the access control application's full path name.
public
void
item_ac_set_access_type
(
AccessControl
ac,
AccessType
value)
Set the application access rights for the access control.
public
void
item_ac_set_display_name
(
AccessControl
ac,
string
value)
Set the access control application's display name.
public
void
item_ac_set_path_name
(
AccessControl
ac,
string
value)
Set the access control application's full path name.
public
void
*
item_create
(
string
? keyring,
ItemType
type,
string
display_name,
AttributeList
attributes,
string
secret,
bool
update_if_exists,
owned
OperationGetIntCallback
callback)
Create a new item in a keyring.
public
Result
item_create_sync
(
string
? keyring,
ItemType
type,
string
display_name,
AttributeList
attributes,
string
secret,
bool
update_if_exists,
out
uint32
item_id)
Create a new item in a keyring.
public
void
*
item_delete
(
string
? keyring,
uint32
id,
owned
OperationDoneCallback
callback)
Delete an item in a keyring.
public
Result
item_delete_sync
(
string
? keyring,
uint32
id)
Delete an item in a keyring.
public
void
*
item_get_acl
(
string
? keyring,
uint32
id,
owned
OperationGetListCallback
callback)
public
Result
item_get_acl_sync
(
string
? keyring,
uint32
id,
out
List
<
AccessControl
> acl)
public
void
*
item_get_attributes
(
string
? keyring,
uint32
id,
owned
OperationGetAttributesCallback
callback)
Get all the attributes for an item.
public
Result
item_get_attributes_sync
(
string
? keyring,
uint32
id,
out
AttributeList
attributes)
Get all attributes for an item.
public
void
*
item_get_info
(
string
? keyring,
uint32
id,
owned
OperationGetItemInfoCallback
callback)
Get information about an item and its secret.
public
void
*
item_get_info_full
(
string
? keyring,
uint32
id,
uint32
flags,
owned
OperationGetItemInfoCallback
callback)
Get information about an item, optionally retrieving its secret.
public
Result
item_get_info_full_sync
(
string
? keyring,
uint32
id,
uint32
flags,
out
ItemInfo
info)
Get information about an item, optionally retrieving its secret.
public
Result
item_get_info_sync
(
string
keyring,
uint32
id,
out
ItemInfo
info)
Get information about an item and its secret.
public
void
*
item_grant_access_rights
(
string
? keyring,
string
display_name,
string
full_path,
uint32
id,
AccessType
rights,
owned
OperationDoneCallback
callback)
public
Result
item_grant_access_rights_sync
(
string
? keyring,
string
display_name,
string
full_path,
uint32
id,
AccessType
rights)
Will grant the application access rights to the item, provided callee has write access to said item.
public
void
*
item_set_acl
(
string
? keyring,
uint32
id,
List
<
AccessControl
> acl,
owned
OperationDoneCallback
callback)
public
Result
item_set_acl_sync
(
string
? keyring,
uint32
id,
List
<
AccessControl
> acl)
public
void
*
item_set_attributes
(
string
? keyring,
uint32
id,
AttributeList
attributes,
owned
OperationDoneCallback
callback)
Set all the attributes for an item.
public
Result
item_set_attributes_sync
(
string
? keyring,
uint32
id,
AttributeList
attributes)
Set all the attributes for an item.
public
void
*
item_set_info
(
string
? keyring,
uint32
id,
ItemInfo
info,
owned
OperationDoneCallback
callback)
Set information on an item, like its display name, secret etc...
public
Result
item_set_info_sync
(
string
? keyring,
uint32
id,
ItemInfo
info)
Set information on an item, like its display name, secret etc...
public
void
*
list_item_ids
(
string
? keyring,
owned
OperationGetListCallback
callback)
Get a list of all the ids for items in
keyring
.
public
Result
list_item_ids_sync
(
string
? keyring,
out
List
<
uint
> ids)
Get a list of all the ids for items in
keyring
.
public
void
*
list_keyring_names
(
owned
OperationGetListCallback
callback)
Get a list of keyring names.
public
Result
list_keyring_names_sync
(
out
List
<
string
> keyrings)
Get a list of keyring names.
public
void
*
@lock
(
string
keyring,
OperationDoneCallback
callback,
void
* data,
DestroyNotify
destroy_data)
Lock a
keyring
, so that its contents may not be accessed without first supplying a password.
public
void
*
lock_all
(
owned
OperationDoneCallback
callback)
Lock all the keyrings, so that their contents may not be accessed without first unlocking them with a password.
public
Result
lock_all_sync
()
Lock all the keyrings, so that their contents may not eb accessed without first unlocking them with a password.
public
Result
lock_sync
(
string
? keyring)
Lock a
keyring
, so that its contents may not be accessed without first supplying a password.
public
void
*
memory_alloc
(
ulong
sz)
Allocate a block of gnome-keyring non-pageable memory.
public
void
memory_free
(
void
* p)
Free a block of gnome-keyring non-pageable memory.
public
bool
memory_is_secure
(
void
* p)
Check if a pointer is in non-pageable memory allocated by gnome-keyring.
public
void
*
memory_realloc
(
void
* p,
ulong
sz)
Reallocate a block of gnome-keyring non-pageable memory.
public
unowned
string
memory_strdup
(
string
str)
Copy a string into non-pageable memory.
public
void
*
memory_try_alloc
(
ulong
sz)
Allocate a block of gnome-keyring non-pageable memory.
public
void
*
memory_try_realloc
(
void
* p,
ulong
sz)
Reallocate a block of gnome-keyring non-pageable memory.
public
void
network_password_free
(
NetworkPasswordData
data)
Free a network password data pointer.
public
unowned
string
result_to_message
(
Result
res)
The
OK
and
CANCELLED
codes will return an empty string.
public
void
*
set_default_keyring
(
string
keyring,
owned
OperationDoneCallback
callback)
Change the default keyring.
public
Result
set_default_keyring_sync
(
string
keyring)
Change the default keyring.
public
void
*
set_info
(
string
? keyring,
Info
info,
owned
OperationDoneCallback
callback)
Set flags and info for the
keyring
.
public
Result
set_info_sync
(
string
? keyring,
Info
info)
Set flags and info for
keyring
.
public
void
*
set_network_password
(
string
? keyring,
string
? user,
string
? domain,
string
? server,
string
? object,
string
? protocol,
string
? authtype,
uint32
port,
string
? password,
owned
OperationGetIntCallback
callback)
Store a network password.
public
Result
set_network_password_sync
(
string
? keyring,
string
? user,
string
? domain,
string
? server,
string
? object,
string
? protocol,
string
? authtype,
uint32
port,
string
? password,
out
uint32
item_id)
Store a network password.
public
void
*
store_password
(
PasswordSchema
schema,
string
? keyring,
string
display_name,
string
password,
owned
OperationDoneCallback
callback, ...)
Store a password associated with a given set of attributes.
public
Result
store_password_sync
(
PasswordSchema
schema,
string
? keyring,
string
display_name,
string
password, ...)
Store a password associated with a given set of attributes.
public
void
*
unlock
(
string
? keyring,
string
? password,
owned
OperationDoneCallback
callback)
Unlock a
keyring
, so that its contents may be accessed.
public
Result
unlock_sync
(
string
? keyring,
string
? password)
Unlock a
keyring
, so that its contents may be accessed.
Fields:
public
PasswordSchema
NETWORK_PASSWORD