Skip to content

Gio.DebugController

interface

GDebugController is an interface to expose control of debugging features and debug output.

It is implemented on Linux using DebugControllerDBus, which exposes a D-Bus interface to allow authenticated peers to control debug features in this process.

Whether debug output is enabled is exposed as DebugController.debug-enabled. This controls GLib.log_set_debug_enabled by default. Application code may connect to the GObject.Object.notify signal for it to control other parts of its debug infrastructure as necessary.

If your application or service is using the default GLib log writer function, creating one of the built-in implementations of GDebugController should be all that’s needed to dynamically enable or disable debug output.

Methods

get_debug_enabled

def get_debug_enabled(self) -> bool

Get the value of DebugController:debug-enabled.

set_debug_enabled

def set_debug_enabled(self, debug_enabled: bool) -> None

Set the value of DebugController:debug-enabled.

Parameters:

  • debug_enabledTrue if debug output should be exposed, False otherwise

Properties

debug_enabled

debug_enabled: bool  # read/write

True if debug output should be exposed (for example by forwarding it to the journal), False otherwise.