EggDBusBus

EggDBusBus — Message bus daemon interface

Functions

#define EGG_DBUS_QUERY_INTERFACE_BUS()
gboolean egg_dbus_bus_hello_sync ()
gboolean egg_dbus_bus_request_name_sync ()
gboolean egg_dbus_bus_release_name_sync ()
gboolean egg_dbus_bus_start_service_by_name_sync ()
gboolean egg_dbus_bus_update_activation_environment_sync ()
gboolean egg_dbus_bus_name_has_owner_sync ()
gboolean egg_dbus_bus_list_names_sync ()
gboolean egg_dbus_bus_list_activatable_names_sync ()
gboolean egg_dbus_bus_add_match_sync ()
gboolean egg_dbus_bus_remove_match_sync ()
gboolean egg_dbus_bus_get_name_owner_sync ()
gboolean egg_dbus_bus_list_queued_owners_sync ()
gboolean egg_dbus_bus_get_connection_unix_user_sync ()
gboolean egg_dbus_bus_get_connection_unix_process_id_sync ()
gboolean egg_dbus_bus_get_adt_audit_session_data_sync ()
gboolean egg_dbus_bus_get_connection_se_linux_security_context_sync ()
gboolean egg_dbus_bus_reload_config_sync ()
gboolean egg_dbus_bus_get_id_sync ()
guint egg_dbus_bus_hello ()
gboolean egg_dbus_bus_hello_finish ()
guint egg_dbus_bus_request_name ()
gboolean egg_dbus_bus_request_name_finish ()
guint egg_dbus_bus_release_name ()
gboolean egg_dbus_bus_release_name_finish ()
guint egg_dbus_bus_start_service_by_name ()
gboolean egg_dbus_bus_start_service_by_name_finish ()
guint egg_dbus_bus_update_activation_environment ()
gboolean egg_dbus_bus_update_activation_environment_finish ()
guint egg_dbus_bus_name_has_owner ()
gboolean egg_dbus_bus_name_has_owner_finish ()
guint egg_dbus_bus_list_names ()
gboolean egg_dbus_bus_list_names_finish ()
guint egg_dbus_bus_list_activatable_names ()
gboolean egg_dbus_bus_list_activatable_names_finish ()
guint egg_dbus_bus_add_match ()
gboolean egg_dbus_bus_add_match_finish ()
guint egg_dbus_bus_remove_match ()
gboolean egg_dbus_bus_remove_match_finish ()
guint egg_dbus_bus_get_name_owner ()
gboolean egg_dbus_bus_get_name_owner_finish ()
guint egg_dbus_bus_list_queued_owners ()
gboolean egg_dbus_bus_list_queued_owners_finish ()
guint egg_dbus_bus_get_connection_unix_user ()
gboolean egg_dbus_bus_get_connection_unix_user_finish ()
guint egg_dbus_bus_get_connection_unix_process_id ()
gboolean egg_dbus_bus_get_connection_unix_process_id_finish ()
guint egg_dbus_bus_get_adt_audit_session_data ()
gboolean egg_dbus_bus_get_adt_audit_session_data_finish ()
guint egg_dbus_bus_get_connection_se_linux_security_context ()
gboolean egg_dbus_bus_get_connection_se_linux_security_context_finish ()
guint egg_dbus_bus_reload_config ()
gboolean egg_dbus_bus_reload_config_finish ()
guint egg_dbus_bus_get_id ()
gboolean egg_dbus_bus_get_id_finish ()
void egg_dbus_bus_handle_hello_finish ()
void egg_dbus_bus_handle_request_name_finish ()
void egg_dbus_bus_handle_release_name_finish ()
void egg_dbus_bus_handle_start_service_by_name_finish ()
void egg_dbus_bus_handle_update_activation_environment_finish ()
void egg_dbus_bus_handle_name_has_owner_finish ()
void egg_dbus_bus_handle_list_names_finish ()
void egg_dbus_bus_handle_list_activatable_names_finish ()
void egg_dbus_bus_handle_add_match_finish ()
void egg_dbus_bus_handle_remove_match_finish ()
void egg_dbus_bus_handle_get_name_owner_finish ()
void egg_dbus_bus_handle_list_queued_owners_finish ()
void egg_dbus_bus_handle_get_connection_unix_user_finish ()
void egg_dbus_bus_handle_get_connection_unix_process_id_finish ()
void egg_dbus_bus_handle_get_adt_audit_session_data_finish ()
void egg_dbus_bus_handle_get_connection_se_linux_security_context_finish ()
void egg_dbus_bus_handle_reload_config_finish ()
void egg_dbus_bus_handle_get_id_finish ()
void egg_dbus_bus_emit_signal_name_owner_changed ()
void egg_dbus_bus_emit_signal_name_lost ()
void egg_dbus_bus_emit_signal_name_acquired ()

Signals

Types and Values

Object Hierarchy

    GEnum
    ├── EggDBusReleaseNameReply
    ├── EggDBusRequestNameReply
    ╰── EggDBusStartServiceByNameReply
    GFlags
    ╰── EggDBusRequestNameFlags
    GInterface
    ╰── EggDBusBus

Prerequisites

EggDBusBus requires GObject.

Description

The EggDBusBus D-Bus interface is implemented by message bus daemons. Normally applications only use the egg_dbus_bus_request_name() method to claim a well-known name on the message bus.

Functions

EGG_DBUS_QUERY_INTERFACE_BUS()

#define EGG_DBUS_QUERY_INTERFACE_BUS(object_proxy) (EGG_DBUS_BUS (egg_dbus_object_proxy_query_interface (object_proxy, EGG_DBUS_TYPE_BUS)))

Convenience macro to get an interface proxy for the remote object represented by object_proxy . See egg_dbus_object_proxy_query_interface() for details.

Parameters

object_proxy

A EggDBusObjectProxy.

 

Returns

An instance derived from EggDBusInterfaceProxy that implements the EggDBusBus interface. This instance can be used to access the

org.freedesktop.DBus D-Bus interface on the remote

object represented by object_proxy . Do not ref or unref the returned instance, it is owned by object_proxy .


egg_dbus_bus_hello_sync ()

gboolean
egg_dbus_bus_hello_sync (EggDBusBus *instance,
                         EggDBusCallFlags call_flags,
                         gchar **out_assigned_name,
                         GCancellable *cancellable,
                         GError **error);

Before an application is able to send messages to other applications it must invoke this method on the message bus to obtain a unique name. If an application without a unique name tries to send a message to another application, or a message to the message bus itself that isn't the egg_dbus_bus_hello() method, it will be disconnected from the bus. There is no corresponding disconnect request; if a client wishes to disconnect from the bus, it simply closes the socket (or other communication channel).

This function synchronously invokes the Hello() method on the org.freedesktop.DBus interface on the object represented by instance . See egg_dbus_bus_hello() for the asynchronous version of this function.

Parameters

instance

A EggDBusBus.

 

call_flags

Flags from EggDBusCallFlags detailing how the method should be invoked.

 

out_assigned_name

Unique name assigned to the connection. Free with g_free().

 

cancellable

A GCancellable or NULL.

 

error

Return location for error.

 

Returns

TRUE if the method call succeeded, FALSE if error is set.


egg_dbus_bus_request_name_sync ()

gboolean
egg_dbus_bus_request_name_sync (EggDBusBus *instance,
                                EggDBusCallFlags call_flags,
                                const gchar *name,
                                EggDBusRequestNameFlags flags,
                                EggDBusRequestNameReply *out_value,
                                GCancellable *cancellable,
                                GError **error);

This method call should be invoked on the org.freedesktop.DBus name to request the message bus to assign the given name to the method caller. Each name maintains a queue of possible owners, where the head of the queue is the primary or current owner of the name. Each potential owner in the queue maintains the EGG_DBUS_REQUEST_NAME_FLAGS_ALLOW_REPLACEMENT and EGG_DBUS_REQUEST_NAME_FLAGS_DO_NOT_QUEUE settings from its latest egg_dbus_bus_request_name() call. See the D-Bus specification for more details.

This function synchronously invokes the RequestName() method on the org.freedesktop.DBus interface on the object represented by instance . See egg_dbus_bus_request_name() for the asynchronous version of this function.

Parameters

instance

A EggDBusBus.

 

call_flags

Flags from EggDBusCallFlags detailing how the method should be invoked.

 

name

Name to request.

 

flags

Flags.

 

out_value

Return value.

 

cancellable

A GCancellable or NULL.

 

error

Return location for error.

 

Returns

TRUE if the method call succeeded, FALSE if error is set.


egg_dbus_bus_release_name_sync ()

gboolean
egg_dbus_bus_release_name_sync (EggDBusBus *instance,
                                EggDBusCallFlags call_flags,
                                const gchar *name,
                                EggDBusReleaseNameReply *out_value,
                                GCancellable *cancellable,
                                GError **error);

This method call should be invoked on the org.freedesktop.DBus name to request the message bus to release the method caller's claim to the given name. If the caller is the primary owner, a new primary owner will be selected from the queue if any other owners are waiting. If the caller is waiting in the queue for the name, the caller will removed from the queue and will not be made an owner of the name if it later becomes available. If there are no other owners in the queue for the name, it will be removed from the bus entirely.

This function synchronously invokes the ReleaseName() method on the org.freedesktop.DBus interface on the object represented by instance . See egg_dbus_bus_release_name() for the asynchronous version of this function.

Parameters

instance

A EggDBusBus.

 

call_flags

Flags from EggDBusCallFlags detailing how the method should be invoked.

 

name

Name to release.

 

out_value

Return value.

 

cancellable

A GCancellable or NULL.

 

error

Return location for error.

 

Returns

TRUE if the method call succeeded, FALSE if error is set.


egg_dbus_bus_start_service_by_name_sync ()

