5430f7f2bc
We finally got the OK from all contributors with non-trivial commits to relicense systemd from GPL2+ to LGPL2.1+. Some udev bits continue to be GPL2+ for now, but we are looking into relicensing them too, to allow free copy/paste of all code within systemd. The bits that used to be MIT continue to be MIT. The big benefit of the relicensing is that closed source code may now link against libsystemd-login.so and friends.
199 lines
10 KiB
C
199 lines
10 KiB
C
/*-*- 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 Lesser General Public License as published by
|
|
the Free Software Foundation; either version 2.1 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
|
|
Lesser General Public License for more details.
|
|
|
|
You should have received a copy of the GNU Lesser 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, void *data);
|
|
|
|
typedef struct BusProperty {
|
|
const char *property; /* name of the property */
|
|
BusPropertyCallback append; /* Function that is called to serialize this property */
|
|
const char *signature;
|
|
const uint16_t offset; /* Offset from BusBoundProperties::base address to the property data.
|
|
* uint16_t is sufficient, because we have no structs too big.
|
|
* -Werror=overflow will catch it if this does not hold. */
|
|
bool indirect; /* data is indirect, ie. not base+offset, but *(base+offset) */
|
|
BusPropertySetCallback set; /* Optional: Function that is called to set this property */
|
|
} BusProperty;
|
|
|
|
typedef struct BusBoundProperties {
|
|
const char *interface; /* interface of the properties */
|
|
const BusProperty *properties; /* array of properties, ended by a NULL-filled element */
|
|
const void *const base; /* base pointer to which the offset must be added to reach data */
|
|
} BusBoundProperties;
|
|
|
|
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 BusBoundProperties *bound_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_tristate_false(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; \
|
|
}
|
|
|
|
#define DEFINE_BUS_PROPERTY_SET_ENUM(function,name,type) \
|
|
int function(DBusMessageIter *i, const char *property, void *data) { \
|
|
const char *value; \
|
|
type *field = data; \
|
|
\
|
|
assert(i); \
|
|
assert(property); \
|
|
\
|
|
dbus_message_iter_get_basic(i, &value); \
|
|
\
|
|
*field = name##_from_string(value); \
|
|
\
|
|
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);
|
|
|
|
int bus_append_strv_iter(DBusMessageIter *iter, char **l);
|
|
|
|
int bus_iter_get_basic_and_next(DBusMessageIter *iter, int type, void *data, bool next);
|
|
|
|
int generic_print_property(const char *name, DBusMessageIter *iter, bool all);
|
|
|
|
void bus_async_unregister_and_exit(DBusConnection *bus, const char *name);
|
|
|
|
DBusHandlerResult bus_exit_idle_filter(DBusConnection *bus, DBusMessage *m, void *userdata);
|
|
|
|
#endif
|