Item management: Libsecret Library Reference Manual

## Item management

In libsecret items are no longer identified by an unsigned integer. Applications should retrieve items based on their attributes. It is also possible to identify an item by its DBus object path.

Replacements for related libgnome-keyring functions and types are described below:

Table 6.

libgnome-keyring | libsecret
--- | ---
`gnome_keyring_item_create()` | `secret_item_create()`, although `secret_password_store()` may be simpler
`gnome_keyring_item_create_sync()` | `secret_item_create_sync()`, although `secret_password_store_sync()` may be simpler
`gnome_keyring_item_delete()` | `secret_item_delete()`, although `secret_password_clear()` may be simpler
`gnome_keyring_item_delete_sync()` | `secret_item_delete_sync()`, although `secret_password_clear_sync()` may be simpler
`gnome_keyring_item_get_info()` | properties are loaded on a SecretItem automatically, use `secret_item_load_secret()` to load the secret
`gnome_keyring_item_get_info_sync()` | properties are loaded on a SecretItem automatically, use `secret_item_load_secret_sync()` to load the secret
`gnome_keyring_item_get_info_full()` | properties are loaded on a SecretItem automatically, use `secret_item_load_secret()` to load the secret
`gnome_keyring_item_get_info_full_sync()` | properties are loaded on a SecretItem automatically, use `secret_item_load_secret_sync()` to load the secret
`gnome_keyring_item_set_info()` | use the appropriate setter methods on SecretItem
`gnome_keyring_item_set_info_sync()` | use the appropriate setter methods on SecretItem
`gnome_keyring_item_get_attributes()` | `secret_item_get_attributes()`
`gnome_keyring_item_get_attributes_sync()` | `secret_item_get_attributes()`
`gnome_keyring_item_set_attributes()` | `secret_item_set_attributes()`
`gnome_keyring_item_set_attributes_sync()` | `secret_item_set_attributes_sync()`
GnomeKeyringItemType | replaced by the name of a SecretSchema
GnomeKeyringItemInfo | SecretItem
`gnome_keyring_item_info_new()` | no equivalent
`gnome_keyring_item_info_copy()` | no equivalent
`gnome_keyring_item_info_free()` | `g_object_unref()` on the SecretItem
`gnome_keyring_item_info_get_display_name()` | `secret_item_get_label()`
`gnome_keyring_item_info_set_display_name()` | `secret_item_set_label()`
`gnome_keyring_item_info_get_ctime()` | `secret_item_get_created()`
`gnome_keyring_item_info_get_mtime()` | `secret_item_get_modified()`
`gnome_keyring_item_info_get_type()` | `secret_item_get_schema_name()`
`gnome_keyring_item_info_set_type()` | `secret_item_set_attributes()` with appropriate schema
`gnome_keyring_item_info_get_secret()` | `secret_item_get_secret()`
`gnome_keyring_item_info_set_secret()` | `secret_item_set_secret()` and `secret_item_set_secret_sync()`
`GNOME_KEYRING_ITEM_INFO_BASICS` | no equivalent, all basic item properties are loaded on SecretItem automatically
`GNOME_KEYRING_ITEM_INFO_SECRET` | use `secret_item_load_secret()` and `secret_item_load_secret_sync()` to load the secret for an item.
`gnome_keyring_item_info_set_display_name()` |