]> git.ipfire.org Git - thirdparty/iw.git/blob - nl80211.h
update for new scan patch
[thirdparty/iw.git] / nl80211.h
1 #ifndef __LINUX_NL80211_H
2 #define __LINUX_NL80211_H
3 /*
4 * 802.11 netlink interface public header
5 *
6 * Copyright 2006, 2007, 2008 Johannes Berg <johannes@sipsolutions.net>
7 * Copyright 2008 Michael Wu <flamingice@sourmilk.net>
8 * Copyright 2008 Luis Carlos Cobo <luisca@cozybit.com>
9 * Copyright 2008 Michael Buesch <mb@bu3sch.de>
10 * Copyright 2008 Luis R. Rodriguez <lrodriguez@atheros.com>
11 * Copyright 2008 Jouni Malinen <jouni.malinen@atheros.com>
12 * Copyright 2008 Colin McCabe <colin@cozybit.com>
13 *
14 * Permission to use, copy, modify, and/or distribute this software for any
15 * purpose with or without fee is hereby granted, provided that the above
16 * copyright notice and this permission notice appear in all copies.
17 *
18 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
19 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
20 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
21 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
22 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
23 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
24 * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
25 *
26 */
27
28 /**
29 * DOC: Station handling
30 *
31 * Stations are added per interface, but a special case exists with VLAN
32 * interfaces. When a station is bound to an AP interface, it may be moved
33 * into a VLAN identified by a VLAN interface index (%NL80211_ATTR_STA_VLAN).
34 * The station is still assumed to belong to the AP interface it was added
35 * to.
36 *
37 * TODO: need more info?
38 */
39
40 /**
41 * enum nl80211_commands - supported nl80211 commands
42 *
43 * @NL80211_CMD_UNSPEC: unspecified command to catch errors
44 *
45 * @NL80211_CMD_GET_WIPHY: request information about a wiphy or dump request
46 * to get a list of all present wiphys.
47 * @NL80211_CMD_SET_WIPHY: set wiphy parameters, needs %NL80211_ATTR_WIPHY or
48 * %NL80211_ATTR_IFINDEX; can be used to set %NL80211_ATTR_WIPHY_NAME,
49 * %NL80211_ATTR_WIPHY_TXQ_PARAMS, %NL80211_ATTR_WIPHY_FREQ, and/or
50 * %NL80211_ATTR_WIPHY_SEC_CHAN_OFFSET.
51 * @NL80211_CMD_NEW_WIPHY: Newly created wiphy, response to get request
52 * or rename notification. Has attributes %NL80211_ATTR_WIPHY and
53 * %NL80211_ATTR_WIPHY_NAME.
54 * @NL80211_CMD_DEL_WIPHY: Wiphy deleted. Has attributes
55 * %NL80211_ATTR_WIPHY and %NL80211_ATTR_WIPHY_NAME.
56 *
57 * @NL80211_CMD_GET_INTERFACE: Request an interface's configuration;
58 * either a dump request on a %NL80211_ATTR_WIPHY or a specific get
59 * on an %NL80211_ATTR_IFINDEX is supported.
60 * @NL80211_CMD_SET_INTERFACE: Set type of a virtual interface, requires
61 * %NL80211_ATTR_IFINDEX and %NL80211_ATTR_IFTYPE.
62 * @NL80211_CMD_NEW_INTERFACE: Newly created virtual interface or response
63 * to %NL80211_CMD_GET_INTERFACE. Has %NL80211_ATTR_IFINDEX,
64 * %NL80211_ATTR_WIPHY and %NL80211_ATTR_IFTYPE attributes. Can also
65 * be sent from userspace to request creation of a new virtual interface,
66 * then requires attributes %NL80211_ATTR_WIPHY, %NL80211_ATTR_IFTYPE and
67 * %NL80211_ATTR_IFNAME.
68 * @NL80211_CMD_DEL_INTERFACE: Virtual interface was deleted, has attributes
69 * %NL80211_ATTR_IFINDEX and %NL80211_ATTR_WIPHY. Can also be sent from
70 * userspace to request deletion of a virtual interface, then requires
71 * attribute %NL80211_ATTR_IFINDEX.
72 *
73 * @NL80211_CMD_GET_KEY: Get sequence counter information for a key specified
74 * by %NL80211_ATTR_KEY_IDX and/or %NL80211_ATTR_MAC.
75 * @NL80211_CMD_SET_KEY: Set key attributes %NL80211_ATTR_KEY_DEFAULT or
76 * %NL80211_ATTR_KEY_THRESHOLD.
77 * @NL80211_CMD_NEW_KEY: add a key with given %NL80211_ATTR_KEY_DATA,
78 * %NL80211_ATTR_KEY_IDX, %NL80211_ATTR_MAC and %NL80211_ATTR_KEY_CIPHER
79 * attributes.
80 * @NL80211_CMD_DEL_KEY: delete a key identified by %NL80211_ATTR_KEY_IDX
81 * or %NL80211_ATTR_MAC.
82 *
83 * @NL80211_CMD_GET_BEACON: retrieve beacon information (returned in a
84 * %NL80222_CMD_NEW_BEACON message)
85 * @NL80211_CMD_SET_BEACON: set the beacon on an access point interface
86 * using the %NL80211_ATTR_BEACON_INTERVAL, %NL80211_ATTR_DTIM_PERIOD,
87 * %NL80211_BEACON_HEAD and %NL80211_BEACON_TAIL attributes.
88 * @NL80211_CMD_NEW_BEACON: add a new beacon to an access point interface,
89 * parameters are like for %NL80211_CMD_SET_BEACON.
90 * @NL80211_CMD_DEL_BEACON: remove the beacon, stop sending it
91 *
92 * @NL80211_CMD_GET_STATION: Get station attributes for station identified by
93 * %NL80211_ATTR_MAC on the interface identified by %NL80211_ATTR_IFINDEX.
94 * @NL80211_CMD_SET_STATION: Set station attributes for station identified by
95 * %NL80211_ATTR_MAC on the interface identified by %NL80211_ATTR_IFINDEX.
96 * @NL80211_CMD_NEW_STATION: Add a station with given attributes to the
97 * the interface identified by %NL80211_ATTR_IFINDEX.
98 * @NL80211_CMD_DEL_STATION: Remove a station identified by %NL80211_ATTR_MAC
99 * or, if no MAC address given, all stations, on the interface identified
100 * by %NL80211_ATTR_IFINDEX.
101 *
102 * @NL80211_CMD_GET_MPATH: Get mesh path attributes for mesh path to
103 * destination %NL80211_ATTR_MAC on the interface identified by
104 * %NL80211_ATTR_IFINDEX.
105 * @NL80211_CMD_SET_MPATH: Set mesh path attributes for mesh path to
106 * destination %NL80211_ATTR_MAC on the interface identified by
107 * %NL80211_ATTR_IFINDEX.
108 * @NL80211_CMD_NEW_PATH: Add a mesh path with given attributes to the
109 * the interface identified by %NL80211_ATTR_IFINDEX.
110 * @NL80211_CMD_DEL_PATH: Remove a mesh path identified by %NL80211_ATTR_MAC
111 * or, if no MAC address given, all mesh paths, on the interface identified
112 * by %NL80211_ATTR_IFINDEX.
113 * @NL80211_CMD_SET_BSS: Set BSS attributes for BSS identified by
114 * %NL80211_ATTR_IFINDEX.
115 *
116 * @NL80211_CMD_SET_REG: Set current regulatory domain. CRDA sends this command
117 * after being queried by the kernel. CRDA replies by sending a regulatory
118 * domain structure which consists of %NL80211_ATTR_REG_ALPHA set to our
119 * current alpha2 if it found a match. It also provides
120 * NL80211_ATTR_REG_RULE_FLAGS, and a set of regulatory rules. Each
121 * regulatory rule is a nested set of attributes given by
122 * %NL80211_ATTR_REG_RULE_FREQ_[START|END] and
123 * %NL80211_ATTR_FREQ_RANGE_MAX_BW with an attached power rule given by
124 * %NL80211_ATTR_REG_RULE_POWER_MAX_ANT_GAIN and
125 * %NL80211_ATTR_REG_RULE_POWER_MAX_EIRP.
126 * @NL80211_CMD_REQ_SET_REG: ask the wireless core to set the regulatory domain
127 * to the the specified ISO/IEC 3166-1 alpha2 country code. The core will
128 * store this as a valid request and then query userspace for it.
129 *
130 * @NL80211_CMD_GET_MESH_PARAMS: Get mesh networking properties for the
131 * interface identified by %NL80211_ATTR_IFINDEX
132 *
133 * @NL80211_CMD_SET_MESH_PARAMS: Set mesh networking properties for the
134 * interface identified by %NL80211_ATTR_IFINDEX
135 *
136 * @NL80211_CMD_GET_SCAN: get scan results
137 * @NL80211_CMD_TRIGGER_SCAN: trigger a new scan with the given parameters
138 * @NL80211_CMD_NEW_SCAN_RESULTS: scan notification (as a reply to
139 * NL80211_CMD_GET_SCAN and on the "scan" multicast group)
140 * @NL80211_CMD_SCAN_ABORTED: scan was aborted, for unspecified reasons,
141 * partial scan results may be available
142 *
143 * @NL80211_CMD_MAX: highest used command number
144 * @__NL80211_CMD_AFTER_LAST: internal use
145 */
146 enum nl80211_commands {
147 /* don't change the order or add anything inbetween, this is ABI! */
148 NL80211_CMD_UNSPEC,
149
150 NL80211_CMD_GET_WIPHY, /* can dump */
151 NL80211_CMD_SET_WIPHY,
152 NL80211_CMD_NEW_WIPHY,
153 NL80211_CMD_DEL_WIPHY,
154
155 NL80211_CMD_GET_INTERFACE, /* can dump */
156 NL80211_CMD_SET_INTERFACE,
157 NL80211_CMD_NEW_INTERFACE,
158 NL80211_CMD_DEL_INTERFACE,
159
160 NL80211_CMD_GET_KEY,
161 NL80211_CMD_SET_KEY,
162 NL80211_CMD_NEW_KEY,
163 NL80211_CMD_DEL_KEY,
164
165 NL80211_CMD_GET_BEACON,
166 NL80211_CMD_SET_BEACON,
167 NL80211_CMD_NEW_BEACON,
168 NL80211_CMD_DEL_BEACON,
169
170 NL80211_CMD_GET_STATION,
171 NL80211_CMD_SET_STATION,
172 NL80211_CMD_NEW_STATION,
173 NL80211_CMD_DEL_STATION,
174
175 NL80211_CMD_GET_MPATH,
176 NL80211_CMD_SET_MPATH,
177 NL80211_CMD_NEW_MPATH,
178 NL80211_CMD_DEL_MPATH,
179
180 NL80211_CMD_SET_BSS,
181
182 NL80211_CMD_SET_REG,
183 NL80211_CMD_REQ_SET_REG,
184
185 NL80211_CMD_GET_MESH_PARAMS,
186 NL80211_CMD_SET_MESH_PARAMS,
187
188 NL80211_CMD_GET_SCAN,
189 NL80211_CMD_TRIGGER_SCAN,
190 NL80211_CMD_NEW_SCAN_RESULTS,
191 NL80211_CMD_SCAN_ABORTED,
192
193 /* add new commands above here */
194
195 /* used to define NL80211_CMD_MAX below */
196 __NL80211_CMD_AFTER_LAST,
197 NL80211_CMD_MAX = __NL80211_CMD_AFTER_LAST - 1
198 };
199
200 /*
201 * Allow user space programs to use #ifdef on new commands by defining them
202 * here
203 */
204 #define NL80211_CMD_SET_BSS NL80211_CMD_SET_BSS
205
206 /**
207 * enum nl80211_attrs - nl80211 netlink attributes
208 *
209 * @NL80211_ATTR_UNSPEC: unspecified attribute to catch errors
210 *
211 * @NL80211_ATTR_WIPHY: index of wiphy to operate on, cf.
212 * /sys/class/ieee80211/<phyname>/index
213 * @NL80211_ATTR_WIPHY_NAME: wiphy name (used for renaming)
214 * @NL80211_ATTR_WIPHY_TXQ_PARAMS: a nested array of TX queue parameters
215 * @NL80211_ATTR_WIPHY_FREQ: frequency of the selected channel in MHz
216 * @NL80211_ATTR_WIPHY_CHANNEL_TYPE: included with NL80211_ATTR_WIPHY_FREQ
217 * if HT20 or HT40 are allowed (i.e., 802.11n disabled if not included):
218 * NL80211_CHAN_NO_HT = HT not allowed (i.e., same as not including
219 * this attribute)
220 * NL80211_CHAN_HT20 = HT20 only
221 * NL80211_CHAN_HT40MINUS = secondary channel is below the primary channel
222 * NL80211_CHAN_HT40PLUS = secondary channel is above the primary channel
223 *
224 * @NL80211_ATTR_IFINDEX: network interface index of the device to operate on
225 * @NL80211_ATTR_IFNAME: network interface name
226 * @NL80211_ATTR_IFTYPE: type of virtual interface, see &enum nl80211_iftype
227 *
228 * @NL80211_ATTR_MAC: MAC address (various uses)
229 *
230 * @NL80211_ATTR_KEY_DATA: (temporal) key data; for TKIP this consists of
231 * 16 bytes encryption key followed by 8 bytes each for TX and RX MIC
232 * keys
233 * @NL80211_ATTR_KEY_IDX: key ID (u8, 0-3)
234 * @NL80211_ATTR_KEY_CIPHER: key cipher suite (u32, as defined by IEEE 802.11
235 * section 7.3.2.25.1, e.g. 0x000FAC04)
236 * @NL80211_ATTR_KEY_SEQ: transmit key sequence number (IV/PN) for TKIP and
237 * CCMP keys, each six bytes in little endian
238 *
239 * @NL80211_ATTR_BEACON_INTERVAL: beacon interval in TU
240 * @NL80211_ATTR_DTIM_PERIOD: DTIM period for beaconing
241 * @NL80211_ATTR_BEACON_HEAD: portion of the beacon before the TIM IE
242 * @NL80211_ATTR_BEACON_TAIL: portion of the beacon after the TIM IE
243 *
244 * @NL80211_ATTR_STA_AID: Association ID for the station (u16)
245 * @NL80211_ATTR_STA_FLAGS: flags, nested element with NLA_FLAG attributes of
246 * &enum nl80211_sta_flags.
247 * @NL80211_ATTR_STA_LISTEN_INTERVAL: listen interval as defined by
248 * IEEE 802.11 7.3.1.6 (u16).
249 * @NL80211_ATTR_STA_SUPPORTED_RATES: supported rates, array of supported
250 * rates as defined by IEEE 802.11 7.3.2.2 but without the length
251 * restriction (at most %NL80211_MAX_SUPP_RATES).
252 * @NL80211_ATTR_STA_VLAN: interface index of VLAN interface to move station
253 * to, or the AP interface the station was originally added to to.
254 * @NL80211_ATTR_STA_INFO: information about a station, part of station info
255 * given for %NL80211_CMD_GET_STATION, nested attribute containing
256 * info as possible, see &enum nl80211_sta_info.
257 *
258 * @NL80211_ATTR_WIPHY_BANDS: Information about an operating bands,
259 * consisting of a nested array.
260 *
261 * @NL80211_ATTR_MESH_ID: mesh id (1-32 bytes).
262 * @NL80211_ATTR_PLINK_ACTION: action to perform on the mesh peer link.
263 * @NL80211_ATTR_MPATH_NEXT_HOP: MAC address of the next hop for a mesh path.
264 * @NL80211_ATTR_MPATH_INFO: information about a mesh_path, part of mesh path
265 * info given for %NL80211_CMD_GET_MPATH, nested attribute described at
266 * &enum nl80211_mpath_info.
267 *
268 * @NL80211_ATTR_MNTR_FLAGS: flags, nested element with NLA_FLAG attributes of
269 * &enum nl80211_mntr_flags.
270 *
271 * @NL80211_ATTR_REG_ALPHA2: an ISO-3166-alpha2 country code for which the
272 * current regulatory domain should be set to or is already set to.
273 * For example, 'CR', for Costa Rica. This attribute is used by the kernel
274 * to query the CRDA to retrieve one regulatory domain. This attribute can
275 * also be used by userspace to query the kernel for the currently set
276 * regulatory domain. We chose an alpha2 as that is also used by the
277 * IEEE-802.11d country information element to identify a country.
278 * Users can also simply ask the wireless core to set regulatory domain
279 * to a specific alpha2.
280 * @NL80211_ATTR_REG_RULES: a nested array of regulatory domain regulatory
281 * rules.
282 *
283 * @NL80211_ATTR_BSS_CTS_PROT: whether CTS protection is enabled (u8, 0 or 1)
284 * @NL80211_ATTR_BSS_SHORT_PREAMBLE: whether short preamble is enabled
285 * (u8, 0 or 1)
286 * @NL80211_ATTR_BSS_SHORT_SLOT_TIME: whether short slot time enabled
287 * (u8, 0 or 1)
288 * @NL80211_ATTR_BSS_BASIC_RATES: basic rates, array of basic
289 * rates in format defined by IEEE 802.11 7.3.2.2 but without the length
290 * restriction (at most %NL80211_MAX_SUPP_RATES).
291 *
292 * @NL80211_ATTR_HT_CAPABILITY: HT Capability information element (from
293 * association request when used with NL80211_CMD_NEW_STATION)
294 *
295 * @NL80211_ATTR_SUPPORTED_IFTYPES: nested attribute containing all
296 * supported interface types, each a flag attribute with the number
297 * of the interface mode.
298 *
299 * @NL80211_ATTR_MAX_NUM_SCAN_SSIDS: number of SSIDs you can scan with
300 * a single scan request, a wiphy attribute.
301 *
302 * @NL80211_ATTR_SCAN_FREQUENCIES: nested attribute with frequencies (in MHz)
303 * @NL80211_ATTR_SCAN_SSIDS: nested attribute with SSIDs, leave out for passive
304 * scanning and include a zero-length SSID (wildcard) for wildcard scan
305 * @NL80211_ATTR_SCAN_GENERATION: the scan generation increases whenever the
306 * scan result list changes (BSS expired or added) so that applications
307 * can verify that they got a single, consistent snapshot (when all dump
308 * messages carried the same generation number)
309 * @NL80211_ATTR_BSS: scan result BSS
310 *
311 * @NL80211_ATTR_MAX: highest attribute number currently defined
312 * @__NL80211_ATTR_AFTER_LAST: internal use
313 */
314 enum nl80211_attrs {
315 /* don't change the order or add anything inbetween, this is ABI! */
316 NL80211_ATTR_UNSPEC,
317
318 NL80211_ATTR_WIPHY,
319 NL80211_ATTR_WIPHY_NAME,
320
321 NL80211_ATTR_IFINDEX,
322 NL80211_ATTR_IFNAME,
323 NL80211_ATTR_IFTYPE,
324
325 NL80211_ATTR_MAC,
326
327 NL80211_ATTR_KEY_DATA,
328 NL80211_ATTR_KEY_IDX,
329 NL80211_ATTR_KEY_CIPHER,
330 NL80211_ATTR_KEY_SEQ,
331 NL80211_ATTR_KEY_DEFAULT,
332
333 NL80211_ATTR_BEACON_INTERVAL,
334 NL80211_ATTR_DTIM_PERIOD,
335 NL80211_ATTR_BEACON_HEAD,
336 NL80211_ATTR_BEACON_TAIL,
337
338 NL80211_ATTR_STA_AID,
339 NL80211_ATTR_STA_FLAGS,
340 NL80211_ATTR_STA_LISTEN_INTERVAL,
341 NL80211_ATTR_STA_SUPPORTED_RATES,
342 NL80211_ATTR_STA_VLAN,
343 NL80211_ATTR_STA_INFO,
344
345 NL80211_ATTR_WIPHY_BANDS,
346
347 NL80211_ATTR_MNTR_FLAGS,
348
349 NL80211_ATTR_MESH_ID,
350 NL80211_ATTR_STA_PLINK_ACTION,
351 NL80211_ATTR_MPATH_NEXT_HOP,
352 NL80211_ATTR_MPATH_INFO,
353
354 NL80211_ATTR_BSS_CTS_PROT,
355 NL80211_ATTR_BSS_SHORT_PREAMBLE,
356 NL80211_ATTR_BSS_SHORT_SLOT_TIME,
357
358 NL80211_ATTR_HT_CAPABILITY,
359
360 NL80211_ATTR_SUPPORTED_IFTYPES,
361
362 NL80211_ATTR_REG_ALPHA2,
363 NL80211_ATTR_REG_RULES,
364
365 NL80211_ATTR_MESH_PARAMS,
366
367 NL80211_ATTR_BSS_BASIC_RATES,
368
369 NL80211_ATTR_WIPHY_TXQ_PARAMS,
370 NL80211_ATTR_WIPHY_FREQ,
371 NL80211_ATTR_WIPHY_CHANNEL_TYPE,
372
373 NL80211_ATTR_MAX_NUM_SCAN_SSIDS,
374
375 NL80211_ATTR_SCAN_FREQUENCIES,
376 NL80211_ATTR_SCAN_SSIDS,
377 NL80211_ATTR_SCAN_GENERATION,
378 NL80211_ATTR_BSS,
379
380 /* add attributes here, update the policy in nl80211.c */
381
382 __NL80211_ATTR_AFTER_LAST,
383 NL80211_ATTR_MAX = __NL80211_ATTR_AFTER_LAST - 1
384 };
385
386 /*
387 * Allow user space programs to use #ifdef on new attributes by defining them
388 * here
389 */
390 #define NL80211_ATTR_HT_CAPABILITY NL80211_ATTR_HT_CAPABILITY
391 #define NL80211_ATTR_BSS_BASIC_RATES NL80211_ATTR_BSS_BASIC_RATES
392 #define NL80211_ATTR_WIPHY_TXQ_PARAMS NL80211_ATTR_WIPHY_TXQ_PARAMS
393 #define NL80211_ATTR_WIPHY_FREQ NL80211_ATTR_WIPHY_FREQ
394 #define NL80211_ATTR_WIPHY_SEC_CHAN_OFFSET NL80211_ATTR_WIPHY_SEC_CHAN_OFFSET
395
396 #define NL80211_MAX_SUPP_RATES 32
397 #define NL80211_MAX_SUPP_REG_RULES 32
398 #define NL80211_TKIP_DATA_OFFSET_ENCR_KEY 0
399 #define NL80211_TKIP_DATA_OFFSET_TX_MIC_KEY 16
400 #define NL80211_TKIP_DATA_OFFSET_RX_MIC_KEY 24
401 #define NL80211_HT_CAPABILITY_LEN 26
402
403 /**
404 * enum nl80211_iftype - (virtual) interface types
405 *
406 * @NL80211_IFTYPE_UNSPECIFIED: unspecified type, driver decides
407 * @NL80211_IFTYPE_ADHOC: independent BSS member
408 * @NL80211_IFTYPE_STATION: managed BSS member
409 * @NL80211_IFTYPE_AP: access point
410 * @NL80211_IFTYPE_AP_VLAN: VLAN interface for access points
411 * @NL80211_IFTYPE_WDS: wireless distribution interface
412 * @NL80211_IFTYPE_MONITOR: monitor interface receiving all frames
413 * @NL80211_IFTYPE_MESH_POINT: mesh point
414 * @NL80211_IFTYPE_MAX: highest interface type number currently defined
415 * @__NL80211_IFTYPE_AFTER_LAST: internal use
416 *
417 * These values are used with the %NL80211_ATTR_IFTYPE
418 * to set the type of an interface.
419 *
420 */
421 enum nl80211_iftype {
422 NL80211_IFTYPE_UNSPECIFIED,
423 NL80211_IFTYPE_ADHOC,
424 NL80211_IFTYPE_STATION,
425 NL80211_IFTYPE_AP,
426 NL80211_IFTYPE_AP_VLAN,
427 NL80211_IFTYPE_WDS,
428 NL80211_IFTYPE_MONITOR,
429 NL80211_IFTYPE_MESH_POINT,
430
431 /* keep last */
432 __NL80211_IFTYPE_AFTER_LAST,
433 NL80211_IFTYPE_MAX = __NL80211_IFTYPE_AFTER_LAST - 1
434 };
435
436 /**
437 * enum nl80211_sta_flags - station flags
438 *
439 * Station flags. When a station is added to an AP interface, it is
440 * assumed to be already associated (and hence authenticated.)
441 *
442 * @NL80211_STA_FLAG_AUTHORIZED: station is authorized (802.1X)
443 * @NL80211_STA_FLAG_SHORT_PREAMBLE: station is capable of receiving frames
444 * with short barker preamble
445 * @NL80211_STA_FLAG_WME: station is WME/QoS capable
446 */
447 enum nl80211_sta_flags {
448 __NL80211_STA_FLAG_INVALID,
449 NL80211_STA_FLAG_AUTHORIZED,
450 NL80211_STA_FLAG_SHORT_PREAMBLE,
451 NL80211_STA_FLAG_WME,
452
453 /* keep last */
454 __NL80211_STA_FLAG_AFTER_LAST,
455 NL80211_STA_FLAG_MAX = __NL80211_STA_FLAG_AFTER_LAST - 1
456 };
457
458 /**
459 * enum nl80211_rate_info - bitrate information
460 *
461 * These attribute types are used with %NL80211_STA_INFO_TXRATE
462 * when getting information about the bitrate of a station.
463 *
464 * @__NL80211_RATE_INFO_INVALID: attribute number 0 is reserved
465 * @NL80211_RATE_INFO_BITRATE: total bitrate (u16, 100kbit/s)
466 * @NL80211_RATE_INFO_MCS: mcs index for 802.11n (u8)
467 * @NL80211_RATE_INFO_40_MHZ_WIDTH: 40 Mhz dualchannel bitrate
468 * @NL80211_RATE_INFO_SHORT_GI: 400ns guard interval
469 * @NL80211_RATE_INFO_MAX: highest rate_info number currently defined
470 * @__NL80211_RATE_INFO_AFTER_LAST: internal use
471 */
472 enum nl80211_rate_info {
473 __NL80211_RATE_INFO_INVALID,
474 NL80211_RATE_INFO_BITRATE,
475 NL80211_RATE_INFO_MCS,
476 NL80211_RATE_INFO_40_MHZ_WIDTH,
477 NL80211_RATE_INFO_SHORT_GI,
478
479 /* keep last */
480 __NL80211_RATE_INFO_AFTER_LAST,
481 NL80211_RATE_INFO_MAX = __NL80211_RATE_INFO_AFTER_LAST - 1
482 };
483
484 /**
485 * enum nl80211_sta_info - station information
486 *
487 * These attribute types are used with %NL80211_ATTR_STA_INFO
488 * when getting information about a station.
489 *
490 * @__NL80211_STA_INFO_INVALID: attribute number 0 is reserved
491 * @NL80211_STA_INFO_INACTIVE_TIME: time since last activity (u32, msecs)
492 * @NL80211_STA_INFO_RX_BYTES: total received bytes (u32, from this station)
493 * @NL80211_STA_INFO_TX_BYTES: total transmitted bytes (u32, to this station)
494 * @__NL80211_STA_INFO_AFTER_LAST: internal
495 * @NL80211_STA_INFO_MAX: highest possible station info attribute
496 * @NL80211_STA_INFO_SIGNAL: signal strength of last received PPDU (u8, dBm)
497 * @NL80211_STA_INFO_TX_BITRATE: current unicast tx rate, nested attribute
498 * containing info as possible, see &enum nl80211_sta_info_txrate.
499 */
500 enum nl80211_sta_info {
501 __NL80211_STA_INFO_INVALID,
502 NL80211_STA_INFO_INACTIVE_TIME,
503 NL80211_STA_INFO_RX_BYTES,
504 NL80211_STA_INFO_TX_BYTES,
505 NL80211_STA_INFO_LLID,
506 NL80211_STA_INFO_PLID,
507 NL80211_STA_INFO_PLINK_STATE,
508 NL80211_STA_INFO_SIGNAL,
509 NL80211_STA_INFO_TX_BITRATE,
510
511 /* keep last */
512 __NL80211_STA_INFO_AFTER_LAST,
513 NL80211_STA_INFO_MAX = __NL80211_STA_INFO_AFTER_LAST - 1
514 };
515
516 /**
517 * enum nl80211_mpath_flags - nl80211 mesh path flags
518 *
519 * @NL80211_MPATH_FLAG_ACTIVE: the mesh path is active
520 * @NL80211_MPATH_FLAG_RESOLVING: the mesh path discovery process is running
521 * @NL80211_MPATH_FLAG_DSN_VALID: the mesh path contains a valid DSN
522 * @NL80211_MPATH_FLAG_FIXED: the mesh path has been manually set
523 * @NL80211_MPATH_FLAG_RESOLVED: the mesh path discovery process succeeded
524 */
525 enum nl80211_mpath_flags {
526 NL80211_MPATH_FLAG_ACTIVE = 1<<0,
527 NL80211_MPATH_FLAG_RESOLVING = 1<<1,
528 NL80211_MPATH_FLAG_DSN_VALID = 1<<2,
529 NL80211_MPATH_FLAG_FIXED = 1<<3,
530 NL80211_MPATH_FLAG_RESOLVED = 1<<4,
531 };
532
533 /**
534 * enum nl80211_mpath_info - mesh path information
535 *
536 * These attribute types are used with %NL80211_ATTR_MPATH_INFO when getting
537 * information about a mesh path.
538 *
539 * @__NL80211_MPATH_INFO_INVALID: attribute number 0 is reserved
540 * @NL80211_ATTR_MPATH_FRAME_QLEN: number of queued frames for this destination
541 * @NL80211_ATTR_MPATH_DSN: destination sequence number
542 * @NL80211_ATTR_MPATH_METRIC: metric (cost) of this mesh path
543 * @NL80211_ATTR_MPATH_EXPTIME: expiration time for the path, in msec from now
544 * @NL80211_ATTR_MPATH_FLAGS: mesh path flags, enumerated in
545 * &enum nl80211_mpath_flags;
546 * @NL80211_ATTR_MPATH_DISCOVERY_TIMEOUT: total path discovery timeout, in msec
547 * @NL80211_ATTR_MPATH_DISCOVERY_RETRIES: mesh path discovery retries
548 */
549 enum nl80211_mpath_info {
550 __NL80211_MPATH_INFO_INVALID,
551 NL80211_MPATH_INFO_FRAME_QLEN,
552 NL80211_MPATH_INFO_DSN,
553 NL80211_MPATH_INFO_METRIC,
554 NL80211_MPATH_INFO_EXPTIME,
555 NL80211_MPATH_INFO_FLAGS,
556 NL80211_MPATH_INFO_DISCOVERY_TIMEOUT,
557 NL80211_MPATH_INFO_DISCOVERY_RETRIES,
558
559 /* keep last */
560 __NL80211_MPATH_INFO_AFTER_LAST,
561 NL80211_MPATH_INFO_MAX = __NL80211_MPATH_INFO_AFTER_LAST - 1
562 };
563
564 /**
565 * enum nl80211_band_attr - band attributes
566 * @__NL80211_BAND_ATTR_INVALID: attribute number 0 is reserved
567 * @NL80211_BAND_ATTR_FREQS: supported frequencies in this band,
568 * an array of nested frequency attributes
569 * @NL80211_BAND_ATTR_RATES: supported bitrates in this band,
570 * an array of nested bitrate attributes
571 * @NL80211_BAND_ATTR_HT_MCS_SET: 16-byte attribute containing the MCS set as
572 * defined in 802.11n
573 * @NL80211_BAND_ATTR_HT_CAPA: HT capabilities, as in the HT information IE
574 * @NL80211_BAND_ATTR_HT_AMPDU_FACTOR: A-MPDU factor, as in 11n
575 * @NL80211_BAND_ATTR_HT_AMPDU_DENSITY: A-MPDU density, as in 11n
576 */
577 enum nl80211_band_attr {
578 __NL80211_BAND_ATTR_INVALID,
579 NL80211_BAND_ATTR_FREQS,
580 NL80211_BAND_ATTR_RATES,
581
582 NL80211_BAND_ATTR_HT_MCS_SET,
583 NL80211_BAND_ATTR_HT_CAPA,
584 NL80211_BAND_ATTR_HT_AMPDU_FACTOR,
585 NL80211_BAND_ATTR_HT_AMPDU_DENSITY,
586
587 /* keep last */
588 __NL80211_BAND_ATTR_AFTER_LAST,
589 NL80211_BAND_ATTR_MAX = __NL80211_BAND_ATTR_AFTER_LAST - 1
590 };
591
592 #define NL80211_BAND_ATTR_HT_CAPA NL80211_BAND_ATTR_HT_CAPA
593
594 /**
595 * enum nl80211_frequency_attr - frequency attributes
596 * @NL80211_FREQUENCY_ATTR_FREQ: Frequency in MHz
597 * @NL80211_FREQUENCY_ATTR_DISABLED: Channel is disabled in current
598 * regulatory domain.
599 * @NL80211_FREQUENCY_ATTR_PASSIVE_SCAN: Only passive scanning is
600 * permitted on this channel in current regulatory domain.
601 * @NL80211_FREQUENCY_ATTR_NO_IBSS: IBSS networks are not permitted
602 * on this channel in current regulatory domain.
603 * @NL80211_FREQUENCY_ATTR_RADAR: Radar detection is mandatory
604 * on this channel in current regulatory domain.
605 * @NL80211_FREQUENCY_ATTR_MAX_TX_POWER: Maximum transmission power in mBm
606 * (100 * dBm).
607 */
608 enum nl80211_frequency_attr {
609 __NL80211_FREQUENCY_ATTR_INVALID,
610 NL80211_FREQUENCY_ATTR_FREQ,
611 NL80211_FREQUENCY_ATTR_DISABLED,
612 NL80211_FREQUENCY_ATTR_PASSIVE_SCAN,
613 NL80211_FREQUENCY_ATTR_NO_IBSS,
614 NL80211_FREQUENCY_ATTR_RADAR,
615 NL80211_FREQUENCY_ATTR_MAX_TX_POWER,
616
617 /* keep last */
618 __NL80211_FREQUENCY_ATTR_AFTER_LAST,
619 NL80211_FREQUENCY_ATTR_MAX = __NL80211_FREQUENCY_ATTR_AFTER_LAST - 1
620 };
621
622 #define NL80211_FREQUENCY_ATTR_MAX_TX_POWER NL80211_FREQUENCY_ATTR_MAX_TX_POWER
623
624 /**
625 * enum nl80211_bitrate_attr - bitrate attributes
626 * @NL80211_BITRATE_ATTR_RATE: Bitrate in units of 100 kbps
627 * @NL80211_BITRATE_ATTR_2GHZ_SHORTPREAMBLE: Short preamble supported
628 * in 2.4 GHz band.
629 */
630 enum nl80211_bitrate_attr {
631 __NL80211_BITRATE_ATTR_INVALID,
632 NL80211_BITRATE_ATTR_RATE,
633 NL80211_BITRATE_ATTR_2GHZ_SHORTPREAMBLE,
634
635 /* keep last */
636 __NL80211_BITRATE_ATTR_AFTER_LAST,
637 NL80211_BITRATE_ATTR_MAX = __NL80211_BITRATE_ATTR_AFTER_LAST - 1
638 };
639
640 /**
641 * enum nl80211_reg_rule_attr - regulatory rule attributes
642 * @NL80211_ATTR_REG_RULE_FLAGS: a set of flags which specify additional
643 * considerations for a given frequency range. These are the
644 * &enum nl80211_reg_rule_flags.
645 * @NL80211_ATTR_FREQ_RANGE_START: starting frequencry for the regulatory
646 * rule in KHz. This is not a center of frequency but an actual regulatory
647 * band edge.
648 * @NL80211_ATTR_FREQ_RANGE_END: ending frequency for the regulatory rule
649 * in KHz. This is not a center a frequency but an actual regulatory
650 * band edge.
651 * @NL80211_ATTR_FREQ_RANGE_MAX_BW: maximum allowed bandwidth for this
652 * frequency range, in KHz.
653 * @NL80211_ATTR_POWER_RULE_MAX_ANT_GAIN: the maximum allowed antenna gain
654 * for a given frequency range. The value is in mBi (100 * dBi).
655 * If you don't have one then don't send this.
656 * @NL80211_ATTR_POWER_RULE_MAX_EIRP: the maximum allowed EIRP for
657 * a given frequency range. The value is in mBm (100 * dBm).
658 */
659 enum nl80211_reg_rule_attr {
660 __NL80211_REG_RULE_ATTR_INVALID,
661 NL80211_ATTR_REG_RULE_FLAGS,
662
663 NL80211_ATTR_FREQ_RANGE_START,
664 NL80211_ATTR_FREQ_RANGE_END,
665 NL80211_ATTR_FREQ_RANGE_MAX_BW,
666
667 NL80211_ATTR_POWER_RULE_MAX_ANT_GAIN,
668 NL80211_ATTR_POWER_RULE_MAX_EIRP,
669
670 /* keep last */
671 __NL80211_REG_RULE_ATTR_AFTER_LAST,
672 NL80211_REG_RULE_ATTR_MAX = __NL80211_REG_RULE_ATTR_AFTER_LAST - 1
673 };
674
675 /**
676 * enum nl80211_reg_rule_flags - regulatory rule flags
677 *
678 * @NL80211_RRF_NO_OFDM: OFDM modulation not allowed
679 * @NL80211_RRF_NO_CCK: CCK modulation not allowed
680 * @NL80211_RRF_NO_INDOOR: indoor operation not allowed
681 * @NL80211_RRF_NO_OUTDOOR: outdoor operation not allowed
682 * @NL80211_RRF_DFS: DFS support is required to be used
683 * @NL80211_RRF_PTP_ONLY: this is only for Point To Point links
684 * @NL80211_RRF_PTMP_ONLY: this is only for Point To Multi Point links
685 * @NL80211_RRF_PASSIVE_SCAN: passive scan is required
686 * @NL80211_RRF_NO_IBSS: no IBSS is allowed
687 */
688 enum nl80211_reg_rule_flags {
689 NL80211_RRF_NO_OFDM = 1<<0,
690 NL80211_RRF_NO_CCK = 1<<1,
691 NL80211_RRF_NO_INDOOR = 1<<2,
692 NL80211_RRF_NO_OUTDOOR = 1<<3,
693 NL80211_RRF_DFS = 1<<4,
694 NL80211_RRF_PTP_ONLY = 1<<5,
695 NL80211_RRF_PTMP_ONLY = 1<<6,
696 NL80211_RRF_PASSIVE_SCAN = 1<<7,
697 NL80211_RRF_NO_IBSS = 1<<8,
698 };
699
700 /**
701 * enum nl80211_mntr_flags - monitor configuration flags
702 *
703 * Monitor configuration flags.
704 *
705 * @__NL80211_MNTR_FLAG_INVALID: reserved
706 *
707 * @NL80211_MNTR_FLAG_FCSFAIL: pass frames with bad FCS
708 * @NL80211_MNTR_FLAG_PLCPFAIL: pass frames with bad PLCP
709 * @NL80211_MNTR_FLAG_CONTROL: pass control frames
710 * @NL80211_MNTR_FLAG_OTHER_BSS: disable BSSID filtering
711 * @NL80211_MNTR_FLAG_COOK_FRAMES: report frames after processing.
712 * overrides all other flags.
713 *
714 * @__NL80211_MNTR_FLAG_AFTER_LAST: internal use
715 * @NL80211_MNTR_FLAG_MAX: highest possible monitor flag
716 */
717 enum nl80211_mntr_flags {
718 __NL80211_MNTR_FLAG_INVALID,
719 NL80211_MNTR_FLAG_FCSFAIL,
720 NL80211_MNTR_FLAG_PLCPFAIL,
721 NL80211_MNTR_FLAG_CONTROL,
722 NL80211_MNTR_FLAG_OTHER_BSS,
723 NL80211_MNTR_FLAG_COOK_FRAMES,
724
725 /* keep last */
726 __NL80211_MNTR_FLAG_AFTER_LAST,
727 NL80211_MNTR_FLAG_MAX = __NL80211_MNTR_FLAG_AFTER_LAST - 1
728 };
729
730 /**
731 * enum nl80211_meshconf_params - mesh configuration parameters
732 *
733 * Mesh configuration parameters
734 *
735 * @__NL80211_MESHCONF_INVALID: internal use
736 *
737 * @NL80211_MESHCONF_RETRY_TIMEOUT: specifies the initial retry timeout in
738 * millisecond units, used by the Peer Link Open message
739 *
740 * @NL80211_MESHCONF_CONFIRM_TIMEOUT: specifies the inital confirm timeout, in
741 * millisecond units, used by the peer link management to close a peer link
742 *
743 * @NL80211_MESHCONF_HOLDING_TIMEOUT: specifies the holding timeout, in
744 * millisecond units
745 *
746 * @NL80211_MESHCONF_MAX_PEER_LINKS: maximum number of peer links allowed
747 * on this mesh interface
748 *
749 * @NL80211_MESHCONF_MAX_RETRIES: specifies the maximum number of peer link
750 * open retries that can be sent to establish a new peer link instance in a
751 * mesh
752 *
753 * @NL80211_MESHCONF_TTL: specifies the value of TTL field set at a source mesh
754 * point.
755 *
756 * @NL80211_MESHCONF_AUTO_OPEN_PLINKS: whether we should automatically
757 * open peer links when we detect compatible mesh peers.
758 *
759 * @NL80211_MESHCONF_HWMP_MAX_PREQ_RETRIES: the number of action frames
760 * containing a PREQ that an MP can send to a particular destination (path
761 * target)
762 *
763 * @NL80211_MESHCONF_PATH_REFRESH_TIME: how frequently to refresh mesh paths
764 * (in milliseconds)
765 *
766 * @NL80211_MESHCONF_MIN_DISCOVERY_TIMEOUT: minimum length of time to wait
767 * until giving up on a path discovery (in milliseconds)
768 *
769 * @NL80211_MESHCONF_HWMP_ACTIVE_PATH_TIMEOUT: The time (in TUs) for which mesh
770 * points receiving a PREQ shall consider the forwarding information from the
771 * root to be valid. (TU = time unit)
772 *
773 * @NL80211_MESHCONF_HWMP_PREQ_MIN_INTERVAL: The minimum interval of time (in
774 * TUs) during which an MP can send only one action frame containing a PREQ
775 * reference element
776 *
777 * @NL80211_MESHCONF_HWMP_NET_DIAM_TRVS_TIME: The interval of time (in TUs)
778 * that it takes for an HWMP information element to propagate across the mesh
779 *
780 * @NL80211_MESHCONF_ATTR_MAX: highest possible mesh configuration attribute
781 *
782 * @__NL80211_MESHCONF_ATTR_AFTER_LAST: internal use
783 */
784 enum nl80211_meshconf_params {
785 __NL80211_MESHCONF_INVALID,
786 NL80211_MESHCONF_RETRY_TIMEOUT,
787 NL80211_MESHCONF_CONFIRM_TIMEOUT,
788 NL80211_MESHCONF_HOLDING_TIMEOUT,
789 NL80211_MESHCONF_MAX_PEER_LINKS,
790 NL80211_MESHCONF_MAX_RETRIES,
791 NL80211_MESHCONF_TTL,
792 NL80211_MESHCONF_AUTO_OPEN_PLINKS,
793 NL80211_MESHCONF_HWMP_MAX_PREQ_RETRIES,
794 NL80211_MESHCONF_PATH_REFRESH_TIME,
795 NL80211_MESHCONF_MIN_DISCOVERY_TIMEOUT,
796 NL80211_MESHCONF_HWMP_ACTIVE_PATH_TIMEOUT,
797 NL80211_MESHCONF_HWMP_PREQ_MIN_INTERVAL,
798 NL80211_MESHCONF_HWMP_NET_DIAM_TRVS_TIME,
799
800 /* keep last */
801 __NL80211_MESHCONF_ATTR_AFTER_LAST,
802 NL80211_MESHCONF_ATTR_MAX = __NL80211_MESHCONF_ATTR_AFTER_LAST - 1
803 };
804
805 /**
806 * enum nl80211_txq_attr - TX queue parameter attributes
807 * @__NL80211_TXQ_ATTR_INVALID: Attribute number 0 is reserved
808 * @NL80211_TXQ_ATTR_QUEUE: TX queue identifier (NL80211_TXQ_Q_*)
809 * @NL80211_TXQ_ATTR_TXOP: Maximum burst time in units of 32 usecs, 0 meaning
810 * disabled
811 * @NL80211_TXQ_ATTR_CWMIN: Minimum contention window [a value of the form
812 * 2^n-1 in the range 1..32767]
813 * @NL80211_TXQ_ATTR_CWMAX: Maximum contention window [a value of the form
814 * 2^n-1 in the range 1..32767]
815 * @NL80211_TXQ_ATTR_AIFS: Arbitration interframe space [0..255]
816 * @__NL80211_TXQ_ATTR_AFTER_LAST: Internal
817 * @NL80211_TXQ_ATTR_MAX: Maximum TXQ attribute number
818 */
819 enum nl80211_txq_attr {
820 __NL80211_TXQ_ATTR_INVALID,
821 NL80211_TXQ_ATTR_QUEUE,
822 NL80211_TXQ_ATTR_TXOP,
823 NL80211_TXQ_ATTR_CWMIN,
824 NL80211_TXQ_ATTR_CWMAX,
825 NL80211_TXQ_ATTR_AIFS,
826
827 /* keep last */
828 __NL80211_TXQ_ATTR_AFTER_LAST,
829 NL80211_TXQ_ATTR_MAX = __NL80211_TXQ_ATTR_AFTER_LAST - 1
830 };
831
832 enum nl80211_txq_q {
833 NL80211_TXQ_Q_VO,
834 NL80211_TXQ_Q_VI,
835 NL80211_TXQ_Q_BE,
836 NL80211_TXQ_Q_BK
837 };
838
839 enum nl80211_channel_type {
840 NL80211_CHAN_NO_HT,
841 NL80211_CHAN_HT20,
842 NL80211_CHAN_HT40MINUS,
843 NL80211_CHAN_HT40PLUS
844 };
845
846 /**
847 * enum nl80211_bss - netlink attributes for a BSS
848 *
849 * @__NL80211_BSS_INVALID: invalid
850 * @NL80211_BSS_FREQUENCY: frequency in MHz (u32)
851 * @NL80211_BSS_TSF: TSF of the received probe response/beacon (u64)
852 * @NL80211_BSS_BEACON_INTERVAL: beacon interval of the (I)BSS (u16)
853 * @NL80211_BSS_CAPABILITY: capability field (CPU order, u16)
854 * @NL80211_BSS_INFORMATION_ELEMENTS: binary attribute containing the
855 * raw information elements from the probe response/beacon (bin)
856 * @NL80211_BSS_SIGNAL_MBM: signal strength of probe response/beacon
857 * in mBm (100 * dBm) (s32)
858 * @NL80211_BSS_SIGNAL_UNSPEC: signal strength of the probe response/beacon
859 * in unspecified units, scaled to 0..100 (u8)
860 * @__NL80211_BSS_AFTER_LAST: internal
861 * @NL80211_BSS_MAX: highest BSS attribute
862 */
863 enum nl80211_bss {
864 __NL80211_BSS_INVALID,
865 NL80211_BSS_BSSID,
866 NL80211_BSS_FREQUENCY,
867 NL80211_BSS_TSF,
868 NL80211_BSS_BEACON_INTERVAL,
869 NL80211_BSS_CAPABILITY,
870 NL80211_BSS_INFORMATION_ELEMENTS,
871 NL80211_BSS_SIGNAL_MBM,
872 NL80211_BSS_SIGNAL_UNSPEC,
873
874 /* keep last */
875 __NL80211_BSS_AFTER_LAST,
876 NL80211_BSS_MAX = __NL80211_BSS_AFTER_LAST - 1
877 };
878
879 #endif /* __LINUX_NL80211_H */