DBusServer

Object Hierarchy:

Description:

[ CCode ( type_id = "g_dbus_server_get_type ()" ) ]
[ Version ( since = "2.26" ) ]
public sealed class DBusServer : Object, Initable

`GDBusServer` is a helper for listening to and accepting D-Bus connections.

This can be used to create a new D-Bus server, allowing two peers to use the D-Bus protocol for their own specialized communication. A server instance provided in this way will not perform message routing or implement the `org.freedesktop.DBus` interface.

To just export an object on a well-known name on a message bus, such as the session or system bus, you should instead use [ func@Gio.bus_own_name].

An example of peer-to-peer communication with GDBus can be found in gdbus-example-peer.c.

Note that a minimal `GDBusServer` will accept connections from any peer. In many use-cases it will be necessary to add a [ class@Gio.DBusAuthObserver] that only accepts connections that have successfully authenticated as the same user that is running the `GDBusServer`. Since GLib 2.68 this can be achieved more simply by passing the `G_DBUS_SERVER_FLAGS_AUTHENTICATION_REQUIRE_SAME_USER` flag to the server.

Namespace: GLib

Package: gio-2.0

Content:

Properties:

public bool active { get; }
Whether the server is currently active.
public string address { owned get; construct; }
The D-Bus address to listen on.
public DBusAuthObserver authentication_observer { owned get; construct; }
A DBusAuthObserver object to assist in the authentication process or null.
public string client_address { get; }
The D-Bus address that clients can use.
public DBusServerFlags flags { get; construct; }
Flags from the DBusServerFlags enumeration.
public string guid { get; construct; }
The GUID of the server.

Creation methods:

protected DBusServer ()
public DBusServer.sync (string address, DBusServerFlags flags, string guid, DBusAuthObserver? observer = null, Cancellable? cancellable = null) throws Error
Creates a new D-Bus server that listens on the first address in address that works.

Methods:

public unowned string get_client_address ()
Gets a D-Bus address string that can be used by clients to connect to this.
public DBusServerFlags get_flags ()
Gets the flags for this.
public unowned string get_guid ()
Gets the GUID for this, as provided to DBusServer.sync.
public bool is_active ()
Gets whether this is active.
public void start ()
Starts this.
public void stop ()
Stops this.

Signals:

public signal bool new_connection (DBusConnection connection)
Emitted when a new authenticated connection has been made.

Inherited Members:

All known members inherited from class GLib.Object

All known members inherited from interface GLib.Initable

@new
init

new_valist

newv