gsupplicant/gsupplicant.h

   1 /*
   2  *
   3  *  WPA supplicant library with GLib integration
   4  *
   5  *  Copyright (C) 2012  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
  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)
  63
  64 #define G_SUPPLICANT_PROTO_WPA          (1 << 0)
  65 #define G_SUPPLICANT_PROTO_RSN          (1 << 1)
  66
  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)
  71
  72 #define G_SUPPLICANT_PAIRWISE_NONE      (1 << 0)
  73 #define G_SUPPLICANT_PAIRWISE_TKIP      (1 << 1)
  74 #define G_SUPPLICANT_PAIRWISE_CCMP      (1 << 2)
  75
  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)
  80
  81 typedef enum {
  82         G_SUPPLICANT_MODE_UNKNOWN,
  83         G_SUPPLICANT_MODE_INFRA,
  84         G_SUPPLICANT_MODE_IBSS,
  85         G_SUPPLICANT_MODE_MASTER,
  86 } GSupplicantMode;
  87
  88 typedef enum {
  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;
  95
  96 typedef enum {
  97         G_SUPPLICANT_STATE_UNKNOWN,
  98         G_SUPPLICANT_STATE_DISABLED,
  99         G_SUPPLICANT_STATE_DISCONNECTED,
 100         G_SUPPLICANT_STATE_INACTIVE,
 101         G_SUPPLICANT_STATE_SCANNING,
 102         G_SUPPLICANT_STATE_AUTHENTICATING,
 103         G_SUPPLICANT_STATE_ASSOCIATING,
 104         G_SUPPLICANT_STATE_ASSOCIATED,
 105         G_SUPPLICANT_STATE_4WAY_HANDSHAKE,
 106         G_SUPPLICANT_STATE_GROUP_HANDSHAKE,
 107         G_SUPPLICANT_STATE_COMPLETED,
 108 } GSupplicantState;
 109
 110 typedef enum {
 111         G_SUPPLICANT_WPS_STATE_UNKNOWN,
 112         G_SUPPLICANT_WPS_STATE_SUCCESS,
 113         G_SUPPLICANT_WPS_STATE_FAIL,
 114 } GSupplicantWpsState;
 115
 116 struct _GSupplicantSSID {
 117         const void *ssid;
 118         unsigned int ssid_len;
 119         unsigned int scan_ssid;
 120         GSupplicantMode mode;
 121         GSupplicantSecurity security;
 122         unsigned int protocol;
 123         unsigned int pairwise_cipher;
 124         unsigned int group_cipher;
 125         unsigned int freq;
 126         const char *eap;
 127         const char *passphrase;
 128         const char *identity;
 129         const char *ca_cert_path;
 130         const char *client_cert_path;
 131         const char *private_key_path;
 132         const char *private_key_passphrase;
 133         const char *phase2_auth;
 134         dbus_bool_t use_wps;
 135         const char *pin_wps;
 136         const char *bgscan;
 137 };
 138
 139 typedef struct _GSupplicantSSID GSupplicantSSID;
 140
 141 /*
 142  * Max number of SSIDs that can be scanned.
 143  * In wpa_s 0.7x the limit is 4.
 144  * In wps_s 0.8 or later it is 16.
 145  * The value is only used if wpa_supplicant does not return any max limit
 146  * for number of scannable SSIDs.
 147  */
 148 #define WPAS_MAX_SCAN_SSIDS 4
 149
 150 struct scan_ssid {
 151         unsigned char ssid[32];
 152         uint8_t ssid_len;
 153 };
 154
 155 struct _GSupplicantScanParams {
 156         GSList *ssids;
 157
 158         uint8_t num_ssids;
 159
 160         uint16_t *freqs;
 161 };
 162
 163 typedef struct _GSupplicantScanParams GSupplicantScanParams;
 164
 165 /* global API */
 166 typedef void (*GSupplicantCountryCallback) (int result,
 167                                                 const char *alpha2,
 168                                                         void *user_data);
 169
 170 int g_supplicant_set_country(const char *alpha2,
 171                                 GSupplicantCountryCallback callback,
 172                                                 const void *user_data);
 173
 174 /* Interface API */
 175 struct _GSupplicantInterface;
 176
 177 typedef struct _GSupplicantInterface GSupplicantInterface;
 178
 179 typedef void (*GSupplicantInterfaceCallback) (int result,
 180                                         GSupplicantInterface *interface,
 181                                                         void *user_data);
 182
 183 int g_supplicant_interface_create(const char *ifname, const char *driver,
 184                                         const char *bridge,
 185                                         GSupplicantInterfaceCallback callback,
 186                                                         void *user_data);
 187 int g_supplicant_interface_remove(GSupplicantInterface *interface,
 188                                         GSupplicantInterfaceCallback callback,
 189                                                         void *user_data);
 190 int g_supplicant_interface_scan(GSupplicantInterface *interface,
 191                                         GSupplicantScanParams *scan_data,
 192                                         GSupplicantInterfaceCallback callback,
 193                                                         void *user_data);
 194
 195 int g_supplicant_interface_autoscan(GSupplicantInterface *interface,
 196                                         const char *autoscan_data,
 197                                         GSupplicantInterfaceCallback callback,
 198                                                         void *user_data);
 199
 200 int g_supplicant_interface_connect(GSupplicantInterface *interface,
 201                                         GSupplicantSSID *ssid,
 202                                         GSupplicantInterfaceCallback callback,
 203                                                         void *user_data);
 204
 205 int g_supplicant_interface_disconnect(GSupplicantInterface *interface,
 206                                         GSupplicantInterfaceCallback callback,
 207                                                         void *user_data);
 208
 209 int g_supplicant_interface_set_apscan(GSupplicantInterface *interface,
 210                                                         unsigned int ap_scan);
 211
 212 void g_supplicant_interface_set_data(GSupplicantInterface *interface,
 213                                                                 void *data);
 214 void *g_supplicant_interface_get_data(GSupplicantInterface *interface);
 215 const char *g_supplicant_interface_get_ifname(GSupplicantInterface *interface);
 216 const char *g_supplicant_interface_get_driver(GSupplicantInterface *interface);
 217 GSupplicantState g_supplicant_interface_get_state(GSupplicantInterface *interface);
 218 const char *g_supplicant_interface_get_wps_key(GSupplicantInterface *interface);
 219 const void *g_supplicant_interface_get_wps_ssid(GSupplicantInterface *interface,
 220                                                         unsigned int *ssid_len);
 221 GSupplicantWpsState g_supplicant_interface_get_wps_state(GSupplicantInterface *interface);
 222 unsigned int g_supplicant_interface_get_mode(GSupplicantInterface *interface);
 223 dbus_bool_t g_supplicant_interface_get_ready(GSupplicantInterface *interface);
 224 unsigned int g_supplicant_interface_get_max_scan_ssids(
 225                                         GSupplicantInterface *interface);
 226
 227 int g_supplicant_interface_enable_selected_network(GSupplicantInterface *interface,
 228                                                         dbus_bool_t enable);
 229 int g_supplicant_interface_set_country(GSupplicantInterface *interface,
 230                                         GSupplicantCountryCallback callback,
 231                                                         const char *alpha2,
 232                                                         void *user_data);
 233
 234 /* Network API */
 235 struct _GSupplicantNetwork;
 236
 237 typedef struct _GSupplicantNetwork GSupplicantNetwork;
 238
 239 GSupplicantInterface *g_supplicant_network_get_interface(GSupplicantNetwork *network);
 240 const char *g_supplicant_network_get_name(GSupplicantNetwork *network);
 241 const char *g_supplicant_network_get_identifier(GSupplicantNetwork *network);
 242 const char *g_supplicant_network_get_path(GSupplicantNetwork *network);
 243 const void *g_supplicant_network_get_ssid(GSupplicantNetwork *network,
 244                                                         unsigned int *ssid_len);
 245 const char *g_supplicant_network_get_mode(GSupplicantNetwork *network);
 246 const char *g_supplicant_network_get_security(GSupplicantNetwork *network);
 247 dbus_int16_t g_supplicant_network_get_signal(GSupplicantNetwork *network);
 248 dbus_uint16_t g_supplicant_network_get_frequency(GSupplicantNetwork *network);
 249 dbus_bool_t g_supplicant_network_get_wps(GSupplicantNetwork *network);
 250 dbus_bool_t g_supplicant_network_is_wps_active(GSupplicantNetwork *network);
 251 dbus_bool_t g_supplicant_network_is_wps_pbc(GSupplicantNetwork *network);
 252 dbus_bool_t g_supplicant_network_is_wps_advertizing(GSupplicantNetwork *network);
 253
 254 struct _GSupplicantCallbacks {
 255         void (*system_ready) (void);
 256         void (*system_killed) (void);
 257         void (*interface_added) (GSupplicantInterface *interface);
 258         void (*interface_state) (GSupplicantInterface *interface);
 259         void (*interface_removed) (GSupplicantInterface *interface);
 260         void (*scan_started) (GSupplicantInterface *interface);
 261         void (*scan_finished) (GSupplicantInterface *interface);
 262         void (*network_added) (GSupplicantNetwork *network);
 263         void (*network_removed) (GSupplicantNetwork *network);
 264         void (*network_changed) (GSupplicantNetwork *network,
 265                                         const char *property);
 266         void (*debug) (const char *str);
 267 };
 268
 269 typedef struct _GSupplicantCallbacks GSupplicantCallbacks;
 270
 271 int g_supplicant_register(const GSupplicantCallbacks *callbacks);
 272 void g_supplicant_unregister(const GSupplicantCallbacks *callbacks);
 273
 274 static inline
 275 void g_supplicant_free_scan_params(GSupplicantScanParams *scan_params)
 276 {
 277         g_slist_free_full(scan_params->ssids, g_free);
 278         g_free(scan_params->freqs);
 279         g_free(scan_params);
 280 }
 281
 282 #ifdef __cplusplus
 283 }
 284 #endif
 285
 286 #endif /* __G_SUPPLICANT_H */