3 * WPA supplicant library with GLib integration
5 * Copyright (C) 2012 Intel Corporation. All rights reserved.
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.
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.
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
21 #ifndef __G_SUPPLICANT_H
22 #define __G_SUPPLICANT_H
28 #define G_SUPPLICANT_EAP_METHOD_MD5 (1 << 0)
29 #define G_SUPPLICANT_EAP_METHOD_TLS (1 << 1)
30 #define G_SUPPLICANT_EAP_METHOD_MSCHAPV2 (1 << 2)
31 #define G_SUPPLICANT_EAP_METHOD_PEAP (1 << 3)
32 #define G_SUPPLICANT_EAP_METHOD_TTLS (1 << 4)
33 #define G_SUPPLICANT_EAP_METHOD_GTC (1 << 5)
34 #define G_SUPPLICANT_EAP_METHOD_OTP (1 << 6)
35 #define G_SUPPLICANT_EAP_METHOD_LEAP (1 << 7)
36 #define G_SUPPLICANT_EAP_METHOD_WSC (1 << 8)
38 #define G_SUPPLICANT_CAPABILITY_AUTHALG_OPEN (1 << 0)
39 #define G_SUPPLICANT_CAPABILITY_AUTHALG_SHARED (1 << 1)
40 #define G_SUPPLICANT_CAPABILITY_AUTHALG_LEAP (1 << 2)
42 #define G_SUPPLICANT_CAPABILITY_PROTO_WPA (1 << 0)
43 #define G_SUPPLICANT_CAPABILITY_PROTO_RSN (1 << 1)
45 #define G_SUPPLICANT_CAPABILITY_SCAN_ACTIVE (1 << 0)
46 #define G_SUPPLICANT_CAPABILITY_SCAN_PASSIVE (1 << 1)
47 #define G_SUPPLICANT_CAPABILITY_SCAN_SSID (1 << 2)
49 #define G_SUPPLICANT_CAPABILITY_MODE_INFRA (1 << 0)
50 #define G_SUPPLICANT_CAPABILITY_MODE_IBSS (1 << 1)
51 #define G_SUPPLICANT_CAPABILITY_MODE_AP (1 << 2)
53 #define G_SUPPLICANT_KEYMGMT_NONE (1 << 0)
54 #define G_SUPPLICANT_KEYMGMT_IEEE8021X (1 << 1)
55 #define G_SUPPLICANT_KEYMGMT_WPA_NONE (1 << 2)
56 #define G_SUPPLICANT_KEYMGMT_WPA_PSK (1 << 3)
57 #define G_SUPPLICANT_KEYMGMT_WPA_PSK_256 (1 << 4)
58 #define G_SUPPLICANT_KEYMGMT_WPA_FT_PSK (1 << 5)
59 #define G_SUPPLICANT_KEYMGMT_WPA_FT_EAP (1 << 6)
60 #define G_SUPPLICANT_KEYMGMT_WPA_EAP (1 << 7)
61 #define G_SUPPLICANT_KEYMGMT_WPA_EAP_256 (1 << 8)
62 #define G_SUPPLICANT_KEYMGMT_WPS (1 << 9)
64 #define G_SUPPLICANT_PROTO_WPA (1 << 0)
65 #define G_SUPPLICANT_PROTO_RSN (1 << 1)
67 #define G_SUPPLICANT_GROUP_WEP40 (1 << 0)
68 #define G_SUPPLICANT_GROUP_WEP104 (1 << 1)
69 #define G_SUPPLICANT_GROUP_TKIP (1 << 2)
70 #define G_SUPPLICANT_GROUP_CCMP (1 << 3)
72 #define G_SUPPLICANT_PAIRWISE_NONE (1 << 0)
73 #define G_SUPPLICANT_PAIRWISE_TKIP (1 << 1)
74 #define G_SUPPLICANT_PAIRWISE_CCMP (1 << 2)
76 #define G_SUPPLICANT_WPS_CONFIGURED (1 << 0)
77 #define G_SUPPLICANT_WPS_PBC (1 << 1)
78 #define G_SUPPLICANT_WPS_PIN (1 << 2)
79 #define G_SUPPLICANT_WPS_REGISTRAR (1 << 3)
82 G_SUPPLICANT_MODE_UNKNOWN,
83 G_SUPPLICANT_MODE_INFRA,
84 G_SUPPLICANT_MODE_IBSS,
85 G_SUPPLICANT_MODE_MASTER,
89 G_SUPPLICANT_SECURITY_UNKNOWN,
90 G_SUPPLICANT_SECURITY_NONE,
91 G_SUPPLICANT_SECURITY_WEP,
92 G_SUPPLICANT_SECURITY_PSK,
93 G_SUPPLICANT_SECURITY_IEEE8021X,
94 } GSupplicantSecurity;
97 G_SUPPLICANT_STATE_UNKNOWN,
98 G_SUPPLICANT_STATE_DISCONNECTED,
99 G_SUPPLICANT_STATE_INACTIVE,
100 G_SUPPLICANT_STATE_SCANNING,
101 G_SUPPLICANT_STATE_AUTHENTICATING,
102 G_SUPPLICANT_STATE_ASSOCIATING,
103 G_SUPPLICANT_STATE_ASSOCIATED,
104 G_SUPPLICANT_STATE_4WAY_HANDSHAKE,
105 G_SUPPLICANT_STATE_GROUP_HANDSHAKE,
106 G_SUPPLICANT_STATE_COMPLETED,
110 G_SUPPLICANT_WPS_STATE_UNKNOWN,
111 G_SUPPLICANT_WPS_STATE_SUCCESS,
112 G_SUPPLICANT_WPS_STATE_FAIL,
113 } GSupplicantWpsState;
115 struct _GSupplicantSSID {
117 unsigned int ssid_len;
118 unsigned int scan_ssid;
119 GSupplicantMode mode;
120 GSupplicantSecurity security;
121 unsigned int protocol;
122 unsigned int pairwise_cipher;
123 unsigned int group_cipher;
126 const char *passphrase;
127 const char *identity;
128 const char *ca_cert_path;
129 const char *client_cert_path;
130 const char *private_key_path;
131 const char *private_key_passphrase;
132 const char *phase2_auth;
138 typedef struct _GSupplicantSSID GSupplicantSSID;
141 * Max number of SSIDs that can be scanned.
142 * In wpa_s 0.7x the limit is 4.
143 * In wps_s 0.8 or later it is 16.
144 * The value is only used if wpa_supplicant does not return any max limit
145 * for number of scannable SSIDs.
147 #define WPAS_MAX_SCAN_SSIDS 4
150 unsigned char ssid[32];
154 struct _GSupplicantScanParams {
162 typedef struct _GSupplicantScanParams GSupplicantScanParams;
165 typedef void (*GSupplicantCountryCallback) (void *user_data);
167 int g_supplicant_set_country(const char *alpha2,
168 GSupplicantCountryCallback callback,
169 const void *user_data);
172 struct _GSupplicantInterface;
174 typedef struct _GSupplicantInterface GSupplicantInterface;
176 typedef void (*GSupplicantInterfaceCallback) (int result,
177 GSupplicantInterface *interface,
180 int g_supplicant_interface_create(const char *ifname, const char *driver,
182 GSupplicantInterfaceCallback callback,
184 int g_supplicant_interface_remove(GSupplicantInterface *interface,
185 GSupplicantInterfaceCallback callback,
187 int g_supplicant_interface_scan(GSupplicantInterface *interface,
188 GSupplicantScanParams *scan_data,
189 GSupplicantInterfaceCallback callback,
192 int g_supplicant_interface_connect(GSupplicantInterface *interface,
193 GSupplicantSSID *ssid,
194 GSupplicantInterfaceCallback callback,
197 int g_supplicant_interface_disconnect(GSupplicantInterface *interface,
198 GSupplicantInterfaceCallback callback,
201 int g_supplicant_interface_set_apscan(GSupplicantInterface *interface,
202 unsigned int ap_scan);
204 void g_supplicant_interface_set_data(GSupplicantInterface *interface,
206 void *g_supplicant_interface_get_data(GSupplicantInterface *interface);
207 const char *g_supplicant_interface_get_ifname(GSupplicantInterface *interface);
208 const char *g_supplicant_interface_get_driver(GSupplicantInterface *interface);
209 GSupplicantState g_supplicant_interface_get_state(GSupplicantInterface *interface);
210 const char *g_supplicant_interface_get_wps_key(GSupplicantInterface *interface);
211 const void *g_supplicant_interface_get_wps_ssid(GSupplicantInterface *interface,
212 unsigned int *ssid_len);
213 GSupplicantWpsState g_supplicant_interface_get_wps_state(GSupplicantInterface *interface);
214 unsigned int g_supplicant_interface_get_mode(GSupplicantInterface *interface);
215 dbus_bool_t g_supplicant_interface_get_ready(GSupplicantInterface *interface);
216 unsigned int g_supplicant_interface_get_max_scan_ssids(
217 GSupplicantInterface *interface);
219 int g_supplicant_interface_enable_selected_network(GSupplicantInterface *interface,
223 struct _GSupplicantNetwork;
225 typedef struct _GSupplicantNetwork GSupplicantNetwork;
227 GSupplicantInterface *g_supplicant_network_get_interface(GSupplicantNetwork *network);
228 const char *g_supplicant_network_get_name(GSupplicantNetwork *network);
229 const char *g_supplicant_network_get_identifier(GSupplicantNetwork *network);
230 const char *g_supplicant_network_get_path(GSupplicantNetwork *network);
231 const void *g_supplicant_network_get_ssid(GSupplicantNetwork *network,
232 unsigned int *ssid_len);
233 const char *g_supplicant_network_get_mode(GSupplicantNetwork *network);
234 const char *g_supplicant_network_get_security(GSupplicantNetwork *network);
235 dbus_int16_t g_supplicant_network_get_signal(GSupplicantNetwork *network);
236 dbus_uint16_t g_supplicant_network_get_frequency(GSupplicantNetwork *network);
237 dbus_bool_t g_supplicant_network_get_wps(GSupplicantNetwork *network);
238 dbus_bool_t g_supplicant_network_is_wps_active(GSupplicantNetwork *network);
239 dbus_bool_t g_supplicant_network_is_wps_pbc(GSupplicantNetwork *network);
240 dbus_bool_t g_supplicant_network_is_wps_advertizing(GSupplicantNetwork *network);
242 struct _GSupplicantCallbacks {
243 void (*system_ready) (void);
244 void (*system_killed) (void);
245 void (*interface_added) (GSupplicantInterface *interface);
246 void (*interface_state) (GSupplicantInterface *interface);
247 void (*interface_removed) (GSupplicantInterface *interface);
248 void (*scan_started) (GSupplicantInterface *interface);
249 void (*scan_finished) (GSupplicantInterface *interface);
250 void (*network_added) (GSupplicantNetwork *network);
251 void (*network_removed) (GSupplicantNetwork *network);
252 void (*network_changed) (GSupplicantNetwork *network,
253 const char *property);
254 void (*debug) (const char *str);
257 typedef struct _GSupplicantCallbacks GSupplicantCallbacks;
259 int g_supplicant_register(const GSupplicantCallbacks *callbacks);
260 void g_supplicant_unregister(const GSupplicantCallbacks *callbacks);
263 void g_supplicant_free_scan_params(GSupplicantScanParams *scan_params)
265 g_slist_free_full(scan_params->ssids, g_free);
266 g_free(scan_params->freqs);
274 #endif /* __G_SUPPLICANT_H */