secret_collection_new_for_dbus_path ()

void
secret_collection_new_for_dbus_path (SecretService *service,
                                     const gchar *collection_path,
                                     SecretCollectionFlags flags,
                                     GCancellable *cancellable,
                                     GAsyncReadyCallback callback,
                                     gpointer user_data);

Get a new collection proxy for a collection in the secret service.

If service is NULL, then secret_service_get() will be called to get the default SecretService proxy.

This method will return immediately and complete asynchronously.

[skip]

Stability Level: Unstable

secret_collection_new_for_dbus_path_finish ()

SecretCollection *
secret_collection_new_for_dbus_path_finish
                               (GAsyncResult *result,
                                GError **error);

Finish asynchronous operation to get a new collection proxy for a collection in the secret service.

[skip]

secret_collection_new_for_dbus_path_sync ()

SecretCollection *
secret_collection_new_for_dbus_path_sync
                               (SecretService *service,
                                const gchar *collection_path,
                                SecretCollectionFlags flags,
                                GCancellable *cancellable,
                                GError **error);

Get a new collection proxy for a collection in the secret service.

If service is NULL, then secret_service_get_sync() will be called to get the default SecretService proxy.

This method may block indefinitely and should not be used in user interface threads.

[skip]

Stability Level: Unstable

secret_item_new_for_dbus_path ()

void
secret_item_new_for_dbus_path (SecretService *service,
                               const gchar *item_path,
                               SecretItemFlags flags,
                               GCancellable *cancellable,
                               GAsyncReadyCallback callback,
                               gpointer user_data);

Get a new item proxy for a secret item in the secret service.

If service is NULL, then secret_service_get() will be called to get the default SecretService proxy.

This method will return immediately and complete asynchronously.

[skip]

Stability Level: Unstable

secret_item_new_for_dbus_path_finish ()

SecretItem *
secret_item_new_for_dbus_path_finish (GAsyncResult *result,
                                      GError **error);

Finish asynchronous operation to get a new item proxy for a secret item in the secret service.

[skip]

Stability Level: Unstable

secret_item_new_for_dbus_path_sync ()

SecretItem *
secret_item_new_for_dbus_path_sync (SecretService *service,
                                    const gchar *item_path,
                                    SecretItemFlags flags,
                                    GCancellable *cancellable,
                                    GError **error);

Get a new item proxy for a secret item in the secret service.

If service is NULL, then secret_service_get_sync() will be called to get the default SecretService proxy.

This method may block indefinitely and should not be used in user interface threads.

[skip]

Stability Level: Unstable

secret_service_get_session_dbus_path ()

const gchar *
secret_service_get_session_dbus_path (SecretService *self);

Get the D-Bus object path of the session object being used to transfer secrets between this secret service proxy and the Secret Service itself.

This will be NULL if no session has been established. Use secret_service_ensure_session() to establish a session.

secret_service_search_for_dbus_paths ()

void
secret_service_search_for_dbus_paths (SecretService *self,
                                      const SecretSchema *schema,
                                      GHashTable *attributes,
                                      GCancellable *cancellable,
                                      GAsyncReadyCallback callback,
                                      gpointer user_data);

Search for items matching the attributes , and return their D-Bus object paths. All collections are searched. The attributes should be a table of string keys and string values.

This function returns immediately and completes asynchronously.

When your callback is called use secret_service_search_for_dbus_paths_finish() to get the results of this function. Only the D-Bus object paths of the items will be returned. If you would like SecretItem objects to be returned instead, then use the secret_service_search() function.

[skip]

Stability Level: Unstable

secret_service_search_for_dbus_paths_finish ()

gboolean
secret_service_search_for_dbus_paths_finish
                               (SecretService *self,
                                GAsyncResult *result,
                                gchar ***unlocked,
                                gchar ***locked,
                                GError **error);

Complete asynchronous operation to search for items, and return their D-Bus object paths.

Matching items that are locked or unlocked, have their D-Bus paths placed in the locked or unlocked arrays respectively.

