[thirdparty/systemd.git] / src / dbus-common.h

/*-*- Mode: C; c-basic-offset: 8; indent-tabs-mode: nil -*-*/

#ifndef foodbuscommonhfoo
#define foodbuscommonhfoo

/***
  This file is part of systemd.

  Copyright 2010 Lennart Poettering

  systemd is free software; you can redistribute it and/or modify it
  under the terms of the GNU General Public License as published by
  the Free Software Foundation; either version 2 of the License, or
  (at your option) any later version.

  systemd is distributed in the hope that it will be useful, but
  WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  General Public License for more details.

  You should have received a copy of the GNU General Public License
  along with systemd; If not, see <http://www.gnu.org/licenses/>.
***/

#include <dbus/dbus.h>

#ifndef DBUS_ERROR_UNKNOWN_OBJECT
#define DBUS_ERROR_UNKNOWN_OBJECT "org.freedesktop.DBus.Error.UnknownObject"
#endif

#ifndef DBUS_ERROR_UNKNOWN_INTERFACE
#define DBUS_ERROR_UNKNOWN_INTERFACE "org.freedesktop.DBus.Error.UnknownInterface"
#endif

#ifndef DBUS_ERROR_UNKNOWN_PROPERTY
#define DBUS_ERROR_UNKNOWN_PROPERTY "org.freedesktop.DBus.Error.UnknownProperty"
#endif

#ifndef DBUS_ERROR_PROPERTY_READ_ONLY
#define DBUS_ERROR_PROPERTY_READ_ONLY "org.freedesktop.DBus.Error.PropertyReadOnly"
#endif

#define BUS_PROPERTIES_INTERFACE                                        \
        " <interface name=\"org.freedesktop.DBus.Properties\">\n"       \
        "  <method name=\"Get\">\n"                                     \
        "   <arg name=\"interface\" direction=\"in\" type=\"s\"/>\n"    \
        "   <arg name=\"property\" direction=\"in\" type=\"s\"/>\n"     \
        "   <arg name=\"value\" direction=\"out\" type=\"v\"/>\n"       \
        "  </method>\n"                                                 \
        "  <method name=\"GetAll\">\n"                                  \
        "   <arg name=\"interface\" direction=\"in\" type=\"s\"/>\n"    \
        "   <arg name=\"properties\" direction=\"out\" type=\"a{sv}\"/>\n" \
        "  </method>\n"                                                 \
        "  <method name=\"Set\">\n"                                     \
        "   <arg name=\"interface\" direction=\"in\" type=\"s\"/>\n"    \
        "   <arg name=\"property\" direction=\"in\" type=\"s\"/>\n"     \
        "   <arg name=\"value\" direction=\"in\" type=\"v\"/>\n"        \
        "  </method>\n"                                                 \
        "  <signal name=\"PropertiesChanged\">\n"                       \
        "   <arg type=\"s\" name=\"interface\"/>\n"                     \
        "   <arg type=\"a{sv}\" name=\"changed_properties\"/>\n"        \
        "   <arg type=\"as\" name=\"invalidated_properties\"/>\n"       \
        "  </signal>\n"                                                 \
        " </interface>\n"

#define BUS_INTROSPECTABLE_INTERFACE                                    \
        " <interface name=\"org.freedesktop.DBus.Introspectable\">\n"   \
        "  <method name=\"Introspect\">\n"                              \
        "   <arg name=\"data\" type=\"s\" direction=\"out\"/>\n"        \
        "  </method>\n"                                                 \
        " </interface>\n"

#define BUS_PEER_INTERFACE                                              \
        "<interface name=\"org.freedesktop.DBus.Peer\">\n"              \
        " <method name=\"Ping\"/>\n"                                    \
        " <method name=\"GetMachineId\">\n"                             \
        "  <arg type=\"s\" name=\"machine_uuid\" direction=\"out\"/>\n" \
        " </method>\n"                                                  \
        "</interface>\n"

