2 * WPA Supplicant / dbus-based control interface
3 * Copyright (c) 2006, Dan Williams <dcbw@redhat.com> and Red Hat, Inc.
5 * This program is free software; you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License version 2 as
7 * published by the Free Software Foundation.
9 * Alternatively, this software may be distributed under the terms of BSD
12 * See README and COPYING for more details.
16 #include <dbus/dbus.h>
20 #include "drivers/driver.h"
22 #include "../config.h"
23 #include "../wpa_supplicant_i.h"
25 #include "dbus_old_handlers.h"
26 #include "dbus_common.h"
27 #include "dbus_common_i.h"
31 * wpas_dbus_decompose_object_path - Decompose an interface object path into parts
32 * @path: The dbus object path
33 * @network: (out) the configured network this object path refers to, if any
34 * @bssid: (out) the scanned bssid this object path refers to, if any
35 * Returns: The object path of the network interface this path refers to
37 * For a given object path, decomposes the object path into object id, network,
38 * and BSSID parts, if those parts exist.
40 char * wpas_dbus_decompose_object_path(const char *path, char **network,
43 const unsigned int dev_path_prefix_len =
44 strlen(WPAS_DBUS_PATH_INTERFACES "/");
48 /* Be a bit paranoid about path */
49 if (!path || strncmp(path, WPAS_DBUS_PATH_INTERFACES "/",
53 /* Ensure there's something at the end of the path */
54 if ((path + dev_path_prefix_len)[0] == '\0')
57 obj_path_only = os_strdup(path);
58 if (obj_path_only == NULL)
61 next_sep = strchr(obj_path_only + dev_path_prefix_len, '/');
62 if (next_sep != NULL) {
63 const char *net_part = strstr(next_sep,
64 WPAS_DBUS_NETWORKS_PART "/");
65 const char *bssid_part = strstr(next_sep,
66 WPAS_DBUS_BSSIDS_PART "/");
68 if (network && net_part) {
69 /* Deal with a request for a configured network */
70 const char *net_name = net_part +
71 strlen(WPAS_DBUS_NETWORKS_PART "/");
74 *network = os_strdup(net_name);
75 } else if (bssid && bssid_part) {
76 /* Deal with a request for a scanned BSSID */
77 const char *bssid_name = bssid_part +
78 strlen(WPAS_DBUS_BSSIDS_PART "/");
79 if (strlen(bssid_name))
80 *bssid = os_strdup(bssid_name);
85 /* Cut off interface object path before "/" */
94 * wpas_dbus_new_invalid_iface_error - Return a new invalid interface error message
95 * @message: Pointer to incoming dbus message this error refers to
96 * Returns: A dbus error message
98 * Convenience function to create and return an invalid interface error
100 DBusMessage * wpas_dbus_new_invalid_iface_error(DBusMessage *message)
102 return dbus_message_new_error(message, WPAS_ERROR_INVALID_IFACE,
103 "wpa_supplicant knows nothing about "
109 * wpas_dbus_new_invalid_network_error - Return a new invalid network error message
110 * @message: Pointer to incoming dbus message this error refers to
111 * Returns: a dbus error message
113 * Convenience function to create and return an invalid network error
115 DBusMessage * wpas_dbus_new_invalid_network_error(DBusMessage *message)
117 return dbus_message_new_error(message, WPAS_ERROR_INVALID_NETWORK,
118 "The requested network does not exist.");
123 * wpas_dbus_new_invalid_bssid_error - Return a new invalid bssid error message
124 * @message: Pointer to incoming dbus message this error refers to
125 * Returns: a dbus error message
127 * Convenience function to create and return an invalid bssid error
129 static DBusMessage * wpas_dbus_new_invalid_bssid_error(DBusMessage *message)
131 return dbus_message_new_error(message, WPAS_ERROR_INVALID_BSSID,
132 "The BSSID requested was invalid.");
137 * wpas_dispatch_network_method - dispatch messages for configured networks
138 * @message: the incoming dbus message
139 * @wpa_s: a network interface's data
140 * @network_id: id of the configured network we're interested in
141 * Returns: a reply dbus message, or a dbus error message
143 * This function dispatches all incoming dbus messages for configured networks.
145 static DBusMessage * wpas_dispatch_network_method(DBusMessage *message,
146 struct wpa_supplicant *wpa_s,
149 DBusMessage *reply = NULL;
150 const char *method = dbus_message_get_member(message);
151 struct wpa_ssid *ssid;
153 ssid = wpa_config_get_network(wpa_s->conf, network_id);
155 return wpas_dbus_new_invalid_network_error(message);
157 if (!strcmp(method, "set"))
158 reply = wpas_dbus_iface_set_network(message, wpa_s, ssid);
159 else if (!strcmp(method, "enable"))
160 reply = wpas_dbus_iface_enable_network(message, wpa_s, ssid);
161 else if (!strcmp(method, "disable"))
162 reply = wpas_dbus_iface_disable_network(message, wpa_s, ssid);
169 * wpas_dispatch_bssid_method - dispatch messages for scanned networks
170 * @message: the incoming dbus message
171 * @wpa_s: a network interface's data
172 * @bssid: bssid of the scanned network we're interested in
173 * Returns: a reply dbus message, or a dbus error message
175 * This function dispatches all incoming dbus messages for scanned networks.
177 static DBusMessage * wpas_dispatch_bssid_method(DBusMessage *message,
178 struct wpa_supplicant *wpa_s,
181 DBusMessage *reply = NULL;
182 const char *method = dbus_message_get_member(message);
183 struct wpa_scan_res *res = NULL;
186 /* Ensure we actually have scan data */
187 if (wpa_s->scan_res == NULL &&
188 wpa_supplicant_get_scan_results(wpa_s) < 0) {
189 reply = wpas_dbus_new_invalid_bssid_error(message);
193 /* Find the bssid's scan data */
194 for (i = 0; i < wpa_s->scan_res->num; i++) {
195 struct wpa_scan_res *search_res = wpa_s->scan_res->res[i];
198 memset(mac_str, 0, sizeof(mac_str));
199 snprintf(mac_str, sizeof(mac_str) - 1, WPAS_DBUS_BSSID_FORMAT,
200 MAC2STR(search_res->bssid));
201 if (!strcmp(bssid, mac_str)) {
208 reply = wpas_dbus_new_invalid_bssid_error(message);
212 /* Dispatch the method call against the scanned bssid */
213 if (!strcmp(method, "properties"))
214 reply = wpas_dbus_bssid_properties(message, wpa_s, res);
222 * wpas_iface_message_handler - Dispatch messages for interfaces or networks
223 * @connection: Connection to the system message bus
224 * @message: An incoming dbus message
225 * @user_data: A pointer to a dbus control interface data structure
226 * Returns: Whether or not the message was handled
228 * This function dispatches all incoming dbus messages for network interfaces,
229 * or objects owned by them, such as scanned BSSIDs and configured networks.
231 static DBusHandlerResult wpas_iface_message_handler(DBusConnection *connection,
232 DBusMessage *message,
235 struct wpa_supplicant *wpa_s = user_data;
236 const char *method = dbus_message_get_member(message);
237 const char *path = dbus_message_get_path(message);
238 const char *msg_interface = dbus_message_get_interface(message);
239 char *iface_obj_path = NULL;
240 char *network = NULL;
242 DBusMessage *reply = NULL;
244 /* Caller must specify a message interface */
248 iface_obj_path = wpas_dbus_decompose_object_path(path, &network,
250 if (iface_obj_path == NULL) {
251 reply = wpas_dbus_new_invalid_iface_error(message);
255 /* Make sure the message's object path actually refers to the
256 * wpa_supplicant structure it's supposed to (which is wpa_s)
258 if (wpa_supplicant_get_iface_by_dbus_path(wpa_s->global,
259 iface_obj_path) != wpa_s) {
260 reply = wpas_dbus_new_invalid_iface_error(message);
264 if (network && !strcmp(msg_interface, WPAS_DBUS_IFACE_NETWORK)) {
265 /* A method for one of this interface's configured networks */
266 int nid = strtoul(network, NULL, 10);
268 reply = wpas_dispatch_network_method(message, wpa_s,
271 reply = wpas_dbus_new_invalid_network_error(message);
272 } else if (bssid && !strcmp(msg_interface, WPAS_DBUS_IFACE_BSSID)) {
273 /* A method for one of this interface's scanned BSSIDs */
274 reply = wpas_dispatch_bssid_method(message, wpa_s, bssid);
275 } else if (!strcmp(msg_interface, WPAS_DBUS_IFACE_INTERFACE)) {
276 /* A method for an interface only. */
277 if (!strcmp(method, "scan"))
278 reply = wpas_dbus_iface_scan(message, wpa_s);
279 else if (!strcmp(method, "scanResults"))
280 reply = wpas_dbus_iface_scan_results(message, wpa_s);
281 else if (!strcmp(method, "addNetwork"))
282 reply = wpas_dbus_iface_add_network(message, wpa_s);
283 else if (!strcmp(method, "removeNetwork"))
284 reply = wpas_dbus_iface_remove_network(message, wpa_s);
285 else if (!strcmp(method, "selectNetwork"))
286 reply = wpas_dbus_iface_select_network(message, wpa_s);
287 else if (!strcmp(method, "capabilities"))
288 reply = wpas_dbus_iface_capabilities(message, wpa_s);
289 else if (!strcmp(method, "disconnect"))
290 reply = wpas_dbus_iface_disconnect(message, wpa_s);
291 else if (!strcmp(method, "setAPScan"))
292 reply = wpas_dbus_iface_set_ap_scan(message, wpa_s);
293 else if (!strcmp(method, "setSmartcardModules"))
294 reply = wpas_dbus_iface_set_smartcard_modules(message,
296 else if (!strcmp(method, "state"))
297 reply = wpas_dbus_iface_get_state(message, wpa_s);
298 else if (!strcmp(method, "scanning"))
299 reply = wpas_dbus_iface_get_scanning(message, wpa_s);
300 else if (!strcmp(method, "setBlobs"))
301 reply = wpas_dbus_iface_set_blobs(message, wpa_s);
302 else if (!strcmp(method, "removeBlobs"))
303 reply = wpas_dbus_iface_remove_blobs(message, wpa_s);
305 else if (!os_strcmp(method, "wpsPbc"))
306 reply = wpas_dbus_iface_wps_pbc(message, wpa_s);
307 else if (!os_strcmp(method, "wpsPin"))
308 reply = wpas_dbus_iface_wps_pin(message, wpa_s);
309 else if (!os_strcmp(method, "wpsReg"))
310 reply = wpas_dbus_iface_wps_reg(message, wpa_s);
311 #endif /* CONFIG_WPS */
314 /* If the message was handled, send back the reply */
316 if (!dbus_message_get_no_reply(message))
317 dbus_connection_send(connection, reply, NULL);
318 dbus_message_unref(reply);
322 os_free(iface_obj_path);
325 return reply ? DBUS_HANDLER_RESULT_HANDLED :
326 DBUS_HANDLER_RESULT_NOT_YET_HANDLED;
331 * wpas_message_handler - dispatch incoming dbus messages
332 * @connection: connection to the system message bus
333 * @message: an incoming dbus message
334 * @user_data: a pointer to a dbus control interface data structure
335 * Returns: whether or not the message was handled
337 * This function dispatches all incoming dbus messages to the correct
338 * handlers, depending on what the message's target object path is,
339 * and what the method call is.
341 static DBusHandlerResult wpas_message_handler(DBusConnection *connection,
342 DBusMessage *message, void *user_data)
344 struct wpas_dbus_priv *ctrl_iface = user_data;
347 const char *msg_interface;
348 DBusMessage *reply = NULL;
350 method = dbus_message_get_member(message);
351 path = dbus_message_get_path(message);
352 msg_interface = dbus_message_get_interface(message);
353 if (!method || !path || !ctrl_iface || !msg_interface)
354 return DBUS_HANDLER_RESULT_NOT_YET_HANDLED;
356 /* Validate the method interface */
357 if (strcmp(msg_interface, WPAS_DBUS_INTERFACE) != 0)
358 return DBUS_HANDLER_RESULT_NOT_YET_HANDLED;
360 if (!strcmp(path, WPAS_DBUS_PATH)) {
361 /* dispatch methods against our global dbus interface here */
362 if (!strcmp(method, "addInterface")) {
363 reply = wpas_dbus_global_add_interface(
364 message, ctrl_iface->global);
365 } else if (!strcmp(method, "removeInterface")) {
366 reply = wpas_dbus_global_remove_interface(
367 message, ctrl_iface->global);
368 } else if (!strcmp(method, "getInterface")) {
369 reply = wpas_dbus_global_get_interface(
370 message, ctrl_iface->global);
371 } else if (!strcmp(method, "setDebugParams")) {
372 reply = wpas_dbus_global_set_debugparams(
373 message, ctrl_iface->global);
377 /* If the message was handled, send back the reply */
379 if (!dbus_message_get_no_reply(message))
380 dbus_connection_send(connection, reply, NULL);
381 dbus_message_unref(reply);
384 return reply ? DBUS_HANDLER_RESULT_HANDLED :
385 DBUS_HANDLER_RESULT_NOT_YET_HANDLED;
390 * wpa_supplicant_dbus_notify_scan_results - Send a scan results signal
391 * @wpa_s: %wpa_supplicant network interface data
392 * Returns: 0 on success, -1 on failure
394 * Notify listeners that this interface has updated scan results.
396 void wpa_supplicant_dbus_notify_scan_results(struct wpa_supplicant *wpa_s)
398 struct wpas_dbus_priv *iface = wpa_s->global->dbus;
399 DBusMessage *_signal;
401 /* Do nothing if the control interface is not turned on */
405 _signal = dbus_message_new_signal(wpa_s->dbus_path,
406 WPAS_DBUS_IFACE_INTERFACE,
407 "ScanResultsAvailable");
408 if (_signal == NULL) {
409 perror("wpa_supplicant_dbus_notify_scan_results[dbus]: "
410 "couldn't create dbus signal; likely out of memory");
411 wpa_printf(MSG_ERROR, "dbus control interface: not enough "
412 "memory to send scan results signal.");
415 dbus_connection_send(iface->con, _signal, NULL);
416 dbus_message_unref(_signal);
421 * wpa_supplicant_dbus_notify_state_change - Send a state change signal
422 * @wpa_s: %wpa_supplicant network interface data
423 * @new_state: new state wpa_supplicant is entering
424 * @old_state: old state wpa_supplicant is leaving
425 * Returns: 0 on success, -1 on failure
427 * Notify listeners that wpa_supplicant has changed state
429 void wpa_supplicant_dbus_notify_state_change(struct wpa_supplicant *wpa_s,
430 enum wpa_states new_state,
431 enum wpa_states old_state)
433 struct wpas_dbus_priv *iface;
434 DBusMessage *_signal = NULL;
435 const char *new_state_str, *old_state_str;
437 /* Do nothing if the control interface is not turned on */
438 if (wpa_s->global == NULL)
440 iface = wpa_s->global->dbus;
444 /* Only send signal if state really changed */
445 if (new_state == old_state)
448 _signal = dbus_message_new_signal(wpa_s->dbus_path,
449 WPAS_DBUS_IFACE_INTERFACE,
451 if (_signal == NULL) {
452 perror("wpa_supplicant_dbus_notify_state_change[dbus]: "
453 "couldn't create dbus signal; likely out of memory");
454 wpa_printf(MSG_ERROR,
455 "wpa_supplicant_dbus_notify_state_change[dbus]: "
456 "couldn't create dbus signal; likely out of "
461 new_state_str = wpa_supplicant_state_txt(new_state);
462 old_state_str = wpa_supplicant_state_txt(old_state);
463 if (new_state_str == NULL || old_state_str == NULL) {
464 perror("wpa_supplicant_dbus_notify_state_change[dbus]: "
465 "couldn't convert state strings");
466 wpa_printf(MSG_ERROR,
467 "wpa_supplicant_dbus_notify_state_change[dbus]: "
468 "couldn't convert state strings.");
472 if (!dbus_message_append_args(_signal,
473 DBUS_TYPE_STRING, &new_state_str,
474 DBUS_TYPE_STRING, &old_state_str,
475 DBUS_TYPE_INVALID)) {
476 perror("wpa_supplicant_dbus_notify_state_change[dbus]: "
477 "not enough memory to construct state change signal.");
478 wpa_printf(MSG_ERROR,
479 "wpa_supplicant_dbus_notify_state_change[dbus]: "
480 "not enough memory to construct state change "
485 dbus_connection_send(iface->con, _signal, NULL);
488 dbus_message_unref(_signal);
493 * wpa_supplicant_dbus_notify_scanning - send scanning status
494 * @wpa_s: %wpa_supplicant network interface data
495 * Returns: 0 on success, -1 on failure
497 * Notify listeners of interface scanning state changes
499 void wpa_supplicant_dbus_notify_scanning(struct wpa_supplicant *wpa_s)
501 struct wpas_dbus_priv *iface = wpa_s->global->dbus;
502 DBusMessage *_signal;
503 dbus_bool_t scanning = wpa_s->scanning ? TRUE : FALSE;
505 /* Do nothing if the control interface is not turned on */
509 _signal = dbus_message_new_signal(wpa_s->dbus_path,
510 WPAS_DBUS_IFACE_INTERFACE,
512 if (_signal == NULL) {
513 perror("wpa_supplicant_dbus_notify_scanning[dbus]: couldn't "
514 "create dbus signal; likely out of memory");
515 wpa_printf(MSG_ERROR, "%s[dbus]: dbus control interface: not "
516 "enough memory to send scan results signal.",
521 if (dbus_message_append_args(_signal,
522 DBUS_TYPE_BOOLEAN, &scanning,
523 DBUS_TYPE_INVALID)) {
524 dbus_connection_send(iface->con, _signal, NULL);
526 perror("wpa_supplicant_dbus_notify_scanning[dbus]: not enough "
527 "memory to construct signal.");
528 wpa_printf(MSG_ERROR, "%s[dbus]: not enough memory to "
529 "construct signal.", __FUNCTION__);
531 dbus_message_unref(_signal);
536 void wpa_supplicant_dbus_notify_wps_cred(struct wpa_supplicant *wpa_s,
537 const struct wps_credential *cred)
539 struct wpas_dbus_priv *iface;
540 DBusMessage *_signal = NULL;
542 /* Do nothing if the control interface is not turned on */
543 if (wpa_s->global == NULL)
545 iface = wpa_s->global->dbus;
549 _signal = dbus_message_new_signal(wpa_s->dbus_path,
550 WPAS_DBUS_IFACE_INTERFACE,
552 if (_signal == NULL) {
553 perror("wpa_supplicant_dbus_notify_wps_cred[dbus]: "
554 "couldn't create dbus signal; likely out of memory");
555 wpa_printf(MSG_ERROR,
556 "wpa_supplicant_dbus_notify_wps_cred[dbus]: "
557 "couldn't create dbus signal; likely out of "
562 if (!dbus_message_append_args(_signal,
563 DBUS_TYPE_ARRAY, DBUS_TYPE_BYTE,
564 &cred->cred_attr, cred->cred_attr_len,
565 DBUS_TYPE_INVALID)) {
566 perror("wpa_supplicant_dbus_notify_wps_cred[dbus]: "
567 "not enough memory to construct signal.");
568 wpa_printf(MSG_ERROR,
569 "wpa_supplicant_dbus_notify_wps_cred[dbus]: "
570 "not enough memory to construct signal.");
574 dbus_connection_send(iface->con, _signal, NULL);
577 dbus_message_unref(_signal);
579 #else /* CONFIG_WPS */
580 void wpa_supplicant_dbus_notify_wps_cred(struct wpa_supplicant *wpa_s,
581 const struct wps_credential *cred)
584 #endif /* CONFIG_WPS */
588 * wpa_supplicant_dbus_ctrl_iface_init - Initialize dbus control interface
589 * @global: Pointer to global data from wpa_supplicant_init()
590 * Returns: 0 on success, -1 on failure
592 * Initialize the dbus control interface and start receiving commands from
593 * external programs over the bus.
595 int wpa_supplicant_dbus_ctrl_iface_init(struct wpas_dbus_priv *iface)
599 DBusObjectPathVTable wpas_vtable = {
600 NULL, &wpas_message_handler, NULL, NULL, NULL, NULL
603 /* Register the message handler for the global dbus interface */
604 if (!dbus_connection_register_object_path(iface->con,
605 WPAS_DBUS_PATH, &wpas_vtable,
607 perror("dbus_connection_register_object_path[dbus]");
608 wpa_printf(MSG_ERROR, "Could not set up DBus message "
613 /* Register our service with the message bus */
614 dbus_error_init(&error);
615 switch (dbus_bus_request_name(iface->con, WPAS_DBUS_SERVICE,
617 case DBUS_REQUEST_NAME_REPLY_PRIMARY_OWNER:
620 case DBUS_REQUEST_NAME_REPLY_EXISTS:
621 case DBUS_REQUEST_NAME_REPLY_IN_QUEUE:
622 case DBUS_REQUEST_NAME_REPLY_ALREADY_OWNER:
623 perror("dbus_bus_request_name[dbus]");
624 wpa_printf(MSG_ERROR, "Could not request DBus service name: "
625 "already registered.");
628 perror("dbus_bus_request_name[dbus]");
629 wpa_printf(MSG_ERROR, "Could not request DBus service name: "
630 "%s %s.", error.name, error.message);
633 dbus_error_free(&error);
638 wpa_printf(MSG_DEBUG, "Providing DBus service '" WPAS_DBUS_SERVICE
646 * wpas_dbus_register_new_iface - Register a new interface with dbus
647 * @wpa_s: %wpa_supplicant interface description structure to register
648 * Returns: 0 on success, -1 on error
650 * Registers a new interface with dbus and assigns it a dbus object path.
652 int wpas_dbus_register_iface(struct wpa_supplicant *wpa_s)
654 struct wpas_dbus_priv *ctrl_iface = wpa_s->global->dbus;
655 DBusConnection * con;
657 DBusObjectPathVTable vtable = {
658 NULL, &wpas_iface_message_handler, NULL, NULL, NULL, NULL
662 /* Do nothing if the control interface is not turned on */
663 if (ctrl_iface == NULL)
666 con = ctrl_iface->con;
667 next = ctrl_iface->next_objid++;
669 /* Create and set the interface's object path */
670 wpa_s->dbus_path = os_zalloc(WPAS_DBUS_OBJECT_PATH_MAX);
671 if (wpa_s->dbus_path == NULL)
673 os_snprintf(wpa_s->dbus_path, WPAS_DBUS_OBJECT_PATH_MAX,
674 WPAS_DBUS_PATH_INTERFACES "/%u",
677 /* Register the message handler for the interface functions */
678 if (!dbus_connection_register_fallback(con, wpa_s->dbus_path, &vtable,
680 perror("wpas_dbus_register_iface [dbus]");
681 wpa_printf(MSG_ERROR, "Could not set up DBus message "
682 "handler for interface %s.", wpa_s->ifname);
693 * wpas_dbus_unregister_iface - Unregister an interface from dbus
694 * @wpa_s: wpa_supplicant interface structure
695 * Returns: 0 on success, -1 on failure
697 * Unregisters the interface with dbus
699 int wpas_dbus_unregister_iface(struct wpa_supplicant *wpa_s)
701 struct wpas_dbus_priv *ctrl_iface;
704 /* Do nothing if the control interface is not turned on */
705 if (wpa_s == NULL || wpa_s->global == NULL)
707 ctrl_iface = wpa_s->global->dbus;
708 if (ctrl_iface == NULL)
711 con = ctrl_iface->con;
712 if (!dbus_connection_unregister_object_path(con, wpa_s->dbus_path))
715 os_free(wpa_s->dbus_path);
716 wpa_s->dbus_path = NULL;
723 * wpa_supplicant_get_iface_by_dbus_path - Get a new network interface
724 * @global: Pointer to global data from wpa_supplicant_init()
725 * @path: Pointer to a dbus object path representing an interface
726 * Returns: Pointer to the interface or %NULL if not found
728 struct wpa_supplicant * wpa_supplicant_get_iface_by_dbus_path(
729 struct wpa_global *global, const char *path)
731 struct wpa_supplicant *wpa_s;
733 for (wpa_s = global->ifaces; wpa_s; wpa_s = wpa_s->next) {
734 if (strcmp(wpa_s->dbus_path, path) == 0)