dbus/helpers.h

   1 /* -*- Mode: C ; c-basic-offset: 2 -*- */
   2 /*
   3  * LADI Session Handler (ladish)
   4  *
   5  * Copyright (C) 2008, 2009 Nedko Arnaudov <nedko@arnaudov.name>
   6  * Copyright (C) 2008 Juuso Alasuutari <juuso.alasuutari@gmail.com>
   7  *
   8  **************************************************************************
   9  * This file contains interface to the D-Bus helpers code
  10  **************************************************************************
  11  *
  12  * Licensed under the Academic Free License version 2.1
  13  *
  14  * LADI Session Handler is free software; you can redistribute it and/or modify
  15  * it under the terms of the GNU General Public License as published by
  16  * the Free Software Foundation; either version 2 of the License, or
  17  * (at your option) any later version.
  18  *
  19  * LADI Session Handler is distributed in the hope that it will be useful,
  20  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  21  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  22  * GNU General Public License for more details.
  23  *
  24  * You should have received a copy of the GNU General Public License
  25  * along with LADI Session Handler. If not, see <http://www.gnu.org/licenses/>
  26  * or write to the Free Software Foundation, Inc.,
  27  * 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  28  */
  29
  30 #ifndef HELPERS_H__6C2107A6_A5E3_4806_869B_4BE609535BA2__INCLUDED
  31 #define HELPERS_H__6C2107A6_A5E3_4806_869B_4BE609535BA2__INCLUDED
  32
  33 #include <dbus/dbus.h>
  34
  35 extern DBusConnection * g_dbus_connection;
  36 extern DBusError g_dbus_error;
  37
  38 bool dbus_iter_get_dict_entry(DBusMessageIter * iter, const char ** key_ptr, void * value_ptr, int * type_ptr, int * size_ptr);
  39 bool dbus_iter_append_variant(DBusMessageIter * iter, int type, const void * arg);
  40 bool dbus_iter_append_dict_entry(DBusMessageIter *iter, int type, const char * key, const void * value, int length);
  41 bool dbus_maybe_add_dict_entry_string(DBusMessageIter *dict_iter_ptr, const char * key, const char * value);
  42 bool dbus_add_dict_entry_uint32(DBusMessageIter * dict_iter_ptr, const char * key, dbus_uint32_t value);
  43 bool dbus_add_dict_entry_bool(DBusMessageIter * dict_iter_ptr, const char * key, dbus_bool_t value);
  44
  45 bool dbus_call(const char * service, const char * object, const char * iface, const char * method, const char * input_signature, ...);
  46
  47 bool
  48 dbus_register_object_signal_handler(
  49   DBusConnection * connection,
  50   const char * service,
  51   const char * object,
  52   const char * iface,
  53   const char * const * signals,
  54   DBusHandleMessageFunction handler,
  55   void * handler_data);
  56
  57 bool
  58 dbus_unregister_object_signal_handler(
  59   DBusConnection * connection,
  60   const char * service,
  61   const char * object,
  62   const char * iface,
  63   const char * const * signals,
  64   DBusHandleMessageFunction handler,
  65   void * handler_data);
  66
  67 struct dbus_signal_hook
  68 {
  69   const char * signal_name;
  70   void (* hook_function)(void * context, DBusMessage * message_ptr);
  71 };
  72
  73 bool
  74 dbus_register_object_signal_hooks(
  75   DBusConnection * connection,
  76   const char * service,
  77   const char * object,
  78   const char * iface,
  79   void * hook_context,
  80   const struct dbus_signal_hook * signal_hooks);
  81
  82 void
  83 dbus_unregister_object_signal_hooks(
  84   DBusConnection * connection,
  85   const char * service,
  86   const char * object,
  87   const char * iface);
  88
  89 bool
  90 dbus_register_service_lifetime_hook(
  91   DBusConnection * connection,
  92   const char * service,
  93   void (* hook_function)(bool appeared));
  94
  95 void
  96 dbus_unregister_service_lifetime_hook(
  97   DBusConnection * connection,
  98   const char * service);
  99
 100 #define DBUS_CALL_DEFAULT_TIMEOUT 1000 // in milliseconds
 101
 102 #include "method.h"
 103 #include "signal.h"
 104 #include "interface.h"
 105 #include "object_path.h"
 106
 107 #endif /* #ifndef HELPERS_H__6C2107A6_A5E3_4806_869B_4BE609535BA2__INCLUDED */