D-Bus object paths of the items will be returned in the unlocked or locked arrays. If you would to have SecretItem objects to be returned instead, then us the secret_service_search() and secret_service_search_finish() functions.

[skip]

Stability Level: Unstable

secret_service_search_for_dbus_paths_sync ()

gboolean
secret_service_search_for_dbus_paths_sync
                               (SecretService *self,
                                const SecretSchema *schema,
                                GHashTable *attributes,
                                GCancellable *cancellable,
                                gchar ***unlocked,
                                gchar ***locked,
                                GError **error);

Search for items matching the attributes , and return their D-Bus object paths. All collections are searched. The attributes should be a table of string keys and string values.

This function may block indefinitely. Use the asynchronous version in user interface threads.

Matching items that are locked or unlocked, have their D-Bus paths placed in the locked or unlocked arrays respectively.

D-Bus object paths of the items will be returned in the unlocked or locked arrays. If you would to have SecretItem objects to be returned instead, then use the secret_service_search_sync() function.

[skip]

Stability Level: Unstable

secret_collection_search_for_dbus_paths ()

void
secret_collection_search_for_dbus_paths
                               (SecretCollection *collection,
                                const SecretSchema *schema,
                                GHashTable *attributes,
                                GCancellable *cancellable,
                                GAsyncReadyCallback callback,
                                gpointer user_data);

Search for items in collection matching the attributes , and return their DBus object paths. Only the specified collection is searched. The attributes should be a table of string keys and string values.

This function returns immediately and completes asynchronously.

When your callback is called use secret_collection_search_for_dbus_paths_finish() to get the results of this function. Only the DBus object paths of the items will be returned. If you would like SecretItem objects to be returned instead, then use the secret_collection_search() function.

[skip]

Stability Level: Unstable

secret_collection_search_for_dbus_paths_finish ()

gchar **
secret_collection_search_for_dbus_paths_finish
                               (SecretCollection *collection,
                                GAsyncResult *result,
                                GError **error);

Complete asynchronous operation to search for items in a collection.

DBus object paths of the items will be returned. If you would to have SecretItem objects to be returned instead, then use the secret_collection_search() and secret_collection_search_finish() functions.

[skip]

Stability Level: Unstable

secret_collection_search_for_dbus_paths_sync ()

gchar **
secret_collection_search_for_dbus_paths_sync
                               (SecretCollection *collection,
                                const SecretSchema *schema,
                                GHashTable *attributes,
                                GCancellable *cancellable,
                                GError **error);

Search for items matching the attributes in collection , and return their DBus object paths. The attributes should be a table of string keys and string values.

This function may block indefinitely. Use the asynchronous version in user interface threads.

DBus object paths of the items will be returned. If you would to have SecretItem objects to be returned instead, then use the secret_collection_search_sync() function.

[skip]

Stability Level: Unstable

secret_service_get_secrets_for_dbus_paths ()

void
secret_service_get_secrets_for_dbus_paths
                               (SecretService *self,
                                const gchar **item_paths,
                                GCancellable *cancellable,
                                GAsyncReadyCallback callback,
                                gpointer user_data);

Get the secret values for a secret item stored in the service.

The items are represented by their D-Bus object paths. If you already have SecretItem proxy objects, use use secret_item_load_secrets() to more simply get their secret values.

This function returns immediately and completes asynchronously.

[skip]

Stability Level: Unstable

secret_service_get_secrets_for_dbus_paths_finish ()

GHashTable *
secret_service_get_secrets_for_dbus_paths_finish
                               (SecretService *self,
                                GAsyncResult *result,
                                GError **error);

Complete asynchronous operation to get the secret values for an secret items stored in the service.

Items that are locked will not be included the results.

[skip]

Stability Level: Unstable

secret_service_get_secrets_for_dbus_paths_sync ()

GHashTable *
secret_service_get_secrets_for_dbus_paths_sync
                               (SecretService *self,
                                const gchar **item_paths,
                                GCancellable *cancellable,
                                GError **error);

Get the secret values for a secret item stored in the service.

The items are represented by their D-Bus object paths. If you already have SecretItem proxy objects, use use secret_item_load_secrets_sync() to more simply get their secret values.

