GI.Secret.Functions

Methods

errorGetQuark

errorGetQuark :: (HasCallStack, MonadIO m) => m Word32

No description available in the introspection data.

getSchema

getSchema

Arguments

:: (HasCallStack, MonadIO m)

=> SchemaType

type: type of schema to get

-> m Schema

Returns: schema type

Get a secret storage schema of the given type.

C code may access the schemas (such as SECRET_SCHEMA_NOTE) directly, but language bindings cannot, and must use this accessor.

Since: 0.18.6

passwordClear

passwordClear

Arguments

:: (HasCallStack, MonadIO m, IsCancellable a)

=> Schema

schema: the schema for the attributes

-> Map Text Text

attributes: the attribute keys and values

-> Maybe a

cancellable: optional cancellation object

-> Maybe AsyncReadyCallback

callback: called when the operation completes

-> m ()

Remove unlocked matching passwords from the secret service.

The attributes should be a set of key and value string pairs.

All unlocked items that match the attributes will be deleted.

This method will return immediately and complete asynchronously.

passwordClearFinish

passwordClearFinish

Arguments

:: (HasCallStack, MonadIO m, IsAsyncResult a)

=> a

result: the asynchronous result passed to the callback

-> m ()

(Can throw GError)

Finish an asynchronous operation to remove passwords from the secret service.

passwordClearSync

passwordClearSync

Arguments

:: (HasCallStack, MonadIO m, IsCancellable a)

=> Schema

schema: the schema for the attributes

-> Map Text Text

attributes: the attribute keys and values

-> Maybe a

cancellable: optional cancellation object

-> m ()

(Can throw GError)

Remove unlocked matching passwords from the secret service.

The attributes should be a set of key and value string pairs.

All unlocked items that match the attributes will be deleted.

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

passwordLookup

passwordLookup

Arguments

:: (HasCallStack, MonadIO m, IsCancellable a)

=> Schema

schema: the schema for attributes

-> Map Text Text

attributes: the attribute keys and values

-> Maybe a

cancellable: optional cancellation object

-> Maybe AsyncReadyCallback

callback: called when the operation completes

-> m ()

Lookup a password in the secret service.

The attributes should be a set of key and value string pairs.

If no secret is found then Nothing is returned.

This method will return immediately and complete asynchronously.

passwordLookupFinish

passwordLookupFinish

Arguments

:: (HasCallStack, MonadIO m, IsAsyncResult a)

=> a

result: the asynchronous result passed to the callback

-> m Text

Returns: a new password string which should be freed with secret_password_free() or may be freed with free when done (Can throw GError)

Finish an asynchronous operation to lookup a password in the secret service.

passwordLookupSync

passwordLookupSync

Arguments

:: (HasCallStack, MonadIO m, IsCancellable a)

=> Schema

schema: the schema for attributes

-> Map Text Text

attributes: the attribute keys and values

-> Maybe a

cancellable: optional cancellation object

-> m Text

Returns: a new password string which should be freed with secret_password_free() or may be freed with free when done (Can throw GError)

Lookup a password in the secret service.

The attributes should be a set of key and value string pairs.

If no secret is found then Nothing is returned.

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

passwordStore

passwordStore

Arguments

:: (HasCallStack, MonadIO m, IsCancellable a)

=> Schema

schema: the schema for attributes

-> Map Text Text

attributes: the attribute keys and values

-> Maybe Text

collection: a collection alias, or D-Bus object path of the collection where to store the secret

-> Text

label: label for the secret

-> Text

password: the null-terminated password to store

-> Maybe a

cancellable: optional cancellation object

-> Maybe AsyncReadyCallback

callback: called when the operation completes

-> m ()

Store a password in the secret service.

The attributes should be a set of key and value string pairs.

If the attributes match a secret item already stored in the collection, then the item will be updated with these new values.

If collection is Nothing, then the default collection will be used. Use COLLECTION_SESSION to store the password in the session collection, which doesn't get stored across login sessions.

This method will return immediately and complete asynchronously.

passwordStoreFinish

passwordStoreFinish

Arguments

:: (HasCallStack, MonadIO m, IsAsyncResult a)

=> a

result: the asynchronous result passed to the callback

-> m ()

(Can throw GError)

Finish asynchronous operation to store a password in the secret service.

passwordStoreSync

passwordStoreSync

Arguments

:: (HasCallStack, MonadIO m, IsCancellable a)

=> Schema

schema: the schema for attributes

-> Map Text Text

attributes: the attribute keys and values

-> Maybe Text

collection: a collection alias, or D-Bus object path of the collection where to store the secret

-> Text

label: label for the secret

-> Text

password: the null-terminated password to store

-> Maybe a

cancellable: optional cancellation object

-> m ()

(Can throw GError)

Store a password in the secret service.

The attributes should be a set of key and value string pairs.

If the attributes match a secret item already stored in the collection, then the item will be updated with these new values.

If collection is Nothing, then the default collection will be used. Use COLLECTION_SESSION to store the password in the session collection, which doesn't get stored across login sessions.

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

passwordWipe

passwordWipe

Arguments

:: (HasCallStack, MonadIO m)

=> Maybe Text

password: password to clear

-> m ()

Clear the memory used by a password.