Class
SecretCollection
Description [src]
class Secret.Collection : Gio.DBusProxy {
parent: GDBusProxy
}
A proxy object representing a collection of secrets in the Secret Service.
SecretCollection
represents a collection of secret items stored in the
Secret Service.
A collection can be in a locked or unlocked state. Use
secret_service_lock()
or secret_service_unlock()
to lock or
unlock the collection.
Use the SecretCollection:items
property or
secret_collection_get_items()
to lookup the items in the collection.
There may not be any items exposed when the collection is locked.
Stability: Stable
Constructors
secret_collection_new_for_dbus_path_finish
Finish asynchronous operation to get a new collection proxy for a collection in the secret service.
secret_collection_new_for_dbus_path_sync
Get a new collection proxy for a collection in the secret service.
Functions
secret_collection_for_alias
Lookup which collection is assigned to this alias. Aliases help determine well known collections, such as ‘default’.
secret_collection_for_alias_finish
Finish an asynchronous operation to lookup which collection is assigned to an alias.
secret_collection_for_alias_sync
Lookup which collection is assigned to this alias. Aliases help determine
well known collections, such as default
.
secret_collection_new_for_dbus_path
Get a new collection proxy for a collection in the secret service.
Instance methods
secret_collection_get_flags
Get the flags representing what features of the SecretCollection
proxy
have been initialized.
secret_collection_load_items
Ensure that the SecretCollection
proxy has loaded all the items present
in the Secret Service.
secret_collection_load_items_finish
Complete an asynchronous operation to ensure that the SecretCollection
proxy
has loaded all the items present in the Secret Service.
secret_collection_load_items_sync
Ensure that the SecretCollection
proxy has loaded all the items present
in the Secret Service. This affects the result of
secret_collection_get_items()
.
secret_collection_refresh
Refresh the properties on this collection. This fires off a request to refresh, and the properties will be updated later.
secret_collection_search
Search for items matching the attributes
in the collection
.
The attributes
should be a table of string keys and string values.
secret_collection_search_finish
Complete asynchronous operation to search for items in a collection.
secret_collection_search_for_dbus_paths
Search for items in collection
matching the attributes
, and return their
DBus object paths.
secret_collection_search_for_dbus_paths_finish
Complete asynchronous operation to search for items in a collection.
secret_collection_search_for_dbus_paths_sync
Search for items matching the attributes
in collection
, and return their
DBus object paths.
secret_collection_search_sync
Search for items matching the attributes
in the collection
.
The attributes
should be a table of string keys and string values.
secret_collection_set_label_finish
Complete asynchronous operation to set the label of this collection.
Methods inherited from GDBusProxy (19)
g_dbus_proxy_call
Asynchronously invokes the method_name
method on proxy
.
unstable since: 2.26
g_dbus_proxy_call_finish
Finishes an operation started with g_dbus_proxy_call().
unstable since: 2.26
g_dbus_proxy_call_sync
Synchronously invokes the method_name
method on proxy
.
unstable since: 2.26
g_dbus_proxy_call_with_unix_fd_list
Like g_dbus_proxy_call()
but also takes a GUnixFDList
object.
unstable since: 2.30
g_dbus_proxy_call_with_unix_fd_list_finish
Finishes an operation started with g_dbus_proxy_call_with_unix_fd_list().
unstable since: 2.30
g_dbus_proxy_call_with_unix_fd_list_sync
Like g_dbus_proxy_call_sync()
but also takes and returns GUnixFDList
objects.
unstable since: 2.30
g_dbus_proxy_get_cached_property
Looks up the value for a property from the cache. This call does no blocking IO.
unstable since: 2.26
g_dbus_proxy_get_cached_property_names
Gets the names of all cached properties on proxy
.
unstable since: 2.26
g_dbus_proxy_get_connection
Gets the connection proxy
is for.
unstable since: 2.26
g_dbus_proxy_get_default_timeout
Gets the timeout to use if -1 (specifying default timeout) is
passed as timeout_msec
in the g_dbus_proxy_call()
and
g_dbus_proxy_call_sync()
functions.
unstable since: 2.26
g_dbus_proxy_get_flags
Gets the flags that proxy
was constructed with.
unstable since: 2.26
g_dbus_proxy_get_interface_info
Returns the GDBusInterfaceInfo
, if any, specifying the interface
that proxy
conforms to. See the GDBusProxy:g-interface-info
property for more details.
unstable since: 2.26
g_dbus_proxy_get_interface_name
Gets the D-Bus interface name proxy
is for.
unstable since: 2.26
g_dbus_proxy_get_name
Gets the name that proxy
was constructed for.
unstable since: 2.26
g_dbus_proxy_get_name_owner
The unique name that owns the name that proxy
is for or NULL
if
no-one currently owns that name. You may connect to the
GObject::notify
signal to track changes to the
GDBusProxy:g-name-owner
property.
unstable since: 2.26
g_dbus_proxy_get_object_path
Gets the object path proxy
is for.
unstable since: 2.26
g_dbus_proxy_set_cached_property
If value
is not NULL
, sets the cached value for the property with
name property_name
to the value in value
.
unstable since: 2.26
g_dbus_proxy_set_default_timeout
Sets the timeout to use if -1 (specifying default timeout) is
passed as timeout_msec
in the g_dbus_proxy_call()
and
g_dbus_proxy_call_sync()
functions.
unstable since: 2.26
g_dbus_proxy_set_interface_info
Ensure that interactions with proxy
conform to the given
interface. See the GDBusProxy:g-interface-info
property for more details.
unstable since: 2.26
Methods inherited from GAsyncInitable (3)
g_async_initable_init_async
Starts asynchronous initialization of the object implementing the
interface. This must be done before any real use of the object after
initial construction. If the object also implements GInitable
you can
optionally call g_initable_init()
instead.
unstable since: 2.22
g_async_initable_init_finish
Finishes asynchronous initialization and returns the result. See g_async_initable_init_async().
unstable since: 2.22
g_async_initable_new_finish
Finishes the async construction for the various g_async_initable_new
calls, returning the created object or NULL
on error.
unstable since: 2.22
Methods inherited from GDBusInterface (4)
g_dbus_interface_dup_object
Gets the GDBusObject
that interface_
belongs to, if any.
unstable since: 2.32
g_dbus_interface_get_info
Gets D-Bus introspection information for the D-Bus interface
implemented by interface_
.
unstable since: 2.30
g_dbus_interface_get_object
Gets the GDBusObject
that interface_
belongs to, if any.
unstable since: 2.30
g_dbus_interface_set_object
Sets the GDBusObject
for interface_
to object
.
unstable since: 2.30
Methods inherited from GInitable (1)
Properties
Secret.Collection:created
The date and time (in seconds since the UNIX epoch) that this collection was created.
Secret.Collection:flags
A set of flags describing which parts of the secret collection have been initialized.
Secret.Collection:items
A list of SecretItem
objects representing the items that are in
this collection. This list will be empty if the collection is locked.
Secret.Collection:modified
The date and time (in seconds since the UNIX epoch) that this collection was last modified.
Secret.Collection:service
The SecretService
object that this collection is associated with and
uses to interact with the actual D-Bus Secret Service.
Properties inherited from GDBusProxy (9)
Gio.DBusProxy:g-bus-type
If this property is not G_BUS_TYPE_NONE
, then
GDBusProxy:g-connection
must be NULL
and will be set to the
GDBusConnection
obtained by calling g_bus_get()
with the value
of this property.
unstable since: 2.26
Gio.DBusProxy:g-connection
The GDBusConnection
the proxy is for.
unstable since: 2.26
Gio.DBusProxy:g-default-timeout
The timeout to use if -1 (specifying default timeout) is passed
as timeout_msec
in the g_dbus_proxy_call()
and
g_dbus_proxy_call_sync()
functions.
unstable since: 2.26
Gio.DBusProxy:g-flags
Flags from the GDBusProxyFlags
enumeration.
unstable since: 2.26
Gio.DBusProxy:g-interface-info
Ensure that interactions with this proxy conform to the given
interface. This is mainly to ensure that malformed data received
from the other peer is ignored. The given GDBusInterfaceInfo
is
said to be the “expected interface”.
unstable since: 2.26
Gio.DBusProxy:g-interface-name
The D-Bus interface name the proxy is for.
unstable since: 2.26
Gio.DBusProxy:g-name
The well-known or unique name that the proxy is for.
unstable since: 2.26
Gio.DBusProxy:g-name-owner
The unique name that owns GDBusProxy:g-name
or NULL
if no-one
currently owns that name. You may connect to GObject::notify
signal to
track changes to this property.
unstable since: 2.26
Gio.DBusProxy:g-object-path
The object path the proxy is for.
unstable since: 2.26
Signals
Signals inherited from GDBusProxy (2)
GDBusProxy::g-properties-changed
Emitted when one or more D-Bus properties on proxy
changes. The
local cache has already been updated when this signal fires. Note
that both changed_properties
and invalidated_properties
are
guaranteed to never be NULL
(either may be empty though).
unstable since: 2.26
GDBusProxy::g-signal
Emitted when a signal from the remote object and interface that proxy
is for, has been received.
unstable since: 2.26
Signals inherited from GObject (1)
GObject::notify
The notify signal is emitted on an object when one of its properties has its value set through g_object_set_property(), g_object_set(), et al.