2 * WPA Supplicant / dbus-based control interface
3 * Copyright (c) 2006, Dan Williams <dcbw@redhat.com> and Red Hat, Inc.
4 * Copyright (c) 2009, Witold Sowa <witold.sowa@gmail.com>
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License version 2 as
8 * published by the Free Software Foundation.
10 * Alternatively, this software may be distributed under the terms of BSD
13 * See README and COPYING for more details.
16 #ifndef WPA_DBUS_CTRL_H
17 #define WPA_DBUS_CTRL_H
19 #include <dbus/dbus.h>
21 struct ctrl_iface_dbus_new_priv {
24 void *application_data;
29 typedef DBusMessage * (* WPADBusMethodHandler)(DBusMessage *message,
31 typedef void (* WPADBusArgumentFreeFunction)(void *handler_arg);
33 typedef DBusMessage * (* WPADBusPropertyAccessor)(DBusMessage *message,
36 struct wpa_dbus_object_desc {
37 DBusConnection *connection;
38 struct wpa_dbus_method_desc *methods;
39 struct wpa_dbus_signal_desc *signals;
40 struct wpa_dbus_property_desc *properties;
43 enum dbus_prop_access { R, W, RW };
45 enum dbus_arg_direction { ARG_IN, ARG_OUT };
47 struct wpa_dbus_argument {
50 enum dbus_arg_direction dir;
53 #define END_ARGS { NULL, NULL, ARG_IN }
55 #ifdef CONFIG_CTRL_IFACE_DBUS_NEW
60 * If we do not have SIGPOLL, try to use SIGIO instead. This is needed for
67 #define WPAS_DBUS_OBJECT_PATH_MAX 150
68 #define WPAS_DBUS_INTERFACE_MAX 150
69 #define WPAS_DBUS_METHOD_SIGNAL_PROP_MAX 50
71 #define WPA_DBUS_INTROSPECTION_INTERFACE "org.freedesktop.DBus.Introspectable"
72 #define WPA_DBUS_INTROSPECTION_METHOD "Introspect"
73 #define WPA_DBUS_PROPERTIES_INTERFACE "org.freedesktop.DBus.Properties"
74 #define WPA_DBUS_PROPERTIES_GET "Get"
75 #define WPA_DBUS_PROPERTIES_SET "Set"
76 #define WPA_DBUS_PROPERTIES_GETALL "GetAll"
78 void free_dbus_object_desc(struct wpa_dbus_object_desc *obj_dsc);
80 struct ctrl_iface_dbus_new_priv *
81 wpa_dbus_ctrl_iface_init(void *application_data, char *dbus_path,
83 struct wpa_dbus_object_desc *obj_desc);
85 void wpa_dbus_ctrl_iface_deinit(struct ctrl_iface_dbus_new_priv *iface);
87 int wpa_dbus_register_object_per_iface(
88 struct ctrl_iface_dbus_new_priv *ctrl_iface,
89 const char *path, const char *ifname,
90 struct wpa_dbus_object_desc *obj_desc);
92 int wpa_dbus_unregister_object_per_iface(
93 struct ctrl_iface_dbus_new_priv *ctrl_iface,
96 int wpa_dbus_method_register(struct wpa_dbus_object_desc *obj_dsc,
97 char *dbus_interface, char *dbus_method,
98 WPADBusMethodHandler method_handler,
99 void *handler_argument,
100 WPADBusArgumentFreeFunction argument_free_func,
101 struct wpa_dbus_argument args[]);
103 int wpa_dbus_signal_register(struct wpa_dbus_object_desc *obj_dsc,
104 char *dbus_interface, char *dbus_signal,
105 struct wpa_dbus_argument args[]);
107 int wpa_dbus_property_register(
108 struct wpa_dbus_object_desc *obj_dsc,
109 char *dbus_interface, char *dbus_property,
111 WPADBusPropertyAccessor getter,
112 WPADBusPropertyAccessor setter,
114 WPADBusArgumentFreeFunction user_datat_free_func,
115 enum dbus_prop_access access);
117 void wpa_dbus_signal_property_changed(struct ctrl_iface_dbus_new_priv *iface,
118 WPADBusPropertyAccessor property_getter,
121 const char *interface_name,
122 const char *property_name);
124 /* Methods internal to the dbus control interface */
125 u32 wpa_dbus_next_objid(struct ctrl_iface_dbus_new_priv *iface);
128 #else /* CONFIG_CTRL_IFACE_DBUS_NEW */
130 static inline void wpa_dbus_signal_property_changed(
131 struct ctrl_iface_dbus_new_priv *iface,
132 WPADBusPropertyAccessor property_getter, void *getter_arg,
133 const char *path, const char *interface_name,
134 const char *property_name)
138 #endif /* CONFIG_CTRL_IFACE_DBUS_NEW */
140 #endif /* WPA_DBUS_CTRL_H */