#define BUS_GENERIC_INTERFACES_LIST             \
        "org.freedesktop.DBus.Properties\0"     \
        "org.freedesktop.DBus.Introspectable\0" \
        "org.freedesktop.DBus.Peer\0"

int bus_check_peercred(DBusConnection *c);

int bus_connect(DBusBusType t, DBusConnection **_bus, bool *private_bus, DBusError *error);

int bus_connect_system_ssh(const char *user, const char *host, DBusConnection **_bus, DBusError *error);
int bus_connect_system_polkit(DBusConnection **_bus, DBusError *error);

const char *bus_error_message(const DBusError *error);

typedef int (*BusPropertyCallback)(DBusMessageIter *iter, const char *property, void *data);
typedef int (*BusPropertySetCallback)(DBusMessageIter *iter, const char *property);

typedef struct BusProperty {
        const char *interface;           /* interface of the property */
        const char *property;            /* name of the property */
        BusPropertyCallback append;      /* Function that is called to serialize this property */
        const char *signature;
        const void *data;                /* The data of this property */
        BusPropertySetCallback set;      /* Optional: Function that is called to set this property */
} BusProperty;

DBusHandlerResult bus_send_error_reply(
                DBusConnection *c,
                DBusMessage *message,
                DBusError *bus_error,
                int error);

DBusHandlerResult bus_default_message_handler(
                DBusConnection *c,
                DBusMessage *message,
                const char *introspection,
                const char *interfaces,
                const BusProperty *properties);

int bus_property_append_string(DBusMessageIter *i, const char *property, void *data);
int bus_property_append_strv(DBusMessageIter *i, const char *property, void *data);
int bus_property_append_bool(DBusMessageIter *i, const char *property, void *data);
int bus_property_append_int32(DBusMessageIter *i, const char *property, void *data);
int bus_property_append_uint32(DBusMessageIter *i, const char *property, void *data);
int bus_property_append_uint64(DBusMessageIter *i, const char *property, void *data);
int bus_property_append_size(DBusMessageIter *i, const char *property, void *data);
int bus_property_append_ul(DBusMessageIter *i, const char *property, void *data);
int bus_property_append_long(DBusMessageIter *i, const char *property, void *data);

#define bus_property_append_int bus_property_append_int32
#define bus_property_append_pid bus_property_append_uint32
#define bus_property_append_uid bus_property_append_uint32
#define bus_property_append_gid bus_property_append_uint32
#define bus_property_append_mode bus_property_append_uint32
#define bus_property_append_unsigned bus_property_append_uint32
#define bus_property_append_usec bus_property_append_uint64

#define DEFINE_BUS_PROPERTY_APPEND_ENUM(function,name,type)             \
        int function(DBusMessageIter *i, const char *property, void *data) { \
                const char *value;                                      \
                type *field = data;                                     \
                                                                        \
                assert(i);                                              \
                assert(property);                                       \
                                                                        \
                value = name##_to_string(*field);                       \
                                                                        \
                if (!dbus_message_iter_append_basic(i, DBUS_TYPE_STRING, &value)) \
                        return -ENOMEM;                                 \
                                                                        \
                return 0;                                               \
        }

const char *bus_errno_to_dbus(int error);

DBusMessage* bus_properties_changed_new(const char *path, const char *interface, const char *properties);

uint32_t bus_flags_to_events(DBusWatch *bus_watch);
unsigned bus_events_to_flags(uint32_t events);

int bus_parse_strv(DBusMessage *m, char ***_l);
int bus_parse_strv_iter(DBusMessageIter *iter, char ***_l);

#endif
Commit	Line	Data
03467c88	1	/-- Mode: C; c-basic-offset: 8; indent-tabs-mode: nil --/
9a1ac7b9 LP	2
	3	#ifndef foodbuscommonhfoo
	4	#define foodbuscommonhfoo
	5
	6	/***
	7	This file is part of systemd.
	8
	9	Copyright 2010 Lennart Poettering
	10
	11	systemd is free software; you can redistribute it and/or modify it
	12	under the terms of the GNU General Public License as published by
	13	the Free Software Foundation; either version 2 of the License, or
	14	(at your option) any later version.
	15
	16	systemd is distributed in the hope that it will be useful, but
	17	WITHOUT ANY WARRANTY; without even the implied warranty of
	18	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
	19	General Public License for more details.
	20
	21	You should have received a copy of the GNU General Public License
	22	along with systemd; If not, see <http://www.gnu.org/licenses/>.
	23	***/
	24
	25	#include <dbus/dbus.h>
	26
