blob: 75fa556728ce824451acdc93efa75d3e19fae443 [file] [log] [blame]
Johannes Berg704232c2007-04-23 12:20:05 -07001#ifndef __NET_CFG80211_H
2#define __NET_CFG80211_H
3
4#include <linux/netlink.h>
5#include <linux/skbuff.h>
Johannes Berg55682962007-09-20 13:09:35 -04006#include <linux/nl80211.h>
Johannes Berg2a519312009-02-10 21:25:55 +01007#include <linux/if_ether.h>
8#include <linux/ieee80211.h>
9#include <linux/wireless.h>
10#include <net/iw_handler.h>
Johannes Berg704232c2007-04-23 12:20:05 -070011#include <net/genetlink.h>
Johannes Bergfee52672008-11-26 22:36:31 +010012/* remove once we remove the wext stuff */
13#include <net/iw_handler.h>
Johannes Berg704232c2007-04-23 12:20:05 -070014
15/*
16 * 802.11 configuration in-kernel interface
17 *
Johannes Berg55682962007-09-20 13:09:35 -040018 * Copyright 2006, 2007 Johannes Berg <johannes@sipsolutions.net>
Johannes Berg704232c2007-04-23 12:20:05 -070019 */
20
Luis Carlos Cobo2ec600d2008-02-23 15:17:06 +010021/**
22 * struct vif_params - describes virtual interface parameters
23 * @mesh_id: mesh ID to use
24 * @mesh_id_len: length of the mesh ID
25 */
26struct vif_params {
27 u8 *mesh_id;
28 int mesh_id_len;
29};
30
Andy Green179f8312007-07-10 19:29:38 +020031/* Radiotap header iteration
32 * implemented in net/wireless/radiotap.c
33 * docs in Documentation/networking/radiotap-headers.txt
34 */
35/**
36 * struct ieee80211_radiotap_iterator - tracks walk thru present radiotap args
37 * @rtheader: pointer to the radiotap header we are walking through
38 * @max_length: length of radiotap header in cpu byte ordering
39 * @this_arg_index: IEEE80211_RADIOTAP_... index of current arg
40 * @this_arg: pointer to current radiotap arg
41 * @arg_index: internal next argument index
42 * @arg: internal next argument pointer
43 * @next_bitmap: internal pointer to next present u32
44 * @bitmap_shifter: internal shifter for curr u32 bitmap, b0 set == arg present
45 */
46
47struct ieee80211_radiotap_iterator {
48 struct ieee80211_radiotap_header *rtheader;
49 int max_length;
50 int this_arg_index;
51 u8 *this_arg;
52
53 int arg_index;
54 u8 *arg;
55 __le32 *next_bitmap;
56 u32 bitmap_shifter;
57};
58
59extern int ieee80211_radiotap_iterator_init(
60 struct ieee80211_radiotap_iterator *iterator,
61 struct ieee80211_radiotap_header *radiotap_header,
62 int max_length);
63
64extern int ieee80211_radiotap_iterator_next(
65 struct ieee80211_radiotap_iterator *iterator);
66
67
Johannes Berg41ade002007-12-19 02:03:29 +010068 /**
69 * struct key_params - key information
70 *
71 * Information about a key
72 *
73 * @key: key material
74 * @key_len: length of key material
75 * @cipher: cipher suite selector
76 * @seq: sequence counter (IV/PN) for TKIP and CCMP keys, only used
77 * with the get_key() callback, must be in little endian,
78 * length given by @seq_len.
79 */
80struct key_params {
81 u8 *key;
82 u8 *seq;
83 int key_len;
84 int seq_len;
85 u32 cipher;
86};
87
Johannes Berged1b6cc2007-12-19 02:03:32 +010088/**
89 * struct beacon_parameters - beacon parameters
90 *
91 * Used to configure the beacon for an interface.
92 *
93 * @head: head portion of beacon (before TIM IE)
94 * or %NULL if not changed
95 * @tail: tail portion of beacon (after TIM IE)
96 * or %NULL if not changed
97 * @interval: beacon interval or zero if not changed
98 * @dtim_period: DTIM period or zero if not changed
99 * @head_len: length of @head
100 * @tail_len: length of @tail
101 */
102struct beacon_parameters {
103 u8 *head, *tail;
104 int interval, dtim_period;
105 int head_len, tail_len;
106};
107
Johannes Berg5727ef12007-12-19 02:03:34 +0100108/**
109 * enum station_flags - station flags
110 *
111 * Station capability flags. Note that these must be the bits
112 * according to the nl80211 flags.
113 *
114 * @STATION_FLAG_CHANGED: station flags were changed
115 * @STATION_FLAG_AUTHORIZED: station is authorized to send frames (802.1X)
116 * @STATION_FLAG_SHORT_PREAMBLE: station is capable of receiving frames
117 * with short preambles
118 * @STATION_FLAG_WME: station is WME/QoS capable
Jouni Malinen5394af42009-01-08 13:31:59 +0200119 * @STATION_FLAG_MFP: station uses management frame protection
Johannes Berg5727ef12007-12-19 02:03:34 +0100120 */
121enum station_flags {
122 STATION_FLAG_CHANGED = 1<<0,
123 STATION_FLAG_AUTHORIZED = 1<<NL80211_STA_FLAG_AUTHORIZED,
124 STATION_FLAG_SHORT_PREAMBLE = 1<<NL80211_STA_FLAG_SHORT_PREAMBLE,
125 STATION_FLAG_WME = 1<<NL80211_STA_FLAG_WME,
Jouni Malinen5394af42009-01-08 13:31:59 +0200126 STATION_FLAG_MFP = 1<<NL80211_STA_FLAG_MFP,
Johannes Berg5727ef12007-12-19 02:03:34 +0100127};
128
129/**
Luis Carlos Cobo2ec600d2008-02-23 15:17:06 +0100130 * enum plink_action - actions to perform in mesh peers
131 *
132 * @PLINK_ACTION_INVALID: action 0 is reserved
133 * @PLINK_ACTION_OPEN: start mesh peer link establishment
134 * @PLINK_ACTION_BLOCL: block traffic from this mesh peer
135 */
136enum plink_actions {
137 PLINK_ACTION_INVALID,
138 PLINK_ACTION_OPEN,
139 PLINK_ACTION_BLOCK,
140};
141
142/**
Johannes Berg5727ef12007-12-19 02:03:34 +0100143 * struct station_parameters - station parameters
144 *
145 * Used to change and create a new station.
146 *
147 * @vlan: vlan interface station should belong to
148 * @supported_rates: supported rates in IEEE 802.11 format
149 * (or NULL for no change)
150 * @supported_rates_len: number of supported rates
151 * @station_flags: station flags (see &enum station_flags)
152 * @listen_interval: listen interval or -1 for no change
153 * @aid: AID or zero for no change
154 */
155struct station_parameters {
156 u8 *supported_rates;
157 struct net_device *vlan;
158 u32 station_flags;
159 int listen_interval;
160 u16 aid;
161 u8 supported_rates_len;
Luis Carlos Cobo2ec600d2008-02-23 15:17:06 +0100162 u8 plink_action;
Jouni Malinen36aedc902008-08-25 11:58:58 +0300163 struct ieee80211_ht_cap *ht_capa;
Johannes Berg5727ef12007-12-19 02:03:34 +0100164};
165
Johannes Bergfd5b74d2007-12-19 02:03:36 +0100166/**
Luis Carlos Cobo2ec600d2008-02-23 15:17:06 +0100167 * enum station_info_flags - station information flags
Johannes Bergfd5b74d2007-12-19 02:03:36 +0100168 *
Luis Carlos Cobo2ec600d2008-02-23 15:17:06 +0100169 * Used by the driver to indicate which info in &struct station_info
170 * it has filled in during get_station() or dump_station().
Johannes Bergfd5b74d2007-12-19 02:03:36 +0100171 *
Luis Carlos Cobo2ec600d2008-02-23 15:17:06 +0100172 * @STATION_INFO_INACTIVE_TIME: @inactive_time filled
173 * @STATION_INFO_RX_BYTES: @rx_bytes filled
174 * @STATION_INFO_TX_BYTES: @tx_bytes filled
175 * @STATION_INFO_LLID: @llid filled
176 * @STATION_INFO_PLID: @plid filled
177 * @STATION_INFO_PLINK_STATE: @plink_state filled
Henning Rogge420e7fa2008-12-11 22:04:19 +0100178 * @STATION_INFO_SIGNAL: @signal filled
179 * @STATION_INFO_TX_BITRATE: @tx_bitrate fields are filled
180 * (tx_bitrate, tx_bitrate_flags and tx_bitrate_mcs)
Jouni Malinen98c8a60a2009-02-17 13:24:57 +0200181 * @STATION_INFO_RX_PACKETS: @rx_packets filled
182 * @STATION_INFO_TX_PACKETS: @tx_packets filled
Johannes Bergfd5b74d2007-12-19 02:03:36 +0100183 */
Luis Carlos Cobo2ec600d2008-02-23 15:17:06 +0100184enum station_info_flags {
185 STATION_INFO_INACTIVE_TIME = 1<<0,
186 STATION_INFO_RX_BYTES = 1<<1,
187 STATION_INFO_TX_BYTES = 1<<2,
188 STATION_INFO_LLID = 1<<3,
189 STATION_INFO_PLID = 1<<4,
190 STATION_INFO_PLINK_STATE = 1<<5,
Henning Rogge420e7fa2008-12-11 22:04:19 +0100191 STATION_INFO_SIGNAL = 1<<6,
192 STATION_INFO_TX_BITRATE = 1<<7,
Jouni Malinen98c8a60a2009-02-17 13:24:57 +0200193 STATION_INFO_RX_PACKETS = 1<<8,
194 STATION_INFO_TX_PACKETS = 1<<9,
Henning Rogge420e7fa2008-12-11 22:04:19 +0100195};
196
197/**
198 * enum station_info_rate_flags - bitrate info flags
199 *
200 * Used by the driver to indicate the specific rate transmission
201 * type for 802.11n transmissions.
202 *
203 * @RATE_INFO_FLAGS_MCS: @tx_bitrate_mcs filled
204 * @RATE_INFO_FLAGS_40_MHZ_WIDTH: 40 Mhz width transmission
205 * @RATE_INFO_FLAGS_SHORT_GI: 400ns guard interval
206 */
207enum rate_info_flags {
208 RATE_INFO_FLAGS_MCS = 1<<0,
209 RATE_INFO_FLAGS_40_MHZ_WIDTH = 1<<1,
210 RATE_INFO_FLAGS_SHORT_GI = 1<<2,
211};
212
213/**
214 * struct rate_info - bitrate information
215 *
216 * Information about a receiving or transmitting bitrate
217 *
218 * @flags: bitflag of flags from &enum rate_info_flags
219 * @mcs: mcs index if struct describes a 802.11n bitrate
220 * @legacy: bitrate in 100kbit/s for 802.11abg
221 */
222struct rate_info {
223 u8 flags;
224 u8 mcs;
225 u16 legacy;
Johannes Bergfd5b74d2007-12-19 02:03:36 +0100226};
227
228/**
Luis Carlos Cobo2ec600d2008-02-23 15:17:06 +0100229 * struct station_info - station information
Johannes Bergfd5b74d2007-12-19 02:03:36 +0100230 *
Luis Carlos Cobo2ec600d2008-02-23 15:17:06 +0100231 * Station information filled by driver for get_station() and dump_station.
Johannes Bergfd5b74d2007-12-19 02:03:36 +0100232 *
Luis Carlos Cobo2ec600d2008-02-23 15:17:06 +0100233 * @filled: bitflag of flags from &enum station_info_flags
Johannes Bergfd5b74d2007-12-19 02:03:36 +0100234 * @inactive_time: time since last station activity (tx/rx) in milliseconds
235 * @rx_bytes: bytes received from this station
236 * @tx_bytes: bytes transmitted to this station
Luis Carlos Cobo2ec600d2008-02-23 15:17:06 +0100237 * @llid: mesh local link id
238 * @plid: mesh peer link id
239 * @plink_state: mesh peer link state
Henning Rogge420e7fa2008-12-11 22:04:19 +0100240 * @signal: signal strength of last received packet in dBm
241 * @txrate: current unicast bitrate to this station
Jouni Malinen98c8a60a2009-02-17 13:24:57 +0200242 * @rx_packets: packets received from this station
243 * @tx_packets: packets transmitted to this station
Johannes Bergfd5b74d2007-12-19 02:03:36 +0100244 */
Luis Carlos Cobo2ec600d2008-02-23 15:17:06 +0100245struct station_info {
Johannes Bergfd5b74d2007-12-19 02:03:36 +0100246 u32 filled;
247 u32 inactive_time;
248 u32 rx_bytes;
249 u32 tx_bytes;
Luis Carlos Cobo2ec600d2008-02-23 15:17:06 +0100250 u16 llid;
251 u16 plid;
252 u8 plink_state;
Henning Rogge420e7fa2008-12-11 22:04:19 +0100253 s8 signal;
254 struct rate_info txrate;
Jouni Malinen98c8a60a2009-02-17 13:24:57 +0200255 u32 rx_packets;
256 u32 tx_packets;
Johannes Bergfd5b74d2007-12-19 02:03:36 +0100257};
258
Michael Wu66f7ac52008-01-31 19:48:22 +0100259/**
260 * enum monitor_flags - monitor flags
261 *
262 * Monitor interface configuration flags. Note that these must be the bits
263 * according to the nl80211 flags.
264 *
265 * @MONITOR_FLAG_FCSFAIL: pass frames with bad FCS
266 * @MONITOR_FLAG_PLCPFAIL: pass frames with bad PLCP
267 * @MONITOR_FLAG_CONTROL: pass control frames
268 * @MONITOR_FLAG_OTHER_BSS: disable BSSID filtering
269 * @MONITOR_FLAG_COOK_FRAMES: report frames after processing
270 */
271enum monitor_flags {
272 MONITOR_FLAG_FCSFAIL = 1<<NL80211_MNTR_FLAG_FCSFAIL,
273 MONITOR_FLAG_PLCPFAIL = 1<<NL80211_MNTR_FLAG_PLCPFAIL,
274 MONITOR_FLAG_CONTROL = 1<<NL80211_MNTR_FLAG_CONTROL,
275 MONITOR_FLAG_OTHER_BSS = 1<<NL80211_MNTR_FLAG_OTHER_BSS,
276 MONITOR_FLAG_COOK_FRAMES = 1<<NL80211_MNTR_FLAG_COOK_FRAMES,
277};
278
Luis Carlos Cobo2ec600d2008-02-23 15:17:06 +0100279/**
280 * enum mpath_info_flags - mesh path information flags
281 *
282 * Used by the driver to indicate which info in &struct mpath_info it has filled
283 * in during get_station() or dump_station().
284 *
285 * MPATH_INFO_FRAME_QLEN: @frame_qlen filled
286 * MPATH_INFO_DSN: @dsn filled
287 * MPATH_INFO_METRIC: @metric filled
288 * MPATH_INFO_EXPTIME: @exptime filled
289 * MPATH_INFO_DISCOVERY_TIMEOUT: @discovery_timeout filled
290 * MPATH_INFO_DISCOVERY_RETRIES: @discovery_retries filled
291 * MPATH_INFO_FLAGS: @flags filled
292 */
293enum mpath_info_flags {
294 MPATH_INFO_FRAME_QLEN = BIT(0),
295 MPATH_INFO_DSN = BIT(1),
296 MPATH_INFO_METRIC = BIT(2),
297 MPATH_INFO_EXPTIME = BIT(3),
298 MPATH_INFO_DISCOVERY_TIMEOUT = BIT(4),
299 MPATH_INFO_DISCOVERY_RETRIES = BIT(5),
300 MPATH_INFO_FLAGS = BIT(6),
301};
302
303/**
304 * struct mpath_info - mesh path information
305 *
306 * Mesh path information filled by driver for get_mpath() and dump_mpath().
307 *
308 * @filled: bitfield of flags from &enum mpath_info_flags
309 * @frame_qlen: number of queued frames for this destination
310 * @dsn: destination sequence number
311 * @metric: metric (cost) of this mesh path
312 * @exptime: expiration time for the mesh path from now, in msecs
313 * @flags: mesh path flags
314 * @discovery_timeout: total mesh path discovery timeout, in msecs
315 * @discovery_retries: mesh path discovery retries
316 */
317struct mpath_info {
318 u32 filled;
319 u32 frame_qlen;
320 u32 dsn;
321 u32 metric;
322 u32 exptime;
323 u32 discovery_timeout;
324 u8 discovery_retries;
325 u8 flags;
326};
327
Jouni Malinen9f1ba902008-08-07 20:07:01 +0300328/**
329 * struct bss_parameters - BSS parameters
330 *
331 * Used to change BSS parameters (mainly for AP mode).
332 *
333 * @use_cts_prot: Whether to use CTS protection
334 * (0 = no, 1 = yes, -1 = do not change)
335 * @use_short_preamble: Whether the use of short preambles is allowed
336 * (0 = no, 1 = yes, -1 = do not change)
337 * @use_short_slot_time: Whether the use of short slot time is allowed
338 * (0 = no, 1 = yes, -1 = do not change)
Jouni Malinen90c97a02008-10-30 16:59:22 +0200339 * @basic_rates: basic rates in IEEE 802.11 format
340 * (or NULL for no change)
341 * @basic_rates_len: number of basic rates
Jouni Malinen9f1ba902008-08-07 20:07:01 +0300342 */
343struct bss_parameters {
344 int use_cts_prot;
345 int use_short_preamble;
346 int use_short_slot_time;
Jouni Malinen90c97a02008-10-30 16:59:22 +0200347 u8 *basic_rates;
348 u8 basic_rates_len;
Jouni Malinen9f1ba902008-08-07 20:07:01 +0300349};
Luis Carlos Cobo2ec600d2008-02-23 15:17:06 +0100350
Luis R. Rodriguezb2e1b302008-09-09 23:19:48 -0700351/**
352 * enum reg_set_by - Indicates who is trying to set the regulatory domain
353 * @REGDOM_SET_BY_INIT: regulatory domain was set by initialization. We will be
354 * using a static world regulatory domain by default.
355 * @REGDOM_SET_BY_CORE: Core queried CRDA for a dynamic world regulatory domain.
356 * @REGDOM_SET_BY_USER: User asked the wireless core to set the
357 * regulatory domain.
358 * @REGDOM_SET_BY_DRIVER: a wireless drivers has hinted to the wireless core
359 * it thinks its knows the regulatory domain we should be in.
360 * @REGDOM_SET_BY_COUNTRY_IE: the wireless core has received an 802.11 country
361 * information element with regulatory information it thinks we
362 * should consider.
363 */
364enum reg_set_by {
365 REGDOM_SET_BY_INIT,
366 REGDOM_SET_BY_CORE,
367 REGDOM_SET_BY_USER,
368 REGDOM_SET_BY_DRIVER,
369 REGDOM_SET_BY_COUNTRY_IE,
370};
371
Luis R. Rodriguez716f9392009-01-22 15:05:51 -0800372/**
373 * enum environment_cap - Environment parsed from country IE
374 * @ENVIRON_ANY: indicates country IE applies to both indoor and
375 * outdoor operation.
376 * @ENVIRON_INDOOR: indicates country IE applies only to indoor operation
377 * @ENVIRON_OUTDOOR: indicates country IE applies only to outdoor operation
378 */
379enum environment_cap {
380 ENVIRON_ANY,
381 ENVIRON_INDOOR,
382 ENVIRON_OUTDOOR,
383};
384
385/**
Luis R. Rodriguez806a9e32009-02-21 00:04:26 -0500386 * struct regulatory_request - used to keep track of regulatory requests
Luis R. Rodriguez716f9392009-01-22 15:05:51 -0800387 *
Luis R. Rodriguez806a9e32009-02-21 00:04:26 -0500388 * @wiphy_idx: this is set if this request's initiator is
Luis R. Rodriguez716f9392009-01-22 15:05:51 -0800389 * %REGDOM_SET_BY_COUNTRY_IE or %REGDOM_SET_BY_DRIVER. This
390 * can be used by the wireless core to deal with conflicts
391 * and potentially inform users of which devices specifically
392 * cased the conflicts.
393 * @initiator: indicates who sent this request, could be any of
394 * of those set in reg_set_by, %REGDOM_SET_BY_*
395 * @alpha2: the ISO / IEC 3166 alpha2 country code of the requested
396 * regulatory domain. We have a few special codes:
397 * 00 - World regulatory domain
398 * 99 - built by driver but a specific alpha2 cannot be determined
399 * 98 - result of an intersection between two regulatory domains
400 * @intersect: indicates whether the wireless core should intersect
401 * the requested regulatory domain with the presently set regulatory
402 * domain.
403 * @country_ie_checksum: checksum of the last processed and accepted
404 * country IE
405 * @country_ie_env: lets us know if the AP is telling us we are outdoor,
406 * indoor, or if it doesn't matter
Luis R. Rodriguezfe33eb32009-02-21 00:04:30 -0500407 * @list: used to insert into the reg_requests_list linked list
Luis R. Rodriguez716f9392009-01-22 15:05:51 -0800408 */
409struct regulatory_request {
Luis R. Rodriguez806a9e32009-02-21 00:04:26 -0500410 int wiphy_idx;
Luis R. Rodriguez716f9392009-01-22 15:05:51 -0800411 enum reg_set_by initiator;
412 char alpha2[2];
413 bool intersect;
414 u32 country_ie_checksum;
415 enum environment_cap country_ie_env;
Luis R. Rodriguezfe33eb32009-02-21 00:04:30 -0500416 struct list_head list;
Luis R. Rodriguez716f9392009-01-22 15:05:51 -0800417};
418
Luis R. Rodriguezb2e1b302008-09-09 23:19:48 -0700419struct ieee80211_freq_range {
420 u32 start_freq_khz;
421 u32 end_freq_khz;
422 u32 max_bandwidth_khz;
423};
424
425struct ieee80211_power_rule {
426 u32 max_antenna_gain;
427 u32 max_eirp;
428};
429
430struct ieee80211_reg_rule {
431 struct ieee80211_freq_range freq_range;
432 struct ieee80211_power_rule power_rule;
433 u32 flags;
434};
435
436struct ieee80211_regdomain {
437 u32 n_reg_rules;
438 char alpha2[2];
439 struct ieee80211_reg_rule reg_rules[];
440};
441
Luis R. Rodriguezb219cee2008-10-30 13:33:55 -0700442#define MHZ_TO_KHZ(freq) ((freq) * 1000)
443#define KHZ_TO_MHZ(freq) ((freq) / 1000)
444#define DBI_TO_MBI(gain) ((gain) * 100)
445#define MBI_TO_DBI(gain) ((gain) / 100)
446#define DBM_TO_MBM(gain) ((gain) * 100)
447#define MBM_TO_DBM(gain) ((gain) / 100)
Luis R. Rodriguezb2e1b302008-09-09 23:19:48 -0700448
449#define REG_RULE(start, end, bw, gain, eirp, reg_flags) { \
Luis R. Rodriguezb219cee2008-10-30 13:33:55 -0700450 .freq_range.start_freq_khz = MHZ_TO_KHZ(start), \
451 .freq_range.end_freq_khz = MHZ_TO_KHZ(end), \
452 .freq_range.max_bandwidth_khz = MHZ_TO_KHZ(bw), \
453 .power_rule.max_antenna_gain = DBI_TO_MBI(gain), \
454 .power_rule.max_eirp = DBM_TO_MBM(eirp), \
Luis R. Rodriguezb2e1b302008-09-09 23:19:48 -0700455 .flags = reg_flags, \
456 }
457
colin@cozybit.com93da9cc2008-10-21 12:03:48 -0700458struct mesh_config {
459 /* Timeouts in ms */
460 /* Mesh plink management parameters */
461 u16 dot11MeshRetryTimeout;
462 u16 dot11MeshConfirmTimeout;
463 u16 dot11MeshHoldingTimeout;
464 u16 dot11MeshMaxPeerLinks;
465 u8 dot11MeshMaxRetries;
466 u8 dot11MeshTTL;
467 bool auto_open_plinks;
468 /* HWMP parameters */
469 u8 dot11MeshHWMPmaxPREQretries;
470 u32 path_refresh_time;
471 u16 min_discovery_timeout;
472 u32 dot11MeshHWMPactivePathTimeout;
473 u16 dot11MeshHWMPpreqMinInterval;
474 u16 dot11MeshHWMPnetDiameterTraversalTime;
475};
476
Jouni Malinen31888482008-10-30 16:59:24 +0200477/**
478 * struct ieee80211_txq_params - TX queue parameters
479 * @queue: TX queue identifier (NL80211_TXQ_Q_*)
480 * @txop: Maximum burst time in units of 32 usecs, 0 meaning disabled
481 * @cwmin: Minimum contention window [a value of the form 2^n-1 in the range
482 * 1..32767]
483 * @cwmax: Maximum contention window [a value of the form 2^n-1 in the range
484 * 1..32767]
485 * @aifs: Arbitration interframe space [0..255]
486 */
487struct ieee80211_txq_params {
488 enum nl80211_txq_q queue;
489 u16 txop;
490 u16 cwmin;
491 u16 cwmax;
492 u8 aifs;
493};
494
Jouni Malinen9aed3cc2009-01-13 16:03:29 +0200495/**
496 * struct mgmt_extra_ie_params - Extra management frame IE parameters
497 *
498 * Used to add extra IE(s) into management frames. If the driver cannot add the
499 * requested data into all management frames of the specified subtype that are
500 * generated in kernel or firmware/hardware, it must reject the configuration
501 * call. The IE data buffer is added to the end of the specified management
502 * frame body after all other IEs. This addition is not applied to frames that
503 * are injected through a monitor interface.
504 *
505 * @subtype: Management frame subtype
506 * @ies: IE data buffer or %NULL to remove previous data
507 * @ies_len: Length of @ies in octets
508 */
509struct mgmt_extra_ie_params {
510 u8 subtype;
511 u8 *ies;
512 int ies_len;
513};
514
Johannes Berg704232c2007-04-23 12:20:05 -0700515/* from net/wireless.h */
516struct wiphy;
517
Jouni Malinen72bdcf32008-11-26 16:15:24 +0200518/* from net/ieee80211.h */
519struct ieee80211_channel;
520
Johannes Berg704232c2007-04-23 12:20:05 -0700521/**
Johannes Berg2a519312009-02-10 21:25:55 +0100522 * struct cfg80211_ssid - SSID description
523 * @ssid: the SSID
524 * @ssid_len: length of the ssid
525 */
526struct cfg80211_ssid {
527 u8 ssid[IEEE80211_MAX_SSID_LEN];
528 u8 ssid_len;
529};
530
531/**
532 * struct cfg80211_scan_request - scan request description
533 *
534 * @ssids: SSIDs to scan for (active scan only)
535 * @n_ssids: number of SSIDs
536 * @channels: channels to scan on.
537 * @n_channels: number of channels for each band
Jouni Malinen70692ad2009-02-16 19:39:13 +0200538 * @ie: optional information element(s) to add into Probe Request or %NULL
539 * @ie_len: length of ie in octets
Johannes Berg2a519312009-02-10 21:25:55 +0100540 * @wiphy: the wiphy this was for
541 * @ifidx: the interface index
542 */
543struct cfg80211_scan_request {
544 struct cfg80211_ssid *ssids;
545 int n_ssids;
546 struct ieee80211_channel **channels;
547 u32 n_channels;
Jouni Malinen70692ad2009-02-16 19:39:13 +0200548 u8 *ie;
549 size_t ie_len;
Johannes Berg2a519312009-02-10 21:25:55 +0100550
551 /* internal */
552 struct wiphy *wiphy;
553 int ifidx;
554};
555
556/**
557 * enum cfg80211_signal_type - signal type
558 *
559 * @CFG80211_SIGNAL_TYPE_NONE: no signal strength information available
560 * @CFG80211_SIGNAL_TYPE_MBM: signal strength in mBm (100*dBm)
561 * @CFG80211_SIGNAL_TYPE_UNSPEC: signal strength, increasing from 0 through 100
562 */
563enum cfg80211_signal_type {
564 CFG80211_SIGNAL_TYPE_NONE,
565 CFG80211_SIGNAL_TYPE_MBM,
566 CFG80211_SIGNAL_TYPE_UNSPEC,
567};
568
569/**
570 * struct cfg80211_bss - BSS description
571 *
572 * This structure describes a BSS (which may also be a mesh network)
573 * for use in scan results and similar.
574 *
575 * @bssid: BSSID of the BSS
576 * @tsf: timestamp of last received update
577 * @beacon_interval: the beacon interval as from the frame
578 * @capability: the capability field in host byte order
579 * @information_elements: the information elements (Note that there
580 * is no guarantee that these are well-formed!)
581 * @len_information_elements: total length of the information elements
Johannes Berg77965c92009-02-18 18:45:06 +0100582 * @signal: signal strength value (type depends on the wiphy's signal_type)
Johannes Berg78c1c7e2009-02-10 21:25:57 +0100583 * @free_priv: function pointer to free private data
Johannes Berg2a519312009-02-10 21:25:55 +0100584 * @priv: private area for driver use, has at least wiphy->bss_priv_size bytes
585 */
586struct cfg80211_bss {
587 struct ieee80211_channel *channel;
588
589 u8 bssid[ETH_ALEN];
590 u64 tsf;
591 u16 beacon_interval;
592 u16 capability;
593 u8 *information_elements;
594 size_t len_information_elements;
595
596 s32 signal;
Johannes Berg2a519312009-02-10 21:25:55 +0100597
Johannes Berg78c1c7e2009-02-10 21:25:57 +0100598 void (*free_priv)(struct cfg80211_bss *bss);
Johannes Berg2a519312009-02-10 21:25:55 +0100599 u8 priv[0] __attribute__((__aligned__(sizeof(void *))));
600};
601
602/**
Johannes Berg704232c2007-04-23 12:20:05 -0700603 * struct cfg80211_ops - backend description for wireless configuration
604 *
605 * This struct is registered by fullmac card drivers and/or wireless stacks
606 * in order to handle configuration requests on their interfaces.
607 *
608 * All callbacks except where otherwise noted should return 0
609 * on success or a negative error code.
610 *
Johannes Berg43fb45cb2007-04-24 14:07:27 -0700611 * All operations are currently invoked under rtnl for consistency with the
612 * wireless extensions but this is subject to reevaluation as soon as this
613 * code is used more widely and we have a first user without wext.
614 *
Johannes Berg0378b3f2009-01-19 11:20:52 -0500615 * @suspend: wiphy device needs to be suspended
616 * @resume: wiphy device needs to be resumed
617 *
Johannes Berg60719ff2008-09-16 14:55:09 +0200618 * @add_virtual_intf: create a new virtual interface with the given name,
619 * must set the struct wireless_dev's iftype.
Johannes Berg704232c2007-04-23 12:20:05 -0700620 *
621 * @del_virtual_intf: remove the virtual interface determined by ifindex.
Johannes Berg55682962007-09-20 13:09:35 -0400622 *
Johannes Berg60719ff2008-09-16 14:55:09 +0200623 * @change_virtual_intf: change type/configuration of virtual interface,
624 * keep the struct wireless_dev's iftype updated.
Johannes Berg55682962007-09-20 13:09:35 -0400625 *
Johannes Berg41ade002007-12-19 02:03:29 +0100626 * @add_key: add a key with the given parameters. @mac_addr will be %NULL
627 * when adding a group key.
628 *
629 * @get_key: get information about the key with the given parameters.
630 * @mac_addr will be %NULL when requesting information for a group
631 * key. All pointers given to the @callback function need not be valid
632 * after it returns.
633 *
634 * @del_key: remove a key given the @mac_addr (%NULL for a group key)
635 * and @key_index
636 *
637 * @set_default_key: set the default key on an interface
Johannes Berged1b6cc2007-12-19 02:03:32 +0100638 *
Jouni Malinen3cfcf6ac2009-01-08 13:32:02 +0200639 * @set_default_mgmt_key: set the default management frame key on an interface
640 *
Johannes Berged1b6cc2007-12-19 02:03:32 +0100641 * @add_beacon: Add a beacon with given parameters, @head, @interval
642 * and @dtim_period will be valid, @tail is optional.
643 * @set_beacon: Change the beacon parameters for an access point mode
644 * interface. This should reject the call when no beacon has been
645 * configured.
646 * @del_beacon: Remove beacon configuration and stop sending the beacon.
Johannes Berg5727ef12007-12-19 02:03:34 +0100647 *
648 * @add_station: Add a new station.
649 *
650 * @del_station: Remove a station; @mac may be NULL to remove all stations.
651 *
652 * @change_station: Modify a given station.
Luis Carlos Cobo2ec600d2008-02-23 15:17:06 +0100653 *
colin@cozybit.com93da9cc2008-10-21 12:03:48 -0700654 * @get_mesh_params: Put the current mesh parameters into *params
655 *
656 * @set_mesh_params: Set mesh parameters.
657 * The mask is a bitfield which tells us which parameters to
658 * set, and which to leave alone.
659 *
Luis Carlos Cobo2ec600d2008-02-23 15:17:06 +0100660 * @set_mesh_cfg: set mesh parameters (by now, just mesh id)
Jouni Malinen9f1ba902008-08-07 20:07:01 +0300661 *
662 * @change_bss: Modify parameters for a given BSS.
Jouni Malinen31888482008-10-30 16:59:24 +0200663 *
664 * @set_txq_params: Set TX queue parameters
Jouni Malinen72bdcf32008-11-26 16:15:24 +0200665 *
666 * @set_channel: Set channel
Jouni Malinen9aed3cc2009-01-13 16:03:29 +0200667 *
668 * @set_mgmt_extra_ie: Set extra IE data for management frames
Johannes Berg2a519312009-02-10 21:25:55 +0100669 *
670 * @scan: Request to do a scan. If returning zero, the scan request is given
671 * the driver, and will be valid until passed to cfg80211_scan_done().
672 * For scan results, call cfg80211_inform_bss(); you can call this outside
673 * the scan/scan_done bracket too.
Johannes Berg704232c2007-04-23 12:20:05 -0700674 */
675struct cfg80211_ops {
Johannes Berg0378b3f2009-01-19 11:20:52 -0500676 int (*suspend)(struct wiphy *wiphy);
677 int (*resume)(struct wiphy *wiphy);
678
Johannes Berg704232c2007-04-23 12:20:05 -0700679 int (*add_virtual_intf)(struct wiphy *wiphy, char *name,
Luis Carlos Cobo2ec600d2008-02-23 15:17:06 +0100680 enum nl80211_iftype type, u32 *flags,
681 struct vif_params *params);
Johannes Berg704232c2007-04-23 12:20:05 -0700682 int (*del_virtual_intf)(struct wiphy *wiphy, int ifindex);
Johannes Berg55682962007-09-20 13:09:35 -0400683 int (*change_virtual_intf)(struct wiphy *wiphy, int ifindex,
Luis Carlos Cobo2ec600d2008-02-23 15:17:06 +0100684 enum nl80211_iftype type, u32 *flags,
685 struct vif_params *params);
Johannes Berg41ade002007-12-19 02:03:29 +0100686
687 int (*add_key)(struct wiphy *wiphy, struct net_device *netdev,
688 u8 key_index, u8 *mac_addr,
689 struct key_params *params);
690 int (*get_key)(struct wiphy *wiphy, struct net_device *netdev,
691 u8 key_index, u8 *mac_addr, void *cookie,
692 void (*callback)(void *cookie, struct key_params*));
693 int (*del_key)(struct wiphy *wiphy, struct net_device *netdev,
694 u8 key_index, u8 *mac_addr);
695 int (*set_default_key)(struct wiphy *wiphy,
696 struct net_device *netdev,
697 u8 key_index);
Jouni Malinen3cfcf6ac2009-01-08 13:32:02 +0200698 int (*set_default_mgmt_key)(struct wiphy *wiphy,
699 struct net_device *netdev,
700 u8 key_index);
Johannes Berged1b6cc2007-12-19 02:03:32 +0100701
702 int (*add_beacon)(struct wiphy *wiphy, struct net_device *dev,
703 struct beacon_parameters *info);
704 int (*set_beacon)(struct wiphy *wiphy, struct net_device *dev,
705 struct beacon_parameters *info);
706 int (*del_beacon)(struct wiphy *wiphy, struct net_device *dev);
Johannes Berg5727ef12007-12-19 02:03:34 +0100707
708
709 int (*add_station)(struct wiphy *wiphy, struct net_device *dev,
710 u8 *mac, struct station_parameters *params);
711 int (*del_station)(struct wiphy *wiphy, struct net_device *dev,
712 u8 *mac);
713 int (*change_station)(struct wiphy *wiphy, struct net_device *dev,
714 u8 *mac, struct station_parameters *params);
Johannes Bergfd5b74d2007-12-19 02:03:36 +0100715 int (*get_station)(struct wiphy *wiphy, struct net_device *dev,
Luis Carlos Cobo2ec600d2008-02-23 15:17:06 +0100716 u8 *mac, struct station_info *sinfo);
717 int (*dump_station)(struct wiphy *wiphy, struct net_device *dev,
718 int idx, u8 *mac, struct station_info *sinfo);
719
720 int (*add_mpath)(struct wiphy *wiphy, struct net_device *dev,
721 u8 *dst, u8 *next_hop);
722 int (*del_mpath)(struct wiphy *wiphy, struct net_device *dev,
723 u8 *dst);
724 int (*change_mpath)(struct wiphy *wiphy, struct net_device *dev,
725 u8 *dst, u8 *next_hop);
726 int (*get_mpath)(struct wiphy *wiphy, struct net_device *dev,
727 u8 *dst, u8 *next_hop,
728 struct mpath_info *pinfo);
729 int (*dump_mpath)(struct wiphy *wiphy, struct net_device *dev,
730 int idx, u8 *dst, u8 *next_hop,
731 struct mpath_info *pinfo);
colin@cozybit.com93da9cc2008-10-21 12:03:48 -0700732 int (*get_mesh_params)(struct wiphy *wiphy,
733 struct net_device *dev,
734 struct mesh_config *conf);
735 int (*set_mesh_params)(struct wiphy *wiphy,
736 struct net_device *dev,
737 const struct mesh_config *nconf, u32 mask);
Jouni Malinen9f1ba902008-08-07 20:07:01 +0300738 int (*change_bss)(struct wiphy *wiphy, struct net_device *dev,
739 struct bss_parameters *params);
Jouni Malinen31888482008-10-30 16:59:24 +0200740
741 int (*set_txq_params)(struct wiphy *wiphy,
742 struct ieee80211_txq_params *params);
Jouni Malinen72bdcf32008-11-26 16:15:24 +0200743
744 int (*set_channel)(struct wiphy *wiphy,
745 struct ieee80211_channel *chan,
Sujith094d05d2008-12-12 11:57:43 +0530746 enum nl80211_channel_type channel_type);
Jouni Malinen9aed3cc2009-01-13 16:03:29 +0200747
748 int (*set_mgmt_extra_ie)(struct wiphy *wiphy,
749 struct net_device *dev,
750 struct mgmt_extra_ie_params *params);
Johannes Berg2a519312009-02-10 21:25:55 +0100751
752 int (*scan)(struct wiphy *wiphy, struct net_device *dev,
753 struct cfg80211_scan_request *request);
Johannes Berg704232c2007-04-23 12:20:05 -0700754};
755
Johannes Bergfee52672008-11-26 22:36:31 +0100756/* temporary wext handlers */
757int cfg80211_wext_giwname(struct net_device *dev,
758 struct iw_request_info *info,
759 char *name, char *extra);
Johannes Berge60c7742008-11-26 23:31:40 +0100760int cfg80211_wext_siwmode(struct net_device *dev, struct iw_request_info *info,
761 u32 *mode, char *extra);
762int cfg80211_wext_giwmode(struct net_device *dev, struct iw_request_info *info,
763 u32 *mode, char *extra);
Johannes Berg2a519312009-02-10 21:25:55 +0100764int cfg80211_wext_siwscan(struct net_device *dev,
765 struct iw_request_info *info,
766 union iwreq_data *wrqu, char *extra);
767int cfg80211_wext_giwscan(struct net_device *dev,
768 struct iw_request_info *info,
769 struct iw_point *data, char *extra);
Johannes Berg4aa188e2009-02-18 19:32:08 +0100770int cfg80211_wext_giwrange(struct net_device *dev,
771 struct iw_request_info *info,
772 struct iw_point *data, char *extra);
Johannes Berg2a519312009-02-10 21:25:55 +0100773
774/**
775 * cfg80211_scan_done - notify that scan finished
776 *
777 * @request: the corresponding scan request
778 * @aborted: set to true if the scan was aborted for any reason,
779 * userspace will be notified of that
780 */
781void cfg80211_scan_done(struct cfg80211_scan_request *request, bool aborted);
782
783/**
784 * cfg80211_inform_bss - inform cfg80211 of a new BSS
785 *
786 * @wiphy: the wiphy reporting the BSS
787 * @bss: the found BSS
Johannes Berg77965c92009-02-18 18:45:06 +0100788 * @signal: the signal strength, type depends on the wiphy's signal_type
Johannes Berg2a519312009-02-10 21:25:55 +0100789 * @gfp: context flags
790 *
791 * This informs cfg80211 that BSS information was found and
792 * the BSS should be updated/added.
793 */
794struct cfg80211_bss*
795cfg80211_inform_bss_frame(struct wiphy *wiphy,
796 struct ieee80211_channel *channel,
797 struct ieee80211_mgmt *mgmt, size_t len,
Johannes Berg77965c92009-02-18 18:45:06 +0100798 s32 signal, gfp_t gfp);
Johannes Berg2a519312009-02-10 21:25:55 +0100799
800struct cfg80211_bss *cfg80211_get_bss(struct wiphy *wiphy,
801 struct ieee80211_channel *channel,
802 const u8 *bssid,
Johannes Berg79420f02009-02-10 21:25:59 +0100803 const u8 *ssid, size_t ssid_len,
804 u16 capa_mask, u16 capa_val);
805static inline struct cfg80211_bss *
806cfg80211_get_ibss(struct wiphy *wiphy,
807 struct ieee80211_channel *channel,
808 const u8 *ssid, size_t ssid_len)
809{
810 return cfg80211_get_bss(wiphy, channel, NULL, ssid, ssid_len,
811 WLAN_CAPABILITY_IBSS, WLAN_CAPABILITY_IBSS);
812}
813
Johannes Berg2a519312009-02-10 21:25:55 +0100814struct cfg80211_bss *cfg80211_get_mesh(struct wiphy *wiphy,
815 struct ieee80211_channel *channel,
816 const u8 *meshid, size_t meshidlen,
817 const u8 *meshcfg);
818void cfg80211_put_bss(struct cfg80211_bss *bss);
Johannes Bergd491af12009-02-10 21:25:58 +0100819/**
820 * cfg80211_unlink_bss - unlink BSS from internal data structures
821 * @wiphy: the wiphy
822 * @bss: the bss to remove
823 *
824 * This function removes the given BSS from the internal data structures
825 * thereby making it no longer show up in scan results etc. Use this
826 * function when you detect a BSS is gone. Normally BSSes will also time
827 * out, so it is not necessary to use this function at all.
828 */
829void cfg80211_unlink_bss(struct wiphy *wiphy, struct cfg80211_bss *bss);
Johannes Bergfee52672008-11-26 22:36:31 +0100830
Johannes Berg704232c2007-04-23 12:20:05 -0700831#endif /* __NET_CFG80211_H */