DBus API in EDE

Introduction

This document will describe DBus usage in EDE applications, specifically what programs are listening and what data is send via DBus protocol.

Naming convention

EDE uses org.equinoxproject as main namespace for interfaces and object paths, e.g.

  org.equinoxproject.Desktop   # ede-desktop interface
  /org/equinoxproject/Desktop  # ede-desktop object path

rest of the name is application name with method or signal name. If application name is not suitable or could not be represented as DBus name (or could be ambiguous), it can be replaced with applications functionality (org.equinoxproject.Desktop will be more explanatory than org.equinoxproject.Ede_Desktop).

For example:

  org.equinoxproject.Desktop.FooMethod   # FooMethod belongs to ede-desktop

Interfaces

org.equinoxproject.Shutdown

A general signal emitted when EDE is starting to shut down.

Name Details
void Shutdown (void) The only member of 'org.equinoxproject.Shutdown' signal. Emitted when desktop is closed by logging out or shutting down or restarting the computer.

org.equinoxproject.Xsettings

This service path exposes XSETTINGS registry. Object path for access service methods is '/org/equinoxproject/Xsettings' and interface is 'org.equinoxproject.Xsettings'.

Name Details
as GetAll (void) Returns array of all known keys hold by XSETTINGS manager. Each array item is string type.
string GetType (string key) Returns type of the given key. As XSETTINGS knows only three types (int, string and color), returned value will be string holding type name.
void Remove (string key)Removes given key from XSETTINGS registry. If key wasn't found, the function will do nothing.
void Flush (void) Force XSETTINGS manager to store data on disk. This is usually done by manager when exits.
bool Set (string key, type value) Set key to given value. Here, value can be int32, string or array (4 int32 elements, representing RGBA) and set value will automatically set key value type. Returns true if done successfully or false if not.
Print/export