bfebab7f LP	27	#ifndef DBUS_ERROR_UNKNOWN_OBJECT
	28	#define DBUS_ERROR_UNKNOWN_OBJECT "org.freedesktop.DBus.Error.UnknownObject"
	29	#endif
	30
	31	#ifndef DBUS_ERROR_UNKNOWN_INTERFACE
	32	#define DBUS_ERROR_UNKNOWN_INTERFACE "org.freedesktop.DBus.Error.UnknownInterface"
	33	#endif
	34
	35	#ifndef DBUS_ERROR_UNKNOWN_PROPERTY
	36	#define DBUS_ERROR_UNKNOWN_PROPERTY "org.freedesktop.DBus.Error.UnknownProperty"
	37	#endif
	38
	39	#ifndef DBUS_ERROR_PROPERTY_READ_ONLY
	40	#define DBUS_ERROR_PROPERTY_READ_ONLY "org.freedesktop.DBus.Error.PropertyReadOnly"
	41	#endif
	42
	43	#define BUS_PROPERTIES_INTERFACE \
	44	" <interface name=\"org.freedesktop.DBus.Properties\">\n" \
	45	" <method name=\"Get\">\n" \
	46	" <arg name=\"interface\" direction=\"in\" type=\"s\"/>\n" \
	47	" <arg name=\"property\" direction=\"in\" type=\"s\"/>\n" \
	48	" <arg name=\"value\" direction=\"out\" type=\"v\"/>\n" \
	49	" </method>\n" \
	50	" <method name=\"GetAll\">\n" \
	51	" <arg name=\"interface\" direction=\"in\" type=\"s\"/>\n" \
	52	" <arg name=\"properties\" direction=\"out\" type=\"a{sv}\"/>\n" \
	53	" </method>\n" \
	54	" <method name=\"Set\">\n" \
	55	" <arg name=\"interface\" direction=\"in\" type=\"s\"/>\n" \
	56	" <arg name=\"property\" direction=\"in\" type=\"s\"/>\n" \
	57	" <arg name=\"value\" direction=\"in\" type=\"v\"/>\n" \
	58	" </method>\n" \
	59	" <signal name=\"PropertiesChanged\">\n" \
	60	" <arg type=\"s\" name=\"interface\"/>\n" \
	61	" <arg type=\"a{sv}\" name=\"changed_properties\"/>\n" \
	62	" <arg type=\"as\" name=\"invalidated_properties\"/>\n" \
	63	" </signal>\n" \
	64	" </interface>\n"
	65
	66	#define BUS_INTROSPECTABLE_INTERFACE \
	67	" <interface name=\"org.freedesktop.DBus.Introspectable\">\n" \
	68	" <method name=\"Introspect\">\n" \
	69	" <arg name=\"data\" type=\"s\" direction=\"out\"/>\n" \
	70	" </method>\n" \
	71	" </interface>\n"
	72
	73	#define BUS_PEER_INTERFACE \
	74	"<interface name=\"org.freedesktop.DBus.Peer\">\n" \
	75	" <method name=\"Ping\"/>\n" \
	76	" <method name=\"GetMachineId\">\n" \
	77	" <arg type=\"s\" name=\"machine_uuid\" direction=\"out\"/>\n" \
	78	" </method>\n" \
	79	"</interface>\n"
	80
	81	#define BUS_GENERIC_INTERFACES_LIST \
	82	"org.freedesktop.DBus.Properties\0" \
	83	"org.freedesktop.DBus.Introspectable\0" \
	84	"org.freedesktop.DBus.Peer\0"
	85
