blob: d29d11a31f5a077a1617b03999cf856a99ecb3ea [file] [log] [blame]
Johannes Berg704232c2007-04-23 12:20:05 -07001#ifndef __NET_CFG80211_H
2#define __NET_CFG80211_H
Johannes Bergd3236552009-04-20 14:31:42 +02003/*
4 * 802.11 device and configuration interface
5 *
Jouni Malinen026331c2010-02-15 12:53:10 +02006 * Copyright 2006-2010 Johannes Berg <johannes@sipsolutions.net>
Johannes Bergd3236552009-04-20 14:31:42 +02007 *
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License version 2 as
10 * published by the Free Software Foundation.
11 */
Johannes Berg704232c2007-04-23 12:20:05 -070012
Johannes Bergd3236552009-04-20 14:31:42 +020013#include <linux/netdevice.h>
14#include <linux/debugfs.h>
15#include <linux/list.h>
Johannes Berg704232c2007-04-23 12:20:05 -070016#include <linux/netlink.h>
17#include <linux/skbuff.h>
Johannes Berg55682962007-09-20 13:09:35 -040018#include <linux/nl80211.h>
Johannes Berg2a519312009-02-10 21:25:55 +010019#include <linux/if_ether.h>
20#include <linux/ieee80211.h>
Johannes Bergd3236552009-04-20 14:31:42 +020021#include <net/regulatory.h>
22
Johannes Bergd70e9692010-08-19 16:11:27 +020023/**
24 * DOC: Introduction
25 *
26 * cfg80211 is the configuration API for 802.11 devices in Linux. It bridges
27 * userspace and drivers, and offers some utility functionality associated
28 * with 802.11. cfg80211 must, directly or indirectly via mac80211, be used
29 * by all modern wireless drivers in Linux, so that they offer a consistent
30 * API through nl80211. For backward compatibility, cfg80211 also offers
31 * wireless extensions to userspace, but hides them from drivers completely.
32 *
33 * Additionally, cfg80211 contains code to help enforce regulatory spectrum
34 * use restrictions.
35 */
36
37
38/**
39 * DOC: Device registration
40 *
41 * In order for a driver to use cfg80211, it must register the hardware device
42 * with cfg80211. This happens through a number of hardware capability structs
43 * described below.
44 *
45 * The fundamental structure for each device is the 'wiphy', of which each
46 * instance describes a physical wireless device connected to the system. Each
47 * such wiphy can have zero, one, or many virtual interfaces associated with
48 * it, which need to be identified as such by pointing the network interface's
49 * @ieee80211_ptr pointer to a &struct wireless_dev which further describes
50 * the wireless part of the interface, normally this struct is embedded in the
51 * network interface's private data area. Drivers can optionally allow creating
52 * or destroying virtual interfaces on the fly, but without at least one or the
53 * ability to create some the wireless device isn't useful.
54 *
55 * Each wiphy structure contains device capability information, and also has
56 * a pointer to the various operations the driver offers. The definitions and
57 * structures here describe these capabilities in detail.
58 */
59
Johannes Berg704232c2007-04-23 12:20:05 -070060/*
Johannes Bergd3236552009-04-20 14:31:42 +020061 * wireless hardware capability structures
62 */
63
64/**
65 * enum ieee80211_band - supported frequency bands
Johannes Berg704232c2007-04-23 12:20:05 -070066 *
Johannes Bergd3236552009-04-20 14:31:42 +020067 * The bands are assigned this way because the supported
68 * bitrates differ in these bands.
69 *
70 * @IEEE80211_BAND_2GHZ: 2.4GHz ISM band
71 * @IEEE80211_BAND_5GHZ: around 5GHz band (4.9-5.7)
Johannes Bergabe37c42010-06-07 11:12:27 +020072 * @IEEE80211_NUM_BANDS: number of defined bands
Johannes Bergd3236552009-04-20 14:31:42 +020073 */
74enum ieee80211_band {
Jouni Malinen13ae75b2009-12-29 12:59:45 +020075 IEEE80211_BAND_2GHZ = NL80211_BAND_2GHZ,
76 IEEE80211_BAND_5GHZ = NL80211_BAND_5GHZ,
Johannes Bergd3236552009-04-20 14:31:42 +020077
78 /* keep last */
79 IEEE80211_NUM_BANDS
80};
81
82/**
83 * enum ieee80211_channel_flags - channel flags
84 *
85 * Channel flags set by the regulatory control code.
86 *
87 * @IEEE80211_CHAN_DISABLED: This channel is disabled.
88 * @IEEE80211_CHAN_PASSIVE_SCAN: Only passive scanning is permitted
89 * on this channel.
90 * @IEEE80211_CHAN_NO_IBSS: IBSS is not allowed on this channel.
91 * @IEEE80211_CHAN_RADAR: Radar detection is required on this channel.
Luis R. Rodriguez689da1b2009-05-02 00:37:18 -040092 * @IEEE80211_CHAN_NO_HT40PLUS: extension channel above this channel
Johannes Bergd3236552009-04-20 14:31:42 +020093 * is not permitted.
Luis R. Rodriguez689da1b2009-05-02 00:37:18 -040094 * @IEEE80211_CHAN_NO_HT40MINUS: extension channel below this channel
Johannes Bergd3236552009-04-20 14:31:42 +020095 * is not permitted.
96 */
97enum ieee80211_channel_flags {
98 IEEE80211_CHAN_DISABLED = 1<<0,
99 IEEE80211_CHAN_PASSIVE_SCAN = 1<<1,
100 IEEE80211_CHAN_NO_IBSS = 1<<2,
101 IEEE80211_CHAN_RADAR = 1<<3,
Luis R. Rodriguez689da1b2009-05-02 00:37:18 -0400102 IEEE80211_CHAN_NO_HT40PLUS = 1<<4,
103 IEEE80211_CHAN_NO_HT40MINUS = 1<<5,
Johannes Bergd3236552009-04-20 14:31:42 +0200104};
105
Luis R. Rodriguez038659e2009-05-02 00:37:17 -0400106#define IEEE80211_CHAN_NO_HT40 \
Luis R. Rodriguez689da1b2009-05-02 00:37:18 -0400107 (IEEE80211_CHAN_NO_HT40PLUS | IEEE80211_CHAN_NO_HT40MINUS)
Luis R. Rodriguez038659e2009-05-02 00:37:17 -0400108
Johannes Bergd3236552009-04-20 14:31:42 +0200109/**
110 * struct ieee80211_channel - channel definition
111 *
112 * This structure describes a single channel for use
113 * with cfg80211.
114 *
115 * @center_freq: center frequency in MHz
Johannes Bergd3236552009-04-20 14:31:42 +0200116 * @hw_value: hardware-specific value for the channel
117 * @flags: channel flags from &enum ieee80211_channel_flags.
118 * @orig_flags: channel flags at registration time, used by regulatory
119 * code to support devices with additional restrictions
120 * @band: band this channel belongs to.
121 * @max_antenna_gain: maximum antenna gain in dBi
122 * @max_power: maximum transmission power (in dBm)
123 * @beacon_found: helper to regulatory code to indicate when a beacon
124 * has been found on this channel. Use regulatory_hint_found_beacon()
Walter Goldens77c20612010-05-18 04:44:54 -0700125 * to enable this, this is useful only on 5 GHz band.
Johannes Bergd3236552009-04-20 14:31:42 +0200126 * @orig_mag: internal use
127 * @orig_mpwr: internal use
128 */
129struct ieee80211_channel {
130 enum ieee80211_band band;
131 u16 center_freq;
Johannes Bergd3236552009-04-20 14:31:42 +0200132 u16 hw_value;
133 u32 flags;
134 int max_antenna_gain;
135 int max_power;
136 bool beacon_found;
137 u32 orig_flags;
138 int orig_mag, orig_mpwr;
139};
140
141/**
142 * enum ieee80211_rate_flags - rate flags
143 *
144 * Hardware/specification flags for rates. These are structured
145 * in a way that allows using the same bitrate structure for
146 * different bands/PHY modes.
147 *
148 * @IEEE80211_RATE_SHORT_PREAMBLE: Hardware can send with short
149 * preamble on this bitrate; only relevant in 2.4GHz band and
150 * with CCK rates.
151 * @IEEE80211_RATE_MANDATORY_A: This bitrate is a mandatory rate
152 * when used with 802.11a (on the 5 GHz band); filled by the
153 * core code when registering the wiphy.
154 * @IEEE80211_RATE_MANDATORY_B: This bitrate is a mandatory rate
155 * when used with 802.11b (on the 2.4 GHz band); filled by the
156 * core code when registering the wiphy.
157 * @IEEE80211_RATE_MANDATORY_G: This bitrate is a mandatory rate
158 * when used with 802.11g (on the 2.4 GHz band); filled by the
159 * core code when registering the wiphy.
160 * @IEEE80211_RATE_ERP_G: This is an ERP rate in 802.11g mode.
161 */
162enum ieee80211_rate_flags {
163 IEEE80211_RATE_SHORT_PREAMBLE = 1<<0,
164 IEEE80211_RATE_MANDATORY_A = 1<<1,
165 IEEE80211_RATE_MANDATORY_B = 1<<2,
166 IEEE80211_RATE_MANDATORY_G = 1<<3,
167 IEEE80211_RATE_ERP_G = 1<<4,
168};
169
170/**
171 * struct ieee80211_rate - bitrate definition
172 *
173 * This structure describes a bitrate that an 802.11 PHY can
174 * operate with. The two values @hw_value and @hw_value_short
175 * are only for driver use when pointers to this structure are
176 * passed around.
177 *
178 * @flags: rate-specific flags
179 * @bitrate: bitrate in units of 100 Kbps
180 * @hw_value: driver/hardware value for this rate
181 * @hw_value_short: driver/hardware value for this rate when
182 * short preamble is used
183 */
184struct ieee80211_rate {
185 u32 flags;
186 u16 bitrate;
187 u16 hw_value, hw_value_short;
188};
189
190/**
191 * struct ieee80211_sta_ht_cap - STA's HT capabilities
192 *
193 * This structure describes most essential parameters needed
194 * to describe 802.11n HT capabilities for an STA.
195 *
196 * @ht_supported: is HT supported by the STA
197 * @cap: HT capabilities map as described in 802.11n spec
198 * @ampdu_factor: Maximum A-MPDU length factor
199 * @ampdu_density: Minimum A-MPDU spacing
200 * @mcs: Supported MCS rates
201 */
202struct ieee80211_sta_ht_cap {
203 u16 cap; /* use IEEE80211_HT_CAP_ */
204 bool ht_supported;
205 u8 ampdu_factor;
206 u8 ampdu_density;
207 struct ieee80211_mcs_info mcs;
208};
209
210/**
211 * struct ieee80211_supported_band - frequency band definition
212 *
213 * This structure describes a frequency band a wiphy
214 * is able to operate in.
215 *
216 * @channels: Array of channels the hardware can operate in
217 * in this band.
218 * @band: the band this structure represents
219 * @n_channels: Number of channels in @channels
220 * @bitrates: Array of bitrates the hardware can operate with
221 * in this band. Must be sorted to give a valid "supported
222 * rates" IE, i.e. CCK rates first, then OFDM.
223 * @n_bitrates: Number of bitrates in @bitrates
Johannes Bergabe37c42010-06-07 11:12:27 +0200224 * @ht_cap: HT capabilities in this band
Johannes Bergd3236552009-04-20 14:31:42 +0200225 */
226struct ieee80211_supported_band {
227 struct ieee80211_channel *channels;
228 struct ieee80211_rate *bitrates;
229 enum ieee80211_band band;
230 int n_channels;
231 int n_bitrates;
232 struct ieee80211_sta_ht_cap ht_cap;
233};
234
235/*
236 * Wireless hardware/device configuration structures and methods
Johannes Berg704232c2007-04-23 12:20:05 -0700237 */
238
Luis Carlos Cobo2ec600d2008-02-23 15:17:06 +0100239/**
Johannes Bergd70e9692010-08-19 16:11:27 +0200240 * DOC: Actions and configuration
241 *
242 * Each wireless device and each virtual interface offer a set of configuration
243 * operations and other actions that are invoked by userspace. Each of these
244 * actions is described in the operations structure, and the parameters these
245 * operations use are described separately.
246 *
247 * Additionally, some operations are asynchronous and expect to get status
248 * information via some functions that drivers need to call.
249 *
250 * Scanning and BSS list handling with its associated functionality is described
251 * in a separate chapter.
252 */
253
254/**
Luis Carlos Cobo2ec600d2008-02-23 15:17:06 +0100255 * struct vif_params - describes virtual interface parameters
Felix Fietkau8b787642009-11-10 18:53:10 +0100256 * @use_4addr: use 4-address frames
Luis Carlos Cobo2ec600d2008-02-23 15:17:06 +0100257 */
258struct vif_params {
Felix Fietkau8b787642009-11-10 18:53:10 +0100259 int use_4addr;
Luis Carlos Cobo2ec600d2008-02-23 15:17:06 +0100260};
261
Andy Green179f8312007-07-10 19:29:38 +0200262/**
Johannes Berg41ade002007-12-19 02:03:29 +0100263 * struct key_params - key information
264 *
265 * Information about a key
266 *
267 * @key: key material
268 * @key_len: length of key material
269 * @cipher: cipher suite selector
270 * @seq: sequence counter (IV/PN) for TKIP and CCMP keys, only used
271 * with the get_key() callback, must be in little endian,
272 * length given by @seq_len.
Johannes Bergabe37c42010-06-07 11:12:27 +0200273 * @seq_len: length of @seq.
Johannes Berg41ade002007-12-19 02:03:29 +0100274 */
275struct key_params {
276 u8 *key;
277 u8 *seq;
278 int key_len;
279 int seq_len;
280 u32 cipher;
281};
282
Johannes Berged1b6cc2007-12-19 02:03:32 +0100283/**
Holger Schurig61fa7132009-11-11 12:25:40 +0100284 * enum survey_info_flags - survey information flags
285 *
Johannes Bergabe37c42010-06-07 11:12:27 +0200286 * @SURVEY_INFO_NOISE_DBM: noise (in dBm) was filled in
Felix Fietkau17e5a802010-09-29 17:15:30 +0200287 * @SURVEY_INFO_IN_USE: channel is currently being used
Felix Fietkau8610c29a2010-10-09 02:39:29 +0200288 * @SURVEY_INFO_CHANNEL_TIME: channel active time (in ms) was filled in
289 * @SURVEY_INFO_CHANNEL_TIME_BUSY: channel busy time was filled in
290 * @SURVEY_INFO_CHANNEL_TIME_EXT_BUSY: extension channel busy time was filled in
291 * @SURVEY_INFO_CHANNEL_TIME_RX: channel receive time was filled in
292 * @SURVEY_INFO_CHANNEL_TIME_TX: channel transmit time was filled in
Johannes Bergabe37c42010-06-07 11:12:27 +0200293 *
Holger Schurig61fa7132009-11-11 12:25:40 +0100294 * Used by the driver to indicate which info in &struct survey_info
295 * it has filled in during the get_survey().
296 */
297enum survey_info_flags {
298 SURVEY_INFO_NOISE_DBM = 1<<0,
Felix Fietkau17e5a802010-09-29 17:15:30 +0200299 SURVEY_INFO_IN_USE = 1<<1,
Felix Fietkau8610c29a2010-10-09 02:39:29 +0200300 SURVEY_INFO_CHANNEL_TIME = 1<<2,
301 SURVEY_INFO_CHANNEL_TIME_BUSY = 1<<3,
302 SURVEY_INFO_CHANNEL_TIME_EXT_BUSY = 1<<4,
303 SURVEY_INFO_CHANNEL_TIME_RX = 1<<5,
304 SURVEY_INFO_CHANNEL_TIME_TX = 1<<6,
Holger Schurig61fa7132009-11-11 12:25:40 +0100305};
306
307/**
308 * struct survey_info - channel survey response
309 *
Holger Schurig61fa7132009-11-11 12:25:40 +0100310 * @channel: the channel this survey record reports, mandatory
311 * @filled: bitflag of flags from &enum survey_info_flags
312 * @noise: channel noise in dBm. This and all following fields are
313 * optional
Felix Fietkau8610c29a2010-10-09 02:39:29 +0200314 * @channel_time: amount of time in ms the radio spent on the channel
315 * @channel_time_busy: amount of time the primary channel was sensed busy
316 * @channel_time_ext_busy: amount of time the extension channel was sensed busy
317 * @channel_time_rx: amount of time the radio spent receiving data
318 * @channel_time_tx: amount of time the radio spent transmitting data
Holger Schurig61fa7132009-11-11 12:25:40 +0100319 *
Johannes Bergabe37c42010-06-07 11:12:27 +0200320 * Used by dump_survey() to report back per-channel survey information.
321 *
Holger Schurig61fa7132009-11-11 12:25:40 +0100322 * This structure can later be expanded with things like
323 * channel duty cycle etc.
324 */
325struct survey_info {
326 struct ieee80211_channel *channel;
Felix Fietkau8610c29a2010-10-09 02:39:29 +0200327 u64 channel_time;
328 u64 channel_time_busy;
329 u64 channel_time_ext_busy;
330 u64 channel_time_rx;
331 u64 channel_time_tx;
Holger Schurig61fa7132009-11-11 12:25:40 +0100332 u32 filled;
333 s8 noise;
334};
335
336/**
Jouni Malinen5fb628e2011-08-10 23:54:35 +0300337 * struct cfg80211_crypto_settings - Crypto settings
338 * @wpa_versions: indicates which, if any, WPA versions are enabled
339 * (from enum nl80211_wpa_versions)
340 * @cipher_group: group key cipher suite (or 0 if unset)
341 * @n_ciphers_pairwise: number of AP supported unicast ciphers
342 * @ciphers_pairwise: unicast key cipher suites
343 * @n_akm_suites: number of AKM suites
344 * @akm_suites: AKM suites
345 * @control_port: Whether user space controls IEEE 802.1X port, i.e.,
346 * sets/clears %NL80211_STA_FLAG_AUTHORIZED. If true, the driver is
347 * required to assume that the port is unauthorized until authorized by
348 * user space. Otherwise, port is marked authorized by default.
349 * @control_port_ethertype: the control port protocol that should be
350 * allowed through even on unauthorized ports
351 * @control_port_no_encrypt: TRUE to prevent encryption of control port
352 * protocol frames.
353 */
354struct cfg80211_crypto_settings {
355 u32 wpa_versions;
356 u32 cipher_group;
357 int n_ciphers_pairwise;
358 u32 ciphers_pairwise[NL80211_MAX_NR_CIPHER_SUITES];
359 int n_akm_suites;
360 u32 akm_suites[NL80211_MAX_NR_AKM_SUITES];
361 bool control_port;
362 __be16 control_port_ethertype;
363 bool control_port_no_encrypt;
364};
365
366/**
Johannes Berged1b6cc2007-12-19 02:03:32 +0100367 * struct beacon_parameters - beacon parameters
368 *
369 * Used to configure the beacon for an interface.
370 *
371 * @head: head portion of beacon (before TIM IE)
372 * or %NULL if not changed
373 * @tail: tail portion of beacon (after TIM IE)
374 * or %NULL if not changed
375 * @interval: beacon interval or zero if not changed
376 * @dtim_period: DTIM period or zero if not changed
377 * @head_len: length of @head
378 * @tail_len: length of @tail
Jouni Malinen32e9de82011-08-10 23:53:31 +0300379 * @ssid: SSID to be used in the BSS (note: may be %NULL if not provided from
380 * user space)
381 * @ssid_len: length of @ssid
382 * @hidden_ssid: whether to hide the SSID in Beacon/Probe Response frames
Jouni Malinen5fb628e2011-08-10 23:54:35 +0300383 * @crypto: crypto settings
384 * @privacy: the BSS uses privacy
385 * @auth_type: Authentication type (algorithm)
Jouni Malinen9946ecf2011-08-10 23:55:56 +0300386 * @beacon_ies: extra information element(s) to add into Beacon frames or %NULL
387 * @beacon_ies_len: length of beacon_ies in octets
388 * @proberesp_ies: extra information element(s) to add into Probe Response
389 * frames or %NULL
390 * @proberesp_ies_len: length of proberesp_ies in octets
391 * @assocresp_ies: extra information element(s) to add into (Re)Association
392 * Response frames or %NULL
393 * @assocresp_ies_len: length of assocresp_ies in octets
Johannes Berged1b6cc2007-12-19 02:03:32 +0100394 */
395struct beacon_parameters {
396 u8 *head, *tail;
397 int interval, dtim_period;
398 int head_len, tail_len;
Jouni Malinen32e9de82011-08-10 23:53:31 +0300399 const u8 *ssid;
400 size_t ssid_len;
401 enum nl80211_hidden_ssid hidden_ssid;
Jouni Malinen5fb628e2011-08-10 23:54:35 +0300402 struct cfg80211_crypto_settings crypto;
403 bool privacy;
404 enum nl80211_auth_type auth_type;
Jouni Malinen9946ecf2011-08-10 23:55:56 +0300405 const u8 *beacon_ies;
406 size_t beacon_ies_len;
407 const u8 *proberesp_ies;
408 size_t proberesp_ies_len;
409 const u8 *assocresp_ies;
410 size_t assocresp_ies_len;
Johannes Berged1b6cc2007-12-19 02:03:32 +0100411};
412
Johannes Berg5727ef12007-12-19 02:03:34 +0100413/**
Luis Carlos Cobo2ec600d2008-02-23 15:17:06 +0100414 * enum plink_action - actions to perform in mesh peers
415 *
416 * @PLINK_ACTION_INVALID: action 0 is reserved
417 * @PLINK_ACTION_OPEN: start mesh peer link establishment
Johannes Bergabe37c42010-06-07 11:12:27 +0200418 * @PLINK_ACTION_BLOCK: block traffic from this mesh peer
Luis Carlos Cobo2ec600d2008-02-23 15:17:06 +0100419 */
420enum plink_actions {
421 PLINK_ACTION_INVALID,
422 PLINK_ACTION_OPEN,
423 PLINK_ACTION_BLOCK,
424};
425
426/**
Johannes Berg5727ef12007-12-19 02:03:34 +0100427 * struct station_parameters - station parameters
428 *
429 * Used to change and create a new station.
430 *
431 * @vlan: vlan interface station should belong to
432 * @supported_rates: supported rates in IEEE 802.11 format
433 * (or NULL for no change)
434 * @supported_rates_len: number of supported rates
Johannes Bergeccb8e82009-05-11 21:57:56 +0300435 * @sta_flags_mask: station flags that changed
436 * (bitmask of BIT(NL80211_STA_FLAG_...))
437 * @sta_flags_set: station flags values
438 * (bitmask of BIT(NL80211_STA_FLAG_...))
Johannes Berg5727ef12007-12-19 02:03:34 +0100439 * @listen_interval: listen interval or -1 for no change
440 * @aid: AID or zero for no change
Johannes Bergabe37c42010-06-07 11:12:27 +0200441 * @plink_action: plink action to take
Javier Cardona9c3990a2011-05-03 16:57:11 -0700442 * @plink_state: set the peer link state for a station
Johannes Bergabe37c42010-06-07 11:12:27 +0200443 * @ht_capa: HT capabilities of station
Johannes Berg5727ef12007-12-19 02:03:34 +0100444 */
445struct station_parameters {
446 u8 *supported_rates;
447 struct net_device *vlan;
Johannes Bergeccb8e82009-05-11 21:57:56 +0300448 u32 sta_flags_mask, sta_flags_set;
Johannes Berg5727ef12007-12-19 02:03:34 +0100449 int listen_interval;
450 u16 aid;
451 u8 supported_rates_len;
Luis Carlos Cobo2ec600d2008-02-23 15:17:06 +0100452 u8 plink_action;
Javier Cardona9c3990a2011-05-03 16:57:11 -0700453 u8 plink_state;
Jouni Malinen36aedc92008-08-25 11:58:58 +0300454 struct ieee80211_ht_cap *ht_capa;
Johannes Berg5727ef12007-12-19 02:03:34 +0100455};
456
Johannes Bergfd5b74d2007-12-19 02:03:36 +0100457/**
Luis Carlos Cobo2ec600d2008-02-23 15:17:06 +0100458 * enum station_info_flags - station information flags
Johannes Bergfd5b74d2007-12-19 02:03:36 +0100459 *
Luis Carlos Cobo2ec600d2008-02-23 15:17:06 +0100460 * Used by the driver to indicate which info in &struct station_info
461 * it has filled in during get_station() or dump_station().
Johannes Bergfd5b74d2007-12-19 02:03:36 +0100462 *
Luis Carlos Cobo2ec600d2008-02-23 15:17:06 +0100463 * @STATION_INFO_INACTIVE_TIME: @inactive_time filled
464 * @STATION_INFO_RX_BYTES: @rx_bytes filled
465 * @STATION_INFO_TX_BYTES: @tx_bytes filled
466 * @STATION_INFO_LLID: @llid filled
467 * @STATION_INFO_PLID: @plid filled
468 * @STATION_INFO_PLINK_STATE: @plink_state filled
Henning Rogge420e7fa2008-12-11 22:04:19 +0100469 * @STATION_INFO_SIGNAL: @signal filled
Felix Fietkauc8dcfd82011-02-27 22:08:00 +0100470 * @STATION_INFO_TX_BITRATE: @txrate fields are filled
Henning Rogge420e7fa2008-12-11 22:04:19 +0100471 * (tx_bitrate, tx_bitrate_flags and tx_bitrate_mcs)
Jouni Malinen98c8a60a2009-02-17 13:24:57 +0200472 * @STATION_INFO_RX_PACKETS: @rx_packets filled
473 * @STATION_INFO_TX_PACKETS: @tx_packets filled
Bruno Randolfb206b4e2010-10-06 18:34:12 +0900474 * @STATION_INFO_TX_RETRIES: @tx_retries filled
475 * @STATION_INFO_TX_FAILED: @tx_failed filled
Ben Greear5a5c7312010-10-07 16:39:20 -0700476 * @STATION_INFO_RX_DROP_MISC: @rx_dropped_misc filled
Bruno Randolf541a45a2010-12-02 19:12:43 +0900477 * @STATION_INFO_SIGNAL_AVG: @signal_avg filled
Felix Fietkauc8dcfd82011-02-27 22:08:00 +0100478 * @STATION_INFO_RX_BITRATE: @rxrate fields are filled
Paul Stewartf4263c92011-03-31 09:25:41 -0700479 * @STATION_INFO_BSS_PARAM: @bss_param filled
Mohammed Shafi Shajakhanebe27c92011-04-08 21:24:24 +0530480 * @STATION_INFO_CONNECTED_TIME: @connected_time filled
Felix Fietkau040bdf72011-08-10 19:00:33 -0600481 * @STATION_INFO_ASSOC_REQ_IES: @assoc_req_ies filled
Johannes Bergfd5b74d2007-12-19 02:03:36 +0100482 */
Luis Carlos Cobo2ec600d2008-02-23 15:17:06 +0100483enum station_info_flags {
484 STATION_INFO_INACTIVE_TIME = 1<<0,
485 STATION_INFO_RX_BYTES = 1<<1,
486 STATION_INFO_TX_BYTES = 1<<2,
487 STATION_INFO_LLID = 1<<3,
488 STATION_INFO_PLID = 1<<4,
489 STATION_INFO_PLINK_STATE = 1<<5,
Henning Rogge420e7fa2008-12-11 22:04:19 +0100490 STATION_INFO_SIGNAL = 1<<6,
491 STATION_INFO_TX_BITRATE = 1<<7,
Jouni Malinen98c8a60a2009-02-17 13:24:57 +0200492 STATION_INFO_RX_PACKETS = 1<<8,
493 STATION_INFO_TX_PACKETS = 1<<9,
Bruno Randolfb206b4e2010-10-06 18:34:12 +0900494 STATION_INFO_TX_RETRIES = 1<<10,
495 STATION_INFO_TX_FAILED = 1<<11,
Ben Greear5a5c7312010-10-07 16:39:20 -0700496 STATION_INFO_RX_DROP_MISC = 1<<12,
Bruno Randolf541a45a2010-12-02 19:12:43 +0900497 STATION_INFO_SIGNAL_AVG = 1<<13,
Felix Fietkauc8dcfd82011-02-27 22:08:00 +0100498 STATION_INFO_RX_BITRATE = 1<<14,
Paul Stewartf4263c92011-03-31 09:25:41 -0700499 STATION_INFO_BSS_PARAM = 1<<15,
Felix Fietkau040bdf72011-08-10 19:00:33 -0600500 STATION_INFO_CONNECTED_TIME = 1<<16,
501 STATION_INFO_ASSOC_REQ_IES = 1<<17
Henning Rogge420e7fa2008-12-11 22:04:19 +0100502};
503
504/**
505 * enum station_info_rate_flags - bitrate info flags
506 *
507 * Used by the driver to indicate the specific rate transmission
508 * type for 802.11n transmissions.
509 *
510 * @RATE_INFO_FLAGS_MCS: @tx_bitrate_mcs filled
511 * @RATE_INFO_FLAGS_40_MHZ_WIDTH: 40 Mhz width transmission
512 * @RATE_INFO_FLAGS_SHORT_GI: 400ns guard interval
513 */
514enum rate_info_flags {
515 RATE_INFO_FLAGS_MCS = 1<<0,
516 RATE_INFO_FLAGS_40_MHZ_WIDTH = 1<<1,
517 RATE_INFO_FLAGS_SHORT_GI = 1<<2,
518};
519
520/**
521 * struct rate_info - bitrate information
522 *
523 * Information about a receiving or transmitting bitrate
524 *
525 * @flags: bitflag of flags from &enum rate_info_flags
526 * @mcs: mcs index if struct describes a 802.11n bitrate
527 * @legacy: bitrate in 100kbit/s for 802.11abg
528 */
529struct rate_info {
530 u8 flags;
531 u8 mcs;
532 u16 legacy;
Johannes Bergfd5b74d2007-12-19 02:03:36 +0100533};
534
535/**
Paul Stewartf4263c92011-03-31 09:25:41 -0700536 * enum station_info_rate_flags - bitrate info flags
537 *
538 * Used by the driver to indicate the specific rate transmission
539 * type for 802.11n transmissions.
540 *
541 * @BSS_PARAM_FLAGS_CTS_PROT: whether CTS protection is enabled
542 * @BSS_PARAM_FLAGS_SHORT_PREAMBLE: whether short preamble is enabled
543 * @BSS_PARAM_FLAGS_SHORT_SLOT_TIME: whether short slot time is enabled
544 */
545enum bss_param_flags {
546 BSS_PARAM_FLAGS_CTS_PROT = 1<<0,
547 BSS_PARAM_FLAGS_SHORT_PREAMBLE = 1<<1,
548 BSS_PARAM_FLAGS_SHORT_SLOT_TIME = 1<<2,
549};
550
551/**
552 * struct sta_bss_parameters - BSS parameters for the attached station
553 *
554 * Information about the currently associated BSS
555 *
556 * @flags: bitflag of flags from &enum bss_param_flags
557 * @dtim_period: DTIM period for the BSS
558 * @beacon_interval: beacon interval
559 */
560struct sta_bss_parameters {
561 u8 flags;
562 u8 dtim_period;
563 u16 beacon_interval;
564};
565
566/**
Luis Carlos Cobo2ec600d2008-02-23 15:17:06 +0100567 * struct station_info - station information
Johannes Bergfd5b74d2007-12-19 02:03:36 +0100568 *
Luis Carlos Cobo2ec600d2008-02-23 15:17:06 +0100569 * Station information filled by driver for get_station() and dump_station.
Johannes Bergfd5b74d2007-12-19 02:03:36 +0100570 *
Luis Carlos Cobo2ec600d2008-02-23 15:17:06 +0100571 * @filled: bitflag of flags from &enum station_info_flags
Mohammed Shafi Shajakhanebe27c92011-04-08 21:24:24 +0530572 * @connected_time: time(in secs) since a station is last connected
Johannes Bergfd5b74d2007-12-19 02:03:36 +0100573 * @inactive_time: time since last station activity (tx/rx) in milliseconds
574 * @rx_bytes: bytes received from this station
575 * @tx_bytes: bytes transmitted to this station
Luis Carlos Cobo2ec600d2008-02-23 15:17:06 +0100576 * @llid: mesh local link id
577 * @plid: mesh peer link id
578 * @plink_state: mesh peer link state
Henning Rogge420e7fa2008-12-11 22:04:19 +0100579 * @signal: signal strength of last received packet in dBm
Bruno Randolf541a45a2010-12-02 19:12:43 +0900580 * @signal_avg: signal strength average in dBm
Randy Dunlap858022a2011-03-18 09:33:02 -0700581 * @txrate: current unicast bitrate from this station
582 * @rxrate: current unicast bitrate to this station
Jouni Malinen98c8a60a2009-02-17 13:24:57 +0200583 * @rx_packets: packets received from this station
584 * @tx_packets: packets transmitted to this station
Bruno Randolfb206b4e2010-10-06 18:34:12 +0900585 * @tx_retries: cumulative retry counts
586 * @tx_failed: number of failed transmissions (retries exceeded, no ACK)
Ben Greear5a5c7312010-10-07 16:39:20 -0700587 * @rx_dropped_misc: Dropped for un-specified reason.
Randy Dunlap1ba01452011-05-22 17:16:20 -0700588 * @bss_param: current BSS parameters
Johannes Bergf5ea9122009-08-07 16:17:38 +0200589 * @generation: generation number for nl80211 dumps.
590 * This number should increase every time the list of stations
591 * changes, i.e. when a station is added or removed, so that
592 * userspace can tell whether it got a consistent snapshot.
Jouni Malinen50d3dfb2011-08-08 12:11:52 +0300593 * @assoc_req_ies: IEs from (Re)Association Request.
594 * This is used only when in AP mode with drivers that do not use
595 * user space MLME/SME implementation. The information is provided for
596 * the cfg80211_new_sta() calls to notify user space of the IEs.
597 * @assoc_req_ies_len: Length of assoc_req_ies buffer in octets.
Johannes Bergfd5b74d2007-12-19 02:03:36 +0100598 */
Luis Carlos Cobo2ec600d2008-02-23 15:17:06 +0100599struct station_info {
Johannes Bergfd5b74d2007-12-19 02:03:36 +0100600 u32 filled;
Mohammed Shafi Shajakhanebe27c92011-04-08 21:24:24 +0530601 u32 connected_time;
Johannes Bergfd5b74d2007-12-19 02:03:36 +0100602 u32 inactive_time;
603 u32 rx_bytes;
604 u32 tx_bytes;
Luis Carlos Cobo2ec600d2008-02-23 15:17:06 +0100605 u16 llid;
606 u16 plid;
607 u8 plink_state;
Henning Rogge420e7fa2008-12-11 22:04:19 +0100608 s8 signal;
Bruno Randolf541a45a2010-12-02 19:12:43 +0900609 s8 signal_avg;
Henning Rogge420e7fa2008-12-11 22:04:19 +0100610 struct rate_info txrate;
Felix Fietkauc8dcfd82011-02-27 22:08:00 +0100611 struct rate_info rxrate;
Jouni Malinen98c8a60a2009-02-17 13:24:57 +0200612 u32 rx_packets;
613 u32 tx_packets;
Bruno Randolfb206b4e2010-10-06 18:34:12 +0900614 u32 tx_retries;
615 u32 tx_failed;
Ben Greear5a5c7312010-10-07 16:39:20 -0700616 u32 rx_dropped_misc;
Paul Stewartf4263c92011-03-31 09:25:41 -0700617 struct sta_bss_parameters bss_param;
Johannes Bergf5ea9122009-08-07 16:17:38 +0200618
619 int generation;
Jouni Malinen50d3dfb2011-08-08 12:11:52 +0300620
621 const u8 *assoc_req_ies;
622 size_t assoc_req_ies_len;
Jouni Malinenf612ced2011-08-11 11:46:22 +0300623
624 /*
625 * Note: Add a new enum station_info_flags value for each new field and
626 * use it to check which fields are initialized.
627 */
Johannes Bergfd5b74d2007-12-19 02:03:36 +0100628};
629
Michael Wu66f7ac52008-01-31 19:48:22 +0100630/**
631 * enum monitor_flags - monitor flags
632 *
633 * Monitor interface configuration flags. Note that these must be the bits
634 * according to the nl80211 flags.
635 *
636 * @MONITOR_FLAG_FCSFAIL: pass frames with bad FCS
637 * @MONITOR_FLAG_PLCPFAIL: pass frames with bad PLCP
638 * @MONITOR_FLAG_CONTROL: pass control frames
639 * @MONITOR_FLAG_OTHER_BSS: disable BSSID filtering
640 * @MONITOR_FLAG_COOK_FRAMES: report frames after processing
641 */
642enum monitor_flags {
643 MONITOR_FLAG_FCSFAIL = 1<<NL80211_MNTR_FLAG_FCSFAIL,
644 MONITOR_FLAG_PLCPFAIL = 1<<NL80211_MNTR_FLAG_PLCPFAIL,
645 MONITOR_FLAG_CONTROL = 1<<NL80211_MNTR_FLAG_CONTROL,
646 MONITOR_FLAG_OTHER_BSS = 1<<NL80211_MNTR_FLAG_OTHER_BSS,
647 MONITOR_FLAG_COOK_FRAMES = 1<<NL80211_MNTR_FLAG_COOK_FRAMES,
648};
649
Luis Carlos Cobo2ec600d2008-02-23 15:17:06 +0100650/**
651 * enum mpath_info_flags - mesh path information flags
652 *
653 * Used by the driver to indicate which info in &struct mpath_info it has filled
654 * in during get_station() or dump_station().
655 *
Johannes Bergabe37c42010-06-07 11:12:27 +0200656 * @MPATH_INFO_FRAME_QLEN: @frame_qlen filled
657 * @MPATH_INFO_SN: @sn filled
658 * @MPATH_INFO_METRIC: @metric filled
659 * @MPATH_INFO_EXPTIME: @exptime filled
660 * @MPATH_INFO_DISCOVERY_TIMEOUT: @discovery_timeout filled
661 * @MPATH_INFO_DISCOVERY_RETRIES: @discovery_retries filled
662 * @MPATH_INFO_FLAGS: @flags filled
Luis Carlos Cobo2ec600d2008-02-23 15:17:06 +0100663 */
664enum mpath_info_flags {
665 MPATH_INFO_FRAME_QLEN = BIT(0),
Rui Paulod19b3bf2009-11-09 23:46:55 +0000666 MPATH_INFO_SN = BIT(1),
Luis Carlos Cobo2ec600d2008-02-23 15:17:06 +0100667 MPATH_INFO_METRIC = BIT(2),
668 MPATH_INFO_EXPTIME = BIT(3),
669 MPATH_INFO_DISCOVERY_TIMEOUT = BIT(4),
670 MPATH_INFO_DISCOVERY_RETRIES = BIT(5),
671 MPATH_INFO_FLAGS = BIT(6),
672};
673
674/**
675 * struct mpath_info - mesh path information
676 *
677 * Mesh path information filled by driver for get_mpath() and dump_mpath().
678 *
679 * @filled: bitfield of flags from &enum mpath_info_flags
680 * @frame_qlen: number of queued frames for this destination
Rui Paulod19b3bf2009-11-09 23:46:55 +0000681 * @sn: target sequence number
Luis Carlos Cobo2ec600d2008-02-23 15:17:06 +0100682 * @metric: metric (cost) of this mesh path
683 * @exptime: expiration time for the mesh path from now, in msecs
684 * @flags: mesh path flags
685 * @discovery_timeout: total mesh path discovery timeout, in msecs
686 * @discovery_retries: mesh path discovery retries
Johannes Bergf5ea9122009-08-07 16:17:38 +0200687 * @generation: generation number for nl80211 dumps.
688 * This number should increase every time the list of mesh paths
689 * changes, i.e. when a station is added or removed, so that
690 * userspace can tell whether it got a consistent snapshot.
Luis Carlos Cobo2ec600d2008-02-23 15:17:06 +0100691 */
692struct mpath_info {
693 u32 filled;
694 u32 frame_qlen;
Rui Paulod19b3bf2009-11-09 23:46:55 +0000695 u32 sn;
Luis Carlos Cobo2ec600d2008-02-23 15:17:06 +0100696 u32 metric;
697 u32 exptime;
698 u32 discovery_timeout;
699 u8 discovery_retries;
700 u8 flags;
Johannes Bergf5ea9122009-08-07 16:17:38 +0200701
702 int generation;
Luis Carlos Cobo2ec600d2008-02-23 15:17:06 +0100703};
704
Jouni Malinen9f1ba902008-08-07 20:07:01 +0300705/**
706 * struct bss_parameters - BSS parameters
707 *
708 * Used to change BSS parameters (mainly for AP mode).
709 *
710 * @use_cts_prot: Whether to use CTS protection
711 * (0 = no, 1 = yes, -1 = do not change)
712 * @use_short_preamble: Whether the use of short preambles is allowed
713 * (0 = no, 1 = yes, -1 = do not change)
714 * @use_short_slot_time: Whether the use of short slot time is allowed
715 * (0 = no, 1 = yes, -1 = do not change)
Jouni Malinen90c97a02008-10-30 16:59:22 +0200716 * @basic_rates: basic rates in IEEE 802.11 format
717 * (or NULL for no change)
718 * @basic_rates_len: number of basic rates
Felix Fietkaufd8aaaf2010-04-27 01:23:35 +0200719 * @ap_isolate: do not forward packets between connected stations
Helmut Schaa50b12f52010-11-19 12:40:25 +0100720 * @ht_opmode: HT Operation mode
721 * (u16 = opmode, -1 = do not change)
Jouni Malinen9f1ba902008-08-07 20:07:01 +0300722 */
723struct bss_parameters {
724 int use_cts_prot;
725 int use_short_preamble;
726 int use_short_slot_time;
Jouni Malinen90c97a02008-10-30 16:59:22 +0200727 u8 *basic_rates;
728 u8 basic_rates_len;
Felix Fietkaufd8aaaf2010-04-27 01:23:35 +0200729 int ap_isolate;
Helmut Schaa50b12f52010-11-19 12:40:25 +0100730 int ht_opmode;
Jouni Malinen9f1ba902008-08-07 20:07:01 +0300731};
Luis Carlos Cobo2ec600d2008-02-23 15:17:06 +0100732
Johannes Berg29cbe682010-12-03 09:20:44 +0100733/*
734 * struct mesh_config - 802.11s mesh configuration
735 *
736 * These parameters can be changed while the mesh is active.
737 */
colin@cozybit.com93da9cc2008-10-21 12:03:48 -0700738struct mesh_config {
739 /* Timeouts in ms */
740 /* Mesh plink management parameters */
741 u16 dot11MeshRetryTimeout;
742 u16 dot11MeshConfirmTimeout;
743 u16 dot11MeshHoldingTimeout;
744 u16 dot11MeshMaxPeerLinks;
745 u8 dot11MeshMaxRetries;
746 u8 dot11MeshTTL;
Javier Cardona45904f22010-12-03 09:20:40 +0100747 /* ttl used in path selection information elements */
748 u8 element_ttl;
colin@cozybit.com93da9cc2008-10-21 12:03:48 -0700749 bool auto_open_plinks;
750 /* HWMP parameters */
751 u8 dot11MeshHWMPmaxPREQretries;
752 u32 path_refresh_time;
753 u16 min_discovery_timeout;
754 u32 dot11MeshHWMPactivePathTimeout;
755 u16 dot11MeshHWMPpreqMinInterval;
756 u16 dot11MeshHWMPnetDiameterTraversalTime;
Rui Paulo63c57232009-11-09 23:46:57 +0000757 u8 dot11MeshHWMPRootMode;
colin@cozybit.com93da9cc2008-10-21 12:03:48 -0700758};
759
Jouni Malinen31888482008-10-30 16:59:24 +0200760/**
Johannes Berg29cbe682010-12-03 09:20:44 +0100761 * struct mesh_setup - 802.11s mesh setup configuration
762 * @mesh_id: the mesh ID
763 * @mesh_id_len: length of the mesh ID, at least 1 and at most 32 bytes
Javier Cardonac80d5452010-12-16 17:37:49 -0800764 * @path_sel_proto: which path selection protocol to use
765 * @path_metric: which metric to use
Javier Cardona581a8b02011-04-07 15:08:27 -0700766 * @ie: vendor information elements (optional)
767 * @ie_len: length of vendor information elements
Javier Cardonab130e5c2011-05-03 16:57:07 -0700768 * @is_authenticated: this mesh requires authentication
769 * @is_secure: this mesh uses security
Johannes Berg29cbe682010-12-03 09:20:44 +0100770 *
771 * These parameters are fixed when the mesh is created.
772 */
773struct mesh_setup {
774 const u8 *mesh_id;
775 u8 mesh_id_len;
Javier Cardonac80d5452010-12-16 17:37:49 -0800776 u8 path_sel_proto;
777 u8 path_metric;
Javier Cardona581a8b02011-04-07 15:08:27 -0700778 const u8 *ie;
779 u8 ie_len;
Javier Cardonab130e5c2011-05-03 16:57:07 -0700780 bool is_authenticated;
Javier Cardona15d5dda2011-04-07 15:08:28 -0700781 bool is_secure;
Johannes Berg29cbe682010-12-03 09:20:44 +0100782};
783
784/**
Jouni Malinen31888482008-10-30 16:59:24 +0200785 * struct ieee80211_txq_params - TX queue parameters
786 * @queue: TX queue identifier (NL80211_TXQ_Q_*)
787 * @txop: Maximum burst time in units of 32 usecs, 0 meaning disabled
788 * @cwmin: Minimum contention window [a value of the form 2^n-1 in the range
789 * 1..32767]
790 * @cwmax: Maximum contention window [a value of the form 2^n-1 in the range
791 * 1..32767]
792 * @aifs: Arbitration interframe space [0..255]
793 */
794struct ieee80211_txq_params {
795 enum nl80211_txq_q queue;
796 u16 txop;
797 u16 cwmin;
798 u16 cwmax;
799 u8 aifs;
800};
801
Johannes Berg704232c2007-04-23 12:20:05 -0700802/* from net/wireless.h */
803struct wiphy;
804
Johannes Bergd70e9692010-08-19 16:11:27 +0200805/**
806 * DOC: Scanning and BSS list handling
807 *
808 * The scanning process itself is fairly simple, but cfg80211 offers quite
809 * a bit of helper functionality. To start a scan, the scan operation will
810 * be invoked with a scan definition. This scan definition contains the
811 * channels to scan, and the SSIDs to send probe requests for (including the
812 * wildcard, if desired). A passive scan is indicated by having no SSIDs to
813 * probe. Additionally, a scan request may contain extra information elements
814 * that should be added to the probe request. The IEs are guaranteed to be
815 * well-formed, and will not exceed the maximum length the driver advertised
816 * in the wiphy structure.
817 *
818 * When scanning finds a BSS, cfg80211 needs to be notified of that, because
819 * it is responsible for maintaining the BSS list; the driver should not
820 * maintain a list itself. For this notification, various functions exist.
821 *
822 * Since drivers do not maintain a BSS list, there are also a number of
823 * functions to search for a BSS and obtain information about it from the
824 * BSS structure cfg80211 maintains. The BSS list is also made available
825 * to userspace.
826 */
Jouni Malinen72bdcf32008-11-26 16:15:24 +0200827
Johannes Berg704232c2007-04-23 12:20:05 -0700828/**
Johannes Berg2a519312009-02-10 21:25:55 +0100829 * struct cfg80211_ssid - SSID description
830 * @ssid: the SSID
831 * @ssid_len: length of the ssid
832 */
833struct cfg80211_ssid {
834 u8 ssid[IEEE80211_MAX_SSID_LEN];
835 u8 ssid_len;
836};
837
838/**
839 * struct cfg80211_scan_request - scan request description
840 *
841 * @ssids: SSIDs to scan for (active scan only)
842 * @n_ssids: number of SSIDs
843 * @channels: channels to scan on.
Helmut Schaaca3dbc22009-07-10 14:54:58 +0200844 * @n_channels: total number of channels to scan
Jouni Malinen70692ad2009-02-16 19:39:13 +0200845 * @ie: optional information element(s) to add into Probe Request or %NULL
846 * @ie_len: length of ie in octets
Johannes Berg34850ab2011-07-18 18:08:35 +0200847 * @rates: bitmap of rates to advertise for each band
Johannes Berg2a519312009-02-10 21:25:55 +0100848 * @wiphy: the wiphy this was for
Johannes Berg463d0182009-07-14 00:33:35 +0200849 * @dev: the interface
Johannes Bergabe37c42010-06-07 11:12:27 +0200850 * @aborted: (internal) scan request was notified as aborted
Johannes Berg2a519312009-02-10 21:25:55 +0100851 */
852struct cfg80211_scan_request {
853 struct cfg80211_ssid *ssids;
854 int n_ssids;
Johannes Berg2a519312009-02-10 21:25:55 +0100855 u32 n_channels;
Johannes Bergde95a542009-04-01 11:58:36 +0200856 const u8 *ie;
Jouni Malinen70692ad2009-02-16 19:39:13 +0200857 size_t ie_len;
Johannes Berg2a519312009-02-10 21:25:55 +0100858
Johannes Berg34850ab2011-07-18 18:08:35 +0200859 u32 rates[IEEE80211_NUM_BANDS];
860
Johannes Berg2a519312009-02-10 21:25:55 +0100861 /* internal */
862 struct wiphy *wiphy;
Johannes Berg463d0182009-07-14 00:33:35 +0200863 struct net_device *dev;
Johannes Berg667503d2009-07-07 03:56:11 +0200864 bool aborted;
Johannes Berg5ba63532009-08-07 17:54:07 +0200865
866 /* keep last */
867 struct ieee80211_channel *channels[0];
Johannes Berg2a519312009-02-10 21:25:55 +0100868};
869
870/**
Luciano Coelho807f8a82011-05-11 17:09:35 +0300871 * struct cfg80211_sched_scan_request - scheduled scan request description
872 *
873 * @ssids: SSIDs to scan for (passed in the probe_reqs in active scans)
874 * @n_ssids: number of SSIDs
875 * @n_channels: total number of channels to scan
Luciano Coelhobbe6ad62011-05-11 17:09:37 +0300876 * @interval: interval between each scheduled scan cycle
Luciano Coelho807f8a82011-05-11 17:09:35 +0300877 * @ie: optional information element(s) to add into Probe Request or %NULL
878 * @ie_len: length of ie in octets
879 * @wiphy: the wiphy this was for
880 * @dev: the interface
881 * @channels: channels to scan
882 */
883struct cfg80211_sched_scan_request {
884 struct cfg80211_ssid *ssids;
885 int n_ssids;
886 u32 n_channels;
Luciano Coelhobbe6ad62011-05-11 17:09:37 +0300887 u32 interval;
Luciano Coelho807f8a82011-05-11 17:09:35 +0300888 const u8 *ie;
889 size_t ie_len;
890
891 /* internal */
892 struct wiphy *wiphy;
893 struct net_device *dev;
894
895 /* keep last */
896 struct ieee80211_channel *channels[0];
897};
898
899/**
Johannes Berg2a519312009-02-10 21:25:55 +0100900 * enum cfg80211_signal_type - signal type
901 *
902 * @CFG80211_SIGNAL_TYPE_NONE: no signal strength information available
903 * @CFG80211_SIGNAL_TYPE_MBM: signal strength in mBm (100*dBm)
904 * @CFG80211_SIGNAL_TYPE_UNSPEC: signal strength, increasing from 0 through 100
905 */
906enum cfg80211_signal_type {
907 CFG80211_SIGNAL_TYPE_NONE,
908 CFG80211_SIGNAL_TYPE_MBM,
909 CFG80211_SIGNAL_TYPE_UNSPEC,
910};
911
912/**
913 * struct cfg80211_bss - BSS description
914 *
915 * This structure describes a BSS (which may also be a mesh network)
916 * for use in scan results and similar.
917 *
Johannes Bergabe37c42010-06-07 11:12:27 +0200918 * @channel: channel this BSS is on
Johannes Berg2a519312009-02-10 21:25:55 +0100919 * @bssid: BSSID of the BSS
920 * @tsf: timestamp of last received update
921 * @beacon_interval: the beacon interval as from the frame
922 * @capability: the capability field in host byte order
923 * @information_elements: the information elements (Note that there
Jouni Malinen34a6edd2010-01-06 16:19:24 +0200924 * is no guarantee that these are well-formed!); this is a pointer to
925 * either the beacon_ies or proberesp_ies depending on whether Probe
926 * Response frame has been received
Johannes Berg2a519312009-02-10 21:25:55 +0100927 * @len_information_elements: total length of the information elements
Jouni Malinen34a6edd2010-01-06 16:19:24 +0200928 * @beacon_ies: the information elements from the last Beacon frame
929 * @len_beacon_ies: total length of the beacon_ies
930 * @proberesp_ies: the information elements from the last Probe Response frame
931 * @len_proberesp_ies: total length of the proberesp_ies
Johannes Berg77965c92009-02-18 18:45:06 +0100932 * @signal: signal strength value (type depends on the wiphy's signal_type)
Johannes Berg78c1c7e2009-02-10 21:25:57 +0100933 * @free_priv: function pointer to free private data
Johannes Berg2a519312009-02-10 21:25:55 +0100934 * @priv: private area for driver use, has at least wiphy->bss_priv_size bytes
935 */
936struct cfg80211_bss {
937 struct ieee80211_channel *channel;
938
939 u8 bssid[ETH_ALEN];
940 u64 tsf;
941 u16 beacon_interval;
942 u16 capability;
943 u8 *information_elements;
944 size_t len_information_elements;
Jouni Malinen34a6edd2010-01-06 16:19:24 +0200945 u8 *beacon_ies;
946 size_t len_beacon_ies;
947 u8 *proberesp_ies;
948 size_t len_proberesp_ies;
Johannes Berg2a519312009-02-10 21:25:55 +0100949
950 s32 signal;
Johannes Berg2a519312009-02-10 21:25:55 +0100951
Johannes Berg78c1c7e2009-02-10 21:25:57 +0100952 void (*free_priv)(struct cfg80211_bss *bss);
Johannes Berg2a519312009-02-10 21:25:55 +0100953 u8 priv[0] __attribute__((__aligned__(sizeof(void *))));
954};
955
956/**
Johannes Berg517357c2009-07-02 17:18:40 +0200957 * ieee80211_bss_get_ie - find IE with given ID
958 * @bss: the bss to search
959 * @ie: the IE ID
960 * Returns %NULL if not found.
961 */
962const u8 *ieee80211_bss_get_ie(struct cfg80211_bss *bss, u8 ie);
963
964
965/**
Jouni Malinen636a5d32009-03-19 13:39:22 +0200966 * struct cfg80211_auth_request - Authentication request data
967 *
968 * This structure provides information needed to complete IEEE 802.11
969 * authentication.
Jouni Malinen636a5d32009-03-19 13:39:22 +0200970 *
Johannes Berg19957bb2009-07-02 17:20:43 +0200971 * @bss: The BSS to authenticate with.
Jouni Malinen636a5d32009-03-19 13:39:22 +0200972 * @auth_type: Authentication type (algorithm)
973 * @ie: Extra IEs to add to Authentication frame or %NULL
974 * @ie_len: Length of ie buffer in octets
Johannes Bergfffd0932009-07-08 14:22:54 +0200975 * @key_len: length of WEP key for shared key authentication
976 * @key_idx: index of WEP key for shared key authentication
977 * @key: WEP key for shared key authentication
Jouni Malinend5cdfac2010-04-04 09:37:19 +0300978 * @local_state_change: This is a request for a local state only, i.e., no
979 * Authentication frame is to be transmitted and authentication state is
980 * to be changed without having to wait for a response from the peer STA
981 * (AP).
Jouni Malinen636a5d32009-03-19 13:39:22 +0200982 */
983struct cfg80211_auth_request {
Johannes Berg19957bb2009-07-02 17:20:43 +0200984 struct cfg80211_bss *bss;
Jouni Malinen636a5d32009-03-19 13:39:22 +0200985 const u8 *ie;
986 size_t ie_len;
Johannes Berg19957bb2009-07-02 17:20:43 +0200987 enum nl80211_auth_type auth_type;
Johannes Bergfffd0932009-07-08 14:22:54 +0200988 const u8 *key;
989 u8 key_len, key_idx;
Jouni Malinend5cdfac2010-04-04 09:37:19 +0300990 bool local_state_change;
Jouni Malinen636a5d32009-03-19 13:39:22 +0200991};
992
993/**
994 * struct cfg80211_assoc_request - (Re)Association request data
995 *
996 * This structure provides information needed to complete IEEE 802.11
997 * (re)association.
Johannes Berg19957bb2009-07-02 17:20:43 +0200998 * @bss: The BSS to associate with.
Jouni Malinen636a5d32009-03-19 13:39:22 +0200999 * @ie: Extra IEs to add to (Re)Association Request frame or %NULL
1000 * @ie_len: Length of ie buffer in octets
Jouni Malinendc6382c2009-05-06 22:09:37 +03001001 * @use_mfp: Use management frame protection (IEEE 802.11w) in this association
Samuel Ortizb23aa672009-07-01 21:26:54 +02001002 * @crypto: crypto settings
Johannes Berg3e5d7642009-07-07 14:37:26 +02001003 * @prev_bssid: previous BSSID, if not %NULL use reassociate frame
Jouni Malinen636a5d32009-03-19 13:39:22 +02001004 */
1005struct cfg80211_assoc_request {
Johannes Berg19957bb2009-07-02 17:20:43 +02001006 struct cfg80211_bss *bss;
Johannes Berg3e5d7642009-07-07 14:37:26 +02001007 const u8 *ie, *prev_bssid;
Jouni Malinen636a5d32009-03-19 13:39:22 +02001008 size_t ie_len;
Samuel Ortizb23aa672009-07-01 21:26:54 +02001009 struct cfg80211_crypto_settings crypto;
Johannes Berg19957bb2009-07-02 17:20:43 +02001010 bool use_mfp;
Jouni Malinen636a5d32009-03-19 13:39:22 +02001011};
1012
1013/**
1014 * struct cfg80211_deauth_request - Deauthentication request data
1015 *
1016 * This structure provides information needed to complete IEEE 802.11
1017 * deauthentication.
1018 *
Johannes Berg19957bb2009-07-02 17:20:43 +02001019 * @bss: the BSS to deauthenticate from
Jouni Malinen636a5d32009-03-19 13:39:22 +02001020 * @ie: Extra IEs to add to Deauthentication frame or %NULL
1021 * @ie_len: Length of ie buffer in octets
Johannes Berg19957bb2009-07-02 17:20:43 +02001022 * @reason_code: The reason code for the deauthentication
Jouni Malinend5cdfac2010-04-04 09:37:19 +03001023 * @local_state_change: This is a request for a local state only, i.e., no
1024 * Deauthentication frame is to be transmitted.
Jouni Malinen636a5d32009-03-19 13:39:22 +02001025 */
1026struct cfg80211_deauth_request {
Johannes Berg19957bb2009-07-02 17:20:43 +02001027 struct cfg80211_bss *bss;
Jouni Malinen636a5d32009-03-19 13:39:22 +02001028 const u8 *ie;
1029 size_t ie_len;
Johannes Berg19957bb2009-07-02 17:20:43 +02001030 u16 reason_code;
Jouni Malinend5cdfac2010-04-04 09:37:19 +03001031 bool local_state_change;
Jouni Malinen636a5d32009-03-19 13:39:22 +02001032};
1033
1034/**
1035 * struct cfg80211_disassoc_request - Disassociation request data
1036 *
1037 * This structure provides information needed to complete IEEE 802.11
1038 * disassocation.
1039 *
Johannes Berg19957bb2009-07-02 17:20:43 +02001040 * @bss: the BSS to disassociate from
Jouni Malinen636a5d32009-03-19 13:39:22 +02001041 * @ie: Extra IEs to add to Disassociation frame or %NULL
1042 * @ie_len: Length of ie buffer in octets
Johannes Berg19957bb2009-07-02 17:20:43 +02001043 * @reason_code: The reason code for the disassociation
Jouni Malinend5cdfac2010-04-04 09:37:19 +03001044 * @local_state_change: This is a request for a local state only, i.e., no
1045 * Disassociation frame is to be transmitted.
Jouni Malinen636a5d32009-03-19 13:39:22 +02001046 */
1047struct cfg80211_disassoc_request {
Johannes Berg19957bb2009-07-02 17:20:43 +02001048 struct cfg80211_bss *bss;
Jouni Malinen636a5d32009-03-19 13:39:22 +02001049 const u8 *ie;
1050 size_t ie_len;
Johannes Berg19957bb2009-07-02 17:20:43 +02001051 u16 reason_code;
Jouni Malinend5cdfac2010-04-04 09:37:19 +03001052 bool local_state_change;
Jouni Malinen636a5d32009-03-19 13:39:22 +02001053};
1054
1055/**
Johannes Berg04a773a2009-04-19 21:24:32 +02001056 * struct cfg80211_ibss_params - IBSS parameters
1057 *
1058 * This structure defines the IBSS parameters for the join_ibss()
1059 * method.
1060 *
1061 * @ssid: The SSID, will always be non-null.
1062 * @ssid_len: The length of the SSID, will always be non-zero.
1063 * @bssid: Fixed BSSID requested, maybe be %NULL, if set do not
1064 * search for IBSSs with a different BSSID.
1065 * @channel: The channel to use if no IBSS can be found to join.
1066 * @channel_fixed: The channel should be fixed -- do not search for
1067 * IBSSs to join on other channels.
1068 * @ie: information element(s) to include in the beacon
1069 * @ie_len: length of that
Johannes Berg8e30bc52009-04-22 17:45:38 +02001070 * @beacon_interval: beacon interval to use
Johannes Bergfffd0932009-07-08 14:22:54 +02001071 * @privacy: this is a protected network, keys will be configured
1072 * after joining
Teemu Paasikivifbd2c8d2010-06-14 12:55:31 +03001073 * @basic_rates: bitmap of basic rates to use when creating the IBSS
Felix Fietkaudd5b4cc2010-11-22 20:58:24 +01001074 * @mcast_rate: per-band multicast rate index + 1 (0: disabled)
Johannes Berg04a773a2009-04-19 21:24:32 +02001075 */
1076struct cfg80211_ibss_params {
1077 u8 *ssid;
1078 u8 *bssid;
1079 struct ieee80211_channel *channel;
1080 u8 *ie;
1081 u8 ssid_len, ie_len;
Johannes Berg8e30bc52009-04-22 17:45:38 +02001082 u16 beacon_interval;
Teemu Paasikivifbd2c8d2010-06-14 12:55:31 +03001083 u32 basic_rates;
Johannes Berg04a773a2009-04-19 21:24:32 +02001084 bool channel_fixed;
Johannes Bergfffd0932009-07-08 14:22:54 +02001085 bool privacy;
Felix Fietkaudd5b4cc2010-11-22 20:58:24 +01001086 int mcast_rate[IEEE80211_NUM_BANDS];
Johannes Berg04a773a2009-04-19 21:24:32 +02001087};
1088
1089/**
Samuel Ortizb23aa672009-07-01 21:26:54 +02001090 * struct cfg80211_connect_params - Connection parameters
1091 *
1092 * This structure provides information needed to complete IEEE 802.11
1093 * authentication and association.
1094 *
1095 * @channel: The channel to use or %NULL if not specified (auto-select based
1096 * on scan results)
1097 * @bssid: The AP BSSID or %NULL if not specified (auto-select based on scan
1098 * results)
1099 * @ssid: SSID
1100 * @ssid_len: Length of ssid in octets
1101 * @auth_type: Authentication type (algorithm)
Johannes Bergabe37c42010-06-07 11:12:27 +02001102 * @ie: IEs for association request
1103 * @ie_len: Length of assoc_ie in octets
Samuel Ortizb23aa672009-07-01 21:26:54 +02001104 * @privacy: indicates whether privacy-enabled APs should be used
1105 * @crypto: crypto settings
Johannes Bergfffd0932009-07-08 14:22:54 +02001106 * @key_len: length of WEP key for shared key authentication
1107 * @key_idx: index of WEP key for shared key authentication
1108 * @key: WEP key for shared key authentication
Samuel Ortizb23aa672009-07-01 21:26:54 +02001109 */
1110struct cfg80211_connect_params {
1111 struct ieee80211_channel *channel;
1112 u8 *bssid;
1113 u8 *ssid;
1114 size_t ssid_len;
1115 enum nl80211_auth_type auth_type;
1116 u8 *ie;
1117 size_t ie_len;
1118 bool privacy;
1119 struct cfg80211_crypto_settings crypto;
Johannes Bergfffd0932009-07-08 14:22:54 +02001120 const u8 *key;
1121 u8 key_len, key_idx;
Samuel Ortizb23aa672009-07-01 21:26:54 +02001122};
1123
1124/**
Jouni Malinenb9a5f8ca2009-04-20 18:39:05 +02001125 * enum wiphy_params_flags - set_wiphy_params bitfield values
Johannes Bergabe37c42010-06-07 11:12:27 +02001126 * @WIPHY_PARAM_RETRY_SHORT: wiphy->retry_short has changed
1127 * @WIPHY_PARAM_RETRY_LONG: wiphy->retry_long has changed
1128 * @WIPHY_PARAM_FRAG_THRESHOLD: wiphy->frag_threshold has changed
1129 * @WIPHY_PARAM_RTS_THRESHOLD: wiphy->rts_threshold has changed
1130 * @WIPHY_PARAM_COVERAGE_CLASS: coverage class changed
Jouni Malinenb9a5f8ca2009-04-20 18:39:05 +02001131 */
1132enum wiphy_params_flags {
1133 WIPHY_PARAM_RETRY_SHORT = 1 << 0,
1134 WIPHY_PARAM_RETRY_LONG = 1 << 1,
1135 WIPHY_PARAM_FRAG_THRESHOLD = 1 << 2,
1136 WIPHY_PARAM_RTS_THRESHOLD = 1 << 3,
Lukáš Turek81077e82009-12-21 22:50:47 +01001137 WIPHY_PARAM_COVERAGE_CLASS = 1 << 4,
Jouni Malinenb9a5f8ca2009-04-20 18:39:05 +02001138};
1139
Johannes Berg99303802009-07-01 21:26:59 +02001140/*
1141 * cfg80211_bitrate_mask - masks for bitrate control
1142 */
1143struct cfg80211_bitrate_mask {
Johannes Berg99303802009-07-01 21:26:59 +02001144 struct {
1145 u32 legacy;
Jouni Malinen37eb0b12010-01-06 13:09:08 +02001146 /* TODO: add support for masking MCS rates; e.g.: */
1147 /* u8 mcs[IEEE80211_HT_MCS_MASK_LEN]; */
Johannes Berg99303802009-07-01 21:26:59 +02001148 } control[IEEE80211_NUM_BANDS];
Johannes Berg99303802009-07-01 21:26:59 +02001149};
Samuel Ortiz67fbb162009-11-24 23:59:15 +01001150/**
1151 * struct cfg80211_pmksa - PMK Security Association
1152 *
1153 * This structure is passed to the set/del_pmksa() method for PMKSA
1154 * caching.
1155 *
1156 * @bssid: The AP's BSSID.
1157 * @pmkid: The PMK material itself.
1158 */
1159struct cfg80211_pmksa {
1160 u8 *bssid;
1161 u8 *pmkid;
1162};
Johannes Berg99303802009-07-01 21:26:59 +02001163
Johannes Berg7643a2c2009-06-02 13:01:39 +02001164/**
Johannes Bergff1b6e62011-05-04 15:37:28 +02001165 * struct cfg80211_wowlan_trig_pkt_pattern - packet pattern
1166 * @mask: bitmask where to match pattern and where to ignore bytes,
1167 * one bit per byte, in same format as nl80211
1168 * @pattern: bytes to match where bitmask is 1
1169 * @pattern_len: length of pattern (in bytes)
1170 *
1171 * Internal note: @mask and @pattern are allocated in one chunk of
1172 * memory, free @mask only!
1173 */
1174struct cfg80211_wowlan_trig_pkt_pattern {
1175 u8 *mask, *pattern;
1176 int pattern_len;
1177};
1178
1179/**
1180 * struct cfg80211_wowlan - Wake on Wireless-LAN support info
1181 *
1182 * This structure defines the enabled WoWLAN triggers for the device.
1183 * @any: wake up on any activity -- special trigger if device continues
1184 * operating as normal during suspend
1185 * @disconnect: wake up if getting disconnected
1186 * @magic_pkt: wake up on receiving magic packet
1187 * @patterns: wake up on receiving packet matching a pattern
1188 * @n_patterns: number of patterns
Johannes Berg77dbbb12011-07-13 10:48:55 +02001189 * @gtk_rekey_failure: wake up on GTK rekey failure
1190 * @eap_identity_req: wake up on EAP identity request packet
1191 * @four_way_handshake: wake up on 4-way handshake
1192 * @rfkill_release: wake up when rfkill is released
Johannes Bergff1b6e62011-05-04 15:37:28 +02001193 */
1194struct cfg80211_wowlan {
Johannes Berg77dbbb12011-07-13 10:48:55 +02001195 bool any, disconnect, magic_pkt, gtk_rekey_failure,
1196 eap_identity_req, four_way_handshake,
1197 rfkill_release;
Johannes Bergff1b6e62011-05-04 15:37:28 +02001198 struct cfg80211_wowlan_trig_pkt_pattern *patterns;
1199 int n_patterns;
1200};
1201
1202/**
Johannes Berge5497d72011-07-05 16:35:40 +02001203 * struct cfg80211_gtk_rekey_data - rekey data
1204 * @kek: key encryption key
1205 * @kck: key confirmation key
1206 * @replay_ctr: replay counter
1207 */
1208struct cfg80211_gtk_rekey_data {
1209 u8 kek[NL80211_KEK_LEN];
1210 u8 kck[NL80211_KCK_LEN];
1211 u8 replay_ctr[NL80211_REPLAY_CTR_LEN];
1212};
1213
1214/**
Johannes Berg704232c2007-04-23 12:20:05 -07001215 * struct cfg80211_ops - backend description for wireless configuration
1216 *
1217 * This struct is registered by fullmac card drivers and/or wireless stacks
1218 * in order to handle configuration requests on their interfaces.
1219 *
1220 * All callbacks except where otherwise noted should return 0
1221 * on success or a negative error code.
1222 *
Johannes Berg43fb45cb2007-04-24 14:07:27 -07001223 * All operations are currently invoked under rtnl for consistency with the
1224 * wireless extensions but this is subject to reevaluation as soon as this
1225 * code is used more widely and we have a first user without wext.
1226 *
Johannes Bergff1b6e62011-05-04 15:37:28 +02001227 * @suspend: wiphy device needs to be suspended. The variable @wow will
1228 * be %NULL or contain the enabled Wake-on-Wireless triggers that are
1229 * configured for the device.
Johannes Berg0378b3f2009-01-19 11:20:52 -05001230 * @resume: wiphy device needs to be resumed
1231 *
Johannes Berg60719ff2008-09-16 14:55:09 +02001232 * @add_virtual_intf: create a new virtual interface with the given name,
Johannes Berg463d0182009-07-14 00:33:35 +02001233 * must set the struct wireless_dev's iftype. Beware: You must create
Johannes Bergf9e10ce2010-12-03 09:20:42 +01001234 * the new netdev in the wiphy's network namespace! Returns the netdev,
1235 * or an ERR_PTR.
Johannes Berg704232c2007-04-23 12:20:05 -07001236 *
1237 * @del_virtual_intf: remove the virtual interface determined by ifindex.
Johannes Berg55682962007-09-20 13:09:35 -04001238 *
Johannes Berg60719ff2008-09-16 14:55:09 +02001239 * @change_virtual_intf: change type/configuration of virtual interface,
1240 * keep the struct wireless_dev's iftype updated.
Johannes Berg55682962007-09-20 13:09:35 -04001241 *
Johannes Berg41ade002007-12-19 02:03:29 +01001242 * @add_key: add a key with the given parameters. @mac_addr will be %NULL
1243 * when adding a group key.
1244 *
1245 * @get_key: get information about the key with the given parameters.
1246 * @mac_addr will be %NULL when requesting information for a group
1247 * key. All pointers given to the @callback function need not be valid
Johannes Berge3da5742009-05-18 19:56:36 +02001248 * after it returns. This function should return an error if it is
1249 * not possible to retrieve the key, -ENOENT if it doesn't exist.
Johannes Berg41ade002007-12-19 02:03:29 +01001250 *
1251 * @del_key: remove a key given the @mac_addr (%NULL for a group key)
Johannes Berge3da5742009-05-18 19:56:36 +02001252 * and @key_index, return -ENOENT if the key doesn't exist.
Johannes Berg41ade002007-12-19 02:03:29 +01001253 *
1254 * @set_default_key: set the default key on an interface
Johannes Berged1b6cc2007-12-19 02:03:32 +01001255 *
Jouni Malinen3cfcf6a2009-01-08 13:32:02 +02001256 * @set_default_mgmt_key: set the default management frame key on an interface
1257 *
Johannes Berge5497d72011-07-05 16:35:40 +02001258 * @set_rekey_data: give the data necessary for GTK rekeying to the driver
1259 *
Johannes Berged1b6cc2007-12-19 02:03:32 +01001260 * @add_beacon: Add a beacon with given parameters, @head, @interval
1261 * and @dtim_period will be valid, @tail is optional.
1262 * @set_beacon: Change the beacon parameters for an access point mode
1263 * interface. This should reject the call when no beacon has been
1264 * configured.
1265 * @del_beacon: Remove beacon configuration and stop sending the beacon.
Johannes Berg5727ef12007-12-19 02:03:34 +01001266 *
1267 * @add_station: Add a new station.
Johannes Berg5727ef12007-12-19 02:03:34 +01001268 * @del_station: Remove a station; @mac may be NULL to remove all stations.
Johannes Berg5727ef12007-12-19 02:03:34 +01001269 * @change_station: Modify a given station.
Johannes Bergabe37c42010-06-07 11:12:27 +02001270 * @get_station: get station information for the station identified by @mac
1271 * @dump_station: dump station callback -- resume dump at index @idx
1272 *
1273 * @add_mpath: add a fixed mesh path
1274 * @del_mpath: delete a given mesh path
1275 * @change_mpath: change a given mesh path
1276 * @get_mpath: get a mesh path for the given parameters
1277 * @dump_mpath: dump mesh path callback -- resume dump at index @idx
Johannes Bergf52555a2011-01-06 22:36:45 +01001278 * @join_mesh: join the mesh network with the specified parameters
1279 * @leave_mesh: leave the current mesh network
Luis Carlos Cobo2ec600d2008-02-23 15:17:06 +01001280 *
Javier Cardona24bdd9f2010-12-16 17:37:48 -08001281 * @get_mesh_config: Get the current mesh configuration
colin@cozybit.com93da9cc2008-10-21 12:03:48 -07001282 *
Javier Cardona24bdd9f2010-12-16 17:37:48 -08001283 * @update_mesh_config: Update mesh parameters on a running mesh.
colin@cozybit.com93da9cc2008-10-21 12:03:48 -07001284 * The mask is a bitfield which tells us which parameters to
1285 * set, and which to leave alone.
1286 *
Jouni Malinen9f1ba902008-08-07 20:07:01 +03001287 * @change_bss: Modify parameters for a given BSS.
Jouni Malinen31888482008-10-30 16:59:24 +02001288 *
1289 * @set_txq_params: Set TX queue parameters
Jouni Malinen72bdcf32008-11-26 16:15:24 +02001290 *
Johannes Bergf444de02010-05-05 15:25:02 +02001291 * @set_channel: Set channel for a given wireless interface. Some devices
1292 * may support multi-channel operation (by channel hopping) so cfg80211
1293 * doesn't verify much. Note, however, that the passed netdev may be
1294 * %NULL as well if the user requested changing the channel for the
1295 * device itself, or for a monitor interface.
Jouni Malinen9aed3cc2009-01-13 16:03:29 +02001296 *
Johannes Berg2a519312009-02-10 21:25:55 +01001297 * @scan: Request to do a scan. If returning zero, the scan request is given
1298 * the driver, and will be valid until passed to cfg80211_scan_done().
1299 * For scan results, call cfg80211_inform_bss(); you can call this outside
1300 * the scan/scan_done bracket too.
Jouni Malinen636a5d32009-03-19 13:39:22 +02001301 *
1302 * @auth: Request to authenticate with the specified peer
1303 * @assoc: Request to (re)associate with the specified peer
1304 * @deauth: Request to deauthenticate from the specified peer
1305 * @disassoc: Request to disassociate from the specified peer
Johannes Berg04a773a2009-04-19 21:24:32 +02001306 *
Samuel Ortizb23aa672009-07-01 21:26:54 +02001307 * @connect: Connect to the ESS with the specified parameters. When connected,
1308 * call cfg80211_connect_result() with status code %WLAN_STATUS_SUCCESS.
1309 * If the connection fails for some reason, call cfg80211_connect_result()
1310 * with the status from the AP.
1311 * @disconnect: Disconnect from the BSS/ESS.
1312 *
Johannes Berg04a773a2009-04-19 21:24:32 +02001313 * @join_ibss: Join the specified IBSS (or create if necessary). Once done, call
1314 * cfg80211_ibss_joined(), also call that function when changing BSSID due
1315 * to a merge.
1316 * @leave_ibss: Leave the IBSS.
Jouni Malinenb9a5f8ca2009-04-20 18:39:05 +02001317 *
1318 * @set_wiphy_params: Notify that wiphy parameters have changed;
1319 * @changed bitfield (see &enum wiphy_params_flags) describes which values
1320 * have changed. The actual parameter values are available in
1321 * struct wiphy. If returning an error, no value should be changed.
Johannes Berg7643a2c2009-06-02 13:01:39 +02001322 *
1323 * @set_tx_power: set the transmit power according to the parameters
1324 * @get_tx_power: store the current TX power into the dbm variable;
Johannes Berg1f87f7d2009-06-02 13:01:41 +02001325 * return 0 if successful
1326 *
Johannes Bergabe37c42010-06-07 11:12:27 +02001327 * @set_wds_peer: set the WDS peer for a WDS interface
1328 *
Johannes Berg1f87f7d2009-06-02 13:01:41 +02001329 * @rfkill_poll: polls the hw rfkill line, use cfg80211 reporting
1330 * functions to adjust rfkill hw state
Johannes Bergaff89a92009-07-01 21:26:51 +02001331 *
Holger Schurig61fa7132009-11-11 12:25:40 +01001332 * @dump_survey: get site survey information.
1333 *
Jouni Malinen9588bbd2009-12-23 13:15:41 +01001334 * @remain_on_channel: Request the driver to remain awake on the specified
1335 * channel for the specified duration to complete an off-channel
1336 * operation (e.g., public action frame exchange). When the driver is
1337 * ready on the requested channel, it must indicate this with an event
1338 * notification by calling cfg80211_ready_on_channel().
1339 * @cancel_remain_on_channel: Cancel an on-going remain-on-channel operation.
1340 * This allows the operation to be terminated prior to timeout based on
1341 * the duration value.
Johannes Bergf7ca38d2010-11-25 10:02:29 +01001342 * @mgmt_tx: Transmit a management frame.
1343 * @mgmt_tx_cancel_wait: Cancel the wait time from transmitting a management
1344 * frame on another channel
Jouni Malinen9588bbd2009-12-23 13:15:41 +01001345 *
Johannes Bergaff89a92009-07-01 21:26:51 +02001346 * @testmode_cmd: run a test mode command
Wey-Yi Guy71063f02011-05-20 09:05:54 -07001347 * @testmode_dump: Implement a test mode dump. The cb->args[2] and up may be
1348 * used by the function, but 0 and 1 must not be touched. Additionally,
1349 * return error codes other than -ENOBUFS and -ENOENT will terminate the
1350 * dump and return to userspace with an error, so be careful. If any data
1351 * was passed in from userspace then the data/len arguments will be present
1352 * and point to the data contained in %NL80211_ATTR_TESTDATA.
Samuel Ortiz67fbb162009-11-24 23:59:15 +01001353 *
Johannes Bergabe37c42010-06-07 11:12:27 +02001354 * @set_bitrate_mask: set the bitrate mask configuration
1355 *
Samuel Ortiz67fbb162009-11-24 23:59:15 +01001356 * @set_pmksa: Cache a PMKID for a BSSID. This is mostly useful for fullmac
1357 * devices running firmwares capable of generating the (re) association
1358 * RSN IE. It allows for faster roaming between WPA2 BSSIDs.
1359 * @del_pmksa: Delete a cached PMKID.
1360 * @flush_pmksa: Flush all cached PMKIDs.
Juuso Oikarinen9043f3b2010-04-27 12:47:41 +03001361 * @set_power_mgmt: Configure WLAN power management. A timeout value of -1
1362 * allows the driver to adjust the dynamic ps timeout value.
Juuso Oikarinend6dc1a32010-03-23 09:02:33 +02001363 * @set_cqm_rssi_config: Configure connection quality monitor RSSI threshold.
Luciano Coelho807f8a82011-05-11 17:09:35 +03001364 * @sched_scan_start: Tell the driver to start a scheduled scan.
1365 * @sched_scan_stop: Tell the driver to stop an ongoing scheduled
1366 * scan. The driver_initiated flag specifies whether the driver
1367 * itself has informed that the scan has stopped.
Samuel Ortiz67fbb162009-11-24 23:59:15 +01001368 *
Johannes Berg271733c2010-10-13 12:06:23 +02001369 * @mgmt_frame_register: Notify driver that a management frame type was
1370 * registered. Note that this callback may not sleep, and cannot run
1371 * concurrently with itself.
Bruno Randolf547025d2010-12-02 16:23:12 +09001372 *
1373 * @set_antenna: Set antenna configuration (tx_ant, rx_ant) on the device.
1374 * Parameters are bitmaps of allowed antennas to use for TX/RX. Drivers may
1375 * reject TX/RX mask combinations they cannot support by returning -EINVAL
1376 * (also see nl80211.h @NL80211_ATTR_WIPHY_ANTENNA_TX).
1377 *
1378 * @get_antenna: Get current antenna configuration from device (tx_ant, rx_ant).
John W. Linville36777132011-03-07 16:17:59 -05001379 *
1380 * @set_ringparam: Set tx and rx ring sizes.
1381 *
1382 * @get_ringparam: Get tx and rx ring current and maximum sizes.
Johannes Berg704232c2007-04-23 12:20:05 -07001383 */
1384struct cfg80211_ops {
Johannes Bergff1b6e62011-05-04 15:37:28 +02001385 int (*suspend)(struct wiphy *wiphy, struct cfg80211_wowlan *wow);
Johannes Berg0378b3f2009-01-19 11:20:52 -05001386 int (*resume)(struct wiphy *wiphy);
1387
Johannes Bergf9e10ce2010-12-03 09:20:42 +01001388 struct net_device * (*add_virtual_intf)(struct wiphy *wiphy,
1389 char *name,
1390 enum nl80211_iftype type,
1391 u32 *flags,
1392 struct vif_params *params);
Johannes Berg463d0182009-07-14 00:33:35 +02001393 int (*del_virtual_intf)(struct wiphy *wiphy, struct net_device *dev);
Johannes Berge36d56b2009-06-09 21:04:43 +02001394 int (*change_virtual_intf)(struct wiphy *wiphy,
1395 struct net_device *dev,
Luis Carlos Cobo2ec600d2008-02-23 15:17:06 +01001396 enum nl80211_iftype type, u32 *flags,
1397 struct vif_params *params);
Johannes Berg41ade002007-12-19 02:03:29 +01001398
1399 int (*add_key)(struct wiphy *wiphy, struct net_device *netdev,
Johannes Berge31b8212010-10-05 19:39:30 +02001400 u8 key_index, bool pairwise, const u8 *mac_addr,
Johannes Berg41ade002007-12-19 02:03:29 +01001401 struct key_params *params);
1402 int (*get_key)(struct wiphy *wiphy, struct net_device *netdev,
Johannes Berge31b8212010-10-05 19:39:30 +02001403 u8 key_index, bool pairwise, const u8 *mac_addr,
1404 void *cookie,
Johannes Berg41ade002007-12-19 02:03:29 +01001405 void (*callback)(void *cookie, struct key_params*));
1406 int (*del_key)(struct wiphy *wiphy, struct net_device *netdev,
Johannes Berge31b8212010-10-05 19:39:30 +02001407 u8 key_index, bool pairwise, const u8 *mac_addr);
Johannes Berg41ade002007-12-19 02:03:29 +01001408 int (*set_default_key)(struct wiphy *wiphy,
1409 struct net_device *netdev,
Johannes Bergdbd2fd62010-12-09 19:58:59 +01001410 u8 key_index, bool unicast, bool multicast);
Jouni Malinen3cfcf6a2009-01-08 13:32:02 +02001411 int (*set_default_mgmt_key)(struct wiphy *wiphy,
1412 struct net_device *netdev,
1413 u8 key_index);
Johannes Berged1b6cc2007-12-19 02:03:32 +01001414
1415 int (*add_beacon)(struct wiphy *wiphy, struct net_device *dev,
1416 struct beacon_parameters *info);
1417 int (*set_beacon)(struct wiphy *wiphy, struct net_device *dev,
1418 struct beacon_parameters *info);
1419 int (*del_beacon)(struct wiphy *wiphy, struct net_device *dev);
Johannes Berg5727ef12007-12-19 02:03:34 +01001420
1421
1422 int (*add_station)(struct wiphy *wiphy, struct net_device *dev,
1423 u8 *mac, struct station_parameters *params);
1424 int (*del_station)(struct wiphy *wiphy, struct net_device *dev,
1425 u8 *mac);
1426 int (*change_station)(struct wiphy *wiphy, struct net_device *dev,
1427 u8 *mac, struct station_parameters *params);
Johannes Bergfd5b74d2007-12-19 02:03:36 +01001428 int (*get_station)(struct wiphy *wiphy, struct net_device *dev,
Luis Carlos Cobo2ec600d2008-02-23 15:17:06 +01001429 u8 *mac, struct station_info *sinfo);
1430 int (*dump_station)(struct wiphy *wiphy, struct net_device *dev,
1431 int idx, u8 *mac, struct station_info *sinfo);
1432
1433 int (*add_mpath)(struct wiphy *wiphy, struct net_device *dev,
1434 u8 *dst, u8 *next_hop);
1435 int (*del_mpath)(struct wiphy *wiphy, struct net_device *dev,
1436 u8 *dst);
1437 int (*change_mpath)(struct wiphy *wiphy, struct net_device *dev,
1438 u8 *dst, u8 *next_hop);
1439 int (*get_mpath)(struct wiphy *wiphy, struct net_device *dev,
1440 u8 *dst, u8 *next_hop,
1441 struct mpath_info *pinfo);
1442 int (*dump_mpath)(struct wiphy *wiphy, struct net_device *dev,
1443 int idx, u8 *dst, u8 *next_hop,
1444 struct mpath_info *pinfo);
Javier Cardona24bdd9f2010-12-16 17:37:48 -08001445 int (*get_mesh_config)(struct wiphy *wiphy,
colin@cozybit.com93da9cc2008-10-21 12:03:48 -07001446 struct net_device *dev,
1447 struct mesh_config *conf);
Javier Cardona24bdd9f2010-12-16 17:37:48 -08001448 int (*update_mesh_config)(struct wiphy *wiphy,
Johannes Berg29cbe682010-12-03 09:20:44 +01001449 struct net_device *dev, u32 mask,
1450 const struct mesh_config *nconf);
1451 int (*join_mesh)(struct wiphy *wiphy, struct net_device *dev,
1452 const struct mesh_config *conf,
1453 const struct mesh_setup *setup);
1454 int (*leave_mesh)(struct wiphy *wiphy, struct net_device *dev);
1455
Jouni Malinen9f1ba902008-08-07 20:07:01 +03001456 int (*change_bss)(struct wiphy *wiphy, struct net_device *dev,
1457 struct bss_parameters *params);
Jouni Malinen31888482008-10-30 16:59:24 +02001458
1459 int (*set_txq_params)(struct wiphy *wiphy,
1460 struct ieee80211_txq_params *params);
Jouni Malinen72bdcf32008-11-26 16:15:24 +02001461
Johannes Bergf444de02010-05-05 15:25:02 +02001462 int (*set_channel)(struct wiphy *wiphy, struct net_device *dev,
Jouni Malinen72bdcf32008-11-26 16:15:24 +02001463 struct ieee80211_channel *chan,
Sujith094d05d2008-12-12 11:57:43 +05301464 enum nl80211_channel_type channel_type);
Jouni Malinen9aed3cc2009-01-13 16:03:29 +02001465
Johannes Berg2a519312009-02-10 21:25:55 +01001466 int (*scan)(struct wiphy *wiphy, struct net_device *dev,
1467 struct cfg80211_scan_request *request);
Jouni Malinen636a5d32009-03-19 13:39:22 +02001468
1469 int (*auth)(struct wiphy *wiphy, struct net_device *dev,
1470 struct cfg80211_auth_request *req);
1471 int (*assoc)(struct wiphy *wiphy, struct net_device *dev,
1472 struct cfg80211_assoc_request *req);
1473 int (*deauth)(struct wiphy *wiphy, struct net_device *dev,
Johannes Berg667503d2009-07-07 03:56:11 +02001474 struct cfg80211_deauth_request *req,
1475 void *cookie);
Jouni Malinen636a5d32009-03-19 13:39:22 +02001476 int (*disassoc)(struct wiphy *wiphy, struct net_device *dev,
Johannes Berg667503d2009-07-07 03:56:11 +02001477 struct cfg80211_disassoc_request *req,
1478 void *cookie);
Johannes Berg04a773a2009-04-19 21:24:32 +02001479
Samuel Ortizb23aa672009-07-01 21:26:54 +02001480 int (*connect)(struct wiphy *wiphy, struct net_device *dev,
1481 struct cfg80211_connect_params *sme);
1482 int (*disconnect)(struct wiphy *wiphy, struct net_device *dev,
1483 u16 reason_code);
1484
Johannes Berg04a773a2009-04-19 21:24:32 +02001485 int (*join_ibss)(struct wiphy *wiphy, struct net_device *dev,
1486 struct cfg80211_ibss_params *params);
1487 int (*leave_ibss)(struct wiphy *wiphy, struct net_device *dev);
Jouni Malinenb9a5f8ca2009-04-20 18:39:05 +02001488
1489 int (*set_wiphy_params)(struct wiphy *wiphy, u32 changed);
Johannes Berg7643a2c2009-06-02 13:01:39 +02001490
1491 int (*set_tx_power)(struct wiphy *wiphy,
Juuso Oikarinenfa61cf72010-06-23 12:12:37 +03001492 enum nl80211_tx_power_setting type, int mbm);
Johannes Berg7643a2c2009-06-02 13:01:39 +02001493 int (*get_tx_power)(struct wiphy *wiphy, int *dbm);
Johannes Berg1f87f7d2009-06-02 13:01:41 +02001494
Johannes Bergab737a42009-07-01 21:26:58 +02001495 int (*set_wds_peer)(struct wiphy *wiphy, struct net_device *dev,
Johannes Berg388ac772010-10-07 13:11:09 +02001496 const u8 *addr);
Johannes Bergab737a42009-07-01 21:26:58 +02001497
Johannes Berg1f87f7d2009-06-02 13:01:41 +02001498 void (*rfkill_poll)(struct wiphy *wiphy);
Johannes Bergaff89a92009-07-01 21:26:51 +02001499
1500#ifdef CONFIG_NL80211_TESTMODE
1501 int (*testmode_cmd)(struct wiphy *wiphy, void *data, int len);
Wey-Yi Guy71063f02011-05-20 09:05:54 -07001502 int (*testmode_dump)(struct wiphy *wiphy, struct sk_buff *skb,
1503 struct netlink_callback *cb,
1504 void *data, int len);
Johannes Bergaff89a92009-07-01 21:26:51 +02001505#endif
Johannes Bergbc92afd2009-07-01 21:26:57 +02001506
Johannes Berg99303802009-07-01 21:26:59 +02001507 int (*set_bitrate_mask)(struct wiphy *wiphy,
1508 struct net_device *dev,
1509 const u8 *peer,
1510 const struct cfg80211_bitrate_mask *mask);
1511
Holger Schurig61fa7132009-11-11 12:25:40 +01001512 int (*dump_survey)(struct wiphy *wiphy, struct net_device *netdev,
1513 int idx, struct survey_info *info);
1514
Samuel Ortiz67fbb162009-11-24 23:59:15 +01001515 int (*set_pmksa)(struct wiphy *wiphy, struct net_device *netdev,
1516 struct cfg80211_pmksa *pmksa);
1517 int (*del_pmksa)(struct wiphy *wiphy, struct net_device *netdev,
1518 struct cfg80211_pmksa *pmksa);
1519 int (*flush_pmksa)(struct wiphy *wiphy, struct net_device *netdev);
1520
Jouni Malinen9588bbd2009-12-23 13:15:41 +01001521 int (*remain_on_channel)(struct wiphy *wiphy,
1522 struct net_device *dev,
1523 struct ieee80211_channel *chan,
1524 enum nl80211_channel_type channel_type,
1525 unsigned int duration,
1526 u64 *cookie);
1527 int (*cancel_remain_on_channel)(struct wiphy *wiphy,
1528 struct net_device *dev,
1529 u64 cookie);
1530
Johannes Berg2e161f72010-08-12 15:38:38 +02001531 int (*mgmt_tx)(struct wiphy *wiphy, struct net_device *dev,
Johannes Bergf7ca38d2010-11-25 10:02:29 +01001532 struct ieee80211_channel *chan, bool offchan,
Jouni Malinen026331c2010-02-15 12:53:10 +02001533 enum nl80211_channel_type channel_type,
Johannes Bergf7ca38d2010-11-25 10:02:29 +01001534 bool channel_type_valid, unsigned int wait,
Jouni Malinen026331c2010-02-15 12:53:10 +02001535 const u8 *buf, size_t len, u64 *cookie);
Johannes Bergf7ca38d2010-11-25 10:02:29 +01001536 int (*mgmt_tx_cancel_wait)(struct wiphy *wiphy,
1537 struct net_device *dev,
1538 u64 cookie);
Jouni Malinen026331c2010-02-15 12:53:10 +02001539
Johannes Bergbc92afd2009-07-01 21:26:57 +02001540 int (*set_power_mgmt)(struct wiphy *wiphy, struct net_device *dev,
1541 bool enabled, int timeout);
Juuso Oikarinend6dc1a32010-03-23 09:02:33 +02001542
1543 int (*set_cqm_rssi_config)(struct wiphy *wiphy,
1544 struct net_device *dev,
1545 s32 rssi_thold, u32 rssi_hyst);
Johannes Berg271733c2010-10-13 12:06:23 +02001546
1547 void (*mgmt_frame_register)(struct wiphy *wiphy,
1548 struct net_device *dev,
1549 u16 frame_type, bool reg);
Bruno Randolfafe0cbf2010-11-10 12:50:50 +09001550
1551 int (*set_antenna)(struct wiphy *wiphy, u32 tx_ant, u32 rx_ant);
1552 int (*get_antenna)(struct wiphy *wiphy, u32 *tx_ant, u32 *rx_ant);
John W. Linville36777132011-03-07 16:17:59 -05001553
1554 int (*set_ringparam)(struct wiphy *wiphy, u32 tx, u32 rx);
1555 void (*get_ringparam)(struct wiphy *wiphy,
1556 u32 *tx, u32 *tx_max, u32 *rx, u32 *rx_max);
Luciano Coelho807f8a82011-05-11 17:09:35 +03001557
1558 int (*sched_scan_start)(struct wiphy *wiphy,
1559 struct net_device *dev,
1560 struct cfg80211_sched_scan_request *request);
Luciano Coelho85a99942011-05-12 16:28:29 +03001561 int (*sched_scan_stop)(struct wiphy *wiphy, struct net_device *dev);
Johannes Berge5497d72011-07-05 16:35:40 +02001562
1563 int (*set_rekey_data)(struct wiphy *wiphy, struct net_device *dev,
1564 struct cfg80211_gtk_rekey_data *data);
Johannes Berg704232c2007-04-23 12:20:05 -07001565};
1566
Johannes Bergd3236552009-04-20 14:31:42 +02001567/*
1568 * wireless hardware and networking interfaces structures
1569 * and registration/helper functions
1570 */
1571
1572/**
Johannes Berg5be83de2009-11-19 00:56:28 +01001573 * enum wiphy_flags - wiphy capability flags
1574 *
1575 * @WIPHY_FLAG_CUSTOM_REGULATORY: tells us the driver for this device
Johannes Bergd3236552009-04-20 14:31:42 +02001576 * has its own custom regulatory domain and cannot identify the
1577 * ISO / IEC 3166 alpha2 it belongs to. When this is enabled
1578 * we will disregard the first regulatory hint (when the
1579 * initiator is %REGDOM_SET_BY_CORE).
Johannes Berg5be83de2009-11-19 00:56:28 +01001580 * @WIPHY_FLAG_STRICT_REGULATORY: tells us the driver for this device will
1581 * ignore regulatory domain settings until it gets its own regulatory
Luis R. Rodriguez749b5272010-10-20 10:18:54 -07001582 * domain via its regulatory_hint() unless the regulatory hint is
1583 * from a country IE. After its gets its own regulatory domain it will
1584 * only allow further regulatory domain settings to further enhance
1585 * compliance. For example if channel 13 and 14 are disabled by this
1586 * regulatory domain no user regulatory domain can enable these channels
1587 * at a later time. This can be used for devices which do not have
1588 * calibration information guaranteed for frequencies or settings
1589 * outside of its regulatory domain.
Johannes Berg5be83de2009-11-19 00:56:28 +01001590 * @WIPHY_FLAG_DISABLE_BEACON_HINTS: enable this if your driver needs to ensure
1591 * that passive scan flags and beaconing flags may not be lifted by
1592 * cfg80211 due to regulatory beacon hints. For more information on beacon
Luis R. Rodriguez37184242009-07-30 17:43:48 -07001593 * hints read the documenation for regulatory_hint_found_beacon()
Johannes Berg5be83de2009-11-19 00:56:28 +01001594 * @WIPHY_FLAG_NETNS_OK: if not set, do not allow changing the netns of this
1595 * wiphy at all
Johannes Berg7527a782011-05-13 10:58:57 +02001596 * @WIPHY_FLAG_ENFORCE_COMBINATIONS: Set this flag to enforce interface
1597 * combinations for this device. This flag is used for backward
1598 * compatibility only until all drivers advertise combinations and
1599 * they will always be enforced.
Johannes Berg5be83de2009-11-19 00:56:28 +01001600 * @WIPHY_FLAG_PS_ON_BY_DEFAULT: if set to true, powersave will be enabled
1601 * by default -- this flag will be set depending on the kernel's default
1602 * on wiphy_new(), but can be changed by the driver if it has a good
1603 * reason to override the default
Johannes Berg9bc383d2009-11-19 11:55:19 +01001604 * @WIPHY_FLAG_4ADDR_AP: supports 4addr mode even on AP (with a single station
1605 * on a VLAN interface)
1606 * @WIPHY_FLAG_4ADDR_STATION: supports 4addr mode even as a station
Johannes Bergc0692b82010-08-27 14:26:53 +03001607 * @WIPHY_FLAG_CONTROL_PORT_PROTOCOL: This device supports setting the
1608 * control port protocol ethertype. The device also honours the
1609 * control_port_no_encrypt flag.
Johannes Berge31b8212010-10-05 19:39:30 +02001610 * @WIPHY_FLAG_IBSS_RSN: The device supports IBSS RSN.
Javier Cardona15d5dda2011-04-07 15:08:28 -07001611 * @WIPHY_FLAG_MESH_AUTH: The device supports mesh authentication by routing
1612 * auth frames to userspace. See @NL80211_MESH_SETUP_USERSPACE_AUTH.
Randy Dunlap1ba01452011-05-22 17:16:20 -07001613 * @WIPHY_FLAG_SUPPORTS_SCHED_SCAN: The device supports scheduled scans.
Johannes Berg5be83de2009-11-19 00:56:28 +01001614 */
1615enum wiphy_flags {
Johannes Bergc0692b82010-08-27 14:26:53 +03001616 WIPHY_FLAG_CUSTOM_REGULATORY = BIT(0),
1617 WIPHY_FLAG_STRICT_REGULATORY = BIT(1),
1618 WIPHY_FLAG_DISABLE_BEACON_HINTS = BIT(2),
1619 WIPHY_FLAG_NETNS_OK = BIT(3),
1620 WIPHY_FLAG_PS_ON_BY_DEFAULT = BIT(4),
1621 WIPHY_FLAG_4ADDR_AP = BIT(5),
1622 WIPHY_FLAG_4ADDR_STATION = BIT(6),
1623 WIPHY_FLAG_CONTROL_PORT_PROTOCOL = BIT(7),
Jussi Kivilinna309075c2010-11-12 08:53:56 +02001624 WIPHY_FLAG_IBSS_RSN = BIT(8),
Javier Cardona15d5dda2011-04-07 15:08:28 -07001625 WIPHY_FLAG_MESH_AUTH = BIT(10),
Luciano Coelho807f8a82011-05-11 17:09:35 +03001626 WIPHY_FLAG_SUPPORTS_SCHED_SCAN = BIT(11),
Johannes Berg7527a782011-05-13 10:58:57 +02001627 WIPHY_FLAG_ENFORCE_COMBINATIONS = BIT(12),
1628};
1629
1630/**
1631 * struct ieee80211_iface_limit - limit on certain interface types
1632 * @max: maximum number of interfaces of these types
1633 * @types: interface types (bits)
1634 */
1635struct ieee80211_iface_limit {
1636 u16 max;
1637 u16 types;
1638};
1639
1640/**
1641 * struct ieee80211_iface_combination - possible interface combination
1642 * @limits: limits for the given interface types
1643 * @n_limits: number of limitations
1644 * @num_different_channels: can use up to this many different channels
1645 * @max_interfaces: maximum number of interfaces in total allowed in this
1646 * group
1647 * @beacon_int_infra_match: In this combination, the beacon intervals
1648 * between infrastructure and AP types must match. This is required
1649 * only in special cases.
1650 *
1651 * These examples can be expressed as follows:
1652 *
1653 * Allow #STA <= 1, #AP <= 1, matching BI, channels = 1, 2 total:
1654 *
1655 * struct ieee80211_iface_limit limits1[] = {
1656 * { .max = 1, .types = BIT(NL80211_IFTYPE_STATION), },
1657 * { .max = 1, .types = BIT(NL80211_IFTYPE_AP}, },
1658 * };
1659 * struct ieee80211_iface_combination combination1 = {
1660 * .limits = limits1,
1661 * .n_limits = ARRAY_SIZE(limits1),
1662 * .max_interfaces = 2,
1663 * .beacon_int_infra_match = true,
1664 * };
1665 *
1666 *
1667 * Allow #{AP, P2P-GO} <= 8, channels = 1, 8 total:
1668 *
1669 * struct ieee80211_iface_limit limits2[] = {
1670 * { .max = 8, .types = BIT(NL80211_IFTYPE_AP) |
1671 * BIT(NL80211_IFTYPE_P2P_GO), },
1672 * };
1673 * struct ieee80211_iface_combination combination2 = {
1674 * .limits = limits2,
1675 * .n_limits = ARRAY_SIZE(limits2),
1676 * .max_interfaces = 8,
1677 * .num_different_channels = 1,
1678 * };
1679 *
1680 *
1681 * Allow #STA <= 1, #{P2P-client,P2P-GO} <= 3 on two channels, 4 total.
1682 * This allows for an infrastructure connection and three P2P connections.
1683 *
1684 * struct ieee80211_iface_limit limits3[] = {
1685 * { .max = 1, .types = BIT(NL80211_IFTYPE_STATION), },
1686 * { .max = 3, .types = BIT(NL80211_IFTYPE_P2P_GO) |
1687 * BIT(NL80211_IFTYPE_P2P_CLIENT), },
1688 * };
1689 * struct ieee80211_iface_combination combination3 = {
1690 * .limits = limits3,
1691 * .n_limits = ARRAY_SIZE(limits3),
1692 * .max_interfaces = 4,
1693 * .num_different_channels = 2,
1694 * };
1695 */
1696struct ieee80211_iface_combination {
1697 const struct ieee80211_iface_limit *limits;
1698 u32 num_different_channels;
1699 u16 max_interfaces;
1700 u8 n_limits;
1701 bool beacon_int_infra_match;
Johannes Berg5be83de2009-11-19 00:56:28 +01001702};
1703
Johannes Bergef15aac2010-01-20 12:02:33 +01001704struct mac_address {
1705 u8 addr[ETH_ALEN];
1706};
1707
Johannes Berg2e161f72010-08-12 15:38:38 +02001708struct ieee80211_txrx_stypes {
1709 u16 tx, rx;
1710};
1711
Johannes Berg5be83de2009-11-19 00:56:28 +01001712/**
Johannes Bergff1b6e62011-05-04 15:37:28 +02001713 * enum wiphy_wowlan_support_flags - WoWLAN support flags
1714 * @WIPHY_WOWLAN_ANY: supports wakeup for the special "any"
1715 * trigger that keeps the device operating as-is and
1716 * wakes up the host on any activity, for example a
1717 * received packet that passed filtering; note that the
1718 * packet should be preserved in that case
1719 * @WIPHY_WOWLAN_MAGIC_PKT: supports wakeup on magic packet
1720 * (see nl80211.h)
1721 * @WIPHY_WOWLAN_DISCONNECT: supports wakeup on disconnect
Johannes Berg77dbbb12011-07-13 10:48:55 +02001722 * @WIPHY_WOWLAN_SUPPORTS_GTK_REKEY: supports GTK rekeying while asleep
1723 * @WIPHY_WOWLAN_GTK_REKEY_FAILURE: supports wakeup on GTK rekey failure
1724 * @WIPHY_WOWLAN_EAP_IDENTITY_REQ: supports wakeup on EAP identity request
1725 * @WIPHY_WOWLAN_4WAY_HANDSHAKE: supports wakeup on 4-way handshake failure
1726 * @WIPHY_WOWLAN_RFKILL_RELEASE: supports wakeup on RF-kill release
Johannes Bergff1b6e62011-05-04 15:37:28 +02001727 */
1728enum wiphy_wowlan_support_flags {
Johannes Berg77dbbb12011-07-13 10:48:55 +02001729 WIPHY_WOWLAN_ANY = BIT(0),
1730 WIPHY_WOWLAN_MAGIC_PKT = BIT(1),
1731 WIPHY_WOWLAN_DISCONNECT = BIT(2),
1732 WIPHY_WOWLAN_SUPPORTS_GTK_REKEY = BIT(3),
1733 WIPHY_WOWLAN_GTK_REKEY_FAILURE = BIT(4),
1734 WIPHY_WOWLAN_EAP_IDENTITY_REQ = BIT(5),
1735 WIPHY_WOWLAN_4WAY_HANDSHAKE = BIT(6),
1736 WIPHY_WOWLAN_RFKILL_RELEASE = BIT(7),
Johannes Bergff1b6e62011-05-04 15:37:28 +02001737};
1738
1739/**
1740 * struct wiphy_wowlan_support - WoWLAN support data
1741 * @flags: see &enum wiphy_wowlan_support_flags
1742 * @n_patterns: number of supported wakeup patterns
1743 * (see nl80211.h for the pattern definition)
1744 * @pattern_max_len: maximum length of each pattern
1745 * @pattern_min_len: minimum length of each pattern
1746 */
1747struct wiphy_wowlan_support {
1748 u32 flags;
1749 int n_patterns;
1750 int pattern_max_len;
1751 int pattern_min_len;
1752};
1753
1754/**
Johannes Berg5be83de2009-11-19 00:56:28 +01001755 * struct wiphy - wireless hardware description
Luis R. Rodriguez2784fe92010-12-15 19:24:11 -08001756 * @reg_notifier: the driver's regulatory notification callback,
1757 * note that if your driver uses wiphy_apply_custom_regulatory()
1758 * the reg_notifier's request can be passed as NULL
Johannes Bergd3236552009-04-20 14:31:42 +02001759 * @regd: the driver's regulatory domain, if one was requested via
1760 * the regulatory_hint() API. This can be used by the driver
1761 * on the reg_notifier() if it chooses to ignore future
1762 * regulatory domain changes caused by other drivers.
1763 * @signal_type: signal type reported in &struct cfg80211_bss.
1764 * @cipher_suites: supported cipher suites
1765 * @n_cipher_suites: number of supported cipher suites
Jouni Malinenb9a5f8ca2009-04-20 18:39:05 +02001766 * @retry_short: Retry limit for short frames (dot11ShortRetryLimit)
1767 * @retry_long: Retry limit for long frames (dot11LongRetryLimit)
1768 * @frag_threshold: Fragmentation threshold (dot11FragmentationThreshold);
1769 * -1 = fragmentation disabled, only odd values >= 256 used
1770 * @rts_threshold: RTS threshold (dot11RTSThreshold); -1 = RTS/CTS disabled
Johannes Bergabe37c42010-06-07 11:12:27 +02001771 * @_net: the network namespace this wiphy currently lives in
Johannes Bergef15aac2010-01-20 12:02:33 +01001772 * @perm_addr: permanent MAC address of this device
1773 * @addr_mask: If the device supports multiple MAC addresses by masking,
1774 * set this to a mask with variable bits set to 1, e.g. if the last
1775 * four bits are variable then set it to 00:...:00:0f. The actual
1776 * variable bits shall be determined by the interfaces added, with
1777 * interfaces not matching the mask being rejected to be brought up.
1778 * @n_addresses: number of addresses in @addresses.
1779 * @addresses: If the device has more than one address, set this pointer
1780 * to a list of addresses (6 bytes each). The first one will be used
1781 * by default for perm_addr. In this case, the mask should be set to
1782 * all-zeroes. In this case it is assumed that the device can handle
1783 * the same number of arbitrary MAC addresses.
Johannes Bergabe37c42010-06-07 11:12:27 +02001784 * @debugfsdir: debugfs directory used for this wiphy, will be renamed
1785 * automatically on wiphy renames
1786 * @dev: (virtual) struct device for this wiphy
1787 * @wext: wireless extension handlers
1788 * @priv: driver private data (sized according to wiphy_new() parameter)
1789 * @interface_modes: bitmask of interfaces types valid for this wiphy,
1790 * must be set by driver
Johannes Berg7527a782011-05-13 10:58:57 +02001791 * @iface_combinations: Valid interface combinations array, should not
1792 * list single interface types.
1793 * @n_iface_combinations: number of entries in @iface_combinations array.
1794 * @software_iftypes: bitmask of software interface types, these are not
1795 * subject to any restrictions since they are purely managed in SW.
Johannes Bergabe37c42010-06-07 11:12:27 +02001796 * @flags: wiphy flags, see &enum wiphy_flags
1797 * @bss_priv_size: each BSS struct has private data allocated with it,
1798 * this variable determines its size
1799 * @max_scan_ssids: maximum number of SSIDs the device can scan for in
1800 * any given scan
Luciano Coelho93b6aa62011-07-13 14:57:28 +03001801 * @max_sched_scan_ssids: maximum number of SSIDs the device can scan
1802 * for in any given scheduled scan
Johannes Bergabe37c42010-06-07 11:12:27 +02001803 * @max_scan_ie_len: maximum length of user-controlled IEs device can
1804 * add to probe request frames transmitted during a scan, must not
1805 * include fixed IEs like supported rates
Luciano Coelho5a865ba2011-07-13 14:57:29 +03001806 * @max_sched_scan_ie_len: same as max_scan_ie_len, but for scheduled
1807 * scans
Johannes Bergabe37c42010-06-07 11:12:27 +02001808 * @coverage_class: current coverage class
1809 * @fw_version: firmware version for ethtool reporting
1810 * @hw_version: hardware version for ethtool reporting
1811 * @max_num_pmkids: maximum number of PMKIDs supported by device
1812 * @privid: a pointer that drivers can use to identify if an arbitrary
1813 * wiphy is theirs, e.g. in global notifiers
1814 * @bands: information about bands/channels supported by this device
Johannes Berg2e161f72010-08-12 15:38:38 +02001815 *
1816 * @mgmt_stypes: bitmasks of frame subtypes that can be subscribed to or
1817 * transmitted through nl80211, points to an array indexed by interface
1818 * type
Bruno Randolfa7ffac92010-12-08 13:59:24 +09001819 *
Bruno Randolf7f531e02010-12-16 11:30:22 +09001820 * @available_antennas_tx: bitmap of antennas which are available to be
1821 * configured as TX antennas. Antenna configuration commands will be
1822 * rejected unless this or @available_antennas_rx is set.
1823 *
1824 * @available_antennas_rx: bitmap of antennas which are available to be
1825 * configured as RX antennas. Antenna configuration commands will be
1826 * rejected unless this or @available_antennas_tx is set.
Johannes Berga2939112010-12-14 17:54:28 +01001827 *
1828 * @max_remain_on_channel_duration: Maximum time a remain-on-channel operation
1829 * may request, if implemented.
Johannes Bergff1b6e62011-05-04 15:37:28 +02001830 *
1831 * @wowlan: WoWLAN support information
Johannes Bergd3236552009-04-20 14:31:42 +02001832 */
1833struct wiphy {
1834 /* assign these fields before you register the wiphy */
1835
Johannes Bergef15aac2010-01-20 12:02:33 +01001836 /* permanent MAC address(es) */
Johannes Bergd3236552009-04-20 14:31:42 +02001837 u8 perm_addr[ETH_ALEN];
Johannes Bergef15aac2010-01-20 12:02:33 +01001838 u8 addr_mask[ETH_ALEN];
1839
Johannes Bergef15aac2010-01-20 12:02:33 +01001840 struct mac_address *addresses;
Johannes Bergd3236552009-04-20 14:31:42 +02001841
Johannes Berg2e161f72010-08-12 15:38:38 +02001842 const struct ieee80211_txrx_stypes *mgmt_stypes;
1843
Johannes Berg7527a782011-05-13 10:58:57 +02001844 const struct ieee80211_iface_combination *iface_combinations;
1845 int n_iface_combinations;
1846 u16 software_iftypes;
1847
Johannes Berg2e161f72010-08-12 15:38:38 +02001848 u16 n_addresses;
1849
Johannes Bergd3236552009-04-20 14:31:42 +02001850 /* Supported interface modes, OR together BIT(NL80211_IFTYPE_...) */
1851 u16 interface_modes;
1852
Johannes Berg5be83de2009-11-19 00:56:28 +01001853 u32 flags;
Johannes Berg463d0182009-07-14 00:33:35 +02001854
Johannes Bergd3236552009-04-20 14:31:42 +02001855 enum cfg80211_signal_type signal_type;
1856
1857 int bss_priv_size;
1858 u8 max_scan_ssids;
Luciano Coelho93b6aa62011-07-13 14:57:28 +03001859 u8 max_sched_scan_ssids;
Johannes Bergd3236552009-04-20 14:31:42 +02001860 u16 max_scan_ie_len;
Luciano Coelho5a865ba2011-07-13 14:57:29 +03001861 u16 max_sched_scan_ie_len;
Johannes Bergd3236552009-04-20 14:31:42 +02001862
1863 int n_cipher_suites;
1864 const u32 *cipher_suites;
1865
Jouni Malinenb9a5f8ca2009-04-20 18:39:05 +02001866 u8 retry_short;
1867 u8 retry_long;
1868 u32 frag_threshold;
1869 u32 rts_threshold;
Lukáš Turek81077e82009-12-21 22:50:47 +01001870 u8 coverage_class;
Jouni Malinenb9a5f8ca2009-04-20 18:39:05 +02001871
Kalle Valodfce95f2009-09-24 11:02:42 -07001872 char fw_version[ETHTOOL_BUSINFO_LEN];
1873 u32 hw_version;
1874
Johannes Bergff1b6e62011-05-04 15:37:28 +02001875 struct wiphy_wowlan_support wowlan;
1876
Johannes Berga2939112010-12-14 17:54:28 +01001877 u16 max_remain_on_channel_duration;
1878
Samuel Ortiz67fbb162009-11-24 23:59:15 +01001879 u8 max_num_pmkids;
1880
Bruno Randolf7f531e02010-12-16 11:30:22 +09001881 u32 available_antennas_tx;
1882 u32 available_antennas_rx;
Bruno Randolfa7ffac92010-12-08 13:59:24 +09001883
Johannes Bergd3236552009-04-20 14:31:42 +02001884 /* If multiple wiphys are registered and you're handed e.g.
1885 * a regular netdev with assigned ieee80211_ptr, you won't
1886 * know whether it points to a wiphy your driver has registered
1887 * or not. Assign this to something global to your driver to
1888 * help determine whether you own this wiphy or not. */
David Kilroycf5aa2f2009-05-16 23:13:47 +01001889 const void *privid;
Johannes Bergd3236552009-04-20 14:31:42 +02001890
1891 struct ieee80211_supported_band *bands[IEEE80211_NUM_BANDS];
1892
1893 /* Lets us get back the wiphy on the callback */
1894 int (*reg_notifier)(struct wiphy *wiphy,
1895 struct regulatory_request *request);
1896
1897 /* fields below are read-only, assigned by cfg80211 */
1898
1899 const struct ieee80211_regdomain *regd;
1900
1901 /* the item in /sys/class/ieee80211/ points to this,
1902 * you need use set_wiphy_dev() (see below) */
1903 struct device dev;
1904
1905 /* dir in debugfs: ieee80211/<wiphyname> */
1906 struct dentry *debugfsdir;
1907
Johannes Berg463d0182009-07-14 00:33:35 +02001908#ifdef CONFIG_NET_NS
1909 /* the network namespace this phy lives in currently */
1910 struct net *_net;
1911#endif
1912
Johannes Berg3d23e342009-09-29 23:27:28 +02001913#ifdef CONFIG_CFG80211_WEXT
1914 const struct iw_handler_def *wext;
1915#endif
1916
Johannes Bergd3236552009-04-20 14:31:42 +02001917 char priv[0] __attribute__((__aligned__(NETDEV_ALIGN)));
1918};
1919
Johannes Berg463d0182009-07-14 00:33:35 +02001920static inline struct net *wiphy_net(struct wiphy *wiphy)
1921{
Eric Dumazetc2d9ba92010-06-01 06:51:19 +00001922 return read_pnet(&wiphy->_net);
Johannes Berg463d0182009-07-14 00:33:35 +02001923}
1924
1925static inline void wiphy_net_set(struct wiphy *wiphy, struct net *net)
1926{
Eric Dumazetc2d9ba92010-06-01 06:51:19 +00001927 write_pnet(&wiphy->_net, net);
Johannes Berg463d0182009-07-14 00:33:35 +02001928}
Johannes Berg463d0182009-07-14 00:33:35 +02001929
Johannes Bergd3236552009-04-20 14:31:42 +02001930/**
1931 * wiphy_priv - return priv from wiphy
1932 *
1933 * @wiphy: the wiphy whose priv pointer to return
1934 */
1935static inline void *wiphy_priv(struct wiphy *wiphy)
1936{
1937 BUG_ON(!wiphy);
1938 return &wiphy->priv;
1939}
1940
1941/**
David Kilroyf1f74822009-06-18 23:21:13 +01001942 * priv_to_wiphy - return the wiphy containing the priv
1943 *
1944 * @priv: a pointer previously returned by wiphy_priv
1945 */
1946static inline struct wiphy *priv_to_wiphy(void *priv)
1947{
1948 BUG_ON(!priv);
1949 return container_of(priv, struct wiphy, priv);
1950}
1951
1952/**
Johannes Bergd3236552009-04-20 14:31:42 +02001953 * set_wiphy_dev - set device pointer for wiphy
1954 *
1955 * @wiphy: The wiphy whose device to bind
1956 * @dev: The device to parent it to
1957 */
1958static inline void set_wiphy_dev(struct wiphy *wiphy, struct device *dev)
1959{
1960 wiphy->dev.parent = dev;
1961}
1962
1963/**
1964 * wiphy_dev - get wiphy dev pointer
1965 *
1966 * @wiphy: The wiphy whose device struct to look up
1967 */
1968static inline struct device *wiphy_dev(struct wiphy *wiphy)
1969{
1970 return wiphy->dev.parent;
1971}
1972
1973/**
1974 * wiphy_name - get wiphy name
1975 *
1976 * @wiphy: The wiphy whose name to return
1977 */
Joe Perchese1db74f2010-07-26 14:39:57 -07001978static inline const char *wiphy_name(const struct wiphy *wiphy)
Johannes Bergd3236552009-04-20 14:31:42 +02001979{
1980 return dev_name(&wiphy->dev);
1981}
1982
1983/**
1984 * wiphy_new - create a new wiphy for use with cfg80211
1985 *
1986 * @ops: The configuration operations for this device
1987 * @sizeof_priv: The size of the private area to allocate
1988 *
1989 * Create a new wiphy and associate the given operations with it.
1990 * @sizeof_priv bytes are allocated for private use.
1991 *
1992 * The returned pointer must be assigned to each netdev's
1993 * ieee80211_ptr for proper operation.
1994 */
David Kilroy3dcf6702009-05-16 23:13:46 +01001995struct wiphy *wiphy_new(const struct cfg80211_ops *ops, int sizeof_priv);
Johannes Bergd3236552009-04-20 14:31:42 +02001996
1997/**
1998 * wiphy_register - register a wiphy with cfg80211
1999 *
2000 * @wiphy: The wiphy to register.
2001 *
2002 * Returns a non-negative wiphy index or a negative error code.
2003 */
2004extern int wiphy_register(struct wiphy *wiphy);
2005
2006/**
2007 * wiphy_unregister - deregister a wiphy from cfg80211
2008 *
2009 * @wiphy: The wiphy to unregister.
2010 *
2011 * After this call, no more requests can be made with this priv
2012 * pointer, but the call may sleep to wait for an outstanding
2013 * request that is being handled.
2014 */
2015extern void wiphy_unregister(struct wiphy *wiphy);
2016
2017/**
2018 * wiphy_free - free wiphy
2019 *
2020 * @wiphy: The wiphy to free
2021 */
2022extern void wiphy_free(struct wiphy *wiphy);
2023
Johannes Bergfffd0932009-07-08 14:22:54 +02002024/* internal structs */
Johannes Berg6829c872009-07-02 09:13:27 +02002025struct cfg80211_conn;
Johannes Berg19957bb2009-07-02 17:20:43 +02002026struct cfg80211_internal_bss;
Johannes Bergfffd0932009-07-08 14:22:54 +02002027struct cfg80211_cached_keys;
Johannes Berg19957bb2009-07-02 17:20:43 +02002028
2029#define MAX_AUTH_BSSES 4
Johannes Berg6829c872009-07-02 09:13:27 +02002030
Johannes Bergd3236552009-04-20 14:31:42 +02002031/**
2032 * struct wireless_dev - wireless per-netdev state
2033 *
2034 * This structure must be allocated by the driver/stack
2035 * that uses the ieee80211_ptr field in struct net_device
2036 * (this is intentional so it can be allocated along with
2037 * the netdev.)
2038 *
2039 * @wiphy: pointer to hardware description
2040 * @iftype: interface type
2041 * @list: (private) Used to collect the interfaces
2042 * @netdev: (private) Used to reference back to the netdev
2043 * @current_bss: (private) Used by the internal configuration code
Johannes Bergf444de02010-05-05 15:25:02 +02002044 * @channel: (private) Used by the internal configuration code to track
2045 * user-set AP, monitor and WDS channels for wireless extensions
Johannes Bergd3236552009-04-20 14:31:42 +02002046 * @bssid: (private) Used by the internal configuration code
2047 * @ssid: (private) Used by the internal configuration code
2048 * @ssid_len: (private) Used by the internal configuration code
Johannes Berg29cbe682010-12-03 09:20:44 +01002049 * @mesh_id_len: (private) Used by the internal configuration code
2050 * @mesh_id_up_len: (private) Used by the internal configuration code
Johannes Bergd3236552009-04-20 14:31:42 +02002051 * @wext: (private) Used by the internal wireless extensions compat code
Johannes Berg9bc383d2009-11-19 11:55:19 +01002052 * @use_4addr: indicates 4addr mode is used on this interface, must be
2053 * set by driver (if supported) on add_interface BEFORE registering the
2054 * netdev and may otherwise be used by driver read-only, will be update
2055 * by cfg80211 on change_interface
Johannes Berg2e161f72010-08-12 15:38:38 +02002056 * @mgmt_registrations: list of registrations for management frames
2057 * @mgmt_registrations_lock: lock for the list
Johannes Bergabe37c42010-06-07 11:12:27 +02002058 * @mtx: mutex used to lock data in this struct
2059 * @cleanup_work: work struct used for cleanup that can't be done directly
Johannes Berg56d18932011-05-09 18:41:15 +02002060 * @beacon_interval: beacon interval used on this device for transmitting
2061 * beacons, 0 when not valid
Johannes Bergd3236552009-04-20 14:31:42 +02002062 */
2063struct wireless_dev {
2064 struct wiphy *wiphy;
2065 enum nl80211_iftype iftype;
2066
Johannes Berg667503d2009-07-07 03:56:11 +02002067 /* the remainder of this struct should be private to cfg80211 */
Johannes Bergd3236552009-04-20 14:31:42 +02002068 struct list_head list;
2069 struct net_device *netdev;
2070
Johannes Berg2e161f72010-08-12 15:38:38 +02002071 struct list_head mgmt_registrations;
2072 spinlock_t mgmt_registrations_lock;
Jouni Malinen026331c2010-02-15 12:53:10 +02002073
Johannes Berg667503d2009-07-07 03:56:11 +02002074 struct mutex mtx;
2075
Johannes Bergad002392009-08-18 19:51:57 +02002076 struct work_struct cleanup_work;
2077
Johannes Berg9bc383d2009-11-19 11:55:19 +01002078 bool use_4addr;
2079
Samuel Ortizb23aa672009-07-01 21:26:54 +02002080 /* currently used for IBSS and SME - might be rearranged later */
Johannes Bergd3236552009-04-20 14:31:42 +02002081 u8 ssid[IEEE80211_MAX_SSID_LEN];
Johannes Berg29cbe682010-12-03 09:20:44 +01002082 u8 ssid_len, mesh_id_len, mesh_id_up_len;
Samuel Ortizb23aa672009-07-01 21:26:54 +02002083 enum {
2084 CFG80211_SME_IDLE,
Johannes Berg6829c872009-07-02 09:13:27 +02002085 CFG80211_SME_CONNECTING,
Samuel Ortizb23aa672009-07-01 21:26:54 +02002086 CFG80211_SME_CONNECTED,
2087 } sme_state;
Johannes Berg6829c872009-07-02 09:13:27 +02002088 struct cfg80211_conn *conn;
Johannes Bergfffd0932009-07-08 14:22:54 +02002089 struct cfg80211_cached_keys *connect_keys;
Johannes Bergd3236552009-04-20 14:31:42 +02002090
Johannes Berg667503d2009-07-07 03:56:11 +02002091 struct list_head event_list;
2092 spinlock_t event_lock;
2093
Johannes Berg19957bb2009-07-02 17:20:43 +02002094 struct cfg80211_internal_bss *authtry_bsses[MAX_AUTH_BSSES];
2095 struct cfg80211_internal_bss *auth_bsses[MAX_AUTH_BSSES];
2096 struct cfg80211_internal_bss *current_bss; /* associated / joined */
Johannes Bergf444de02010-05-05 15:25:02 +02002097 struct ieee80211_channel *channel;
Johannes Berg19957bb2009-07-02 17:20:43 +02002098
Kalle Valoffb9eb32010-02-17 17:58:10 +02002099 bool ps;
2100 int ps_timeout;
2101
Johannes Berg56d18932011-05-09 18:41:15 +02002102 int beacon_interval;
2103
Johannes Berg3d23e342009-09-29 23:27:28 +02002104#ifdef CONFIG_CFG80211_WEXT
Johannes Bergd3236552009-04-20 14:31:42 +02002105 /* wext data */
Johannes Bergcbe8fa92009-05-09 20:09:03 +02002106 struct {
Johannes Bergc238c8a2009-07-07 03:56:06 +02002107 struct cfg80211_ibss_params ibss;
2108 struct cfg80211_connect_params connect;
Johannes Bergfffd0932009-07-08 14:22:54 +02002109 struct cfg80211_cached_keys *keys;
Johannes Bergf2129352009-07-01 21:26:56 +02002110 u8 *ie;
2111 size_t ie_len;
Johannes Bergf401a6f2009-08-07 14:51:05 +02002112 u8 bssid[ETH_ALEN], prev_bssid[ETH_ALEN];
Johannes Bergf2129352009-07-01 21:26:56 +02002113 u8 ssid[IEEE80211_MAX_SSID_LEN];
Johannes Berg08645122009-05-11 13:54:58 +02002114 s8 default_key, default_mgmt_key;
Kalle Valoffb9eb32010-02-17 17:58:10 +02002115 bool prev_bssid_valid;
Johannes Bergcbe8fa92009-05-09 20:09:03 +02002116 } wext;
Johannes Bergd3236552009-04-20 14:31:42 +02002117#endif
2118};
2119
2120/**
2121 * wdev_priv - return wiphy priv from wireless_dev
2122 *
2123 * @wdev: The wireless device whose wiphy's priv pointer to return
2124 */
2125static inline void *wdev_priv(struct wireless_dev *wdev)
2126{
2127 BUG_ON(!wdev);
2128 return wiphy_priv(wdev->wiphy);
2129}
2130
Johannes Bergd70e9692010-08-19 16:11:27 +02002131/**
2132 * DOC: Utility functions
2133 *
2134 * cfg80211 offers a number of utility functions that can be useful.
Johannes Bergd3236552009-04-20 14:31:42 +02002135 */
2136
2137/**
2138 * ieee80211_channel_to_frequency - convert channel number to frequency
Johannes Bergabe37c42010-06-07 11:12:27 +02002139 * @chan: channel number
Bruno Randolf59eb21a2011-01-17 13:37:28 +09002140 * @band: band, necessary due to channel number overlap
Johannes Bergd3236552009-04-20 14:31:42 +02002141 */
Bruno Randolf59eb21a2011-01-17 13:37:28 +09002142extern int ieee80211_channel_to_frequency(int chan, enum ieee80211_band band);
Johannes Bergd3236552009-04-20 14:31:42 +02002143
2144/**
2145 * ieee80211_frequency_to_channel - convert frequency to channel number
Johannes Bergabe37c42010-06-07 11:12:27 +02002146 * @freq: center frequency
Johannes Bergd3236552009-04-20 14:31:42 +02002147 */
2148extern int ieee80211_frequency_to_channel(int freq);
2149
2150/*
2151 * Name indirection necessary because the ieee80211 code also has
2152 * a function named "ieee80211_get_channel", so if you include
2153 * cfg80211's header file you get cfg80211's version, if you try
2154 * to include both header files you'll (rightfully!) get a symbol
2155 * clash.
2156 */
2157extern struct ieee80211_channel *__ieee80211_get_channel(struct wiphy *wiphy,
2158 int freq);
2159/**
2160 * ieee80211_get_channel - get channel struct from wiphy for specified frequency
Johannes Bergabe37c42010-06-07 11:12:27 +02002161 * @wiphy: the struct wiphy to get the channel for
2162 * @freq: the center frequency of the channel
Johannes Bergd3236552009-04-20 14:31:42 +02002163 */
2164static inline struct ieee80211_channel *
2165ieee80211_get_channel(struct wiphy *wiphy, int freq)
2166{
2167 return __ieee80211_get_channel(wiphy, freq);
2168}
2169
2170/**
2171 * ieee80211_get_response_rate - get basic rate for a given rate
2172 *
2173 * @sband: the band to look for rates in
2174 * @basic_rates: bitmap of basic rates
2175 * @bitrate: the bitrate for which to find the basic rate
2176 *
2177 * This function returns the basic rate corresponding to a given
2178 * bitrate, that is the next lower bitrate contained in the basic
2179 * rate map, which is, for this function, given as a bitmap of
2180 * indices of rates in the band's bitrate table.
2181 */
2182struct ieee80211_rate *
2183ieee80211_get_response_rate(struct ieee80211_supported_band *sband,
2184 u32 basic_rates, int bitrate);
2185
2186/*
2187 * Radiotap parsing functions -- for controlled injection support
2188 *
2189 * Implemented in net/wireless/radiotap.c
2190 * Documentation in Documentation/networking/radiotap-headers.txt
2191 */
2192
Johannes Berg33e5a2f2010-02-03 10:24:30 +01002193struct radiotap_align_size {
2194 uint8_t align:4, size:4;
2195};
2196
2197struct ieee80211_radiotap_namespace {
2198 const struct radiotap_align_size *align_size;
2199 int n_bits;
2200 uint32_t oui;
2201 uint8_t subns;
2202};
2203
2204struct ieee80211_radiotap_vendor_namespaces {
2205 const struct ieee80211_radiotap_namespace *ns;
2206 int n_ns;
2207};
2208
Johannes Bergd3236552009-04-20 14:31:42 +02002209/**
2210 * struct ieee80211_radiotap_iterator - tracks walk thru present radiotap args
Johannes Berg33e5a2f2010-02-03 10:24:30 +01002211 * @this_arg_index: index of current arg, valid after each successful call
2212 * to ieee80211_radiotap_iterator_next()
2213 * @this_arg: pointer to current radiotap arg; it is valid after each
2214 * call to ieee80211_radiotap_iterator_next() but also after
2215 * ieee80211_radiotap_iterator_init() where it will point to
2216 * the beginning of the actual data portion
2217 * @this_arg_size: length of the current arg, for convenience
2218 * @current_namespace: pointer to the current namespace definition
2219 * (or internally %NULL if the current namespace is unknown)
2220 * @is_radiotap_ns: indicates whether the current namespace is the default
2221 * radiotap namespace or not
2222 *
Johannes Berg33e5a2f2010-02-03 10:24:30 +01002223 * @_rtheader: pointer to the radiotap header we are walking through
2224 * @_max_length: length of radiotap header in cpu byte ordering
2225 * @_arg_index: next argument index
2226 * @_arg: next argument pointer
2227 * @_next_bitmap: internal pointer to next present u32
2228 * @_bitmap_shifter: internal shifter for curr u32 bitmap, b0 set == arg present
2229 * @_vns: vendor namespace definitions
2230 * @_next_ns_data: beginning of the next namespace's data
2231 * @_reset_on_ext: internal; reset the arg index to 0 when going to the
2232 * next bitmap word
2233 *
2234 * Describes the radiotap parser state. Fields prefixed with an underscore
2235 * must not be used by users of the parser, only by the parser internally.
Johannes Bergd3236552009-04-20 14:31:42 +02002236 */
2237
2238struct ieee80211_radiotap_iterator {
Johannes Berg33e5a2f2010-02-03 10:24:30 +01002239 struct ieee80211_radiotap_header *_rtheader;
2240 const struct ieee80211_radiotap_vendor_namespaces *_vns;
2241 const struct ieee80211_radiotap_namespace *current_namespace;
Johannes Bergd3236552009-04-20 14:31:42 +02002242
Johannes Berg33e5a2f2010-02-03 10:24:30 +01002243 unsigned char *_arg, *_next_ns_data;
Johannes Berg67272442010-04-21 10:25:36 +02002244 __le32 *_next_bitmap;
Johannes Berg33e5a2f2010-02-03 10:24:30 +01002245
2246 unsigned char *this_arg;
2247 int this_arg_index;
2248 int this_arg_size;
2249
2250 int is_radiotap_ns;
2251
2252 int _max_length;
2253 int _arg_index;
2254 uint32_t _bitmap_shifter;
2255 int _reset_on_ext;
Johannes Bergd3236552009-04-20 14:31:42 +02002256};
2257
2258extern int ieee80211_radiotap_iterator_init(
Johannes Berg33e5a2f2010-02-03 10:24:30 +01002259 struct ieee80211_radiotap_iterator *iterator,
2260 struct ieee80211_radiotap_header *radiotap_header,
2261 int max_length, const struct ieee80211_radiotap_vendor_namespaces *vns);
Johannes Bergd3236552009-04-20 14:31:42 +02002262
2263extern int ieee80211_radiotap_iterator_next(
Johannes Berg33e5a2f2010-02-03 10:24:30 +01002264 struct ieee80211_radiotap_iterator *iterator);
2265
Johannes Bergd3236552009-04-20 14:31:42 +02002266
Zhu Yie31a16d2009-05-21 21:47:03 +08002267extern const unsigned char rfc1042_header[6];
2268extern const unsigned char bridge_tunnel_header[6];
2269
Yogesh Ashok Powar0879fa42011-08-09 18:02:26 -07002270/* Parsed Information Elements */
2271struct ieee802_11_elems {
2272 u8 *ie_start;
2273 size_t total_len;
2274
2275 /* pointers to IEs */
2276 u8 *ssid;
2277 u8 *supp_rates;
2278 u8 *fh_params;
2279 u8 *ds_params;
2280 u8 *cf_params;
2281 struct ieee80211_tim_ie *tim;
2282 u8 *ibss_params;
2283 u8 *challenge;
2284 u8 *wpa;
2285 u8 *rsn;
2286 u8 *erp_info;
2287 u8 *ext_supp_rates;
2288 u8 *wmm_info;
2289 u8 *wmm_param;
2290 struct ieee80211_ht_cap *ht_cap_elem;
2291 struct ieee80211_ht_info *ht_info_elem;
2292 struct ieee80211_meshconf_ie *mesh_config;
2293 u8 *mesh_id;
Thomas Pedersen8db09852011-08-12 20:01:00 -07002294 u8 *peering;
Yogesh Ashok Powar0879fa42011-08-09 18:02:26 -07002295 u8 *preq;
2296 u8 *prep;
2297 u8 *perr;
2298 struct ieee80211_rann_ie *rann;
2299 u8 *ch_switch_elem;
2300 u8 *country_elem;
2301 u8 *pwr_constr_elem;
2302 u8 *quiet_elem; /* first quite element */
2303 u8 *timeout_int;
2304
2305 /* length of them, respectively */
2306 u8 ssid_len;
2307 u8 supp_rates_len;
2308 u8 fh_params_len;
2309 u8 ds_params_len;
2310 u8 cf_params_len;
2311 u8 tim_len;
2312 u8 ibss_params_len;
2313 u8 challenge_len;
2314 u8 wpa_len;
2315 u8 rsn_len;
2316 u8 erp_info_len;
2317 u8 ext_supp_rates_len;
2318 u8 wmm_info_len;
2319 u8 wmm_param_len;
2320 u8 mesh_id_len;
Thomas Pedersen8db09852011-08-12 20:01:00 -07002321 u8 peering_len;
Yogesh Ashok Powar0879fa42011-08-09 18:02:26 -07002322 u8 preq_len;
2323 u8 prep_len;
2324 u8 perr_len;
2325 u8 ch_switch_elem_len;
2326 u8 country_elem_len;
2327 u8 pwr_constr_elem_len;
2328 u8 quiet_elem_len;
2329 u8 num_of_quiet_elem; /* can be more the one */
2330 u8 timeout_int_len;
2331};
2332
Zhu Yie31a16d2009-05-21 21:47:03 +08002333/**
2334 * ieee80211_get_hdrlen_from_skb - get header length from data
2335 *
2336 * Given an skb with a raw 802.11 header at the data pointer this function
2337 * returns the 802.11 header length in bytes (not including encryption
2338 * headers). If the data in the sk_buff is too short to contain a valid 802.11
2339 * header the function returns 0.
2340 *
2341 * @skb: the frame
2342 */
2343unsigned int ieee80211_get_hdrlen_from_skb(const struct sk_buff *skb);
2344
2345/**
2346 * ieee80211_hdrlen - get header length in bytes from frame control
2347 * @fc: frame control field in little-endian format
2348 */
Johannes Berg633adf12010-08-12 14:49:58 +02002349unsigned int __attribute_const__ ieee80211_hdrlen(__le16 fc);
Zhu Yie31a16d2009-05-21 21:47:03 +08002350
2351/**
Johannes Bergd70e9692010-08-19 16:11:27 +02002352 * DOC: Data path helpers
2353 *
2354 * In addition to generic utilities, cfg80211 also offers
2355 * functions that help implement the data path for devices
2356 * that do not do the 802.11/802.3 conversion on the device.
2357 */
2358
2359/**
Zhu Yie31a16d2009-05-21 21:47:03 +08002360 * ieee80211_data_to_8023 - convert an 802.11 data frame to 802.3
2361 * @skb: the 802.11 data frame
2362 * @addr: the device MAC address
2363 * @iftype: the virtual interface type
2364 */
Zhu Yieaf85ca2009-12-01 10:18:37 +08002365int ieee80211_data_to_8023(struct sk_buff *skb, const u8 *addr,
Zhu Yie31a16d2009-05-21 21:47:03 +08002366 enum nl80211_iftype iftype);
2367
2368/**
2369 * ieee80211_data_from_8023 - convert an 802.3 frame to 802.11
2370 * @skb: the 802.3 frame
2371 * @addr: the device MAC address
2372 * @iftype: the virtual interface type
2373 * @bssid: the network bssid (used only for iftype STATION and ADHOC)
2374 * @qos: build 802.11 QoS data frame
2375 */
Zhu Yieaf85ca2009-12-01 10:18:37 +08002376int ieee80211_data_from_8023(struct sk_buff *skb, const u8 *addr,
Zhu Yie31a16d2009-05-21 21:47:03 +08002377 enum nl80211_iftype iftype, u8 *bssid, bool qos);
2378
2379/**
Zhu Yieaf85ca2009-12-01 10:18:37 +08002380 * ieee80211_amsdu_to_8023s - decode an IEEE 802.11n A-MSDU frame
2381 *
2382 * Decode an IEEE 802.11n A-MSDU frame and convert it to a list of
2383 * 802.3 frames. The @list will be empty if the decode fails. The
2384 * @skb is consumed after the function returns.
2385 *
2386 * @skb: The input IEEE 802.11n A-MSDU frame.
2387 * @list: The output list of 802.3 frames. It must be allocated and
2388 * initialized by by the caller.
2389 * @addr: The device MAC address.
2390 * @iftype: The device interface type.
2391 * @extra_headroom: The hardware extra headroom for SKBs in the @list.
Yogesh Ashok Powar8b3beca2011-05-13 11:22:31 -07002392 * @has_80211_header: Set it true if SKB is with IEEE 802.11 header.
Zhu Yieaf85ca2009-12-01 10:18:37 +08002393 */
2394void ieee80211_amsdu_to_8023s(struct sk_buff *skb, struct sk_buff_head *list,
2395 const u8 *addr, enum nl80211_iftype iftype,
Yogesh Ashok Powar8b3beca2011-05-13 11:22:31 -07002396 const unsigned int extra_headroom,
2397 bool has_80211_header);
Zhu Yieaf85ca2009-12-01 10:18:37 +08002398
2399/**
Zhu Yie31a16d2009-05-21 21:47:03 +08002400 * cfg80211_classify8021d - determine the 802.1p/1d tag for a data frame
2401 * @skb: the data frame
2402 */
2403unsigned int cfg80211_classify8021d(struct sk_buff *skb);
2404
Johannes Bergc21dbf92010-01-26 14:15:46 +01002405/**
2406 * cfg80211_find_ie - find information element in data
2407 *
2408 * @eid: element ID
2409 * @ies: data consisting of IEs
2410 * @len: length of data
2411 *
2412 * This function will return %NULL if the element ID could
2413 * not be found or if the element is invalid (claims to be
2414 * longer than the given data), or a pointer to the first byte
2415 * of the requested element, that is the byte containing the
2416 * element ID. There are no checks on the element length
2417 * other than having to fit into the given data.
2418 */
2419const u8 *cfg80211_find_ie(u8 eid, const u8 *ies, int len);
2420
Johannes Bergd70e9692010-08-19 16:11:27 +02002421/**
2422 * DOC: Regulatory enforcement infrastructure
2423 *
2424 * TODO
Johannes Bergd3236552009-04-20 14:31:42 +02002425 */
2426
2427/**
2428 * regulatory_hint - driver hint to the wireless core a regulatory domain
2429 * @wiphy: the wireless device giving the hint (used only for reporting
2430 * conflicts)
2431 * @alpha2: the ISO/IEC 3166 alpha2 the driver claims its regulatory domain
2432 * should be in. If @rd is set this should be NULL. Note that if you
2433 * set this to NULL you should still set rd->alpha2 to some accepted
2434 * alpha2.
2435 *
2436 * Wireless drivers can use this function to hint to the wireless core
2437 * what it believes should be the current regulatory domain by
2438 * giving it an ISO/IEC 3166 alpha2 country code it knows its regulatory
2439 * domain should be in or by providing a completely build regulatory domain.
2440 * If the driver provides an ISO/IEC 3166 alpha2 userspace will be queried
2441 * for a regulatory domain structure for the respective country.
2442 *
2443 * The wiphy must have been registered to cfg80211 prior to this call.
2444 * For cfg80211 drivers this means you must first use wiphy_register(),
2445 * for mac80211 drivers you must first use ieee80211_register_hw().
2446 *
2447 * Drivers should check the return value, its possible you can get
2448 * an -ENOMEM.
2449 */
2450extern int regulatory_hint(struct wiphy *wiphy, const char *alpha2);
2451
2452/**
Johannes Bergd3236552009-04-20 14:31:42 +02002453 * wiphy_apply_custom_regulatory - apply a custom driver regulatory domain
2454 * @wiphy: the wireless device we want to process the regulatory domain on
2455 * @regd: the custom regulatory domain to use for this wiphy
2456 *
2457 * Drivers can sometimes have custom regulatory domains which do not apply
2458 * to a specific country. Drivers can use this to apply such custom regulatory
2459 * domains. This routine must be called prior to wiphy registration. The
2460 * custom regulatory domain will be trusted completely and as such previous
2461 * default channel settings will be disregarded. If no rule is found for a
2462 * channel on the regulatory domain the channel will be disabled.
2463 */
2464extern void wiphy_apply_custom_regulatory(
2465 struct wiphy *wiphy,
2466 const struct ieee80211_regdomain *regd);
2467
2468/**
2469 * freq_reg_info - get regulatory information for the given frequency
2470 * @wiphy: the wiphy for which we want to process this rule for
2471 * @center_freq: Frequency in KHz for which we want regulatory information for
Luis R. Rodriguez038659e2009-05-02 00:37:17 -04002472 * @desired_bw_khz: the desired max bandwidth you want to use per
2473 * channel. Note that this is still 20 MHz if you want to use HT40
2474 * as HT40 makes use of two channels for its 40 MHz width bandwidth.
2475 * If set to 0 we'll assume you want the standard 20 MHz.
Johannes Bergd3236552009-04-20 14:31:42 +02002476 * @reg_rule: the regulatory rule which we have for this frequency
2477 *
2478 * Use this function to get the regulatory rule for a specific frequency on
2479 * a given wireless device. If the device has a specific regulatory domain
2480 * it wants to follow we respect that unless a country IE has been received
2481 * and processed already.
2482 *
2483 * Returns 0 if it was able to find a valid regulatory rule which does
2484 * apply to the given center_freq otherwise it returns non-zero. It will
2485 * also return -ERANGE if we determine the given center_freq does not even have
2486 * a regulatory rule for a frequency range in the center_freq's band. See
2487 * freq_in_rule_band() for our current definition of a band -- this is purely
2488 * subjective and right now its 802.11 specific.
2489 */
Luis R. Rodriguez038659e2009-05-02 00:37:17 -04002490extern int freq_reg_info(struct wiphy *wiphy,
2491 u32 center_freq,
2492 u32 desired_bw_khz,
Johannes Bergd3236552009-04-20 14:31:42 +02002493 const struct ieee80211_reg_rule **reg_rule);
2494
2495/*
Johannes Bergd3236552009-04-20 14:31:42 +02002496 * callbacks for asynchronous cfg80211 methods, notification
2497 * functions and BSS handling helpers
2498 */
2499
Johannes Berg2a519312009-02-10 21:25:55 +01002500/**
2501 * cfg80211_scan_done - notify that scan finished
2502 *
2503 * @request: the corresponding scan request
2504 * @aborted: set to true if the scan was aborted for any reason,
2505 * userspace will be notified of that
2506 */
2507void cfg80211_scan_done(struct cfg80211_scan_request *request, bool aborted);
2508
2509/**
Luciano Coelho807f8a82011-05-11 17:09:35 +03002510 * cfg80211_sched_scan_results - notify that new scan results are available
2511 *
2512 * @wiphy: the wiphy which got scheduled scan results
2513 */
2514void cfg80211_sched_scan_results(struct wiphy *wiphy);
2515
2516/**
2517 * cfg80211_sched_scan_stopped - notify that the scheduled scan has stopped
2518 *
2519 * @wiphy: the wiphy on which the scheduled scan stopped
2520 *
2521 * The driver can call this function to inform cfg80211 that the
2522 * scheduled scan had to be stopped, for whatever reason. The driver
2523 * is then called back via the sched_scan_stop operation when done.
2524 */
2525void cfg80211_sched_scan_stopped(struct wiphy *wiphy);
2526
2527/**
Johannes Bergabe37c42010-06-07 11:12:27 +02002528 * cfg80211_inform_bss_frame - inform cfg80211 of a received BSS frame
Johannes Berg2a519312009-02-10 21:25:55 +01002529 *
2530 * @wiphy: the wiphy reporting the BSS
Johannes Bergabe37c42010-06-07 11:12:27 +02002531 * @channel: The channel the frame was received on
2532 * @mgmt: the management frame (probe response or beacon)
2533 * @len: length of the management frame
Johannes Berg77965c92009-02-18 18:45:06 +01002534 * @signal: the signal strength, type depends on the wiphy's signal_type
Johannes Berg2a519312009-02-10 21:25:55 +01002535 * @gfp: context flags
2536 *
2537 * This informs cfg80211 that BSS information was found and
2538 * the BSS should be updated/added.
2539 */
2540struct cfg80211_bss*
2541cfg80211_inform_bss_frame(struct wiphy *wiphy,
2542 struct ieee80211_channel *channel,
2543 struct ieee80211_mgmt *mgmt, size_t len,
Johannes Berg77965c92009-02-18 18:45:06 +01002544 s32 signal, gfp_t gfp);
Johannes Berg2a519312009-02-10 21:25:55 +01002545
Johannes Bergabe37c42010-06-07 11:12:27 +02002546/**
2547 * cfg80211_inform_bss - inform cfg80211 of a new BSS
2548 *
2549 * @wiphy: the wiphy reporting the BSS
2550 * @channel: The channel the frame was received on
2551 * @bssid: the BSSID of the BSS
2552 * @timestamp: the TSF timestamp sent by the peer
2553 * @capability: the capability field sent by the peer
2554 * @beacon_interval: the beacon interval announced by the peer
2555 * @ie: additional IEs sent by the peer
2556 * @ielen: length of the additional IEs
2557 * @signal: the signal strength, type depends on the wiphy's signal_type
2558 * @gfp: context flags
2559 *
2560 * This informs cfg80211 that BSS information was found and
2561 * the BSS should be updated/added.
2562 */
Jussi Kivilinna06aa7af2009-03-26 23:40:09 +02002563struct cfg80211_bss*
2564cfg80211_inform_bss(struct wiphy *wiphy,
2565 struct ieee80211_channel *channel,
2566 const u8 *bssid,
2567 u64 timestamp, u16 capability, u16 beacon_interval,
2568 const u8 *ie, size_t ielen,
2569 s32 signal, gfp_t gfp);
2570
Johannes Berg2a519312009-02-10 21:25:55 +01002571struct cfg80211_bss *cfg80211_get_bss(struct wiphy *wiphy,
2572 struct ieee80211_channel *channel,
2573 const u8 *bssid,
Johannes Berg79420f02009-02-10 21:25:59 +01002574 const u8 *ssid, size_t ssid_len,
2575 u16 capa_mask, u16 capa_val);
2576static inline struct cfg80211_bss *
2577cfg80211_get_ibss(struct wiphy *wiphy,
2578 struct ieee80211_channel *channel,
2579 const u8 *ssid, size_t ssid_len)
2580{
2581 return cfg80211_get_bss(wiphy, channel, NULL, ssid, ssid_len,
2582 WLAN_CAPABILITY_IBSS, WLAN_CAPABILITY_IBSS);
2583}
2584
Johannes Berg2a519312009-02-10 21:25:55 +01002585struct cfg80211_bss *cfg80211_get_mesh(struct wiphy *wiphy,
2586 struct ieee80211_channel *channel,
2587 const u8 *meshid, size_t meshidlen,
2588 const u8 *meshcfg);
2589void cfg80211_put_bss(struct cfg80211_bss *bss);
Johannes Bergd3236552009-04-20 14:31:42 +02002590
Johannes Bergd491af12009-02-10 21:25:58 +01002591/**
2592 * cfg80211_unlink_bss - unlink BSS from internal data structures
2593 * @wiphy: the wiphy
2594 * @bss: the bss to remove
2595 *
2596 * This function removes the given BSS from the internal data structures
2597 * thereby making it no longer show up in scan results etc. Use this
2598 * function when you detect a BSS is gone. Normally BSSes will also time
2599 * out, so it is not necessary to use this function at all.
2600 */
2601void cfg80211_unlink_bss(struct wiphy *wiphy, struct cfg80211_bss *bss);
Johannes Bergfee52672008-11-26 22:36:31 +01002602
Jouni Malinen6039f6d2009-03-19 13:39:21 +02002603/**
2604 * cfg80211_send_rx_auth - notification of processed authentication
2605 * @dev: network device
2606 * @buf: authentication frame (header + body)
2607 * @len: length of the frame data
2608 *
2609 * This function is called whenever an authentication has been processed in
Jouni Malinen1965c852009-04-22 21:38:25 +03002610 * station mode. The driver is required to call either this function or
2611 * cfg80211_send_auth_timeout() to indicate the result of cfg80211_ops::auth()
Johannes Bergcb0b4be2009-07-07 03:56:07 +02002612 * call. This function may sleep.
Jouni Malinen6039f6d2009-03-19 13:39:21 +02002613 */
Johannes Bergcb0b4be2009-07-07 03:56:07 +02002614void cfg80211_send_rx_auth(struct net_device *dev, const u8 *buf, size_t len);
Jouni Malinen6039f6d2009-03-19 13:39:21 +02002615
2616/**
Jouni Malinen1965c852009-04-22 21:38:25 +03002617 * cfg80211_send_auth_timeout - notification of timed out authentication
2618 * @dev: network device
2619 * @addr: The MAC address of the device with which the authentication timed out
Johannes Bergcb0b4be2009-07-07 03:56:07 +02002620 *
2621 * This function may sleep.
Jouni Malinen1965c852009-04-22 21:38:25 +03002622 */
Johannes Bergcb0b4be2009-07-07 03:56:07 +02002623void cfg80211_send_auth_timeout(struct net_device *dev, const u8 *addr);
Jouni Malinen1965c852009-04-22 21:38:25 +03002624
2625/**
Johannes Berga58ce432009-11-19 12:45:42 +01002626 * __cfg80211_auth_canceled - notify cfg80211 that authentication was canceled
2627 * @dev: network device
2628 * @addr: The MAC address of the device with which the authentication timed out
2629 *
2630 * When a pending authentication had no action yet, the driver may decide
2631 * to not send a deauth frame, but in that case must calls this function
2632 * to tell cfg80211 about this decision. It is only valid to call this
2633 * function within the deauth() callback.
2634 */
2635void __cfg80211_auth_canceled(struct net_device *dev, const u8 *addr);
2636
2637/**
Jouni Malinen6039f6d2009-03-19 13:39:21 +02002638 * cfg80211_send_rx_assoc - notification of processed association
2639 * @dev: network device
2640 * @buf: (re)association response frame (header + body)
2641 * @len: length of the frame data
2642 *
2643 * This function is called whenever a (re)association response has been
Jouni Malinen1965c852009-04-22 21:38:25 +03002644 * processed in station mode. The driver is required to call either this
2645 * function or cfg80211_send_assoc_timeout() to indicate the result of
Johannes Bergcb0b4be2009-07-07 03:56:07 +02002646 * cfg80211_ops::assoc() call. This function may sleep.
Jouni Malinen6039f6d2009-03-19 13:39:21 +02002647 */
Johannes Bergcb0b4be2009-07-07 03:56:07 +02002648void cfg80211_send_rx_assoc(struct net_device *dev, const u8 *buf, size_t len);
Jouni Malinen6039f6d2009-03-19 13:39:21 +02002649
2650/**
Jouni Malinen1965c852009-04-22 21:38:25 +03002651 * cfg80211_send_assoc_timeout - notification of timed out association
2652 * @dev: network device
2653 * @addr: The MAC address of the device with which the association timed out
Johannes Bergcb0b4be2009-07-07 03:56:07 +02002654 *
2655 * This function may sleep.
Jouni Malinen1965c852009-04-22 21:38:25 +03002656 */
Johannes Bergcb0b4be2009-07-07 03:56:07 +02002657void cfg80211_send_assoc_timeout(struct net_device *dev, const u8 *addr);
Jouni Malinen1965c852009-04-22 21:38:25 +03002658
2659/**
Jouni Malinen53b46b82009-03-27 20:53:56 +02002660 * cfg80211_send_deauth - notification of processed deauthentication
Jouni Malinen6039f6d2009-03-19 13:39:21 +02002661 * @dev: network device
2662 * @buf: deauthentication frame (header + body)
2663 * @len: length of the frame data
2664 *
2665 * This function is called whenever deauthentication has been processed in
Jouni Malinen53b46b82009-03-27 20:53:56 +02002666 * station mode. This includes both received deauthentication frames and
Johannes Bergcb0b4be2009-07-07 03:56:07 +02002667 * locally generated ones. This function may sleep.
Jouni Malinen6039f6d2009-03-19 13:39:21 +02002668 */
Holger Schurigce470613c2009-10-13 13:28:13 +02002669void cfg80211_send_deauth(struct net_device *dev, const u8 *buf, size_t len);
2670
2671/**
2672 * __cfg80211_send_deauth - notification of processed deauthentication
2673 * @dev: network device
2674 * @buf: deauthentication frame (header + body)
2675 * @len: length of the frame data
2676 *
2677 * Like cfg80211_send_deauth(), but doesn't take the wdev lock.
2678 */
2679void __cfg80211_send_deauth(struct net_device *dev, const u8 *buf, size_t len);
Jouni Malinen6039f6d2009-03-19 13:39:21 +02002680
2681/**
Jouni Malinen53b46b82009-03-27 20:53:56 +02002682 * cfg80211_send_disassoc - notification of processed disassociation
Jouni Malinen6039f6d2009-03-19 13:39:21 +02002683 * @dev: network device
2684 * @buf: disassociation response frame (header + body)
2685 * @len: length of the frame data
2686 *
2687 * This function is called whenever disassociation has been processed in
Jouni Malinen53b46b82009-03-27 20:53:56 +02002688 * station mode. This includes both received disassociation frames and locally
Johannes Bergcb0b4be2009-07-07 03:56:07 +02002689 * generated ones. This function may sleep.
Jouni Malinen6039f6d2009-03-19 13:39:21 +02002690 */
Holger Schurigce470613c2009-10-13 13:28:13 +02002691void cfg80211_send_disassoc(struct net_device *dev, const u8 *buf, size_t len);
2692
2693/**
2694 * __cfg80211_send_disassoc - notification of processed disassociation
2695 * @dev: network device
2696 * @buf: disassociation response frame (header + body)
2697 * @len: length of the frame data
2698 *
2699 * Like cfg80211_send_disassoc(), but doesn't take the wdev lock.
2700 */
2701void __cfg80211_send_disassoc(struct net_device *dev, const u8 *buf,
2702 size_t len);
Jouni Malinen6039f6d2009-03-19 13:39:21 +02002703
Kalle Valoa08c1c12009-03-22 21:57:28 +02002704/**
Jouni Malinencf4e5942010-12-16 00:52:40 +02002705 * cfg80211_send_unprot_deauth - notification of unprotected deauthentication
2706 * @dev: network device
2707 * @buf: deauthentication frame (header + body)
2708 * @len: length of the frame data
2709 *
2710 * This function is called whenever a received Deauthentication frame has been
2711 * dropped in station mode because of MFP being used but the Deauthentication
2712 * frame was not protected. This function may sleep.
2713 */
2714void cfg80211_send_unprot_deauth(struct net_device *dev, const u8 *buf,
2715 size_t len);
2716
2717/**
2718 * cfg80211_send_unprot_disassoc - notification of unprotected disassociation
2719 * @dev: network device
2720 * @buf: disassociation frame (header + body)
2721 * @len: length of the frame data
2722 *
2723 * This function is called whenever a received Disassociation frame has been
2724 * dropped in station mode because of MFP being used but the Disassociation
2725 * frame was not protected. This function may sleep.
2726 */
2727void cfg80211_send_unprot_disassoc(struct net_device *dev, const u8 *buf,
2728 size_t len);
2729
2730/**
Jouni Malinena3b8b052009-03-27 21:59:49 +02002731 * cfg80211_michael_mic_failure - notification of Michael MIC failure (TKIP)
2732 * @dev: network device
2733 * @addr: The source MAC address of the frame
2734 * @key_type: The key type that the received frame used
Arik Nemtsova66b98d2011-06-23 00:00:24 +03002735 * @key_id: Key identifier (0..3). Can be -1 if missing.
Jouni Malinena3b8b052009-03-27 21:59:49 +02002736 * @tsc: The TSC value of the frame that generated the MIC failure (6 octets)
Johannes Berge6d6e342009-07-01 21:26:47 +02002737 * @gfp: allocation flags
Jouni Malinena3b8b052009-03-27 21:59:49 +02002738 *
2739 * This function is called whenever the local MAC detects a MIC failure in a
2740 * received frame. This matches with MLME-MICHAELMICFAILURE.indication()
2741 * primitive.
2742 */
2743void cfg80211_michael_mic_failure(struct net_device *dev, const u8 *addr,
2744 enum nl80211_key_type key_type, int key_id,
Johannes Berge6d6e342009-07-01 21:26:47 +02002745 const u8 *tsc, gfp_t gfp);
Jouni Malinena3b8b052009-03-27 21:59:49 +02002746
Johannes Berg04a773a2009-04-19 21:24:32 +02002747/**
2748 * cfg80211_ibss_joined - notify cfg80211 that device joined an IBSS
2749 *
2750 * @dev: network device
2751 * @bssid: the BSSID of the IBSS joined
2752 * @gfp: allocation flags
2753 *
2754 * This function notifies cfg80211 that the device joined an IBSS or
2755 * switched to a different BSSID. Before this function can be called,
2756 * either a beacon has to have been received from the IBSS, or one of
2757 * the cfg80211_inform_bss{,_frame} functions must have been called
2758 * with the locally generated beacon -- this guarantees that there is
2759 * always a scan result for this IBSS. cfg80211 will handle the rest.
2760 */
2761void cfg80211_ibss_joined(struct net_device *dev, const u8 *bssid, gfp_t gfp);
2762
Johannes Berg1f87f7d2009-06-02 13:01:41 +02002763/**
Javier Cardonac93b5e72011-04-07 15:08:34 -07002764 * cfg80211_notify_new_candidate - notify cfg80211 of a new mesh peer candidate
2765 *
2766 * @dev: network device
2767 * @macaddr: the MAC address of the new candidate
2768 * @ie: information elements advertised by the peer candidate
2769 * @ie_len: lenght of the information elements buffer
2770 * @gfp: allocation flags
2771 *
2772 * This function notifies cfg80211 that the mesh peer candidate has been
2773 * detected, most likely via a beacon or, less likely, via a probe response.
2774 * cfg80211 then sends a notification to userspace.
2775 */
2776void cfg80211_notify_new_peer_candidate(struct net_device *dev,
2777 const u8 *macaddr, const u8 *ie, u8 ie_len, gfp_t gfp);
2778
2779/**
Johannes Bergd70e9692010-08-19 16:11:27 +02002780 * DOC: RFkill integration
2781 *
2782 * RFkill integration in cfg80211 is almost invisible to drivers,
2783 * as cfg80211 automatically registers an rfkill instance for each
2784 * wireless device it knows about. Soft kill is also translated
2785 * into disconnecting and turning all interfaces off, drivers are
2786 * expected to turn off the device when all interfaces are down.
2787 *
2788 * However, devices may have a hard RFkill line, in which case they
2789 * also need to interact with the rfkill subsystem, via cfg80211.
2790 * They can do this with a few helper functions documented here.
2791 */
2792
2793/**
Johannes Berg1f87f7d2009-06-02 13:01:41 +02002794 * wiphy_rfkill_set_hw_state - notify cfg80211 about hw block state
2795 * @wiphy: the wiphy
2796 * @blocked: block status
2797 */
2798void wiphy_rfkill_set_hw_state(struct wiphy *wiphy, bool blocked);
2799
2800/**
2801 * wiphy_rfkill_start_polling - start polling rfkill
2802 * @wiphy: the wiphy
2803 */
2804void wiphy_rfkill_start_polling(struct wiphy *wiphy);
2805
2806/**
2807 * wiphy_rfkill_stop_polling - stop polling rfkill
2808 * @wiphy: the wiphy
2809 */
2810void wiphy_rfkill_stop_polling(struct wiphy *wiphy);
2811
Johannes Bergaff89a92009-07-01 21:26:51 +02002812#ifdef CONFIG_NL80211_TESTMODE
2813/**
Johannes Bergd70e9692010-08-19 16:11:27 +02002814 * DOC: Test mode
2815 *
2816 * Test mode is a set of utility functions to allow drivers to
2817 * interact with driver-specific tools to aid, for instance,
2818 * factory programming.
2819 *
2820 * This chapter describes how drivers interact with it, for more
2821 * information see the nl80211 book's chapter on it.
2822 */
2823
2824/**
Johannes Bergaff89a92009-07-01 21:26:51 +02002825 * cfg80211_testmode_alloc_reply_skb - allocate testmode reply
2826 * @wiphy: the wiphy
2827 * @approxlen: an upper bound of the length of the data that will
2828 * be put into the skb
2829 *
2830 * This function allocates and pre-fills an skb for a reply to
2831 * the testmode command. Since it is intended for a reply, calling
2832 * it outside of the @testmode_cmd operation is invalid.
2833 *
2834 * The returned skb (or %NULL if any errors happen) is pre-filled
2835 * with the wiphy index and set up in a way that any data that is
2836 * put into the skb (with skb_put(), nla_put() or similar) will end
2837 * up being within the %NL80211_ATTR_TESTDATA attribute, so all that
2838 * needs to be done with the skb is adding data for the corresponding
2839 * userspace tool which can then read that data out of the testdata
2840 * attribute. You must not modify the skb in any other way.
2841 *
2842 * When done, call cfg80211_testmode_reply() with the skb and return
2843 * its error code as the result of the @testmode_cmd operation.
2844 */
2845struct sk_buff *cfg80211_testmode_alloc_reply_skb(struct wiphy *wiphy,
2846 int approxlen);
2847
2848/**
2849 * cfg80211_testmode_reply - send the reply skb
2850 * @skb: The skb, must have been allocated with
2851 * cfg80211_testmode_alloc_reply_skb()
2852 *
2853 * Returns an error code or 0 on success, since calling this
2854 * function will usually be the last thing before returning
2855 * from the @testmode_cmd you should return the error code.
2856 * Note that this function consumes the skb regardless of the
2857 * return value.
2858 */
2859int cfg80211_testmode_reply(struct sk_buff *skb);
2860
2861/**
2862 * cfg80211_testmode_alloc_event_skb - allocate testmode event
2863 * @wiphy: the wiphy
2864 * @approxlen: an upper bound of the length of the data that will
2865 * be put into the skb
2866 * @gfp: allocation flags
2867 *
2868 * This function allocates and pre-fills an skb for an event on the
2869 * testmode multicast group.
2870 *
2871 * The returned skb (or %NULL if any errors happen) is set up in the
2872 * same way as with cfg80211_testmode_alloc_reply_skb() but prepared
2873 * for an event. As there, you should simply add data to it that will
2874 * then end up in the %NL80211_ATTR_TESTDATA attribute. Again, you must
2875 * not modify the skb in any other way.
2876 *
2877 * When done filling the skb, call cfg80211_testmode_event() with the
2878 * skb to send the event.
2879 */
2880struct sk_buff *cfg80211_testmode_alloc_event_skb(struct wiphy *wiphy,
2881 int approxlen, gfp_t gfp);
2882
2883/**
2884 * cfg80211_testmode_event - send the event
2885 * @skb: The skb, must have been allocated with
2886 * cfg80211_testmode_alloc_event_skb()
2887 * @gfp: allocation flags
2888 *
2889 * This function sends the given @skb, which must have been allocated
2890 * by cfg80211_testmode_alloc_event_skb(), as an event. It always
2891 * consumes it.
2892 */
2893void cfg80211_testmode_event(struct sk_buff *skb, gfp_t gfp);
2894
2895#define CFG80211_TESTMODE_CMD(cmd) .testmode_cmd = (cmd),
Wey-Yi Guy71063f02011-05-20 09:05:54 -07002896#define CFG80211_TESTMODE_DUMP(cmd) .testmode_dump = (cmd),
Johannes Bergaff89a92009-07-01 21:26:51 +02002897#else
2898#define CFG80211_TESTMODE_CMD(cmd)
Wey-Yi Guy71063f02011-05-20 09:05:54 -07002899#define CFG80211_TESTMODE_DUMP(cmd)
Johannes Bergaff89a92009-07-01 21:26:51 +02002900#endif
2901
Samuel Ortizb23aa672009-07-01 21:26:54 +02002902/**
2903 * cfg80211_connect_result - notify cfg80211 of connection result
2904 *
2905 * @dev: network device
2906 * @bssid: the BSSID of the AP
2907 * @req_ie: association request IEs (maybe be %NULL)
2908 * @req_ie_len: association request IEs length
2909 * @resp_ie: association response IEs (may be %NULL)
2910 * @resp_ie_len: assoc response IEs length
2911 * @status: status code, 0 for successful connection, use
2912 * %WLAN_STATUS_UNSPECIFIED_FAILURE if your device cannot give you
2913 * the real status code for failures.
2914 * @gfp: allocation flags
2915 *
2916 * It should be called by the underlying driver whenever connect() has
2917 * succeeded.
2918 */
2919void cfg80211_connect_result(struct net_device *dev, const u8 *bssid,
2920 const u8 *req_ie, size_t req_ie_len,
2921 const u8 *resp_ie, size_t resp_ie_len,
2922 u16 status, gfp_t gfp);
2923
2924/**
2925 * cfg80211_roamed - notify cfg80211 of roaming
2926 *
2927 * @dev: network device
Jouni Malinened9d0102011-05-16 19:40:15 +03002928 * @channel: the channel of the new AP
Samuel Ortizb23aa672009-07-01 21:26:54 +02002929 * @bssid: the BSSID of the new AP
2930 * @req_ie: association request IEs (maybe be %NULL)
2931 * @req_ie_len: association request IEs length
2932 * @resp_ie: association response IEs (may be %NULL)
2933 * @resp_ie_len: assoc response IEs length
2934 * @gfp: allocation flags
2935 *
2936 * It should be called by the underlying driver whenever it roamed
2937 * from one AP to another while connected.
2938 */
Jouni Malinened9d0102011-05-16 19:40:15 +03002939void cfg80211_roamed(struct net_device *dev,
2940 struct ieee80211_channel *channel,
2941 const u8 *bssid,
Samuel Ortizb23aa672009-07-01 21:26:54 +02002942 const u8 *req_ie, size_t req_ie_len,
2943 const u8 *resp_ie, size_t resp_ie_len, gfp_t gfp);
2944
2945/**
2946 * cfg80211_disconnected - notify cfg80211 that connection was dropped
2947 *
2948 * @dev: network device
2949 * @ie: information elements of the deauth/disassoc frame (may be %NULL)
2950 * @ie_len: length of IEs
2951 * @reason: reason code for the disconnection, set it to 0 if unknown
2952 * @gfp: allocation flags
2953 *
2954 * After it calls this function, the driver should enter an idle state
2955 * and not try to connect to any AP any more.
2956 */
2957void cfg80211_disconnected(struct net_device *dev, u16 reason,
2958 u8 *ie, size_t ie_len, gfp_t gfp);
2959
Jouni Malinen9588bbd2009-12-23 13:15:41 +01002960/**
2961 * cfg80211_ready_on_channel - notification of remain_on_channel start
2962 * @dev: network device
2963 * @cookie: the request cookie
2964 * @chan: The current channel (from remain_on_channel request)
2965 * @channel_type: Channel type
2966 * @duration: Duration in milliseconds that the driver intents to remain on the
2967 * channel
2968 * @gfp: allocation flags
2969 */
2970void cfg80211_ready_on_channel(struct net_device *dev, u64 cookie,
2971 struct ieee80211_channel *chan,
2972 enum nl80211_channel_type channel_type,
2973 unsigned int duration, gfp_t gfp);
2974
2975/**
2976 * cfg80211_remain_on_channel_expired - remain_on_channel duration expired
2977 * @dev: network device
2978 * @cookie: the request cookie
2979 * @chan: The current channel (from remain_on_channel request)
2980 * @channel_type: Channel type
2981 * @gfp: allocation flags
2982 */
2983void cfg80211_remain_on_channel_expired(struct net_device *dev,
2984 u64 cookie,
2985 struct ieee80211_channel *chan,
2986 enum nl80211_channel_type channel_type,
2987 gfp_t gfp);
Samuel Ortizb23aa672009-07-01 21:26:54 +02002988
Johannes Berg98b62182009-12-23 13:15:44 +01002989
2990/**
2991 * cfg80211_new_sta - notify userspace about station
2992 *
2993 * @dev: the netdev
2994 * @mac_addr: the station's address
2995 * @sinfo: the station information
2996 * @gfp: allocation flags
2997 */
2998void cfg80211_new_sta(struct net_device *dev, const u8 *mac_addr,
2999 struct station_info *sinfo, gfp_t gfp);
3000
Jouni Malinen026331c2010-02-15 12:53:10 +02003001/**
Jouni Malinenec15e682011-03-23 15:29:52 +02003002 * cfg80211_del_sta - notify userspace about deletion of a station
3003 *
3004 * @dev: the netdev
3005 * @mac_addr: the station's address
3006 * @gfp: allocation flags
3007 */
3008void cfg80211_del_sta(struct net_device *dev, const u8 *mac_addr, gfp_t gfp);
3009
3010/**
Johannes Berg2e161f72010-08-12 15:38:38 +02003011 * cfg80211_rx_mgmt - notification of received, unprocessed management frame
Jouni Malinen026331c2010-02-15 12:53:10 +02003012 * @dev: network device
3013 * @freq: Frequency on which the frame was received in MHz
Johannes Berg2e161f72010-08-12 15:38:38 +02003014 * @buf: Management frame (header + body)
Jouni Malinen026331c2010-02-15 12:53:10 +02003015 * @len: length of the frame data
3016 * @gfp: context flags
Johannes Berg2e161f72010-08-12 15:38:38 +02003017 *
3018 * Returns %true if a user space application has registered for this frame.
3019 * For action frames, that makes it responsible for rejecting unrecognized
3020 * action frames; %false otherwise, in which case for action frames the
3021 * driver is responsible for rejecting the frame.
Jouni Malinen026331c2010-02-15 12:53:10 +02003022 *
3023 * This function is called whenever an Action frame is received for a station
3024 * mode interface, but is not processed in kernel.
3025 */
Johannes Berg2e161f72010-08-12 15:38:38 +02003026bool cfg80211_rx_mgmt(struct net_device *dev, int freq, const u8 *buf,
3027 size_t len, gfp_t gfp);
Jouni Malinen026331c2010-02-15 12:53:10 +02003028
3029/**
Johannes Berg2e161f72010-08-12 15:38:38 +02003030 * cfg80211_mgmt_tx_status - notification of TX status for management frame
Jouni Malinen026331c2010-02-15 12:53:10 +02003031 * @dev: network device
Johannes Berg2e161f72010-08-12 15:38:38 +02003032 * @cookie: Cookie returned by cfg80211_ops::mgmt_tx()
3033 * @buf: Management frame (header + body)
Jouni Malinen026331c2010-02-15 12:53:10 +02003034 * @len: length of the frame data
3035 * @ack: Whether frame was acknowledged
3036 * @gfp: context flags
3037 *
Johannes Berg2e161f72010-08-12 15:38:38 +02003038 * This function is called whenever a management frame was requested to be
3039 * transmitted with cfg80211_ops::mgmt_tx() to report the TX status of the
Jouni Malinen026331c2010-02-15 12:53:10 +02003040 * transmission attempt.
3041 */
Johannes Berg2e161f72010-08-12 15:38:38 +02003042void cfg80211_mgmt_tx_status(struct net_device *dev, u64 cookie,
3043 const u8 *buf, size_t len, bool ack, gfp_t gfp);
Jouni Malinen026331c2010-02-15 12:53:10 +02003044
Juuso Oikarinend6dc1a32010-03-23 09:02:33 +02003045
3046/**
3047 * cfg80211_cqm_rssi_notify - connection quality monitoring rssi event
3048 * @dev: network device
3049 * @rssi_event: the triggered RSSI event
3050 * @gfp: context flags
3051 *
3052 * This function is called when a configured connection quality monitoring
3053 * rssi threshold reached event occurs.
3054 */
3055void cfg80211_cqm_rssi_notify(struct net_device *dev,
3056 enum nl80211_cqm_rssi_threshold_event rssi_event,
3057 gfp_t gfp);
3058
Johannes Bergc063dbf2010-11-24 08:10:05 +01003059/**
3060 * cfg80211_cqm_pktloss_notify - notify userspace about packetloss to peer
3061 * @dev: network device
3062 * @peer: peer's MAC address
3063 * @num_packets: how many packets were lost -- should be a fixed threshold
3064 * but probably no less than maybe 50, or maybe a throughput dependent
3065 * threshold (to account for temporary interference)
3066 * @gfp: context flags
3067 */
3068void cfg80211_cqm_pktloss_notify(struct net_device *dev,
3069 const u8 *peer, u32 num_packets, gfp_t gfp);
3070
Johannes Berge5497d72011-07-05 16:35:40 +02003071/**
3072 * cfg80211_gtk_rekey_notify - notify userspace about driver rekeying
3073 * @dev: network device
3074 * @bssid: BSSID of AP (to avoid races)
3075 * @replay_ctr: new replay counter
Johannes Bergaf71ff82011-07-09 14:48:30 +02003076 * @gfp: allocation flags
Johannes Berge5497d72011-07-05 16:35:40 +02003077 */
3078void cfg80211_gtk_rekey_notify(struct net_device *dev, const u8 *bssid,
3079 const u8 *replay_ctr, gfp_t gfp);
3080
Joe Perchese1db74f2010-07-26 14:39:57 -07003081/* Logging, debugging and troubleshooting/diagnostic helpers. */
3082
3083/* wiphy_printk helpers, similar to dev_printk */
3084
3085#define wiphy_printk(level, wiphy, format, args...) \
Joe Perches9c376632010-08-20 15:13:59 -07003086 dev_printk(level, &(wiphy)->dev, format, ##args)
Joe Perchese1db74f2010-07-26 14:39:57 -07003087#define wiphy_emerg(wiphy, format, args...) \
Joe Perches9c376632010-08-20 15:13:59 -07003088 dev_emerg(&(wiphy)->dev, format, ##args)
Joe Perchese1db74f2010-07-26 14:39:57 -07003089#define wiphy_alert(wiphy, format, args...) \
Joe Perches9c376632010-08-20 15:13:59 -07003090 dev_alert(&(wiphy)->dev, format, ##args)
Joe Perchese1db74f2010-07-26 14:39:57 -07003091#define wiphy_crit(wiphy, format, args...) \
Joe Perches9c376632010-08-20 15:13:59 -07003092 dev_crit(&(wiphy)->dev, format, ##args)
Joe Perchese1db74f2010-07-26 14:39:57 -07003093#define wiphy_err(wiphy, format, args...) \
Joe Perches9c376632010-08-20 15:13:59 -07003094 dev_err(&(wiphy)->dev, format, ##args)
Joe Perchese1db74f2010-07-26 14:39:57 -07003095#define wiphy_warn(wiphy, format, args...) \
Joe Perches9c376632010-08-20 15:13:59 -07003096 dev_warn(&(wiphy)->dev, format, ##args)
Joe Perchese1db74f2010-07-26 14:39:57 -07003097#define wiphy_notice(wiphy, format, args...) \
Joe Perches9c376632010-08-20 15:13:59 -07003098 dev_notice(&(wiphy)->dev, format, ##args)
Joe Perchese1db74f2010-07-26 14:39:57 -07003099#define wiphy_info(wiphy, format, args...) \
Joe Perches9c376632010-08-20 15:13:59 -07003100 dev_info(&(wiphy)->dev, format, ##args)
Joe Perches073730d2010-07-26 14:40:00 -07003101
Joe Perches9c376632010-08-20 15:13:59 -07003102#define wiphy_debug(wiphy, format, args...) \
Joe Perchese1db74f2010-07-26 14:39:57 -07003103 wiphy_printk(KERN_DEBUG, wiphy, format, ##args)
Joe Perches9c376632010-08-20 15:13:59 -07003104
Joe Perchese1db74f2010-07-26 14:39:57 -07003105#define wiphy_dbg(wiphy, format, args...) \
Joe Perches9c376632010-08-20 15:13:59 -07003106 dev_dbg(&(wiphy)->dev, format, ##args)
Joe Perchese1db74f2010-07-26 14:39:57 -07003107
3108#if defined(VERBOSE_DEBUG)
3109#define wiphy_vdbg wiphy_dbg
3110#else
Joe Perchese1db74f2010-07-26 14:39:57 -07003111#define wiphy_vdbg(wiphy, format, args...) \
3112({ \
3113 if (0) \
3114 wiphy_printk(KERN_DEBUG, wiphy, format, ##args); \
Joe Perches9c376632010-08-20 15:13:59 -07003115 0; \
Joe Perchese1db74f2010-07-26 14:39:57 -07003116})
3117#endif
3118
3119/*
3120 * wiphy_WARN() acts like wiphy_printk(), but with the key difference
3121 * of using a WARN/WARN_ON to get the message out, including the
3122 * file/line information and a backtrace.
3123 */
3124#define wiphy_WARN(wiphy, format, args...) \
3125 WARN(1, "wiphy: %s\n" format, wiphy_name(wiphy), ##args);
3126
Johannes Berg704232c2007-04-23 12:20:05 -07003127#endif /* __NET_CFG80211_H */