nl80211.h revision 5394af4d86ae51b369ff243c3f75b6f9a74e164b
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_MAX: highest used command number
137 * @__NL80211_CMD_AFTER_LAST: internal use
138 */
139enum nl80211_commands {
140/* don't change the order or add anything inbetween, this is ABI! */
141	NL80211_CMD_UNSPEC,
142
143	NL80211_CMD_GET_WIPHY,		/* can dump */
144	NL80211_CMD_SET_WIPHY,
145	NL80211_CMD_NEW_WIPHY,
146	NL80211_CMD_DEL_WIPHY,
147
148	NL80211_CMD_GET_INTERFACE,	/* can dump */
149	NL80211_CMD_SET_INTERFACE,
150	NL80211_CMD_NEW_INTERFACE,
151	NL80211_CMD_DEL_INTERFACE,
152
153	NL80211_CMD_GET_KEY,
154	NL80211_CMD_SET_KEY,
155	NL80211_CMD_NEW_KEY,
156	NL80211_CMD_DEL_KEY,
157
158	NL80211_CMD_GET_BEACON,
159	NL80211_CMD_SET_BEACON,
160	NL80211_CMD_NEW_BEACON,
161	NL80211_CMD_DEL_BEACON,
162
163	NL80211_CMD_GET_STATION,
164	NL80211_CMD_SET_STATION,
165	NL80211_CMD_NEW_STATION,
166	NL80211_CMD_DEL_STATION,
167
168	NL80211_CMD_GET_MPATH,
169	NL80211_CMD_SET_MPATH,
170	NL80211_CMD_NEW_MPATH,
171	NL80211_CMD_DEL_MPATH,
172
173	NL80211_CMD_SET_BSS,
174
175	NL80211_CMD_SET_REG,
176	NL80211_CMD_REQ_SET_REG,
177
178	NL80211_CMD_GET_MESH_PARAMS,
179	NL80211_CMD_SET_MESH_PARAMS,
180
181	/* add new commands above here */
182
183	/* used to define NL80211_CMD_MAX below */
184	__NL80211_CMD_AFTER_LAST,
185	NL80211_CMD_MAX = __NL80211_CMD_AFTER_LAST - 1
186};
187
188/*
189 * Allow user space programs to use #ifdef on new commands by defining them
190 * here
191 */
192#define NL80211_CMD_SET_BSS NL80211_CMD_SET_BSS
193
194/**
195 * enum nl80211_attrs - nl80211 netlink attributes
196 *
197 * @NL80211_ATTR_UNSPEC: unspecified attribute to catch errors
198 *
199 * @NL80211_ATTR_WIPHY: index of wiphy to operate on, cf.
200 *	/sys/class/ieee80211/<phyname>/index
201 * @NL80211_ATTR_WIPHY_NAME: wiphy name (used for renaming)
202 * @NL80211_ATTR_WIPHY_TXQ_PARAMS: a nested array of TX queue parameters
203 * @NL80211_ATTR_WIPHY_FREQ: frequency of the selected channel in MHz
204 * @NL80211_ATTR_WIPHY_CHANNEL_TYPE: included with NL80211_ATTR_WIPHY_FREQ
205 *	if HT20 or HT40 are allowed (i.e., 802.11n disabled if not included):
206 *	NL80211_CHAN_NO_HT = HT not allowed (i.e., same as not including
207 *		this attribute)
208 *	NL80211_CHAN_HT20 = HT20 only
209 *	NL80211_CHAN_HT40MINUS = secondary channel is below the primary channel
210 *	NL80211_CHAN_HT40PLUS = secondary channel is above the primary channel
211 *
212 * @NL80211_ATTR_IFINDEX: network interface index of the device to operate on
213 * @NL80211_ATTR_IFNAME: network interface name
214 * @NL80211_ATTR_IFTYPE: type of virtual interface, see &enum nl80211_iftype
215 *
216 * @NL80211_ATTR_MAC: MAC address (various uses)
217 *
218 * @NL80211_ATTR_KEY_DATA: (temporal) key data; for TKIP this consists of
219 *	16 bytes encryption key followed by 8 bytes each for TX and RX MIC
220 *	keys
221 * @NL80211_ATTR_KEY_IDX: key ID (u8, 0-3)
222 * @NL80211_ATTR_KEY_CIPHER: key cipher suite (u32, as defined by IEEE 802.11
223 *	section 7.3.2.25.1, e.g. 0x000FAC04)
224 * @NL80211_ATTR_KEY_SEQ: transmit key sequence number (IV/PN) for TKIP and
225 *	CCMP keys, each six bytes in little endian
226 *
227 * @NL80211_ATTR_BEACON_INTERVAL: beacon interval in TU
228 * @NL80211_ATTR_DTIM_PERIOD: DTIM period for beaconing
229 * @NL80211_ATTR_BEACON_HEAD: portion of the beacon before the TIM IE
230 * @NL80211_ATTR_BEACON_TAIL: portion of the beacon after the TIM IE
231 *
232 * @NL80211_ATTR_STA_AID: Association ID for the station (u16)
233 * @NL80211_ATTR_STA_FLAGS: flags, nested element with NLA_FLAG attributes of
234 *	&enum nl80211_sta_flags.
235 * @NL80211_ATTR_STA_LISTEN_INTERVAL: listen interval as defined by
236 *	IEEE 802.11 7.3.1.6 (u16).
237 * @NL80211_ATTR_STA_SUPPORTED_RATES: supported rates, array of supported
238 *	rates as defined by IEEE 802.11 7.3.2.2 but without the length
239 *	restriction (at most %NL80211_MAX_SUPP_RATES).
240 * @NL80211_ATTR_STA_VLAN: interface index of VLAN interface to move station
241 *	to, or the AP interface the station was originally added to to.
242 * @NL80211_ATTR_STA_INFO: information about a station, part of station info
243 *	given for %NL80211_CMD_GET_STATION, nested attribute containing
244 *	info as possible, see &enum nl80211_sta_info.
245 *
246 * @NL80211_ATTR_WIPHY_BANDS: Information about an operating bands,
247 *	consisting of a nested array.
248 *
249 * @NL80211_ATTR_MESH_ID: mesh id (1-32 bytes).
250 * @NL80211_ATTR_PLINK_ACTION: action to perform on the mesh peer link.
251 * @NL80211_ATTR_MPATH_NEXT_HOP: MAC address of the next hop for a mesh path.
252 * @NL80211_ATTR_MPATH_INFO: information about a mesh_path, part of mesh path
253 * 	info given for %NL80211_CMD_GET_MPATH, nested attribute described at
254 *	&enum nl80211_mpath_info.
255 *
256 * @NL80211_ATTR_MNTR_FLAGS: flags, nested element with NLA_FLAG attributes of
257 *      &enum nl80211_mntr_flags.
258 *
259 * @NL80211_ATTR_REG_ALPHA2: an ISO-3166-alpha2 country code for which the
260 * 	current regulatory domain should be set to or is already set to.
261 * 	For example, 'CR', for Costa Rica. This attribute is used by the kernel
262 * 	to query the CRDA to retrieve one regulatory domain. This attribute can
263 * 	also be used by userspace to query the kernel for the currently set
264 * 	regulatory domain. We chose an alpha2 as that is also used by the
265 * 	IEEE-802.11d country information element to identify a country.
266 * 	Users can also simply ask the wireless core to set regulatory domain
267 * 	to a specific alpha2.
268 * @NL80211_ATTR_REG_RULES: a nested array of regulatory domain regulatory
269 *	rules.
270 *
271 * @NL80211_ATTR_BSS_CTS_PROT: whether CTS protection is enabled (u8, 0 or 1)
272 * @NL80211_ATTR_BSS_SHORT_PREAMBLE: whether short preamble is enabled
273 *	(u8, 0 or 1)
274 * @NL80211_ATTR_BSS_SHORT_SLOT_TIME: whether short slot time enabled
275 *	(u8, 0 or 1)
276 * @NL80211_ATTR_BSS_BASIC_RATES: basic rates, array of basic
277 *	rates in format defined by IEEE 802.11 7.3.2.2 but without the length
278 *	restriction (at most %NL80211_MAX_SUPP_RATES).
279 *
280 * @NL80211_ATTR_HT_CAPABILITY: HT Capability information element (from
281 *	association request when used with NL80211_CMD_NEW_STATION)
282 *
283 * @NL80211_ATTR_SUPPORTED_IFTYPES: nested attribute containing all
284 *	supported interface types, each a flag attribute with the number
285 *	of the interface mode.
286 *
287 * @NL80211_ATTR_MAX: highest attribute number currently defined
288 * @__NL80211_ATTR_AFTER_LAST: internal use
289 */
290enum nl80211_attrs {
291/* don't change the order or add anything inbetween, this is ABI! */
292	NL80211_ATTR_UNSPEC,
293
294	NL80211_ATTR_WIPHY,
295	NL80211_ATTR_WIPHY_NAME,
296
297	NL80211_ATTR_IFINDEX,
298	NL80211_ATTR_IFNAME,
299	NL80211_ATTR_IFTYPE,
300
301	NL80211_ATTR_MAC,
302
303	NL80211_ATTR_KEY_DATA,
304	NL80211_ATTR_KEY_IDX,
305	NL80211_ATTR_KEY_CIPHER,
306	NL80211_ATTR_KEY_SEQ,
307	NL80211_ATTR_KEY_DEFAULT,
308
309	NL80211_ATTR_BEACON_INTERVAL,
310	NL80211_ATTR_DTIM_PERIOD,
311	NL80211_ATTR_BEACON_HEAD,
312	NL80211_ATTR_BEACON_TAIL,
313
314	NL80211_ATTR_STA_AID,
315	NL80211_ATTR_STA_FLAGS,
316	NL80211_ATTR_STA_LISTEN_INTERVAL,
317	NL80211_ATTR_STA_SUPPORTED_RATES,
318	NL80211_ATTR_STA_VLAN,
319	NL80211_ATTR_STA_INFO,
320
321	NL80211_ATTR_WIPHY_BANDS,
322
323	NL80211_ATTR_MNTR_FLAGS,
324
325	NL80211_ATTR_MESH_ID,
326	NL80211_ATTR_STA_PLINK_ACTION,
327	NL80211_ATTR_MPATH_NEXT_HOP,
328	NL80211_ATTR_MPATH_INFO,
329
330	NL80211_ATTR_BSS_CTS_PROT,
331	NL80211_ATTR_BSS_SHORT_PREAMBLE,
332	NL80211_ATTR_BSS_SHORT_SLOT_TIME,
333
334	NL80211_ATTR_HT_CAPABILITY,
335
336	NL80211_ATTR_SUPPORTED_IFTYPES,
337
338	NL80211_ATTR_REG_ALPHA2,
339	NL80211_ATTR_REG_RULES,
340
341	NL80211_ATTR_MESH_PARAMS,
342
343	NL80211_ATTR_BSS_BASIC_RATES,
344
345	NL80211_ATTR_WIPHY_TXQ_PARAMS,
346	NL80211_ATTR_WIPHY_FREQ,
347	NL80211_ATTR_WIPHY_CHANNEL_TYPE,
348
349	/* add attributes here, update the policy in nl80211.c */
350
351	__NL80211_ATTR_AFTER_LAST,
352	NL80211_ATTR_MAX = __NL80211_ATTR_AFTER_LAST - 1
353};
354
355/*
356 * Allow user space programs to use #ifdef on new attributes by defining them
357 * here
358 */
359#define NL80211_ATTR_HT_CAPABILITY NL80211_ATTR_HT_CAPABILITY
360#define NL80211_ATTR_BSS_BASIC_RATES NL80211_ATTR_BSS_BASIC_RATES
361#define NL80211_ATTR_WIPHY_TXQ_PARAMS NL80211_ATTR_WIPHY_TXQ_PARAMS
362#define NL80211_ATTR_WIPHY_FREQ NL80211_ATTR_WIPHY_FREQ
363#define NL80211_ATTR_WIPHY_SEC_CHAN_OFFSET NL80211_ATTR_WIPHY_SEC_CHAN_OFFSET
364
365#define NL80211_MAX_SUPP_RATES			32
366#define NL80211_MAX_SUPP_REG_RULES		32
367#define NL80211_TKIP_DATA_OFFSET_ENCR_KEY	0
368#define NL80211_TKIP_DATA_OFFSET_TX_MIC_KEY	16
369#define NL80211_TKIP_DATA_OFFSET_RX_MIC_KEY	24
370#define NL80211_HT_CAPABILITY_LEN		26
371
372/**
373 * enum nl80211_iftype - (virtual) interface types
374 *
375 * @NL80211_IFTYPE_UNSPECIFIED: unspecified type, driver decides
376 * @NL80211_IFTYPE_ADHOC: independent BSS member
377 * @NL80211_IFTYPE_STATION: managed BSS member
378 * @NL80211_IFTYPE_AP: access point
379 * @NL80211_IFTYPE_AP_VLAN: VLAN interface for access points
380 * @NL80211_IFTYPE_WDS: wireless distribution interface
381 * @NL80211_IFTYPE_MONITOR: monitor interface receiving all frames
382 * @NL80211_IFTYPE_MESH_POINT: mesh point
383 * @NL80211_IFTYPE_MAX: highest interface type number currently defined
384 * @__NL80211_IFTYPE_AFTER_LAST: internal use
385 *
386 * These values are used with the %NL80211_ATTR_IFTYPE
387 * to set the type of an interface.
388 *
389 */
390enum nl80211_iftype {
391	NL80211_IFTYPE_UNSPECIFIED,
392	NL80211_IFTYPE_ADHOC,
393	NL80211_IFTYPE_STATION,
394	NL80211_IFTYPE_AP,
395	NL80211_IFTYPE_AP_VLAN,
396	NL80211_IFTYPE_WDS,
397	NL80211_IFTYPE_MONITOR,
398	NL80211_IFTYPE_MESH_POINT,
399
400	/* keep last */
401	__NL80211_IFTYPE_AFTER_LAST,
402	NL80211_IFTYPE_MAX = __NL80211_IFTYPE_AFTER_LAST - 1
403};
404
405/**
406 * enum nl80211_sta_flags - station flags
407 *
408 * Station flags. When a station is added to an AP interface, it is
409 * assumed to be already associated (and hence authenticated.)
410 *
411 * @NL80211_STA_FLAG_AUTHORIZED: station is authorized (802.1X)
412 * @NL80211_STA_FLAG_SHORT_PREAMBLE: station is capable of receiving frames
413 *	with short barker preamble
414 * @NL80211_STA_FLAG_WME: station is WME/QoS capable
415 * @NL80211_STA_FLAG_MFP: station uses management frame protection
416 */
417enum nl80211_sta_flags {
418	__NL80211_STA_FLAG_INVALID,
419	NL80211_STA_FLAG_AUTHORIZED,
420	NL80211_STA_FLAG_SHORT_PREAMBLE,
421	NL80211_STA_FLAG_WME,
422	NL80211_STA_FLAG_MFP,
423
424	/* keep last */
425	__NL80211_STA_FLAG_AFTER_LAST,
426	NL80211_STA_FLAG_MAX = __NL80211_STA_FLAG_AFTER_LAST - 1
427};
428
429/**
430 * enum nl80211_rate_info - bitrate information
431 *
432 * These attribute types are used with %NL80211_STA_INFO_TXRATE
433 * when getting information about the bitrate of a station.
434 *
435 * @__NL80211_RATE_INFO_INVALID: attribute number 0 is reserved
436 * @NL80211_RATE_INFO_BITRATE: total bitrate (u16, 100kbit/s)
437 * @NL80211_RATE_INFO_MCS: mcs index for 802.11n (u8)
438 * @NL80211_RATE_INFO_40_MHZ_WIDTH: 40 Mhz dualchannel bitrate
439 * @NL80211_RATE_INFO_SHORT_GI: 400ns guard interval
440 * @NL80211_RATE_INFO_MAX: highest rate_info number currently defined
441 * @__NL80211_RATE_INFO_AFTER_LAST: internal use
442 */
443enum nl80211_rate_info {
444	__NL80211_RATE_INFO_INVALID,
445	NL80211_RATE_INFO_BITRATE,
446	NL80211_RATE_INFO_MCS,
447	NL80211_RATE_INFO_40_MHZ_WIDTH,
448	NL80211_RATE_INFO_SHORT_GI,
449
450	/* keep last */
451	__NL80211_RATE_INFO_AFTER_LAST,
452	NL80211_RATE_INFO_MAX = __NL80211_RATE_INFO_AFTER_LAST - 1
453};
454
455/**
456 * enum nl80211_sta_info - station information
457 *
458 * These attribute types are used with %NL80211_ATTR_STA_INFO
459 * when getting information about a station.
460 *
461 * @__NL80211_STA_INFO_INVALID: attribute number 0 is reserved
462 * @NL80211_STA_INFO_INACTIVE_TIME: time since last activity (u32, msecs)
463 * @NL80211_STA_INFO_RX_BYTES: total received bytes (u32, from this station)
464 * @NL80211_STA_INFO_TX_BYTES: total transmitted bytes (u32, to this station)
465 * @__NL80211_STA_INFO_AFTER_LAST: internal
466 * @NL80211_STA_INFO_MAX: highest possible station info attribute
467 * @NL80211_STA_INFO_SIGNAL: signal strength of last received PPDU (u8, dBm)
468 * @NL80211_STA_INFO_TX_BITRATE: current unicast tx rate, nested attribute
469 * 	containing info as possible, see &enum nl80211_sta_info_txrate.
470 */
471enum nl80211_sta_info {
472	__NL80211_STA_INFO_INVALID,
473	NL80211_STA_INFO_INACTIVE_TIME,
474	NL80211_STA_INFO_RX_BYTES,
475	NL80211_STA_INFO_TX_BYTES,
476	NL80211_STA_INFO_LLID,
477	NL80211_STA_INFO_PLID,
478	NL80211_STA_INFO_PLINK_STATE,
479	NL80211_STA_INFO_SIGNAL,
480	NL80211_STA_INFO_TX_BITRATE,
481
482	/* keep last */
483	__NL80211_STA_INFO_AFTER_LAST,
484	NL80211_STA_INFO_MAX = __NL80211_STA_INFO_AFTER_LAST - 1
485};
486
487/**
488 * enum nl80211_mpath_flags - nl80211 mesh path flags
489 *
490 * @NL80211_MPATH_FLAG_ACTIVE: the mesh path is active
491 * @NL80211_MPATH_FLAG_RESOLVING: the mesh path discovery process is running
492 * @NL80211_MPATH_FLAG_DSN_VALID: the mesh path contains a valid DSN
493 * @NL80211_MPATH_FLAG_FIXED: the mesh path has been manually set
494 * @NL80211_MPATH_FLAG_RESOLVED: the mesh path discovery process succeeded
495 */
496enum nl80211_mpath_flags {
497	NL80211_MPATH_FLAG_ACTIVE =	1<<0,
498	NL80211_MPATH_FLAG_RESOLVING =	1<<1,
499	NL80211_MPATH_FLAG_DSN_VALID =	1<<2,
500	NL80211_MPATH_FLAG_FIXED =	1<<3,
501	NL80211_MPATH_FLAG_RESOLVED =	1<<4,
502};
503
504/**
505 * enum nl80211_mpath_info - mesh path information
506 *
507 * These attribute types are used with %NL80211_ATTR_MPATH_INFO when getting
508 * information about a mesh path.
509 *
510 * @__NL80211_MPATH_INFO_INVALID: attribute number 0 is reserved
511 * @NL80211_ATTR_MPATH_FRAME_QLEN: number of queued frames for this destination
512 * @NL80211_ATTR_MPATH_DSN: destination sequence number
513 * @NL80211_ATTR_MPATH_METRIC: metric (cost) of this mesh path
514 * @NL80211_ATTR_MPATH_EXPTIME: expiration time for the path, in msec from now
515 * @NL80211_ATTR_MPATH_FLAGS: mesh path flags, enumerated in
516 * 	&enum nl80211_mpath_flags;
517 * @NL80211_ATTR_MPATH_DISCOVERY_TIMEOUT: total path discovery timeout, in msec
518 * @NL80211_ATTR_MPATH_DISCOVERY_RETRIES: mesh path discovery retries
519 */
520enum nl80211_mpath_info {
521	__NL80211_MPATH_INFO_INVALID,
522	NL80211_MPATH_INFO_FRAME_QLEN,
523	NL80211_MPATH_INFO_DSN,
524	NL80211_MPATH_INFO_METRIC,
525	NL80211_MPATH_INFO_EXPTIME,
526	NL80211_MPATH_INFO_FLAGS,
527	NL80211_MPATH_INFO_DISCOVERY_TIMEOUT,
528	NL80211_MPATH_INFO_DISCOVERY_RETRIES,
529
530	/* keep last */
531	__NL80211_MPATH_INFO_AFTER_LAST,
532	NL80211_MPATH_INFO_MAX = __NL80211_MPATH_INFO_AFTER_LAST - 1
533};
534
535/**
536 * enum nl80211_band_attr - band attributes
537 * @__NL80211_BAND_ATTR_INVALID: attribute number 0 is reserved
538 * @NL80211_BAND_ATTR_FREQS: supported frequencies in this band,
539 *	an array of nested frequency attributes
540 * @NL80211_BAND_ATTR_RATES: supported bitrates in this band,
541 *	an array of nested bitrate attributes
542 * @NL80211_BAND_ATTR_HT_MCS_SET: 16-byte attribute containing the MCS set as
543 *	defined in 802.11n
544 * @NL80211_BAND_ATTR_HT_CAPA: HT capabilities, as in the HT information IE
545 * @NL80211_BAND_ATTR_HT_AMPDU_FACTOR: A-MPDU factor, as in 11n
546 * @NL80211_BAND_ATTR_HT_AMPDU_DENSITY: A-MPDU density, as in 11n
547 */
548enum nl80211_band_attr {
549	__NL80211_BAND_ATTR_INVALID,
550	NL80211_BAND_ATTR_FREQS,
551	NL80211_BAND_ATTR_RATES,
552
553	NL80211_BAND_ATTR_HT_MCS_SET,
554	NL80211_BAND_ATTR_HT_CAPA,
555	NL80211_BAND_ATTR_HT_AMPDU_FACTOR,
556	NL80211_BAND_ATTR_HT_AMPDU_DENSITY,
557
558	/* keep last */
559	__NL80211_BAND_ATTR_AFTER_LAST,
560	NL80211_BAND_ATTR_MAX = __NL80211_BAND_ATTR_AFTER_LAST - 1
561};
562
563#define NL80211_BAND_ATTR_HT_CAPA NL80211_BAND_ATTR_HT_CAPA
564
565/**
566 * enum nl80211_frequency_attr - frequency attributes
567 * @NL80211_FREQUENCY_ATTR_FREQ: Frequency in MHz
568 * @NL80211_FREQUENCY_ATTR_DISABLED: Channel is disabled in current
569 *	regulatory domain.
570 * @NL80211_FREQUENCY_ATTR_PASSIVE_SCAN: Only passive scanning is
571 *	permitted on this channel in current regulatory domain.
572 * @NL80211_FREQUENCY_ATTR_NO_IBSS: IBSS networks are not permitted
573 *	on this channel in current regulatory domain.
574 * @NL80211_FREQUENCY_ATTR_RADAR: Radar detection is mandatory
575 *	on this channel in current regulatory domain.
576 * @NL80211_FREQUENCY_ATTR_MAX_TX_POWER: Maximum transmission power in mBm
577 *	(100 * dBm).
578 */
579enum nl80211_frequency_attr {
580	__NL80211_FREQUENCY_ATTR_INVALID,
581	NL80211_FREQUENCY_ATTR_FREQ,
582	NL80211_FREQUENCY_ATTR_DISABLED,
583	NL80211_FREQUENCY_ATTR_PASSIVE_SCAN,
584	NL80211_FREQUENCY_ATTR_NO_IBSS,
585	NL80211_FREQUENCY_ATTR_RADAR,
586	NL80211_FREQUENCY_ATTR_MAX_TX_POWER,
587
588	/* keep last */
589	__NL80211_FREQUENCY_ATTR_AFTER_LAST,
590	NL80211_FREQUENCY_ATTR_MAX = __NL80211_FREQUENCY_ATTR_AFTER_LAST - 1
591};
592
593#define NL80211_FREQUENCY_ATTR_MAX_TX_POWER NL80211_FREQUENCY_ATTR_MAX_TX_POWER
594
595/**
596 * enum nl80211_bitrate_attr - bitrate attributes
597 * @NL80211_BITRATE_ATTR_RATE: Bitrate in units of 100 kbps
598 * @NL80211_BITRATE_ATTR_2GHZ_SHORTPREAMBLE: Short preamble supported
599 *	in 2.4 GHz band.
600 */
601enum nl80211_bitrate_attr {
602	__NL80211_BITRATE_ATTR_INVALID,
603	NL80211_BITRATE_ATTR_RATE,
604	NL80211_BITRATE_ATTR_2GHZ_SHORTPREAMBLE,
605
606	/* keep last */
607	__NL80211_BITRATE_ATTR_AFTER_LAST,
608	NL80211_BITRATE_ATTR_MAX = __NL80211_BITRATE_ATTR_AFTER_LAST - 1
609};
610
611/**
612 * enum nl80211_reg_rule_attr - regulatory rule attributes
613 * @NL80211_ATTR_REG_RULE_FLAGS: a set of flags which specify additional
614 * 	considerations for a given frequency range. These are the
615 * 	&enum nl80211_reg_rule_flags.
616 * @NL80211_ATTR_FREQ_RANGE_START: starting frequencry for the regulatory
617 * 	rule in KHz. This is not a center of frequency but an actual regulatory
618 * 	band edge.
619 * @NL80211_ATTR_FREQ_RANGE_END: ending frequency for the regulatory rule
620 * 	in KHz. This is not a center a frequency but an actual regulatory
621 * 	band edge.
622 * @NL80211_ATTR_FREQ_RANGE_MAX_BW: maximum allowed bandwidth for this
623 * 	frequency range, in KHz.
624 * @NL80211_ATTR_POWER_RULE_MAX_ANT_GAIN: the maximum allowed antenna gain
625 * 	for a given frequency range. The value is in mBi (100 * dBi).
626 * 	If you don't have one then don't send this.
627 * @NL80211_ATTR_POWER_RULE_MAX_EIRP: the maximum allowed EIRP for
628 * 	a given frequency range. The value is in mBm (100 * dBm).
629 */
630enum nl80211_reg_rule_attr {
631	__NL80211_REG_RULE_ATTR_INVALID,
632	NL80211_ATTR_REG_RULE_FLAGS,
633
634	NL80211_ATTR_FREQ_RANGE_START,
635	NL80211_ATTR_FREQ_RANGE_END,
636	NL80211_ATTR_FREQ_RANGE_MAX_BW,
637
638	NL80211_ATTR_POWER_RULE_MAX_ANT_GAIN,
639	NL80211_ATTR_POWER_RULE_MAX_EIRP,
640
641	/* keep last */
642	__NL80211_REG_RULE_ATTR_AFTER_LAST,
643	NL80211_REG_RULE_ATTR_MAX = __NL80211_REG_RULE_ATTR_AFTER_LAST - 1
644};
645
646/**
647 * enum nl80211_reg_rule_flags - regulatory rule flags
648 *
649 * @NL80211_RRF_NO_OFDM: OFDM modulation not allowed
650 * @NL80211_RRF_NO_CCK: CCK modulation not allowed
651 * @NL80211_RRF_NO_INDOOR: indoor operation not allowed
652 * @NL80211_RRF_NO_OUTDOOR: outdoor operation not allowed
653 * @NL80211_RRF_DFS: DFS support is required to be used
654 * @NL80211_RRF_PTP_ONLY: this is only for Point To Point links
655 * @NL80211_RRF_PTMP_ONLY: this is only for Point To Multi Point links
656 * @NL80211_RRF_PASSIVE_SCAN: passive scan is required
657 * @NL80211_RRF_NO_IBSS: no IBSS is allowed
658 */
659enum nl80211_reg_rule_flags {
660	NL80211_RRF_NO_OFDM		= 1<<0,
661	NL80211_RRF_NO_CCK		= 1<<1,
662	NL80211_RRF_NO_INDOOR		= 1<<2,
663	NL80211_RRF_NO_OUTDOOR		= 1<<3,
664	NL80211_RRF_DFS			= 1<<4,
665	NL80211_RRF_PTP_ONLY		= 1<<5,
666	NL80211_RRF_PTMP_ONLY		= 1<<6,
667	NL80211_RRF_PASSIVE_SCAN	= 1<<7,
668	NL80211_RRF_NO_IBSS		= 1<<8,
669};
670
671/**
672 * enum nl80211_mntr_flags - monitor configuration flags
673 *
674 * Monitor configuration flags.
675 *
676 * @__NL80211_MNTR_FLAG_INVALID: reserved
677 *
678 * @NL80211_MNTR_FLAG_FCSFAIL: pass frames with bad FCS
679 * @NL80211_MNTR_FLAG_PLCPFAIL: pass frames with bad PLCP
680 * @NL80211_MNTR_FLAG_CONTROL: pass control frames
681 * @NL80211_MNTR_FLAG_OTHER_BSS: disable BSSID filtering
682 * @NL80211_MNTR_FLAG_COOK_FRAMES: report frames after processing.
683 *	overrides all other flags.
684 *
685 * @__NL80211_MNTR_FLAG_AFTER_LAST: internal use
686 * @NL80211_MNTR_FLAG_MAX: highest possible monitor flag
687 */
688enum nl80211_mntr_flags {
689	__NL80211_MNTR_FLAG_INVALID,
690	NL80211_MNTR_FLAG_FCSFAIL,
691	NL80211_MNTR_FLAG_PLCPFAIL,
692	NL80211_MNTR_FLAG_CONTROL,
693	NL80211_MNTR_FLAG_OTHER_BSS,
694	NL80211_MNTR_FLAG_COOK_FRAMES,
695
696	/* keep last */
697	__NL80211_MNTR_FLAG_AFTER_LAST,
698	NL80211_MNTR_FLAG_MAX = __NL80211_MNTR_FLAG_AFTER_LAST - 1
699};
700
701/**
702 * enum nl80211_meshconf_params - mesh configuration parameters
703 *
704 * Mesh configuration parameters
705 *
706 * @__NL80211_MESHCONF_INVALID: internal use
707 *
708 * @NL80211_MESHCONF_RETRY_TIMEOUT: specifies the initial retry timeout in
709 * millisecond units, used by the Peer Link Open message
710 *
711 * @NL80211_MESHCONF_CONFIRM_TIMEOUT: specifies the inital confirm timeout, in
712 * millisecond units, used by the peer link management to close a peer link
713 *
714 * @NL80211_MESHCONF_HOLDING_TIMEOUT: specifies the holding timeout, in
715 * millisecond units
716 *
717 * @NL80211_MESHCONF_MAX_PEER_LINKS: maximum number of peer links allowed
718 * on this mesh interface
719 *
720 * @NL80211_MESHCONF_MAX_RETRIES: specifies the maximum number of peer link
721 * open retries that can be sent to establish a new peer link instance in a
722 * mesh
723 *
724 * @NL80211_MESHCONF_TTL: specifies the value of TTL field set at a source mesh
725 * point.
726 *
727 * @NL80211_MESHCONF_AUTO_OPEN_PLINKS: whether we should automatically
728 * open peer links when we detect compatible mesh peers.
729 *
730 * @NL80211_MESHCONF_HWMP_MAX_PREQ_RETRIES: the number of action frames
731 * containing a PREQ that an MP can send to a particular destination (path
732 * target)
733 *
734 * @NL80211_MESHCONF_PATH_REFRESH_TIME: how frequently to refresh mesh paths
735 * (in milliseconds)
736 *
737 * @NL80211_MESHCONF_MIN_DISCOVERY_TIMEOUT: minimum length of time to wait
738 * until giving up on a path discovery (in milliseconds)
739 *
740 * @NL80211_MESHCONF_HWMP_ACTIVE_PATH_TIMEOUT: The time (in TUs) for which mesh
741 * points receiving a PREQ shall consider the forwarding information from the
742 * root to be valid. (TU = time unit)
743 *
744 * @NL80211_MESHCONF_HWMP_PREQ_MIN_INTERVAL: The minimum interval of time (in
745 * TUs) during which an MP can send only one action frame containing a PREQ
746 * reference element
747 *
748 * @NL80211_MESHCONF_HWMP_NET_DIAM_TRVS_TIME: The interval of time (in TUs)
749 * that it takes for an HWMP information element to propagate across the mesh
750 *
751 * @NL80211_MESHCONF_ATTR_MAX: highest possible mesh configuration attribute
752 *
753 * @__NL80211_MESHCONF_ATTR_AFTER_LAST: internal use
754 */
755enum nl80211_meshconf_params {
756	__NL80211_MESHCONF_INVALID,
757	NL80211_MESHCONF_RETRY_TIMEOUT,
758	NL80211_MESHCONF_CONFIRM_TIMEOUT,
759	NL80211_MESHCONF_HOLDING_TIMEOUT,
760	NL80211_MESHCONF_MAX_PEER_LINKS,
761	NL80211_MESHCONF_MAX_RETRIES,
762	NL80211_MESHCONF_TTL,
763	NL80211_MESHCONF_AUTO_OPEN_PLINKS,
764	NL80211_MESHCONF_HWMP_MAX_PREQ_RETRIES,
765	NL80211_MESHCONF_PATH_REFRESH_TIME,
766	NL80211_MESHCONF_MIN_DISCOVERY_TIMEOUT,
767	NL80211_MESHCONF_HWMP_ACTIVE_PATH_TIMEOUT,
768	NL80211_MESHCONF_HWMP_PREQ_MIN_INTERVAL,
769	NL80211_MESHCONF_HWMP_NET_DIAM_TRVS_TIME,
770
771	/* keep last */
772	__NL80211_MESHCONF_ATTR_AFTER_LAST,
773	NL80211_MESHCONF_ATTR_MAX = __NL80211_MESHCONF_ATTR_AFTER_LAST - 1
774};
775
776/**
777 * enum nl80211_txq_attr - TX queue parameter attributes
778 * @__NL80211_TXQ_ATTR_INVALID: Attribute number 0 is reserved
779 * @NL80211_TXQ_ATTR_QUEUE: TX queue identifier (NL80211_TXQ_Q_*)
780 * @NL80211_TXQ_ATTR_TXOP: Maximum burst time in units of 32 usecs, 0 meaning
781 *	disabled
782 * @NL80211_TXQ_ATTR_CWMIN: Minimum contention window [a value of the form
783 *	2^n-1 in the range 1..32767]
784 * @NL80211_TXQ_ATTR_CWMAX: Maximum contention window [a value of the form
785 *	2^n-1 in the range 1..32767]
786 * @NL80211_TXQ_ATTR_AIFS: Arbitration interframe space [0..255]
787 * @__NL80211_TXQ_ATTR_AFTER_LAST: Internal
788 * @NL80211_TXQ_ATTR_MAX: Maximum TXQ attribute number
789 */
790enum nl80211_txq_attr {
791	__NL80211_TXQ_ATTR_INVALID,
792	NL80211_TXQ_ATTR_QUEUE,
793	NL80211_TXQ_ATTR_TXOP,
794	NL80211_TXQ_ATTR_CWMIN,
795	NL80211_TXQ_ATTR_CWMAX,
796	NL80211_TXQ_ATTR_AIFS,
797
798	/* keep last */
799	__NL80211_TXQ_ATTR_AFTER_LAST,
800	NL80211_TXQ_ATTR_MAX = __NL80211_TXQ_ATTR_AFTER_LAST - 1
801};
802
803enum nl80211_txq_q {
804	NL80211_TXQ_Q_VO,
805	NL80211_TXQ_Q_VI,
806	NL80211_TXQ_Q_BE,
807	NL80211_TXQ_Q_BK
808};
809
810enum nl80211_channel_type {
811	NL80211_CHAN_NO_HT,
812	NL80211_CHAN_HT20,
813	NL80211_CHAN_HT40MINUS,
814	NL80211_CHAN_HT40PLUS
815};
816#endif /* __LINUX_NL80211_H */
817