gboolean
egg_dbus_bus_start_service_by_name_sync
                               (EggDBusBus *instance,
                                EggDBusCallFlags call_flags,
                                const gchar *name,
                                guint flags,
                                EggDBusStartServiceByNameReply *out_value,
                                GCancellable *cancellable,
                                GError **error);

Tries to launch the executable associated with name . See the D-Bus specification for more details on service activation.

This function synchronously invokes the StartServiceByName() method on the org.freedesktop.DBus interface on the object represented by instance . See egg_dbus_bus_start_service_by_name() for the asynchronous version of this function.

Parameters

instance

A EggDBusBus.

 

call_flags

Flags from EggDBusCallFlags detailing how the method should be invoked.

 

name

Name of the service to start.

 

flags

Flags (currently not used).

 

out_value

Reply

 

cancellable

A GCancellable or NULL.

 

error

Return location for error.

 

Returns

TRUE if the method call succeeded, FALSE if error is set.


egg_dbus_bus_update_activation_environment_sync ()

gboolean
egg_dbus_bus_update_activation_environment_sync
                               (EggDBusBus *instance,
                                EggDBusCallFlags call_flags,
                                EggDBusHashMap *env_hash,
                                GCancellable *cancellable,
                                GError **error);

Normally, session bus activated services inherit the environment of the bus daemon. This method adds to or modifies that environment when activating services. Some bus instances, such as the standard system bus, may disable access to this method for some or all callers.

This function synchronously invokes the UpdateActivationEnvironment() method on the org.freedesktop.DBus interface on the object represented by instance . See egg_dbus_bus_update_activation_environment() for the asynchronous version of this function.

Parameters

instance

A EggDBusBus.

 

call_flags

Flags from EggDBusCallFlags detailing how the method should be invoked.

 

env_hash

Environment to add or update.

 

cancellable

A GCancellable or NULL.

 

error

Return location for error.

 

Returns

TRUE if the method call succeeded, FALSE if error is set.


egg_dbus_bus_name_has_owner_sync ()

gboolean
egg_dbus_bus_name_has_owner_sync (EggDBusBus *instance,
                                  EggDBusCallFlags call_flags,
                                  const gchar *name,
                                  gboolean *out_has_owner,
                                  GCancellable *cancellable,
                                  GError **error);

Checks if the specified name exists (currently has an owner).

This function synchronously invokes the NameHasOwner() method on the org.freedesktop.DBus interface on the object represented by instance . See egg_dbus_bus_name_has_owner() for the asynchronous version of this function.

Parameters

instance

A EggDBusBus.

 

call_flags

Flags from EggDBusCallFlags detailing how the method should be invoked.

 

name

Name to check.

 

out_has_owner

TRUE only if name exists.

 

cancellable

A GCancellable or NULL.

 

error

Return location for error.

 

Returns

TRUE if the method call succeeded, FALSE if error is set.


egg_dbus_bus_list_names_sync ()

gboolean
egg_dbus_bus_list_names_sync (EggDBusBus *instance,
                              EggDBusCallFlags call_flags,
                              gchar ***out_names,
                              GCancellable *cancellable,
                              GError **error);

Returns a list of all currently-owned names on the bus.

This function synchronously invokes the ListNames() method on the org.freedesktop.DBus interface on the object represented by instance . See egg_dbus_bus_list_names() for the asynchronous version of this function.

Parameters

instance

A EggDBusBus.

 

call_flags

Flags from EggDBusCallFlags detailing how the method should be invoked.

 

out_names

Array of strings where each string is a bus name. Free with g_strfreev().

 

cancellable

A GCancellable or NULL.

 

error

Return location for error.

 

Returns

TRUE if the method call succeeded, FALSE if error is set.


egg_dbus_bus_list_activatable_names_sync ()

gboolean
egg_dbus_bus_list_activatable_names_sync
                               (EggDBusBus *instance,
                                EggDBusCallFlags call_flags,
                                gchar ***out_activatable_names,
                                GCancellable *cancellable,
                                GError **error);

Returns a list of all names that can be activated on the bus.

This function synchronously invokes the ListActivatableNames() method on the org.freedesktop.DBus interface on the object represented by instance . See egg_dbus_bus_list_activatable_names() for the asynchronous version of this function.

Parameters

instance

A EggDBusBus.

 

call_flags

Flags from EggDBusCallFlags detailing how the method should be invoked.

 

out_activatable_names

Array of strings where each string is a bus name. Free with g_strfreev().

 

cancellable

A GCancellable or NULL.

 

error

Return location for error.

 

Returns

TRUE if the method call succeeded, FALSE if error is set.


egg_dbus_bus_add_match_sync ()

gboolean
egg_dbus_bus_add_match_sync (EggDBusBus *instance,
                             EggDBusCallFlags call_flags,
                             const gchar *rule,
                             GCancellable *cancellable,
                             GError **error);

Adds a match rule to match messages going through the message bus. If the bus does not have enough resources the org.freedesktop.DBus.Error.OOM error is returned. See the D-Bus specification for more information about match rules.

This function synchronously invokes the AddMatch() method on the org.freedesktop.DBus interface on the object represented by instance . See egg_dbus_bus_add_match() for the asynchronous version of this function.

Parameters

instance

A EggDBusBus.

 

call_flags

Flags from EggDBusCallFlags detailing how the method should be invoked.

 

rule

Match rule to add to the connection.

 

cancellable

A GCancellable or NULL.

 

error

Return location for error.

 

Returns

TRUE if the method call succeeded, FALSE if error is set.


egg_dbus_bus_remove_match_sync ()

gboolean
egg_dbus_bus_remove_match_sync (EggDBusBus *instance,
                                EggDBusCallFlags call_flags,
                                const gchar *rule,
                                GCancellable *cancellable,
                                GError **error);

Removes the first rule that matches. If the rule is not found the org.freedesktop.DBus.Error.MatchRuleNotFound error is returned. See the D-Bus specification for more information about match rules.

This function synchronously invokes the RemoveMatch() method on the org.freedesktop.DBus interface on the object represented by instance . See egg_dbus_bus_remove_match() for the asynchronous version of this function.

Parameters

instance

A EggDBusBus.

 

call_flags

Flags from EggDBusCallFlags detailing how the method should be invoked.

 

rule

Match rule to remove from the connection.

 

cancellable

A GCancellable or NULL.

 

error

Return location for error.

 

Returns

TRUE if the method call succeeded, FALSE if error is set.


egg_dbus_bus_get_name_owner_sync ()

gboolean
egg_dbus_bus_get_name_owner_sync (EggDBusBus *instance,
                                  EggDBusCallFlags call_flags,
                                  const gchar *name,
                                  gchar **out_unique_name,
                                  GCancellable *cancellable,
                                  GError **error);

Returns the unique connection name of the primary owner of the name given. If the requested name doesn't have an owner, returns a org.freedesktop.DBus.Error.NameHasNoOwner error.

This function synchronously invokes the GetNameOwner() method on the org.freedesktop.DBus interface on the object represented by instance . See egg_dbus_bus_get_name_owner() for the asynchronous version of this function.

Parameters

instance

A EggDBusBus.

 

call_flags

Flags from EggDBusCallFlags detailing how the method should be invoked.

 

name

Name to get owner of.

 

out_unique_name

The unique name that owns name . Free with g_free().

 

cancellable

A GCancellable or NULL.

 

error

Return location for error.

 

Returns

TRUE if the method call succeeded, FALSE if error is set.


egg_dbus_bus_list_queued_owners_sync ()

gboolean
egg_dbus_bus_list_queued_owners_sync (EggDBusBus *instance,
                                      EggDBusCallFlags call_flags,
                                      const gchar *name,
                                      gchar ***out_queued_owners,
                                      GCancellable *cancellable,
                                      GError **error);

Lists the names waiting in queue to own name .

This function synchronously invokes the ListQueuedOwners() method on the org.freedesktop.DBus interface on the object represented by instance . See egg_dbus_bus_list_queued_owners() for the asynchronous version of this function.

Parameters

instance

A EggDBusBus.

 

call_flags

Flags from EggDBusCallFlags detailing how the method should be invoked.

 

name

A well-known name.

 

out_queued_owners

Array of unique names in queue to own name . Free with g_strfreev().

 

cancellable

A GCancellable or NULL.

 

error

Return location for error.

 

Returns

TRUE if the method call succeeded, FALSE if error is set.


egg_dbus_bus_get_connection_unix_user_sync ()

gboolean
egg_dbus_bus_get_connection_unix_user_sync
                               (EggDBusBus *instance,
                                EggDBusCallFlags call_flags,
                                const gchar *name,
                                uid_t *out_uid,
                                GCancellable *cancellable,
                                GError **error);

Returns the UNIX user id of the process connected to the server. If unable to determine it, a org.freedesktop.DBus.Error.Failed error is returned.

This function synchronously invokes the GetConnectionUnixUser() method on the org.freedesktop.DBus interface on the object represented by instance . See egg_dbus_bus_get_connection_unix_user() for the asynchronous version of this function.

Parameters

instance

A EggDBusBus.

 

call_flags

Flags from EggDBusCallFlags detailing how the method should be invoked.

 

name

Name of the connection to query.

 

out_uid

UNIX user id.

 

cancellable

A GCancellable or NULL.

 

error

Return location for error.

 

Returns

TRUE if the method call succeeded, FALSE if error is set.


egg_dbus_bus_get_connection_unix_process_id_sync ()

gboolean
egg_dbus_bus_get_connection_unix_process_id_sync
                               (EggDBusBus *instance,
                                EggDBusCallFlags call_flags,
                                const gchar *name,
                                pid_t *out_pid,
                                GCancellable *cancellable,
                                GError **error);

Returns the UNIX process id of the process connected to the server. If unable to determine it, a org.freedesktop.DBus.Error.Failed error is returned.

This function synchronously invokes the GetConnectionUnixProcessID() method on the org.freedesktop.DBus interface on the object represented by instance . See egg_dbus_bus_get_connection_unix_process_id() for the asynchronous version of this function.

Parameters

