wlantest/wlantest.h

   1 /*
   2  * wlantest - IEEE 802.11 protocol monitoring and testing tool
   3  * Copyright (c) 2010-2013, Jouni Malinen <j@w1.fi>
   4  *
   5  * This software may be distributed under the terms of the BSD license.
   6  * See README for more details.
   7  */
   8
   9 #ifndef WLANTEST_H
  10 #define WLANTEST_H
  11
  12 #include "utils/list.h"
  13 #include "common/wpa_common.h"
  14 #include "wlantest_ctrl.h"
  15
  16 struct ieee802_11_elems;
  17 struct radius_msg;
  18 struct ieee80211_hdr;
  19 struct wlantest_bss;
  20
  21 #define MAX_RADIUS_SECRET_LEN 128
  22
  23 struct wlantest_radius_secret {
  24         struct dl_list list;
  25         char secret[MAX_RADIUS_SECRET_LEN];
  26 };
  27
  28 struct wlantest_passphrase {
  29         struct dl_list list;
  30         char passphrase[64];
  31         u8 ssid[32];
  32         size_t ssid_len;
  33         u8 bssid[ETH_ALEN];
  34 };
  35
  36 struct wlantest_pmk {
  37         struct dl_list list;
  38         u8 pmk[32];
  39 };
  40
  41 struct wlantest_ptk {
  42         struct dl_list list;
  43         struct wpa_ptk ptk;
  44         size_t ptk_len;
  45 };
  46
  47 struct wlantest_wep {
  48         struct dl_list list;
  49         size_t key_len;
  50         u8 key[13];
  51 };
  52
  53 struct wlantest_sta {
  54         struct dl_list list;
  55         struct wlantest_bss *bss;
  56         u8 addr[ETH_ALEN];
  57         enum {
  58                 STATE1 /* not authenticated */,
  59                 STATE2 /* authenticated */,
  60                 STATE3 /* associated */
  61         } state;
  62         u16 aid;
  63         u8 rsnie[257]; /* WPA/RSN IE */
  64         u8 osenie[257]; /* OSEN IE */
  65         int proto;
  66         int pairwise_cipher;
  67         int group_cipher;
  68         int key_mgmt;
  69         int rsn_capab;
  70         u8 anonce[32]; /* ANonce from the previous EAPOL-Key msg 1/4 or 3/4 */
  71         u8 snonce[32]; /* SNonce from the previous EAPOL-Key msg 2/4 */
  72         struct wpa_ptk ptk; /* Derived PTK */
  73         int ptk_set;
  74         struct wpa_ptk tptk; /* Derived PTK during rekeying */
  75         int tptk_set;
  76         u8 rsc_tods[16 + 1][6];
  77         u8 rsc_fromds[16 + 1][6];
  78         u8 ap_sa_query_tr[2];
  79         u8 sta_sa_query_tr[2];
  80         u32 counters[NUM_WLANTEST_STA_COUNTER];
  81         u16 assocreq_capab_info;
  82         u16 assocreq_listen_int;
  83         u8 *assocreq_ies;
  84         size_t assocreq_ies_len;
  85
  86         /* Last ICMP Echo request information */
  87         u32 icmp_echo_req_src;
  88         u32 icmp_echo_req_dst;
  89         u16 icmp_echo_req_id;
  90         u16 icmp_echo_req_seq;
  91
  92         le16 seq_ctrl_to_sta[17];
  93         le16 seq_ctrl_to_ap[17];
  94
  95         int pwrmgt;
  96         int pspoll;
  97
  98         u8 gtk[32];
  99         size_t gtk_len;
 100         int gtk_idx;
 101
 102         u32 tx_tid[16 + 1];
 103         u32 rx_tid[16 + 1];
 104 };
 105
 106 struct wlantest_tdls {
 107         struct dl_list list;
 108         struct wlantest_sta *init;
 109         struct wlantest_sta *resp;
 110         struct tpk {
 111                 u8 kck[16];
 112                 u8 tk[16];
 113         } tpk;
 114         int link_up;
 115         u8 dialog_token;
 116         u8 rsc_init[16 + 1][6];
 117         u8 rsc_resp[16 + 1][6];
 118         u32 counters[NUM_WLANTEST_TDLS_COUNTER];
 119         u8 inonce[32];
 120         u8 rnonce[32];
 121 };
 122
 123 struct wlantest_bss {
 124         struct dl_list list;
 125         u8 bssid[ETH_ALEN];
 126         u16 capab_info;
 127         u16 prev_capab_info;
 128         u8 ssid[32];
 129         size_t ssid_len;
 130         int proberesp_seen;
 131         int parse_error_reported;
 132         u8 wpaie[257];
 133         u8 rsnie[257];
 134         u8 osenie[257];
 135         int proto;
 136         int pairwise_cipher;
 137         int group_cipher;
 138         int mgmt_group_cipher;
 139         int key_mgmt;
 140         int rsn_capab;
 141         struct dl_list sta; /* struct wlantest_sta */
 142         struct dl_list pmk; /* struct wlantest_pmk */
 143         u8 gtk[4][32];
 144         size_t gtk_len[4];
 145         int gtk_idx;
 146         u8 rsc[4][6];
 147         u8 igtk[6][16];
 148         int igtk_set[6];
 149         int igtk_idx;
 150         u8 ipn[6][6];
 151         u32 counters[NUM_WLANTEST_BSS_COUNTER];
 152         struct dl_list tdls; /* struct wlantest_tdls */
 153 };
 154
 155 struct wlantest_radius {
 156         struct dl_list list;
 157         u32 srv;
 158         u32 cli;
 159         struct radius_msg *last_req;
 160 };
 161
 162
 163 #define MAX_CTRL_CONNECTIONS 10
 164 #define MAX_NOTES 10
 165
 166 struct wlantest {
 167         int monitor_sock;
 168         int monitor_wired;
 169
 170         int ctrl_sock;
 171         int ctrl_socks[MAX_CTRL_CONNECTIONS];
 172
 173         struct dl_list passphrase; /* struct wlantest_passphrase */
 174         struct dl_list bss; /* struct wlantest_bss */
 175         struct dl_list secret; /* struct wlantest_radius_secret */
 176         struct dl_list radius; /* struct wlantest_radius */
 177         struct dl_list pmk; /* struct wlantest_pmk */
 178         struct dl_list ptk; /* struct wlantest_ptk */
 179         struct dl_list wep; /* struct wlantest_wep */
 180
 181         unsigned int rx_mgmt;
 182         unsigned int rx_ctrl;
 183         unsigned int rx_data;
 184         unsigned int fcs_error;
 185
 186         void *write_pcap; /* pcap_t* */
 187         void *write_pcap_dumper; /* pcpa_dumper_t */
 188         struct timeval write_pcap_time;
 189         u8 *decrypted;
 190         size_t decrypted_len;
 191         FILE *pcapng;
 192         u32 write_pcapng_time_high;
 193         u32 write_pcapng_time_low;
 194
 195         u8 last_hdr[30];
 196         size_t last_len;
 197         int last_mgmt_valid;
 198
 199         unsigned int assume_fcs:1;
 200
 201         char *notes[MAX_NOTES];
 202         size_t num_notes;
 203
 204         const char *write_file;
 205         const char *pcapng_file;
 206 };
 207
 208 void add_note(struct wlantest *wt, int level, const char *fmt, ...)
 209 PRINTF_FORMAT(3, 4);
 210 void clear_notes(struct wlantest *wt);
 211 size_t notes_len(struct wlantest *wt, size_t hdrlen);
 212
 213 int add_wep(struct wlantest *wt, const char *key);
 214 int read_cap_file(struct wlantest *wt, const char *fname);
 215 int read_wired_cap_file(struct wlantest *wt, const char *fname);
 216
 217 int write_pcap_init(struct wlantest *wt, const char *fname);
 218 void write_pcap_deinit(struct wlantest *wt);
 219 void write_pcap_captured(struct wlantest *wt, const u8 *buf, size_t len);
 220 void write_pcap_decrypted(struct wlantest *wt, const u8 *buf1, size_t len1,
 221                           const u8 *buf2, size_t len2);
 222
 223 int write_pcapng_init(struct wlantest *wt, const char *fname);
 224 void write_pcapng_deinit(struct wlantest *wt);
 225 struct pcap_pkthdr;
 226 void write_pcapng_write_read(struct wlantest *wt, int dlt,
 227                              struct pcap_pkthdr *hdr, const u8 *data);
 228 void write_pcapng_captured(struct wlantest *wt, const u8 *buf, size_t len);
 229
 230 void wlantest_process(struct wlantest *wt, const u8 *data, size_t len);
 231 void wlantest_process_prism(struct wlantest *wt, const u8 *data, size_t len);
 232 void wlantest_process_80211(struct wlantest *wt, const u8 *data, size_t len);
 233 void wlantest_process_wired(struct wlantest *wt, const u8 *data, size_t len);
 234 u32 crc32(const u8 *frame, size_t frame_len);
 235 int monitor_init(struct wlantest *wt, const char *ifname);
 236 int monitor_init_wired(struct wlantest *wt, const char *ifname);
 237 void monitor_deinit(struct wlantest *wt);
 238 void rx_mgmt(struct wlantest *wt, const u8 *data, size_t len);
 239 void rx_mgmt_ack(struct wlantest *wt, const struct ieee80211_hdr *hdr);
 240 void rx_data(struct wlantest *wt, const u8 *data, size_t len);
 241 void rx_data_eapol(struct wlantest *wt, const u8 *dst, const u8 *src,
 242                    const u8 *data, size_t len, int prot);
 243 void rx_data_ip(struct wlantest *wt, const u8 *bssid, const u8 *sta_addr,
 244                 const u8 *dst, const u8 *src, const u8 *data, size_t len,
 245                 const u8 *peer_addr);
 246 void rx_data_80211_encap(struct wlantest *wt, const u8 *bssid,
 247                          const u8 *sta_addr, const u8 *dst, const u8 *src,
 248                          const u8 *data, size_t len);
 249
 250 struct wlantest_bss * bss_find(struct wlantest *wt, const u8 *bssid);
 251 struct wlantest_bss * bss_get(struct wlantest *wt, const u8 *bssid);
 252 void bss_deinit(struct wlantest_bss *bss);
 253 void bss_update(struct wlantest *wt, struct wlantest_bss *bss,
 254                 struct ieee802_11_elems *elems);
 255 void bss_flush(struct wlantest *wt);
 256 int bss_add_pmk_from_passphrase(struct wlantest_bss *bss,
 257                                 const char *passphrase);
 258 void pmk_deinit(struct wlantest_pmk *pmk);
 259 void tdls_deinit(struct wlantest_tdls *tdls);
 260
 261 struct wlantest_sta * sta_find(struct wlantest_bss *bss, const u8 *addr);
 262 struct wlantest_sta * sta_get(struct wlantest_bss *bss, const u8 *addr);
 263 void sta_deinit(struct wlantest_sta *sta);
 264 void sta_update_assoc(struct wlantest_sta *sta,
 265                       struct ieee802_11_elems *elems);
 266
 267 u8 * ccmp_decrypt(const u8 *tk, const struct ieee80211_hdr *hdr,
 268                   const u8 *data, size_t data_len, size_t *decrypted_len);
 269 u8 * ccmp_encrypt(const u8 *tk, u8 *frame, size_t len, size_t hdrlen, u8 *qos,
 270                   u8 *pn, int keyid, size_t *encrypted_len);
 271 void ccmp_get_pn(u8 *pn, const u8 *data);
 272 u8 * ccmp_256_decrypt(const u8 *tk, const struct ieee80211_hdr *hdr,
 273                       const u8 *data, size_t data_len, size_t *decrypted_len);
 274 u8 * ccmp_256_encrypt(const u8 *tk, u8 *frame, size_t len, size_t hdrlen,
 275                       u8 *qos, u8 *pn, int keyid, size_t *encrypted_len);
 276
 277 u8 * tkip_decrypt(const u8 *tk, const struct ieee80211_hdr *hdr,
 278                   const u8 *data, size_t data_len, size_t *decrypted_len);
 279 u8 * tkip_encrypt(const u8 *tk, u8 *frame, size_t len, size_t hdrlen, u8 *qos,
 280                   u8 *pn, int keyid, size_t *encrypted_len);
 281 void tkip_get_pn(u8 *pn, const u8 *data);
 282
 283 u8 * wep_decrypt(struct wlantest *wt, const struct ieee80211_hdr *hdr,
 284                  const u8 *data, size_t data_len, size_t *decrypted_len);
 285
 286 u8 * bip_protect(const u8 *igtk, u8 *frame, size_t len, u8 *ipn, int keyid,
 287                  size_t *prot_len);
 288 u8 * bip_gmac_protect(const u8 *igtk, size_t igtk_len, u8 *frame, size_t len,
 289                       u8 *ipn, int keyid, size_t *prot_len);
 290
 291 u8 * gcmp_decrypt(const u8 *tk, size_t tk_len, const struct ieee80211_hdr *hdr,
 292                   const u8 *data, size_t data_len, size_t *decrypted_len);
 293 u8 * gcmp_encrypt(const u8 *tk, size_t tk_len, u8 *frame, size_t len,
 294                   size_t hdrlen, u8 *qos,
 295                   u8 *pn, int keyid, size_t *encrypted_len);
 296
 297 int ctrl_init(struct wlantest *wt);
 298 void ctrl_deinit(struct wlantest *wt);
 299
 300 int wlantest_inject(struct wlantest *wt, struct wlantest_bss *bss,
 301                     struct wlantest_sta *sta, u8 *frame, size_t len,
 302                     enum wlantest_inject_protection prot);
 303
 304 int wlantest_relog(struct wlantest *wt);
 305
 306 #endif /* WLANTEST_H */