GDebugController

GDebugController — Debugging controller

Functions

Properties

gboolean debug-enabled Read / Write

Types and Values

Object Hierarchy

    GInterface
    ╰── GDebugController

Prerequisites

GDebugController requires GInitable and GObject.

Known Implementations

GDebugController is implemented by GDebugControllerDBus.

Includes

#include <gio/gio.h>

Description

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

It is implemented on Linux using GDebugControllerDBus, 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 “debug-enabled”. This controls g_log_set_debug_enabled() by default. Application code may connect to the “notify” signal for it to control other parts of its debug infrastructure as necessary.

Functions

g_debug_controller_dup_default ()

GDebugController *
g_debug_controller_dup_default (void);

Gets a reference to the default GDebugController for the system.

Returns

a new reference to the default GDebugController.

[not nullable][transfer full]

Since: 2.72


g_debug_controller_get_debug_enabled ()

gboolean
g_debug_controller_get_debug_enabled (GDebugController *self);

Get the value of “debug-enabled”.

Parameters

self

a GDebugController

 

Returns

TRUE if debug output should be exposed, FALSE otherwise

Since: 2.72


g_debug_controller_set_debug_enabled ()

void
g_debug_controller_set_debug_enabled (GDebugController *self,
                                      gboolean debug_enabled);

Set the value of “debug-enabled”.

Parameters

self

a GDebugController

 

debug_enabled

TRUE if debug output should be exposed, FALSE otherwise

 

Since: 2.72

Types and Values

GDebugController

typedef struct _GDebugController GDebugController;

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

Since: 2.72


struct GDebugControllerInterface

struct GDebugControllerInterface {
};

The virtual function table for GDebugController.

Members

Since: 2.72


G_DEBUG_CONTROLLER_EXTENSION_POINT_NAME

#define G_DEBUG_CONTROLLER_EXTENSION_POINT_NAME "gio-debug-controller"

Extension point for debug control functionality. See Extending GIO.

Since: 2.72

Property Details

The “debug-enabled” property

  “debug-enabled”            gboolean

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

Owner: GDebugController

Flags: Read / Write

Default value: FALSE

Since: 2.72