instance

A EggDBusBus.

 

call_flags

Flags from EggDBusCallFlags detailing how the method should be invoked.

 

name

Name of the connection to query.

 

out_pid

UNIX process id.

 

cancellable

A GCancellable or NULL.

 

error

Return location for error.

 

Returns

TRUE if the method call succeeded, FALSE if error is set.


egg_dbus_bus_get_adt_audit_session_data_sync ()

gboolean
egg_dbus_bus_get_adt_audit_session_data_sync
                               (EggDBusBus *instance,
                                EggDBusCallFlags call_flags,
                                const gchar *name,
                                EggDBusArraySeq **out_data,
                                GCancellable *cancellable,
                                GError **error);

Returns the Solaris/ADT auditing data of the process connected to the server. If unable to determine it, a org.freedesktop.DBus.Error.AdtAuditDataUnknown error is returned.

This function synchronously invokes the GetAdtAuditSessionData() method on the org.freedesktop.DBus interface on the object represented by instance . See egg_dbus_bus_get_adt_audit_session_data() for the asynchronous version of this function.

Parameters

instance

A EggDBusBus.

 

call_flags

Flags from EggDBusCallFlags detailing how the method should be invoked.

 

name

Name of the connection to query.

 

out_data

An array of bytes (typically a string of undefined encoding). Free with g_object_unref().

 

cancellable

A GCancellable or NULL.

 

error

Return location for error.

 

Returns

TRUE if the method call succeeded, FALSE if error is set.


egg_dbus_bus_get_connection_se_linux_security_context_sync ()

gboolean
egg_dbus_bus_get_connection_se_linux_security_context_sync
                               (EggDBusBus *instance,
                                EggDBusCallFlags call_flags,
                                const gchar *name,
                                EggDBusArraySeq **out_security_context,
                                GCancellable *cancellable,
                                GError **error);

Returns the SELinux security context of the process connected to the server. If unable to determine it, a org.freedesktop.DBus.Error.SELinuxSecurityContextUnknown error is returned.

This function synchronously invokes the GetConnectionSELinuxSecurityContext() method on the org.freedesktop.DBus interface on the object represented by instance . See egg_dbus_bus_get_connection_se_linux_security_context() for the asynchronous version of this function.

Parameters

instance

A EggDBusBus.

 

call_flags

Flags from EggDBusCallFlags detailing how the method should be invoked.

 

name

Name of the connection to query.

 

out_security_context

An array of bytes (typically a string of undefined encoding). Free with g_object_unref().

 

cancellable

A GCancellable or NULL.

 

error

Return location for error.

 

Returns

TRUE if the method call succeeded, FALSE if error is set.


egg_dbus_bus_reload_config_sync ()

gboolean
egg_dbus_bus_reload_config_sync (EggDBusBus *instance,
                                 EggDBusCallFlags call_flags,
                                 GCancellable *cancellable,
                                 GError **error);

Asks the message bus to reload configuration files.

This function synchronously invokes the ReloadConfig() method on the org.freedesktop.DBus interface on the object represented by instance . See egg_dbus_bus_reload_config() for the asynchronous version of this function.

Parameters

instance

A EggDBusBus.

 

call_flags

Flags from EggDBusCallFlags detailing how the method should be invoked.

 

cancellable

A GCancellable or NULL.

 

error

Return location for error.

 

Returns

TRUE if the method call succeeded, FALSE if error is set.


egg_dbus_bus_get_id_sync ()

gboolean
egg_dbus_bus_get_id_sync (EggDBusBus *instance,
                          EggDBusCallFlags call_flags,
                          gchar **out_unique_id,
                          GCancellable *cancellable,
                          GError **error);

Gets the unique ID of the bus. The unique ID here is shared among all addresses the bus daemon is listening on (TCP, UNIX domain socket, etc.). Each address the bus is listening on also has its own unique ID. The per-bus and per-address IDs are not related. For a desktop session bus, the bus ID can be used as a way to uniquely identify a user's session. See the D-Bus specification for more information about unique IDs.

This function synchronously invokes the GetId() method on the org.freedesktop.DBus interface on the object represented by instance . See egg_dbus_bus_get_id() for the asynchronous version of this function.

Parameters

instance

A EggDBusBus.

 

call_flags

Flags from EggDBusCallFlags detailing how the method should be invoked.

 

out_unique_id

Unique ID identifying the bus daemon. Free with g_free().

 

cancellable

A GCancellable or NULL.

 

error

Return location for error.

 

Returns

TRUE if the method call succeeded, FALSE if error is set.


egg_dbus_bus_hello ()

guint
egg_dbus_bus_hello (EggDBusBus *instance,
                    EggDBusCallFlags call_flags,
                    GCancellable *cancellable,
                    GAsyncReadyCallback callback,
                    gpointer user_data);

Before an application is able to send messages to other applications it must invoke this method on the message bus to obtain a unique name. If an application without a unique name tries to send a message to another application, or a message to the message bus itself that isn't the egg_dbus_bus_hello() method, it will be disconnected from the bus. There is no corresponding disconnect request; if a client wishes to disconnect from the bus, it simply closes the socket (or other communication channel).

This function asynchronously invokes the Hello() method on the org.freedesktop.DBus interface on the object represented by instance . When the reply is ready, callback will be called (on the main thread). You can then call egg_dbus_bus_hello_finish() to get the result. See egg_dbus_bus_hello_sync() for the synchronous version of this function.

Parameters

instance

A EggDBusBus.

 

call_flags

Flags from EggDBusCallFlags detailing how the method should be invoked.

 

cancellable

A GCancellable or NULL.

 

callback

Callback to invoke when the reply is ready.

 

user_data

User data to pass to callback .

 

Returns

A pending call id (never zero) that can be used with egg_dbus_connection_pending_call_cancel() or egg_dbus_connection_pending_call_block().


egg_dbus_bus_hello_finish ()

gboolean
egg_dbus_bus_hello_finish (EggDBusBus *instance,
                           gchar **out_assigned_name,
                           GAsyncResult *res,
                           GError **error);

Finishes an asynchronous method invocation started with egg_dbus_bus_hello().

Parameters

instance

A EggDBusBus.

 

out_assigned_name

Unique name assigned to the connection. Free with g_free().

 

res

A GAsyncResult obtained from the GAsyncReadyCallback function passed to egg_dbus_bus_hello().

 

error

Return location for error.

 

Returns

TRUE if the method call succeeded, FALSE if error is set.


egg_dbus_bus_request_name ()

guint
egg_dbus_bus_request_name (EggDBusBus *instance,
                           EggDBusCallFlags call_flags,
                           const gchar *name,
                           EggDBusRequestNameFlags flags,
                           GCancellable *cancellable,
                           GAsyncReadyCallback callback,
                           gpointer user_data);

This method call should be invoked on the org.freedesktop.DBus name to request the message bus to assign the given name to the method caller. Each name maintains a queue of possible owners, where the head of the queue is the primary or current owner of the name. Each potential owner in the queue maintains the EGG_DBUS_REQUEST_NAME_FLAGS_ALLOW_REPLACEMENT and EGG_DBUS_REQUEST_NAME_FLAGS_DO_NOT_QUEUE settings from its latest egg_dbus_bus_request_name() call. See the D-Bus specification for more details.

This function asynchronously invokes the RequestName() method on the org.freedesktop.DBus interface on the object represented by instance . When the reply is ready, callback will be called (on the main thread). You can then call egg_dbus_bus_request_name_finish() to get the result. See egg_dbus_bus_request_name_sync() for the synchronous version of this function.

Parameters

instance

A EggDBusBus.

 

call_flags

Flags from EggDBusCallFlags detailing how the method should be invoked.

 

name

Name to request.

 

flags

Flags.

 

cancellable

A GCancellable or NULL.

 

callback

Callback to invoke when the reply is ready.

 

user_data

User data to pass to callback .

 

Returns

A pending call id (never zero) that can be used with egg_dbus_connection_pending_call_cancel() or egg_dbus_connection_pending_call_block().


egg_dbus_bus_request_name_finish ()

gboolean
egg_dbus_bus_request_name_finish (EggDBusBus *instance,
                                  EggDBusRequestNameReply *out_value,
                                  GAsyncResult *res,
                                  GError **error);

Finishes an asynchronous method invocation started with egg_dbus_bus_request_name().

Parameters

instance

A EggDBusBus.

 

out_value

Return value.

 

res

A GAsyncResult obtained from the GAsyncReadyCallback function passed to egg_dbus_bus_request_name().

 

error

Return location for error.

 

Returns

TRUE if the method call succeeded, FALSE if error is set.


egg_dbus_bus_release_name ()

guint
egg_dbus_bus_release_name (EggDBusBus *instance,
                           EggDBusCallFlags call_flags,
                           const gchar *name,
                           GCancellable *cancellable,
                           GAsyncReadyCallback callback,
                           gpointer user_data);

This method call should be invoked on the org.freedesktop.DBus name to request the message bus to release the method caller's claim to the given name. If the caller is the primary owner, a new primary owner will be selected from the queue if any other owners are waiting. If the caller is waiting in the queue for the name, the caller will removed from the queue and will not be made an owner of the name if it later becomes available. If there are no other owners in the queue for the name, it will be removed from the bus entirely.

This function asynchronously invokes the ReleaseName() method on the org.freedesktop.DBus interface on the object represented by instance . When the reply is ready, callback will be called (on the main thread). You can then call egg_dbus_bus_release_name_finish() to get the result. See egg_dbus_bus_release_name_sync() for the synchronous version of this function.

Parameters

instance

A EggDBusBus.

 

call_flags

Flags from EggDBusCallFlags detailing how the method should be invoked.

 

name

Name to release.

 

cancellable

A GCancellable or NULL.

 

callback

Callback to invoke when the reply is ready.

 

user_data

User data to pass to callback .

 

Returns

A pending call id (never zero) that can be used with egg_dbus_connection_pending_call_cancel() or egg_dbus_connection_pending_call_block().


