gsupplicant/gsupplicant.h

   1 /*
   2  *
   3  *  WPA supplicant library with GLib integration
   4  *
   5  *  Copyright (C) 2012-2013  Intel Corporation. All rights reserved.
   6  *
   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.
  10  *
  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.
  15  *
  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
  19  *
  20  */
  21 #ifndef __G_SUPPLICANT_H
  22 #define __G_SUPPLICANT_H
  23
  24 #ifdef __cplusplus
  25 extern "C" {
  26 #endif
  27
  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)
  37
  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)
  41
  42 #define G_SUPPLICANT_CAPABILITY_PROTO_WPA               (1 << 0)
  43 #define G_SUPPLICANT_CAPABILITY_PROTO_RSN               (1 << 1)
  44
  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)
  48
  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)
  53
  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)
  64
  65 #define G_SUPPLICANT_PROTO_WPA          (1 << 0)
  66 #define G_SUPPLICANT_PROTO_RSN          (1 << 1)
  67
  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)
  72
  73 #define G_SUPPLICANT_PAIRWISE_NONE      (1 << 0)
  74 #define G_SUPPLICANT_PAIRWISE_TKIP      (1 << 1)
  75 #define G_SUPPLICANT_PAIRWISE_CCMP      (1 << 2)
  76
  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)
  81
  82 #define G_SUPPLICANT_WPS_CONFIG_PBC     0x0080
  83
  84 #define G_SUPPLICANT_GROUP_ROLE_CLIENT  (1 << 0)
  85 #define G_SUPPLICANT_GROUP_ROLE_GO      (1 << 1)
  86
  87 typedef enum {
  88         G_SUPPLICANT_MODE_UNKNOWN,
  89         G_SUPPLICANT_MODE_INFRA,
  90         G_SUPPLICANT_MODE_IBSS,
  91         G_SUPPLICANT_MODE_MASTER,
  92 } GSupplicantMode;
  93
  94 typedef enum {
  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;
 101
 102 typedef enum {
 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,
 114 } GSupplicantState;
 115
 116 typedef enum {
 117         G_SUPPLICANT_WPS_STATE_UNKNOWN,
 118         G_SUPPLICANT_WPS_STATE_SUCCESS,
 119         G_SUPPLICANT_WPS_STATE_FAIL,
 120 } GSupplicantWpsState;
 121
 122 typedef enum {
 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;
 131
 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,
 136 };
 137
 138 struct _GSupplicantSSID {
 139         const void *ssid;
 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;
 147         unsigned int freq;
 148         const char *eap;
 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;
 156         dbus_bool_t use_wps;
 157         const char *pin_wps;
 158         const char *bgscan;
 159         int ignore_broadcast_ssid;
 160 };
 161
 162 typedef struct _GSupplicantSSID GSupplicantSSID;
 163
 164 struct scan_ssid {
 165         unsigned char ssid[32];
 166         uint8_t ssid_len;
 167 };
 168
 169 struct _GSupplicantScanParams {
 170         GSList *ssids;
 171
 172         uint8_t num_ssids;
 173
 174         uint8_t num_freqs;
 175         uint16_t *freqs;
 176 };
 177
 178 typedef struct _GSupplicantScanParams GSupplicantScanParams;
 179
 180 struct _GSupplicantPeerParams {
 181         bool master;
 182         char *wps_pin;
 183         char *path;
 184 };
 185
 186 typedef struct _GSupplicantPeerParams GSupplicantPeerParams;
 187
 188 struct _GSupplicantP2PServiceParams {
 189         int version;
 190         char *service;
 191         unsigned char *query;
 192         int query_length;
 193         unsigned char *response;
 194         int response_length;
 195         unsigned char *wfd_ies;
 196         int wfd_ies_length;
 197 };
 198
 199 typedef struct _GSupplicantP2PServiceParams GSupplicantP2PServiceParams;
 200
 201 /* global API */
 202 typedef void (*GSupplicantCountryCallback) (int result,
 203                                                 const char *alpha2,
 204                                                         void *user_data);
 205
 206 int g_supplicant_set_country(const char *alpha2,
 207                                 GSupplicantCountryCallback callback,
 208                                                 const void *user_data);
 209
 210 /* Interface API */
 211 struct _GSupplicantInterface;
 212 struct _GSupplicantPeer;
 213
 214 typedef struct _GSupplicantInterface GSupplicantInterface;
 215 typedef struct _GSupplicantPeer GSupplicantPeer;
 216
 217 typedef void (*GSupplicantInterfaceCallback) (int result,
 218                                         GSupplicantInterface *interface,
 219                                                         void *user_data);
 220
 221 void g_supplicant_interface_cancel(GSupplicantInterface *interface);
 222
 223 int g_supplicant_interface_create(const char *ifname, const char *driver,
 224                                         const char *bridge,
 225                                         GSupplicantInterfaceCallback callback,
 226                                                         void *user_data);
 227 int g_supplicant_interface_remove(GSupplicantInterface *interface,
 228                                         GSupplicantInterfaceCallback callback,
 229                                                         void *user_data);
 230 int g_supplicant_interface_scan(GSupplicantInterface *interface,
 231                                         GSupplicantScanParams *scan_data,
 232                                         GSupplicantInterfaceCallback callback,
 233                                                         void *user_data);
 234
 235 int g_supplicant_interface_p2p_find(GSupplicantInterface *interface,
 236                                         GSupplicantInterfaceCallback callback,
 237                                                         void *user_data);
 238
 239 int g_supplicant_interface_p2p_stop_find(GSupplicantInterface *interface);
 240
 241 int g_supplicant_interface_p2p_connect(GSupplicantInterface *interface,
 242                                         GSupplicantPeerParams *peer_params,
 243                                         GSupplicantInterfaceCallback callback,
 244                                         void *user_data);
 245
 246 int g_supplicant_interface_p2p_disconnect(GSupplicantInterface *interface,
 247                                         GSupplicantPeerParams *peer_params);
 248
 249 int g_supplicant_interface_p2p_listen(GSupplicantInterface *interface,
 250                                                 int period, int interval);
 251
 252 int g_supplicant_interface_p2p_add_service(GSupplicantInterface *interface,
 253                                 GSupplicantInterfaceCallback callback,
 254                                 GSupplicantP2PServiceParams *p2p_service_params,
 255                                 void *user_data);
 256
 257 int g_supplicant_interface_p2p_del_service(GSupplicantInterface *interface,
 258                                 GSupplicantP2PServiceParams *p2p_service_params);
 259
 260 int g_supplicant_set_widi_ies(GSupplicantP2PServiceParams *p2p_service_params,
 261                                         GSupplicantInterfaceCallback callback,
 262                                         void *user_data);
 263
 264 int g_supplicant_interface_connect(GSupplicantInterface *interface,
 265                                         GSupplicantSSID *ssid,
 266                                         GSupplicantInterfaceCallback callback,
 267                                                         void *user_data);
 268
 269 int g_supplicant_interface_disconnect(GSupplicantInterface *interface,
 270                                         GSupplicantInterfaceCallback callback,
 271                                                         void *user_data);
 272
 273 int g_supplicant_interface_set_apscan(GSupplicantInterface *interface,
 274                                                         unsigned int ap_scan);
 275
 276 void g_supplicant_interface_set_data(GSupplicantInterface *interface,
 277                                                                 void *data);
 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);
 290
 291 int g_supplicant_interface_enable_selected_network(GSupplicantInterface *interface,
 292                                                         dbus_bool_t enable);
 293 int g_supplicant_interface_set_country(GSupplicantInterface *interface,
 294                                         GSupplicantCountryCallback callback,
 295                                                         const char *alpha2,
 296                                                         void *user_data);
 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);
 304
 305 /* Network and Peer API */
 306 struct _GSupplicantNetwork;
 307 struct _GSupplicantGroup;
 308
 309 typedef struct _GSupplicantNetwork GSupplicantNetwork;
 310 typedef struct _GSupplicantGroup GSupplicantGroup;
 311
 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);
 326
 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,
 334                                                                 int *length);
 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);
 341
 342 #if defined TIZEN_EXT
 343 /*
 344 * Description: Network client requires additional wifi specific info
 345 */
 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);
 354 #endif
 355
 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);
 369 #endif
 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);
 380 };
 381
 382 typedef struct _GSupplicantCallbacks GSupplicantCallbacks;
 383
 384 int g_supplicant_register(const GSupplicantCallbacks *callbacks);
 385 void g_supplicant_unregister(const GSupplicantCallbacks *callbacks);
 386
 387 static inline
 388 void g_supplicant_free_scan_params(GSupplicantScanParams *scan_params)
 389 {
 390         g_slist_free_full(scan_params->ssids, g_free);
 391         g_free(scan_params->freqs);
 392         g_free(scan_params);
 393 }
 394
 395 #ifdef __cplusplus
 396 }
 397 #endif
 398
 399 #endif /* __G_SUPPLICANT_H */