include/dbus.h

   1 /*
   2  *
   3  *  Connection Manager
   4  *
   5  *  Copyright (C) 2007-2012  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 #ifndef __CONNMAN_DBUS_H
  23 #define __CONNMAN_DBUS_H
  24
  25 #include <dbus/dbus.h>
  26
  27 #ifdef __cplusplus
  28 extern "C" {
  29 #endif
  30
  31 #define CONNMAN_SERVICE                 "net.connman"
  32 #define CONNMAN_PATH                    "/net/connman"
  33
  34 #define CONNMAN_ERROR_INTERFACE         CONNMAN_SERVICE ".Error"
  35 #define CONNMAN_AGENT_INTERFACE         CONNMAN_SERVICE ".Agent"
  36 #define CONNMAN_COUNTER_INTERFACE       CONNMAN_SERVICE ".Counter"
  37
  38 #define CONNMAN_MANAGER_INTERFACE       CONNMAN_SERVICE ".Manager"
  39 #define CONNMAN_MANAGER_PATH            "/"
  40
  41 #define CONNMAN_CLOCK_INTERFACE         CONNMAN_SERVICE ".Clock"
  42 #define CONNMAN_TASK_INTERFACE          CONNMAN_SERVICE ".Task"
  43 #define CONNMAN_SERVICE_INTERFACE       CONNMAN_SERVICE ".Service"
  44 #define CONNMAN_TECHNOLOGY_INTERFACE    CONNMAN_SERVICE ".Technology"
  45 #define CONNMAN_SESSION_INTERFACE       CONNMAN_SERVICE ".Session"
  46 #define CONNMAN_NOTIFICATION_INTERFACE  CONNMAN_SERVICE ".Notification"
  47 #define CONNMAN_PEER_INTERFACE          CONNMAN_SERVICE ".Peer"
  48 #if defined TIZEN_EXT_WIFI_MESH
  49 #define CONNMAN_MESH_INTERFACE          CONNMAN_SERVICE ".Mesh"
  50 #endif
  51
  52 #define CONNMAN_PRIVILEGE_MODIFY        1
  53 #define CONNMAN_PRIVILEGE_SECRET        2
  54
  55 typedef void (* connman_dbus_append_cb_t) (DBusMessageIter *iter,
  56                                                         void *user_data);
  57
  58 DBusConnection *connman_dbus_get_connection(void);
  59
  60 void connman_dbus_property_append_basic(DBusMessageIter *iter,
  61                                         const char *key, int type, void *val);
  62 void connman_dbus_property_append_dict(DBusMessageIter *iter, const char *key,
  63                         connman_dbus_append_cb_t function, void *user_data);
  64 void connman_dbus_property_append_array(DBusMessageIter *iter,
  65                                                 const char *key, int type,
  66                         connman_dbus_append_cb_t function, void *user_data);
  67 void connman_dbus_property_append_fixed_array(DBusMessageIter *iter,
  68                                 const char *key, int type, void *val, int len);
  69
  70 dbus_bool_t connman_dbus_property_changed_basic(const char *path,
  71                                 const char *interface, const char *key,
  72                                                         int type, void *val);
  73 dbus_bool_t connman_dbus_property_changed_dict(const char *path,
  74                                 const char *interface, const char *key,
  75                         connman_dbus_append_cb_t function, void *user_data);
  76 dbus_bool_t connman_dbus_property_changed_array(const char *path,
  77                         const char *interface, const char *key, int type,
  78                         connman_dbus_append_cb_t function, void *user_data);
  79
  80 dbus_bool_t connman_dbus_setting_changed_basic(const char *owner,
  81                                 const char *path, const char *key,
  82                                 int type, void *val);
  83 dbus_bool_t connman_dbus_setting_changed_dict(const char *owner,
  84                                 const char *path, const char *key,
  85                                 connman_dbus_append_cb_t function,
  86                                 void *user_data);
  87 dbus_bool_t connman_dbus_setting_changed_array(const char *owner,
  88                                 const char *path, const char *key, int type,
  89                                 connman_dbus_append_cb_t function,
  90                                 void *user_data);
  91
  92 static inline void connman_dbus_dict_open(DBusMessageIter *iter,
  93                                                         DBusMessageIter *dict)
  94 {
  95         dbus_message_iter_open_container(iter, DBUS_TYPE_ARRAY,
  96                         DBUS_DICT_ENTRY_BEGIN_CHAR_AS_STRING
  97                         DBUS_TYPE_STRING_AS_STRING DBUS_TYPE_VARIANT_AS_STRING
  98                         DBUS_DICT_ENTRY_END_CHAR_AS_STRING, dict);
  99 }
 100
 101 static inline void connman_dbus_dict_open_variant(DBusMessageIter *iter,
 102                                                         DBusMessageIter *dict)
 103 {
 104         dbus_message_iter_open_container(iter, DBUS_TYPE_VARIANT,
 105                         DBUS_TYPE_ARRAY_AS_STRING
 106                         DBUS_DICT_ENTRY_BEGIN_CHAR_AS_STRING
 107                         DBUS_TYPE_STRING_AS_STRING DBUS_TYPE_VARIANT_AS_STRING
 108                         DBUS_DICT_ENTRY_END_CHAR_AS_STRING, dict);
 109 }
 110
 111 static inline void connman_dbus_array_open(DBusMessageIter *iter,
 112                                                         DBusMessageIter *dict)
 113 {
 114         dbus_message_iter_open_container(iter, DBUS_TYPE_VARIANT,
 115                         DBUS_TYPE_ARRAY_AS_STRING
 116                         DBUS_TYPE_STRING_AS_STRING,
 117                         dict);
 118 }
 119
 120 static inline void connman_dbus_dict_close(DBusMessageIter *iter,
 121                                                         DBusMessageIter *dict)
 122 {
 123         dbus_message_iter_close_container(iter, dict);
 124 }
 125
 126 static inline void connman_dbus_dict_append_basic(DBusMessageIter *dict,
 127                                         const char *key, int type, void *val)
 128 {
 129         DBusMessageIter entry;
 130
 131         dbus_message_iter_open_container(dict, DBUS_TYPE_DICT_ENTRY,
 132                                                                 NULL, &entry);
 133         connman_dbus_property_append_basic(&entry, key, type, val);
 134         dbus_message_iter_close_container(dict, &entry);
 135 }
 136
 137 static inline void connman_dbus_dict_append_dict(DBusMessageIter *dict,
 138                         const char *key, connman_dbus_append_cb_t function,
 139                                                         void *user_data)
 140 {
 141         DBusMessageIter entry;
 142
 143         dbus_message_iter_open_container(dict, DBUS_TYPE_DICT_ENTRY,
 144                                                                 NULL, &entry);
 145         connman_dbus_property_append_dict(&entry, key, function, user_data);
 146         dbus_message_iter_close_container(dict, &entry);
 147 }
 148
 149 static inline void connman_dbus_dict_append_array(DBusMessageIter *dict,
 150                 const char *key, int type, connman_dbus_append_cb_t function,
 151                                                         void *user_data)
 152 {
 153         DBusMessageIter entry;
 154
 155         dbus_message_iter_open_container(dict, DBUS_TYPE_DICT_ENTRY,
 156                                                                 NULL, &entry);
 157         connman_dbus_property_append_array(&entry, key,
 158                                                 type, function, user_data);
 159         dbus_message_iter_close_container(dict, &entry);
 160 }
 161
 162 static inline void connman_dbus_dict_append_fixed_array(DBusMessageIter *dict,
 163                                 const char *key, int type, void *val, int len)
 164 {
 165         DBusMessageIter entry;
 166
 167         dbus_message_iter_open_container(dict, DBUS_TYPE_DICT_ENTRY,
 168                                                                 NULL, &entry);
 169         connman_dbus_property_append_fixed_array(&entry, key, type, val, len);
 170         dbus_message_iter_close_container(dict, &entry);
 171 }
 172
 173 dbus_bool_t connman_dbus_validate_ident(const char *ident);
 174 char *connman_dbus_encode_string(const char *value);
 175
 176 typedef void (* connman_dbus_get_connection_unix_user_cb_t) (unsigned int uid,
 177                                                 void *user_data, int err);
 178
 179 int connman_dbus_get_connection_unix_user(DBusConnection *connection,
 180                                const char *bus_name,
 181                                connman_dbus_get_connection_unix_user_cb_t func,
 182                                void *user_data);
 183
 184 typedef void (* connman_dbus_get_context_cb_t) (const unsigned char *context,
 185                                                 void *user_data, int err);
 186
 187 int connman_dbus_get_selinux_context(DBusConnection *connection,
 188                                const char *service,
 189                                connman_dbus_get_context_cb_t func,
 190                                void *user_data);
 191
 192 void connman_dbus_reply_pending(DBusMessage *pending,
 193                                         int error, const char *path);
 194
 195 #ifdef __cplusplus
 196 }
 197 #endif
 198
 199 #endif /* __CONNMAN_DBUS_H */