127 lines
6.0 KiB
C
127 lines
6.0 KiB
C
#ifndef EDBUS_FREEDESKTOP_H
|
|
#define EDBUS_FREEDESKTOP_H 1
|
|
|
|
/**
|
|
* @defgroup EDBus_Basic Basic Methods
|
|
*
|
|
* @{
|
|
*/
|
|
#define EDBUS_NAME_REQUEST_FLAG_ALLOW_REPLACEMENT 0x1 /**< Allow another service to become the primary owner if requested */
|
|
#define EDBUS_NAME_REQUEST_FLAG_REPLACE_EXISTING 0x2 /**< Request to replace the current primary owner */
|
|
#define EDBUS_NAME_REQUEST_FLAG_DO_NOT_QUEUE 0x4 /**< If we can not become the primary owner do not place us in the queue */
|
|
|
|
/* Replies to request for a name */
|
|
#define EDBUS_NAME_REQUEST_REPLY_PRIMARY_OWNER 1 /**< Service has become the primary owner of the requested name */
|
|
#define EDBUS_NAME_REQUEST_REPLY_IN_QUEUE 2 /**< Service could not become the primary owner and has been placed in the queue */
|
|
#define EDBUS_NAME_REQUEST_REPLY_EXISTS 3 /**< Service is already in the queue */
|
|
#define EDBUS_NAME_REQUEST_REPLY_ALREADY_OWNER 4 /**< Service is already the primary owner */
|
|
|
|
EAPI EDBus_Pending *edbus_name_request(EDBus_Connection *conn, const char *bus, unsigned int flags, EDBus_Message_Cb cb, const void *cb_data);
|
|
|
|
/* Replies to releasing a name */
|
|
#define EDBUS_NAME_RELEASE_REPLY_RELEASED 1 /**< Service was released from the given name */
|
|
#define EDBUS_NAME_RELEASE_REPLY_NON_EXISTENT 2 /**< The given name does not exist on the bus */
|
|
#define EDBUS_NAME_RELEASE_REPLY_NOT_OWNER 3 /**< Service is not an owner of the given name */
|
|
|
|
EAPI EDBus_Pending *edbus_name_release(EDBus_Connection *conn, const char *bus, EDBus_Message_Cb cb, const void *cb_data);
|
|
EAPI EDBus_Pending *edbus_name_owner_get(EDBus_Connection *conn, const char *bus, EDBus_Message_Cb cb, const void *cb_data);
|
|
EAPI EDBus_Pending *edbus_name_owner_has(EDBus_Connection *conn, const char *bus, EDBus_Message_Cb cb, const void *cb_data);
|
|
EAPI EDBus_Pending *edbus_names_list(EDBus_Connection *conn, EDBus_Message_Cb cb, const void *cb_data);
|
|
EAPI EDBus_Pending *edbus_names_activatable_list(EDBus_Connection *conn, EDBus_Message_Cb cb, const void *cb_data);
|
|
|
|
/* Replies to service starts */
|
|
#define EDBUS_NAME_START_REPLY_SUCCESS 1 /**< Service was auto started */
|
|
#define EDBUS_NAME_START_REPLY_ALREADY_RUNNING 2 /**< Service was already running */
|
|
|
|
EAPI EDBus_Pending *edbus_name_start(EDBus_Connection *conn, const char *bus, unsigned int flags, EDBus_Message_Cb cb, const void *cb_data);
|
|
|
|
typedef void (*EDBus_Name_Owner_Changed_Cb)(void *data, const char *bus, const char *old_id, const char *new_id);
|
|
|
|
EAPI void edbus_name_owner_changed_callback_add(EDBus_Connection *conn, const char *bus, EDBus_Name_Owner_Changed_Cb cb, const void *cb_data);
|
|
EAPI void edbus_name_owner_changed_callback_del(EDBus_Connection *conn, const char *bus, EDBus_Name_Owner_Changed_Cb cb, const void *cb_data);
|
|
|
|
/**
|
|
* @defgroup EDBus_FDO_Peer org.freedesktop.DBus.Peer
|
|
*
|
|
* @{
|
|
*/
|
|
EAPI EDBus_Pending *edbus_object_peer_ping(EDBus_Object *obj, EDBus_Message_Cb cb, const void *data) EINA_ARG_NONNULL(1);
|
|
EAPI EDBus_Pending *edbus_object_peer_machine_id_get(EDBus_Object *obj, EDBus_Message_Cb cb, const void *data) EINA_ARG_NONNULL(1, 2);
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup EDBus_FDO_Introspectable org.freedesktop.DBus.Introspectable
|
|
*
|
|
* @{
|
|
*/
|
|
EAPI EDBus_Pending *edbus_object_introspect(EDBus_Object *obj, EDBus_Message_Cb cb, const void *data) EINA_ARG_NONNULL(1, 2);
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup EDBus_FDO_Properties org.freedesktop.DBus.Properties
|
|
*
|
|
* Whenever edbus_proxy_properties_monitor() is called on a
|
|
* proxy to an object it will automatically listen for properties
|
|
* changed on that interface, emitting events with
|
|
* edbus_object_event_type being
|
|
* #EDBUS_OBJECT_EVENT_PROPERTY_CHANGED and
|
|
* #EDBUS_OBJECT_EVENT_PROPERTY_REMOVED, as well as
|
|
* #EDBUS_PROXY_EVENT_PROPERTY_CHANGED and
|
|
* #EDBUS_PROXY_EVENT_PROPERTY_REMOVED.
|
|
*
|
|
* One may manually query the properties
|
|
* edbus_proxy_property_get() and edbus_proxy_property_get_all()
|
|
* or listen for changes with
|
|
* edbus_proxy_properties_changed_callback_add().
|
|
*
|
|
* To set property call edbus_proxy_property_set().
|
|
*
|
|
* @{
|
|
*/
|
|
EAPI void edbus_proxy_properties_monitor(EDBus_Proxy *proxy);
|
|
|
|
EAPI EDBus_Pending *edbus_proxy_property_get(EDBus_Proxy *proxy, const char *name, EDBus_Message_Cb cb, const void *data) EINA_ARG_NONNULL(1, 2, 3);
|
|
EAPI EDBus_Pending *edbus_proxy_property_set(EDBus_Proxy *proxy, const char *name, char type, const void *value, EDBus_Message_Cb cb, const void *data) EINA_ARG_NONNULL(1, 2, 4);
|
|
EAPI EDBus_Pending *edbus_proxy_property_get_all(EDBus_Proxy *proxy, EDBus_Message_Cb cb, const void *data) EINA_ARG_NONNULL(1, 2);
|
|
EAPI EDBus_Signal_Handler *edbus_proxy_properties_changed_callback_add(EDBus_Proxy *proxy, EDBus_Message_Cb cb, const void *data) EINA_ARG_NONNULL(1, 2);
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup EDBus_FDO_ObjectManager org.freedesktop.DBus.ObjectManager
|
|
*
|
|
* Whenever edbus_object_managed_objects_monitor() is called on an
|
|
* object it will start listening for children being added or
|
|
* interfaces changing on the object itself. It will then emit
|
|
* events with edbus_object_event_type being
|
|
* #EDBUS_OBJECT_EVENT_IFACE_ADDED,
|
|
* #EDBUS_OBJECT_EVENT_IFACE_REMOVED,
|
|
* #EDBUS_OBJECT_EVENT_PROPERTY_CHANGED and
|
|
* #EDBUS_OBJECT_EVENT_PROPERTY_REMOVED.
|
|
*
|
|
* One may manually query the managed objects with
|
|
* edbus_object_managed_objects_get() and listen for changes with
|
|
* edbus_object_interfaces_added_callback_add() and
|
|
* edbus_object_interfaces_removed_callback_add().
|
|
*
|
|
* @{
|
|
*/
|
|
EAPI void edbus_object_properties_monitor(EDBus_Object *obj);
|
|
|
|
EAPI EDBus_Pending *edbus_object_managed_objects_get(EDBus_Object *obj, EDBus_Message_Cb cb, const void *data) EINA_ARG_NONNULL(1, 2);
|
|
EAPI EDBus_Signal_Handler *edbus_object_interfaces_added_callback_add(EDBus_Object *obj, EDBus_Message_Cb cb, const void *data) EINA_ARG_NONNULL(1, 2);
|
|
EAPI EDBus_Signal_Handler *edbus_object_interfaces_removed_callback_add(EDBus_Object *obj, EDBus_Message_Cb cb, const void *data) EINA_ARG_NONNULL(1, 2);
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
#endif
|