This method may block indefinitely and should not be used in user interface threads.

Items that are locked will not be included the results.

[skip]

Stability Level: Unstable

secret_service_get_secret_for_dbus_path ()

void
secret_service_get_secret_for_dbus_path
                               (SecretService *self,
                                const gchar *item_path,
                                GCancellable *cancellable,
                                GAsyncReadyCallback callback,
                                gpointer user_data);

Get the secret value for a secret item stored in the service.

The item is represented by its D-Bus object path. If you already have a SecretItem proxy object, use use secret_item_get_secret() to more simply get its secret value.

This function returns immediately and completes asynchronously.

[skip]

Stability Level: Unstable

secret_service_get_secret_for_dbus_path_finish ()

SecretValue *
secret_service_get_secret_for_dbus_path_finish
                               (SecretService *self,
                                GAsyncResult *result,
                                GError **error);

Complete asynchronous operation to get the secret value for an secret item stored in the service.

Will return NULL if the item is locked.

[skip]

Stability Level: Unstable

secret_service_get_secret_for_dbus_path_sync ()

SecretValue *
secret_service_get_secret_for_dbus_path_sync
                               (SecretService *self,
                                const gchar *item_path,
                                GCancellable *cancellable,
                                GError **error);

Get the secret value for a secret item stored in the service.

The item is represented by its D-Bus object path. If you already have a SecretItem proxy object, use use secret_item_load_secret_sync() to more simply get its secret value.

This method may block indefinitely and should not be used in user interface threads.

Will return NULL if the item is locked.

[skip]

Stability Level: Unstable

secret_service_lock_dbus_paths ()

void
secret_service_lock_dbus_paths (SecretService *self,
                                const gchar **paths,
                                GCancellable *cancellable,
                                GAsyncReadyCallback callback,
                                gpointer user_data);

Lock items or collections in the secret service.

The items or collections are represented by their D-Bus object paths. If you already have SecretItem and SecretCollection proxy objects, use use secret_service_lock() instead.

The secret service may not be able to lock items individually, and may lock an entire collection instead.

This method returns immediately and completes asynchronously. The secret service may prompt the user. secret_service_prompt() will be used to handle any prompts that show up.

[skip]

Stability Level: Unstable

secret_service_lock_dbus_paths_finish ()

gint
secret_service_lock_dbus_paths_finish (SecretService *self,
                                       GAsyncResult *result,
                                       gchar ***locked,
                                       GError **error);

Complete asynchronous operation to lock items or collections in the secret service.

The secret service may not be able to lock items individually, and may lock an entire collection instead.

[skip]

Stability Level: Unstable

secret_service_lock_dbus_paths_sync ()

gint
secret_service_lock_dbus_paths_sync (SecretService *self,
                                     const gchar **paths,
                                     GCancellable *cancellable,
                                     gchar ***locked,
                                     GError **error);

Lock items or collections in the secret service.

The items or collections are represented by their D-Bus object paths. If you already have SecretItem and SecretCollection proxy objects, use use secret_service_lock_sync() instead.

The secret service may not be able to lock items individually, and may lock an entire collection instead.

This method may block indefinitely and should not be used in user interface threads. The secret service may prompt the user. secret_service_prompt() will be used to handle any prompts that show up.

[skip]

Stability Level: Unstable

secret_service_unlock_dbus_paths ()

void
secret_service_unlock_dbus_paths (SecretService *self,
                                  const gchar **paths,
                                  GCancellable *cancellable,
                                  GAsyncReadyCallback callback,
                                  gpointer user_data);

Unlock items or collections in the secret service.

The items or collections are represented by their D-Bus object paths. If you already have SecretItem and SecretCollection proxy objects, use use secret_service_unlock() instead.

The secret service may not be able to unlock items individually, and may unlock an entire collection instead.

This method returns immediately and completes asynchronously. The secret service may prompt the user. secret_service_prompt() will be used to handle any prompts that show up.

[skip]

Stability Level: Unstable

secret_service_unlock_dbus_paths_finish ()

