2 * wpa_supplicant - D-Bus introspection
3 * Copyright (c) 2006, Dan Williams <dcbw@redhat.com> and Red Hat, Inc.
4 * Copyright (c) 2009, Witold Sowa <witold.sowa@gmail.com>
5 * Copyright (c) 2010, Jouni Malinen <j@w1.fi>
7 * This software may be distributed under the terms of the BSD license.
8 * See README for more details.
11 #include "utils/includes.h"
13 #include "utils/common.h"
14 #include "utils/list.h"
15 #include "utils/wpabuf.h"
16 #include "dbus_common_i.h"
17 #include "dbus_new_helpers.h"
27 static struct interfaces * add_interface(struct dl_list *list,
28 const char *dbus_interface)
30 struct interfaces *iface;
32 dl_list_for_each(iface, list, struct interfaces, list) {
33 if (os_strcmp(iface->dbus_interface, dbus_interface) == 0)
34 return iface; /* already in the list */
37 iface = os_zalloc(sizeof(struct interfaces));
40 iface->xml = wpabuf_alloc(6000);
41 if (iface->xml == NULL) {
45 wpabuf_printf(iface->xml, "<interface name=\"%s\">", dbus_interface);
46 dl_list_add_tail(list, &iface->list);
47 iface->dbus_interface = os_strdup(dbus_interface);
52 static void add_arg(struct wpabuf *xml, const char *name, const char *type,
53 const char *direction)
55 wpabuf_printf(xml, "<arg name=\"%s\"", name);
57 wpabuf_printf(xml, " type=\"%s\"", type);
59 wpabuf_printf(xml, " direction=\"%s\"", direction);
60 wpabuf_put_str(xml, "/>");
64 static void add_entry(struct wpabuf *xml, const char *type, const char *name,
65 const struct wpa_dbus_argument *args, int include_dir)
67 const struct wpa_dbus_argument *arg;
69 if (args == NULL || args->name == NULL) {
70 wpabuf_printf(xml, "<%s name=\"%s\"/>", type, name);
73 wpabuf_printf(xml, "<%s name=\"%s\">", type, name);
74 for (arg = args; arg && arg->name; arg++) {
75 add_arg(xml, arg->name, arg->type,
76 include_dir ? (arg->dir == ARG_IN ? "in" : "out") :
79 wpabuf_printf(xml, "</%s>", type);
83 static void add_property(struct wpabuf *xml,
84 const struct wpa_dbus_property_desc *dsc)
86 wpabuf_printf(xml, "<property name=\"%s\" type=\"%s\" "
88 dsc->dbus_property, dsc->type,
89 dsc->getter ? "read" : "",
90 dsc->setter ? "write" : "");
94 static void extract_interfaces_methods(
95 struct dl_list *list, const struct wpa_dbus_method_desc *methods)
97 const struct wpa_dbus_method_desc *dsc;
98 struct interfaces *iface;
100 for (dsc = methods; dsc && dsc->dbus_method; dsc++) {
101 iface = add_interface(list, dsc->dbus_interface);
103 add_entry(iface->xml, "method", dsc->dbus_method,
109 static void extract_interfaces_signals(
110 struct dl_list *list, const struct wpa_dbus_signal_desc *signals)
112 const struct wpa_dbus_signal_desc *dsc;
113 struct interfaces *iface;
115 for (dsc = signals; dsc && dsc->dbus_signal; dsc++) {
116 iface = add_interface(list, dsc->dbus_interface);
118 add_entry(iface->xml, "signal", dsc->dbus_signal,
124 static void extract_interfaces_properties(
125 struct dl_list *list, const struct wpa_dbus_property_desc *properties)
127 const struct wpa_dbus_property_desc *dsc;
128 struct interfaces *iface;
130 for (dsc = properties; dsc && dsc->dbus_property; dsc++) {
131 iface = add_interface(list, dsc->dbus_interface);
133 add_property(iface->xml, dsc);
139 * extract_interfaces - Extract interfaces from methods, signals and props
140 * @list: Interface list to be filled
141 * @obj_dsc: Description of object from which interfaces will be extracted
143 * Iterates over all methods, signals, and properties registered with an
144 * object and collects all declared DBus interfaces and create interfaces'
145 * node in XML root node for each. Returned list elements contain interface
146 * name and XML node of corresponding interface.
148 static void extract_interfaces(struct dl_list *list,
149 struct wpa_dbus_object_desc *obj_dsc)
151 extract_interfaces_methods(list, obj_dsc->methods);
152 extract_interfaces_signals(list, obj_dsc->signals);
153 extract_interfaces_properties(list, obj_dsc->properties);
157 static void add_interfaces(struct dl_list *list, struct wpabuf *xml)
159 struct interfaces *iface, *n;
161 dl_list_for_each_safe(iface, n, list, struct interfaces, list) {
162 if (wpabuf_len(iface->xml) + 20 < wpabuf_tailroom(xml)) {
163 wpabuf_put_buf(xml, iface->xml);
164 wpabuf_put_str(xml, "</interface>");
166 wpa_printf(MSG_DEBUG,
167 "dbus: Not enough room for add_interfaces inspect data: tailroom %u, add %u",
168 (unsigned int) wpabuf_tailroom(xml),
169 (unsigned int) wpabuf_len(iface->xml));
171 dl_list_del(&iface->list);
172 wpabuf_free(iface->xml);
173 os_free(iface->dbus_interface);
179 static void add_child_nodes(struct wpabuf *xml, DBusConnection *con,
185 /* add child nodes to introspection tree */
186 dbus_connection_list_registered(con, path, &children);
187 for (i = 0; children[i]; i++)
188 wpabuf_printf(xml, "<node name=\"%s\"/>", children[i]);
189 dbus_free_string_array(children);
193 static void add_introspectable_interface(struct wpabuf *xml)
195 wpabuf_printf(xml, "<interface name=\"%s\">"
196 "<method name=\"%s\">"
197 "<arg name=\"data\" type=\"s\" direction=\"out\"/>"
200 WPA_DBUS_INTROSPECTION_INTERFACE,
201 WPA_DBUS_INTROSPECTION_METHOD);
205 static void add_properties_interface(struct wpabuf *xml)
207 wpabuf_printf(xml, "<interface name=\"%s\">",
208 WPA_DBUS_PROPERTIES_INTERFACE);
210 wpabuf_printf(xml, "<method name=\"%s\">", WPA_DBUS_PROPERTIES_GET);
211 add_arg(xml, "interface", "s", "in");
212 add_arg(xml, "propname", "s", "in");
213 add_arg(xml, "value", "v", "out");
214 wpabuf_put_str(xml, "</method>");
216 wpabuf_printf(xml, "<method name=\"%s\">", WPA_DBUS_PROPERTIES_GETALL);
217 add_arg(xml, "interface", "s", "in");
218 add_arg(xml, "props", "a{sv}", "out");
219 wpabuf_put_str(xml, "</method>");
221 wpabuf_printf(xml, "<method name=\"%s\">", WPA_DBUS_PROPERTIES_SET);
222 add_arg(xml, "interface", "s", "in");
223 add_arg(xml, "propname", "s", "in");
224 add_arg(xml, "value", "v", "in");
225 wpabuf_put_str(xml, "</method>");
227 wpabuf_put_str(xml, "</interface>");
231 static void add_wpas_interfaces(struct wpabuf *xml,
232 struct wpa_dbus_object_desc *obj_dsc)
234 struct dl_list ifaces;
236 dl_list_init(&ifaces);
237 extract_interfaces(&ifaces, obj_dsc);
238 add_interfaces(&ifaces, xml);
243 * wpa_dbus_introspect - Responds for Introspect calls on object
244 * @message: Message with Introspect call
245 * @obj_dsc: Object description on which Introspect was called
246 * Returns: Message with introspection result XML string as only argument
248 * Iterates over all methods, signals and properties registered with
249 * object and generates introspection data for the object as XML string.
251 DBusMessage * wpa_dbus_introspect(DBusMessage *message,
252 struct wpa_dbus_object_desc *obj_dsc)
258 xml = wpabuf_alloc(10000);
262 wpabuf_put_str(xml, "<?xml version=\"1.0\"?>\n");
263 wpabuf_put_str(xml, DBUS_INTROSPECT_1_0_XML_DOCTYPE_DECL_NODE);
264 wpabuf_put_str(xml, "<node>");
266 add_introspectable_interface(xml);
267 add_properties_interface(xml);
268 add_wpas_interfaces(xml, obj_dsc);
269 add_child_nodes(xml, obj_dsc->connection,
270 dbus_message_get_path(message));
272 wpabuf_put_str(xml, "</node>\n");
274 reply = dbus_message_new_method_return(message);
276 const char *intro_str = wpabuf_head(xml);
278 dbus_message_append_args(reply, DBUS_TYPE_STRING, &intro_str,