egg_dbus_bus_release_name_finish ()

gboolean
egg_dbus_bus_release_name_finish (EggDBusBus *instance,
                                  EggDBusReleaseNameReply *out_value,
                                  GAsyncResult *res,
                                  GError **error);

Finishes an asynchronous method invocation started with egg_dbus_bus_release_name().

Parameters

instance

A EggDBusBus.

 

out_value

Return value.

 

res

A GAsyncResult obtained from the GAsyncReadyCallback function passed to egg_dbus_bus_release_name().

 

error

Return location for error.

 

Returns

TRUE if the method call succeeded, FALSE if error is set.


egg_dbus_bus_start_service_by_name ()

guint
egg_dbus_bus_start_service_by_name (EggDBusBus *instance,
                                    EggDBusCallFlags call_flags,
                                    const gchar *name,
                                    guint flags,
                                    GCancellable *cancellable,
                                    GAsyncReadyCallback callback,
                                    gpointer user_data);

Tries to launch the executable associated with name . See the D-Bus specification for more details on service activation.

This function asynchronously invokes the StartServiceByName() method on the org.freedesktop.DBus interface on the object represented by instance . When the reply is ready, callback will be called (on the main thread). You can then call egg_dbus_bus_start_service_by_name_finish() to get the result. See egg_dbus_bus_start_service_by_name_sync() for the synchronous version of this function.

Parameters

instance

A EggDBusBus.

 

call_flags

Flags from EggDBusCallFlags detailing how the method should be invoked.

 

name

Name of the service to start.

 

flags

Flags (currently not used).

 

cancellable

A GCancellable or NULL.

 

callback

Callback to invoke when the reply is ready.

 

user_data

User data to pass to callback .

 

Returns

A pending call id (never zero) that can be used with egg_dbus_connection_pending_call_cancel() or egg_dbus_connection_pending_call_block().


egg_dbus_bus_start_service_by_name_finish ()

gboolean
egg_dbus_bus_start_service_by_name_finish
                               (EggDBusBus *instance,
                                EggDBusStartServiceByNameReply *out_value,
                                GAsyncResult *res,
                                GError **error);

Finishes an asynchronous method invocation started with egg_dbus_bus_start_service_by_name().

Parameters

instance

A EggDBusBus.

 

out_value

Reply

 

res

A GAsyncResult obtained from the GAsyncReadyCallback function passed to egg_dbus_bus_start_service_by_name().

 

error

Return location for error.

 

Returns

TRUE if the method call succeeded, FALSE if error is set.


egg_dbus_bus_update_activation_environment ()

guint
egg_dbus_bus_update_activation_environment
                               (EggDBusBus *instance,
                                EggDBusCallFlags call_flags,
                                EggDBusHashMap *env_hash,
                                GCancellable *cancellable,
                                GAsyncReadyCallback callback,
                                gpointer user_data);

Normally, session bus activated services inherit the environment of the bus daemon. This method adds to or modifies that environment when activating services. Some bus instances, such as the standard system bus, may disable access to this method for some or all callers.

This function asynchronously invokes the UpdateActivationEnvironment() method on the org.freedesktop.DBus interface on the object represented by instance . When the reply is ready, callback will be called (on the main thread). You can then call egg_dbus_bus_update_activation_environment_finish() to get the result. See egg_dbus_bus_update_activation_environment_sync() for the synchronous version of this function.

Parameters

instance

A EggDBusBus.

 

call_flags

Flags from EggDBusCallFlags detailing how the method should be invoked.

 

env_hash

Environment to add or update.

 

cancellable

A GCancellable or NULL.

 

callback

Callback to invoke when the reply is ready.

 

user_data

User data to pass to callback .

 

Returns

A pending call id (never zero) that can be used with egg_dbus_connection_pending_call_cancel() or egg_dbus_connection_pending_call_block().


egg_dbus_bus_update_activation_environment_finish ()

gboolean
egg_dbus_bus_update_activation_environment_finish
                               (EggDBusBus *instance,
                                GAsyncResult *res,
                                GError **error);

Finishes an asynchronous method invocation started with egg_dbus_bus_update_activation_environment().

Parameters

instance

A EggDBusBus.

 

res

A GAsyncResult obtained from the GAsyncReadyCallback function passed to egg_dbus_bus_update_activation_environment().

 

error

Return location for error.

 

Returns

TRUE if the method call succeeded, FALSE if error is set.


egg_dbus_bus_name_has_owner ()

guint
egg_dbus_bus_name_has_owner (EggDBusBus *instance,
                             EggDBusCallFlags call_flags,
                             const gchar *name,
                             GCancellable *cancellable,
                             GAsyncReadyCallback callback,
                             gpointer user_data);

Checks if the specified name exists (currently has an owner).

This function asynchronously invokes the NameHasOwner() method on the org.freedesktop.DBus interface on the object represented by instance . When the reply is ready, callback will be called (on the main thread). You can then call egg_dbus_bus_name_has_owner_finish() to get the result. See egg_dbus_bus_name_has_owner_sync() for the synchronous version of this function.

Parameters

instance

A EggDBusBus.

 

call_flags

Flags from EggDBusCallFlags detailing how the method should be invoked.

 

name

Name to check.

 

cancellable

A GCancellable or NULL.

 

callback

Callback to invoke when the reply is ready.

 

user_data

User data to pass to callback .

 

Returns

A pending call id (never zero) that can be used with egg_dbus_connection_pending_call_cancel() or egg_dbus_connection_pending_call_block().


egg_dbus_bus_name_has_owner_finish ()

gboolean
egg_dbus_bus_name_has_owner_finish (EggDBusBus *instance,
                                    gboolean *out_has_owner,
                                    GAsyncResult *res,
                                    GError **error);

Finishes an asynchronous method invocation started with egg_dbus_bus_name_has_owner().

Parameters

instance

A EggDBusBus.

 

out_has_owner

TRUE only if name exists.

 

res

A GAsyncResult obtained from the GAsyncReadyCallback function passed to egg_dbus_bus_name_has_owner().

 

error

Return location for error.

 

Returns

TRUE if the method call succeeded, FALSE if error is set.


egg_dbus_bus_list_names ()

guint
egg_dbus_bus_list_names (EggDBusBus *instance,
                         EggDBusCallFlags call_flags,
                         GCancellable *cancellable,
                         GAsyncReadyCallback callback,
                         gpointer user_data);

Returns a list of all currently-owned names on the bus.

This function asynchronously invokes the ListNames() method on the org.freedesktop.DBus interface on the object represented by instance . When the reply is ready, callback will be called (on the main thread). You can then call egg_dbus_bus_list_names_finish() to get the result. See egg_dbus_bus_list_names_sync() for the synchronous version of this function.

Parameters

instance

A EggDBusBus.

 

call_flags

Flags from EggDBusCallFlags detailing how the method should be invoked.

 

cancellable

A GCancellable or NULL.

 

callback

Callback to invoke when the reply is ready.

 

user_data

User data to pass to callback .

 

Returns

A pending call id (never zero) that can be used with egg_dbus_connection_pending_call_cancel() or egg_dbus_connection_pending_call_block().


egg_dbus_bus_list_names_finish ()

gboolean
egg_dbus_bus_list_names_finish (EggDBusBus *instance,
                                gchar ***out_names,
                                GAsyncResult *res,
                                GError **error);

Finishes an asynchronous method invocation started with egg_dbus_bus_list_names().

Parameters

instance

A EggDBusBus.

 

out_names

Array of strings where each string is a bus name. Free with g_strfreev().

 

res

A GAsyncResult obtained from the GAsyncReadyCallback function passed to egg_dbus_bus_list_names().

 

error

Return location for error.

 

Returns

TRUE if the method call succeeded, FALSE if error is set.


egg_dbus_bus_list_activatable_names ()

guint
egg_dbus_bus_list_activatable_names (EggDBusBus *instance,
                                     EggDBusCallFlags call_flags,
                                     GCancellable *cancellable,
                                     GAsyncReadyCallback callback,
                                     gpointer user_data);

Returns a list of all names that can be activated on the bus.

This function asynchronously invokes the ListActivatableNames() method on the org.freedesktop.DBus interface on the object represented by instance . When the reply is ready, callback will be called (on the main thread). You can then call egg_dbus_bus_list_activatable_names_finish() to get the result. See egg_dbus_bus_list_activatable_names_sync() for the synchronous version of this function.

Parameters

instance

A EggDBusBus.

 

call_flags

Flags from EggDBusCallFlags detailing how the method should be invoked.

 

cancellable

A GCancellable or NULL.

 

callback

Callback to invoke when the reply is ready.

 

user_data

User data to pass to callback .

 

Returns

A pending call id (never zero) that can be used with egg_dbus_connection_pending_call_cancel() or egg_dbus_connection_pending_call_block().


egg_dbus_bus_list_activatable_names_finish ()

gboolean
egg_dbus_bus_list_activatable_names_finish
                               (EggDBusBus *instance,
                                gchar ***out_activatable_names,
                                GAsyncResult *res,
                                GError **error);

Finishes an asynchronous method invocation started with egg_dbus_bus_list_activatable_names().

Parameters

instance

A EggDBusBus.

 

out_activatable_names

Array of strings where each string is a bus name. Free with g_strfreev().

 

res

A GAsyncResult obtained from the GAsyncReadyCallback function passed to egg_dbus_bus_list_activatable_names().

 

error

Return location for error.

 

Returns

TRUE if the method call succeeded, FALSE if error is set.


egg_dbus_bus_add_match ()

guint
egg_dbus_bus_add_match (EggDBusBus *instance,
                        EggDBusCallFlags call_flags,
                        const gchar *rule,
                        GCancellable *cancellable,
                        GAsyncReadyCallback callback,
                        gpointer user_data);

Adds a match rule to match messages going through the message bus. If the bus does not have enough resources the org.freedesktop.DBus.Error.OOM error is returned. See the D-Bus specification for more information about match rules.