gint
secret_service_unlock_dbus_paths_finish
                               (SecretService *self,
                                GAsyncResult *result,
                                gchar ***unlocked,
                                GError **error);

Complete asynchronous operation to unlock items or collections in the secret service.

The secret service may not be able to unlock items individually, and may unlock an entire collection instead.

[skip]

Stability Level: Unstable

secret_service_unlock_dbus_paths_sync ()

gint
secret_service_unlock_dbus_paths_sync (SecretService *self,
                                       const gchar **paths,
                                       GCancellable *cancellable,
                                       gchar ***unlocked,
                                       GError **error);

Unlock items or collections in the secret service.

The items or collections are represented by their D-Bus object paths. If you already have SecretItem and SecretCollection proxy objects, use use secret_service_unlock_sync() instead.

The secret service may not be able to unlock items individually, and may unlock an entire collection instead.

This method may block indefinitely and should not be used in user interface threads. The secret service may prompt the user. secret_service_prompt() will be used to handle any prompts that show up.

[skip]

Stability Level: Unstable

secret_service_prompt_at_dbus_path ()

void
secret_service_prompt_at_dbus_path (SecretService *self,
                                    const gchar *prompt_path,
                                    const GVariantType *return_type,
                                    GCancellable *cancellable,
                                    GAsyncReadyCallback callback,
                                    gpointer user_data);

Perform prompting for a SecretPrompt.

This function is called by other parts of this library to handle prompts for the various actions that can require prompting.

Override the SecretServiceClass prompt_async virtual method to change the behavior of the propmting. The default behavior is to simply run secret_prompt_perform() on the prompt.

[skip]

Stability Level: Unstable

secret_service_prompt_at_dbus_path_finish ()

GVariant *
secret_service_prompt_at_dbus_path_finish
                               (SecretService *self,
                                GAsyncResult *result,
                                GError **error);

Complete asynchronous operation to perform prompting for a SecretPrompt.

Returns a variant result if the prompt was completed and not dismissed. The type of result depends on the action the prompt is completing, and is defined in the Secret Service DBus API specification.

[skip]

Stability Level: Unstable

secret_service_prompt_at_dbus_path_sync ()

GVariant *
secret_service_prompt_at_dbus_path_sync
                               (SecretService *self,
                                const gchar *prompt_path,
                                GCancellable *cancellable,
                                const GVariantType *return_type,
                                GError **error);

Perform prompting for a SecretPrompt.

Override the SecretServiceClass prompt_async virtual method to change the behavior of the propmting. The default behavior is to simply run secret_prompt_perform() on the prompt.

Returns a variant result if the prompt was completed and not dismissed. The type of result depends on the action the prompt is completing, and is defined in the Secret Service DBus API specification.

This method may block and should not be used in user interface threads.

[skip]

Stability Level: Unstable

secret_service_create_collection_dbus_path ()

void
secret_service_create_collection_dbus_path
                               (SecretService *self,
                                GHashTable *properties,
                                const gchar *alias,
                                SecretCollectionCreateFlags flags,
                                GCancellable *cancellable,
                                GAsyncReadyCallback callback,
                                gpointer user_data);

Create a new collection in the secret service, and return its path.

Using this method requires that you setup a correct hash table of D-Bus properties for the new collection. You may prefer to use secret_collection_create() which does handles this for you.

An alias is a well-known tag for a collection, such as 'default' (ie: the default collection to store items in). This allows other applications to easily identify and share a collection. If a collection with the alias already exists, then instead of creating a new collection, the existing collection will be returned. If no collection with this alias exists, then a new collection will be created and this alias will be assigned to it.

properties is a set of properties for the new collection. The keys in the hash table should be interface.property strings like org.freedesktop.Secret.Collection.Label. The values in the hash table should be GVariant values of the properties.

If you wish to have a

This method will return immediately and complete asynchronously. The secret service may prompt the user. secret_service_prompt() will be used to handle any prompts that are required.

[skip]

Stability Level: Unstable

secret_service_create_collection_dbus_path_finish ()

