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)