This function asynchronously invokes the AddMatch() method on the org.freedesktop.DBus interface on the object represented by instance . When the reply is ready, callback will be called (on the main thread). You can then call egg_dbus_bus_add_match_finish() to get the result. See egg_dbus_bus_add_match_sync() for the synchronous version of this function.

Parameters

instance

A EggDBusBus.

 

call_flags

Flags from EggDBusCallFlags detailing how the method should be invoked.

 

rule

Match rule to add to the connection.

 

cancellable

A GCancellable or NULL.

 

callback

Callback to invoke when the reply is ready.

 

user_data

User data to pass to callback .

 

Returns

A pending call id (never zero) that can be used with egg_dbus_connection_pending_call_cancel() or egg_dbus_connection_pending_call_block().


egg_dbus_bus_add_match_finish ()

gboolean
egg_dbus_bus_add_match_finish (EggDBusBus *instance,
                               GAsyncResult *res,
                               GError **error);

Finishes an asynchronous method invocation started with egg_dbus_bus_add_match().

Parameters

instance

A EggDBusBus.

 

res

A GAsyncResult obtained from the GAsyncReadyCallback function passed to egg_dbus_bus_add_match().

 

error

Return location for error.

 

Returns

TRUE if the method call succeeded, FALSE if error is set.


egg_dbus_bus_remove_match ()

guint
egg_dbus_bus_remove_match (EggDBusBus *instance,
                           EggDBusCallFlags call_flags,
                           const gchar *rule,
                           GCancellable *cancellable,
                           GAsyncReadyCallback callback,
                           gpointer user_data);

Removes the first rule that matches. If the rule is not found the org.freedesktop.DBus.Error.MatchRuleNotFound error is returned. See the D-Bus specification for more information about match rules.

This function asynchronously invokes the RemoveMatch() method on the org.freedesktop.DBus interface on the object represented by instance . When the reply is ready, callback will be called (on the main thread). You can then call egg_dbus_bus_remove_match_finish() to get the result. See egg_dbus_bus_remove_match_sync() for the synchronous version of this function.

Parameters

instance

A EggDBusBus.

 

call_flags

Flags from EggDBusCallFlags detailing how the method should be invoked.

 

rule

Match rule to remove from the connection.

 

cancellable

A GCancellable or NULL.

 

callback

Callback to invoke when the reply is ready.

 

user_data

User data to pass to callback .

 

Returns

A pending call id (never zero) that can be used with egg_dbus_connection_pending_call_cancel() or egg_dbus_connection_pending_call_block().


egg_dbus_bus_remove_match_finish ()

gboolean
egg_dbus_bus_remove_match_finish (EggDBusBus *instance,
                                  GAsyncResult *res,
                                  GError **error);

Finishes an asynchronous method invocation started with egg_dbus_bus_remove_match().

Parameters

instance

A EggDBusBus.

 

res

A GAsyncResult obtained from the GAsyncReadyCallback function passed to egg_dbus_bus_remove_match().

 

error

Return location for error.

 

Returns

TRUE if the method call succeeded, FALSE if error is set.


egg_dbus_bus_get_name_owner ()

guint
egg_dbus_bus_get_name_owner (EggDBusBus *instance,
                             EggDBusCallFlags call_flags,
                             const gchar *name,
                             GCancellable *cancellable,
                             GAsyncReadyCallback callback,
                             gpointer user_data);

Returns the unique connection name of the primary owner of the name given. If the requested name doesn't have an owner, returns a org.freedesktop.DBus.Error.NameHasNoOwner error.

This function asynchronously invokes the GetNameOwner() method on the org.freedesktop.DBus interface on the object represented by instance . When the reply is ready, callback will be called (on the main thread). You can then call egg_dbus_bus_get_name_owner_finish() to get the result. See egg_dbus_bus_get_name_owner_sync() for the synchronous version of this function.

Parameters

instance

A EggDBusBus.

 

call_flags

Flags from EggDBusCallFlags detailing how the method should be invoked.

 

name

Name to get owner of.

 

cancellable

A GCancellable or NULL.

 

callback

Callback to invoke when the reply is ready.

 

user_data

User data to pass to callback .

 

Returns

A pending call id (never zero) that can be used with egg_dbus_connection_pending_call_cancel() or egg_dbus_connection_pending_call_block().


egg_dbus_bus_get_name_owner_finish ()

gboolean
egg_dbus_bus_get_name_owner_finish (EggDBusBus *instance,
                                    gchar **out_unique_name,
                                    GAsyncResult *res,
                                    GError **error);

Finishes an asynchronous method invocation started with egg_dbus_bus_get_name_owner().

Parameters

instance

A EggDBusBus.

 

out_unique_name

The unique name that owns name . Free with g_free().

 

res

A GAsyncResult obtained from the GAsyncReadyCallback function passed to egg_dbus_bus_get_name_owner().

 

error

Return location for error.

 

Returns

TRUE if the method call succeeded, FALSE if error is set.


egg_dbus_bus_list_queued_owners ()

guint
egg_dbus_bus_list_queued_owners (EggDBusBus *instance,
                                 EggDBusCallFlags call_flags,
                                 const gchar *name,
                                 GCancellable *cancellable,
                                 GAsyncReadyCallback callback,
                                 gpointer user_data);

Lists the names waiting in queue to own name .

This function asynchronously invokes the ListQueuedOwners() method on the org.freedesktop.DBus interface on the object represented by instance . When the reply is ready, callback will be called (on the main thread). You can then call egg_dbus_bus_list_queued_owners_finish() to get the result. See egg_dbus_bus_list_queued_owners_sync() for the synchronous version of this function.

Parameters

instance

A EggDBusBus.

 

call_flags

Flags from EggDBusCallFlags detailing how the method should be invoked.

 

name

A well-known name.

 

cancellable

A GCancellable or NULL.

 

callback

Callback to invoke when the reply is ready.

 

user_data

User data to pass to callback .

 

Returns

A pending call id (never zero) that can be used with egg_dbus_connection_pending_call_cancel() or egg_dbus_connection_pending_call_block().


egg_dbus_bus_list_queued_owners_finish ()

gboolean
egg_dbus_bus_list_queued_owners_finish
                               (EggDBusBus *instance,
                                gchar ***out_queued_owners,
                                GAsyncResult *res,
                                GError **error);

Finishes an asynchronous method invocation started with egg_dbus_bus_list_queued_owners().

Parameters

instance

A EggDBusBus.

 

out_queued_owners

Array of unique names in queue to own name . Free with g_strfreev().

 

res

A GAsyncResult obtained from the GAsyncReadyCallback function passed to egg_dbus_bus_list_queued_owners().

 

error

Return location for error.

 

Returns

TRUE if the method call succeeded, FALSE if error is set.


egg_dbus_bus_get_connection_unix_user ()

guint
egg_dbus_bus_get_connection_unix_user (EggDBusBus *instance,
                                       EggDBusCallFlags call_flags,
                                       const gchar *name,
                                       GCancellable *cancellable,
                                       GAsyncReadyCallback callback,
                                       gpointer user_data);

Returns the UNIX user id of the process connected to the server. If unable to determine it, a org.freedesktop.DBus.Error.Failed error is returned.

This function asynchronously invokes the GetConnectionUnixUser() method on the org.freedesktop.DBus interface on the object represented by instance . When the reply is ready, callback will be called (on the main thread). You can then call egg_dbus_bus_get_connection_unix_user_finish() to get the result. See egg_dbus_bus_get_connection_unix_user_sync() for the synchronous version of this function.

Parameters

instance

A EggDBusBus.

 

call_flags

Flags from EggDBusCallFlags detailing how the method should be invoked.

 

name

Name of the connection to query.

 

cancellable

A GCancellable or NULL.

 

callback

Callback to invoke when the reply is ready.

 

user_data

User data to pass to callback .

 

Returns

A pending call id (never zero) that can be used with egg_dbus_connection_pending_call_cancel() or egg_dbus_connection_pending_call_block().


egg_dbus_bus_get_connection_unix_user_finish ()

gboolean
egg_dbus_bus_get_connection_unix_user_finish
                               (EggDBusBus *instance,
                                uid_t *out_uid,
                                GAsyncResult *res,
                                GError **error);

Finishes an asynchronous method invocation started with egg_dbus_bus_get_connection_unix_user().

Parameters

instance

A EggDBusBus.

 

out_uid

UNIX user id.

 

res

A GAsyncResult obtained from the GAsyncReadyCallback function passed to egg_dbus_bus_get_connection_unix_user().

 

error

Return location for error.

 

Returns

TRUE if the method call succeeded, FALSE if error is set.


egg_dbus_bus_get_connection_unix_process_id ()

guint
egg_dbus_bus_get_connection_unix_process_id
                               (EggDBusBus *instance,
                                EggDBusCallFlags call_flags,
                                const gchar *name,
                                GCancellable *cancellable,
                                GAsyncReadyCallback callback,
                                gpointer user_data);

Returns the UNIX process id of the process connected to the server. If unable to determine it, a org.freedesktop.DBus.Error.Failed error is returned.

This function asynchronously invokes the GetConnectionUnixProcessID() method on the org.freedesktop.DBus interface on the object represented by instance . When the reply is ready, callback will be called (on the main thread). You can then call egg_dbus_bus_get_connection_unix_process_id_finish() to get the result. See egg_dbus_bus_get_connection_unix_process_id_sync() for the synchronous version of this function.

Parameters

instance

A EggDBusBus.

 

call_flags

Flags from EggDBusCallFlags detailing how the method should be invoked.

 

name

Name of the connection to query.

 

cancellable

A GCancellable or NULL.

 

callback

Callback to invoke when the reply is ready.

 

user_data

User data to pass to callback .

 

Returns

A pending call id (never zero) that can be used with egg_dbus_connection_pending_call_cancel() or egg_dbus_connection_pending_call_block().


