gsupplicant/gsupplicant.h

   1 /*
   2  *
   3  *  WPA supplicant library with GLib integration
   4  *
   5  *  Copyright (C) 2010  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_GROUP_WEP40                (1 << 0)
  65 #define G_SUPPLICANT_GROUP_WEP104               (1 << 1)
  66 #define G_SUPPLICANT_GROUP_TKIP         (1 << 2)
  67 #define G_SUPPLICANT_GROUP_CCMP         (1 << 3)
  68
  69 #define G_SUPPLICANT_PAIRWISE_NONE      (1 << 0)
  70 #define G_SUPPLICANT_PAIRWISE_TKIP      (1 << 1)
  71 #define G_SUPPLICANT_PAIRWISE_CCMP      (1 << 2)
  72
  73 typedef enum {
  74         G_SUPPLICANT_MODE_UNKNOWN,
  75         G_SUPPLICANT_MODE_INFRA,
  76         G_SUPPLICANT_MODE_IBSS,
  77 } GSupplicantMode;
  78
  79 typedef enum {
  80         G_SUPPLICANT_SECURITY_UNKNOWN,
  81         G_SUPPLICANT_SECURITY_NONE,
  82         G_SUPPLICANT_SECURITY_WEP,
  83         G_SUPPLICANT_SECURITY_PSK,
  84         G_SUPPLICANT_SECURITY_IEEE8021X,
  85 } GSupplicantSecurity;
  86
  87 typedef enum {
  88         G_SUPPLICANT_STATE_UNKNOWN,
  89         G_SUPPLICANT_STATE_DISCONNECTED,
  90         G_SUPPLICANT_STATE_INACTIVE,
  91         G_SUPPLICANT_STATE_SCANNING,
  92         G_SUPPLICANT_STATE_AUTHENTICATING,
  93         G_SUPPLICANT_STATE_ASSOCIATING,
  94         G_SUPPLICANT_STATE_ASSOCIATED,
  95         G_SUPPLICANT_STATE_4WAY_HANDSHAKE,
  96         G_SUPPLICANT_STATE_GROUP_HANDSHAKE,
  97         G_SUPPLICANT_STATE_COMPLETED,
  98 } GSupplicantState;
  99
 100 struct _GSupplicantSSID {
 101         const void *ssid;
 102         unsigned int ssid_len;
 103         GSupplicantMode mode;
 104         GSupplicantSecurity security;
 105         unsigned int eap_method;
 106         char *passphrase;
 107         char *identity;
 108         char *ca_cert_path;
 109         char *client_cert_path;
 110         char *private_key_path;
 111         char *private_key_passphrase;
 112         char *phase2_auth;
 113 };
 114
 115 typedef struct _GSupplicantSSID GSupplicantSSID;
 116
 117 /* Interface API */
 118 struct _GSupplicantInterface;
 119
 120 typedef struct _GSupplicantInterface GSupplicantInterface;
 121
 122 typedef void (*GSupplicantInterfaceCallback) (int result,
 123                                         GSupplicantInterface *interface,
 124                                                         void *user_data);
 125
 126 int g_supplicant_interface_create(const char *ifname, const char *driver,
 127                                         GSupplicantInterfaceCallback callback,
 128                                                         void *user_data);
 129 int g_supplicant_interface_remove(GSupplicantInterface *interface,
 130                                         GSupplicantInterfaceCallback callback,
 131                                                         void *user_data);
 132 int g_supplicant_interface_scan(GSupplicantInterface *interface,
 133                                         GSupplicantInterfaceCallback callback,
 134                                                         void *user_data);
 135
 136 int g_supplicant_interface_connect(GSupplicantInterface *interface,
 137                                         GSupplicantSSID *ssid,
 138                                         GSupplicantInterfaceCallback callback,
 139                                                         void *user_data);
 140
 141 int g_supplicant_interface_disconnect(GSupplicantInterface *interface,
 142                                         GSupplicantInterfaceCallback callback,
 143                                                         void *user_data);
 144
 145 void g_supplicant_interface_set_data(GSupplicantInterface *interface,
 146                                                                 void *data);
 147 const void *g_supplicant_interface_get_data(GSupplicantInterface *interface);
 148 const char *g_supplicant_interface_get_ifname(GSupplicantInterface *interface);
 149 const char *g_supplicant_interface_get_driver(GSupplicantInterface *interface);
 150 GSupplicantState g_supplicant_interface_get_state(GSupplicantInterface *interface);
 151
 152 /* Network API */
 153 struct _GSupplicantNetwork;
 154
 155 typedef struct _GSupplicantNetwork GSupplicantNetwork;
 156
 157 GSupplicantInterface *g_supplicant_network_get_interface(GSupplicantNetwork *network);
 158 const char *g_supplicant_network_get_name(GSupplicantNetwork *network);
 159 const char *g_supplicant_network_get_identifier(GSupplicantNetwork *network);
 160 const char *g_supplicant_network_get_path(GSupplicantNetwork *network);
 161 const void *g_supplicant_network_get_ssid(GSupplicantNetwork *network,
 162                                                         unsigned int *ssid_len);
 163 const char *g_supplicant_network_get_mode(GSupplicantNetwork *network);
 164 const char *g_supplicant_network_get_security(GSupplicantNetwork *network);
 165 dbus_int16_t g_supplicant_network_get_signal(GSupplicantNetwork *network);
 166
 167 struct _GSupplicantCallbacks {
 168         void (*system_ready) (void);
 169         void (*system_killed) (void);
 170         void (*interface_added) (GSupplicantInterface *interface);
 171         void (*interface_state) (GSupplicantInterface *interface);
 172         void (*interface_removed) (GSupplicantInterface *interface);
 173         void (*scan_started) (GSupplicantInterface *interface);
 174         void (*scan_finished) (GSupplicantInterface *interface);
 175         void (*network_added) (GSupplicantNetwork *network);
 176         void (*network_removed) (GSupplicantNetwork *network);
 177 };
 178
 179 typedef struct _GSupplicantCallbacks GSupplicantCallbacks;
 180
 181 int g_supplicant_register(const GSupplicantCallbacks *callbacks);
 182 void g_supplicant_unregister(const GSupplicantCallbacks *callbacks);
 183
 184 #ifdef __cplusplus
 185 }
 186 #endif
 187
 188 #endif /* __G_SUPPLICANT_H */