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 /* Sends an error message as the reply to the given message. */
  71 void pa_dbus_send_error(
  72         DBusConnection *c,
  73         DBusMessage *in_reply_to,
  74         const char *name,
  75         const char *format, ...) PA_GCC_PRINTF_ATTR(4, 5);
  76
  77 void pa_dbus_send_empty_reply(DBusConnection *c, DBusMessage *in_reply_to);
  78 void pa_dbus_send_basic_value_reply(DBusConnection *c, DBusMessage *in_reply_to, int type, void *data);
  79 void pa_dbus_send_basic_variant_reply(DBusConnection *c, DBusMessage *in_reply_to, int type, void *data);
  80 void pa_dbus_send_basic_array_variant_reply(
  81         DBusConnection *c,
  82         DBusMessage *in_reply_to,
  83         int item_type,
  84         void *array,
  85         unsigned n);
  86 void pa_dbus_send_proplist_variant_reply(DBusConnection *c, DBusMessage *in_reply_to, pa_proplist *proplist);
  87
  88 void pa_dbus_append_basic_array(DBusMessageIter *iter, int item_type, const void *array, unsigned n);
  89 void pa_dbus_append_basic_array_variant(DBusMessageIter *iter, int item_type, const void *array, unsigned n);
  90 void pa_dbus_append_basic_variant(DBusMessageIter *iter, int type, void *data);
  91 void pa_dbus_append_basic_variant_dict_entry(DBusMessageIter *dict_iter, const char *key, int type, void *data);
  92 void pa_dbus_append_basic_array_variant_dict_entry(
  93         DBusMessageIter *dict_iter,
  94         const char *key,
  95         int item_type,
  96         const void *array,
  97         unsigned n);
  98 void pa_dbus_append_proplist(DBusMessageIter *iter, pa_proplist *proplist);
  99 void pa_dbus_append_proplist_variant(DBusMessageIter *iter, pa_proplist *proplist);
 100 void pa_dbus_append_proplist_variant_dict_entry(DBusMessageIter *dict_iter, const char *key, pa_proplist *proplist);
 101
 102 /* Returns a new proplist that the caller has to free. If the proplist contains
 103  * invalid keys, an error reply is sent and NULL is returned. The iterator must
 104  * point to "a{say}" element. This function calls dbus_message_iter_next(iter)
 105  * before returning. */
 106 pa_proplist *pa_dbus_get_proplist_arg(DBusConnection *c, DBusMessage *msg, DBusMessageIter *iter);
 107
 108 #endif