driver.h revision bd567ad93e03f285fdad93464100148cd5ae7941
18d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/* 28d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Driver interface definition 38d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Copyright (c) 2003-2010, Jouni Malinen <j@w1.fi> 48d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 58d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This program is free software; you can redistribute it and/or modify 68d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * it under the terms of the GNU General Public License version 2 as 78d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * published by the Free Software Foundation. 88d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 98d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Alternatively, this software may be distributed under the terms of BSD 108d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * license. 118d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 128d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * See README and COPYING for more details. 138d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 148d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This file defines a driver interface used by both %wpa_supplicant and 158d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * hostapd. The first part of the file defines data structures used in various 168d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * driver operations. This is followed by the struct wpa_driver_ops that each 178d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * driver wrapper will beed to define with callback functions for requesting 188d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * driver operations. After this, there are definitions for driver event 198d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * reporting with wpa_supplicant_event() and some convenience helper functions 208d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * that can be used to report events. 218d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 228d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 238d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#ifndef DRIVER_H 248d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define DRIVER_H 258d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 268d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define WPA_SUPPLICANT_DRIVER_VERSION 4 278d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 288d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#include "common/defs.h" 298d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 308d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define HOSTAPD_CHAN_DISABLED 0x00000001 318d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define HOSTAPD_CHAN_PASSIVE_SCAN 0x00000002 328d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define HOSTAPD_CHAN_NO_IBSS 0x00000004 338d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define HOSTAPD_CHAN_RADAR 0x00000008 348d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define HOSTAPD_CHAN_HT40PLUS 0x00000010 358d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define HOSTAPD_CHAN_HT40MINUS 0x00000020 368d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define HOSTAPD_CHAN_HT40 0x00000040 378d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 388d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/** 398d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * struct hostapd_channel_data - Channel information 408d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 418d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtstruct hostapd_channel_data { 428d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 438d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * chan - Channel number (IEEE 802.11) 448d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 458d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt short chan; 468d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 478d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 488d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * freq - Frequency in MHz 498d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 508d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt short freq; 518d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 528d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 538d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * flag - Channel flags (HOSTAPD_CHAN_*) 548d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 558d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int flag; 568d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 578d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 588d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * max_tx_power - maximum transmit power in dBm 598d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 608d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt u8 max_tx_power; 618d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt}; 628d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 638d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/** 648d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * struct hostapd_hw_modes - Supported hardware mode information 658d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 668d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtstruct hostapd_hw_modes { 678d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 688d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * mode - Hardware mode 698d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 708d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt enum hostapd_hw_mode mode; 718d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 728d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 738d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * num_channels - Number of entries in the channels array 748d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 758d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int num_channels; 768d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 778d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 788d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * channels - Array of supported channels 798d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 808d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt struct hostapd_channel_data *channels; 818d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 828d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 838d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * num_rates - Number of entries in the rates array 848d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 858d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int num_rates; 868d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 878d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 888d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * rates - Array of supported rates in 100 kbps units 898d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 908d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int *rates; 918d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 928d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 938d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * ht_capab - HT (IEEE 802.11n) capabilities 948d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 958d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt u16 ht_capab; 968d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 978d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 988d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * mcs_set - MCS (IEEE 802.11n) rate parameters 998d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 1008d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt u8 mcs_set[16]; 1018d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 1028d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 1038d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * a_mpdu_params - A-MPDU (IEEE 802.11n) parameters 1048d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 1058d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt u8 a_mpdu_params; 1068d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt}; 1078d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 1088d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 1098d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define IEEE80211_MODE_INFRA 0 1108d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define IEEE80211_MODE_IBSS 1 1118d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define IEEE80211_MODE_AP 2 1128d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 1138d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define IEEE80211_CAP_ESS 0x0001 1148d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define IEEE80211_CAP_IBSS 0x0002 1158d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define IEEE80211_CAP_PRIVACY 0x0010 1168d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 1178d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define WPA_SCAN_QUAL_INVALID BIT(0) 1188d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define WPA_SCAN_NOISE_INVALID BIT(1) 1198d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define WPA_SCAN_LEVEL_INVALID BIT(2) 1208d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define WPA_SCAN_LEVEL_DBM BIT(3) 1218d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define WPA_SCAN_AUTHENTICATED BIT(4) 1228d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define WPA_SCAN_ASSOCIATED BIT(5) 1238d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 1248d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/** 1258d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * struct wpa_scan_res - Scan result for an BSS/IBSS 1268d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @flags: information flags about the BSS/IBSS (WPA_SCAN_*) 1278d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @bssid: BSSID 1288d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @freq: frequency of the channel in MHz (e.g., 2412 = channel 1) 1298d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @beacon_int: beacon interval in TUs (host byte order) 1308d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @caps: capability information field in host byte order 1318d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @qual: signal quality 1328d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @noise: noise level 1338d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @level: signal level 1348d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @tsf: Timestamp 1358d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @age: Age of the information in milliseconds (i.e., how many milliseconds 1368d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * ago the last Beacon or Probe Response frame was received) 1378d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @ie_len: length of the following IE field in octets 1388d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @beacon_ie_len: length of the following Beacon IE field in octets 1398d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 1408d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This structure is used as a generic format for scan results from the 1418d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * driver. Each driver interface implementation is responsible for converting 1428d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * the driver or OS specific scan results into this format. 1438d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 1448d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * If the driver does not support reporting all IEs, the IE data structure is 1458d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * constructed of the IEs that are available. This field will also need to 1468d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * include SSID in IE format. All drivers are encouraged to be extended to 1478d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * report all IEs to make it easier to support future additions. 1488d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 1498d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtstruct wpa_scan_res { 1508d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt unsigned int flags; 1518d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt u8 bssid[ETH_ALEN]; 1528d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int freq; 1538d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt u16 beacon_int; 1548d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt u16 caps; 1558d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int qual; 1568d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int noise; 1578d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int level; 1588d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt u64 tsf; 1598d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt unsigned int age; 1608d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt size_t ie_len; 1618d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt size_t beacon_ie_len; 1628d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /* 1638d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Followed by ie_len octets of IEs from Probe Response frame (or if 1648d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * the driver does not indicate source of IEs, these may also be from 1658d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Beacon frame). After the first set of IEs, another set of IEs may 1668d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * follow (with beacon_ie_len octets of data) if the driver provides 1678d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * both IE sets. 1688d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 1698d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt}; 1708d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 1718d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/** 1728d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * struct wpa_scan_results - Scan results 1738d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @res: Array of pointers to allocated variable length scan result entries 1748d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @num: Number of entries in the scan result array 1758d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 1768d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtstruct wpa_scan_results { 1778d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt struct wpa_scan_res **res; 1788d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt size_t num; 1798d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt}; 1808d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 1818d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/** 1828d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * struct wpa_interface_info - Network interface information 1838d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @next: Pointer to the next interface or NULL if this is the last one 1848d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @ifname: Interface name that can be used with init() or init2() 1858d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @desc: Human readable adapter description (e.g., vendor/model) or NULL if 1868d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * not available 1878d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @drv_name: struct wpa_driver_ops::name (note: unlike other strings, this one 1888d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * is not an allocated copy, i.e., get_interfaces() caller will not free 1898d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * this) 1908d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 1918d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtstruct wpa_interface_info { 1928d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt struct wpa_interface_info *next; 1938d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt char *ifname; 1948d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt char *desc; 1958d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const char *drv_name; 1968d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt}; 1978d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 1988d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define WPAS_MAX_SCAN_SSIDS 4 1998d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 2008d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/** 2018d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * struct wpa_driver_scan_params - Scan parameters 2028d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Data for struct wpa_driver_ops::scan2(). 2038d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 2048d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtstruct wpa_driver_scan_params { 2058d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 2068d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * ssids - SSIDs to scan for 2078d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 2088d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt struct wpa_driver_scan_ssid { 2098d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 2108d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * ssid - specific SSID to scan for (ProbeReq) 2118d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * %NULL or zero-length SSID is used to indicate active scan 2128d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * with wildcard SSID. 2138d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 2148d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *ssid; 2158d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 2168d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * ssid_len: Length of the SSID in octets 2178d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 2188d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt size_t ssid_len; 2198d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt } ssids[WPAS_MAX_SCAN_SSIDS]; 2208d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 2218d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 2228d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * num_ssids - Number of entries in ssids array 2238d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Zero indicates a request for a passive scan. 2248d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 2258d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt size_t num_ssids; 2268d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 2278d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 2288d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * extra_ies - Extra IE(s) to add into Probe Request or %NULL 2298d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 2308d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *extra_ies; 2318d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 2328d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 2338d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * extra_ies_len - Length of extra_ies in octets 2348d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 2358d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt size_t extra_ies_len; 2368d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 2378d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 2388d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * freqs - Array of frequencies to scan or %NULL for all frequencies 2398d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 2408d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * The frequency is set in MHz. The array is zero-terminated. 2418d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 2428d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int *freqs; 2438d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 2448d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 2458d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * filter_ssids - Filter for reporting SSIDs 2468d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 2478d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This optional parameter can be used to request the driver wrapper to 2488d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * filter scan results to include only the specified SSIDs. %NULL 2498d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * indicates that no filtering is to be done. This can be used to 2508d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * reduce memory needs for scan results in environments that have large 2518d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * number of APs with different SSIDs. 2528d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 2538d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * The driver wrapper is allowed to take this allocated buffer into its 2548d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * own use by setting the pointer to %NULL. In that case, the driver 2558d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * wrapper is responsible for freeing the buffer with os_free() once it 2568d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * is not needed anymore. 2578d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 2588d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt struct wpa_driver_scan_filter { 2598d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt u8 ssid[32]; 2608d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt size_t ssid_len; 2618d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt } *filter_ssids; 2628d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 2638d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 2648d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * num_filter_ssids - Number of entries in filter_ssids array 2658d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 2668d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt size_t num_filter_ssids; 2678d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt}; 2688d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 2698d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/** 2708d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * struct wpa_driver_auth_params - Authentication parameters 2718d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Data for struct wpa_driver_ops::authenticate(). 2728d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 2738d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtstruct wpa_driver_auth_params { 2748d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int freq; 2758d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *bssid; 2768d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *ssid; 2778d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt size_t ssid_len; 2788d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int auth_alg; 2798d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *ie; 2808d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt size_t ie_len; 2818d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *wep_key[4]; 2828d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt size_t wep_key_len[4]; 2838d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int wep_tx_keyidx; 2848d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int local_state_change; 2858d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt}; 2868d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 2878d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtenum wps_mode { 2888d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt WPS_MODE_NONE /* no WPS provisioning being used */, 2898d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt WPS_MODE_OPEN /* WPS provisioning with AP that is in open mode */, 2908d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt WPS_MODE_PRIVACY /* WPS provisioning with AP that is using protection 2918d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 2928d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt}; 2938d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 2948d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/** 2958d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * struct wpa_driver_associate_params - Association parameters 2968d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Data for struct wpa_driver_ops::associate(). 2978d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 2988d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtstruct wpa_driver_associate_params { 2998d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 3008d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * bssid - BSSID of the selected AP 3018d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This can be %NULL, if ap_scan=2 mode is used and the driver is 3028d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * responsible for selecting with which BSS to associate. */ 3038d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *bssid; 3048d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 3058d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 3068d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * ssid - The selected SSID 3078d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 3088d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *ssid; 3098d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 3108d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 3118d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * ssid_len - Length of the SSID (1..32) 3128d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 3138d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt size_t ssid_len; 3148d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 3158d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 3168d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * freq - Frequency of the channel the selected AP is using 3178d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Frequency that the selected AP is using (in MHz as 3188d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * reported in the scan results) 3198d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 3208d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int freq; 3218d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 3228d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 3238d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * wpa_ie - WPA information element for (Re)Association Request 3248d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * WPA information element to be included in (Re)Association 3258d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Request (including information element id and length). Use 3268d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * of this WPA IE is optional. If the driver generates the WPA 3278d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * IE, it can use pairwise_suite, group_suite, and 3288d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * key_mgmt_suite to select proper algorithms. In this case, 3298d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * the driver has to notify wpa_supplicant about the used WPA 3308d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * IE by generating an event that the interface code will 3318d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * convert into EVENT_ASSOCINFO data (see below). 3328d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 3338d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * When using WPA2/IEEE 802.11i, wpa_ie is used for RSN IE 3348d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * instead. The driver can determine which version is used by 3358d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * looking at the first byte of the IE (0xdd for WPA, 0x30 for 3368d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * WPA2/RSN). 3378d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 3388d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * When using WPS, wpa_ie is used for WPS IE instead of WPA/RSN IE. 3398d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 3408d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *wpa_ie; 3418d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 3428d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 3438d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * wpa_ie_len - length of the wpa_ie 3448d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 3458d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt size_t wpa_ie_len; 3468d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 3478d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 3488d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * pairwise_suite - Selected pairwise cipher suite 3498d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 3508d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This is usually ignored if @wpa_ie is used. 3518d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 3528d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt enum wpa_cipher pairwise_suite; 3538d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 3548d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 3558d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * group_suite - Selected group cipher suite 3568d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 3578d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This is usually ignored if @wpa_ie is used. 3588d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 3598d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt enum wpa_cipher group_suite; 3608d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 3618d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 3628d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * key_mgmt_suite - Selected key management suite 3638d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 3648d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This is usually ignored if @wpa_ie is used. 3658d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 3668d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt enum wpa_key_mgmt key_mgmt_suite; 3678d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 3688d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 3698d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * auth_alg - Allowed authentication algorithms 3708d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Bit field of WPA_AUTH_ALG_* 3718d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 3728d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int auth_alg; 3738d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 3748d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 3758d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * mode - Operation mode (infra/ibss) IEEE80211_MODE_* 3768d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 3778d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int mode; 3788d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 3798d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 3808d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * wep_key - WEP keys for static WEP configuration 3818d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 3828d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *wep_key[4]; 3838d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 3848d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 3858d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * wep_key_len - WEP key length for static WEP configuration 3868d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 3878d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt size_t wep_key_len[4]; 3888d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 3898d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 3908d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * wep_tx_keyidx - WEP TX key index for static WEP configuration 3918d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 3928d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int wep_tx_keyidx; 3938d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 3948d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 3958d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * mgmt_frame_protection - IEEE 802.11w management frame protection 3968d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 3978d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt enum mfp_options mgmt_frame_protection; 3988d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 3998d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 4008d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * ft_ies - IEEE 802.11r / FT information elements 4018d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * If the supplicant is using IEEE 802.11r (FT) and has the needed keys 4028d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * for fast transition, this parameter is set to include the IEs that 4038d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * are to be sent in the next FT Authentication Request message. 4048d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * update_ft_ies() handler is called to update the IEs for further 4058d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * FT messages in the sequence. 4068d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 4078d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * The driver should use these IEs only if the target AP is advertising 4088d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * the same mobility domain as the one included in the MDIE here. 4098d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 4108d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * In ap_scan=2 mode, the driver can use these IEs when moving to a new 4118d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * AP after the initial association. These IEs can only be used if the 4128d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * target AP is advertising support for FT and is using the same MDIE 4138d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * and SSID as the current AP. 4148d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 4158d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * The driver is responsible for reporting the FT IEs received from the 4168d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * AP's response using wpa_supplicant_event() with EVENT_FT_RESPONSE 4178d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * type. update_ft_ies() handler will then be called with the FT IEs to 4188d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * include in the next frame in the authentication sequence. 4198d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 4208d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *ft_ies; 4218d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 4228d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 4238d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * ft_ies_len - Length of ft_ies in bytes 4248d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 4258d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt size_t ft_ies_len; 4268d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 4278d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 4288d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * ft_md - FT Mobility domain (6 octets) (also included inside ft_ies) 4298d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 4308d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This value is provided to allow the driver interface easier access 4318d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * to the current mobility domain. This value is set to %NULL if no 4328d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * mobility domain is currently active. 4338d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 4348d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *ft_md; 4358d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 4368d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 4378d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * passphrase - RSN passphrase for PSK 4388d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 4398d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This value is made available only for WPA/WPA2-Personal (PSK) and 4408d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * only for drivers that set WPA_DRIVER_FLAGS_4WAY_HANDSHAKE. This is 4418d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * the 8..63 character ASCII passphrase, if available. Please note that 4428d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * this can be %NULL if passphrase was not used to generate the PSK. In 4438d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * that case, the psk field must be used to fetch the PSK. 4448d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 4458d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const char *passphrase; 4468d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 4478d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 4488d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * psk - RSN PSK (alternative for passphrase for PSK) 4498d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 4508d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This value is made available only for WPA/WPA2-Personal (PSK) and 4518d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * only for drivers that set WPA_DRIVER_FLAGS_4WAY_HANDSHAKE. This is 4528d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * the 32-octet (256-bit) PSK, if available. The driver wrapper should 4538d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * be prepared to handle %NULL value as an error. 4548d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 4558d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *psk; 4568d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 4578d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 4588d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * drop_unencrypted - Enable/disable unencrypted frame filtering 4598d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 4608d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Configure the driver to drop all non-EAPOL frames (both receive and 4618d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * transmit paths). Unencrypted EAPOL frames (ethertype 0x888e) must 4628d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * still be allowed for key negotiation. 4638d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 4648d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int drop_unencrypted; 4658d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 4668d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 4678d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * prev_bssid - Previously used BSSID in this ESS 4688d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 4698d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * When not %NULL, this is a request to use reassociation instead of 4708d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * association. 4718d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 4728d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *prev_bssid; 4738d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 4748d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 4758d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * wps - WPS mode 4768d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 4778d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * If the driver needs to do special configuration for WPS association, 4788d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * this variable provides more information on what type of association 4798d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * is being requested. Most drivers should not need ot use this. 4808d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 4818d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt enum wps_mode wps; 4828d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 4838d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 4848d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * p2p - Whether this connection is a P2P group 4858d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 4868d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int p2p; 4878d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 4888d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 4898d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * uapsd - UAPSD parameters for the network 4908d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * -1 = do not change defaults 4918d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * AP mode: 1 = enabled, 0 = disabled 4928d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * STA mode: bits 0..3 UAPSD enabled for VO,VI,BK,BE 4938d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 4948d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int uapsd; 4958d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt}; 4968d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 4978d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/** 4988d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * struct wpa_driver_capa - Driver capability information 4998d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 5008d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtstruct wpa_driver_capa { 5018d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define WPA_DRIVER_CAPA_KEY_MGMT_WPA 0x00000001 5028d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define WPA_DRIVER_CAPA_KEY_MGMT_WPA2 0x00000002 5038d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define WPA_DRIVER_CAPA_KEY_MGMT_WPA_PSK 0x00000004 5048d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define WPA_DRIVER_CAPA_KEY_MGMT_WPA2_PSK 0x00000008 5058d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define WPA_DRIVER_CAPA_KEY_MGMT_WPA_NONE 0x00000010 5068d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define WPA_DRIVER_CAPA_KEY_MGMT_FT 0x00000020 5078d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define WPA_DRIVER_CAPA_KEY_MGMT_FT_PSK 0x00000040 5088d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt unsigned int key_mgmt; 5098d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 5108d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define WPA_DRIVER_CAPA_ENC_WEP40 0x00000001 5118d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define WPA_DRIVER_CAPA_ENC_WEP104 0x00000002 5128d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define WPA_DRIVER_CAPA_ENC_TKIP 0x00000004 5138d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define WPA_DRIVER_CAPA_ENC_CCMP 0x00000008 5148d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt unsigned int enc; 5158d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 5168d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define WPA_DRIVER_AUTH_OPEN 0x00000001 5178d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define WPA_DRIVER_AUTH_SHARED 0x00000002 5188d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define WPA_DRIVER_AUTH_LEAP 0x00000004 5198d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt unsigned int auth; 5208d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 5218d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/* Driver generated WPA/RSN IE */ 5228d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define WPA_DRIVER_FLAGS_DRIVER_IE 0x00000001 5238d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/* Driver needs static WEP key setup after association command */ 5248d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define WPA_DRIVER_FLAGS_SET_KEYS_AFTER_ASSOC 0x00000002 5258d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define WPA_DRIVER_FLAGS_USER_SPACE_MLME 0x00000004 5268d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/* Driver takes care of RSN 4-way handshake internally; PMK is configured with 5278d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * struct wpa_driver_ops::set_key using alg = WPA_ALG_PMK */ 5288d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define WPA_DRIVER_FLAGS_4WAY_HANDSHAKE 0x00000008 5298d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define WPA_DRIVER_FLAGS_WIRED 0x00000010 5308d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/* Driver provides separate commands for authentication and association (SME in 5318d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * wpa_supplicant). */ 5328d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define WPA_DRIVER_FLAGS_SME 0x00000020 5338d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/* Driver supports AP mode */ 5348d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define WPA_DRIVER_FLAGS_AP 0x00000040 5358d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/* Driver needs static WEP key setup after association has been completed */ 5368d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define WPA_DRIVER_FLAGS_SET_KEYS_AFTER_ASSOC_DONE 0x00000080 5378d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/* Driver takes care of P2P management operations */ 5388d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define WPA_DRIVER_FLAGS_P2P_MGMT 0x00000100 5398d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/* Driver supports concurrent P2P operations */ 5408d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define WPA_DRIVER_FLAGS_P2P_CONCURRENT 0x00000200 5418d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/* 5428d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Driver uses the initial interface as a dedicated management interface, i.e., 5438d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * it cannot be used for P2P group operations or non-P2P purposes. 5448d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 5458d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define WPA_DRIVER_FLAGS_P2P_DEDICATED_INTERFACE 0x00000400 5468d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/* This interface is P2P capable (P2P Device, GO, or P2P Client */ 5478d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define WPA_DRIVER_FLAGS_P2P_CAPABLE 0x00000800 5488d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/* Driver supports concurrent operations on multiple channels */ 5498d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define WPA_DRIVER_FLAGS_MULTI_CHANNEL_CONCURRENT 0x00001000 5508d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/* 5518d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Driver uses the initial interface for P2P management interface and non-P2P 5528d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * purposes (e.g., connect to infra AP), but this interface cannot be used for 5538d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * P2P group operations. 5548d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 5558d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define WPA_DRIVER_FLAGS_P2P_MGMT_AND_NON_P2P 0x00002000 5568d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/* 5578d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Driver is known to use sane error codes, i.e., when it indicates that 5588d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * something (e.g., association) fails, there was indeed a failure and the 5598d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * operation does not end up getting completed successfully later. 5608d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 5618d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define WPA_DRIVER_FLAGS_SANE_ERROR_CODES 0x00004000 5628d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/* Driver supports off-channel TX */ 5638d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define WPA_DRIVER_FLAGS_OFFCHANNEL_TX 0x00008000 5648d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/* Driver indicates TX status events for EAPOL Data frames */ 5658d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define WPA_DRIVER_FLAGS_EAPOL_TX_STATUS 0x00010000 5668d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt unsigned int flags; 5678d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 5688d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int max_scan_ssids; 5698d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 5708d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 5718d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * max_remain_on_chan - Maximum remain-on-channel duration in msec 5728d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 5738d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt unsigned int max_remain_on_chan; 5748d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 5758d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 5768d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * max_stations - Maximum number of associated stations the driver 5778d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * supports in AP mode 5788d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 5798d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt unsigned int max_stations; 5808d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt}; 5818d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 5828d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 5838d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtstruct hostapd_data; 5848d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 5858d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtstruct hostap_sta_driver_data { 5868d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt unsigned long rx_packets, tx_packets, rx_bytes, tx_bytes; 5878d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt unsigned long current_tx_rate; 5888d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt unsigned long inactive_msec; 5898d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt unsigned long flags; 5908d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt unsigned long num_ps_buf_frames; 5918d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt unsigned long tx_retry_failed; 5928d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt unsigned long tx_retry_count; 5938d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int last_rssi; 5948d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int last_ack_rssi; 5958d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt}; 5968d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 5978d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtstruct hostapd_sta_add_params { 5988d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *addr; 5998d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt u16 aid; 6008d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt u16 capability; 6018d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *supp_rates; 6028d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt size_t supp_rates_len; 6038d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt u16 listen_interval; 6048d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const struct ieee80211_ht_capabilities *ht_capabilities; 6058d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt}; 6068d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 6078d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtstruct hostapd_freq_params { 6088d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int mode; 6098d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int freq; 6108d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int channel; 6118d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int ht_enabled; 6128d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int sec_channel_offset; /* 0 = HT40 disabled, -1 = HT40 enabled, 6138d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * secondary channel below primary, 1 = HT40 6148d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * enabled, secondary channel above primary */ 6158d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt}; 6168d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 6178d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtenum wpa_driver_if_type { 6188d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 6198d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * WPA_IF_STATION - Station mode interface 6208d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 6218d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt WPA_IF_STATION, 6228d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 6238d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 6248d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * WPA_IF_AP_VLAN - AP mode VLAN interface 6258d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 6268d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This interface shares its address and Beacon frame with the main 6278d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * BSS. 6288d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 6298d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt WPA_IF_AP_VLAN, 6308d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 6318d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 6328d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * WPA_IF_AP_BSS - AP mode BSS interface 6338d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 6348d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This interface has its own address and Beacon frame. 6358d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 6368d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt WPA_IF_AP_BSS, 6378d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 6388d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 6398d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * WPA_IF_P2P_GO - P2P Group Owner 6408d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 6418d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt WPA_IF_P2P_GO, 6428d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 6438d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 6448d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * WPA_IF_P2P_CLIENT - P2P Client 6458d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 6468d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt WPA_IF_P2P_CLIENT, 6478d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 6488d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 6498d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * WPA_IF_P2P_GROUP - P2P Group interface (will become either 6508d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * WPA_IF_P2P_GO or WPA_IF_P2P_CLIENT, but the role is not yet known) 6518d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 6528d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt WPA_IF_P2P_GROUP 6538d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt}; 6548d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 6558d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtstruct wpa_init_params { 6568d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *bssid; 6578d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const char *ifname; 6588d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *ssid; 6598d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt size_t ssid_len; 6608d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const char *test_socket; 6618d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int use_pae_group_addr; 6628d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt char **bridge; 6638d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt size_t num_bridge; 6648d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 6658d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt u8 *own_addr; /* buffer for writing own MAC address */ 6668d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt}; 6678d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 6688d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 6698d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtstruct wpa_bss_params { 6708d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** Interface name (for multi-SSID/VLAN support) */ 6718d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const char *ifname; 6728d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** Whether IEEE 802.1X or WPA/WPA2 is enabled */ 6738d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int enabled; 6748d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 6758d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int wpa; 6768d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int ieee802_1x; 6778d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int wpa_group; 6788d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int wpa_pairwise; 6798d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int wpa_key_mgmt; 6808d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int rsn_preauth; 6818d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt enum mfp_options ieee80211w; 6828d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt}; 6838d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 6848d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define WPA_STA_AUTHORIZED BIT(0) 6858d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define WPA_STA_WMM BIT(1) 6868d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define WPA_STA_SHORT_PREAMBLE BIT(2) 6878d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define WPA_STA_MFP BIT(3) 6888d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 6898d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/** 6908d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * struct p2p_params - P2P parameters for driver-based P2P management 6918d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 6928d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtstruct p2p_params { 6938d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const char *dev_name; 6948d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt u8 pri_dev_type[8]; 6958d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define DRV_MAX_SEC_DEV_TYPES 5 6968d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt u8 sec_dev_type[DRV_MAX_SEC_DEV_TYPES][8]; 6978d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt size_t num_sec_dev_types; 6988d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt}; 6998d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 7008d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtenum tdls_oper { 7018d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt TDLS_DISCOVERY_REQ, 7028d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt TDLS_SETUP, 7038d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt TDLS_TEARDOWN, 7048d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt TDLS_ENABLE_LINK, 7058d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt TDLS_DISABLE_LINK, 7068d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt TDLS_ENABLE, 7078d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt TDLS_DISABLE 7088d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt}; 7098d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 7108d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/** 7118d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * struct wpa_signal_info - Information about channel signal quality 7128d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 7138d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtstruct wpa_signal_info { 7148d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt u32 frequency; 7158d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int above_threshold; 7168d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int current_signal; 7178d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int current_noise; 7188d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int current_txrate; 7198d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt}; 7208d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 7218d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/** 7228d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * struct wpa_driver_ops - Driver interface API definition 7238d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 7248d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This structure defines the API that each driver interface needs to implement 7258d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * for core wpa_supplicant code. All driver specific functionality is captured 7268d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * in this wrapper. 7278d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 7288d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtstruct wpa_driver_ops { 7298d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** Name of the driver interface */ 7308d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const char *name; 7318d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** One line description of the driver interface */ 7328d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const char *desc; 7338d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 7348d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 7358d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * get_bssid - Get the current BSSID 7368d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: private driver interface data 7378d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @bssid: buffer for BSSID (ETH_ALEN = 6 bytes) 7388d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 7398d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 7408d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 7418d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Query kernel driver for the current BSSID and copy it to bssid. 7428d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Setting bssid to 00:00:00:00:00:00 is recommended if the STA is not 7438d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * associated. 7448d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 7458d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*get_bssid)(void *priv, u8 *bssid); 7468d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 7478d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 7488d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * get_ssid - Get the current SSID 7498d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: private driver interface data 7508d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @ssid: buffer for SSID (at least 32 bytes) 7518d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 7528d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: Length of the SSID on success, -1 on failure 7538d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 7548d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Query kernel driver for the current SSID and copy it to ssid. 7558d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returning zero is recommended if the STA is not associated. 7568d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 7578d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Note: SSID is an array of octets, i.e., it is not nul terminated and 7588d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * can, at least in theory, contain control characters (including nul) 7598d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * and as such, should be processed as binary data, not a printable 7608d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * string. 7618d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 7628d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*get_ssid)(void *priv, u8 *ssid); 7638d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 7648d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 7658d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * set_key - Configure encryption key 7668d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @ifname: Interface name (for multi-SSID/VLAN support) 7678d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: private driver interface data 7688d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @alg: encryption algorithm (%WPA_ALG_NONE, %WPA_ALG_WEP, 7698d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * %WPA_ALG_TKIP, %WPA_ALG_CCMP, %WPA_ALG_IGTK, %WPA_ALG_PMK); 7708d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * %WPA_ALG_NONE clears the key. 7718d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @addr: Address of the peer STA (BSSID of the current AP when setting 7728d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * pairwise key in station mode), ff:ff:ff:ff:ff:ff for 7738d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * broadcast keys, %NULL for default keys that are used both for 7748d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * broadcast and unicast; when clearing keys, %NULL is used to 7758d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * indicate that both the broadcast-only and default key of the 7768d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * specified key index is to be cleared 7778d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @key_idx: key index (0..3), usually 0 for unicast keys; 0..4095 for 7788d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * IGTK 7798d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @set_tx: configure this key as the default Tx key (only used when 7808d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * driver does not support separate unicast/individual key 7818d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @seq: sequence number/packet number, seq_len octets, the next 7828d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * packet number to be used for in replay protection; configured 7838d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * for Rx keys (in most cases, this is only used with broadcast 7848d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * keys and set to zero for unicast keys); %NULL if not set 7858d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @seq_len: length of the seq, depends on the algorithm: 7868d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * TKIP: 6 octets, CCMP: 6 octets, IGTK: 6 octets 7878d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @key: key buffer; TKIP: 16-byte temporal key, 8-byte Tx Mic key, 7888d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 8-byte Rx Mic Key 7898d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @key_len: length of the key buffer in octets (WEP: 5 or 13, 7908d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * TKIP: 32, CCMP: 16, IGTK: 16) 7918d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 7928d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 7938d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 7948d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Configure the given key for the kernel driver. If the driver 7958d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * supports separate individual keys (4 default keys + 1 individual), 7968d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * addr can be used to determine whether the key is default or 7978d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * individual. If only 4 keys are supported, the default key with key 7988d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * index 0 is used as the individual key. STA must be configured to use 7998d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * it as the default Tx key (set_tx is set) and accept Rx for all the 8008d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * key indexes. In most cases, WPA uses only key indexes 1 and 2 for 8018d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * broadcast keys, so key index 0 is available for this kind of 8028d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * configuration. 8038d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 8048d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Please note that TKIP keys include separate TX and RX MIC keys and 8058d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * some drivers may expect them in different order than wpa_supplicant 8068d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * is using. If the TX/RX keys are swapped, all TKIP encrypted packets 8078d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * will trigger Michael MIC errors. This can be fixed by changing the 8088d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * order of MIC keys by swapping te bytes 16..23 and 24..31 of the key 8098d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * in driver_*.c set_key() implementation, see driver_ndis.c for an 8108d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * example on how this can be done. 8118d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 8128d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*set_key)(const char *ifname, void *priv, enum wpa_alg alg, 8138d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *addr, int key_idx, int set_tx, 8148d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *seq, size_t seq_len, 8158d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *key, size_t key_len); 8168d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 8178d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 8188d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * init - Initialize driver interface 8198d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @ctx: context to be used when calling wpa_supplicant functions, 8208d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * e.g., wpa_supplicant_event() 8218d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @ifname: interface name, e.g., wlan0 8228d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 8238d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: Pointer to private data, %NULL on failure 8248d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 8258d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Initialize driver interface, including event processing for kernel 8268d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * driver events (e.g., associated, scan results, Michael MIC failure). 8278d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This function can allocate a private configuration data area for 8288d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @ctx, file descriptor, interface name, etc. information that may be 8298d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * needed in future driver operations. If this is not used, non-NULL 8308d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * value will need to be returned because %NULL is used to indicate 8318d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * failure. The returned value will be used as 'void *priv' data for 8328d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * all other driver_ops functions. 8338d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 8348d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * The main event loop (eloop.c) of wpa_supplicant can be used to 8358d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * register callback for read sockets (eloop_register_read_sock()). 8368d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 8378d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * See below for more information about events and 8388d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * wpa_supplicant_event() function. 8398d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 8408d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt void * (*init)(void *ctx, const char *ifname); 8418d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 8428d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 8438d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * deinit - Deinitialize driver interface 8448d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: private driver interface data from init() 8458d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 8468d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Shut down driver interface and processing of driver events. Free 8478d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * private data buffer if one was allocated in init() handler. 8488d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 8498d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt void (*deinit)(void *priv); 8508d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 8518d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 8528d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * set_param - Set driver configuration parameters 8538d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: private driver interface data from init() 8548d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @param: driver specific configuration parameters 8558d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 8568d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 8578d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 8588d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Optional handler for notifying driver interface about configuration 8598d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * parameters (driver_param). 8608d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 8618d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*set_param)(void *priv, const char *param); 8628d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 8638d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 8648d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * set_countermeasures - Enable/disable TKIP countermeasures 8658d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: private driver interface data 8668d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @enabled: 1 = countermeasures enabled, 0 = disabled 8678d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 8688d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 8698d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 8708d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Configure TKIP countermeasures. When these are enabled, the driver 8718d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * should drop all received and queued frames that are using TKIP. 8728d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 8738d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*set_countermeasures)(void *priv, int enabled); 8748d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 8758d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 8768d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * deauthenticate - Request driver to deauthenticate 8778d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: private driver interface data 8788d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @addr: peer address (BSSID of the AP) 8798d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @reason_code: 16-bit reason code to be sent in the deauthentication 8808d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * frame 8818d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 8828d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 8838d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 8848d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*deauthenticate)(void *priv, const u8 *addr, int reason_code); 8858d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 8868d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 8878d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * disassociate - Request driver to disassociate 8888d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: private driver interface data 8898d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @addr: peer address (BSSID of the AP) 8908d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @reason_code: 16-bit reason code to be sent in the disassociation 8918d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * frame 8928d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 8938d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 8948d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 8958d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*disassociate)(void *priv, const u8 *addr, int reason_code); 8968d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 8978d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 8988d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * associate - Request driver to associate 8998d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: private driver interface data 9008d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @params: association parameters 9018d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 9028d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 9038d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 9048d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*associate)(void *priv, 9058d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt struct wpa_driver_associate_params *params); 9068d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 9078d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 9088d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * add_pmkid - Add PMKSA cache entry to the driver 9098d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: private driver interface data 9108d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @bssid: BSSID for the PMKSA cache entry 9118d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @pmkid: PMKID for the PMKSA cache entry 9128d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 9138d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 9148d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 9158d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This function is called when a new PMK is received, as a result of 9168d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * either normal authentication or RSN pre-authentication. 9178d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 9188d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * If the driver generates RSN IE, i.e., it does not use wpa_ie in 9198d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * associate(), add_pmkid() can be used to add new PMKSA cache entries 9208d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * in the driver. If the driver uses wpa_ie from wpa_supplicant, this 9218d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * driver_ops function does not need to be implemented. Likewise, if 9228d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * the driver does not support WPA, this function is not needed. 9238d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 9248d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*add_pmkid)(void *priv, const u8 *bssid, const u8 *pmkid); 9258d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 9268d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 9278d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * remove_pmkid - Remove PMKSA cache entry to the driver 9288d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: private driver interface data 9298d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @bssid: BSSID for the PMKSA cache entry 9308d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @pmkid: PMKID for the PMKSA cache entry 9318d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 9328d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 9338d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 9348d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This function is called when the supplicant drops a PMKSA cache 9358d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * entry for any reason. 9368d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 9378d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * If the driver generates RSN IE, i.e., it does not use wpa_ie in 9388d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * associate(), remove_pmkid() can be used to synchronize PMKSA caches 9398d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * between the driver and wpa_supplicant. If the driver uses wpa_ie 9408d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * from wpa_supplicant, this driver_ops function does not need to be 9418d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * implemented. Likewise, if the driver does not support WPA, this 9428d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * function is not needed. 9438d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 9448d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*remove_pmkid)(void *priv, const u8 *bssid, const u8 *pmkid); 9458d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 9468d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 9478d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * flush_pmkid - Flush PMKSA cache 9488d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: private driver interface data 9498d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 9508d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 9518d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 9528d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This function is called when the supplicant drops all PMKSA cache 9538d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * entries for any reason. 9548d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 9558d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * If the driver generates RSN IE, i.e., it does not use wpa_ie in 9568d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * associate(), remove_pmkid() can be used to synchronize PMKSA caches 9578d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * between the driver and wpa_supplicant. If the driver uses wpa_ie 9588d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * from wpa_supplicant, this driver_ops function does not need to be 9598d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * implemented. Likewise, if the driver does not support WPA, this 9608d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * function is not needed. 9618d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 9628d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*flush_pmkid)(void *priv); 9638d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 9648d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 9658d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * get_capa - Get driver capabilities 9668d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: private driver interface data 9678d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 9688d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 9698d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 9708d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Get driver/firmware/hardware capabilities. 9718d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 9728d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*get_capa)(void *priv, struct wpa_driver_capa *capa); 9738d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 9748d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 9758d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * poll - Poll driver for association information 9768d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: private driver interface data 9778d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 9788d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This is an option callback that can be used when the driver does not 9798d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * provide event mechanism for association events. This is called when 9808d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * receiving WPA EAPOL-Key messages that require association 9818d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * information. The driver interface is supposed to generate associnfo 9828d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * event before returning from this callback function. In addition, the 9838d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * driver interface should generate an association event after having 9848d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * sent out associnfo. 9858d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 9868d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt void (*poll)(void *priv); 9878d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 9888d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 9898d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * get_ifname - Get interface name 9908d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: private driver interface data 9918d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 9928d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: Pointer to the interface name. This can differ from the 9938d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * interface name used in init() call. Init() is called first. 9948d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 9958d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This optional function can be used to allow the driver interface to 9968d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * replace the interface name with something else, e.g., based on an 9978d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * interface mapping from a more descriptive name. 9988d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 9998d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const char * (*get_ifname)(void *priv); 10008d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 10018d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 10028d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * get_mac_addr - Get own MAC address 10038d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: private driver interface data 10048d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 10058d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: Pointer to own MAC address or %NULL on failure 10068d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 10078d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This optional function can be used to get the own MAC address of the 10088d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * device from the driver interface code. This is only needed if the 10098d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * l2_packet implementation for the OS does not provide easy access to 10108d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * a MAC address. */ 10118d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 * (*get_mac_addr)(void *priv); 10128d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 10138d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 10148d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * send_eapol - Optional function for sending EAPOL packets 10158d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: private driver interface data 10168d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @dest: Destination MAC address 10178d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @proto: Ethertype 10188d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @data: EAPOL packet starting with IEEE 802.1X header 10198d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @data_len: Size of the EAPOL packet 10208d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 10218d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 10228d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 10238d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This optional function can be used to override l2_packet operations 10248d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * with driver specific functionality. If this function pointer is set, 10258d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * l2_packet module is not used at all and the driver interface code is 10268d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * responsible for receiving and sending all EAPOL packets. The 10278d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * received EAPOL packets are sent to core code with EVENT_EAPOL_RX 10288d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * event. The driver interface is required to implement get_mac_addr() 10298d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * handler if send_eapol() is used. 10308d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 10318d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*send_eapol)(void *priv, const u8 *dest, u16 proto, 10328d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *data, size_t data_len); 10338d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 10348d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 10358d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * set_operstate - Sets device operating state to DORMANT or UP 10368d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: private driver interface data 10378d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @state: 0 = dormant, 1 = up 10388d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 10398d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 10408d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This is an optional function that can be used on operating systems 10418d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * that support a concept of controlling network device state from user 10428d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * space applications. This function, if set, gets called with 10438d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * state = 1 when authentication has been completed and with state = 0 10448d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * when connection is lost. 10458d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 10468d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*set_operstate)(void *priv, int state); 10478d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 10488d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 10498d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * mlme_setprotection - MLME-SETPROTECTION.request primitive 10508d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 10518d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @addr: Address of the station for which to set protection (may be 10528d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * %NULL for group keys) 10538d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @protect_type: MLME_SETPROTECTION_PROTECT_TYPE_* 10548d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @key_type: MLME_SETPROTECTION_KEY_TYPE_* 10558d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 10568d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 10578d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This is an optional function that can be used to set the driver to 10588d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * require protection for Tx and/or Rx frames. This uses the layer 10598d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * interface defined in IEEE 802.11i-2004 clause 10.3.22.1 10608d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * (MLME-SETPROTECTION.request). Many drivers do not use explicit 10618d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * set protection operation; instead, they set protection implicitly 10628d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * based on configured keys. 10638d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 10648d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*mlme_setprotection)(void *priv, const u8 *addr, int protect_type, 10658d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int key_type); 10668d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 10678d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 10688d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * get_hw_feature_data - Get hardware support data (channels and rates) 10698d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 10708d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @num_modes: Variable for returning the number of returned modes 10718d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * flags: Variable for returning hardware feature flags 10728d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: Pointer to allocated hardware data on success or %NULL on 10738d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * failure. Caller is responsible for freeing this. 10748d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 10758d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This function is only needed for drivers that export MLME 10768d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * (management frame processing) to %wpa_supplicant or hostapd. 10778d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 10788d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt struct hostapd_hw_modes * (*get_hw_feature_data)(void *priv, 10798d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt u16 *num_modes, 10808d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt u16 *flags); 10818d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 10828d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 10838d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * set_channel - Set channel 10848d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 10858d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @phymode: HOSTAPD_MODE_IEEE80211B, .. 10868d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @chan: IEEE 802.11 channel number 10878d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @freq: Frequency of the channel in MHz 10888d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 10898d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 10908d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This function is only needed for drivers that export MLME 10918d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * (management frame processing) to wpa_supplicant. 10928d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 10938d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*set_channel)(void *priv, enum hostapd_hw_mode phymode, int chan, 10948d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int freq); 10958d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 10968d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 10978d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * set_ssid - Set SSID 10988d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 10998d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @ssid: SSID 11008d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @ssid_len: SSID length 11018d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 11028d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 11038d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This function is only needed for drivers that export MLME 11048d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * (management frame processing) to wpa_supplicant. 11058d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 11068d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*set_ssid)(void *priv, const u8 *ssid, size_t ssid_len); 11078d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 11088d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 11098d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * set_bssid - Set BSSID 11108d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 11118d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @bssid: BSSID 11128d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 11138d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 11148d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This function is only needed for drivers that export MLME 11158d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * (management frame processing) to wpa_supplicant. 11168d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 11178d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*set_bssid)(void *priv, const u8 *bssid); 11188d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 11198d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 11208d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * send_mlme - Send management frame from MLME 11218d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 11228d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @data: IEEE 802.11 management frame with IEEE 802.11 header 11238d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @data_len: Size of the management frame 11248d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 11258d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 11268d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This function is only needed for drivers that export MLME 11278d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * (management frame processing) to wpa_supplicant. 11288d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 11298d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*send_mlme)(void *priv, const u8 *data, size_t data_len); 11308d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 11318d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 11328d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * mlme_add_sta - Add a STA entry into the driver/netstack 11338d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 11348d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @addr: MAC address of the STA (e.g., BSSID of the AP) 11358d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @supp_rates: Supported rate set (from (Re)AssocResp); in IEEE 802.11 11368d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * format (one octet per rate, 1 = 0.5 Mbps) 11378d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @supp_rates_len: Number of entries in supp_rates 11388d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 11398d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 11408d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This function is only needed for drivers that export MLME 11418d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * (management frame processing) to wpa_supplicant. When the MLME code 11428d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * completes association with an AP, this function is called to 11438d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * configure the driver/netstack with a STA entry for data frame 11448d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * processing (TX rate control, encryption/decryption). 11458d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 11468d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*mlme_add_sta)(void *priv, const u8 *addr, const u8 *supp_rates, 11478d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt size_t supp_rates_len); 11488d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 11498d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 11508d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * mlme_remove_sta - Remove a STA entry from the driver/netstack 11518d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 11528d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @addr: MAC address of the STA (e.g., BSSID of the AP) 11538d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 11548d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 11558d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This function is only needed for drivers that export MLME 11568d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * (management frame processing) to wpa_supplicant. 11578d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 11588d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*mlme_remove_sta)(void *priv, const u8 *addr); 11598d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 11608d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 11618d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * update_ft_ies - Update FT (IEEE 802.11r) IEs 11628d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 11638d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @md: Mobility domain (2 octets) (also included inside ies) 11648d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @ies: FT IEs (MDIE, FTIE, ...) or %NULL to remove IEs 11658d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @ies_len: Length of FT IEs in bytes 11668d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 11678d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 11688d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * The supplicant uses this callback to let the driver know that keying 11698d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * material for FT is available and that the driver can use the 11708d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * provided IEs in the next message in FT authentication sequence. 11718d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 11728d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This function is only needed for driver that support IEEE 802.11r 11738d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * (Fast BSS Transition). 11748d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 11758d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*update_ft_ies)(void *priv, const u8 *md, const u8 *ies, 11768d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt size_t ies_len); 11778d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 11788d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 11798d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * send_ft_action - Send FT Action frame (IEEE 802.11r) 11808d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 11818d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @action: Action field value 11828d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @target_ap: Target AP address 11838d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @ies: FT IEs (MDIE, FTIE, ...) (FT Request action frame body) 11848d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @ies_len: Length of FT IEs in bytes 11858d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 11868d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 11878d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * The supplicant uses this callback to request the driver to transmit 11888d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * an FT Action frame (action category 6) for over-the-DS fast BSS 11898d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * transition. 11908d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 11918d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*send_ft_action)(void *priv, u8 action, const u8 *target_ap, 11928d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *ies, size_t ies_len); 11938d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 11948d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 11958d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * get_scan_results2 - Fetch the latest scan results 11968d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: private driver interface data 11978d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 11988d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: Allocated buffer of scan results (caller is responsible for 11998d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * freeing the data structure) on success, NULL on failure 12008d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 12018d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt struct wpa_scan_results * (*get_scan_results2)(void *priv); 12028d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 12038d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 12048d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * set_country - Set country 12058d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 12068d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @alpha2: country to which to switch to 12078d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 12088d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 12098d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This function is for drivers which support some form 12108d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * of setting a regulatory domain. 12118d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 12128d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*set_country)(void *priv, const char *alpha2); 12138d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 12148d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 12158d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * global_init - Global driver initialization 12168d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: Pointer to private data (global), %NULL on failure 12178d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 12188d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This optional function is called to initialize the driver wrapper 12198d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * for global data, i.e., data that applies to all interfaces. If this 12208d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * function is implemented, global_deinit() will also need to be 12218d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * implemented to free the private data. The driver will also likely 12228d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * use init2() function instead of init() to get the pointer to global 12238d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * data available to per-interface initializer. 12248d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 12258d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt void * (*global_init)(void); 12268d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 12278d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 12288d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * global_deinit - Global driver deinitialization 12298d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: private driver global data from global_init() 12308d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 12318d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Terminate any global driver related functionality and free the 12328d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * global data structure. 12338d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 12348d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt void (*global_deinit)(void *priv); 12358d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 12368d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 12378d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * init2 - Initialize driver interface (with global data) 12388d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @ctx: context to be used when calling wpa_supplicant functions, 12398d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * e.g., wpa_supplicant_event() 12408d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @ifname: interface name, e.g., wlan0 12418d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @global_priv: private driver global data from global_init() 12428d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: Pointer to private data, %NULL on failure 12438d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 12448d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This function can be used instead of init() if the driver wrapper 12458d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * uses global data. 12468d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 12478d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt void * (*init2)(void *ctx, const char *ifname, void *global_priv); 12488d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 12498d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 12508d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * get_interfaces - Get information about available interfaces 12518d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @global_priv: private driver global data from global_init() 12528d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: Allocated buffer of interface information (caller is 12538d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * responsible for freeing the data structure) on success, NULL on 12548d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * failure 12558d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 12568d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt struct wpa_interface_info * (*get_interfaces)(void *global_priv); 12578d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 12588d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 12598d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * scan2 - Request the driver to initiate scan 12608d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: private driver interface data 12618d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @params: Scan parameters 12628d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 12638d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 12648d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 12658d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Once the scan results are ready, the driver should report scan 12668d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * results event for wpa_supplicant which will eventually request the 12678d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * results with wpa_driver_get_scan_results2(). 12688d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 12698d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*scan2)(void *priv, struct wpa_driver_scan_params *params); 12708d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 12718d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 12728d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * authenticate - Request driver to authenticate 12738d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: private driver interface data 12748d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @params: authentication parameters 12758d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 12768d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 12778d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This is an optional function that can be used with drivers that 12788d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * support separate authentication and association steps, i.e., when 12798d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * wpa_supplicant can act as the SME. If not implemented, associate() 12808d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * function is expected to take care of IEEE 802.11 authentication, 12818d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * too. 12828d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 12838d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*authenticate)(void *priv, 12848d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt struct wpa_driver_auth_params *params); 12858d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 12868d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 12878d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * set_beacon - Set Beacon frame template 12888d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 12898d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @head: Beacon head from IEEE 802.11 header to IEs before TIM IE 12908d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @head_len: Length of the head buffer in octets 12918d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @tail: Beacon tail following TIM IE 12928d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @tail_len: Length of the tail buffer in octets 12938d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @dtim_period: DTIM period 12948d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @beacon_int: Beacon interval 12958d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 12968d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 12978d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This function is used to configure Beacon template for the driver in 12988d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * AP mode. The driver is responsible for building the full Beacon 12998d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * frame by concatenating the head part with TIM IE generated by the 13008d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * driver/firmware and finishing with the tail part. 13018d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 13028d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*set_beacon)(void *priv, const u8 *head, size_t head_len, 13038d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *tail, size_t tail_len, int dtim_period, 13048d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int beacon_int); 13058d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 13068d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 13078d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * hapd_init - Initialize driver interface (hostapd only) 13088d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @hapd: Pointer to hostapd context 13098d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @params: Configuration for the driver wrapper 13108d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: Pointer to private data, %NULL on failure 13118d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 13128d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This function is used instead of init() or init2() when the driver 13138d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * wrapper is used withh hostapd. 13148d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 13158d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt void * (*hapd_init)(struct hostapd_data *hapd, 13168d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt struct wpa_init_params *params); 13178d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 13188d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 13198d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * hapd_deinit - Deinitialize driver interface (hostapd only) 13208d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data from hapd_init() 13218d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 13228d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt void (*hapd_deinit)(void *priv); 13238d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 13248d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 13258d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * set_ieee8021x - Enable/disable IEEE 802.1X support (AP only) 13268d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 13278d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @params: BSS parameters 13288d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 13298d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 13308d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This is an optional function to configure the kernel driver to 13318d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * enable/disable IEEE 802.1X support and set WPA/WPA2 parameters. This 13328d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * can be left undefined (set to %NULL) if IEEE 802.1X support is 13338d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * always enabled and the driver uses set_beacon() to set WPA/RSN IE 13348d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * for Beacon frames. 13358d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 13368d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*set_ieee8021x)(void *priv, struct wpa_bss_params *params); 13378d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 13388d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 13398d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * set_privacy - Enable/disable privacy (AP only) 13408d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 13418d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @enabled: 1 = privacy enabled, 0 = disabled 13428d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 13438d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 13448d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This is an optional function to configure privacy field in the 13458d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * kernel driver for Beacon frames. This can be left undefined (set to 13468d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * %NULL) if the driver uses the Beacon template from set_beacon(). 13478d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 13488d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*set_privacy)(void *priv, int enabled); 13498d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 13508d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 13518d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * get_seqnum - Fetch the current TSC/packet number (AP only) 13528d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @ifname: The interface name (main or virtual) 13538d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 13548d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @addr: MAC address of the station or %NULL for group keys 13558d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @idx: Key index 13568d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @seq: Buffer for returning the latest used TSC/packet number 13578d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 13588d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 13598d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This function is used to fetch the last used TSC/packet number for 13608d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * a TKIP, CCMP, or BIP/IGTK key. It is mainly used with group keys, so 13618d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * there is no strict requirement on implementing support for unicast 13628d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * keys (i.e., addr != %NULL). 13638d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 13648d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*get_seqnum)(const char *ifname, void *priv, const u8 *addr, 13658d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int idx, u8 *seq); 13668d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 13678d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 13688d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * flush - Flush all association stations (AP only) 13698d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 13708d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 13718d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 13728d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This function requests the driver to disassociate all associated 13738d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * stations. This function does not need to be implemented if the 13748d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * driver does not process association frames internally. 13758d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 13768d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*flush)(void *priv); 13778d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 13788d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 13798d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * set_generic_elem - Add IEs into Beacon/Probe Response frames (AP) 13808d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 13818d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @elem: Information elements 13828d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @elem_len: Length of the elem buffer in octets 13838d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 13848d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 13858d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This is an optional function to add information elements in the 13868d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * kernel driver for Beacon and Probe Response frames. This can be left 13878d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * undefined (set to %NULL) if the driver uses the Beacon template from 13888d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * set_beacon(). 13898d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 13908d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*set_generic_elem)(void *priv, const u8 *elem, size_t elem_len); 13918d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 13928d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 13938d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * read_sta_data - Fetch station data (AP only) 13948d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 13958d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @data: Buffer for returning station information 13968d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @addr: MAC address of the station 13978d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 13988d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 13998d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*read_sta_data)(void *priv, struct hostap_sta_driver_data *data, 14008d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *addr); 14018d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 14028d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 14038d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * hapd_send_eapol - Send an EAPOL packet (AP only) 14048d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: private driver interface data 14058d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @addr: Destination MAC address 14068d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @data: EAPOL packet starting with IEEE 802.1X header 14078d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @data_len: Length of the EAPOL packet in octets 14088d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @encrypt: Whether the frame should be encrypted 14098d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @own_addr: Source MAC address 14108d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @flags: WPA_STA_* flags for the destination station 14118d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 14128d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 14138d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 14148d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*hapd_send_eapol)(void *priv, const u8 *addr, const u8 *data, 14158d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt size_t data_len, int encrypt, 14168d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *own_addr, u32 flags); 14178d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 14188d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 14198d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * sta_deauth - Deauthenticate a station (AP only) 14208d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 14218d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @own_addr: Source address and BSSID for the Deauthentication frame 14228d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @addr: MAC address of the station to deauthenticate 14238d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @reason: Reason code for the Deauthentiation frame 14248d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 14258d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 14268d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This function requests a specific station to be deauthenticated and 14278d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * a Deauthentication frame to be sent to it. 14288d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 14298d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*sta_deauth)(void *priv, const u8 *own_addr, const u8 *addr, 14308d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int reason); 14318d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 14328d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 14338d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * sta_disassoc - Disassociate a station (AP only) 14348d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 14358d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @own_addr: Source address and BSSID for the Disassociation frame 14368d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @addr: MAC address of the station to disassociate 14378d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @reason: Reason code for the Disassociation frame 14388d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 14398d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 14408d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This function requests a specific station to be disassociated and 14418d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * a Disassociation frame to be sent to it. 14428d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 14438d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*sta_disassoc)(void *priv, const u8 *own_addr, const u8 *addr, 14448d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int reason); 14458d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 14468d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 14478d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * sta_remove - Remove a station entry (AP only) 14488d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 14498d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @addr: MAC address of the station to be removed 14508d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 14518d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 14528d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*sta_remove)(void *priv, const u8 *addr); 14538d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 14548d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 14558d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * hapd_get_ssid - Get the current SSID (AP only) 14568d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 14578d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @buf: Buffer for returning the SSID 14588d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @len: Maximum length of the buffer 14598d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: Length of the SSID on success, -1 on failure 14608d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 14618d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This function need not be implemented if the driver uses Beacon 14628d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * template from set_beacon() and does not reply to Probe Request 14638d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * frames. 14648d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 14658d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*hapd_get_ssid)(void *priv, u8 *buf, int len); 14668d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 14678d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 14688d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * hapd_set_ssid - Set SSID (AP only) 14698d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 14708d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @buf: SSID 14718d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @len: Length of the SSID in octets 14728d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 14738d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 14748d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*hapd_set_ssid)(void *priv, const u8 *buf, int len); 14758d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 14768d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 14778d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * hapd_set_countermeasures - Enable/disable TKIP countermeasures (AP) 14788d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 14798d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @enabled: 1 = countermeasures enabled, 0 = disabled 14808d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 14818d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 14828d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This need not be implemented if the driver does not take care of 14838d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * association processing. 14848d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 14858d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*hapd_set_countermeasures)(void *priv, int enabled); 14868d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 14878d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 14888d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * sta_add - Add a station entry 14898d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 14908d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @params: Station parameters 14918d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 14928d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 14938d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This function is used to add a station entry to the driver once the 14948d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * station has completed association. This is only used if the driver 14958d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * does not take care of association processing. 14968d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 14978d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*sta_add)(void *priv, struct hostapd_sta_add_params *params); 14988d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 14998d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 15008d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * get_inact_sec - Get station inactivity duration (AP only) 15018d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 15028d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @addr: Station address 15038d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: Number of seconds station has been inactive, -1 on failure 15048d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 15058d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*get_inact_sec)(void *priv, const u8 *addr); 15068d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 15078d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 15088d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * sta_clear_stats - Clear station statistics (AP only) 15098d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 15108d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @addr: Station address 15118d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 15128d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 15138d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*sta_clear_stats)(void *priv, const u8 *addr); 15148d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 15158d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 15168d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * set_freq - Set channel/frequency (AP only) 15178d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 15188d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @freq: Channel parameters 15198d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 15208d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 15218d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*set_freq)(void *priv, struct hostapd_freq_params *freq); 15228d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 15238d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 15248d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * set_rts - Set RTS threshold 15258d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 15268d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @rts: RTS threshold in octets 15278d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 15288d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 15298d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*set_rts)(void *priv, int rts); 15308d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 15318d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 15328d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * set_frag - Set fragmentation threshold 15338d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 15348d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @frag: Fragmentation threshold in octets 15358d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 15368d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 15378d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*set_frag)(void *priv, int frag); 15388d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 15398d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 15408d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * sta_set_flags - Set station flags (AP only) 15418d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 15428d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @addr: Station address 15438d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @total_flags: Bitmap of all WPA_STA_* flags currently set 15448d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @flags_or: Bitmap of WPA_STA_* flags to add 15458d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @flags_and: Bitmap of WPA_STA_* flags to us as a mask 15468d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 15478d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 15488d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*sta_set_flags)(void *priv, const u8 *addr, 15498d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int total_flags, int flags_or, int flags_and); 15508d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 15518d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 15528d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * set_rate_sets - Set supported and basic rate sets (AP only) 15538d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 15548d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @supp_rates: -1 terminated array of supported rates in 100 kbps 15558d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @basic_rates: -1 terminated array of basic rates in 100 kbps 15568d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @mode: hardware mode (HOSTAPD_MODE_*) 15578d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 15588d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 15598d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*set_rate_sets)(void *priv, int *supp_rates, int *basic_rates, 15608d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int mode); 15618d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 15628d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 15638d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * set_cts_protect - Set CTS protection mode (AP only) 15648d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 15658d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @value: Whether CTS protection is enabled 15668d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 15678d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 15688d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*set_cts_protect)(void *priv, int value); 15698d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 15708d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 15718d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * set_preamble - Set preamble mode (AP only) 15728d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 15738d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @value: Whether short preamble is enabled 15748d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 15758d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 15768d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*set_preamble)(void *priv, int value); 15778d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 15788d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 15798d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * set_short_slot_time - Set short slot time (AP only) 15808d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 15818d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @value: Whether short slot time is enabled 15828d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 15838d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 15848d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*set_short_slot_time)(void *priv, int value); 15858d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 15868d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 15878d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * set_tx_queue_params - Set TX queue parameters 15888d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 15898d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @queue: Queue number (0 = VO, 1 = VI, 2 = BE, 3 = BK) 15908d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @aifs: AIFS 15918d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @cw_min: cwMin 15928d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @cw_max: cwMax 15938d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @burst_time: Maximum length for bursting in 0.1 msec units 15948d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 15958d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*set_tx_queue_params)(void *priv, int queue, int aifs, int cw_min, 15968d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int cw_max, int burst_time); 15978d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 15988d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 15998d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * valid_bss_mask - Validate BSSID mask 16008d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 16018d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @addr: Address 16028d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @mask: Mask 16038d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 if mask is valid, -1 if mask is not valid, 1 if mask can 16048d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * be used, but the main interface address must be the first address in 16058d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * the block if mask is applied 16068d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 16078d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*valid_bss_mask)(void *priv, const u8 *addr, const u8 *mask); 16088d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 16098d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 16108d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * if_add - Add a virtual interface 16118d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 16128d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @type: Interface type 16138d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @ifname: Interface name for the new virtual interface 16148d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @addr: Local address to use for the interface or %NULL to use the 16158d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * parent interface address 16168d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @bss_ctx: BSS context for %WPA_IF_AP_BSS interfaces 16178d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @drv_priv: Pointer for overwriting the driver context or %NULL if 16188d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * not allowed (applies only to %WPA_IF_AP_BSS type) 16198d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @force_ifname: Buffer for returning an interface name that the 16208d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * driver ended up using if it differs from the requested ifname 16218d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @if_addr: Buffer for returning the allocated interface address 16228d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * (this may differ from the requested addr if the driver cannot 16238d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * change interface address) 16248d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @bridge: Bridge interface to use or %NULL if no bridge configured 16258d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 16268d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 16278d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*if_add)(void *priv, enum wpa_driver_if_type type, 16288d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const char *ifname, const u8 *addr, void *bss_ctx, 16298d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt void **drv_priv, char *force_ifname, u8 *if_addr, 16308d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const char *bridge); 16318d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 16328d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 16338d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * if_remove - Remove a virtual interface 16348d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 16358d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @type: Interface type 16368d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @ifname: Interface name of the virtual interface to be removed 16378d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 16388d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 16398d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*if_remove)(void *priv, enum wpa_driver_if_type type, 16408d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const char *ifname); 16418d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 16428d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 16438d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * set_sta_vlan - Bind a station into a specific interface (AP only) 16448d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 16458d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @ifname: Interface (main or virtual BSS or VLAN) 16468d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @addr: MAC address of the associated station 16478d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @vlan_id: VLAN ID 16488d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 16498d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 16508d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This function is used to bind a station to a specific virtual 16518d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * interface. It is only used if when virtual interfaces are supported, 16528d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * e.g., to assign stations to different VLAN interfaces based on 16538d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * information from a RADIUS server. This allows separate broadcast 16548d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * domains to be used with a single BSS. 16558d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 16568d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*set_sta_vlan)(void *priv, const u8 *addr, const char *ifname, 16578d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int vlan_id); 16588d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 16598d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 16608d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * commit - Optional commit changes handler (AP only) 16618d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: driver private data 16628d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 16638d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 16648d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This optional handler function can be registered if the driver 16658d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * interface implementation needs to commit changes (e.g., by setting 16668d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * network interface up) at the end of initial configuration. If set, 16678d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * this handler will be called after initial setup has been completed. 16688d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 16698d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*commit)(void *priv); 16708d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 16718d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 16728d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * send_ether - Send an ethernet packet (AP only) 16738d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: private driver interface data 16748d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @dst: Destination MAC address 16758d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @src: Source MAC address 16768d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @proto: Ethertype 16778d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @data: EAPOL packet starting with IEEE 802.1X header 16788d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @data_len: Length of the EAPOL packet in octets 16798d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 16808d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 16818d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*send_ether)(void *priv, const u8 *dst, const u8 *src, u16 proto, 16828d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *data, size_t data_len); 16838d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 16848d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 16858d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * set_radius_acl_auth - Notification of RADIUS ACL change 16868d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 16878d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @mac: MAC address of the station 16888d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @accepted: Whether the station was accepted 16898d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @session_timeout: Session timeout for the station 16908d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 16918d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 16928d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*set_radius_acl_auth)(void *priv, const u8 *mac, int accepted, 16938d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt u32 session_timeout); 16948d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 16958d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 16968d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * set_radius_acl_expire - Notification of RADIUS ACL expiration 16978d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 16988d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @mac: MAC address of the station 16998d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 17008d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 17018d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*set_radius_acl_expire)(void *priv, const u8 *mac); 17028d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 17038d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 17048d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * set_ht_params - Set HT parameters (AP only) 17058d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 17068d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @ht_capab: HT Capabilities IE 17078d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @ht_capab_len: Length of ht_capab in octets 17088d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @ht_oper: HT Operation IE 17098d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @ht_oper_len: Length of ht_oper in octets 17108d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 17118d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 17128d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*set_ht_params)(void *priv, 17138d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *ht_capab, size_t ht_capab_len, 17148d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *ht_oper, size_t ht_oper_len); 17158d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 17168d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 17178d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * set_ap_wps_ie - Add WPS IE(s) into Beacon/Probe Response frames (AP) 17188d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 17198d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @beacon: WPS IE(s) for Beacon frames or %NULL to remove extra IE(s) 17208d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @proberesp: WPS IE(s) for Probe Response frames or %NULL to remove 17218d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * extra IE(s) 17228d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @assocresp: WPS IE(s) for (Re)Association Response frames or %NULL 17238d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * to remove extra IE(s) 17248d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 17258d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 17268d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This is an optional function to add WPS IE in the kernel driver for 17278d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Beacon and Probe Response frames. This can be left undefined (set 17288d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * to %NULL) if the driver uses the Beacon template from set_beacon() 17298d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * and does not process Probe Request frames. If the driver takes care 17308d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * of (Re)Association frame processing, the assocresp buffer includes 17318d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * WPS IE(s) that need to be added to (Re)Association Response frames 17328d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * whenever a (Re)Association Request frame indicated use of WPS. 17338d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 17348d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This will also be used to add P2P IE(s) into Beacon/Probe Response 17358d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * frames when operating as a GO. The driver is responsible for adding 17368d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * timing related attributes (e.g., NoA) in addition to the IEs 17378d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * included here by appending them after these buffers. This call is 17388d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * also used to provide Probe Response IEs for P2P Listen state 17398d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * operations for drivers that generate the Probe Response frames 17408d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * internally. 17418d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 17428d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*set_ap_wps_ie)(void *priv, const struct wpabuf *beacon, 17438d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const struct wpabuf *proberesp, 17448d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const struct wpabuf *assocresp); 17458d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 17468d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 17478d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * set_supp_port - Set IEEE 802.1X Supplicant Port status 17488d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 17498d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @authorized: Whether the port is authorized 17508d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 17518d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 17528d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*set_supp_port)(void *priv, int authorized); 17538d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 17548d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 17558d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * set_wds_sta - Bind a station into a 4-address WDS (AP only) 17568d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 17578d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @addr: MAC address of the associated station 17588d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @aid: Association ID 17598d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @val: 1 = bind to 4-address WDS; 0 = unbind 17608d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @bridge_ifname: Bridge interface to use for the WDS station or %NULL 17618d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * to indicate that bridge is not to be used 17628d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 17638d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 17648d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*set_wds_sta)(void *priv, const u8 *addr, int aid, int val, 17658d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const char *bridge_ifname); 17668d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 17678d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 17688d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * send_action - Transmit an Action frame 17698d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 17708d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @freq: Frequency (in MHz) of the channel 17718d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @wait: Time to wait off-channel for a response (in ms), or zero 17728d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @dst: Destination MAC address (Address 1) 17738d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @src: Source MAC address (Address 2) 17748d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @bssid: BSSID (Address 3) 17758d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @data: Frame body 17768d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @data_len: data length in octets 17778d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 17788d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 17798d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This command can be used to request the driver to transmit an action 17808d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * frame to the specified destination. 17818d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 17828d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * If the %WPA_DRIVER_FLAGS_OFFCHANNEL_TX flag is set, the frame will 17838d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * be transmitted on the given channel and the device will wait for a 17848d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * response on that channel for the given wait time. 17858d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 17868d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * If the flag is not set, the wait time will be ignored. In this case, 17878d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * if a remain-on-channel duration is in progress, the frame must be 17888d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * transmitted on that channel; alternatively the frame may be sent on 17898d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * the current operational channel (if in associated state in station 17908d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * mode or while operating as an AP.) 17918d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 17928d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*send_action)(void *priv, unsigned int freq, unsigned int wait, 17938d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *dst, const u8 *src, const u8 *bssid, 17948d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *data, size_t data_len); 17958d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 17968d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 17978d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * send_action_cancel_wait - Cancel action frame TX wait 17988d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 17998d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 18008d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This command cancels the wait time associated with sending an action 18018d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * frame. It is only available when %WPA_DRIVER_FLAGS_OFFCHANNEL_TX is 18028d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * set in the driver flags. 18038d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 18048d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt void (*send_action_cancel_wait)(void *priv); 18058d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 18068d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 18078d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * remain_on_channel - Remain awake on a channel 18088d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 18098d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @freq: Frequency (in MHz) of the channel 18108d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @duration: Duration in milliseconds 18118d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 18128d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 18138d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This command is used to request the driver to remain awake on the 18148d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * specified channel for the specified duration and report received 18158d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Action frames with EVENT_RX_ACTION events. Optionally, received 18168d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Probe Request frames may also be requested to be reported by calling 18178d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * probe_req_report(). These will be reported with EVENT_RX_PROBE_REQ. 18188d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 18198d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * The driver may not be at the requested channel when this function 18208d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * returns, i.e., the return code is only indicating whether the 18218d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * request was accepted. The caller will need to wait until the 18228d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * EVENT_REMAIN_ON_CHANNEL event indicates that the driver has 18238d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * completed the channel change. This may take some time due to other 18248d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * need for the radio and the caller should be prepared to timing out 18258d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * its wait since there are no guarantees on when this request can be 18268d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * executed. 18278d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 18288d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*remain_on_channel)(void *priv, unsigned int freq, 18298d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt unsigned int duration); 18308d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 18318d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 18328d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * cancel_remain_on_channel - Cancel remain-on-channel operation 18338d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 18348d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 18358d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This command can be used to cancel a remain-on-channel operation 18368d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * before its originally requested duration has passed. This could be 18378d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * used, e.g., when remain_on_channel() is used to request extra time 18388d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * to receive a response to an Action frame and the response is 18398d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * received when there is still unneeded time remaining on the 18408d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * remain-on-channel operation. 18418d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 18428d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*cancel_remain_on_channel)(void *priv); 18438d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 18448d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 18458d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * probe_req_report - Request Probe Request frames to be indicated 18468d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 18478d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @report: Whether to report received Probe Request frames 18488d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure (or if not supported) 18498d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 18508d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This command can be used to request the driver to indicate when 18518d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Probe Request frames are received with EVENT_RX_PROBE_REQ events. 18528d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Since this operation may require extra resources, e.g., due to less 18538d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * optimal hardware/firmware RX filtering, many drivers may disable 18548d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Probe Request reporting at least in station mode. This command is 18558d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * used to notify the driver when the Probe Request frames need to be 18568d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * reported, e.g., during remain-on-channel operations. 18578d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 18588d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*probe_req_report)(void *priv, int report); 18598d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 18608d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 18618d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * disable_11b_rates - Set whether IEEE 802.11b rates are used for TX 18628d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 18638d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @disabled: Whether IEEE 802.11b rates are disabled 18648d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure (or if not supported) 18658d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 18668d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This command is used to disable IEEE 802.11b rates (1, 2, 5.5, and 18678d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 11 Mbps) as TX rates for data and management frames. This can be 18688d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * used to optimize channel use when there is no need to support IEEE 18698d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 802.11b-only devices. 18708d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 18718d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*disable_11b_rates)(void *priv, int disabled); 18728d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 18738d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 18748d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * deinit_ap - Deinitialize AP mode 18758d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 18768d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure (or if not supported) 18778d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 18788d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This optional function can be used to disable AP mode related 18798d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * configuration and change the driver mode to station mode to allow 18808d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * normal station operations like scanning to be completed. 18818d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 18828d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*deinit_ap)(void *priv); 18838d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 18848d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 18858d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * suspend - Notification on system suspend/hibernate event 18868d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 18878d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 18888d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt void (*suspend)(void *priv); 18898d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 18908d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 18918d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * resume - Notification on system resume/thaw event 18928d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 18938d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 18948d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt void (*resume)(void *priv); 18958d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 18968d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 18978d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * signal_monitor - Set signal monitoring parameters 18988d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 18998d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @threshold: Threshold value for signal change events; 0 = disabled 19008d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @hysteresis: Minimum change in signal strength before indicating a 19018d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * new event 19028d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure (or if not supported) 19038d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 19048d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This function can be used to configure monitoring of signal strength 19058d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * with the current AP. Whenever signal strength drops below the 19068d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * %threshold value or increases above it, EVENT_SIGNAL_CHANGE event 19078d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * should be generated assuming the signal strength has changed at 19088d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * least %hysteresis from the previously indicated signal change event. 19098d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 19108d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*signal_monitor)(void *priv, int threshold, int hysteresis); 19118d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 19128d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 19138d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * send_frame - Send IEEE 802.11 frame (testing use only) 19148d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 19158d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @data: IEEE 802.11 frame with IEEE 802.11 header 19168d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @data_len: Size of the frame 19178d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @encrypt: Whether to encrypt the frame (if keys are set) 19188d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 19198d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 19208d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This function is only used for debugging purposes and is not 19218d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * required to be implemented for normal operations. 19228d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 19238d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*send_frame)(void *priv, const u8 *data, size_t data_len, 19248d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int encrypt); 19258d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 19268d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 19278d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * shared_freq - Get operating frequency of shared interface(s) 19288d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 19298d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: Operating frequency in MHz, 0 if no shared operation in 19308d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * use, or -1 on failure 19318d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 19328d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This command can be used to request the current operating frequency 19338d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * of any virtual interface that shares the same radio to provide 19348d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * information for channel selection for other virtual interfaces. 19358d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 19368d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*shared_freq)(void *priv); 19378d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 19388d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 19398d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * get_noa - Get current Notice of Absence attribute payload 19408d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 19418d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @buf: Buffer for returning NoA 19428d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @buf_len: Buffer length in octets 19438d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: Number of octets used in buf, 0 to indicate no NoA is being 19448d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * advertized, or -1 on failure 19458d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 19468d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This function is used to fetch the current Notice of Absence 19478d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * attribute value from GO. 19488d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 19498d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*get_noa)(void *priv, u8 *buf, size_t buf_len); 19508d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 19518d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 19528d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * set_noa - Set Notice of Absence parameters for GO (testing) 19538d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 19548d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @count: Count 19558d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @start: Start time in ms from next TBTT 19568d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @duration: Duration in ms 19578d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success or -1 on failure 19588d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 19598d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This function is used to set Notice of Absence parameters for GO. It 19608d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * is used only for testing. To disable NoA, all parameters are set to 19618d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 0. 19628d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 19638d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*set_noa)(void *priv, u8 count, int start, int duration); 19648d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 19658d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 19668d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * set_p2p_powersave - Set P2P power save options 19678d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 19688d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @legacy_ps: 0 = disable, 1 = enable, 2 = maximum PS, -1 = no change 19698d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @opp_ps: 0 = disable, 1 = enable, -1 = no change 19708d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @ctwindow: 0.. = change (msec), -1 = no change 19718d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success or -1 on failure 19728d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 19738d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*set_p2p_powersave)(void *priv, int legacy_ps, int opp_ps, 19748d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int ctwindow); 19758d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 19768d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 19778d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * ampdu - Enable/disable aggregation 19788d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 19798d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @ampdu: 1/0 = enable/disable A-MPDU aggregation 19808d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success or -1 on failure 19818d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 19828d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*ampdu)(void *priv, int ampdu); 19838d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 19848d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 19858d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * set_intra_bss - Enables/Disables intra BSS bridging 19868d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 19878d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*set_intra_bss)(void *priv, int enabled); 19888d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 19898d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 19908d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * get_radio_name - Get physical radio name for the device 19918d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 19928d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: Radio name or %NULL if not known 19938d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 19948d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * The returned data must not be modified by the caller. It is assumed 19958d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * that any interface that has the same radio name as another is 19968d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * sharing the same physical radio. This information can be used to 19978d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * share scan results etc. information between the virtual interfaces 19988d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * to speed up various operations. 19998d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 20008d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const char * (*get_radio_name)(void *priv); 20018d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 20028d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 20038d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * p2p_find - Start P2P Device Discovery 20048d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 20058d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @timeout: Timeout for find operation in seconds or 0 for no timeout 20068d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @type: Device Discovery type (enum p2p_discovery_type) 20078d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 20088d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 20098d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This function is only used if the driver implements P2P management, 20108d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * i.e., if it sets WPA_DRIVER_FLAGS_P2P_MGMT in 20118d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * struct wpa_driver_capa. 20128d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 20138d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*p2p_find)(void *priv, unsigned int timeout, int type); 20148d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 20158d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 20168d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * p2p_stop_find - Stop P2P Device Discovery 20178d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 20188d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 20198d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 20208d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This function is only used if the driver implements P2P management, 20218d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * i.e., if it sets WPA_DRIVER_FLAGS_P2P_MGMT in 20228d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * struct wpa_driver_capa. 20238d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 20248d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*p2p_stop_find)(void *priv); 20258d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 20268d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 20278d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * p2p_listen - Start P2P Listen state for specified duration 20288d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 20298d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @timeout: Listen state duration in milliseconds 20308d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 20318d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 20328d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This function can be used to request the P2P module to keep the 20338d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * device discoverable on the listen channel for an extended set of 20348d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * time. At least in its current form, this is mainly used for testing 20358d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * purposes and may not be of much use for normal P2P operations. 20368d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 20378d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This function is only used if the driver implements P2P management, 20388d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * i.e., if it sets WPA_DRIVER_FLAGS_P2P_MGMT in 20398d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * struct wpa_driver_capa. 20408d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 20418d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*p2p_listen)(void *priv, unsigned int timeout); 20428d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 20438d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 20448d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * p2p_connect - Start P2P group formation (GO negotiation) 20458d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 20468d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @peer_addr: MAC address of the peer P2P client 20478d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @wps_method: enum p2p_wps_method value indicating config method 20488d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @go_intent: Local GO intent value (1..15) 20498d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @own_interface_addr: Intended interface address to use with the 20508d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * group 20518d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @force_freq: The only allowed channel frequency in MHz or 0 20528d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @persistent_group: Whether to create persistent group 20538d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 20548d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 20558d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This function is only used if the driver implements P2P management, 20568d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * i.e., if it sets WPA_DRIVER_FLAGS_P2P_MGMT in 20578d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * struct wpa_driver_capa. 20588d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 20598d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*p2p_connect)(void *priv, const u8 *peer_addr, int wps_method, 20608d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int go_intent, const u8 *own_interface_addr, 20618d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt unsigned int force_freq, int persistent_group); 20628d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 20638d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 20648d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * wps_success_cb - Report successfully completed WPS provisioning 20658d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 20668d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @peer_addr: Peer address 20678d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 20688d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 20698d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This function is used to report successfully completed WPS 20708d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * provisioning during group formation in both GO/Registrar and 20718d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * client/Enrollee roles. 20728d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 20738d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This function is only used if the driver implements P2P management, 20748d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * i.e., if it sets WPA_DRIVER_FLAGS_P2P_MGMT in 20758d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * struct wpa_driver_capa. 20768d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 20778d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*wps_success_cb)(void *priv, const u8 *peer_addr); 20788d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 20798d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 20808d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * p2p_group_formation_failed - Report failed WPS provisioning 20818d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 20828d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 20838d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 20848d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This function is used to report failed group formation. This can 20858d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * happen either due to failed WPS provisioning or due to 15 second 20868d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * timeout during the provisioning phase. 20878d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 20888d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This function is only used if the driver implements P2P management, 20898d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * i.e., if it sets WPA_DRIVER_FLAGS_P2P_MGMT in 20908d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * struct wpa_driver_capa. 20918d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 20928d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*p2p_group_formation_failed)(void *priv); 20938d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 20948d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 20958d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * p2p_set_params - Set P2P parameters 20968d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 20978d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @params: P2P parameters 20988d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 20998d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 21008d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This function is only used if the driver implements P2P management, 21018d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * i.e., if it sets WPA_DRIVER_FLAGS_P2P_MGMT in 21028d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * struct wpa_driver_capa. 21038d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 21048d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*p2p_set_params)(void *priv, const struct p2p_params *params); 21058d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 21068d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 21078d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * p2p_prov_disc_req - Send Provision Discovery Request 21088d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 21098d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @peer_addr: MAC address of the peer P2P client 21108d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @config_methods: WPS Config Methods value (only one bit set) 21118d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 21128d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 21138d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This function can be used to request a discovered P2P peer to 21148d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * display a PIN (config_methods = WPS_CONFIG_DISPLAY) or be prepared 21158d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * to enter a PIN from us (config_methods = WPS_CONFIG_KEYPAD). The 21168d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Provision Discovery Request frame is transmitted once immediately 21178d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * and if no response is received, the frame will be sent again 21188d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * whenever the target device is discovered during device dsicovery 21198d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * (start with a p2p_find() call). Response from the peer is indicated 21208d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * with the EVENT_P2P_PROV_DISC_RESPONSE event. 21218d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 21228d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This function is only used if the driver implements P2P management, 21238d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * i.e., if it sets WPA_DRIVER_FLAGS_P2P_MGMT in 21248d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * struct wpa_driver_capa. 21258d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 21268d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*p2p_prov_disc_req)(void *priv, const u8 *peer_addr, 21278d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt u16 config_methods); 21288d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 21298d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 21308d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * p2p_sd_request - Schedule a service discovery query 21318d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 21328d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @dst: Destination peer or %NULL to apply for all peers 21338d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @tlvs: P2P Service Query TLV(s) 21348d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: Reference to the query or 0 on failure 21358d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 21368d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Response to the query is indicated with the 21378d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * EVENT_P2P_SD_RESPONSE driver event. 21388d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 21398d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This function is only used if the driver implements P2P management, 21408d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * i.e., if it sets WPA_DRIVER_FLAGS_P2P_MGMT in 21418d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * struct wpa_driver_capa. 21428d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 21438d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt u64 (*p2p_sd_request)(void *priv, const u8 *dst, 21448d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const struct wpabuf *tlvs); 21458d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 21468d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 21478d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * p2p_sd_cancel_request - Cancel a pending service discovery query 21488d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 21498d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @req: Query reference from p2p_sd_request() 21508d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 21518d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 21528d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This function is only used if the driver implements P2P management, 21538d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * i.e., if it sets WPA_DRIVER_FLAGS_P2P_MGMT in 21548d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * struct wpa_driver_capa. 21558d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 21568d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*p2p_sd_cancel_request)(void *priv, u64 req); 21578d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 21588d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 21598d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * p2p_sd_response - Send response to a service discovery query 21608d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 21618d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @freq: Frequency from EVENT_P2P_SD_REQUEST event 21628d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @dst: Destination address from EVENT_P2P_SD_REQUEST event 21638d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @dialog_token: Dialog token from EVENT_P2P_SD_REQUEST event 21648d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @resp_tlvs: P2P Service Response TLV(s) 21658d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 21668d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 21678d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This function is called as a response to the request indicated with 21688d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * the EVENT_P2P_SD_REQUEST driver event. 21698d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 21708d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This function is only used if the driver implements P2P management, 21718d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * i.e., if it sets WPA_DRIVER_FLAGS_P2P_MGMT in 21728d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * struct wpa_driver_capa. 21738d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 21748d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*p2p_sd_response)(void *priv, int freq, const u8 *dst, 21758d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt u8 dialog_token, 21768d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const struct wpabuf *resp_tlvs); 21778d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 21788d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 21798d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * p2p_service_update - Indicate a change in local services 21808d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 21818d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 21828d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 21838d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This function needs to be called whenever there is a change in 21848d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * availability of the local services. This will increment the 21858d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Service Update Indicator value which will be used in SD Request and 21868d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Response frames. 21878d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 21888d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This function is only used if the driver implements P2P management, 21898d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * i.e., if it sets WPA_DRIVER_FLAGS_P2P_MGMT in 21908d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * struct wpa_driver_capa. 21918d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 21928d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*p2p_service_update)(void *priv); 21938d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 21948d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 21958d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * p2p_reject - Reject peer device (explicitly block connections) 21968d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 21978d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @addr: MAC address of the peer 21988d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 21998d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 22008d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*p2p_reject)(void *priv, const u8 *addr); 22018d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 22028d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 22038d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * p2p_invite - Invite a P2P Device into a group 22048d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 22058d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @peer: Device Address of the peer P2P Device 22068d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @role: Local role in the group 22078d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @bssid: Group BSSID or %NULL if not known 22088d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @ssid: Group SSID 22098d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @ssid_len: Length of ssid in octets 22108d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @go_dev_addr: Forced GO Device Address or %NULL if none 22118d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @persistent_group: Whether this is to reinvoke a persistent group 22128d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 22138d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 22148d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*p2p_invite)(void *priv, const u8 *peer, int role, 22158d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *bssid, const u8 *ssid, size_t ssid_len, 22168d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *go_dev_addr, int persistent_group); 22178d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 22188d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 22198d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * send_tdls_mgmt - for sending TDLS management packets 22208d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: private driver interface data 22218d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @dst: Destination (peer) MAC address 22228d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @action_code: TDLS action code for the mssage 22238d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @dialog_token: Dialog Token to use in the message (if needed) 22248d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @status_code: Status Code or Reason Code to use (if needed) 22258d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @buf: TDLS IEs to add to the message 22268d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @len: Length of buf in octets 22278d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 22288d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 22298d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This optional function can be used to send packet to driver which is 22308d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * responsible for receiving and sending all TDLS packets. 22318d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 22328d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*send_tdls_mgmt)(void *priv, const u8 *dst, u8 action_code, 22338d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt u8 dialog_token, u16 status_code, 22348d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *buf, size_t len); 22358d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 22368d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*tdls_oper)(void *priv, enum tdls_oper oper, const u8 *peer); 22378d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 22388d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 22398d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * signal_poll - Get current connection information 22408d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @priv: Private driver interface data 22418d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @signal_info: Connection info structure 22428d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 22438d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int (*signal_poll)(void *priv, struct wpa_signal_info *signal_info); 2244bd567ad93e03f285fdad93464100148cd5ae7941Dmitry Shmidt 2245bd567ad93e03f285fdad93464100148cd5ae7941Dmitry Shmidt /** 2246bd567ad93e03f285fdad93464100148cd5ae7941Dmitry Shmidt * driver_cmd - execute driver-specific command 2247bd567ad93e03f285fdad93464100148cd5ae7941Dmitry Shmidt * @priv: private driver interface data 2248bd567ad93e03f285fdad93464100148cd5ae7941Dmitry Shmidt * @cmd: command to execute 2249bd567ad93e03f285fdad93464100148cd5ae7941Dmitry Shmidt * @buf: return buffer 2250bd567ad93e03f285fdad93464100148cd5ae7941Dmitry Shmidt * @buf_len: buffer length 2251bd567ad93e03f285fdad93464100148cd5ae7941Dmitry Shmidt * 2252bd567ad93e03f285fdad93464100148cd5ae7941Dmitry Shmidt * Returns: 0 on success, -1 on failure 2253bd567ad93e03f285fdad93464100148cd5ae7941Dmitry Shmidt */ 2254bd567ad93e03f285fdad93464100148cd5ae7941Dmitry Shmidt int (*driver_cmd)(void *priv, char *cmd, char *buf, size_t buf_len); 22558d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt}; 22568d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 22578d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 22588d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/** 22598d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * enum wpa_event_type - Event type for wpa_supplicant_event() calls 22608d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 22618d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtenum wpa_event_type { 22628d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 22638d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * EVENT_ASSOC - Association completed 22648d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 22658d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This event needs to be delivered when the driver completes IEEE 22668d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 802.11 association or reassociation successfully. 22678d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * wpa_driver_ops::get_bssid() is expected to provide the current BSSID 22688d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * after this event has been generated. In addition, optional 22698d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * EVENT_ASSOCINFO may be generated just before EVENT_ASSOC to provide 22708d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * more information about the association. If the driver interface gets 22718d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * both of these events at the same time, it can also include the 22728d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * assoc_info data in EVENT_ASSOC call. 22738d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 22748d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt EVENT_ASSOC, 22758d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 22768d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 22778d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * EVENT_DISASSOC - Association lost 22788d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 22798d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This event should be called when association is lost either due to 22808d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * receiving deauthenticate or disassociate frame from the AP or when 22818d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * sending either of these frames to the current AP. If the driver 22828d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * supports separate deauthentication event, EVENT_DISASSOC should only 22838d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * be used for disassociation and EVENT_DEAUTH for deauthentication. 22848d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * In AP mode, union wpa_event_data::disassoc_info is required. 22858d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 22868d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt EVENT_DISASSOC, 22878d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 22888d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 22898d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * EVENT_MICHAEL_MIC_FAILURE - Michael MIC (TKIP) detected 22908d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 22918d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This event must be delivered when a Michael MIC error is detected by 22928d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * the local driver. Additional data for event processing is 22938d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * provided with union wpa_event_data::michael_mic_failure. This 22948d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * information is used to request new encyption key and to initiate 22958d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * TKIP countermeasures if needed. 22968d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 22978d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt EVENT_MICHAEL_MIC_FAILURE, 22988d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 22998d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 23008d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * EVENT_SCAN_RESULTS - Scan results available 23018d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 23028d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This event must be called whenever scan results are available to be 23038d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * fetched with struct wpa_driver_ops::get_scan_results(). This event 23048d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * is expected to be used some time after struct wpa_driver_ops::scan() 23058d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * is called. If the driver provides an unsolicited event when the scan 23068d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * has been completed, this event can be used to trigger 23078d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * EVENT_SCAN_RESULTS call. If such event is not available from the 23088d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * driver, the driver wrapper code is expected to use a registered 23098d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * timeout to generate EVENT_SCAN_RESULTS call after the time that the 23108d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * scan is expected to be completed. Optional information about 23118d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * completed scan can be provided with union wpa_event_data::scan_info. 23128d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 23138d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt EVENT_SCAN_RESULTS, 23148d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 23158d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 23168d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * EVENT_ASSOCINFO - Report optional extra information for association 23178d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 23188d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This event can be used to report extra association information for 23198d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * EVENT_ASSOC processing. This extra information includes IEs from 23208d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * association frames and Beacon/Probe Response frames in union 23218d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * wpa_event_data::assoc_info. EVENT_ASSOCINFO must be send just before 23228d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * EVENT_ASSOC. Alternatively, the driver interface can include 23238d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * assoc_info data in the EVENT_ASSOC call if it has all the 23248d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * information available at the same point. 23258d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 23268d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt EVENT_ASSOCINFO, 23278d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 23288d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 23298d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * EVENT_INTERFACE_STATUS - Report interface status changes 23308d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 23318d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This optional event can be used to report changes in interface 23328d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * status (interface added/removed) using union 23338d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * wpa_event_data::interface_status. This can be used to trigger 23348d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * wpa_supplicant to stop and re-start processing for the interface, 23358d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * e.g., when a cardbus card is ejected/inserted. 23368d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 23378d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt EVENT_INTERFACE_STATUS, 23388d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 23398d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 23408d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * EVENT_PMKID_CANDIDATE - Report a candidate AP for pre-authentication 23418d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 23428d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This event can be used to inform wpa_supplicant about candidates for 23438d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * RSN (WPA2) pre-authentication. If wpa_supplicant is not responsible 23448d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * for scan request (ap_scan=2 mode), this event is required for 23458d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * pre-authentication. If wpa_supplicant is performing scan request 23468d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * (ap_scan=1), this event is optional since scan results can be used 23478d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * to add pre-authentication candidates. union 23488d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * wpa_event_data::pmkid_candidate is used to report the BSSID of the 23498d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * candidate and priority of the candidate, e.g., based on the signal 23508d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * strength, in order to try to pre-authenticate first with candidates 23518d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * that are most likely targets for re-association. 23528d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 23538d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * EVENT_PMKID_CANDIDATE can be called whenever the driver has updates 23548d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * on the candidate list. In addition, it can be called for the current 23558d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * AP and APs that have existing PMKSA cache entries. wpa_supplicant 23568d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * will automatically skip pre-authentication in cases where a valid 23578d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * PMKSA exists. When more than one candidate exists, this event should 23588d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * be generated once for each candidate. 23598d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 23608d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Driver will be notified about successful pre-authentication with 23618d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * struct wpa_driver_ops::add_pmkid() calls. 23628d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 23638d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt EVENT_PMKID_CANDIDATE, 23648d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 23658d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 23668d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * EVENT_STKSTART - Request STK handshake (MLME-STKSTART.request) 23678d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 23688d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This event can be used to inform wpa_supplicant about desire to set 23698d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * up secure direct link connection between two stations as defined in 23708d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * IEEE 802.11e with a new PeerKey mechanism that replaced the original 23718d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * STAKey negotiation. The caller will need to set peer address for the 23728d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * event. 23738d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 23748d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt EVENT_STKSTART, 23758d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 23768d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 23778d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * EVENT_TDLS - Request TDLS operation 23788d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 23798d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This event can be used to request a TDLS operation to be performed. 23808d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 23818d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt EVENT_TDLS, 23828d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 23838d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 23848d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * EVENT_FT_RESPONSE - Report FT (IEEE 802.11r) response IEs 23858d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 23868d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * The driver is expected to report the received FT IEs from 23878d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * FT authentication sequence from the AP. The FT IEs are included in 23888d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * the extra information in union wpa_event_data::ft_ies. 23898d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 23908d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt EVENT_FT_RESPONSE, 23918d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 23928d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 23938d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * EVENT_IBSS_RSN_START - Request RSN authentication in IBSS 23948d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 23958d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * The driver can use this event to inform wpa_supplicant about a STA 23968d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * in an IBSS with which protected frames could be exchanged. This 23978d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * event starts RSN authentication with the other STA to authenticate 23988d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * the STA and set up encryption keys with it. 23998d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 24008d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt EVENT_IBSS_RSN_START, 24018d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 24028d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 24038d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * EVENT_AUTH - Authentication result 24048d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 24058d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This event should be called when authentication attempt has been 24068d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * completed. This is only used if the driver supports separate 24078d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * authentication step (struct wpa_driver_ops::authenticate). 24088d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Information about authentication result is included in 24098d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * union wpa_event_data::auth. 24108d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 24118d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt EVENT_AUTH, 24128d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 24138d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 24148d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * EVENT_DEAUTH - Authentication lost 24158d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 24168d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This event should be called when authentication is lost either due 24178d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * to receiving deauthenticate frame from the AP or when sending that 24188d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * frame to the current AP. 24198d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * In AP mode, union wpa_event_data::deauth_info is required. 24208d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 24218d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt EVENT_DEAUTH, 24228d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 24238d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 24248d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * EVENT_ASSOC_REJECT - Association rejected 24258d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 24268d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This event should be called when (re)association attempt has been 24278d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * rejected by the AP. Information about the association response is 24288d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * included in union wpa_event_data::assoc_reject. 24298d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 24308d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt EVENT_ASSOC_REJECT, 24318d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 24328d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 24338d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * EVENT_AUTH_TIMED_OUT - Authentication timed out 24348d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 24358d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt EVENT_AUTH_TIMED_OUT, 24368d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 24378d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 24388d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * EVENT_ASSOC_TIMED_OUT - Association timed out 24398d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 24408d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt EVENT_ASSOC_TIMED_OUT, 24418d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 24428d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 24438d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * EVENT_FT_RRB_RX - FT (IEEE 802.11r) RRB frame received 24448d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 24458d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt EVENT_FT_RRB_RX, 24468d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 24478d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 24488d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * EVENT_WPS_BUTTON_PUSHED - Report hardware push button press for WPS 24498d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 24508d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt EVENT_WPS_BUTTON_PUSHED, 24518d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 24528d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 24538d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * EVENT_TX_STATUS - Report TX status 24548d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 24558d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt EVENT_TX_STATUS, 24568d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 24578d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 24588d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * EVENT_RX_FROM_UNKNOWN - Report RX from unknown STA 24598d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 24608d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt EVENT_RX_FROM_UNKNOWN, 24618d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 24628d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 24638d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * EVENT_RX_MGMT - Report RX of a management frame 24648d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 24658d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt EVENT_RX_MGMT, 24668d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 24678d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 24688d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * EVENT_RX_ACTION - Action frame received 24698d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 24708d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This event is used to indicate when an Action frame has been 24718d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * received. Information about the received frame is included in 24728d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * union wpa_event_data::rx_action. 24738d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 24748d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt EVENT_RX_ACTION, 24758d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 24768d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 24778d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * EVENT_REMAIN_ON_CHANNEL - Remain-on-channel duration started 24788d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 24798d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This event is used to indicate when the driver has started the 24808d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * requested remain-on-channel duration. Information about the 24818d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * operation is included in union wpa_event_data::remain_on_channel. 24828d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 24838d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt EVENT_REMAIN_ON_CHANNEL, 24848d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 24858d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 24868d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * EVENT_CANCEL_REMAIN_ON_CHANNEL - Remain-on-channel timed out 24878d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 24888d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This event is used to indicate when the driver has completed 24898d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * remain-on-channel duration, i.e., may noot be available on the 24908d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * requested channel anymore. Information about the 24918d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * operation is included in union wpa_event_data::remain_on_channel. 24928d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 24938d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt EVENT_CANCEL_REMAIN_ON_CHANNEL, 24948d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 24958d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 24968d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * EVENT_MLME_RX - Report reception of frame for MLME (test use only) 24978d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 24988d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This event is used only by driver_test.c and userspace MLME. 24998d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 25008d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt EVENT_MLME_RX, 25018d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 25028d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 25038d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * EVENT_RX_PROBE_REQ - Indicate received Probe Request frame 25048d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 25058d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This event is used to indicate when a Probe Request frame has been 25068d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * received. Information about the received frame is included in 25078d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * union wpa_event_data::rx_probe_req. The driver is required to report 25088d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * these events only after successfully completed probe_req_report() 25098d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * commands to request the events (i.e., report parameter is non-zero) 25108d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * in station mode. In AP mode, Probe Request frames should always be 25118d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * reported. 25128d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 25138d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt EVENT_RX_PROBE_REQ, 25148d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 25158d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 25168d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * EVENT_NEW_STA - New wired device noticed 25178d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 25188d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This event is used to indicate that a new device has been detected 25198d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * in a network that does not use association-like functionality (i.e., 25208d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * mainly wired Ethernet). This can be used to start EAPOL 25218d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * authenticator when receiving a frame from a device. The address of 25228d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * the device is included in union wpa_event_data::new_sta. 25238d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 25248d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt EVENT_NEW_STA, 25258d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 25268d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 25278d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * EVENT_EAPOL_RX - Report received EAPOL frame 25288d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 25298d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * When in AP mode with hostapd, this event is required to be used to 25308d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * deliver the receive EAPOL frames from the driver. With 25318d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * %wpa_supplicant, this event is used only if the send_eapol() handler 25328d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * is used to override the use of l2_packet for EAPOL frame TX. 25338d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 25348d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt EVENT_EAPOL_RX, 25358d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 25368d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 25378d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * EVENT_SIGNAL_CHANGE - Indicate change in signal strength 25388d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 25398d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This event is used to indicate changes in the signal strength 25408d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * observed in frames received from the current AP if signal strength 25418d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * monitoring has been enabled with signal_monitor(). 25428d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 25438d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt EVENT_SIGNAL_CHANGE, 25448d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 25458d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 25468d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * EVENT_INTERFACE_ENABLED - Notify that interface was enabled 25478d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 25488d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This event is used to indicate that the interface was enabled after 25498d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * having been previously disabled, e.g., due to rfkill. 25508d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 25518d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt EVENT_INTERFACE_ENABLED, 25528d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 25538d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 25548d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * EVENT_INTERFACE_DISABLED - Notify that interface was disabled 25558d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 25568d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This event is used to indicate that the interface was disabled, 25578d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * e.g., due to rfkill. 25588d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 25598d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt EVENT_INTERFACE_DISABLED, 25608d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 25618d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 25628d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * EVENT_CHANNEL_LIST_CHANGED - Channel list changed 25638d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 25648d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This event is used to indicate that the channel list has changed, 25658d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * e.g., because of a regulatory domain change triggered by scan 25668d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * results including an AP advertising a country code. 25678d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 25688d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt EVENT_CHANNEL_LIST_CHANGED, 25698d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 25708d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 25718d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * EVENT_INTERFACE_UNAVAILABLE - Notify that interface is unavailable 25728d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 25738d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This event is used to indicate that the driver cannot maintain this 25748d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * interface in its operation mode anymore. The most likely use for 25758d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * this is to indicate that AP mode operation is not available due to 25768d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * operating channel would need to be changed to a DFS channel when 25778d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * the driver does not support radar detection and another virtual 25788d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * interfaces caused the operating channel to change. Other similar 25798d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * resource conflicts could also trigger this for station mode 25808d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * interfaces. 25818d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 25828d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt EVENT_INTERFACE_UNAVAILABLE, 25838d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 25848d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 25858d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * EVENT_BEST_CHANNEL 25868d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 25878d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Driver generates this event whenever it detects a better channel 25888d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * (e.g., based on RSSI or channel use). This information can be used 25898d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * to improve channel selection for a new AP/P2P group. 25908d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 25918d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt EVENT_BEST_CHANNEL, 25928d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 25938d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 25948d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * EVENT_UNPROT_DEAUTH - Unprotected Deauthentication frame received 25958d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 25968d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This event should be called when a Deauthentication frame is dropped 25978d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * due to it not being protected (MFP/IEEE 802.11w). 25988d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * union wpa_event_data::unprot_deauth is required to provide more 25998d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * details of the frame. 26008d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 26018d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt EVENT_UNPROT_DEAUTH, 26028d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 26038d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 26048d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * EVENT_UNPROT_DISASSOC - Unprotected Disassociation frame received 26058d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 26068d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This event should be called when a Disassociation frame is dropped 26078d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * due to it not being protected (MFP/IEEE 802.11w). 26088d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * union wpa_event_data::unprot_disassoc is required to provide more 26098d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * details of the frame. 26108d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 26118d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt EVENT_UNPROT_DISASSOC, 26128d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 26138d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 26148d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * EVENT_STATION_LOW_ACK 26158d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 26168d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Driver generates this event whenever it detected that a particular 26178d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * station was lost. Detection can be through massive transmission 26188d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * failures for example. 26198d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 26208d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt EVENT_STATION_LOW_ACK, 26218d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 26228d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 26238d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * EVENT_P2P_DEV_FOUND - Report a discovered P2P device 26248d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 26258d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This event is used only if the driver implements P2P management 26268d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * internally. Event data is stored in 26278d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * union wpa_event_data::p2p_dev_found. 26288d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 26298d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt EVENT_P2P_DEV_FOUND, 26308d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 26318d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 26328d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * EVENT_P2P_GO_NEG_REQ_RX - Report reception of GO Negotiation Request 26338d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 26348d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This event is used only if the driver implements P2P management 26358d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * internally. Event data is stored in 26368d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * union wpa_event_data::p2p_go_neg_req_rx. 26378d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 26388d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt EVENT_P2P_GO_NEG_REQ_RX, 26398d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 26408d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 26418d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * EVENT_P2P_GO_NEG_COMPLETED - Report completion of GO Negotiation 26428d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 26438d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This event is used only if the driver implements P2P management 26448d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * internally. Event data is stored in 26458d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * union wpa_event_data::p2p_go_neg_completed. 26468d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 26478d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt EVENT_P2P_GO_NEG_COMPLETED, 26488d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 26498d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt EVENT_P2P_PROV_DISC_REQUEST, 26508d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt EVENT_P2P_PROV_DISC_RESPONSE, 26518d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt EVENT_P2P_SD_REQUEST, 26528d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt EVENT_P2P_SD_RESPONSE, 26538d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 26548d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 26558d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * EVENT_IBSS_PEER_LOST - IBSS peer not reachable anymore 26568d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 26578d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt EVENT_IBSS_PEER_LOST 26588d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt}; 26598d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 26608d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 26618d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/** 26628d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * union wpa_event_data - Additional data for wpa_supplicant_event() calls 26638d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 26648d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtunion wpa_event_data { 26658d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 26668d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * struct assoc_info - Data for EVENT_ASSOC and EVENT_ASSOCINFO events 26678d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 26688d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This structure is optional for EVENT_ASSOC calls and required for 26698d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * EVENT_ASSOCINFO calls. By using EVENT_ASSOC with this data, the 26708d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * driver interface does not need to generate separate EVENT_ASSOCINFO 26718d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * calls. 26728d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 26738d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt struct assoc_info { 26748d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 26758d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * reassoc - Flag to indicate association or reassociation 26768d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 26778d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int reassoc; 26788d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 26798d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 26808d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * req_ies - (Re)Association Request IEs 26818d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 26828d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * If the driver generates WPA/RSN IE, this event data must be 26838d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * returned for WPA handshake to have needed information. If 26848d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * wpa_supplicant-generated WPA/RSN IE is used, this 26858d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * information event is optional. 26868d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 26878d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This should start with the first IE (fixed fields before IEs 26888d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * are not included). 26898d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 26908d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *req_ies; 26918d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 26928d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 26938d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * req_ies_len - Length of req_ies in bytes 26948d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 26958d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt size_t req_ies_len; 26968d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 26978d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 26988d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * resp_ies - (Re)Association Response IEs 26998d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 27008d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Optional association data from the driver. This data is not 27018d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * required WPA, but may be useful for some protocols and as 27028d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * such, should be reported if this is available to the driver 27038d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * interface. 27048d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 27058d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This should start with the first IE (fixed fields before IEs 27068d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * are not included). 27078d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 27088d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *resp_ies; 27098d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 27108d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 27118d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * resp_ies_len - Length of resp_ies in bytes 27128d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 27138d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt size_t resp_ies_len; 27148d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 27158d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 27168d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * beacon_ies - Beacon or Probe Response IEs 27178d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 27188d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Optional Beacon/ProbeResp data: IEs included in Beacon or 27198d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Probe Response frames from the current AP (i.e., the one 27208d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * that the client just associated with). This information is 27218d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * used to update WPA/RSN IE for the AP. If this field is not 27228d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * set, the results from previous scan will be used. If no 27238d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * data for the new AP is found, scan results will be requested 27248d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * again (without scan request). At this point, the driver is 27258d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * expected to provide WPA/RSN IE for the AP (if WPA/WPA2 is 27268d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * used). 27278d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 27288d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This should start with the first IE (fixed fields before IEs 27298d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * are not included). 27308d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 27318d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *beacon_ies; 27328d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 27338d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 27348d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * beacon_ies_len - Length of beacon_ies */ 27358d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt size_t beacon_ies_len; 27368d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 27378d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 27388d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * freq - Frequency of the operational channel in MHz 27398d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 27408d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt unsigned int freq; 27418d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 27428d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 27438d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * addr - Station address (for AP mode) 27448d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 27458d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *addr; 27468d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt } assoc_info; 27478d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 27488d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 27498d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * struct disassoc_info - Data for EVENT_DISASSOC events 27508d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 27518d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt struct disassoc_info { 27528d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 27538d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * addr - Station address (for AP mode) 27548d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 27558d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *addr; 27568d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 27578d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 27588d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * reason_code - Reason Code (host byte order) used in 27598d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Deauthentication frame 27608d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 27618d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt u16 reason_code; 27628d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 27638d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 27648d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * ie - Optional IE(s) in Disassociation frame 27658d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 27668d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *ie; 27678d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 27688d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 27698d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * ie_len - Length of ie buffer in octets 27708d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 27718d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt size_t ie_len; 27728d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt } disassoc_info; 27738d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 27748d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 27758d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * struct deauth_info - Data for EVENT_DEAUTH events 27768d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 27778d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt struct deauth_info { 27788d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 27798d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * addr - Station address (for AP mode) 27808d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 27818d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *addr; 27828d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 27838d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 27848d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * reason_code - Reason Code (host byte order) used in 27858d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Deauthentication frame 27868d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 27878d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt u16 reason_code; 27888d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 27898d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 27908d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * ie - Optional IE(s) in Deauthentication frame 27918d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 27928d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *ie; 27938d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 27948d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 27958d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * ie_len - Length of ie buffer in octets 27968d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 27978d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt size_t ie_len; 27988d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt } deauth_info; 27998d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 28008d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 28018d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * struct michael_mic_failure - Data for EVENT_MICHAEL_MIC_FAILURE 28028d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 28038d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt struct michael_mic_failure { 28048d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int unicast; 28058d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *src; 28068d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt } michael_mic_failure; 28078d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 28088d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 28098d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * struct interface_status - Data for EVENT_INTERFACE_STATUS 28108d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 28118d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt struct interface_status { 28128d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt char ifname[100]; 28138d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt enum { 28148d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt EVENT_INTERFACE_ADDED, EVENT_INTERFACE_REMOVED 28158d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt } ievent; 28168d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt } interface_status; 28178d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 28188d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 28198d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * struct pmkid_candidate - Data for EVENT_PMKID_CANDIDATE 28208d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 28218d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt struct pmkid_candidate { 28228d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** BSSID of the PMKID candidate */ 28238d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt u8 bssid[ETH_ALEN]; 28248d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** Smaller the index, higher the priority */ 28258d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int index; 28268d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** Whether RSN IE includes pre-authenticate flag */ 28278d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int preauth; 28288d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt } pmkid_candidate; 28298d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 28308d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 28318d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * struct stkstart - Data for EVENT_STKSTART 28328d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 28338d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt struct stkstart { 28348d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt u8 peer[ETH_ALEN]; 28358d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt } stkstart; 28368d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 28378d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 28388d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * struct tdls - Data for EVENT_TDLS 28398d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 28408d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt struct tdls { 28418d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt u8 peer[ETH_ALEN]; 28428d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt enum { 28438d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt TDLS_REQUEST_SETUP, 28448d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt TDLS_REQUEST_TEARDOWN 28458d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt } oper; 28468d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt u16 reason_code; /* for teardown */ 28478d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt } tdls; 28488d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 28498d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 28508d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * struct ft_ies - FT information elements (EVENT_FT_RESPONSE) 28518d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 28528d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * During FT (IEEE 802.11r) authentication sequence, the driver is 28538d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * expected to use this event to report received FT IEs (MDIE, FTIE, 28548d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * RSN IE, TIE, possible resource request) to the supplicant. The FT 28558d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * IEs for the next message will be delivered through the 28568d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * struct wpa_driver_ops::update_ft_ies() callback. 28578d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 28588d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt struct ft_ies { 28598d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *ies; 28608d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt size_t ies_len; 28618d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int ft_action; 28628d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt u8 target_ap[ETH_ALEN]; 28638d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** Optional IE(s), e.g., WMM TSPEC(s), for RIC-Request */ 28648d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *ric_ies; 28658d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** Length of ric_ies buffer in octets */ 28668d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt size_t ric_ies_len; 28678d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt } ft_ies; 28688d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 28698d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 28708d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * struct ibss_rsn_start - Data for EVENT_IBSS_RSN_START 28718d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 28728d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt struct ibss_rsn_start { 28738d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt u8 peer[ETH_ALEN]; 28748d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt } ibss_rsn_start; 28758d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 28768d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 28778d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * struct auth_info - Data for EVENT_AUTH events 28788d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 28798d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt struct auth_info { 28808d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt u8 peer[ETH_ALEN]; 28818d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt u16 auth_type; 28828d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt u16 status_code; 28838d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *ies; 28848d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt size_t ies_len; 28858d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt } auth; 28868d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 28878d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 28888d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * struct assoc_reject - Data for EVENT_ASSOC_REJECT events 28898d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 28908d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt struct assoc_reject { 28918d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 28928d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * bssid - BSSID of the AP that rejected association 28938d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 28948d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *bssid; 28958d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 28968d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 28978d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * resp_ies - (Re)Association Response IEs 28988d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 28998d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Optional association data from the driver. This data is not 29008d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * required WPA, but may be useful for some protocols and as 29018d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * such, should be reported if this is available to the driver 29028d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * interface. 29038d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 29048d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This should start with the first IE (fixed fields before IEs 29058d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * are not included). 29068d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 29078d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *resp_ies; 29088d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 29098d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 29108d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * resp_ies_len - Length of resp_ies in bytes 29118d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 29128d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt size_t resp_ies_len; 29138d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 29148d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 29158d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * status_code - Status Code from (Re)association Response 29168d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 29178d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt u16 status_code; 29188d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt } assoc_reject; 29198d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 29208d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt struct timeout_event { 29218d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt u8 addr[ETH_ALEN]; 29228d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt } timeout_event; 29238d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 29248d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 29258d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * struct ft_rrb_rx - Data for EVENT_FT_RRB_RX events 29268d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 29278d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt struct ft_rrb_rx { 29288d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *src; 29298d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *data; 29308d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt size_t data_len; 29318d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt } ft_rrb_rx; 29328d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 29338d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 29348d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * struct tx_status - Data for EVENT_TX_STATUS events 29358d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 29368d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt struct tx_status { 29378d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt u16 type; 29388d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt u16 stype; 29398d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *dst; 29408d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *data; 29418d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt size_t data_len; 29428d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int ack; 29438d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt } tx_status; 29448d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 29458d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 29468d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * struct rx_from_unknown - Data for EVENT_RX_FROM_UNKNOWN events 29478d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 29488d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt struct rx_from_unknown { 29498d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *frame; 29508d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt size_t len; 29518d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt } rx_from_unknown; 29528d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 29538d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 29548d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * struct rx_mgmt - Data for EVENT_RX_MGMT events 29558d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 29568d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt struct rx_mgmt { 29578d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *frame; 29588d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt size_t frame_len; 29598d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt u32 datarate; 29608d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt u32 ssi_signal; 29618d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt } rx_mgmt; 29628d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 29638d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 29648d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * struct rx_action - Data for EVENT_RX_ACTION events 29658d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 29668d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt struct rx_action { 29678d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 29688d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * da - Destination address of the received Action frame 29698d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 29708d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *da; 29718d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 29728d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 29738d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * sa - Source address of the received Action frame 29748d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 29758d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *sa; 29768d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 29778d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 29788d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * bssid - Address 3 of the received Action frame 29798d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 29808d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *bssid; 29818d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 29828d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 29838d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * category - Action frame category 29848d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 29858d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt u8 category; 29868d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 29878d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 29888d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * data - Action frame body after category field 29898d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 29908d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *data; 29918d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 29928d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 29938d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * len - Length of data in octets 29948d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 29958d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt size_t len; 29968d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 29978d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 29988d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * freq - Frequency (in MHz) on which the frame was received 29998d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 30008d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int freq; 30018d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt } rx_action; 30028d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 30038d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 30048d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * struct remain_on_channel - Data for EVENT_REMAIN_ON_CHANNEL events 30058d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 30068d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This is also used with EVENT_CANCEL_REMAIN_ON_CHANNEL events. 30078d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 30088d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt struct remain_on_channel { 30098d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 30108d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * freq - Channel frequency in MHz 30118d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 30128d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt unsigned int freq; 30138d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 30148d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 30158d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * duration - Duration to remain on the channel in milliseconds 30168d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 30178d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt unsigned int duration; 30188d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt } remain_on_channel; 30198d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 30208d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 30218d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * struct scan_info - Optional data for EVENT_SCAN_RESULTS events 30228d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @aborted: Whether the scan was aborted 30238d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @freqs: Scanned frequencies in MHz (%NULL = all channels scanned) 30248d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @num_freqs: Number of entries in freqs array 30258d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @ssids: Scanned SSIDs (%NULL or zero-length SSID indicates wildcard 30268d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * SSID) 30278d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @num_ssids: Number of entries in ssids array 30288d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 30298d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt struct scan_info { 30308d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int aborted; 30318d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const int *freqs; 30328d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt size_t num_freqs; 30338d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt struct wpa_driver_scan_ssid ssids[WPAS_MAX_SCAN_SSIDS]; 30348d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt size_t num_ssids; 30358d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt } scan_info; 30368d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 30378d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 30388d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * struct mlme_rx - Data for EVENT_MLME_RX events 30398d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 30408d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt struct mlme_rx { 30418d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *buf; 30428d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt size_t len; 30438d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int freq; 30448d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int channel; 30458d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int ssi; 30468d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt } mlme_rx; 30478d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 30488d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 30498d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * struct rx_probe_req - Data for EVENT_RX_PROBE_REQ events 30508d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 30518d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt struct rx_probe_req { 30528d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 30538d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * sa - Source address of the received Probe Request frame 30548d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 30558d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *sa; 30568d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 30578d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 30588d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * ie - IEs from the Probe Request body 30598d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 30608d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *ie; 30618d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 30628d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 30638d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * ie_len - Length of ie buffer in octets 30648d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 30658d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt size_t ie_len; 30668d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt } rx_probe_req; 30678d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 30688d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 30698d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * struct new_sta - Data for EVENT_NEW_STA events 30708d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 30718d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt struct new_sta { 30728d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *addr; 30738d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt } new_sta; 30748d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 30758d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 30768d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * struct eapol_rx - Data for EVENT_EAPOL_RX events 30778d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 30788d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt struct eapol_rx { 30798d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *src; 30808d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *data; 30818d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt size_t data_len; 30828d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt } eapol_rx; 30838d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 30848d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 30858d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * signal_change - Data for EVENT_SIGNAL_CHANGE events 30868d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 30878d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt struct wpa_signal_info signal_change; 30888d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 30898d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 30908d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * struct best_channel - Data for EVENT_BEST_CHANNEL events 30918d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @freq_24: Best 2.4 GHz band channel frequency in MHz 30928d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @freq_5: Best 5 GHz band channel frequency in MHz 30938d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @freq_overall: Best channel frequency in MHz 30948d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 30958d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 0 can be used to indicate no preference in either band. 30968d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 30978d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt struct best_channel { 30988d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int freq_24; 30998d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int freq_5; 31008d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int freq_overall; 31018d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt } best_chan; 31028d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 31038d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt struct unprot_deauth { 31048d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *sa; 31058d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *da; 31068d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt u16 reason_code; 31078d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt } unprot_deauth; 31088d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 31098d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt struct unprot_disassoc { 31108d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *sa; 31118d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *da; 31128d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt u16 reason_code; 31138d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt } unprot_disassoc; 31148d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 31158d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 31168d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * struct low_ack - Data for EVENT_STATION_LOW_ACK events 31178d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @addr: station address 31188d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 31198d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt struct low_ack { 31208d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt u8 addr[ETH_ALEN]; 31218d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt } low_ack; 31228d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 31238d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 31248d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * struct p2p_dev_found - Data for EVENT_P2P_DEV_FOUND 31258d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 31268d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt struct p2p_dev_found { 31278d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *addr; 31288d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *dev_addr; 31298d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *pri_dev_type; 31308d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const char *dev_name; 31318d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt u16 config_methods; 31328d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt u8 dev_capab; 31338d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt u8 group_capab; 31348d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt } p2p_dev_found; 31358d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 31368d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 31378d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * struct p2p_go_neg_req_rx - Data for EVENT_P2P_GO_NEG_REQ_RX 31388d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 31398d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt struct p2p_go_neg_req_rx { 31408d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *src; 31418d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt u16 dev_passwd_id; 31428d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt } p2p_go_neg_req_rx; 31438d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 31448d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 31458d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * struct p2p_go_neg_completed - Data for EVENT_P2P_GO_NEG_COMPLETED 31468d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 31478d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt struct p2p_go_neg_completed { 31488d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt struct p2p_go_neg_results *res; 31498d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt } p2p_go_neg_completed; 31508d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 31518d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt struct p2p_prov_disc_req { 31528d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *peer; 31538d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt u16 config_methods; 31548d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *dev_addr; 31558d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *pri_dev_type; 31568d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const char *dev_name; 31578d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt u16 supp_config_methods; 31588d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt u8 dev_capab; 31598d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt u8 group_capab; 31608d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt } p2p_prov_disc_req; 31618d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 31628d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt struct p2p_prov_disc_resp { 31638d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *peer; 31648d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt u16 config_methods; 31658d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt } p2p_prov_disc_resp; 31668d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 31678d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt struct p2p_sd_req { 31688d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt int freq; 31698d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *sa; 31708d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt u8 dialog_token; 31718d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt u16 update_indic; 31728d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *tlvs; 31738d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt size_t tlvs_len; 31748d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt } p2p_sd_req; 31758d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 31768d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt struct p2p_sd_resp { 31778d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *sa; 31788d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt u16 update_indic; 31798d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt const u8 *tlvs; 31808d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt size_t tlvs_len; 31818d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt } p2p_sd_resp; 31828d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 31838d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt /** 31848d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * struct ibss_peer_lost - Data for EVENT_IBSS_PEER_LOST 31858d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 31868d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt struct ibss_peer_lost { 31878d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt u8 peer[ETH_ALEN]; 31888d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt } ibss_peer_lost; 31898d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt}; 31908d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 31918d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/** 31928d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * wpa_supplicant_event - Report a driver event for wpa_supplicant 31938d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @ctx: Context pointer (wpa_s); this is the ctx variable registered 31948d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * with struct wpa_driver_ops::init() 31958d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @event: event type (defined above) 31968d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @data: possible extra data for the event 31978d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 31988d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Driver wrapper code should call this function whenever an event is received 31998d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * from the driver. 32008d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 32018d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtvoid wpa_supplicant_event(void *ctx, enum wpa_event_type event, 32028d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt union wpa_event_data *data); 32038d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 32048d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 32058d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/* 32068d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * The following inline functions are provided for convenience to simplify 32078d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * event indication for some of the common events. 32088d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 32098d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 32108d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtstatic inline void drv_event_assoc(void *ctx, const u8 *addr, const u8 *ie, 32118d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt size_t ielen, int reassoc) 32128d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt{ 32138d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt union wpa_event_data event; 32148d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt os_memset(&event, 0, sizeof(event)); 32158d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt event.assoc_info.reassoc = reassoc; 32168d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt event.assoc_info.req_ies = ie; 32178d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt event.assoc_info.req_ies_len = ielen; 32188d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt event.assoc_info.addr = addr; 32198d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt wpa_supplicant_event(ctx, EVENT_ASSOC, &event); 32208d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt} 32218d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 32228d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtstatic inline void drv_event_disassoc(void *ctx, const u8 *addr) 32238d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt{ 32248d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt union wpa_event_data event; 32258d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt os_memset(&event, 0, sizeof(event)); 32268d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt event.disassoc_info.addr = addr; 32278d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt wpa_supplicant_event(ctx, EVENT_DISASSOC, &event); 32288d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt} 32298d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 32308d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtstatic inline void drv_event_eapol_rx(void *ctx, const u8 *src, const u8 *data, 32318d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt size_t data_len) 32328d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt{ 32338d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt union wpa_event_data event; 32348d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt os_memset(&event, 0, sizeof(event)); 32358d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt event.eapol_rx.src = src; 32368d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt event.eapol_rx.data = data; 32378d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt event.eapol_rx.data_len = data_len; 32388d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt wpa_supplicant_event(ctx, EVENT_EAPOL_RX, &event); 32398d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt} 32408d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 32418d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#endif /* DRIVER_H */ 3242