3 * WPA supplicant library with GLib integration
5 * Copyright (C) 2012-2013 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)
52 #define G_SUPPLICANT_CAPABILITY_MODE_P2P (1 << 3)
54 #define G_SUPPLICANT_KEYMGMT_NONE (1 << 0)
55 #define G_SUPPLICANT_KEYMGMT_IEEE8021X (1 << 1)
56 #define G_SUPPLICANT_KEYMGMT_WPA_NONE (1 << 2)
57 #define G_SUPPLICANT_KEYMGMT_WPA_PSK (1 << 3)
58 #define G_SUPPLICANT_KEYMGMT_WPA_PSK_256 (1 << 4)
59 #define G_SUPPLICANT_KEYMGMT_WPA_FT_PSK (1 << 5)
60 #define G_SUPPLICANT_KEYMGMT_WPA_FT_EAP (1 << 6)
61 #define G_SUPPLICANT_KEYMGMT_WPA_EAP (1 << 7)
62 #define G_SUPPLICANT_KEYMGMT_WPA_EAP_256 (1 << 8)
63 #define G_SUPPLICANT_KEYMGMT_WPS (1 << 9)
65 #define G_SUPPLICANT_PROTO_WPA (1 << 0)
66 #define G_SUPPLICANT_PROTO_RSN (1 << 1)
68 #define G_SUPPLICANT_GROUP_WEP40 (1 << 0)
69 #define G_SUPPLICANT_GROUP_WEP104 (1 << 1)
70 #define G_SUPPLICANT_GROUP_TKIP (1 << 2)
71 #define G_SUPPLICANT_GROUP_CCMP (1 << 3)
73 #define G_SUPPLICANT_PAIRWISE_NONE (1 << 0)
74 #define G_SUPPLICANT_PAIRWISE_TKIP (1 << 1)
75 #define G_SUPPLICANT_PAIRWISE_CCMP (1 << 2)
77 #define G_SUPPLICANT_WPS_CONFIGURED (1 << 0)
78 #define G_SUPPLICANT_WPS_PBC (1 << 1)
79 #define G_SUPPLICANT_WPS_PIN (1 << 2)
80 #define G_SUPPLICANT_WPS_REGISTRAR (1 << 3)
82 #define G_SUPPLICANT_WPS_CONFIG_PBC 0x0080
84 #define G_SUPPLICANT_GROUP_ROLE_CLIENT (1 << 0)
85 #define G_SUPPLICANT_GROUP_ROLE_GO (1 << 1)
88 G_SUPPLICANT_MODE_UNKNOWN,
89 G_SUPPLICANT_MODE_INFRA,
90 G_SUPPLICANT_MODE_IBSS,
91 G_SUPPLICANT_MODE_MASTER,
95 G_SUPPLICANT_SECURITY_UNKNOWN,
96 G_SUPPLICANT_SECURITY_NONE,
97 G_SUPPLICANT_SECURITY_WEP,
98 G_SUPPLICANT_SECURITY_PSK,
99 G_SUPPLICANT_SECURITY_IEEE8021X,
100 } GSupplicantSecurity;
103 G_SUPPLICANT_STATE_UNKNOWN,
104 G_SUPPLICANT_STATE_DISABLED,
105 G_SUPPLICANT_STATE_DISCONNECTED,
106 G_SUPPLICANT_STATE_INACTIVE,
107 G_SUPPLICANT_STATE_SCANNING,
108 G_SUPPLICANT_STATE_AUTHENTICATING,
109 G_SUPPLICANT_STATE_ASSOCIATING,
110 G_SUPPLICANT_STATE_ASSOCIATED,
111 G_SUPPLICANT_STATE_4WAY_HANDSHAKE,
112 G_SUPPLICANT_STATE_GROUP_HANDSHAKE,
113 G_SUPPLICANT_STATE_COMPLETED,
117 G_SUPPLICANT_WPS_STATE_UNKNOWN,
118 G_SUPPLICANT_WPS_STATE_SUCCESS,
119 G_SUPPLICANT_WPS_STATE_FAIL,
120 } GSupplicantWpsState;
123 G_SUPPLICANT_PEER_SERVICES_CHANGED,
124 G_SUPPLICANT_PEER_GROUP_CHANGED,
125 G_SUPPLICANT_PEER_GROUP_STARTED,
126 G_SUPPLICANT_PEER_GROUP_FINISHED,
127 G_SUPPLICANT_PEER_GROUP_JOINED,
128 G_SUPPLICANT_PEER_GROUP_DISCONNECTED,
129 G_SUPPLICANT_PEER_GROUP_FAILED,
130 } GSupplicantPeerState;
132 enum GSupplicantAPHiddenSSID {
133 G_SUPPLICANT_AP_NO_SSID_HIDING,
134 G_SUPPLICANT_AP_HIDDEN_SSID_ZERO_LEN,
135 G_SUPPLICANT_AP_HIDDEN_SSID_ZERO_CONTENTS,
138 struct _GSupplicantSSID {
140 unsigned int ssid_len;
141 unsigned int scan_ssid;
142 GSupplicantMode mode;
143 GSupplicantSecurity security;
144 unsigned int protocol;
145 unsigned int pairwise_cipher;
146 unsigned int group_cipher;
149 const char *passphrase;
150 const char *identity;
151 const char *ca_cert_path;
152 const char *client_cert_path;
153 const char *private_key_path;
154 const char *private_key_passphrase;
155 const char *phase2_auth;
159 int ignore_broadcast_ssid;
162 typedef struct _GSupplicantSSID GSupplicantSSID;
165 unsigned char ssid[32];
169 struct _GSupplicantScanParams {
178 typedef struct _GSupplicantScanParams GSupplicantScanParams;
180 struct _GSupplicantPeerParams {
186 typedef struct _GSupplicantPeerParams GSupplicantPeerParams;
188 struct _GSupplicantP2PServiceParams {
191 unsigned char *query;
193 unsigned char *response;
195 unsigned char *wfd_ies;
199 typedef struct _GSupplicantP2PServiceParams GSupplicantP2PServiceParams;
202 typedef void (*GSupplicantCountryCallback) (int result,
206 int g_supplicant_set_country(const char *alpha2,
207 GSupplicantCountryCallback callback,
208 const void *user_data);
211 struct _GSupplicantInterface;
212 struct _GSupplicantPeer;
214 typedef struct _GSupplicantInterface GSupplicantInterface;
215 typedef struct _GSupplicantPeer GSupplicantPeer;
217 typedef void (*GSupplicantInterfaceCallback) (int result,
218 GSupplicantInterface *interface,
221 void g_supplicant_interface_cancel(GSupplicantInterface *interface);
223 int g_supplicant_interface_create(const char *ifname, const char *driver,
225 GSupplicantInterfaceCallback callback,
227 int g_supplicant_interface_remove(GSupplicantInterface *interface,
228 GSupplicantInterfaceCallback callback,
230 int g_supplicant_interface_scan(GSupplicantInterface *interface,
231 GSupplicantScanParams *scan_data,
232 GSupplicantInterfaceCallback callback,
235 int g_supplicant_interface_p2p_find(GSupplicantInterface *interface,
236 GSupplicantInterfaceCallback callback,
239 int g_supplicant_interface_p2p_stop_find(GSupplicantInterface *interface);
241 int g_supplicant_interface_p2p_connect(GSupplicantInterface *interface,
242 GSupplicantPeerParams *peer_params,
243 GSupplicantInterfaceCallback callback,
246 int g_supplicant_interface_p2p_disconnect(GSupplicantInterface *interface,
247 GSupplicantPeerParams *peer_params);
249 int g_supplicant_interface_p2p_listen(GSupplicantInterface *interface,
250 int period, int interval);
252 int g_supplicant_interface_p2p_add_service(GSupplicantInterface *interface,
253 GSupplicantInterfaceCallback callback,
254 GSupplicantP2PServiceParams *p2p_service_params,
257 int g_supplicant_interface_p2p_del_service(GSupplicantInterface *interface,
258 GSupplicantP2PServiceParams *p2p_service_params);
260 int g_supplicant_set_widi_ies(GSupplicantP2PServiceParams *p2p_service_params,
261 GSupplicantInterfaceCallback callback,
264 int g_supplicant_interface_connect(GSupplicantInterface *interface,
265 GSupplicantSSID *ssid,
266 GSupplicantInterfaceCallback callback,
269 int g_supplicant_interface_disconnect(GSupplicantInterface *interface,
270 GSupplicantInterfaceCallback callback,
273 int g_supplicant_interface_set_apscan(GSupplicantInterface *interface,
274 unsigned int ap_scan);
276 void g_supplicant_interface_set_data(GSupplicantInterface *interface,
278 void *g_supplicant_interface_get_data(GSupplicantInterface *interface);
279 const char *g_supplicant_interface_get_ifname(GSupplicantInterface *interface);
280 const char *g_supplicant_interface_get_driver(GSupplicantInterface *interface);
281 GSupplicantState g_supplicant_interface_get_state(GSupplicantInterface *interface);
282 const char *g_supplicant_interface_get_wps_key(GSupplicantInterface *interface);
283 const void *g_supplicant_interface_get_wps_ssid(GSupplicantInterface *interface,
284 unsigned int *ssid_len);
285 GSupplicantWpsState g_supplicant_interface_get_wps_state(GSupplicantInterface *interface);
286 unsigned int g_supplicant_interface_get_mode(GSupplicantInterface *interface);
287 dbus_bool_t g_supplicant_interface_get_ready(GSupplicantInterface *interface);
288 unsigned int g_supplicant_interface_get_max_scan_ssids(
289 GSupplicantInterface *interface);
291 int g_supplicant_interface_enable_selected_network(GSupplicantInterface *interface,
293 int g_supplicant_interface_set_country(GSupplicantInterface *interface,
294 GSupplicantCountryCallback callback,
297 bool g_supplicant_interface_has_p2p(GSupplicantInterface *interface);
298 int g_supplicant_interface_set_p2p_device_config(GSupplicantInterface *interface,
299 const char *device_name,
300 const char *primary_dev_type);
301 GSupplicantPeer *g_supplicant_interface_peer_lookup(GSupplicantInterface *interface,
302 const char *identifier);
303 bool g_supplicant_interface_is_p2p_finding(GSupplicantInterface *interface);
305 /* Network and Peer API */
306 struct _GSupplicantNetwork;
307 struct _GSupplicantGroup;
309 typedef struct _GSupplicantNetwork GSupplicantNetwork;
310 typedef struct _GSupplicantGroup GSupplicantGroup;
312 GSupplicantInterface *g_supplicant_network_get_interface(GSupplicantNetwork *network);
313 const char *g_supplicant_network_get_name(GSupplicantNetwork *network);
314 const char *g_supplicant_network_get_identifier(GSupplicantNetwork *network);
315 const char *g_supplicant_network_get_path(GSupplicantNetwork *network);
316 const void *g_supplicant_network_get_ssid(GSupplicantNetwork *network,
317 unsigned int *ssid_len);
318 const char *g_supplicant_network_get_mode(GSupplicantNetwork *network);
319 const char *g_supplicant_network_get_security(GSupplicantNetwork *network);
320 dbus_int16_t g_supplicant_network_get_signal(GSupplicantNetwork *network);
321 dbus_uint16_t g_supplicant_network_get_frequency(GSupplicantNetwork *network);
322 dbus_bool_t g_supplicant_network_get_wps(GSupplicantNetwork *network);
323 dbus_bool_t g_supplicant_network_is_wps_active(GSupplicantNetwork *network);
324 dbus_bool_t g_supplicant_network_is_wps_pbc(GSupplicantNetwork *network);
325 dbus_bool_t g_supplicant_network_is_wps_advertizing(GSupplicantNetwork *network);
327 GSupplicantInterface *g_supplicant_peer_get_interface(GSupplicantPeer *peer);
328 const char *g_supplicant_peer_get_path(GSupplicantPeer *peer);
329 const char *g_supplicant_peer_get_identifier(GSupplicantPeer *peer);
330 const void *g_supplicant_peer_get_device_address(GSupplicantPeer *peer);
331 const void *g_supplicant_peer_get_iface_address(GSupplicantPeer *peer);
332 const char *g_supplicant_peer_get_name(GSupplicantPeer *peer);
333 const unsigned char *g_supplicant_peer_get_widi_ies(GSupplicantPeer *peer,
335 bool g_supplicant_peer_is_wps_pbc(GSupplicantPeer *peer);
336 bool g_supplicant_peer_is_wps_pin(GSupplicantPeer *peer);
337 bool g_supplicant_peer_is_in_a_group(GSupplicantPeer *peer);
338 GSupplicantInterface *g_supplicant_peer_get_group_interface(GSupplicantPeer *peer);
339 bool g_supplicant_peer_is_client(GSupplicantPeer *peer);
340 bool g_supplicant_peer_has_requested_connection(GSupplicantPeer *peer);
342 #if defined TIZEN_EXT
344 * Description: Network client requires additional wifi specific info
346 const unsigned char *g_supplicant_network_get_bssid(
347 GSupplicantNetwork *network);
348 unsigned int g_supplicant_network_get_maxrate(GSupplicantNetwork *network);
349 const char *g_supplicant_network_get_enc_mode(GSupplicantNetwork *network);
350 unsigned int g_supplicant_network_is_hs20AP(GSupplicantNetwork *network);
351 const char *g_supplicant_network_get_eap(GSupplicantNetwork *network);
352 const char *g_supplicant_network_get_identity(GSupplicantNetwork *network);
353 const char *g_supplicant_network_get_phase2(GSupplicantNetwork *network);
356 struct _GSupplicantCallbacks {
357 void (*system_ready) (void);
358 void (*system_killed) (void);
359 void (*interface_added) (GSupplicantInterface *interface);
360 void (*interface_state) (GSupplicantInterface *interface);
361 void (*interface_removed) (GSupplicantInterface *interface);
362 void (*p2p_support) (GSupplicantInterface *interface);
363 void (*scan_started) (GSupplicantInterface *interface);
364 void (*scan_finished) (GSupplicantInterface *interface);
365 void (*network_added) (GSupplicantNetwork *network);
366 void (*network_removed) (GSupplicantNetwork *network);
367 #if defined TIZEN_EXT
368 void (*network_merged) (GSupplicantNetwork *network);
370 void (*network_changed) (GSupplicantNetwork *network,
371 const char *property);
372 void (*add_station) (const char *mac);
373 void (*remove_station) (const char *mac);
374 void (*peer_found) (GSupplicantPeer *peer);
375 void (*peer_lost) (GSupplicantPeer *peer);
376 void (*peer_changed) (GSupplicantPeer *peer,
377 GSupplicantPeerState state);
378 void (*peer_request) (GSupplicantPeer *peer);
379 void (*debug) (const char *str);
382 typedef struct _GSupplicantCallbacks GSupplicantCallbacks;
384 int g_supplicant_register(const GSupplicantCallbacks *callbacks);
385 void g_supplicant_unregister(const GSupplicantCallbacks *callbacks);
388 void g_supplicant_free_scan_params(GSupplicantScanParams *scan_params)
390 g_slist_free_full(scan_params->ssids, g_free);
391 g_free(scan_params->freqs);
399 #endif /* __G_SUPPLICANT_H */