src/pulsecore/dbus-util.h

   1 #ifndef foodbusutilhfoo
   2 #define foodbusutilhfoo
   3
   4 /***
   5   This file is part of PulseAudio.
   6
   7   Copyright 2006 Shams E. King
   8
   9   PulseAudio is free software; you can redistribute it and/or modify
  10   it under the terms of the GNU Lesser General Public License as published
  11   by the Free Software Foundation; either version 2.1 of the License,
  12   or (at your option) any later version.
  13
  14   PulseAudio is distributed in the hope that it will be useful, but
  15   WITHOUT ANY WARRANTY; without even the implied warranty of
  16   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  17   General Public License for more details.
  18
  19   You should have received a copy of the GNU Lesser General Public License
  20   along with PulseAudio; if not, write to the Free Software
  21   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
  22   USA.
  23 ***/
  24
  25 #include <dbus/dbus.h>
  26
  27 #include <pulse/gccmacro.h>
  28 #include <pulse/mainloop-api.h>
  29 #include <pulse/proplist.h>
  30
  31 #include <pulsecore/llist.h>
  32
  33 /* A wrap connection is not shared or refcounted, it is available in client side */
  34 typedef struct pa_dbus_wrap_connection pa_dbus_wrap_connection;
  35
  36 pa_dbus_wrap_connection* pa_dbus_wrap_connection_new(pa_mainloop_api *mainloop, pa_bool_t use_rtclock, DBusBusType type, DBusError *error);
  37 pa_dbus_wrap_connection* pa_dbus_wrap_connection_new_from_existing(
  38         pa_mainloop_api *mainloop,
  39         pa_bool_t use_rtclock,
  40         DBusConnection *conn);
  41 void pa_dbus_wrap_connection_free(pa_dbus_wrap_connection* conn);
  42
  43 DBusConnection* pa_dbus_wrap_connection_get(pa_dbus_wrap_connection *conn);
  44
  45 int pa_dbus_add_matches(DBusConnection *c, DBusError *error, ...) PA_GCC_SENTINEL;
  46 void pa_dbus_remove_matches(DBusConnection *c,  ...) PA_GCC_SENTINEL;
  47
  48 typedef struct pa_dbus_pending pa_dbus_pending;
  49
  50 struct pa_dbus_pending {
  51     DBusConnection *connection;
  52     DBusMessage *message;
  53     DBusPendingCall *pending;
  54
  55     void *context_data;
  56     void *call_data;
  57
  58     PA_LLIST_FIELDS(pa_dbus_pending);
  59 };
  60
  61 pa_dbus_pending *pa_dbus_pending_new(DBusConnection *c, DBusMessage *m, DBusPendingCall *pending, void *context_data, void *call_data);
  62 void pa_dbus_pending_free(pa_dbus_pending *p);
  63
  64 /* Sync up a list of pa_dbus_pending_call objects */
  65 void pa_dbus_sync_pending_list(pa_dbus_pending **p);
  66
  67 /* Free up a list of pa_dbus_pending_call objects */
  68 void pa_dbus_free_pending_list(pa_dbus_pending **p);
  69
  70 /* When receiving a DBusMessage with type DBUS_MESSAGE_TYPE_ERROR, the
  71  * DBusMessage may or may not contain an error message (a human-readable
  72  * explanation of what went wrong). Extracting the error message from the
  73  * DBusMessage object is a bit tedious, so here's a helper function that does
  74  * that. If the DBusMessage doesn't contain any error message,
  75  * "<no explanation>" is returned. */
  76 const char *pa_dbus_get_error_message(DBusMessage *m);
  77
  78 /* Sends an error message as the reply to the given message. */
  79 void pa_dbus_send_error(
  80         DBusConnection *c,
  81         DBusMessage *in_reply_to,
  82         const char *name,
  83         const char *format, ...) PA_GCC_PRINTF_ATTR(4, 5);
  84
  85 void pa_dbus_send_empty_reply(DBusConnection *c, DBusMessage *in_reply_to);
  86 void pa_dbus_send_basic_value_reply(DBusConnection *c, DBusMessage *in_reply_to, int type, void *data);
  87 void pa_dbus_send_basic_variant_reply(DBusConnection *c, DBusMessage *in_reply_to, int type, void *data);
  88 void pa_dbus_send_basic_array_variant_reply(
  89         DBusConnection *c,
  90         DBusMessage *in_reply_to,
  91         int item_type,
  92         void *array,
  93         unsigned n);
  94 void pa_dbus_send_proplist_variant_reply(DBusConnection *c, DBusMessage *in_reply_to, pa_proplist *proplist);
  95
  96 void pa_dbus_append_basic_array(DBusMessageIter *iter, int item_type, const void *array, unsigned n);
  97 void pa_dbus_append_basic_array_variant(DBusMessageIter *iter, int item_type, const void *array, unsigned n);
  98 void pa_dbus_append_basic_variant(DBusMessageIter *iter, int type, void *data);
  99 void pa_dbus_append_basic_variant_dict_entry(DBusMessageIter *dict_iter, const char *key, int type, void *data);
 100 void pa_dbus_append_basic_array_variant_dict_entry(
 101         DBusMessageIter *dict_iter,
 102         const char *key,
 103         int item_type,
 104         const void *array,
 105         unsigned n);
 106 void pa_dbus_append_proplist(DBusMessageIter *iter, pa_proplist *proplist);
 107 void pa_dbus_append_proplist_variant(DBusMessageIter *iter, pa_proplist *proplist);
 108 void pa_dbus_append_proplist_variant_dict_entry(DBusMessageIter *dict_iter, const char *key, pa_proplist *proplist);
 109
 110 /* Returns a new proplist that the caller has to free. If the proplist contains
 111  * invalid keys, an error reply is sent and NULL is returned. The iterator must
 112  * point to "a{say}" element. This function calls dbus_message_iter_next(iter)
 113  * before returning. */
 114 pa_proplist *pa_dbus_get_proplist_arg(DBusConnection *c, DBusMessage *msg, DBusMessageIter *iter);
 115
 116 #endif