9a1ac7b9 LP	86	int bus_check_peercred(DBusConnection *c);
9a1ac7b9 LP	87
f4579ce7	88	int bus_connect(DBusBusType t, DBusConnection *_bus, bool private_bus, DBusError *error);
9a1ac7b9	89
a8f11321 LP	90	int bus_connect_system_ssh(const char user, const char host, DBusConnection *_bus, DBusError error);
	91	int bus_connect_system_polkit(DBusConnection *_bus, DBusError error);
	92
4cf5d675 LP	93	const char bus_error_message(const DBusError error);
4cf5d675 LP	94
bfebab7f LP	95	typedef int (BusPropertyCallback)(DBusMessageIter iter, const char property, void data);
	96	typedef int (BusPropertySetCallback)(DBusMessageIter iter, const char *property);
	97
	98	typedef struct BusProperty {
	99	const char interface; / interface of the property */
	100	const char property; / name of the property */
	101	BusPropertyCallback append; /* Function that is called to serialize this property */
	102	const char *signature;
	103	const void data; / The data of this property */
	104	BusPropertySetCallback set; /* Optional: Function that is called to set this property */
	105	} BusProperty;
	106
	107	DBusHandlerResult bus_send_error_reply(
	108	DBusConnection *c,
	109	DBusMessage *message,
	110	DBusError *bus_error,
	111	int error);
	112
	113	DBusHandlerResult bus_default_message_handler(
	114	DBusConnection *c,
	115	DBusMessage *message,
	116	const char *introspection,
	117	const char *interfaces,
	118	const BusProperty *properties);
	119
	120	int bus_property_append_string(DBusMessageIter i, const char property, void *data);
	121	int bus_property_append_strv(DBusMessageIter i, const char property, void *data);
	122	int bus_property_append_bool(DBusMessageIter i, const char property, void *data);
	123	int bus_property_append_int32(DBusMessageIter i, const char property, void *data);
	124	int bus_property_append_uint32(DBusMessageIter i, const char property, void *data);
	125	int bus_property_append_uint64(DBusMessageIter i, const char property, void *data);
	126	int bus_property_append_size(DBusMessageIter i, const char property, void *data);
	127	int bus_property_append_ul(DBusMessageIter i, const char property, void *data);
916abb21	128	int bus_property_append_long(DBusMessageIter i, const char property, void *data);
bfebab7f LP	129
	130	#define bus_property_append_int bus_property_append_int32
	131	#define bus_property_append_pid bus_property_append_uint32
bd253d1b LP	132	#define bus_property_append_uid bus_property_append_uint32
bd253d1b LP	133	#define bus_property_append_gid bus_property_append_uint32
bfebab7f LP	134	#define bus_property_append_mode bus_property_append_uint32
	135	#define bus_property_append_unsigned bus_property_append_uint32
	136	#define bus_property_append_usec bus_property_append_uint64
	137
	138	#define DEFINE_BUS_PROPERTY_APPEND_ENUM(function,name,type) \
	139	int function(DBusMessageIter i, const char property, void *data) { \
	140	const char *value; \
	141	type *field = data; \
	142	\
	143	assert(i); \
	144	assert(property); \
	145	\
	146	value = name##_to_string(*field); \
	147	\
	148	if (!dbus_message_iter_append_basic(i, DBUS_TYPE_STRING, &value)) \
	149	return -ENOMEM; \
	150	\
	151	return 0; \
	152	}
	153
	154	const char *bus_errno_to_dbus(int error);
	155
	156	DBusMessage* bus_properties_changed_new(const char path, const char interface, const char *properties);
	157
3df5bf61 LP	158	uint32_t bus_flags_to_events(DBusWatch *bus_watch);
	159	unsigned bus_events_to_flags(uint32_t events);
	160
8d0e38a2 LP	161	int bus_parse_strv(DBusMessage m, char **_l);
	162	int bus_parse_strv_iter(DBusMessageIter iter, char **_l);
	163
9a1ac7b9	164	#endif