egg_dbus_bus_get_connection_unix_process_id_finish ()

gboolean
egg_dbus_bus_get_connection_unix_process_id_finish
                               (EggDBusBus *instance,
                                pid_t *out_pid,
                                GAsyncResult *res,
                                GError **error);

Finishes an asynchronous method invocation started with egg_dbus_bus_get_connection_unix_process_id().

Parameters

instance

A EggDBusBus.

 

out_pid

UNIX process id.

 

res

A GAsyncResult obtained from the GAsyncReadyCallback function passed to egg_dbus_bus_get_connection_unix_process_id().

 

error

Return location for error.

 

Returns

TRUE if the method call succeeded, FALSE if error is set.


egg_dbus_bus_get_adt_audit_session_data ()

guint
egg_dbus_bus_get_adt_audit_session_data
                               (EggDBusBus *instance,
                                EggDBusCallFlags call_flags,
                                const gchar *name,
                                GCancellable *cancellable,
                                GAsyncReadyCallback callback,
                                gpointer user_data);

Returns the Solaris/ADT auditing data of the process connected to the server. If unable to determine it, a org.freedesktop.DBus.Error.AdtAuditDataUnknown error is returned.

This function asynchronously invokes the GetAdtAuditSessionData() method on the org.freedesktop.DBus interface on the object represented by instance . When the reply is ready, callback will be called (on the main thread). You can then call egg_dbus_bus_get_adt_audit_session_data_finish() to get the result. See egg_dbus_bus_get_adt_audit_session_data_sync() for the synchronous version of this function.

Parameters

instance

A EggDBusBus.

 

call_flags

Flags from EggDBusCallFlags detailing how the method should be invoked.

 

name

Name of the connection to query.

 

cancellable

A GCancellable or NULL.

 

callback

Callback to invoke when the reply is ready.

 

user_data

User data to pass to callback .

 

Returns

A pending call id (never zero) that can be used with egg_dbus_connection_pending_call_cancel() or egg_dbus_connection_pending_call_block().


egg_dbus_bus_get_adt_audit_session_data_finish ()

gboolean
egg_dbus_bus_get_adt_audit_session_data_finish
                               (EggDBusBus *instance,
                                EggDBusArraySeq **out_data,
                                GAsyncResult *res,
                                GError **error);

Finishes an asynchronous method invocation started with egg_dbus_bus_get_adt_audit_session_data().

Parameters

instance

A EggDBusBus.

 

out_data

An array of bytes (typically a string of undefined encoding). Free with g_object_unref().

 

res

A GAsyncResult obtained from the GAsyncReadyCallback function passed to egg_dbus_bus_get_adt_audit_session_data().

 

error

Return location for error.

 

Returns

TRUE if the method call succeeded, FALSE if error is set.


egg_dbus_bus_get_connection_se_linux_security_context ()

guint
egg_dbus_bus_get_connection_se_linux_security_context
                               (EggDBusBus *instance,
                                EggDBusCallFlags call_flags,
                                const gchar *name,
                                GCancellable *cancellable,
                                GAsyncReadyCallback callback,
                                gpointer user_data);

Returns the SELinux security context of the process connected to the server. If unable to determine it, a org.freedesktop.DBus.Error.SELinuxSecurityContextUnknown error is returned.

This function asynchronously invokes the GetConnectionSELinuxSecurityContext() method on the org.freedesktop.DBus interface on the object represented by instance . When the reply is ready, callback will be called (on the main thread). You can then call egg_dbus_bus_get_connection_se_linux_security_context_finish() to get the result. See egg_dbus_bus_get_connection_se_linux_security_context_sync() for the synchronous version of this function.

Parameters

instance

A EggDBusBus.

 

call_flags

Flags from EggDBusCallFlags detailing how the method should be invoked.

 

name

Name of the connection to query.

 

cancellable

A GCancellable or NULL.

 

callback

Callback to invoke when the reply is ready.

 

user_data

User data to pass to callback .

 

Returns

A pending call id (never zero) that can be used with egg_dbus_connection_pending_call_cancel() or egg_dbus_connection_pending_call_block().


egg_dbus_bus_get_connection_se_linux_security_context_finish ()

gboolean
egg_dbus_bus_get_connection_se_linux_security_context_finish
                               (EggDBusBus *instance,
                                EggDBusArraySeq **out_security_context,
                                GAsyncResult *res,
                                GError **error);

Finishes an asynchronous method invocation started with egg_dbus_bus_get_connection_se_linux_security_context().

Parameters

instance

A EggDBusBus.

 

out_security_context

An array of bytes (typically a string of undefined encoding). Free with g_object_unref().

 

res

A GAsyncResult obtained from the GAsyncReadyCallback function passed to egg_dbus_bus_get_connection_se_linux_security_context().

 

error

Return location for error.

 

Returns

TRUE if the method call succeeded, FALSE if error is set.


egg_dbus_bus_reload_config ()

guint
egg_dbus_bus_reload_config (EggDBusBus *instance,
                            EggDBusCallFlags call_flags,
                            GCancellable *cancellable,
                            GAsyncReadyCallback callback,
                            gpointer user_data);

Asks the message bus to reload configuration files.

This function asynchronously invokes the ReloadConfig() method on the org.freedesktop.DBus interface on the object represented by instance . When the reply is ready, callback will be called (on the main thread). You can then call egg_dbus_bus_reload_config_finish() to get the result. See egg_dbus_bus_reload_config_sync() for the synchronous version of this function.

Parameters

instance

A EggDBusBus.

 

call_flags

Flags from EggDBusCallFlags detailing how the method should be invoked.

 

cancellable

A GCancellable or NULL.

 

callback

Callback to invoke when the reply is ready.

 

user_data

User data to pass to callback .

 

Returns

A pending call id (never zero) that can be used with egg_dbus_connection_pending_call_cancel() or egg_dbus_connection_pending_call_block().


egg_dbus_bus_reload_config_finish ()

gboolean
egg_dbus_bus_reload_config_finish (EggDBusBus *instance,
                                   GAsyncResult *res,
                                   GError **error);

Finishes an asynchronous method invocation started with egg_dbus_bus_reload_config().

Parameters

instance

A EggDBusBus.

 

res

A GAsyncResult obtained from the GAsyncReadyCallback function passed to egg_dbus_bus_reload_config().

 

error

Return location for error.

 

Returns

TRUE if the method call succeeded, FALSE if error is set.


egg_dbus_bus_get_id ()

guint
egg_dbus_bus_get_id (EggDBusBus *instance,
                     EggDBusCallFlags call_flags,
                     GCancellable *cancellable,
                     GAsyncReadyCallback callback,
                     gpointer user_data);

Gets the unique ID of the bus. The unique ID here is shared among all addresses the bus daemon is listening on (TCP, UNIX domain socket, etc.). Each address the bus is listening on also has its own unique ID. The per-bus and per-address IDs are not related. For a desktop session bus, the bus ID can be used as a way to uniquely identify a user's session. See the D-Bus specification for more information about unique IDs.

This function asynchronously invokes the GetId() method on the org.freedesktop.DBus interface on the object represented by instance . When the reply is ready, callback will be called (on the main thread). You can then call egg_dbus_bus_get_id_finish() to get the result. See egg_dbus_bus_get_id_sync() for the synchronous version of this function.

Parameters

instance

A EggDBusBus.

 

call_flags

Flags from EggDBusCallFlags detailing how the method should be invoked.

 

cancellable

A GCancellable or NULL.

 

callback

Callback to invoke when the reply is ready.

 

user_data

User data to pass to callback .

 

Returns

A pending call id (never zero) that can be used with egg_dbus_connection_pending_call_cancel() or egg_dbus_connection_pending_call_block().


egg_dbus_bus_get_id_finish ()

gboolean
egg_dbus_bus_get_id_finish (EggDBusBus *instance,
                            gchar **out_unique_id,
                            GAsyncResult *res,
                            GError **error);

Finishes an asynchronous method invocation started with egg_dbus_bus_get_id().

Parameters

instance

A EggDBusBus.

 

out_unique_id

Unique ID identifying the bus daemon. Free with g_free().

 

res

A GAsyncResult obtained from the GAsyncReadyCallback function passed to egg_dbus_bus_get_id().

 

error

Return location for error.

 

Returns

TRUE if the method call succeeded, FALSE if error is set.


egg_dbus_bus_handle_hello_finish ()

void
egg_dbus_bus_handle_hello_finish (EggDBusMethodInvocation *method_invocation,
                                  const gchar *out_assigned_name);

Function to be called by implementers of the

org.freedesktop.DBus

D-Bus interface to finish handling the

Hello() method.

Parameters

assigned_name

Unique name assigned to the connection.

 

method_invocation

A EggDBusMethodInvocation.

 

egg_dbus_bus_handle_request_name_finish ()

void
egg_dbus_bus_handle_request_name_finish
                               (EggDBusMethodInvocation *method_invocation,
                                EggDBusRequestNameReply out_value);

Function to be called by implementers of the

org.freedesktop.DBus

D-Bus interface to finish handling the

RequestName() method.

Parameters

value

Return value.

 

method_invocation

A EggDBusMethodInvocation.

 

egg_dbus_bus_handle_release_name_finish ()

void
egg_dbus_bus_handle_release_name_finish
                               (EggDBusMethodInvocation *method_invocation,
                                EggDBusReleaseNameReply out_value);

Function to be called by implementers of the

org.freedesktop.DBus

D-Bus interface to finish handling the

ReleaseName() method.

Parameters

value

Return value.

 

method_invocation

A EggDBusMethodInvocation.

 

egg_dbus_bus_handle_start_service_by_name_finish ()

void
egg_dbus_bus_handle_start_service_by_name_finish
                               (EggDBusMethodInvocation *method_invocation,
                                EggDBusStartServiceByNameReply out_value);

Function to be called by implementers of the

org.freedesktop.DBus