gchar *
secret_service_create_collection_dbus_path_finish
                               (SecretService *self,
                                GAsyncResult *result,
                                GError **error);

Finish asynchronous operation to create a new collection in the secret service.

[skip]

Stability Level: Unstable

secret_service_create_collection_dbus_path_sync ()

gchar *
secret_service_create_collection_dbus_path_sync
                               (SecretService *self,
                                GHashTable *properties,
                                const gchar *alias,
                                SecretCollectionCreateFlags flags,
                                GCancellable *cancellable,
                                GError **error);

Create a new collection in the secret service and return its path.

Using this method requires that you setup a correct hash table of D-Bus properties for the new collection. You may prefer to use secret_collection_create() which does handles this for you.

An alias is a well-known tag for a collection, such as 'default' (ie: the default collection to store items in). This allows other applications to easily identify and share a collection. If a collection with the alias already exists, then instead of creating a new collection, the existing collection will be returned. If no collection with this alias exists, then a new collection will be created and this alias will be assigned to it.

properties is a set of properties for the new collection. The keys in the hash table should be interface.property strings like org.freedesktop.Secret.Collection.Label. The values in the hash table should be GVariant values of the properties.

This method may block indefinitely and should not be used in user interface threads. The secret service may prompt the user. secret_service_prompt() will be used to handle any prompts that are required.

[skip]

Stability Level: Unstable

secret_service_create_item_dbus_path ()

void
secret_service_create_item_dbus_path (SecretService *self,
                                      const gchar *collection_path,
                                      GHashTable *properties,
                                      SecretValue *value,
                                      SecretItemCreateFlags flags,
                                      GCancellable *cancellable,
                                      GAsyncReadyCallback callback,
                                      gpointer user_data);

Create a new item in a secret service collection and return its D-Bus object path.

It is often easier to use secret_password_store() or secret_item_create() rather than using this function. Using this method requires that you setup a correct hash table of D-Bus properties for the new collection.

If the flags contains SECRET_ITEM_CREATE_REPLACE, then the secret service will search for an item matching the attributes , and update that item instead of creating a new one.

properties is a set of properties for the new collection. The keys in the hash table should be interface.property strings like org.freedesktop.Secret.Item.Label. The values in the hash table should be GVariant values of the properties.

This method will return immediately and complete asynchronously. The secret service may prompt the user. secret_service_prompt() will be used to handle any prompts that are required.

[skip]

Stability Level: Unstable

secret_service_create_item_dbus_path_finish ()

gchar *
secret_service_create_item_dbus_path_finish
                               (SecretService *self,
                                GAsyncResult *result,
                                GError **error);

Finish asynchronous operation to create a new item in the secret service.

[skip]

Stability Level: Unstable

secret_service_create_item_dbus_path_sync ()

gchar *
secret_service_create_item_dbus_path_sync
                               (SecretService *self,
                                const gchar *collection_path,
                                GHashTable *properties,
                                SecretValue *value,
                                SecretItemCreateFlags flags,
                                GCancellable *cancellable,
                                GError **error);

Create a new item in a secret service collection and return its D-Bus object path.

It is often easier to use secret_password_store_sync() or secret_item_create_sync() rather than using this function. Using this method requires that you setup a correct hash table of D-Bus properties for the new collection.

If the flags contains SECRET_ITEM_CREATE_REPLACE, then the secret service will search for an item matching the attributes , and update that item instead of creating a new one.

properties is a set of properties for the new collection. The keys in the hash table should be interface.property strings like org.freedesktop.Secret.Item.Label. The values in the hash table should be GVariant values of the properties.

This method may block indefinitely and should not be used in user interface threads. The secret service may prompt the user. secret_service_prompt() will be used to handle any prompts that are required.

Stability Level: Unstable

secret_service_delete_item_dbus_path ()

void
secret_service_delete_item_dbus_path (SecretService *self,
                                      const gchar *item_path,
                                      GCancellable *cancellable,
                                      GAsyncReadyCallback callback,
                                      gpointer user_data);

Delete a secret item from the secret service.

The item is represented by its D-Bus object path. If you already have a SecretItem proxy objects, use use secret_item_delete() instead.

