include/dbus.h

   1 /*
   2  *
   3  *  neard - Near Field Communication manager
   4  *
   5  *  Copyright (C) 2011  Intel Corporation. All rights reserved.
   6  *
   7  *  This program is free software; you can redistribute it and/or modify
   8  *  it under the terms of the GNU General Public License version 2 as
   9  *  published by the Free Software Foundation.
  10  *
  11  *  This program is distributed in the hope that it will be useful,
  12  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14  *  GNU General Public License for more details.
  15  *
  16  *  You should have received a copy of the GNU General Public License
  17  *  along with this program; if not, write to the Free Software
  18  *  Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
  19  *
  20  */
  21
  22 #include <dbus/dbus.h>
  23
  24 #define NFC_SERVICE     "org.neard"
  25 #define NFC_PATH        "/org/neard"
  26
  27 #define NFC_ERROR_INTERFACE     NFC_SERVICE ".Error"
  28
  29 #define NFC_MANAGER_INTERFACE   NFC_SERVICE ".Manager"
  30 #define NFC_MANAGER_PATH        "/"
  31
  32 #define NFC_ADAPTER_INTERFACE   NFC_SERVICE ".Adapter"
  33 #define NFC_TARGET_INTERFACE    NFC_SERVICE ".Target"
  34 #define NFC_RECORD_INTERFACE    NFC_SERVICE ".Record"
  35
  36 typedef void (* near_dbus_append_cb_t) (DBusMessageIter *iter,
  37                                                         void *user_data);
  38
  39 DBusConnection *near_dbus_get_connection(void);
  40
  41 void near_dbus_property_append_basic(DBusMessageIter *iter,
  42                                         const char *key, int type, void *val);
  43 void near_dbus_property_append_dict(DBusMessageIter *iter, const char *key,
  44                         near_dbus_append_cb_t function, void *user_data);
  45 void near_dbus_property_append_array(DBusMessageIter *iter,
  46                                                 const char *key, int type,
  47                         near_dbus_append_cb_t function, void *user_data);
  48 void near_dbus_property_append_fixed_array(DBusMessageIter *iter,
  49                                 const char *key, int type, void *val, int len);
  50
  51 dbus_bool_t near_dbus_property_changed_basic(const char *path,
  52                                 const char *interface, const char *key,
  53                                                         int type, void *val);
  54 dbus_bool_t near_dbus_property_changed_dict(const char *path,
  55                                 const char *interface, const char *key,
  56                         near_dbus_append_cb_t function, void *user_data);
  57 dbus_bool_t near_dbus_property_changed_array(const char *path,
  58                         const char *interface, const char *key, int type,
  59                         near_dbus_append_cb_t function, void *user_data);
  60
  61 dbus_bool_t near_dbus_setting_changed_basic(const char *owner,
  62                                 const char *path, const char *key,
  63                                 int type, void *val);
  64 dbus_bool_t near_dbus_setting_changed_dict(const char *owner,
  65                                 const char *path, const char *key,
  66                                 near_dbus_append_cb_t function,
  67                                 void *user_data);
  68 dbus_bool_t near_dbus_setting_changed_array(const char *owner,
  69                                 const char *path, const char *key, int type,
  70                                 near_dbus_append_cb_t function,
  71                                 void *user_data);
  72
  73 static inline void near_dbus_dict_open(DBusMessageIter *iter,
  74                                                         DBusMessageIter *dict)
  75 {
  76         dbus_message_iter_open_container(iter, DBUS_TYPE_ARRAY,
  77                         DBUS_DICT_ENTRY_BEGIN_CHAR_AS_STRING
  78                         DBUS_TYPE_STRING_AS_STRING DBUS_TYPE_VARIANT_AS_STRING
  79                         DBUS_DICT_ENTRY_END_CHAR_AS_STRING, dict);
  80 }
  81
  82 static inline void near_dbus_dict_close(DBusMessageIter *iter,
  83                                                         DBusMessageIter *dict)
  84 {
  85         dbus_message_iter_close_container(iter, dict);
  86 }
  87
  88 static inline void near_dbus_dict_append_basic(DBusMessageIter *dict,
  89                                         const char *key, int type, void *val)
  90 {
  91         DBusMessageIter entry;
  92
  93         dbus_message_iter_open_container(dict, DBUS_TYPE_DICT_ENTRY,
  94                                                                 NULL, &entry);
  95         near_dbus_property_append_basic(&entry, key, type, val);
  96         dbus_message_iter_close_container(dict, &entry);
  97 }
  98
  99 static inline void near_dbus_dict_append_dict(DBusMessageIter *dict,
 100                         const char *key, near_dbus_append_cb_t function,
 101                                                         void *user_data)
 102 {
 103         DBusMessageIter entry;
 104
 105         dbus_message_iter_open_container(dict, DBUS_TYPE_DICT_ENTRY,
 106                                                                 NULL, &entry);
 107         near_dbus_property_append_dict(&entry, key, function, user_data);
 108         dbus_message_iter_close_container(dict, &entry);
 109 }
 110
 111 static inline void near_dbus_dict_append_array(DBusMessageIter *dict,
 112                 const char *key, int type, near_dbus_append_cb_t function,
 113                                                         void *user_data)
 114 {
 115         DBusMessageIter entry;
 116
 117         dbus_message_iter_open_container(dict, DBUS_TYPE_DICT_ENTRY,
 118                                                                 NULL, &entry);
 119         near_dbus_property_append_array(&entry, key,
 120                                                 type, function, user_data);
 121         dbus_message_iter_close_container(dict, &entry);
 122 }
 123
 124 static inline void near_dbus_dict_append_fixed_array(DBusMessageIter *dict,
 125                                 const char *key, int type, void *val, int len)
 126 {
 127         DBusMessageIter entry;
 128
 129         dbus_message_iter_open_container(dict, DBUS_TYPE_DICT_ENTRY,
 130                                                                 NULL, &entry);
 131         near_dbus_property_append_fixed_array(&entry, key, type, val, len);
 132         dbus_message_iter_close_container(dict, &entry);
 133 }
 134
 135 dbus_bool_t near_dbus_validate_ident(const char *ident);
 136 char *near_dbus_encode_string(const char *value);