D-Bus interface to finish handling the

StartServiceByName() method.

Parameters

value

Reply

 

method_invocation

A EggDBusMethodInvocation.

 

egg_dbus_bus_handle_update_activation_environment_finish ()

void
egg_dbus_bus_handle_update_activation_environment_finish
                               (EggDBusMethodInvocation *method_invocation);

Function to be called by implementers of the

org.freedesktop.DBus

D-Bus interface to finish handling the

UpdateActivationEnvironment() method.

Parameters

method_invocation

A EggDBusMethodInvocation.

 

egg_dbus_bus_handle_name_has_owner_finish ()

void
egg_dbus_bus_handle_name_has_owner_finish
                               (EggDBusMethodInvocation *method_invocation,
                                gboolean out_has_owner);

Function to be called by implementers of the

org.freedesktop.DBus

D-Bus interface to finish handling the

NameHasOwner() method.

Parameters

has_owner

TRUE only if name exists.

 

method_invocation

A EggDBusMethodInvocation.

 

egg_dbus_bus_handle_list_names_finish ()

void
egg_dbus_bus_handle_list_names_finish (EggDBusMethodInvocation *method_invocation,
                                       gchar **out_names);

Function to be called by implementers of the

org.freedesktop.DBus

D-Bus interface to finish handling the

ListNames() method.

Parameters

names

Array of strings where each string is a bus name.

 

method_invocation

A EggDBusMethodInvocation.

 

egg_dbus_bus_handle_list_activatable_names_finish ()

void
egg_dbus_bus_handle_list_activatable_names_finish
                               (EggDBusMethodInvocation *method_invocation,
                                gchar **out_activatable_names);

Function to be called by implementers of the

org.freedesktop.DBus

D-Bus interface to finish handling the

ListActivatableNames() method.

Parameters

activatable_names

Array of strings where each string is a bus name.

 

method_invocation

A EggDBusMethodInvocation.

 

egg_dbus_bus_handle_add_match_finish ()

void
egg_dbus_bus_handle_add_match_finish (EggDBusMethodInvocation *method_invocation);

Function to be called by implementers of the

org.freedesktop.DBus

D-Bus interface to finish handling the

AddMatch() method.

Parameters

method_invocation

A EggDBusMethodInvocation.

 

egg_dbus_bus_handle_remove_match_finish ()

void
egg_dbus_bus_handle_remove_match_finish
                               (EggDBusMethodInvocation *method_invocation);

Function to be called by implementers of the

org.freedesktop.DBus

D-Bus interface to finish handling the

RemoveMatch() method.

Parameters

method_invocation

A EggDBusMethodInvocation.

 

egg_dbus_bus_handle_get_name_owner_finish ()

void
egg_dbus_bus_handle_get_name_owner_finish
                               (EggDBusMethodInvocation *method_invocation,
                                const gchar *out_unique_name);

Function to be called by implementers of the

org.freedesktop.DBus

D-Bus interface to finish handling the

GetNameOwner() method.

Parameters

unique_name

The unique name that owns name .

 

method_invocation

A EggDBusMethodInvocation.

 

egg_dbus_bus_handle_list_queued_owners_finish ()

void
egg_dbus_bus_handle_list_queued_owners_finish
                               (EggDBusMethodInvocation *method_invocation,
                                gchar **out_queued_owners);

Function to be called by implementers of the

org.freedesktop.DBus

D-Bus interface to finish handling the

ListQueuedOwners() method.

Parameters

queued_owners

Array of unique names in queue to own name .

 

method_invocation

A EggDBusMethodInvocation.

 

egg_dbus_bus_handle_get_connection_unix_user_finish ()

void
egg_dbus_bus_handle_get_connection_unix_user_finish
                               (EggDBusMethodInvocation *method_invocation,
                                uid_t out_uid);

Function to be called by implementers of the

org.freedesktop.DBus

D-Bus interface to finish handling the

GetConnectionUnixUser() method.

Parameters

uid

UNIX user id.

 

method_invocation

A EggDBusMethodInvocation.

 

egg_dbus_bus_handle_get_connection_unix_process_id_finish ()

void
egg_dbus_bus_handle_get_connection_unix_process_id_finish
                               (EggDBusMethodInvocation *method_invocation,
                                pid_t out_pid);

Function to be called by implementers of the

org.freedesktop.DBus

D-Bus interface to finish handling the

GetConnectionUnixProcessID() method.

Parameters

pid

UNIX process id.

 

method_invocation

A EggDBusMethodInvocation.

 

egg_dbus_bus_handle_get_adt_audit_session_data_finish ()

void
egg_dbus_bus_handle_get_adt_audit_session_data_finish
                               (EggDBusMethodInvocation *method_invocation,
                                EggDBusArraySeq *out_data);

Function to be called by implementers of the

org.freedesktop.DBus

D-Bus interface to finish handling the

GetAdtAuditSessionData() method.

Parameters

data

An array of bytes (typically a string of undefined encoding).

 

method_invocation

A EggDBusMethodInvocation.

 

egg_dbus_bus_handle_get_connection_se_linux_security_context_finish ()

void
egg_dbus_bus_handle_get_connection_se_linux_security_context_finish
                               (EggDBusMethodInvocation *method_invocation,
                                EggDBusArraySeq *out_security_context);

Function to be called by implementers of the

org.freedesktop.DBus

D-Bus interface to finish handling the

GetConnectionSELinuxSecurityContext() method.

Parameters

security_context

An array of bytes (typically a string of undefined encoding).

 

method_invocation

A EggDBusMethodInvocation.

 

egg_dbus_bus_handle_reload_config_finish ()

void
egg_dbus_bus_handle_reload_config_finish
                               (EggDBusMethodInvocation *method_invocation);

Function to be called by implementers of the

org.freedesktop.DBus

D-Bus interface to finish handling the

ReloadConfig() method.

Parameters

method_invocation

A EggDBusMethodInvocation.

 

egg_dbus_bus_handle_get_id_finish ()

void
egg_dbus_bus_handle_get_id_finish (EggDBusMethodInvocation *method_invocation,
                                   const gchar *out_unique_id);

Function to be called by implementers of the

org.freedesktop.DBus

D-Bus interface to finish handling the

GetId() method.

Parameters

unique_id

Unique ID identifying the bus daemon

 

method_invocation

A EggDBusMethodInvocation.

 

egg_dbus_bus_emit_signal_name_owner_changed ()

void
egg_dbus_bus_emit_signal_name_owner_changed
                               (EggDBusBus *instance,
                                const gchar *destination,
                                const gchar *name,
                                const gchar *old_owner,
                                const gchar *new_owner);

Type safe wrapper for emitting the “name-owner-changed” signal.

Parameters

instance

A GObject derived type implementing the EggDBusBus interface.

 

destination

The destination of the signal or NULL to emit signals to all listeners.

 

name

Name with new owner.

 

old_owner

Old owner or empty string if none.

 

new_owner

New owner or empty string if none.

 

egg_dbus_bus_emit_signal_name_lost ()

void
egg_dbus_bus_emit_signal_name_lost (EggDBusBus *instance,
                                    const gchar *destination,
                                    const gchar *name);

Type safe wrapper for emitting the “name-lost” signal.

Parameters

instance

A GObject derived type implementing the EggDBusBus interface.

 

destination

The destination of the signal or NULL to emit signals to all listeners.

 

name

Name which was lost.

 

egg_dbus_bus_emit_signal_name_acquired ()

void
egg_dbus_bus_emit_signal_name_acquired
                               (EggDBusBus *instance,
                                const gchar *destination,
                                const gchar *name);

Type safe wrapper for emitting the “name-acquired” signal.

Parameters

instance

A GObject derived type implementing the EggDBusBus interface.

 

destination

The destination of the signal or NULL to emit signals to all listeners.

 

name

Name which was acquired.

 

Types and Values

EggDBusBus

typedef struct _EggDBusBus EggDBusBus;

struct EggDBusBusIface

struct EggDBusBusIface {
  EggDBusInterfaceIface g_iface;

  void (* handle_hello) (
      EggDBusBus *instance,
      EggDBusMethodInvocation *method_invocation);

  void (* handle_request_name) (
      EggDBusBus *instance,
      const gchar *name,
      EggDBusRequestNameFlags flags,
      EggDBusMethodInvocation *method_invocation);

  void (* handle_release_name) (
      EggDBusBus *instance,
      const gchar *name,
      EggDBusMethodInvocation *method_invocation);

  void (* handle_start_service_by_name) (
      EggDBusBus *instance,
      const gchar *name,
      guint flags,
      EggDBusMethodInvocation *method_invocation);

  void (* handle_update_activation_environment) (
      EggDBusBus *instance,
      EggDBusHashMap *env_hash,
      EggDBusMethodInvocation *method_invocation);

  void (* handle_name_has_owner) (
      EggDBusBus *instance,
      const gchar *name,
      EggDBusMethodInvocation *method_invocation);

  void (* handle_list_names) (
      EggDBusBus *instance,
      EggDBusMethodInvocation *method_invocation);

  void (* handle_list_activatable_names) (
      EggDBusBus *instance,
      EggDBusMethodInvocation *method_invocation);

  void (* handle_add_match) (
      EggDBusBus *instance,
      const gchar *rule,
      EggDBusMethodInvocation *method_invocation);

  void (* handle_remove_match) (
      EggDBusBus *instance,
      const gchar *rule,
      EggDBusMethodInvocation *method_invocation);

  void (* handle_get_name_owner) (
      EggDBusBus *instance,
      const gchar *name,
      EggDBusMethodInvocation *method_invocation);

  void (* handle_list_queued_owners) (
      EggDBusBus *instance,
      const gchar *name,
      EggDBusMethodInvocation *method_invocation);

  void (* handle_get_connection_unix_user) (
      EggDBusBus *instance,
      const gchar *name,
      EggDBusMethodInvocation *method_invocation);

