src/dbus.h

   1 /*-*- Mode: C; c-basic-offset: 8; indent-tabs-mode: nil -*-*/
   2
   3 #ifndef foodbushfoo
   4 #define foodbushfoo
   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
  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 #include "manager.h"
  36
  37 typedef int (*BusPropertyCallback)(Manager *m, DBusMessageIter *iter, const char *property, void *data);
  38 typedef int (*BusPropertySetCallback)(Manager *m, DBusMessageIter *iter, const char *property);
  39
  40 typedef struct BusProperty {
  41         const char *interface;           /* interface of the property */
  42         const char *property;            /* name of the property */
  43         BusPropertyCallback append;      /* Function that is called to serialize this property */
  44         const char *signature;
  45         const void *data;                /* The data of this property */
  46         BusPropertySetCallback set;      /* Function that is called to set this property */
  47 } BusProperty;
  48
  49 #define BUS_PROPERTIES_INTERFACE                                        \
  50         " <interface name=\"org.freedesktop.DBus.Properties\">\n"       \
  51         "  <method name=\"Get\">\n"                                     \
  52         "   <arg name=\"interface\" direction=\"in\" type=\"s\"/>\n"    \
  53         "   <arg name=\"property\" direction=\"in\" type=\"s\"/>\n"     \
  54         "   <arg name=\"value\" direction=\"out\" type=\"v\"/>\n"       \
  55         "  </method>\n"                                                 \
  56         "  <method name=\"GetAll\">\n"                                  \
  57         "   <arg name=\"interface\" direction=\"in\" type=\"s\"/>\n"    \
  58         "   <arg name=\"properties\" direction=\"out\" type=\"a{sv}\"/>\n" \
  59         "  </method>\n"                                                 \
  60         "  <method name=\"Set\">\n"                                     \
  61         "   <arg name=\"interface\" direction=\"in\" type=\"s\"/>\n"    \
  62         "   <arg name=\"property\" direction=\"in\" type=\"s\"/>\n"     \
  63         "   <arg name=\"value\" direction=\"in\" type=\"v\"/>\n"       \
  64         "  </method>\n"                                                 \
  65         "  <signal name=\"PropertiesChanged\">\n"                       \
  66         "   <arg type=\"s\" name=\"interface\"/>\n"                     \
  67         "   <arg type=\"a{sv}\" name=\"changed_properties\"/>\n"        \
  68         "   <arg type=\"as\" name=\"invalidated_properties\"/>\n"       \
  69         "  </signal>\n"                                                 \
  70         " </interface>\n"
  71
  72 #define BUS_INTROSPECTABLE_INTERFACE                                    \
  73         " <interface name=\"org.freedesktop.DBus.Introspectable\">\n"   \
  74         "  <method name=\"Introspect\">\n"                              \
  75         "   <arg name=\"data\" type=\"s\" direction=\"out\"/>\n"        \
  76         "  </method>\n"                                                 \
  77         " </interface>\n"
  78
  79 #define BUS_PEER_INTERFACE                                              \
  80         "<interface name=\"org.freedesktop.DBus.Peer\">\n"              \
  81         " <method name=\"Ping\"/>\n"                                    \
  82         " <method name=\"GetMachineId\">\n"                             \
  83         "  <arg type=\"s\" name=\"machine_uuid\" direction=\"out\"/>\n" \
  84         " </method>\n"                                                  \
  85         "</interface>\n"
  86
  87 int bus_init(Manager *m, bool try_bus_connect);
  88 void bus_done(Manager *m);
  89
  90 unsigned bus_dispatch(Manager *m);
  91
  92 void bus_watch_event(Manager *m, Watch *w, int events);
  93 void bus_timeout_event(Manager *m, Watch *w, int events);
  94
  95 int bus_query_pid(Manager *m, const char *name);
  96
  97 DBusHandlerResult bus_default_message_handler(Manager *m, DBusConnection *c, DBusMessage *message, const char* introspection, const BusProperty *properties);
  98 DBusHandlerResult bus_send_error_reply(Manager *m, DBusConnection *c, DBusMessage *message, DBusError *bus_error, int error);
  99
 100 int bus_broadcast(Manager *m, DBusMessage *message);
 101
 102 int bus_property_append_string(Manager *m, DBusMessageIter *i, const char *property, void *data);
 103 int bus_property_append_strv(Manager *m, DBusMessageIter *i, const char *property, void *data);
 104 int bus_property_append_bool(Manager *m, DBusMessageIter *i, const char *property, void *data);
 105 int bus_property_append_int32(Manager *m, DBusMessageIter *i, const char *property, void *data);
 106 int bus_property_append_uint32(Manager *m, DBusMessageIter *i, const char *property, void *data);
 107 int bus_property_append_uint64(Manager *m, DBusMessageIter *i, const char *property, void *data);
 108 int bus_property_append_size(Manager *m, DBusMessageIter *i, const char *property, void *data);
 109 int bus_property_append_ul(Manager *m, DBusMessageIter *i, const char *property, void *data);
 110
 111 #define bus_property_append_int bus_property_append_int32
 112 #define bus_property_append_pid bus_property_append_uint32
 113 #define bus_property_append_mode bus_property_append_uint32
 114 #define bus_property_append_unsigned bus_property_append_uint32
 115 #define bus_property_append_usec bus_property_append_uint64
 116
 117 #define DEFINE_BUS_PROPERTY_APPEND_ENUM(function,name,type)             \
 118         int function(Manager *m, DBusMessageIter *i, const char *property, void *data) { \
 119                 const char *value;                                      \
 120                 type *field = data;                                     \
 121                                                                         \
 122                 assert(m);                                              \
 123                 assert(i);                                              \
 124                 assert(property);                                       \
 125                                                                         \
 126                 value = name##_to_string(*field);                       \
 127                                                                         \
 128                 if (!dbus_message_iter_append_basic(i, DBUS_TYPE_STRING, &value)) \
 129                         return -ENOMEM;                                 \
 130                                                                         \
 131                 return 0;                                               \
 132         }
 133
 134 int bus_parse_strv(DBusMessage *m, char ***_l);
 135
 136 bool bus_has_subscriber(Manager *m);
 137 bool bus_connection_has_subscriber(Manager *m, DBusConnection *c);
 138
 139 DBusMessage* bus_properties_changed_new(const char *path, const char *interface, const char *properties);
 140
 141 #define BUS_CONNECTION_SUBSCRIBED(m, c) dbus_connection_get_data((c), (m)->subscribed_data_slot)
 142 #define BUS_PENDING_CALL_NAME(m, p) dbus_pending_call_get_data((p), (m)->name_data_slot)
 143
 144 extern const char * const bus_interface_table[];
 145
 146 #endif