Class: Gio::DebugControllerDBus

Inherits:

Object

• Object
• Gio::DebugControllerDBus

Defined in:

(unknown)

Overview

The virtual function table for GDebug::ControllerDBus.

Instance Method Summary

• #connection ⇒ Gio::DBusConnection

  The D-Bus connection to expose the debugging interface on.

• #connection=(connection) ⇒ Gio::DBusConnection

  The D-Bus connection to expose the debugging interface on.

• #initialize(connection, cancellable) ⇒ Gio::DebugControllerDBus constructor

  Create a new GDebug::ControllerDBus and synchronously initialize it.

• #stop ⇒ nil

  Stop the debug controller, unregistering its object from the bus.

Constructor Details

#initialize(connection, cancellable) ⇒ Gio::DebugControllerDBus

Create a new GDebug::ControllerDBus and synchronously initialize it.

Initializing the object will export the debug object on connection. The object will remain registered until the last reference to the GDebug::ControllerDBus is dropped.

Initialization may fail if registering the object on connection fails.

Parameters:

• connection (Gio::DBusConnection) —

  a GDBus::Connection to register the debug object on

• cancellable (Gio::Cancellable) —

  a #GCancellable, or nil

Instance Method Details

#connection ⇒ Gio::DBusConnection

The D-Bus connection to expose the debugging interface on.

Typically this will be the same connection (to the system or session bus) which the rest of the application or service’s D-Bus objects are registered on.

Returns:

• (Gio::DBusConnection) —

  connection

#connection=(connection) ⇒ Gio::DBusConnection

The D-Bus connection to expose the debugging interface on.

Typically this will be the same connection (to the system or session bus) which the rest of the application or service’s D-Bus objects are registered on.

Parameters:

• connection (Gio::DBusConnection)

Returns:

• (Gio::DBusConnection) —

  connection

• (Gio::DBusConnection) —

  connection

#stop ⇒ nil

Stop the debug controller, unregistering its object from the bus.

Any pending method calls to the object will complete successfully, but new ones will return an error. This method will block until all pending GDebug::ControllerDBus::authorize signals have been handled. This is expected to not take long, as it will just be waiting for threads to join. If any GDebug::ControllerDBus::authorize signal handlers are still executing in other threads, this will block until after they have returned.

This method will be called automatically when the final reference to the GDebug::ControllerDBus is dropped. You may want to call it explicitly to know when the controller has been fully removed from the bus, or to break reference count cycles.

Calling this method from within a GDebug::ControllerDBus::authorize signal handler will cause a deadlock and must not be done.

Returns:

• (nil)