  void (* handle_get_connection_unix_process_id) (
      EggDBusBus *instance,
      const gchar *name,
      EggDBusMethodInvocation *method_invocation);

  void (* handle_get_adt_audit_session_data) (
      EggDBusBus *instance,
      const gchar *name,
      EggDBusMethodInvocation *method_invocation);

  void (* handle_get_connection_se_linux_security_context) (
      EggDBusBus *instance,
      const gchar *name,
      EggDBusMethodInvocation *method_invocation);

  void (* handle_reload_config) (
      EggDBusBus *instance,
      EggDBusMethodInvocation *method_invocation);

  void (* handle_get_id) (
      EggDBusBus *instance,
      EggDBusMethodInvocation *method_invocation);
};

Interface VTable for implementing the org.freedesktop.DBus D-Bus interface.

Members

handle_hello ()

Before an application is able to send messages to other applications it must invoke this method on the message bus to obtain a unique name. If an application without a unique name tries to send a message to another application, or a message to the message bus itself that isn't the egg_dbus_bus_hello() method, it will be disconnected from the bus. There is no corresponding disconnect request; if a client wishes to disconnect from the bus, it simply closes the socket (or other communication channel).

 

handle_request_name ()

This method call should be invoked on the org.freedesktop.DBus name to request the message bus to assign the given name to the method caller. Each name maintains a queue of possible owners, where the head of the queue is the primary or current owner of the name. Each potential owner in the queue maintains the EGG_DBUS_REQUEST_NAME_FLAGS_ALLOW_REPLACEMENT and EGG_DBUS_REQUEST_NAME_FLAGS_DO_NOT_QUEUE settings from its latest egg_dbus_bus_request_name() call. See the D-Bus specification for more details.

 

handle_release_name ()

This method call should be invoked on the org.freedesktop.DBus name to request the message bus to release the method caller's claim to the given name. If the caller is the primary owner, a new primary owner will be selected from the queue if any other owners are waiting. If the caller is waiting in the queue for the name, the caller will removed from the queue and will not be made an owner of the name if it later becomes available. If there are no other owners in the queue for the name, it will be removed from the bus entirely.

 

handle_start_service_by_name ()

Tries to launch the executable associated with name . See the D-Bus specification for more details on service activation.

 

handle_update_activation_environment ()

Normally, session bus activated services inherit the environment of the bus daemon. This method adds to or modifies that environment when activating services. Some bus instances, such as the standard system bus, may disable access to this method for some or all callers.

 

handle_name_has_owner ()

Checks if the specified name exists (currently has an owner).

 

handle_list_names ()

Returns a list of all currently-owned names on the bus.

 

handle_list_activatable_names ()

Returns a list of all names that can be activated on the bus.

 

handle_add_match ()

Adds a match rule to match messages going through the message bus. If the bus does not have enough resources the org.freedesktop.DBus.Error.OOM error is returned. See the D-Bus specification for more information about match rules.

 

handle_remove_match ()

Removes the first rule that matches. If the rule is not found the org.freedesktop.DBus.Error.MatchRuleNotFound error is returned. See the D-Bus specification for more information about match rules.

 

handle_get_name_owner ()

Returns the unique connection name of the primary owner of the name given. If the requested name doesn't have an owner, returns a org.freedesktop.DBus.Error.NameHasNoOwner error.

 

handle_list_queued_owners ()

Lists the names waiting in queue to own name .

 

handle_get_connection_unix_user ()

Returns the UNIX user id of the process connected to the server. If unable to determine it, a org.freedesktop.DBus.Error.Failed error is returned.

 

handle_get_connection_unix_process_id ()

Returns the UNIX process id of the process connected to the server. If unable to determine it, a org.freedesktop.DBus.Error.Failed error is returned.

 

handle_get_adt_audit_session_data ()

Returns the Solaris/ADT auditing data of the process connected to the server. If unable to determine it, a org.freedesktop.DBus.Error.AdtAuditDataUnknown error is returned.

 

handle_get_connection_se_linux_security_context ()

Returns the SELinux security context of the process connected to the server. If unable to determine it, a org.freedesktop.DBus.Error.SELinuxSecurityContextUnknown error is returned.

 

handle_reload_config ()

Asks the message bus to reload configuration files.

 

handle_get_id ()

Gets the unique ID of the bus. The unique ID here is shared among all addresses the bus daemon is listening on (TCP, UNIX domain socket, etc.). Each address the bus is listening on also has its own unique ID. The per-bus and per-address IDs are not related. For a desktop session bus, the bus ID can be used as a way to uniquely identify a user's session. See the D-Bus specification for more information about unique IDs.

 

enum EggDBusRequestNameFlags

Flags used in the egg_dbus_bus_request_name() method.

Members

EGG_DBUS_REQUEST_NAME_FLAGS_NONE

No flags set.

 

EGG_DBUS_REQUEST_NAME_FLAGS_ALLOW_REPLACEMENT

If an application A specifies this flag and succeeds in becoming the owner of the name, and another application B later calls egg_dbus_bus_request_name() with the EGG_DBUS_REQUEST_NAME_FLAGS_REPLACE_EXISTING flag, then application A will lose ownership and receive a “name-lost” signal, and application B will become the new owner. If EGG_DBUS_REQUEST_NAME_FLAGS_ALLOW_REPLACEMENT is not specified by application A, or EGG_DBUS_REQUEST_NAME_FLAGS_REPLACE_EXISTING is not specified by application B, then application B will not replace application A as the owner.

 

EGG_DBUS_REQUEST_NAME_FLAGS_REPLACE_EXISTING

Try to replace the current owner if there is one. If this flag is not set the application will only become the owner of the name if there is no current owner. If this flag is set, the application will replace the current owner if the current owner specified EGG_DBUS_REQUEST_NAME_FLAGS_ALLOW_REPLACEMENT.

 

EGG_DBUS_REQUEST_NAME_FLAGS_DO_NOT_QUEUE

Without this flag, if an application requests a name that is already owned, the application will be placed in a queue to own the name when the current owner gives it up. If this flag is given, the application will not be placed in the queue, the request for the name will simply fail. This flag also affects behavior when an application is replaced as name owner; by default the application moves back into the waiting queue, unless this flag was provided when the application became the name owner.

 

enum EggDBusRequestNameReply

Return values for the egg_dbus_bus_request_name() method

Members

EGG_DBUS_REQUEST_NAME_REPLY_PRIMARY_OWNER

The caller is now the primary owner of the name, replacing any previous owner. Either the name had no owner before, or the caller specified EGG_DBUS_REQUEST_NAME_FLAGS_REPLACE_EXISTING and the current owner specified EGG_DBUS_REQUEST_NAME_FLAGS_ALLOW_REPLACEMENT.

 

EGG_DBUS_REQUEST_NAME_REPLY_IN_QUEUE

The name already had an owner, EGG_DBUS_REQUEST_NAME_FLAGS_DO_NOT_QUEUE was not specified, and either the current owner did not specify EGG_DBUS_REQUEST_NAME_FLAGS_ALLOW_REPLACEMENT or the requesting application did not specify EGG_DBUS_REQUEST_NAME_FLAGS_REPLACE_EXISTING.

 

EGG_DBUS_REQUEST_NAME_REPLY_EXISTS

The name already has an owner, EGG_DBUS_REQUEST_NAME_FLAGS_DO_NOT_QUEUE was specified, and either EGG_DBUS_REQUEST_NAME_FLAGS_ALLOW_REPLACEMENT was not specified by the current owner, or EGG_DBUS_REQUEST_NAME_FLAGS_REPLACE_EXISTING was not specified by the requesting application.

 

EGG_DBUS_REQUEST_NAME_REPLY_ALREADY_OWNED

The application trying to request ownership of a name is already the owner of it

 

enum EggDBusReleaseNameReply

Return values for the egg_dbus_bus_release_name() method.

Members

EGG_DBUS_RELEASE_NAME_REPLY_RELEASED

The caller has released his claim on the given name. Either the caller was the primary owner of the name, and the name is now unused or taken by somebody waiting in the queue for the name, or the caller was waiting in the queue for the name and has now been removed from the queue.

 

EGG_DBUS_RELEASE_NAME_REPLY_NON_EXISTANT

The given name does not exist on this bus.

 

EGG_DBUS_RELEASE_NAME_REPLY_NOT_OWNER

The caller was not the primary owner of this name, and was also not waiting in the queue to own this name.

 

enum EggDBusStartServiceByNameReply

Return values for the egg_dbus_bus_start_service_by_name() method.

Members

EGG_DBUS_START_SERVICE_BY_NAME_REPLY_SUCCESS

The service was successfully started.

 

EGG_DBUS_START_SERVICE_BY_NAME_REPLY_ALREADY_RUNNING

A connection already owns the given name.

 

Signal Details

The “name-acquired” signal

void
user_function (EggDBusBus *instance,
               gchar      *name,
               gpointer    user_data)

This signal is sent to a specific application when it gains ownership of a name.

Parameters

instance

A EggDBusBus.

 

name

Name which was acquired.

 

user_data

user data set when the signal handler was connected.

 

Flags: Run Last


The “name-lost” signal

void
user_function (EggDBusBus *instance,
               gchar      *name,
               gpointer    user_data)

This signal is sent to a specific application when it loses ownership of a name.

Parameters

instance

A EggDBusBus.

 

name

Name which was lost.

 

user_data

user data set when the signal handler was connected.

 

Flags: Run Last


The “name-owner-changed” signal

void
user_function (EggDBusBus *instance,
               gchar      *name,
               gchar      *old_owner,
               gchar      *new_owner,
               gpointer    user_data)

This signal indicates that the owner of a name has changed. It's also the signal to use to detect the appearance of new names on the bus.

Parameters

instance

A EggDBusBus.

 

name

Name with new owner.

 

old_owner

Old owner or empty string if none.

 

new_owner

New owner or empty string if none.

 

user_data

user data set when the signal handler was connected.

 

Flags: Run Last