This method will return immediately and complete asynchronously.

[skip]

Stability Level: Unstable

secret_service_delete_item_dbus_path_finish ()

gboolean
secret_service_delete_item_dbus_path_finish
                               (SecretService *self,
                                GAsyncResult *result,
                                GError **error);

Complete an asynchronous operation to delete a secret item from the secret service.

[skip]

Stability Level: Unstable

secret_service_delete_item_dbus_path_sync ()

gboolean
secret_service_delete_item_dbus_path_sync
                               (SecretService *self,
                                const gchar *item_path,
                                GCancellable *cancellable,
                                GError **error);

Delete a secret item from the secret service.

The item is represented by its D-Bus object path. If you already have a SecretItem proxy objects, use use secret_item_delete_sync() instead.

This method may block indefinitely and should not be used in user interface threads.

[skip]

Stability Level: Unstable

secret_service_read_alias_dbus_path ()

void
secret_service_read_alias_dbus_path (SecretService *self,
                                     const gchar *alias,
                                     GCancellable *cancellable,
                                     GAsyncReadyCallback callback,
                                     gpointer user_data);

Lookup which collection is assigned to this alias. Aliases help determine well known collections, such as 'default'. This method looks up the dbus object path of the well known collection.

This method will return immediately and complete asynchronously.

[skip]

Stability Level: Unstable

secret_service_read_alias_dbus_path_finish ()

gchar *
secret_service_read_alias_dbus_path_finish
                               (SecretService *self,
                                GAsyncResult *result,
                                GError **error);

Finish an asynchronous operation to lookup which collection is assigned to an alias. This method returns the DBus object path of the collection

[skip]

Stability Level: Unstable

secret_service_read_alias_dbus_path_sync ()

gchar *
secret_service_read_alias_dbus_path_sync
                               (SecretService *self,
                                const gchar *alias,
                                GCancellable *cancellable,
                                GError **error);

Lookup which collection is assigned to this alias. Aliases help determine well known collections, such as 'default'. This method returns the dbus object path of the collection.

This method may block and should not be used in user interface threads.

[skip]

Stability Level: Unstable

secret_service_set_alias_to_dbus_path ()

void
secret_service_set_alias_to_dbus_path (SecretService *self,
                                       const gchar *alias,
                                       const gchar *collection_path,
                                       GCancellable *cancellable,
                                       GAsyncReadyCallback callback,
                                       gpointer user_data);

Assign a collection to this alias. Aliases help determine well known collections, such as 'default'. This method takes the dbus object path of the collection to assign to the alias.

This method will return immediately and complete asynchronously.

[skip]

Stability Level: Unstable

secret_service_set_alias_to_dbus_path_finish ()

gboolean
secret_service_set_alias_to_dbus_path_finish
                               (SecretService *self,
                                GAsyncResult *result,
                                GError **error);

Finish an asynchronous operation to assign a collection to an alias.

[skip]

Stability Level: Unstable

secret_service_set_alias_to_dbus_path_sync ()

gboolean
secret_service_set_alias_to_dbus_path_sync
                               (SecretService *self,
                                const gchar *alias,
                                const gchar *collection_path,
                                GCancellable *cancellable,
                                GError **error);

Assign a collection to this alias. Aliases help determine well known collections, such as 'default'. This method takes the dbus object path of the collection to assign to the alias.

This method may block and should not be used in user interface threads.

[skip]

Stability Level: Unstable

secret_service_encode_dbus_secret ()

GVariant *
secret_service_encode_dbus_secret (SecretService *service,
                                   SecretValue *value);

Encodes a SecretValue into GVariant for use with the Secret Service DBus API.

The resulting GVariant will have a (oayays) signature.

A session must have already been established by the SecretService.

secret_service_decode_dbus_secret ()

SecretValue *
secret_service_decode_dbus_secret (SecretService *service,
                                   GVariant *value);

Decode a SecretValue into GVariant received with the Secret Service DBus API.

The GVariant should have a (oayays) signature.

A session must have already been established by the SecretService, and the encoded secret must be valid for that session.