xref: /openbmc/linux/include/uapi/linux/nl80211.h (revision 275876e2)
1 #ifndef __LINUX_NL80211_H
2 #define __LINUX_NL80211_H
3 /*
4  * 802.11 netlink interface public header
5  *
6  * Copyright 2006-2010 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 <m@bues.ch>
10  * Copyright 2008, 2009 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 #include <linux/types.h>
29 
30 #define NL80211_GENL_NAME "nl80211"
31 
32 /**
33  * DOC: Station handling
34  *
35  * Stations are added per interface, but a special case exists with VLAN
36  * interfaces. When a station is bound to an AP interface, it may be moved
37  * into a VLAN identified by a VLAN interface index (%NL80211_ATTR_STA_VLAN).
38  * The station is still assumed to belong to the AP interface it was added
39  * to.
40  *
41  * Station handling varies per interface type and depending on the driver's
42  * capabilities.
43  *
44  * For drivers supporting TDLS with external setup (WIPHY_FLAG_SUPPORTS_TDLS
45  * and WIPHY_FLAG_TDLS_EXTERNAL_SETUP), the station lifetime is as follows:
46  *  - a setup station entry is added, not yet authorized, without any rate
47  *    or capability information, this just exists to avoid race conditions
48  *  - when the TDLS setup is done, a single NL80211_CMD_SET_STATION is valid
49  *    to add rate and capability information to the station and at the same
50  *    time mark it authorized.
51  *  - %NL80211_TDLS_ENABLE_LINK is then used
52  *  - after this, the only valid operation is to remove it by tearing down
53  *    the TDLS link (%NL80211_TDLS_DISABLE_LINK)
54  *
55  * TODO: need more info for other interface types
56  */
57 
58 /**
59  * DOC: Frame transmission/registration support
60  *
61  * Frame transmission and registration support exists to allow userspace
62  * management entities such as wpa_supplicant react to management frames
63  * that are not being handled by the kernel. This includes, for example,
64  * certain classes of action frames that cannot be handled in the kernel
65  * for various reasons.
66  *
67  * Frame registration is done on a per-interface basis and registrations
68  * cannot be removed other than by closing the socket. It is possible to
69  * specify a registration filter to register, for example, only for a
70  * certain type of action frame. In particular with action frames, those
71  * that userspace registers for will not be returned as unhandled by the
72  * driver, so that the registered application has to take responsibility
73  * for doing that.
74  *
75  * The type of frame that can be registered for is also dependent on the
76  * driver and interface type. The frame types are advertised in wiphy
77  * attributes so applications know what to expect.
78  *
79  * NOTE: When an interface changes type while registrations are active,
80  *       these registrations are ignored until the interface type is
81  *       changed again. This means that changing the interface type can
82  *       lead to a situation that couldn't otherwise be produced, but
83  *       any such registrations will be dormant in the sense that they
84  *       will not be serviced, i.e. they will not receive any frames.
85  *
86  * Frame transmission allows userspace to send for example the required
87  * responses to action frames. It is subject to some sanity checking,
88  * but many frames can be transmitted. When a frame was transmitted, its
89  * status is indicated to the sending socket.
90  *
91  * For more technical details, see the corresponding command descriptions
92  * below.
93  */
94 
95 /**
96  * DOC: Virtual interface / concurrency capabilities
97  *
98  * Some devices are able to operate with virtual MACs, they can have
99  * more than one virtual interface. The capability handling for this
100  * is a bit complex though, as there may be a number of restrictions
101  * on the types of concurrency that are supported.
102  *
103  * To start with, each device supports the interface types listed in
104  * the %NL80211_ATTR_SUPPORTED_IFTYPES attribute, but by listing the
105  * types there no concurrency is implied.
106  *
107  * Once concurrency is desired, more attributes must be observed:
108  * To start with, since some interface types are purely managed in
109  * software, like the AP-VLAN type in mac80211 for example, there's
110  * an additional list of these, they can be added at any time and
111  * are only restricted by some semantic restrictions (e.g. AP-VLAN
112  * cannot be added without a corresponding AP interface). This list
113  * is exported in the %NL80211_ATTR_SOFTWARE_IFTYPES attribute.
114  *
115  * Further, the list of supported combinations is exported. This is
116  * in the %NL80211_ATTR_INTERFACE_COMBINATIONS attribute. Basically,
117  * it exports a list of "groups", and at any point in time the
118  * interfaces that are currently active must fall into any one of
119  * the advertised groups. Within each group, there are restrictions
120  * on the number of interfaces of different types that are supported
121  * and also the number of different channels, along with potentially
122  * some other restrictions. See &enum nl80211_if_combination_attrs.
123  *
124  * All together, these attributes define the concurrency of virtual
125  * interfaces that a given device supports.
126  */
127 
128 /**
129  * DOC: packet coalesce support
130  *
131  * In most cases, host that receives IPv4 and IPv6 multicast/broadcast
132  * packets does not do anything with these packets. Therefore the
133  * reception of these unwanted packets causes unnecessary processing
134  * and power consumption.
135  *
136  * Packet coalesce feature helps to reduce number of received interrupts
137  * to host by buffering these packets in firmware/hardware for some
138  * predefined time. Received interrupt will be generated when one of the
139  * following events occur.
140  * a) Expiration of hardware timer whose expiration time is set to maximum
141  * coalescing delay of matching coalesce rule.
142  * b) Coalescing buffer in hardware reaches it's limit.
143  * c) Packet doesn't match any of the configured coalesce rules.
144  *
145  * User needs to configure following parameters for creating a coalesce
146  * rule.
147  * a) Maximum coalescing delay
148  * b) List of packet patterns which needs to be matched
149  * c) Condition for coalescence. pattern 'match' or 'no match'
150  * Multiple such rules can be created.
151  */
152 
153 /**
154  * enum nl80211_commands - supported nl80211 commands
155  *
156  * @NL80211_CMD_UNSPEC: unspecified command to catch errors
157  *
158  * @NL80211_CMD_GET_WIPHY: request information about a wiphy or dump request
159  *	to get a list of all present wiphys.
160  * @NL80211_CMD_SET_WIPHY: set wiphy parameters, needs %NL80211_ATTR_WIPHY or
161  *	%NL80211_ATTR_IFINDEX; can be used to set %NL80211_ATTR_WIPHY_NAME,
162  *	%NL80211_ATTR_WIPHY_TXQ_PARAMS, %NL80211_ATTR_WIPHY_FREQ (and the
163  *	attributes determining the channel width; this is used for setting
164  *	monitor mode channel),  %NL80211_ATTR_WIPHY_RETRY_SHORT,
165  *	%NL80211_ATTR_WIPHY_RETRY_LONG, %NL80211_ATTR_WIPHY_FRAG_THRESHOLD,
166  *	and/or %NL80211_ATTR_WIPHY_RTS_THRESHOLD.
167  *	However, for setting the channel, see %NL80211_CMD_SET_CHANNEL
168  *	instead, the support here is for backward compatibility only.
169  * @NL80211_CMD_NEW_WIPHY: Newly created wiphy, response to get request
170  *	or rename notification. Has attributes %NL80211_ATTR_WIPHY and
171  *	%NL80211_ATTR_WIPHY_NAME.
172  * @NL80211_CMD_DEL_WIPHY: Wiphy deleted. Has attributes
173  *	%NL80211_ATTR_WIPHY and %NL80211_ATTR_WIPHY_NAME.
174  *
175  * @NL80211_CMD_GET_INTERFACE: Request an interface's configuration;
176  *	either a dump request on a %NL80211_ATTR_WIPHY or a specific get
177  *	on an %NL80211_ATTR_IFINDEX is supported.
178  * @NL80211_CMD_SET_INTERFACE: Set type of a virtual interface, requires
179  *	%NL80211_ATTR_IFINDEX and %NL80211_ATTR_IFTYPE.
180  * @NL80211_CMD_NEW_INTERFACE: Newly created virtual interface or response
181  *	to %NL80211_CMD_GET_INTERFACE. Has %NL80211_ATTR_IFINDEX,
182  *	%NL80211_ATTR_WIPHY and %NL80211_ATTR_IFTYPE attributes. Can also
183  *	be sent from userspace to request creation of a new virtual interface,
184  *	then requires attributes %NL80211_ATTR_WIPHY, %NL80211_ATTR_IFTYPE and
185  *	%NL80211_ATTR_IFNAME.
186  * @NL80211_CMD_DEL_INTERFACE: Virtual interface was deleted, has attributes
187  *	%NL80211_ATTR_IFINDEX and %NL80211_ATTR_WIPHY. Can also be sent from
188  *	userspace to request deletion of a virtual interface, then requires
189  *	attribute %NL80211_ATTR_IFINDEX.
190  *
191  * @NL80211_CMD_GET_KEY: Get sequence counter information for a key specified
192  *	by %NL80211_ATTR_KEY_IDX and/or %NL80211_ATTR_MAC.
193  * @NL80211_CMD_SET_KEY: Set key attributes %NL80211_ATTR_KEY_DEFAULT,
194  *	%NL80211_ATTR_KEY_DEFAULT_MGMT, or %NL80211_ATTR_KEY_THRESHOLD.
195  * @NL80211_CMD_NEW_KEY: add a key with given %NL80211_ATTR_KEY_DATA,
196  *	%NL80211_ATTR_KEY_IDX, %NL80211_ATTR_MAC, %NL80211_ATTR_KEY_CIPHER,
197  *	and %NL80211_ATTR_KEY_SEQ attributes.
198  * @NL80211_CMD_DEL_KEY: delete a key identified by %NL80211_ATTR_KEY_IDX
199  *	or %NL80211_ATTR_MAC.
200  *
201  * @NL80211_CMD_GET_BEACON: (not used)
202  * @NL80211_CMD_SET_BEACON: change the beacon on an access point interface
203  *	using the %NL80211_ATTR_BEACON_HEAD and %NL80211_ATTR_BEACON_TAIL
204  *	attributes. For drivers that generate the beacon and probe responses
205  *	internally, the following attributes must be provided: %NL80211_ATTR_IE,
206  *	%NL80211_ATTR_IE_PROBE_RESP and %NL80211_ATTR_IE_ASSOC_RESP.
207  * @NL80211_CMD_START_AP: Start AP operation on an AP interface, parameters
208  *	are like for %NL80211_CMD_SET_BEACON, and additionally parameters that
209  *	do not change are used, these include %NL80211_ATTR_BEACON_INTERVAL,
210  *	%NL80211_ATTR_DTIM_PERIOD, %NL80211_ATTR_SSID,
211  *	%NL80211_ATTR_HIDDEN_SSID, %NL80211_ATTR_CIPHERS_PAIRWISE,
212  *	%NL80211_ATTR_CIPHER_GROUP, %NL80211_ATTR_WPA_VERSIONS,
213  *	%NL80211_ATTR_AKM_SUITES, %NL80211_ATTR_PRIVACY,
214  *	%NL80211_ATTR_AUTH_TYPE, %NL80211_ATTR_INACTIVITY_TIMEOUT,
215  *	%NL80211_ATTR_ACL_POLICY and %NL80211_ATTR_MAC_ADDRS.
216  *	The channel to use can be set on the interface or be given using the
217  *	%NL80211_ATTR_WIPHY_FREQ and the attributes determining channel width.
218  * @NL80211_CMD_NEW_BEACON: old alias for %NL80211_CMD_START_AP
219  * @NL80211_CMD_STOP_AP: Stop AP operation on the given interface
220  * @NL80211_CMD_DEL_BEACON: old alias for %NL80211_CMD_STOP_AP
221  *
222  * @NL80211_CMD_GET_STATION: Get station attributes for station identified by
223  *	%NL80211_ATTR_MAC on the interface identified by %NL80211_ATTR_IFINDEX.
224  * @NL80211_CMD_SET_STATION: Set station attributes for station identified by
225  *	%NL80211_ATTR_MAC on the interface identified by %NL80211_ATTR_IFINDEX.
226  * @NL80211_CMD_NEW_STATION: Add a station with given attributes to the
227  *	the interface identified by %NL80211_ATTR_IFINDEX.
228  * @NL80211_CMD_DEL_STATION: Remove a station identified by %NL80211_ATTR_MAC
229  *	or, if no MAC address given, all stations, on the interface identified
230  *	by %NL80211_ATTR_IFINDEX.
231  *
232  * @NL80211_CMD_GET_MPATH: Get mesh path attributes for mesh path to
233  * 	destination %NL80211_ATTR_MAC on the interface identified by
234  * 	%NL80211_ATTR_IFINDEX.
235  * @NL80211_CMD_SET_MPATH:  Set mesh path attributes for mesh path to
236  * 	destination %NL80211_ATTR_MAC on the interface identified by
237  * 	%NL80211_ATTR_IFINDEX.
238  * @NL80211_CMD_NEW_MPATH: Create a new mesh path for the destination given by
239  *	%NL80211_ATTR_MAC via %NL80211_ATTR_MPATH_NEXT_HOP.
240  * @NL80211_CMD_DEL_MPATH: Delete a mesh path to the destination given by
241  *	%NL80211_ATTR_MAC.
242  * @NL80211_CMD_NEW_PATH: Add a mesh path with given attributes to the
243  *	the interface identified by %NL80211_ATTR_IFINDEX.
244  * @NL80211_CMD_DEL_PATH: Remove a mesh path identified by %NL80211_ATTR_MAC
245  *	or, if no MAC address given, all mesh paths, on the interface identified
246  *	by %NL80211_ATTR_IFINDEX.
247  * @NL80211_CMD_SET_BSS: Set BSS attributes for BSS identified by
248  *	%NL80211_ATTR_IFINDEX.
249  *
250  * @NL80211_CMD_GET_REG: ask the wireless core to send us its currently set
251  * 	regulatory domain.
252  * @NL80211_CMD_SET_REG: Set current regulatory domain. CRDA sends this command
253  *	after being queried by the kernel. CRDA replies by sending a regulatory
254  *	domain structure which consists of %NL80211_ATTR_REG_ALPHA set to our
255  *	current alpha2 if it found a match. It also provides
256  * 	NL80211_ATTR_REG_RULE_FLAGS, and a set of regulatory rules. Each
257  * 	regulatory rule is a nested set of attributes  given by
258  * 	%NL80211_ATTR_REG_RULE_FREQ_[START|END] and
259  * 	%NL80211_ATTR_FREQ_RANGE_MAX_BW with an attached power rule given by
260  * 	%NL80211_ATTR_REG_RULE_POWER_MAX_ANT_GAIN and
261  * 	%NL80211_ATTR_REG_RULE_POWER_MAX_EIRP.
262  * @NL80211_CMD_REQ_SET_REG: ask the wireless core to set the regulatory domain
263  * 	to the specified ISO/IEC 3166-1 alpha2 country code. The core will
264  * 	store this as a valid request and then query userspace for it.
265  *
266  * @NL80211_CMD_GET_MESH_CONFIG: Get mesh networking properties for the
267  *	interface identified by %NL80211_ATTR_IFINDEX
268  *
269  * @NL80211_CMD_SET_MESH_CONFIG: Set mesh networking properties for the
270  *      interface identified by %NL80211_ATTR_IFINDEX
271  *
272  * @NL80211_CMD_SET_MGMT_EXTRA_IE: Set extra IEs for management frames. The
273  *	interface is identified with %NL80211_ATTR_IFINDEX and the management
274  *	frame subtype with %NL80211_ATTR_MGMT_SUBTYPE. The extra IE data to be
275  *	added to the end of the specified management frame is specified with
276  *	%NL80211_ATTR_IE. If the command succeeds, the requested data will be
277  *	added to all specified management frames generated by
278  *	kernel/firmware/driver.
279  *	Note: This command has been removed and it is only reserved at this
280  *	point to avoid re-using existing command number. The functionality this
281  *	command was planned for has been provided with cleaner design with the
282  *	option to specify additional IEs in NL80211_CMD_TRIGGER_SCAN,
283  *	NL80211_CMD_AUTHENTICATE, NL80211_CMD_ASSOCIATE,
284  *	NL80211_CMD_DEAUTHENTICATE, and NL80211_CMD_DISASSOCIATE.
285  *
286  * @NL80211_CMD_GET_SCAN: get scan results
287  * @NL80211_CMD_TRIGGER_SCAN: trigger a new scan with the given parameters
288  *	%NL80211_ATTR_TX_NO_CCK_RATE is used to decide whether to send the
289  *	probe requests at CCK rate or not.
290  * @NL80211_CMD_NEW_SCAN_RESULTS: scan notification (as a reply to
291  *	NL80211_CMD_GET_SCAN and on the "scan" multicast group)
292  * @NL80211_CMD_SCAN_ABORTED: scan was aborted, for unspecified reasons,
293  *	partial scan results may be available
294  *
295  * @NL80211_CMD_START_SCHED_SCAN: start a scheduled scan at certain
296  *	intervals, as specified by %NL80211_ATTR_SCHED_SCAN_INTERVAL.
297  *	Like with normal scans, if SSIDs (%NL80211_ATTR_SCAN_SSIDS)
298  *	are passed, they are used in the probe requests.  For
299  *	broadcast, a broadcast SSID must be passed (ie. an empty
300  *	string).  If no SSID is passed, no probe requests are sent and
301  *	a passive scan is performed.  %NL80211_ATTR_SCAN_FREQUENCIES,
302  *	if passed, define which channels should be scanned; if not
303  *	passed, all channels allowed for the current regulatory domain
304  *	are used.  Extra IEs can also be passed from the userspace by
305  *	using the %NL80211_ATTR_IE attribute.
306  * @NL80211_CMD_STOP_SCHED_SCAN: stop a scheduled scan. Returns -ENOENT if
307  *	scheduled scan is not running. The caller may assume that as soon
308  *	as the call returns, it is safe to start a new scheduled scan again.
309  * @NL80211_CMD_SCHED_SCAN_RESULTS: indicates that there are scheduled scan
310  *	results available.
311  * @NL80211_CMD_SCHED_SCAN_STOPPED: indicates that the scheduled scan has
312  *	stopped.  The driver may issue this event at any time during a
313  *	scheduled scan.  One reason for stopping the scan is if the hardware
314  *	does not support starting an association or a normal scan while running
315  *	a scheduled scan.  This event is also sent when the
316  *	%NL80211_CMD_STOP_SCHED_SCAN command is received or when the interface
317  *	is brought down while a scheduled scan was running.
318  *
319  * @NL80211_CMD_GET_SURVEY: get survey resuls, e.g. channel occupation
320  *      or noise level
321  * @NL80211_CMD_NEW_SURVEY_RESULTS: survey data notification (as a reply to
322  *	NL80211_CMD_GET_SURVEY and on the "scan" multicast group)
323  *
324  * @NL80211_CMD_SET_PMKSA: Add a PMKSA cache entry, using %NL80211_ATTR_MAC
325  *	(for the BSSID) and %NL80211_ATTR_PMKID.
326  * @NL80211_CMD_DEL_PMKSA: Delete a PMKSA cache entry, using %NL80211_ATTR_MAC
327  *	(for the BSSID) and %NL80211_ATTR_PMKID.
328  * @NL80211_CMD_FLUSH_PMKSA: Flush all PMKSA cache entries.
329  *
330  * @NL80211_CMD_REG_CHANGE: indicates to userspace the regulatory domain
331  * 	has been changed and provides details of the request information
332  * 	that caused the change such as who initiated the regulatory request
333  * 	(%NL80211_ATTR_REG_INITIATOR), the wiphy_idx
334  * 	(%NL80211_ATTR_REG_ALPHA2) on which the request was made from if
335  * 	the initiator was %NL80211_REGDOM_SET_BY_COUNTRY_IE or
336  * 	%NL80211_REGDOM_SET_BY_DRIVER, the type of regulatory domain
337  * 	set (%NL80211_ATTR_REG_TYPE), if the type of regulatory domain is
338  * 	%NL80211_REG_TYPE_COUNTRY the alpha2 to which we have moved on
339  * 	to (%NL80211_ATTR_REG_ALPHA2).
340  * @NL80211_CMD_REG_BEACON_HINT: indicates to userspace that an AP beacon
341  * 	has been found while world roaming thus enabling active scan or
342  * 	any mode of operation that initiates TX (beacons) on a channel
343  * 	where we would not have been able to do either before. As an example
344  * 	if you are world roaming (regulatory domain set to world or if your
345  * 	driver is using a custom world roaming regulatory domain) and while
346  * 	doing a passive scan on the 5 GHz band you find an AP there (if not
347  * 	on a DFS channel) you will now be able to actively scan for that AP
348  * 	or use AP mode on your card on that same channel. Note that this will
349  * 	never be used for channels 1-11 on the 2 GHz band as they are always
350  * 	enabled world wide. This beacon hint is only sent if your device had
351  * 	either disabled active scanning or beaconing on a channel. We send to
352  * 	userspace the wiphy on which we removed a restriction from
353  * 	(%NL80211_ATTR_WIPHY) and the channel on which this occurred
354  * 	before (%NL80211_ATTR_FREQ_BEFORE) and after (%NL80211_ATTR_FREQ_AFTER)
355  * 	the beacon hint was processed.
356  *
357  * @NL80211_CMD_AUTHENTICATE: authentication request and notification.
358  *	This command is used both as a command (request to authenticate) and
359  *	as an event on the "mlme" multicast group indicating completion of the
360  *	authentication process.
361  *	When used as a command, %NL80211_ATTR_IFINDEX is used to identify the
362  *	interface. %NL80211_ATTR_MAC is used to specify PeerSTAAddress (and
363  *	BSSID in case of station mode). %NL80211_ATTR_SSID is used to specify
364  *	the SSID (mainly for association, but is included in authentication
365  *	request, too, to help BSS selection. %NL80211_ATTR_WIPHY_FREQ is used
366  *	to specify the frequence of the channel in MHz. %NL80211_ATTR_AUTH_TYPE
367  *	is used to specify the authentication type. %NL80211_ATTR_IE is used to
368  *	define IEs (VendorSpecificInfo, but also including RSN IE and FT IEs)
369  *	to be added to the frame.
370  *	When used as an event, this reports reception of an Authentication
371  *	frame in station and IBSS modes when the local MLME processed the
372  *	frame, i.e., it was for the local STA and was received in correct
373  *	state. This is similar to MLME-AUTHENTICATE.confirm primitive in the
374  *	MLME SAP interface (kernel providing MLME, userspace SME). The
375  *	included %NL80211_ATTR_FRAME attribute contains the management frame
376  *	(including both the header and frame body, but not FCS). This event is
377  *	also used to indicate if the authentication attempt timed out. In that
378  *	case the %NL80211_ATTR_FRAME attribute is replaced with a
379  *	%NL80211_ATTR_TIMED_OUT flag (and %NL80211_ATTR_MAC to indicate which
380  *	pending authentication timed out).
381  * @NL80211_CMD_ASSOCIATE: association request and notification; like
382  *	NL80211_CMD_AUTHENTICATE but for Association and Reassociation
383  *	(similar to MLME-ASSOCIATE.request, MLME-REASSOCIATE.request,
384  *	MLME-ASSOCIATE.confirm or MLME-REASSOCIATE.confirm primitives).
385  * @NL80211_CMD_DEAUTHENTICATE: deauthentication request and notification; like
386  *	NL80211_CMD_AUTHENTICATE but for Deauthentication frames (similar to
387  *	MLME-DEAUTHENTICATION.request and MLME-DEAUTHENTICATE.indication
388  *	primitives).
389  * @NL80211_CMD_DISASSOCIATE: disassociation request and notification; like
390  *	NL80211_CMD_AUTHENTICATE but for Disassociation frames (similar to
391  *	MLME-DISASSOCIATE.request and MLME-DISASSOCIATE.indication primitives).
392  *
393  * @NL80211_CMD_MICHAEL_MIC_FAILURE: notification of a locally detected Michael
394  *	MIC (part of TKIP) failure; sent on the "mlme" multicast group; the
395  *	event includes %NL80211_ATTR_MAC to describe the source MAC address of
396  *	the frame with invalid MIC, %NL80211_ATTR_KEY_TYPE to show the key
397  *	type, %NL80211_ATTR_KEY_IDX to indicate the key identifier, and
398  *	%NL80211_ATTR_KEY_SEQ to indicate the TSC value of the frame; this
399  *	event matches with MLME-MICHAELMICFAILURE.indication() primitive
400  *
401  * @NL80211_CMD_JOIN_IBSS: Join a new IBSS -- given at least an SSID and a
402  *	FREQ attribute (for the initial frequency if no peer can be found)
403  *	and optionally a MAC (as BSSID) and FREQ_FIXED attribute if those
404  *	should be fixed rather than automatically determined. Can only be
405  *	executed on a network interface that is UP, and fixed BSSID/FREQ
406  *	may be rejected. Another optional parameter is the beacon interval,
407  *	given in the %NL80211_ATTR_BEACON_INTERVAL attribute, which if not
408  *	given defaults to 100 TU (102.4ms).
409  * @NL80211_CMD_LEAVE_IBSS: Leave the IBSS -- no special arguments, the IBSS is
410  *	determined by the network interface.
411  *
412  * @NL80211_CMD_TESTMODE: testmode command, takes a wiphy (or ifindex) attribute
413  *	to identify the device, and the TESTDATA blob attribute to pass through
414  *	to the driver.
415  *
416  * @NL80211_CMD_CONNECT: connection request and notification; this command
417  *	requests to connect to a specified network but without separating
418  *	auth and assoc steps. For this, you need to specify the SSID in a
419  *	%NL80211_ATTR_SSID attribute, and can optionally specify the association
420  *	IEs in %NL80211_ATTR_IE, %NL80211_ATTR_AUTH_TYPE, %NL80211_ATTR_USE_MFP,
421  *	%NL80211_ATTR_MAC, %NL80211_ATTR_WIPHY_FREQ, %NL80211_ATTR_CONTROL_PORT,
422  *	%NL80211_ATTR_CONTROL_PORT_ETHERTYPE,
423  *	%NL80211_ATTR_CONTROL_PORT_NO_ENCRYPT, %NL80211_ATTR_MAC_HINT, and
424  *	%NL80211_ATTR_WIPHY_FREQ_HINT.
425  *	If included, %NL80211_ATTR_MAC and %NL80211_ATTR_WIPHY_FREQ are
426  *	restrictions on BSS selection, i.e., they effectively prevent roaming
427  *	within the ESS. %NL80211_ATTR_MAC_HINT and %NL80211_ATTR_WIPHY_FREQ_HINT
428  *	can be included to provide a recommendation of the initial BSS while
429  *	allowing the driver to roam to other BSSes within the ESS and also to
430  *	ignore this recommendation if the indicated BSS is not ideal. Only one
431  *	set of BSSID,frequency parameters is used (i.e., either the enforcing
432  *	%NL80211_ATTR_MAC,%NL80211_ATTR_WIPHY_FREQ or the less strict
433  *	%NL80211_ATTR_MAC_HINT and %NL80211_ATTR_WIPHY_FREQ_HINT).
434  *	Background scan period can optionally be
435  *	specified in %NL80211_ATTR_BG_SCAN_PERIOD,
436  *	if not specified default background scan configuration
437  *	in driver is used and if period value is 0, bg scan will be disabled.
438  *	This attribute is ignored if driver does not support roam scan.
439  *	It is also sent as an event, with the BSSID and response IEs when the
440  *	connection is established or failed to be established. This can be
441  *	determined by the STATUS_CODE attribute.
442  * @NL80211_CMD_ROAM: request that the card roam (currently not implemented),
443  *	sent as an event when the card/driver roamed by itself.
444  * @NL80211_CMD_DISCONNECT: drop a given connection; also used to notify
445  *	userspace that a connection was dropped by the AP or due to other
446  *	reasons, for this the %NL80211_ATTR_DISCONNECTED_BY_AP and
447  *	%NL80211_ATTR_REASON_CODE attributes are used.
448  *
449  * @NL80211_CMD_SET_WIPHY_NETNS: Set a wiphy's netns. Note that all devices
450  *	associated with this wiphy must be down and will follow.
451  *
452  * @NL80211_CMD_REMAIN_ON_CHANNEL: Request to remain awake on the specified
453  *	channel for the specified amount of time. This can be used to do
454  *	off-channel operations like transmit a Public Action frame and wait for
455  *	a response while being associated to an AP on another channel.
456  *	%NL80211_ATTR_IFINDEX is used to specify which interface (and thus
457  *	radio) is used. %NL80211_ATTR_WIPHY_FREQ is used to specify the
458  *	frequency for the operation.
459  *	%NL80211_ATTR_DURATION is used to specify the duration in milliseconds
460  *	to remain on the channel. This command is also used as an event to
461  *	notify when the requested duration starts (it may take a while for the
462  *	driver to schedule this time due to other concurrent needs for the
463  *	radio).
464  *	When called, this operation returns a cookie (%NL80211_ATTR_COOKIE)
465  *	that will be included with any events pertaining to this request;
466  *	the cookie is also used to cancel the request.
467  * @NL80211_CMD_CANCEL_REMAIN_ON_CHANNEL: This command can be used to cancel a
468  *	pending remain-on-channel duration if the desired operation has been
469  *	completed prior to expiration of the originally requested duration.
470  *	%NL80211_ATTR_WIPHY or %NL80211_ATTR_IFINDEX is used to specify the
471  *	radio. The %NL80211_ATTR_COOKIE attribute must be given as well to
472  *	uniquely identify the request.
473  *	This command is also used as an event to notify when a requested
474  *	remain-on-channel duration has expired.
475  *
476  * @NL80211_CMD_SET_TX_BITRATE_MASK: Set the mask of rates to be used in TX
477  *	rate selection. %NL80211_ATTR_IFINDEX is used to specify the interface
478  *	and @NL80211_ATTR_TX_RATES the set of allowed rates.
479  *
480  * @NL80211_CMD_REGISTER_FRAME: Register for receiving certain mgmt frames
481  *	(via @NL80211_CMD_FRAME) for processing in userspace. This command
482  *	requires an interface index, a frame type attribute (optional for
483  *	backward compatibility reasons, if not given assumes action frames)
484  *	and a match attribute containing the first few bytes of the frame
485  *	that should match, e.g. a single byte for only a category match or
486  *	four bytes for vendor frames including the OUI. The registration
487  *	cannot be dropped, but is removed automatically when the netlink
488  *	socket is closed. Multiple registrations can be made.
489  * @NL80211_CMD_REGISTER_ACTION: Alias for @NL80211_CMD_REGISTER_FRAME for
490  *	backward compatibility
491  * @NL80211_CMD_FRAME: Management frame TX request and RX notification. This
492  *	command is used both as a request to transmit a management frame and
493  *	as an event indicating reception of a frame that was not processed in
494  *	kernel code, but is for us (i.e., which may need to be processed in a
495  *	user space application). %NL80211_ATTR_FRAME is used to specify the
496  *	frame contents (including header). %NL80211_ATTR_WIPHY_FREQ is used
497  *	to indicate on which channel the frame is to be transmitted or was
498  *	received. If this channel is not the current channel (remain-on-channel
499  *	or the operational channel) the device will switch to the given channel
500  *	and transmit the frame, optionally waiting for a response for the time
501  *	specified using %NL80211_ATTR_DURATION. When called, this operation
502  *	returns a cookie (%NL80211_ATTR_COOKIE) that will be included with the
503  *	TX status event pertaining to the TX request.
504  *	%NL80211_ATTR_TX_NO_CCK_RATE is used to decide whether to send the
505  *	management frames at CCK rate or not in 2GHz band.
506  *	%NL80211_ATTR_CSA_C_OFFSETS_TX is an array of offsets to CSA
507  *	counters which will be updated to the current value. This attribute
508  *	is used during CSA period.
509  * @NL80211_CMD_FRAME_WAIT_CANCEL: When an off-channel TX was requested, this
510  *	command may be used with the corresponding cookie to cancel the wait
511  *	time if it is known that it is no longer necessary.
512  * @NL80211_CMD_ACTION: Alias for @NL80211_CMD_FRAME for backward compatibility.
513  * @NL80211_CMD_FRAME_TX_STATUS: Report TX status of a management frame
514  *	transmitted with %NL80211_CMD_FRAME. %NL80211_ATTR_COOKIE identifies
515  *	the TX command and %NL80211_ATTR_FRAME includes the contents of the
516  *	frame. %NL80211_ATTR_ACK flag is included if the recipient acknowledged
517  *	the frame.
518  * @NL80211_CMD_ACTION_TX_STATUS: Alias for @NL80211_CMD_FRAME_TX_STATUS for
519  *	backward compatibility.
520  *
521  * @NL80211_CMD_SET_POWER_SAVE: Set powersave, using %NL80211_ATTR_PS_STATE
522  * @NL80211_CMD_GET_POWER_SAVE: Get powersave status in %NL80211_ATTR_PS_STATE
523  *
524  * @NL80211_CMD_SET_CQM: Connection quality monitor configuration. This command
525  *	is used to configure connection quality monitoring notification trigger
526  *	levels.
527  * @NL80211_CMD_NOTIFY_CQM: Connection quality monitor notification. This
528  *	command is used as an event to indicate the that a trigger level was
529  *	reached.
530  * @NL80211_CMD_SET_CHANNEL: Set the channel (using %NL80211_ATTR_WIPHY_FREQ
531  *	and the attributes determining channel width) the given interface
532  *	(identifed by %NL80211_ATTR_IFINDEX) shall operate on.
533  *	In case multiple channels are supported by the device, the mechanism
534  *	with which it switches channels is implementation-defined.
535  *	When a monitor interface is given, it can only switch channel while
536  *	no other interfaces are operating to avoid disturbing the operation
537  *	of any other interfaces, and other interfaces will again take
538  *	precedence when they are used.
539  *
540  * @NL80211_CMD_SET_WDS_PEER: Set the MAC address of the peer on a WDS interface.
541  *
542  * @NL80211_CMD_JOIN_MESH: Join a mesh. The mesh ID must be given, and initial
543  *	mesh config parameters may be given.
544  * @NL80211_CMD_LEAVE_MESH: Leave the mesh network -- no special arguments, the
545  *	network is determined by the network interface.
546  *
547  * @NL80211_CMD_UNPROT_DEAUTHENTICATE: Unprotected deauthentication frame
548  *	notification. This event is used to indicate that an unprotected
549  *	deauthentication frame was dropped when MFP is in use.
550  * @NL80211_CMD_UNPROT_DISASSOCIATE: Unprotected disassociation frame
551  *	notification. This event is used to indicate that an unprotected
552  *	disassociation frame was dropped when MFP is in use.
553  *
554  * @NL80211_CMD_NEW_PEER_CANDIDATE: Notification on the reception of a
555  *      beacon or probe response from a compatible mesh peer.  This is only
556  *      sent while no station information (sta_info) exists for the new peer
557  *      candidate and when @NL80211_MESH_SETUP_USERSPACE_AUTH,
558  *      @NL80211_MESH_SETUP_USERSPACE_AMPE, or
559  *      @NL80211_MESH_SETUP_USERSPACE_MPM is set.  On reception of this
560  *      notification, userspace may decide to create a new station
561  *      (@NL80211_CMD_NEW_STATION).  To stop this notification from
562  *      reoccurring, the userspace authentication daemon may want to create the
563  *      new station with the AUTHENTICATED flag unset and maybe change it later
564  *      depending on the authentication result.
565  *
566  * @NL80211_CMD_GET_WOWLAN: get Wake-on-Wireless-LAN (WoWLAN) settings.
567  * @NL80211_CMD_SET_WOWLAN: set Wake-on-Wireless-LAN (WoWLAN) settings.
568  *	Since wireless is more complex than wired ethernet, it supports
569  *	various triggers. These triggers can be configured through this
570  *	command with the %NL80211_ATTR_WOWLAN_TRIGGERS attribute. For
571  *	more background information, see
572  *	http://wireless.kernel.org/en/users/Documentation/WoWLAN.
573  *	The @NL80211_CMD_SET_WOWLAN command can also be used as a notification
574  *	from the driver reporting the wakeup reason. In this case, the
575  *	@NL80211_ATTR_WOWLAN_TRIGGERS attribute will contain the reason
576  *	for the wakeup, if it was caused by wireless. If it is not present
577  *	in the wakeup notification, the wireless device didn't cause the
578  *	wakeup but reports that it was woken up.
579  *
580  * @NL80211_CMD_SET_REKEY_OFFLOAD: This command is used give the driver
581  *	the necessary information for supporting GTK rekey offload. This
582  *	feature is typically used during WoWLAN. The configuration data
583  *	is contained in %NL80211_ATTR_REKEY_DATA (which is nested and
584  *	contains the data in sub-attributes). After rekeying happened,
585  *	this command may also be sent by the driver as an MLME event to
586  *	inform userspace of the new replay counter.
587  *
588  * @NL80211_CMD_PMKSA_CANDIDATE: This is used as an event to inform userspace
589  *	of PMKSA caching dandidates.
590  *
591  * @NL80211_CMD_TDLS_OPER: Perform a high-level TDLS command (e.g. link setup).
592  *	In addition, this can be used as an event to request userspace to take
593  *	actions on TDLS links (set up a new link or tear down an existing one).
594  *	In such events, %NL80211_ATTR_TDLS_OPERATION indicates the requested
595  *	operation, %NL80211_ATTR_MAC contains the peer MAC address, and
596  *	%NL80211_ATTR_REASON_CODE the reason code to be used (only with
597  *	%NL80211_TDLS_TEARDOWN).
598  * @NL80211_CMD_TDLS_MGMT: Send a TDLS management frame. The
599  *	%NL80211_ATTR_TDLS_ACTION attribute determines the type of frame to be
600  *	sent. Public Action codes (802.11-2012 8.1.5.1) will be sent as
601  *	802.11 management frames, while TDLS action codes (802.11-2012
602  *	8.5.13.1) will be encapsulated and sent as data frames. The currently
603  *	supported Public Action code is %WLAN_PUB_ACTION_TDLS_DISCOVER_RES
604  *	and the currently supported TDLS actions codes are given in
605  *	&enum ieee80211_tdls_actioncode.
606  *
607  * @NL80211_CMD_UNEXPECTED_FRAME: Used by an application controlling an AP
608  *	(or GO) interface (i.e. hostapd) to ask for unexpected frames to
609  *	implement sending deauth to stations that send unexpected class 3
610  *	frames. Also used as the event sent by the kernel when such a frame
611  *	is received.
612  *	For the event, the %NL80211_ATTR_MAC attribute carries the TA and
613  *	other attributes like the interface index are present.
614  *	If used as the command it must have an interface index and you can
615  *	only unsubscribe from the event by closing the socket. Subscription
616  *	is also for %NL80211_CMD_UNEXPECTED_4ADDR_FRAME events.
617  *
618  * @NL80211_CMD_UNEXPECTED_4ADDR_FRAME: Sent as an event indicating that the
619  *	associated station identified by %NL80211_ATTR_MAC sent a 4addr frame
620  *	and wasn't already in a 4-addr VLAN. The event will be sent similarly
621  *	to the %NL80211_CMD_UNEXPECTED_FRAME event, to the same listener.
622  *
623  * @NL80211_CMD_PROBE_CLIENT: Probe an associated station on an AP interface
624  *	by sending a null data frame to it and reporting when the frame is
625  *	acknowleged. This is used to allow timing out inactive clients. Uses
626  *	%NL80211_ATTR_IFINDEX and %NL80211_ATTR_MAC. The command returns a
627  *	direct reply with an %NL80211_ATTR_COOKIE that is later used to match
628  *	up the event with the request. The event includes the same data and
629  *	has %NL80211_ATTR_ACK set if the frame was ACKed.
630  *
631  * @NL80211_CMD_REGISTER_BEACONS: Register this socket to receive beacons from
632  *	other BSSes when any interfaces are in AP mode. This helps implement
633  *	OLBC handling in hostapd. Beacons are reported in %NL80211_CMD_FRAME
634  *	messages. Note that per PHY only one application may register.
635  *
636  * @NL80211_CMD_SET_NOACK_MAP: sets a bitmap for the individual TIDs whether
637  *      No Acknowledgement Policy should be applied.
638  *
639  * @NL80211_CMD_CH_SWITCH_NOTIFY: An AP or GO may decide to switch channels
640  *	independently of the userspace SME, send this event indicating
641  *	%NL80211_ATTR_IFINDEX is now on %NL80211_ATTR_WIPHY_FREQ and the
642  *	attributes determining channel width.
643  *
644  * @NL80211_CMD_START_P2P_DEVICE: Start the given P2P Device, identified by
645  *	its %NL80211_ATTR_WDEV identifier. It must have been created with
646  *	%NL80211_CMD_NEW_INTERFACE previously. After it has been started, the
647  *	P2P Device can be used for P2P operations, e.g. remain-on-channel and
648  *	public action frame TX.
649  * @NL80211_CMD_STOP_P2P_DEVICE: Stop the given P2P Device, identified by
650  *	its %NL80211_ATTR_WDEV identifier.
651  *
652  * @NL80211_CMD_CONN_FAILED: connection request to an AP failed; used to
653  *	notify userspace that AP has rejected the connection request from a
654  *	station, due to particular reason. %NL80211_ATTR_CONN_FAILED_REASON
655  *	is used for this.
656  *
657  * @NL80211_CMD_SET_MCAST_RATE: Change the rate used to send multicast frames
658  *	for IBSS or MESH vif.
659  *
660  * @NL80211_CMD_SET_MAC_ACL: sets ACL for MAC address based access control.
661  *	This is to be used with the drivers advertising the support of MAC
662  *	address based access control. List of MAC addresses is passed in
663  *	%NL80211_ATTR_MAC_ADDRS and ACL policy is passed in
664  *	%NL80211_ATTR_ACL_POLICY. Driver will enable ACL with this list, if it
665  *	is not already done. The new list will replace any existing list. Driver
666  *	will clear its ACL when the list of MAC addresses passed is empty. This
667  *	command is used in AP/P2P GO mode. Driver has to make sure to clear its
668  *	ACL list during %NL80211_CMD_STOP_AP.
669  *
670  * @NL80211_CMD_RADAR_DETECT: Start a Channel availability check (CAC). Once
671  *	a radar is detected or the channel availability scan (CAC) has finished
672  *	or was aborted, or a radar was detected, usermode will be notified with
673  *	this event. This command is also used to notify userspace about radars
674  *	while operating on this channel.
675  *	%NL80211_ATTR_RADAR_EVENT is used to inform about the type of the
676  *	event.
677  *
678  * @NL80211_CMD_GET_PROTOCOL_FEATURES: Get global nl80211 protocol features,
679  *	i.e. features for the nl80211 protocol rather than device features.
680  *	Returns the features in the %NL80211_ATTR_PROTOCOL_FEATURES bitmap.
681  *
682  * @NL80211_CMD_UPDATE_FT_IES: Pass down the most up-to-date Fast Transition
683  *	Information Element to the WLAN driver
684  *
685  * @NL80211_CMD_FT_EVENT: Send a Fast transition event from the WLAN driver
686  *	to the supplicant. This will carry the target AP's MAC address along
687  *	with the relevant Information Elements. This event is used to report
688  *	received FT IEs (MDIE, FTIE, RSN IE, TIE, RICIE).
689  *
690  * @NL80211_CMD_CRIT_PROTOCOL_START: Indicates user-space will start running
691  *	a critical protocol that needs more reliability in the connection to
692  *	complete.
693  *
694  * @NL80211_CMD_CRIT_PROTOCOL_STOP: Indicates the connection reliability can
695  *	return back to normal.
696  *
697  * @NL80211_CMD_GET_COALESCE: Get currently supported coalesce rules.
698  * @NL80211_CMD_SET_COALESCE: Configure coalesce rules or clear existing rules.
699  *
700  * @NL80211_CMD_CHANNEL_SWITCH: Perform a channel switch by announcing the
701  *	the new channel information (Channel Switch Announcement - CSA)
702  *	in the beacon for some time (as defined in the
703  *	%NL80211_ATTR_CH_SWITCH_COUNT parameter) and then change to the
704  *	new channel. Userspace provides the new channel information (using
705  *	%NL80211_ATTR_WIPHY_FREQ and the attributes determining channel
706  *	width). %NL80211_ATTR_CH_SWITCH_BLOCK_TX may be supplied to inform
707  *	other station that transmission must be blocked until the channel
708  *	switch is complete.
709  *
710  * @NL80211_CMD_VENDOR: Vendor-specified command/event. The command is specified
711  *	by the %NL80211_ATTR_VENDOR_ID attribute and a sub-command in
712  *	%NL80211_ATTR_VENDOR_SUBCMD. Parameter(s) can be transported in
713  *	%NL80211_ATTR_VENDOR_DATA.
714  *	For feature advertisement, the %NL80211_ATTR_VENDOR_DATA attribute is
715  *	used in the wiphy data as a nested attribute containing descriptions
716  *	(&struct nl80211_vendor_cmd_info) of the supported vendor commands.
717  *	This may also be sent as an event with the same attributes.
718  *
719  * @NL80211_CMD_SET_QOS_MAP: Set Interworking QoS mapping for IP DSCP values.
720  *	The QoS mapping information is included in %NL80211_ATTR_QOS_MAP. If
721  *	that attribute is not included, QoS mapping is disabled. Since this
722  *	QoS mapping is relevant for IP packets, it is only valid during an
723  *	association. This is cleared on disassociation and AP restart.
724  *
725  * @NL80211_CMD_MAX: highest used command number
726  * @__NL80211_CMD_AFTER_LAST: internal use
727  */
728 enum nl80211_commands {
729 /* don't change the order or add anything between, this is ABI! */
730 	NL80211_CMD_UNSPEC,
731 
732 	NL80211_CMD_GET_WIPHY,		/* can dump */
733 	NL80211_CMD_SET_WIPHY,
734 	NL80211_CMD_NEW_WIPHY,
735 	NL80211_CMD_DEL_WIPHY,
736 
737 	NL80211_CMD_GET_INTERFACE,	/* can dump */
738 	NL80211_CMD_SET_INTERFACE,
739 	NL80211_CMD_NEW_INTERFACE,
740 	NL80211_CMD_DEL_INTERFACE,
741 
742 	NL80211_CMD_GET_KEY,
743 	NL80211_CMD_SET_KEY,
744 	NL80211_CMD_NEW_KEY,
745 	NL80211_CMD_DEL_KEY,
746 
747 	NL80211_CMD_GET_BEACON,
748 	NL80211_CMD_SET_BEACON,
749 	NL80211_CMD_START_AP,
750 	NL80211_CMD_NEW_BEACON = NL80211_CMD_START_AP,
751 	NL80211_CMD_STOP_AP,
752 	NL80211_CMD_DEL_BEACON = NL80211_CMD_STOP_AP,
753 
754 	NL80211_CMD_GET_STATION,
755 	NL80211_CMD_SET_STATION,
756 	NL80211_CMD_NEW_STATION,
757 	NL80211_CMD_DEL_STATION,
758 
759 	NL80211_CMD_GET_MPATH,
760 	NL80211_CMD_SET_MPATH,
761 	NL80211_CMD_NEW_MPATH,
762 	NL80211_CMD_DEL_MPATH,
763 
764 	NL80211_CMD_SET_BSS,
765 
766 	NL80211_CMD_SET_REG,
767 	NL80211_CMD_REQ_SET_REG,
768 
769 	NL80211_CMD_GET_MESH_CONFIG,
770 	NL80211_CMD_SET_MESH_CONFIG,
771 
772 	NL80211_CMD_SET_MGMT_EXTRA_IE /* reserved; not used */,
773 
774 	NL80211_CMD_GET_REG,
775 
776 	NL80211_CMD_GET_SCAN,
777 	NL80211_CMD_TRIGGER_SCAN,
778 	NL80211_CMD_NEW_SCAN_RESULTS,
779 	NL80211_CMD_SCAN_ABORTED,
780 
781 	NL80211_CMD_REG_CHANGE,
782 
783 	NL80211_CMD_AUTHENTICATE,
784 	NL80211_CMD_ASSOCIATE,
785 	NL80211_CMD_DEAUTHENTICATE,
786 	NL80211_CMD_DISASSOCIATE,
787 
788 	NL80211_CMD_MICHAEL_MIC_FAILURE,
789 
790 	NL80211_CMD_REG_BEACON_HINT,
791 
792 	NL80211_CMD_JOIN_IBSS,
793 	NL80211_CMD_LEAVE_IBSS,
794 
795 	NL80211_CMD_TESTMODE,
796 
797 	NL80211_CMD_CONNECT,
798 	NL80211_CMD_ROAM,
799 	NL80211_CMD_DISCONNECT,
800 
801 	NL80211_CMD_SET_WIPHY_NETNS,
802 
803 	NL80211_CMD_GET_SURVEY,
804 	NL80211_CMD_NEW_SURVEY_RESULTS,
805 
806 	NL80211_CMD_SET_PMKSA,
807 	NL80211_CMD_DEL_PMKSA,
808 	NL80211_CMD_FLUSH_PMKSA,
809 
810 	NL80211_CMD_REMAIN_ON_CHANNEL,
811 	NL80211_CMD_CANCEL_REMAIN_ON_CHANNEL,
812 
813 	NL80211_CMD_SET_TX_BITRATE_MASK,
814 
815 	NL80211_CMD_REGISTER_FRAME,
816 	NL80211_CMD_REGISTER_ACTION = NL80211_CMD_REGISTER_FRAME,
817 	NL80211_CMD_FRAME,
818 	NL80211_CMD_ACTION = NL80211_CMD_FRAME,
819 	NL80211_CMD_FRAME_TX_STATUS,
820 	NL80211_CMD_ACTION_TX_STATUS = NL80211_CMD_FRAME_TX_STATUS,
821 
822 	NL80211_CMD_SET_POWER_SAVE,
823 	NL80211_CMD_GET_POWER_SAVE,
824 
825 	NL80211_CMD_SET_CQM,
826 	NL80211_CMD_NOTIFY_CQM,
827 
828 	NL80211_CMD_SET_CHANNEL,
829 	NL80211_CMD_SET_WDS_PEER,
830 
831 	NL80211_CMD_FRAME_WAIT_CANCEL,
832 
833 	NL80211_CMD_JOIN_MESH,
834 	NL80211_CMD_LEAVE_MESH,
835 
836 	NL80211_CMD_UNPROT_DEAUTHENTICATE,
837 	NL80211_CMD_UNPROT_DISASSOCIATE,
838 
839 	NL80211_CMD_NEW_PEER_CANDIDATE,
840 
841 	NL80211_CMD_GET_WOWLAN,
842 	NL80211_CMD_SET_WOWLAN,
843 
844 	NL80211_CMD_START_SCHED_SCAN,
845 	NL80211_CMD_STOP_SCHED_SCAN,
846 	NL80211_CMD_SCHED_SCAN_RESULTS,
847 	NL80211_CMD_SCHED_SCAN_STOPPED,
848 
849 	NL80211_CMD_SET_REKEY_OFFLOAD,
850 
851 	NL80211_CMD_PMKSA_CANDIDATE,
852 
853 	NL80211_CMD_TDLS_OPER,
854 	NL80211_CMD_TDLS_MGMT,
855 
856 	NL80211_CMD_UNEXPECTED_FRAME,
857 
858 	NL80211_CMD_PROBE_CLIENT,
859 
860 	NL80211_CMD_REGISTER_BEACONS,
861 
862 	NL80211_CMD_UNEXPECTED_4ADDR_FRAME,
863 
864 	NL80211_CMD_SET_NOACK_MAP,
865 
866 	NL80211_CMD_CH_SWITCH_NOTIFY,
867 
868 	NL80211_CMD_START_P2P_DEVICE,
869 	NL80211_CMD_STOP_P2P_DEVICE,
870 
871 	NL80211_CMD_CONN_FAILED,
872 
873 	NL80211_CMD_SET_MCAST_RATE,
874 
875 	NL80211_CMD_SET_MAC_ACL,
876 
877 	NL80211_CMD_RADAR_DETECT,
878 
879 	NL80211_CMD_GET_PROTOCOL_FEATURES,
880 
881 	NL80211_CMD_UPDATE_FT_IES,
882 	NL80211_CMD_FT_EVENT,
883 
884 	NL80211_CMD_CRIT_PROTOCOL_START,
885 	NL80211_CMD_CRIT_PROTOCOL_STOP,
886 
887 	NL80211_CMD_GET_COALESCE,
888 	NL80211_CMD_SET_COALESCE,
889 
890 	NL80211_CMD_CHANNEL_SWITCH,
891 
892 	NL80211_CMD_VENDOR,
893 
894 	NL80211_CMD_SET_QOS_MAP,
895 
896 	/* add new commands above here */
897 
898 	/* used to define NL80211_CMD_MAX below */
899 	__NL80211_CMD_AFTER_LAST,
900 	NL80211_CMD_MAX = __NL80211_CMD_AFTER_LAST - 1
901 };
902 
903 /*
904  * Allow user space programs to use #ifdef on new commands by defining them
905  * here
906  */
907 #define NL80211_CMD_SET_BSS NL80211_CMD_SET_BSS
908 #define NL80211_CMD_SET_MGMT_EXTRA_IE NL80211_CMD_SET_MGMT_EXTRA_IE
909 #define NL80211_CMD_REG_CHANGE NL80211_CMD_REG_CHANGE
910 #define NL80211_CMD_AUTHENTICATE NL80211_CMD_AUTHENTICATE
911 #define NL80211_CMD_ASSOCIATE NL80211_CMD_ASSOCIATE
912 #define NL80211_CMD_DEAUTHENTICATE NL80211_CMD_DEAUTHENTICATE
913 #define NL80211_CMD_DISASSOCIATE NL80211_CMD_DISASSOCIATE
914 #define NL80211_CMD_REG_BEACON_HINT NL80211_CMD_REG_BEACON_HINT
915 
916 #define NL80211_ATTR_FEATURE_FLAGS NL80211_ATTR_FEATURE_FLAGS
917 
918 /* source-level API compatibility */
919 #define NL80211_CMD_GET_MESH_PARAMS NL80211_CMD_GET_MESH_CONFIG
920 #define NL80211_CMD_SET_MESH_PARAMS NL80211_CMD_SET_MESH_CONFIG
921 #define NL80211_MESH_SETUP_VENDOR_PATH_SEL_IE NL80211_MESH_SETUP_IE
922 
923 /**
924  * enum nl80211_attrs - nl80211 netlink attributes
925  *
926  * @NL80211_ATTR_UNSPEC: unspecified attribute to catch errors
927  *
928  * @NL80211_ATTR_WIPHY: index of wiphy to operate on, cf.
929  *	/sys/class/ieee80211/<phyname>/index
930  * @NL80211_ATTR_WIPHY_NAME: wiphy name (used for renaming)
931  * @NL80211_ATTR_WIPHY_TXQ_PARAMS: a nested array of TX queue parameters
932  * @NL80211_ATTR_WIPHY_FREQ: frequency of the selected channel in MHz,
933  *	defines the channel together with the (deprecated)
934  *	%NL80211_ATTR_WIPHY_CHANNEL_TYPE attribute or the attributes
935  *	%NL80211_ATTR_CHANNEL_WIDTH and if needed %NL80211_ATTR_CENTER_FREQ1
936  *	and %NL80211_ATTR_CENTER_FREQ2
937  * @NL80211_ATTR_CHANNEL_WIDTH: u32 attribute containing one of the values
938  *	of &enum nl80211_chan_width, describing the channel width. See the
939  *	documentation of the enum for more information.
940  * @NL80211_ATTR_CENTER_FREQ1: Center frequency of the first part of the
941  *	channel, used for anything but 20 MHz bandwidth
942  * @NL80211_ATTR_CENTER_FREQ2: Center frequency of the second part of the
943  *	channel, used only for 80+80 MHz bandwidth
944  * @NL80211_ATTR_WIPHY_CHANNEL_TYPE: included with NL80211_ATTR_WIPHY_FREQ
945  *	if HT20 or HT40 are to be used (i.e., HT disabled if not included):
946  *	NL80211_CHAN_NO_HT = HT not allowed (i.e., same as not including
947  *		this attribute)
948  *	NL80211_CHAN_HT20 = HT20 only
949  *	NL80211_CHAN_HT40MINUS = secondary channel is below the primary channel
950  *	NL80211_CHAN_HT40PLUS = secondary channel is above the primary channel
951  *	This attribute is now deprecated.
952  * @NL80211_ATTR_WIPHY_RETRY_SHORT: TX retry limit for frames whose length is
953  *	less than or equal to the RTS threshold; allowed range: 1..255;
954  *	dot11ShortRetryLimit; u8
955  * @NL80211_ATTR_WIPHY_RETRY_LONG: TX retry limit for frames whose length is
956  *	greater than the RTS threshold; allowed range: 1..255;
957  *	dot11ShortLongLimit; u8
958  * @NL80211_ATTR_WIPHY_FRAG_THRESHOLD: fragmentation threshold, i.e., maximum
959  *	length in octets for frames; allowed range: 256..8000, disable
960  *	fragmentation with (u32)-1; dot11FragmentationThreshold; u32
961  * @NL80211_ATTR_WIPHY_RTS_THRESHOLD: RTS threshold (TX frames with length
962  *	larger than or equal to this use RTS/CTS handshake); allowed range:
963  *	0..65536, disable with (u32)-1; dot11RTSThreshold; u32
964  * @NL80211_ATTR_WIPHY_COVERAGE_CLASS: Coverage Class as defined by IEEE 802.11
965  *	section 7.3.2.9; dot11CoverageClass; u8
966  *
967  * @NL80211_ATTR_IFINDEX: network interface index of the device to operate on
968  * @NL80211_ATTR_IFNAME: network interface name
969  * @NL80211_ATTR_IFTYPE: type of virtual interface, see &enum nl80211_iftype
970  *
971  * @NL80211_ATTR_WDEV: wireless device identifier, used for pseudo-devices
972  *	that don't have a netdev (u64)
973  *
974  * @NL80211_ATTR_MAC: MAC address (various uses)
975  *
976  * @NL80211_ATTR_KEY_DATA: (temporal) key data; for TKIP this consists of
977  *	16 bytes encryption key followed by 8 bytes each for TX and RX MIC
978  *	keys
979  * @NL80211_ATTR_KEY_IDX: key ID (u8, 0-3)
980  * @NL80211_ATTR_KEY_CIPHER: key cipher suite (u32, as defined by IEEE 802.11
981  *	section 7.3.2.25.1, e.g. 0x000FAC04)
982  * @NL80211_ATTR_KEY_SEQ: transmit key sequence number (IV/PN) for TKIP and
983  *	CCMP keys, each six bytes in little endian
984  * @NL80211_ATTR_KEY_DEFAULT: Flag attribute indicating the key is default key
985  * @NL80211_ATTR_KEY_DEFAULT_MGMT: Flag attribute indicating the key is the
986  *	default management key
987  * @NL80211_ATTR_CIPHER_SUITES_PAIRWISE: For crypto settings for connect or
988  *	other commands, indicates which pairwise cipher suites are used
989  * @NL80211_ATTR_CIPHER_SUITE_GROUP: For crypto settings for connect or
990  *	other commands, indicates which group cipher suite is used
991  *
992  * @NL80211_ATTR_BEACON_INTERVAL: beacon interval in TU
993  * @NL80211_ATTR_DTIM_PERIOD: DTIM period for beaconing
994  * @NL80211_ATTR_BEACON_HEAD: portion of the beacon before the TIM IE
995  * @NL80211_ATTR_BEACON_TAIL: portion of the beacon after the TIM IE
996  *
997  * @NL80211_ATTR_STA_AID: Association ID for the station (u16)
998  * @NL80211_ATTR_STA_FLAGS: flags, nested element with NLA_FLAG attributes of
999  *	&enum nl80211_sta_flags (deprecated, use %NL80211_ATTR_STA_FLAGS2)
1000  * @NL80211_ATTR_STA_LISTEN_INTERVAL: listen interval as defined by
1001  *	IEEE 802.11 7.3.1.6 (u16).
1002  * @NL80211_ATTR_STA_SUPPORTED_RATES: supported rates, array of supported
1003  *	rates as defined by IEEE 802.11 7.3.2.2 but without the length
1004  *	restriction (at most %NL80211_MAX_SUPP_RATES).
1005  * @NL80211_ATTR_STA_VLAN: interface index of VLAN interface to move station
1006  *	to, or the AP interface the station was originally added to to.
1007  * @NL80211_ATTR_STA_INFO: information about a station, part of station info
1008  *	given for %NL80211_CMD_GET_STATION, nested attribute containing
1009  *	info as possible, see &enum nl80211_sta_info.
1010  *
1011  * @NL80211_ATTR_WIPHY_BANDS: Information about an operating bands,
1012  *	consisting of a nested array.
1013  *
1014  * @NL80211_ATTR_MESH_ID: mesh id (1-32 bytes).
1015  * @NL80211_ATTR_STA_PLINK_ACTION: action to perform on the mesh peer link
1016  *	(see &enum nl80211_plink_action).
1017  * @NL80211_ATTR_MPATH_NEXT_HOP: MAC address of the next hop for a mesh path.
1018  * @NL80211_ATTR_MPATH_INFO: information about a mesh_path, part of mesh path
1019  * 	info given for %NL80211_CMD_GET_MPATH, nested attribute described at
1020  *	&enum nl80211_mpath_info.
1021  *
1022  * @NL80211_ATTR_MNTR_FLAGS: flags, nested element with NLA_FLAG attributes of
1023  *      &enum nl80211_mntr_flags.
1024  *
1025  * @NL80211_ATTR_REG_ALPHA2: an ISO-3166-alpha2 country code for which the
1026  * 	current regulatory domain should be set to or is already set to.
1027  * 	For example, 'CR', for Costa Rica. This attribute is used by the kernel
1028  * 	to query the CRDA to retrieve one regulatory domain. This attribute can
1029  * 	also be used by userspace to query the kernel for the currently set
1030  * 	regulatory domain. We chose an alpha2 as that is also used by the
1031  * 	IEEE-802.11 country information element to identify a country.
1032  * 	Users can also simply ask the wireless core to set regulatory domain
1033  * 	to a specific alpha2.
1034  * @NL80211_ATTR_REG_RULES: a nested array of regulatory domain regulatory
1035  *	rules.
1036  *
1037  * @NL80211_ATTR_BSS_CTS_PROT: whether CTS protection is enabled (u8, 0 or 1)
1038  * @NL80211_ATTR_BSS_SHORT_PREAMBLE: whether short preamble is enabled
1039  *	(u8, 0 or 1)
1040  * @NL80211_ATTR_BSS_SHORT_SLOT_TIME: whether short slot time enabled
1041  *	(u8, 0 or 1)
1042  * @NL80211_ATTR_BSS_BASIC_RATES: basic rates, array of basic
1043  *	rates in format defined by IEEE 802.11 7.3.2.2 but without the length
1044  *	restriction (at most %NL80211_MAX_SUPP_RATES).
1045  *
1046  * @NL80211_ATTR_HT_CAPABILITY: HT Capability information element (from
1047  *	association request when used with NL80211_CMD_NEW_STATION)
1048  *
1049  * @NL80211_ATTR_SUPPORTED_IFTYPES: nested attribute containing all
1050  *	supported interface types, each a flag attribute with the number
1051  *	of the interface mode.
1052  *
1053  * @NL80211_ATTR_MGMT_SUBTYPE: Management frame subtype for
1054  *	%NL80211_CMD_SET_MGMT_EXTRA_IE.
1055  *
1056  * @NL80211_ATTR_IE: Information element(s) data (used, e.g., with
1057  *	%NL80211_CMD_SET_MGMT_EXTRA_IE).
1058  *
1059  * @NL80211_ATTR_MAX_NUM_SCAN_SSIDS: number of SSIDs you can scan with
1060  *	a single scan request, a wiphy attribute.
1061  * @NL80211_ATTR_MAX_NUM_SCHED_SCAN_SSIDS: number of SSIDs you can
1062  *	scan with a single scheduled scan request, a wiphy attribute.
1063  * @NL80211_ATTR_MAX_SCAN_IE_LEN: maximum length of information elements
1064  *	that can be added to a scan request
1065  * @NL80211_ATTR_MAX_SCHED_SCAN_IE_LEN: maximum length of information
1066  *	elements that can be added to a scheduled scan request
1067  * @NL80211_ATTR_MAX_MATCH_SETS: maximum number of sets that can be
1068  *	used with @NL80211_ATTR_SCHED_SCAN_MATCH, a wiphy attribute.
1069  *
1070  * @NL80211_ATTR_SCAN_FREQUENCIES: nested attribute with frequencies (in MHz)
1071  * @NL80211_ATTR_SCAN_SSIDS: nested attribute with SSIDs, leave out for passive
1072  *	scanning and include a zero-length SSID (wildcard) for wildcard scan
1073  * @NL80211_ATTR_BSS: scan result BSS
1074  *
1075  * @NL80211_ATTR_REG_INITIATOR: indicates who requested the regulatory domain
1076  * 	currently in effect. This could be any of the %NL80211_REGDOM_SET_BY_*
1077  * @NL80211_ATTR_REG_TYPE: indicates the type of the regulatory domain currently
1078  * 	set. This can be one of the nl80211_reg_type (%NL80211_REGDOM_TYPE_*)
1079  *
1080  * @NL80211_ATTR_SUPPORTED_COMMANDS: wiphy attribute that specifies
1081  *	an array of command numbers (i.e. a mapping index to command number)
1082  *	that the driver for the given wiphy supports.
1083  *
1084  * @NL80211_ATTR_FRAME: frame data (binary attribute), including frame header
1085  *	and body, but not FCS; used, e.g., with NL80211_CMD_AUTHENTICATE and
1086  *	NL80211_CMD_ASSOCIATE events
1087  * @NL80211_ATTR_SSID: SSID (binary attribute, 0..32 octets)
1088  * @NL80211_ATTR_AUTH_TYPE: AuthenticationType, see &enum nl80211_auth_type,
1089  *	represented as a u32
1090  * @NL80211_ATTR_REASON_CODE: ReasonCode for %NL80211_CMD_DEAUTHENTICATE and
1091  *	%NL80211_CMD_DISASSOCIATE, u16
1092  *
1093  * @NL80211_ATTR_KEY_TYPE: Key Type, see &enum nl80211_key_type, represented as
1094  *	a u32
1095  *
1096  * @NL80211_ATTR_FREQ_BEFORE: A channel which has suffered a regulatory change
1097  * 	due to considerations from a beacon hint. This attribute reflects
1098  * 	the state of the channel _before_ the beacon hint processing. This
1099  * 	attributes consists of a nested attribute containing
1100  * 	NL80211_FREQUENCY_ATTR_*
1101  * @NL80211_ATTR_FREQ_AFTER: A channel which has suffered a regulatory change
1102  * 	due to considerations from a beacon hint. This attribute reflects
1103  * 	the state of the channel _after_ the beacon hint processing. This
1104  * 	attributes consists of a nested attribute containing
1105  * 	NL80211_FREQUENCY_ATTR_*
1106  *
1107  * @NL80211_ATTR_CIPHER_SUITES: a set of u32 values indicating the supported
1108  *	cipher suites
1109  *
1110  * @NL80211_ATTR_FREQ_FIXED: a flag indicating the IBSS should not try to look
1111  *	for other networks on different channels
1112  *
1113  * @NL80211_ATTR_TIMED_OUT: a flag indicating than an operation timed out; this
1114  *	is used, e.g., with %NL80211_CMD_AUTHENTICATE event
1115  *
1116  * @NL80211_ATTR_USE_MFP: Whether management frame protection (IEEE 802.11w) is
1117  *	used for the association (&enum nl80211_mfp, represented as a u32);
1118  *	this attribute can be used
1119  *	with %NL80211_CMD_ASSOCIATE and %NL80211_CMD_CONNECT requests
1120  *
1121  * @NL80211_ATTR_STA_FLAGS2: Attribute containing a
1122  *	&struct nl80211_sta_flag_update.
1123  *
1124  * @NL80211_ATTR_CONTROL_PORT: A flag indicating whether user space controls
1125  *	IEEE 802.1X port, i.e., sets/clears %NL80211_STA_FLAG_AUTHORIZED, in
1126  *	station mode. If the flag is included in %NL80211_CMD_ASSOCIATE
1127  *	request, the driver will assume that the port is unauthorized until
1128  *	authorized by user space. Otherwise, port is marked authorized by
1129  *	default in station mode.
1130  * @NL80211_ATTR_CONTROL_PORT_ETHERTYPE: A 16-bit value indicating the
1131  *	ethertype that will be used for key negotiation. It can be
1132  *	specified with the associate and connect commands. If it is not
1133  *	specified, the value defaults to 0x888E (PAE, 802.1X). This
1134  *	attribute is also used as a flag in the wiphy information to
1135  *	indicate that protocols other than PAE are supported.
1136  * @NL80211_ATTR_CONTROL_PORT_NO_ENCRYPT: When included along with
1137  *	%NL80211_ATTR_CONTROL_PORT_ETHERTYPE, indicates that the custom
1138  *	ethertype frames used for key negotiation must not be encrypted.
1139  *
1140  * @NL80211_ATTR_TESTDATA: Testmode data blob, passed through to the driver.
1141  *	We recommend using nested, driver-specific attributes within this.
1142  *
1143  * @NL80211_ATTR_DISCONNECTED_BY_AP: A flag indicating that the DISCONNECT
1144  *	event was due to the AP disconnecting the station, and not due to
1145  *	a local disconnect request.
1146  * @NL80211_ATTR_STATUS_CODE: StatusCode for the %NL80211_CMD_CONNECT
1147  *	event (u16)
1148  * @NL80211_ATTR_PRIVACY: Flag attribute, used with connect(), indicating
1149  *	that protected APs should be used. This is also used with NEW_BEACON to
1150  *	indicate that the BSS is to use protection.
1151  *
1152  * @NL80211_ATTR_CIPHERS_PAIRWISE: Used with CONNECT, ASSOCIATE, and NEW_BEACON
1153  *	to indicate which unicast key ciphers will be used with the connection
1154  *	(an array of u32).
1155  * @NL80211_ATTR_CIPHER_GROUP: Used with CONNECT, ASSOCIATE, and NEW_BEACON to
1156  *	indicate which group key cipher will be used with the connection (a
1157  *	u32).
1158  * @NL80211_ATTR_WPA_VERSIONS: Used with CONNECT, ASSOCIATE, and NEW_BEACON to
1159  *	indicate which WPA version(s) the AP we want to associate with is using
1160  *	(a u32 with flags from &enum nl80211_wpa_versions).
1161  * @NL80211_ATTR_AKM_SUITES: Used with CONNECT, ASSOCIATE, and NEW_BEACON to
1162  *	indicate which key management algorithm(s) to use (an array of u32).
1163  *
1164  * @NL80211_ATTR_REQ_IE: (Re)association request information elements as
1165  *	sent out by the card, for ROAM and successful CONNECT events.
1166  * @NL80211_ATTR_RESP_IE: (Re)association response information elements as
1167  *	sent by peer, for ROAM and successful CONNECT events.
1168  *
1169  * @NL80211_ATTR_PREV_BSSID: previous BSSID, to be used by in ASSOCIATE
1170  *	commands to specify using a reassociate frame
1171  *
1172  * @NL80211_ATTR_KEY: key information in a nested attribute with
1173  *	%NL80211_KEY_* sub-attributes
1174  * @NL80211_ATTR_KEYS: array of keys for static WEP keys for connect()
1175  *	and join_ibss(), key information is in a nested attribute each
1176  *	with %NL80211_KEY_* sub-attributes
1177  *
1178  * @NL80211_ATTR_PID: Process ID of a network namespace.
1179  *
1180  * @NL80211_ATTR_GENERATION: Used to indicate consistent snapshots for
1181  *	dumps. This number increases whenever the object list being
1182  *	dumped changes, and as such userspace can verify that it has
1183  *	obtained a complete and consistent snapshot by verifying that
1184  *	all dump messages contain the same generation number. If it
1185  *	changed then the list changed and the dump should be repeated
1186  *	completely from scratch.
1187  *
1188  * @NL80211_ATTR_4ADDR: Use 4-address frames on a virtual interface
1189  *
1190  * @NL80211_ATTR_SURVEY_INFO: survey information about a channel, part of
1191  *      the survey response for %NL80211_CMD_GET_SURVEY, nested attribute
1192  *      containing info as possible, see &enum survey_info.
1193  *
1194  * @NL80211_ATTR_PMKID: PMK material for PMKSA caching.
1195  * @NL80211_ATTR_MAX_NUM_PMKIDS: maximum number of PMKIDs a firmware can
1196  *	cache, a wiphy attribute.
1197  *
1198  * @NL80211_ATTR_DURATION: Duration of an operation in milliseconds, u32.
1199  * @NL80211_ATTR_MAX_REMAIN_ON_CHANNEL_DURATION: Device attribute that
1200  *	specifies the maximum duration that can be requested with the
1201  *	remain-on-channel operation, in milliseconds, u32.
1202  *
1203  * @NL80211_ATTR_COOKIE: Generic 64-bit cookie to identify objects.
1204  *
1205  * @NL80211_ATTR_TX_RATES: Nested set of attributes
1206  *	(enum nl80211_tx_rate_attributes) describing TX rates per band. The
1207  *	enum nl80211_band value is used as the index (nla_type() of the nested
1208  *	data. If a band is not included, it will be configured to allow all
1209  *	rates based on negotiated supported rates information. This attribute
1210  *	is used with %NL80211_CMD_SET_TX_BITRATE_MASK.
1211  *
1212  * @NL80211_ATTR_FRAME_MATCH: A binary attribute which typically must contain
1213  *	at least one byte, currently used with @NL80211_CMD_REGISTER_FRAME.
1214  * @NL80211_ATTR_FRAME_TYPE: A u16 indicating the frame type/subtype for the
1215  *	@NL80211_CMD_REGISTER_FRAME command.
1216  * @NL80211_ATTR_TX_FRAME_TYPES: wiphy capability attribute, which is a
1217  *	nested attribute of %NL80211_ATTR_FRAME_TYPE attributes, containing
1218  *	information about which frame types can be transmitted with
1219  *	%NL80211_CMD_FRAME.
1220  * @NL80211_ATTR_RX_FRAME_TYPES: wiphy capability attribute, which is a
1221  *	nested attribute of %NL80211_ATTR_FRAME_TYPE attributes, containing
1222  *	information about which frame types can be registered for RX.
1223  *
1224  * @NL80211_ATTR_ACK: Flag attribute indicating that the frame was
1225  *	acknowledged by the recipient.
1226  *
1227  * @NL80211_ATTR_PS_STATE: powersave state, using &enum nl80211_ps_state values.
1228  *
1229  * @NL80211_ATTR_CQM: connection quality monitor configuration in a
1230  *	nested attribute with %NL80211_ATTR_CQM_* sub-attributes.
1231  *
1232  * @NL80211_ATTR_LOCAL_STATE_CHANGE: Flag attribute to indicate that a command
1233  *	is requesting a local authentication/association state change without
1234  *	invoking actual management frame exchange. This can be used with
1235  *	NL80211_CMD_AUTHENTICATE, NL80211_CMD_DEAUTHENTICATE,
1236  *	NL80211_CMD_DISASSOCIATE.
1237  *
1238  * @NL80211_ATTR_AP_ISOLATE: (AP mode) Do not forward traffic between stations
1239  *	connected to this BSS.
1240  *
1241  * @NL80211_ATTR_WIPHY_TX_POWER_SETTING: Transmit power setting type. See
1242  *      &enum nl80211_tx_power_setting for possible values.
1243  * @NL80211_ATTR_WIPHY_TX_POWER_LEVEL: Transmit power level in signed mBm units.
1244  *      This is used in association with @NL80211_ATTR_WIPHY_TX_POWER_SETTING
1245  *      for non-automatic settings.
1246  *
1247  * @NL80211_ATTR_SUPPORT_IBSS_RSN: The device supports IBSS RSN, which mostly
1248  *	means support for per-station GTKs.
1249  *
1250  * @NL80211_ATTR_WIPHY_ANTENNA_TX: Bitmap of allowed antennas for transmitting.
1251  *	This can be used to mask out antennas which are not attached or should
1252  *	not be used for transmitting. If an antenna is not selected in this
1253  *	bitmap the hardware is not allowed to transmit on this antenna.
1254  *
1255  *	Each bit represents one antenna, starting with antenna 1 at the first
1256  *	bit. Depending on which antennas are selected in the bitmap, 802.11n
1257  *	drivers can derive which chainmasks to use (if all antennas belonging to
1258  *	a particular chain are disabled this chain should be disabled) and if
1259  *	a chain has diversity antennas wether diversity should be used or not.
1260  *	HT capabilities (STBC, TX Beamforming, Antenna selection) can be
1261  *	derived from the available chains after applying the antenna mask.
1262  *	Non-802.11n drivers can derive wether to use diversity or not.
1263  *	Drivers may reject configurations or RX/TX mask combinations they cannot
1264  *	support by returning -EINVAL.
1265  *
1266  * @NL80211_ATTR_WIPHY_ANTENNA_RX: Bitmap of allowed antennas for receiving.
1267  *	This can be used to mask out antennas which are not attached or should
1268  *	not be used for receiving. If an antenna is not selected in this bitmap
1269  *	the hardware should not be configured to receive on this antenna.
1270  *	For a more detailed description see @NL80211_ATTR_WIPHY_ANTENNA_TX.
1271  *
1272  * @NL80211_ATTR_WIPHY_ANTENNA_AVAIL_TX: Bitmap of antennas which are available
1273  *	for configuration as TX antennas via the above parameters.
1274  *
1275  * @NL80211_ATTR_WIPHY_ANTENNA_AVAIL_RX: Bitmap of antennas which are available
1276  *	for configuration as RX antennas via the above parameters.
1277  *
1278  * @NL80211_ATTR_MCAST_RATE: Multicast tx rate (in 100 kbps) for IBSS
1279  *
1280  * @NL80211_ATTR_OFFCHANNEL_TX_OK: For management frame TX, the frame may be
1281  *	transmitted on another channel when the channel given doesn't match
1282  *	the current channel. If the current channel doesn't match and this
1283  *	flag isn't set, the frame will be rejected. This is also used as an
1284  *	nl80211 capability flag.
1285  *
1286  * @NL80211_ATTR_BSS_HT_OPMODE: HT operation mode (u16)
1287  *
1288  * @NL80211_ATTR_KEY_DEFAULT_TYPES: A nested attribute containing flags
1289  *	attributes, specifying what a key should be set as default as.
1290  *	See &enum nl80211_key_default_types.
1291  *
1292  * @NL80211_ATTR_MESH_SETUP: Optional mesh setup parameters.  These cannot be
1293  *	changed once the mesh is active.
1294  * @NL80211_ATTR_MESH_CONFIG: Mesh configuration parameters, a nested attribute
1295  *	containing attributes from &enum nl80211_meshconf_params.
1296  * @NL80211_ATTR_SUPPORT_MESH_AUTH: Currently, this means the underlying driver
1297  *	allows auth frames in a mesh to be passed to userspace for processing via
1298  *	the @NL80211_MESH_SETUP_USERSPACE_AUTH flag.
1299  * @NL80211_ATTR_STA_PLINK_STATE: The state of a mesh peer link as defined in
1300  *	&enum nl80211_plink_state. Used when userspace is driving the peer link
1301  *	management state machine.  @NL80211_MESH_SETUP_USERSPACE_AMPE or
1302  *	@NL80211_MESH_SETUP_USERSPACE_MPM must be enabled.
1303  *
1304  * @NL80211_ATTR_WOWLAN_TRIGGERS_SUPPORTED: indicates, as part of the wiphy
1305  *	capabilities, the supported WoWLAN triggers
1306  * @NL80211_ATTR_WOWLAN_TRIGGERS: used by %NL80211_CMD_SET_WOWLAN to
1307  *	indicate which WoW triggers should be enabled. This is also
1308  *	used by %NL80211_CMD_GET_WOWLAN to get the currently enabled WoWLAN
1309  *	triggers.
1310  *
1311  * @NL80211_ATTR_SCHED_SCAN_INTERVAL: Interval between scheduled scan
1312  *	cycles, in msecs.
1313  *
1314  * @NL80211_ATTR_SCHED_SCAN_MATCH: Nested attribute with one or more
1315  *	sets of attributes to match during scheduled scans.  Only BSSs
1316  *	that match any of the sets will be reported.  These are
1317  *	pass-thru filter rules.
1318  *	For a match to succeed, the BSS must match all attributes of a
1319  *	set.  Since not every hardware supports matching all types of
1320  *	attributes, there is no guarantee that the reported BSSs are
1321  *	fully complying with the match sets and userspace needs to be
1322  *	able to ignore them by itself.
1323  *	Thus, the implementation is somewhat hardware-dependent, but
1324  *	this is only an optimization and the userspace application
1325  *	needs to handle all the non-filtered results anyway.
1326  *	If the match attributes don't make sense when combined with
1327  *	the values passed in @NL80211_ATTR_SCAN_SSIDS (eg. if an SSID
1328  *	is included in the probe request, but the match attributes
1329  *	will never let it go through), -EINVAL may be returned.
1330  *	If ommited, no filtering is done.
1331  *
1332  * @NL80211_ATTR_INTERFACE_COMBINATIONS: Nested attribute listing the supported
1333  *	interface combinations. In each nested item, it contains attributes
1334  *	defined in &enum nl80211_if_combination_attrs.
1335  * @NL80211_ATTR_SOFTWARE_IFTYPES: Nested attribute (just like
1336  *	%NL80211_ATTR_SUPPORTED_IFTYPES) containing the interface types that
1337  *	are managed in software: interfaces of these types aren't subject to
1338  *	any restrictions in their number or combinations.
1339  *
1340  * @NL80211_ATTR_REKEY_DATA: nested attribute containing the information
1341  *	necessary for GTK rekeying in the device, see &enum nl80211_rekey_data.
1342  *
1343  * @NL80211_ATTR_SCAN_SUPP_RATES: rates per to be advertised as supported in scan,
1344  *	nested array attribute containing an entry for each band, with the entry
1345  *	being a list of supported rates as defined by IEEE 802.11 7.3.2.2 but
1346  *	without the length restriction (at most %NL80211_MAX_SUPP_RATES).
1347  *
1348  * @NL80211_ATTR_HIDDEN_SSID: indicates whether SSID is to be hidden from Beacon
1349  *	and Probe Response (when response to wildcard Probe Request); see
1350  *	&enum nl80211_hidden_ssid, represented as a u32
1351  *
1352  * @NL80211_ATTR_IE_PROBE_RESP: Information element(s) for Probe Response frame.
1353  *	This is used with %NL80211_CMD_NEW_BEACON and %NL80211_CMD_SET_BEACON to
1354  *	provide extra IEs (e.g., WPS/P2P IE) into Probe Response frames when the
1355  *	driver (or firmware) replies to Probe Request frames.
1356  * @NL80211_ATTR_IE_ASSOC_RESP: Information element(s) for (Re)Association
1357  *	Response frames. This is used with %NL80211_CMD_NEW_BEACON and
1358  *	%NL80211_CMD_SET_BEACON to provide extra IEs (e.g., WPS/P2P IE) into
1359  *	(Re)Association Response frames when the driver (or firmware) replies to
1360  *	(Re)Association Request frames.
1361  *
1362  * @NL80211_ATTR_STA_WME: Nested attribute containing the wme configuration
1363  *	of the station, see &enum nl80211_sta_wme_attr.
1364  * @NL80211_ATTR_SUPPORT_AP_UAPSD: the device supports uapsd when working
1365  *	as AP.
1366  *
1367  * @NL80211_ATTR_ROAM_SUPPORT: Indicates whether the firmware is capable of
1368  *	roaming to another AP in the same ESS if the signal lever is low.
1369  *
1370  * @NL80211_ATTR_PMKSA_CANDIDATE: Nested attribute containing the PMKSA caching
1371  *	candidate information, see &enum nl80211_pmksa_candidate_attr.
1372  *
1373  * @NL80211_ATTR_TX_NO_CCK_RATE: Indicates whether to use CCK rate or not
1374  *	for management frames transmission. In order to avoid p2p probe/action
1375  *	frames are being transmitted at CCK rate in 2GHz band, the user space
1376  *	applications use this attribute.
1377  *	This attribute is used with %NL80211_CMD_TRIGGER_SCAN and
1378  *	%NL80211_CMD_FRAME commands.
1379  *
1380  * @NL80211_ATTR_TDLS_ACTION: Low level TDLS action code (e.g. link setup
1381  *	request, link setup confirm, link teardown, etc.). Values are
1382  *	described in the TDLS (802.11z) specification.
1383  * @NL80211_ATTR_TDLS_DIALOG_TOKEN: Non-zero token for uniquely identifying a
1384  *	TDLS conversation between two devices.
1385  * @NL80211_ATTR_TDLS_OPERATION: High level TDLS operation; see
1386  *	&enum nl80211_tdls_operation, represented as a u8.
1387  * @NL80211_ATTR_TDLS_SUPPORT: A flag indicating the device can operate
1388  *	as a TDLS peer sta.
1389  * @NL80211_ATTR_TDLS_EXTERNAL_SETUP: The TDLS discovery/setup and teardown
1390  *	procedures should be performed by sending TDLS packets via
1391  *	%NL80211_CMD_TDLS_MGMT. Otherwise %NL80211_CMD_TDLS_OPER should be
1392  *	used for asking the driver to perform a TDLS operation.
1393  *
1394  * @NL80211_ATTR_DEVICE_AP_SME: This u32 attribute may be listed for devices
1395  *	that have AP support to indicate that they have the AP SME integrated
1396  *	with support for the features listed in this attribute, see
1397  *	&enum nl80211_ap_sme_features.
1398  *
1399  * @NL80211_ATTR_DONT_WAIT_FOR_ACK: Used with %NL80211_CMD_FRAME, this tells
1400  *	the driver to not wait for an acknowledgement. Note that due to this,
1401  *	it will also not give a status callback nor return a cookie. This is
1402  *	mostly useful for probe responses to save airtime.
1403  *
1404  * @NL80211_ATTR_FEATURE_FLAGS: This u32 attribute contains flags from
1405  *	&enum nl80211_feature_flags and is advertised in wiphy information.
1406  * @NL80211_ATTR_PROBE_RESP_OFFLOAD: Indicates that the HW responds to probe
1407  *	requests while operating in AP-mode.
1408  *	This attribute holds a bitmap of the supported protocols for
1409  *	offloading (see &enum nl80211_probe_resp_offload_support_attr).
1410  *
1411  * @NL80211_ATTR_PROBE_RESP: Probe Response template data. Contains the entire
1412  *	probe-response frame. The DA field in the 802.11 header is zero-ed out,
1413  *	to be filled by the FW.
1414  * @NL80211_ATTR_DISABLE_HT:  Force HT capable interfaces to disable
1415  *      this feature.  Currently, only supported in mac80211 drivers.
1416  * @NL80211_ATTR_HT_CAPABILITY_MASK: Specify which bits of the
1417  *      ATTR_HT_CAPABILITY to which attention should be paid.
1418  *      Currently, only mac80211 NICs support this feature.
1419  *      The values that may be configured are:
1420  *       MCS rates, MAX-AMSDU, HT-20-40 and HT_CAP_SGI_40
1421  *       AMPDU density and AMPDU factor.
1422  *      All values are treated as suggestions and may be ignored
1423  *      by the driver as required.  The actual values may be seen in
1424  *      the station debugfs ht_caps file.
1425  *
1426  * @NL80211_ATTR_DFS_REGION: region for regulatory rules which this country
1427  *    abides to when initiating radiation on DFS channels. A country maps
1428  *    to one DFS region.
1429  *
1430  * @NL80211_ATTR_NOACK_MAP: This u16 bitmap contains the No Ack Policy of
1431  *      up to 16 TIDs.
1432  *
1433  * @NL80211_ATTR_INACTIVITY_TIMEOUT: timeout value in seconds, this can be
1434  *	used by the drivers which has MLME in firmware and does not have support
1435  *	to report per station tx/rx activity to free up the staion entry from
1436  *	the list. This needs to be used when the driver advertises the
1437  *	capability to timeout the stations.
1438  *
1439  * @NL80211_ATTR_RX_SIGNAL_DBM: signal strength in dBm (as a 32-bit int);
1440  *	this attribute is (depending on the driver capabilities) added to
1441  *	received frames indicated with %NL80211_CMD_FRAME.
1442  *
1443  * @NL80211_ATTR_BG_SCAN_PERIOD: Background scan period in seconds
1444  *      or 0 to disable background scan.
1445  *
1446  * @NL80211_ATTR_USER_REG_HINT_TYPE: type of regulatory hint passed from
1447  *	userspace. If unset it is assumed the hint comes directly from
1448  *	a user. If set code could specify exactly what type of source
1449  *	was used to provide the hint. For the different types of
1450  *	allowed user regulatory hints see nl80211_user_reg_hint_type.
1451  *
1452  * @NL80211_ATTR_CONN_FAILED_REASON: The reason for which AP has rejected
1453  *	the connection request from a station. nl80211_connect_failed_reason
1454  *	enum has different reasons of connection failure.
1455  *
1456  * @NL80211_ATTR_SAE_DATA: SAE elements in Authentication frames. This starts
1457  *	with the Authentication transaction sequence number field.
1458  *
1459  * @NL80211_ATTR_VHT_CAPABILITY: VHT Capability information element (from
1460  *	association request when used with NL80211_CMD_NEW_STATION)
1461  *
1462  * @NL80211_ATTR_SCAN_FLAGS: scan request control flags (u32)
1463  *
1464  * @NL80211_ATTR_P2P_CTWINDOW: P2P GO Client Traffic Window (u8), used with
1465  *	the START_AP and SET_BSS commands
1466  * @NL80211_ATTR_P2P_OPPPS: P2P GO opportunistic PS (u8), used with the
1467  *	START_AP and SET_BSS commands. This can have the values 0 or 1;
1468  *	if not given in START_AP 0 is assumed, if not given in SET_BSS
1469  *	no change is made.
1470  *
1471  * @NL80211_ATTR_LOCAL_MESH_POWER_MODE: local mesh STA link-specific power mode
1472  *	defined in &enum nl80211_mesh_power_mode.
1473  *
1474  * @NL80211_ATTR_ACL_POLICY: ACL policy, see &enum nl80211_acl_policy,
1475  *	carried in a u32 attribute
1476  *
1477  * @NL80211_ATTR_MAC_ADDRS: Array of nested MAC addresses, used for
1478  *	MAC ACL.
1479  *
1480  * @NL80211_ATTR_MAC_ACL_MAX: u32 attribute to advertise the maximum
1481  *	number of MAC addresses that a device can support for MAC
1482  *	ACL.
1483  *
1484  * @NL80211_ATTR_RADAR_EVENT: Type of radar event for notification to userspace,
1485  *	contains a value of enum nl80211_radar_event (u32).
1486  *
1487  * @NL80211_ATTR_EXT_CAPA: 802.11 extended capabilities that the kernel driver
1488  *	has and handles. The format is the same as the IE contents. See
1489  *	802.11-2012 8.4.2.29 for more information.
1490  * @NL80211_ATTR_EXT_CAPA_MASK: Extended capabilities that the kernel driver
1491  *	has set in the %NL80211_ATTR_EXT_CAPA value, for multibit fields.
1492  *
1493  * @NL80211_ATTR_STA_CAPABILITY: Station capabilities (u16) are advertised to
1494  *	the driver, e.g., to enable TDLS power save (PU-APSD).
1495  *
1496  * @NL80211_ATTR_STA_EXT_CAPABILITY: Station extended capabilities are
1497  *	advertised to the driver, e.g., to enable TDLS off channel operations
1498  *	and PU-APSD.
1499  *
1500  * @NL80211_ATTR_PROTOCOL_FEATURES: global nl80211 feature flags, see
1501  *	&enum nl80211_protocol_features, the attribute is a u32.
1502  *
1503  * @NL80211_ATTR_SPLIT_WIPHY_DUMP: flag attribute, userspace supports
1504  *	receiving the data for a single wiphy split across multiple
1505  *	messages, given with wiphy dump message
1506  *
1507  * @NL80211_ATTR_MDID: Mobility Domain Identifier
1508  *
1509  * @NL80211_ATTR_IE_RIC: Resource Information Container Information
1510  *	Element
1511  *
1512  * @NL80211_ATTR_CRIT_PROT_ID: critical protocol identifier requiring increased
1513  *	reliability, see &enum nl80211_crit_proto_id (u16).
1514  * @NL80211_ATTR_MAX_CRIT_PROT_DURATION: duration in milliseconds in which
1515  *      the connection should have increased reliability (u16).
1516  *
1517  * @NL80211_ATTR_PEER_AID: Association ID for the peer TDLS station (u16).
1518  *	This is similar to @NL80211_ATTR_STA_AID but with a difference of being
1519  *	allowed to be used with the first @NL80211_CMD_SET_STATION command to
1520  *	update a TDLS peer STA entry.
1521  *
1522  * @NL80211_ATTR_COALESCE_RULE: Coalesce rule information.
1523  *
1524  * @NL80211_ATTR_CH_SWITCH_COUNT: u32 attribute specifying the number of TBTT's
1525  *	until the channel switch event.
1526  * @NL80211_ATTR_CH_SWITCH_BLOCK_TX: flag attribute specifying that transmission
1527  *	must be blocked on the current channel (before the channel switch
1528  *	operation).
1529  * @NL80211_ATTR_CSA_IES: Nested set of attributes containing the IE information
1530  *	for the time while performing a channel switch.
1531  * @NL80211_ATTR_CSA_C_OFF_BEACON: An array of offsets (u16) to the channel
1532  *	switch counters in the beacons tail (%NL80211_ATTR_BEACON_TAIL).
1533  * @NL80211_ATTR_CSA_C_OFF_PRESP: An array of offsets (u16) to the channel
1534  *	switch counters in the probe response (%NL80211_ATTR_PROBE_RESP).
1535  *
1536  * @NL80211_ATTR_RXMGMT_FLAGS: flags for nl80211_send_mgmt(), u32.
1537  *	As specified in the &enum nl80211_rxmgmt_flags.
1538  *
1539  * @NL80211_ATTR_STA_SUPPORTED_CHANNELS: array of supported channels.
1540  *
1541  * @NL80211_ATTR_STA_SUPPORTED_OPER_CLASSES: array of supported
1542  *      supported operating classes.
1543  *
1544  * @NL80211_ATTR_HANDLE_DFS: A flag indicating whether user space
1545  *	controls DFS operation in IBSS mode. If the flag is included in
1546  *	%NL80211_CMD_JOIN_IBSS request, the driver will allow use of DFS
1547  *	channels and reports radar events to userspace. Userspace is required
1548  *	to react to radar events, e.g. initiate a channel switch or leave the
1549  *	IBSS network.
1550  *
1551  * @NL80211_ATTR_SUPPORT_5_MHZ: A flag indicating that the device supports
1552  *	5 MHz channel bandwidth.
1553  * @NL80211_ATTR_SUPPORT_10_MHZ: A flag indicating that the device supports
1554  *	10 MHz channel bandwidth.
1555  *
1556  * @NL80211_ATTR_OPMODE_NOTIF: Operating mode field from Operating Mode
1557  *	Notification Element based on association request when used with
1558  *	%NL80211_CMD_NEW_STATION; u8 attribute.
1559  *
1560  * @NL80211_ATTR_VENDOR_ID: The vendor ID, either a 24-bit OUI or, if
1561  *	%NL80211_VENDOR_ID_IS_LINUX is set, a special Linux ID (not used yet)
1562  * @NL80211_ATTR_VENDOR_SUBCMD: vendor sub-command
1563  * @NL80211_ATTR_VENDOR_DATA: data for the vendor command, if any; this
1564  *	attribute is also used for vendor command feature advertisement
1565  * @NL80211_ATTR_VENDOR_EVENTS: used for event list advertising in the wiphy
1566  *	info, containing a nested array of possible events
1567  *
1568  * @NL80211_ATTR_QOS_MAP: IP DSCP mapping for Interworking QoS mapping. This
1569  *	data is in the format defined for the payload of the QoS Map Set element
1570  *	in IEEE Std 802.11-2012, 8.4.2.97.
1571  *
1572  * @NL80211_ATTR_MAC_HINT: MAC address recommendation as initial BSS
1573  * @NL80211_ATTR_WIPHY_FREQ_HINT: frequency of the recommended initial BSS
1574  *
1575  * @NL80211_ATTR_MAX_AP_ASSOC_STA: Device attribute that indicates how many
1576  *	associated stations are supported in AP mode (including P2P GO); u32.
1577  *	Since drivers may not have a fixed limit on the maximum number (e.g.,
1578  *	other concurrent operations may affect this), drivers are allowed to
1579  *	advertise values that cannot always be met. In such cases, an attempt
1580  *	to add a new station entry with @NL80211_CMD_NEW_STATION may fail.
1581  *
1582  * @NL80211_ATTR_CSA_C_OFFSETS_TX: An array of csa counter offsets (u16) which
1583  *	should be updated when the frame is transmitted.
1584  * @NL80211_ATTR_MAX_CSA_COUNTERS: U8 attribute used to advertise the maximum
1585  *	supported number of csa counters.
1586  *
1587  * @NL80211_ATTR_TDLS_PEER_CAPABILITY: flags for TDLS peer capabilities, u32.
1588  *	As specified in the &enum nl80211_tdls_peer_capability.
1589  *
1590  * @NL80211_ATTR_IFACE_SOCKET_OWNER: flag attribute, if set during interface
1591  *	creation then the new interface will be owned by the netlink socket
1592  *	that created it and will be destroyed when the socket is closed
1593  *
1594  * @NL80211_ATTR_TDLS_INITIATOR: flag attribute indicating the current end is
1595  *	the TDLS link initiator.
1596  *
1597  * @NL80211_ATTR_MAX: highest attribute number currently defined
1598  * @__NL80211_ATTR_AFTER_LAST: internal use
1599  */
1600 enum nl80211_attrs {
1601 /* don't change the order or add anything between, this is ABI! */
1602 	NL80211_ATTR_UNSPEC,
1603 
1604 	NL80211_ATTR_WIPHY,
1605 	NL80211_ATTR_WIPHY_NAME,
1606 
1607 	NL80211_ATTR_IFINDEX,
1608 	NL80211_ATTR_IFNAME,
1609 	NL80211_ATTR_IFTYPE,
1610 
1611 	NL80211_ATTR_MAC,
1612 
1613 	NL80211_ATTR_KEY_DATA,
1614 	NL80211_ATTR_KEY_IDX,
1615 	NL80211_ATTR_KEY_CIPHER,
1616 	NL80211_ATTR_KEY_SEQ,
1617 	NL80211_ATTR_KEY_DEFAULT,
1618 
1619 	NL80211_ATTR_BEACON_INTERVAL,
1620 	NL80211_ATTR_DTIM_PERIOD,
1621 	NL80211_ATTR_BEACON_HEAD,
1622 	NL80211_ATTR_BEACON_TAIL,
1623 
1624 	NL80211_ATTR_STA_AID,
1625 	NL80211_ATTR_STA_FLAGS,
1626 	NL80211_ATTR_STA_LISTEN_INTERVAL,
1627 	NL80211_ATTR_STA_SUPPORTED_RATES,
1628 	NL80211_ATTR_STA_VLAN,
1629 	NL80211_ATTR_STA_INFO,
1630 
1631 	NL80211_ATTR_WIPHY_BANDS,
1632 
1633 	NL80211_ATTR_MNTR_FLAGS,
1634 
1635 	NL80211_ATTR_MESH_ID,
1636 	NL80211_ATTR_STA_PLINK_ACTION,
1637 	NL80211_ATTR_MPATH_NEXT_HOP,
1638 	NL80211_ATTR_MPATH_INFO,
1639 
1640 	NL80211_ATTR_BSS_CTS_PROT,
1641 	NL80211_ATTR_BSS_SHORT_PREAMBLE,
1642 	NL80211_ATTR_BSS_SHORT_SLOT_TIME,
1643 
1644 	NL80211_ATTR_HT_CAPABILITY,
1645 
1646 	NL80211_ATTR_SUPPORTED_IFTYPES,
1647 
1648 	NL80211_ATTR_REG_ALPHA2,
1649 	NL80211_ATTR_REG_RULES,
1650 
1651 	NL80211_ATTR_MESH_CONFIG,
1652 
1653 	NL80211_ATTR_BSS_BASIC_RATES,
1654 
1655 	NL80211_ATTR_WIPHY_TXQ_PARAMS,
1656 	NL80211_ATTR_WIPHY_FREQ,
1657 	NL80211_ATTR_WIPHY_CHANNEL_TYPE,
1658 
1659 	NL80211_ATTR_KEY_DEFAULT_MGMT,
1660 
1661 	NL80211_ATTR_MGMT_SUBTYPE,
1662 	NL80211_ATTR_IE,
1663 
1664 	NL80211_ATTR_MAX_NUM_SCAN_SSIDS,
1665 
1666 	NL80211_ATTR_SCAN_FREQUENCIES,
1667 	NL80211_ATTR_SCAN_SSIDS,
1668 	NL80211_ATTR_GENERATION, /* replaces old SCAN_GENERATION */
1669 	NL80211_ATTR_BSS,
1670 
1671 	NL80211_ATTR_REG_INITIATOR,
1672 	NL80211_ATTR_REG_TYPE,
1673 
1674 	NL80211_ATTR_SUPPORTED_COMMANDS,
1675 
1676 	NL80211_ATTR_FRAME,
1677 	NL80211_ATTR_SSID,
1678 	NL80211_ATTR_AUTH_TYPE,
1679 	NL80211_ATTR_REASON_CODE,
1680 
1681 	NL80211_ATTR_KEY_TYPE,
1682 
1683 	NL80211_ATTR_MAX_SCAN_IE_LEN,
1684 	NL80211_ATTR_CIPHER_SUITES,
1685 
1686 	NL80211_ATTR_FREQ_BEFORE,
1687 	NL80211_ATTR_FREQ_AFTER,
1688 
1689 	NL80211_ATTR_FREQ_FIXED,
1690 
1691 
1692 	NL80211_ATTR_WIPHY_RETRY_SHORT,
1693 	NL80211_ATTR_WIPHY_RETRY_LONG,
1694 	NL80211_ATTR_WIPHY_FRAG_THRESHOLD,
1695 	NL80211_ATTR_WIPHY_RTS_THRESHOLD,
1696 
1697 	NL80211_ATTR_TIMED_OUT,
1698 
1699 	NL80211_ATTR_USE_MFP,
1700 
1701 	NL80211_ATTR_STA_FLAGS2,
1702 
1703 	NL80211_ATTR_CONTROL_PORT,
1704 
1705 	NL80211_ATTR_TESTDATA,
1706 
1707 	NL80211_ATTR_PRIVACY,
1708 
1709 	NL80211_ATTR_DISCONNECTED_BY_AP,
1710 	NL80211_ATTR_STATUS_CODE,
1711 
1712 	NL80211_ATTR_CIPHER_SUITES_PAIRWISE,
1713 	NL80211_ATTR_CIPHER_SUITE_GROUP,
1714 	NL80211_ATTR_WPA_VERSIONS,
1715 	NL80211_ATTR_AKM_SUITES,
1716 
1717 	NL80211_ATTR_REQ_IE,
1718 	NL80211_ATTR_RESP_IE,
1719 
1720 	NL80211_ATTR_PREV_BSSID,
1721 
1722 	NL80211_ATTR_KEY,
1723 	NL80211_ATTR_KEYS,
1724 
1725 	NL80211_ATTR_PID,
1726 
1727 	NL80211_ATTR_4ADDR,
1728 
1729 	NL80211_ATTR_SURVEY_INFO,
1730 
1731 	NL80211_ATTR_PMKID,
1732 	NL80211_ATTR_MAX_NUM_PMKIDS,
1733 
1734 	NL80211_ATTR_DURATION,
1735 
1736 	NL80211_ATTR_COOKIE,
1737 
1738 	NL80211_ATTR_WIPHY_COVERAGE_CLASS,
1739 
1740 	NL80211_ATTR_TX_RATES,
1741 
1742 	NL80211_ATTR_FRAME_MATCH,
1743 
1744 	NL80211_ATTR_ACK,
1745 
1746 	NL80211_ATTR_PS_STATE,
1747 
1748 	NL80211_ATTR_CQM,
1749 
1750 	NL80211_ATTR_LOCAL_STATE_CHANGE,
1751 
1752 	NL80211_ATTR_AP_ISOLATE,
1753 
1754 	NL80211_ATTR_WIPHY_TX_POWER_SETTING,
1755 	NL80211_ATTR_WIPHY_TX_POWER_LEVEL,
1756 
1757 	NL80211_ATTR_TX_FRAME_TYPES,
1758 	NL80211_ATTR_RX_FRAME_TYPES,
1759 	NL80211_ATTR_FRAME_TYPE,
1760 
1761 	NL80211_ATTR_CONTROL_PORT_ETHERTYPE,
1762 	NL80211_ATTR_CONTROL_PORT_NO_ENCRYPT,
1763 
1764 	NL80211_ATTR_SUPPORT_IBSS_RSN,
1765 
1766 	NL80211_ATTR_WIPHY_ANTENNA_TX,
1767 	NL80211_ATTR_WIPHY_ANTENNA_RX,
1768 
1769 	NL80211_ATTR_MCAST_RATE,
1770 
1771 	NL80211_ATTR_OFFCHANNEL_TX_OK,
1772 
1773 	NL80211_ATTR_BSS_HT_OPMODE,
1774 
1775 	NL80211_ATTR_KEY_DEFAULT_TYPES,
1776 
1777 	NL80211_ATTR_MAX_REMAIN_ON_CHANNEL_DURATION,
1778 
1779 	NL80211_ATTR_MESH_SETUP,
1780 
1781 	NL80211_ATTR_WIPHY_ANTENNA_AVAIL_TX,
1782 	NL80211_ATTR_WIPHY_ANTENNA_AVAIL_RX,
1783 
1784 	NL80211_ATTR_SUPPORT_MESH_AUTH,
1785 	NL80211_ATTR_STA_PLINK_STATE,
1786 
1787 	NL80211_ATTR_WOWLAN_TRIGGERS,
1788 	NL80211_ATTR_WOWLAN_TRIGGERS_SUPPORTED,
1789 
1790 	NL80211_ATTR_SCHED_SCAN_INTERVAL,
1791 
1792 	NL80211_ATTR_INTERFACE_COMBINATIONS,
1793 	NL80211_ATTR_SOFTWARE_IFTYPES,
1794 
1795 	NL80211_ATTR_REKEY_DATA,
1796 
1797 	NL80211_ATTR_MAX_NUM_SCHED_SCAN_SSIDS,
1798 	NL80211_ATTR_MAX_SCHED_SCAN_IE_LEN,
1799 
1800 	NL80211_ATTR_SCAN_SUPP_RATES,
1801 
1802 	NL80211_ATTR_HIDDEN_SSID,
1803 
1804 	NL80211_ATTR_IE_PROBE_RESP,
1805 	NL80211_ATTR_IE_ASSOC_RESP,
1806 
1807 	NL80211_ATTR_STA_WME,
1808 	NL80211_ATTR_SUPPORT_AP_UAPSD,
1809 
1810 	NL80211_ATTR_ROAM_SUPPORT,
1811 
1812 	NL80211_ATTR_SCHED_SCAN_MATCH,
1813 	NL80211_ATTR_MAX_MATCH_SETS,
1814 
1815 	NL80211_ATTR_PMKSA_CANDIDATE,
1816 
1817 	NL80211_ATTR_TX_NO_CCK_RATE,
1818 
1819 	NL80211_ATTR_TDLS_ACTION,
1820 	NL80211_ATTR_TDLS_DIALOG_TOKEN,
1821 	NL80211_ATTR_TDLS_OPERATION,
1822 	NL80211_ATTR_TDLS_SUPPORT,
1823 	NL80211_ATTR_TDLS_EXTERNAL_SETUP,
1824 
1825 	NL80211_ATTR_DEVICE_AP_SME,
1826 
1827 	NL80211_ATTR_DONT_WAIT_FOR_ACK,
1828 
1829 	NL80211_ATTR_FEATURE_FLAGS,
1830 
1831 	NL80211_ATTR_PROBE_RESP_OFFLOAD,
1832 
1833 	NL80211_ATTR_PROBE_RESP,
1834 
1835 	NL80211_ATTR_DFS_REGION,
1836 
1837 	NL80211_ATTR_DISABLE_HT,
1838 	NL80211_ATTR_HT_CAPABILITY_MASK,
1839 
1840 	NL80211_ATTR_NOACK_MAP,
1841 
1842 	NL80211_ATTR_INACTIVITY_TIMEOUT,
1843 
1844 	NL80211_ATTR_RX_SIGNAL_DBM,
1845 
1846 	NL80211_ATTR_BG_SCAN_PERIOD,
1847 
1848 	NL80211_ATTR_WDEV,
1849 
1850 	NL80211_ATTR_USER_REG_HINT_TYPE,
1851 
1852 	NL80211_ATTR_CONN_FAILED_REASON,
1853 
1854 	NL80211_ATTR_SAE_DATA,
1855 
1856 	NL80211_ATTR_VHT_CAPABILITY,
1857 
1858 	NL80211_ATTR_SCAN_FLAGS,
1859 
1860 	NL80211_ATTR_CHANNEL_WIDTH,
1861 	NL80211_ATTR_CENTER_FREQ1,
1862 	NL80211_ATTR_CENTER_FREQ2,
1863 
1864 	NL80211_ATTR_P2P_CTWINDOW,
1865 	NL80211_ATTR_P2P_OPPPS,
1866 
1867 	NL80211_ATTR_LOCAL_MESH_POWER_MODE,
1868 
1869 	NL80211_ATTR_ACL_POLICY,
1870 
1871 	NL80211_ATTR_MAC_ADDRS,
1872 
1873 	NL80211_ATTR_MAC_ACL_MAX,
1874 
1875 	NL80211_ATTR_RADAR_EVENT,
1876 
1877 	NL80211_ATTR_EXT_CAPA,
1878 	NL80211_ATTR_EXT_CAPA_MASK,
1879 
1880 	NL80211_ATTR_STA_CAPABILITY,
1881 	NL80211_ATTR_STA_EXT_CAPABILITY,
1882 
1883 	NL80211_ATTR_PROTOCOL_FEATURES,
1884 	NL80211_ATTR_SPLIT_WIPHY_DUMP,
1885 
1886 	NL80211_ATTR_DISABLE_VHT,
1887 	NL80211_ATTR_VHT_CAPABILITY_MASK,
1888 
1889 	NL80211_ATTR_MDID,
1890 	NL80211_ATTR_IE_RIC,
1891 
1892 	NL80211_ATTR_CRIT_PROT_ID,
1893 	NL80211_ATTR_MAX_CRIT_PROT_DURATION,
1894 
1895 	NL80211_ATTR_PEER_AID,
1896 
1897 	NL80211_ATTR_COALESCE_RULE,
1898 
1899 	NL80211_ATTR_CH_SWITCH_COUNT,
1900 	NL80211_ATTR_CH_SWITCH_BLOCK_TX,
1901 	NL80211_ATTR_CSA_IES,
1902 	NL80211_ATTR_CSA_C_OFF_BEACON,
1903 	NL80211_ATTR_CSA_C_OFF_PRESP,
1904 
1905 	NL80211_ATTR_RXMGMT_FLAGS,
1906 
1907 	NL80211_ATTR_STA_SUPPORTED_CHANNELS,
1908 
1909 	NL80211_ATTR_STA_SUPPORTED_OPER_CLASSES,
1910 
1911 	NL80211_ATTR_HANDLE_DFS,
1912 
1913 	NL80211_ATTR_SUPPORT_5_MHZ,
1914 	NL80211_ATTR_SUPPORT_10_MHZ,
1915 
1916 	NL80211_ATTR_OPMODE_NOTIF,
1917 
1918 	NL80211_ATTR_VENDOR_ID,
1919 	NL80211_ATTR_VENDOR_SUBCMD,
1920 	NL80211_ATTR_VENDOR_DATA,
1921 	NL80211_ATTR_VENDOR_EVENTS,
1922 
1923 	NL80211_ATTR_QOS_MAP,
1924 
1925 	NL80211_ATTR_MAC_HINT,
1926 	NL80211_ATTR_WIPHY_FREQ_HINT,
1927 
1928 	NL80211_ATTR_MAX_AP_ASSOC_STA,
1929 
1930 	NL80211_ATTR_TDLS_PEER_CAPABILITY,
1931 
1932 	NL80211_ATTR_IFACE_SOCKET_OWNER,
1933 
1934 	NL80211_ATTR_CSA_C_OFFSETS_TX,
1935 	NL80211_ATTR_MAX_CSA_COUNTERS,
1936 
1937 	NL80211_ATTR_TDLS_INITIATOR,
1938 
1939 	/* add attributes here, update the policy in nl80211.c */
1940 
1941 	__NL80211_ATTR_AFTER_LAST,
1942 	NL80211_ATTR_MAX = __NL80211_ATTR_AFTER_LAST - 1
1943 };
1944 
1945 /* source-level API compatibility */
1946 #define NL80211_ATTR_SCAN_GENERATION NL80211_ATTR_GENERATION
1947 #define	NL80211_ATTR_MESH_PARAMS NL80211_ATTR_MESH_CONFIG
1948 
1949 /*
1950  * Allow user space programs to use #ifdef on new attributes by defining them
1951  * here
1952  */
1953 #define NL80211_CMD_CONNECT NL80211_CMD_CONNECT
1954 #define NL80211_ATTR_HT_CAPABILITY NL80211_ATTR_HT_CAPABILITY
1955 #define NL80211_ATTR_BSS_BASIC_RATES NL80211_ATTR_BSS_BASIC_RATES
1956 #define NL80211_ATTR_WIPHY_TXQ_PARAMS NL80211_ATTR_WIPHY_TXQ_PARAMS
1957 #define NL80211_ATTR_WIPHY_FREQ NL80211_ATTR_WIPHY_FREQ
1958 #define NL80211_ATTR_WIPHY_CHANNEL_TYPE NL80211_ATTR_WIPHY_CHANNEL_TYPE
1959 #define NL80211_ATTR_MGMT_SUBTYPE NL80211_ATTR_MGMT_SUBTYPE
1960 #define NL80211_ATTR_IE NL80211_ATTR_IE
1961 #define NL80211_ATTR_REG_INITIATOR NL80211_ATTR_REG_INITIATOR
1962 #define NL80211_ATTR_REG_TYPE NL80211_ATTR_REG_TYPE
1963 #define NL80211_ATTR_FRAME NL80211_ATTR_FRAME
1964 #define NL80211_ATTR_SSID NL80211_ATTR_SSID
1965 #define NL80211_ATTR_AUTH_TYPE NL80211_ATTR_AUTH_TYPE
1966 #define NL80211_ATTR_REASON_CODE NL80211_ATTR_REASON_CODE
1967 #define NL80211_ATTR_CIPHER_SUITES_PAIRWISE NL80211_ATTR_CIPHER_SUITES_PAIRWISE
1968 #define NL80211_ATTR_CIPHER_SUITE_GROUP NL80211_ATTR_CIPHER_SUITE_GROUP
1969 #define NL80211_ATTR_WPA_VERSIONS NL80211_ATTR_WPA_VERSIONS
1970 #define NL80211_ATTR_AKM_SUITES NL80211_ATTR_AKM_SUITES
1971 #define NL80211_ATTR_KEY NL80211_ATTR_KEY
1972 #define NL80211_ATTR_KEYS NL80211_ATTR_KEYS
1973 #define NL80211_ATTR_FEATURE_FLAGS NL80211_ATTR_FEATURE_FLAGS
1974 
1975 #define NL80211_MAX_SUPP_RATES			32
1976 #define NL80211_MAX_SUPP_HT_RATES		77
1977 #define NL80211_MAX_SUPP_REG_RULES		32
1978 #define NL80211_TKIP_DATA_OFFSET_ENCR_KEY	0
1979 #define NL80211_TKIP_DATA_OFFSET_TX_MIC_KEY	16
1980 #define NL80211_TKIP_DATA_OFFSET_RX_MIC_KEY	24
1981 #define NL80211_HT_CAPABILITY_LEN		26
1982 #define NL80211_VHT_CAPABILITY_LEN		12
1983 
1984 #define NL80211_MAX_NR_CIPHER_SUITES		5
1985 #define NL80211_MAX_NR_AKM_SUITES		2
1986 
1987 #define NL80211_MIN_REMAIN_ON_CHANNEL_TIME	10
1988 
1989 /* default RSSI threshold for scan results if none specified. */
1990 #define NL80211_SCAN_RSSI_THOLD_OFF		-300
1991 
1992 #define NL80211_CQM_TXE_MAX_INTVL		1800
1993 
1994 /**
1995  * enum nl80211_iftype - (virtual) interface types
1996  *
1997  * @NL80211_IFTYPE_UNSPECIFIED: unspecified type, driver decides
1998  * @NL80211_IFTYPE_ADHOC: independent BSS member
1999  * @NL80211_IFTYPE_STATION: managed BSS member
2000  * @NL80211_IFTYPE_AP: access point
2001  * @NL80211_IFTYPE_AP_VLAN: VLAN interface for access points; VLAN interfaces
2002  *	are a bit special in that they must always be tied to a pre-existing
2003  *	AP type interface.
2004  * @NL80211_IFTYPE_WDS: wireless distribution interface
2005  * @NL80211_IFTYPE_MONITOR: monitor interface receiving all frames
2006  * @NL80211_IFTYPE_MESH_POINT: mesh point
2007  * @NL80211_IFTYPE_P2P_CLIENT: P2P client
2008  * @NL80211_IFTYPE_P2P_GO: P2P group owner
2009  * @NL80211_IFTYPE_P2P_DEVICE: P2P device interface type, this is not a netdev
2010  *	and therefore can't be created in the normal ways, use the
2011  *	%NL80211_CMD_START_P2P_DEVICE and %NL80211_CMD_STOP_P2P_DEVICE
2012  *	commands to create and destroy one
2013  * @NL80211_IFTYPE_MAX: highest interface type number currently defined
2014  * @NUM_NL80211_IFTYPES: number of defined interface types
2015  *
2016  * These values are used with the %NL80211_ATTR_IFTYPE
2017  * to set the type of an interface.
2018  *
2019  */
2020 enum nl80211_iftype {
2021 	NL80211_IFTYPE_UNSPECIFIED,
2022 	NL80211_IFTYPE_ADHOC,
2023 	NL80211_IFTYPE_STATION,
2024 	NL80211_IFTYPE_AP,
2025 	NL80211_IFTYPE_AP_VLAN,
2026 	NL80211_IFTYPE_WDS,
2027 	NL80211_IFTYPE_MONITOR,
2028 	NL80211_IFTYPE_MESH_POINT,
2029 	NL80211_IFTYPE_P2P_CLIENT,
2030 	NL80211_IFTYPE_P2P_GO,
2031 	NL80211_IFTYPE_P2P_DEVICE,
2032 
2033 	/* keep last */
2034 	NUM_NL80211_IFTYPES,
2035 	NL80211_IFTYPE_MAX = NUM_NL80211_IFTYPES - 1
2036 };
2037 
2038 /**
2039  * enum nl80211_sta_flags - station flags
2040  *
2041  * Station flags. When a station is added to an AP interface, it is
2042  * assumed to be already associated (and hence authenticated.)
2043  *
2044  * @__NL80211_STA_FLAG_INVALID: attribute number 0 is reserved
2045  * @NL80211_STA_FLAG_AUTHORIZED: station is authorized (802.1X)
2046  * @NL80211_STA_FLAG_SHORT_PREAMBLE: station is capable of receiving frames
2047  *	with short barker preamble
2048  * @NL80211_STA_FLAG_WME: station is WME/QoS capable
2049  * @NL80211_STA_FLAG_MFP: station uses management frame protection
2050  * @NL80211_STA_FLAG_AUTHENTICATED: station is authenticated
2051  * @NL80211_STA_FLAG_TDLS_PEER: station is a TDLS peer -- this flag should
2052  *	only be used in managed mode (even in the flags mask). Note that the
2053  *	flag can't be changed, it is only valid while adding a station, and
2054  *	attempts to change it will silently be ignored (rather than rejected
2055  *	as errors.)
2056  * @NL80211_STA_FLAG_ASSOCIATED: station is associated; used with drivers
2057  *	that support %NL80211_FEATURE_FULL_AP_CLIENT_STATE to transition a
2058  *	previously added station into associated state
2059  * @NL80211_STA_FLAG_MAX: highest station flag number currently defined
2060  * @__NL80211_STA_FLAG_AFTER_LAST: internal use
2061  */
2062 enum nl80211_sta_flags {
2063 	__NL80211_STA_FLAG_INVALID,
2064 	NL80211_STA_FLAG_AUTHORIZED,
2065 	NL80211_STA_FLAG_SHORT_PREAMBLE,
2066 	NL80211_STA_FLAG_WME,
2067 	NL80211_STA_FLAG_MFP,
2068 	NL80211_STA_FLAG_AUTHENTICATED,
2069 	NL80211_STA_FLAG_TDLS_PEER,
2070 	NL80211_STA_FLAG_ASSOCIATED,
2071 
2072 	/* keep last */
2073 	__NL80211_STA_FLAG_AFTER_LAST,
2074 	NL80211_STA_FLAG_MAX = __NL80211_STA_FLAG_AFTER_LAST - 1
2075 };
2076 
2077 #define NL80211_STA_FLAG_MAX_OLD_API	NL80211_STA_FLAG_TDLS_PEER
2078 
2079 /**
2080  * struct nl80211_sta_flag_update - station flags mask/set
2081  * @mask: mask of station flags to set
2082  * @set: which values to set them to
2083  *
2084  * Both mask and set contain bits as per &enum nl80211_sta_flags.
2085  */
2086 struct nl80211_sta_flag_update {
2087 	__u32 mask;
2088 	__u32 set;
2089 } __attribute__((packed));
2090 
2091 /**
2092  * enum nl80211_rate_info - bitrate information
2093  *
2094  * These attribute types are used with %NL80211_STA_INFO_TXRATE
2095  * when getting information about the bitrate of a station.
2096  * There are 2 attributes for bitrate, a legacy one that represents
2097  * a 16-bit value, and new one that represents a 32-bit value.
2098  * If the rate value fits into 16 bit, both attributes are reported
2099  * with the same value. If the rate is too high to fit into 16 bits
2100  * (>6.5535Gbps) only 32-bit attribute is included.
2101  * User space tools encouraged to use the 32-bit attribute and fall
2102  * back to the 16-bit one for compatibility with older kernels.
2103  *
2104  * @__NL80211_RATE_INFO_INVALID: attribute number 0 is reserved
2105  * @NL80211_RATE_INFO_BITRATE: total bitrate (u16, 100kbit/s)
2106  * @NL80211_RATE_INFO_MCS: mcs index for 802.11n (u8)
2107  * @NL80211_RATE_INFO_40_MHZ_WIDTH: 40 MHz dualchannel bitrate
2108  * @NL80211_RATE_INFO_SHORT_GI: 400ns guard interval
2109  * @NL80211_RATE_INFO_BITRATE32: total bitrate (u32, 100kbit/s)
2110  * @NL80211_RATE_INFO_MAX: highest rate_info number currently defined
2111  * @NL80211_RATE_INFO_VHT_MCS: MCS index for VHT (u8)
2112  * @NL80211_RATE_INFO_VHT_NSS: number of streams in VHT (u8)
2113  * @NL80211_RATE_INFO_80_MHZ_WIDTH: 80 MHz VHT rate
2114  * @NL80211_RATE_INFO_80P80_MHZ_WIDTH: 80+80 MHz VHT rate
2115  * @NL80211_RATE_INFO_160_MHZ_WIDTH: 160 MHz VHT rate
2116  * @__NL80211_RATE_INFO_AFTER_LAST: internal use
2117  */
2118 enum nl80211_rate_info {
2119 	__NL80211_RATE_INFO_INVALID,
2120 	NL80211_RATE_INFO_BITRATE,
2121 	NL80211_RATE_INFO_MCS,
2122 	NL80211_RATE_INFO_40_MHZ_WIDTH,
2123 	NL80211_RATE_INFO_SHORT_GI,
2124 	NL80211_RATE_INFO_BITRATE32,
2125 	NL80211_RATE_INFO_VHT_MCS,
2126 	NL80211_RATE_INFO_VHT_NSS,
2127 	NL80211_RATE_INFO_80_MHZ_WIDTH,
2128 	NL80211_RATE_INFO_80P80_MHZ_WIDTH,
2129 	NL80211_RATE_INFO_160_MHZ_WIDTH,
2130 
2131 	/* keep last */
2132 	__NL80211_RATE_INFO_AFTER_LAST,
2133 	NL80211_RATE_INFO_MAX = __NL80211_RATE_INFO_AFTER_LAST - 1
2134 };
2135 
2136 /**
2137  * enum nl80211_sta_bss_param - BSS information collected by STA
2138  *
2139  * These attribute types are used with %NL80211_STA_INFO_BSS_PARAM
2140  * when getting information about the bitrate of a station.
2141  *
2142  * @__NL80211_STA_BSS_PARAM_INVALID: attribute number 0 is reserved
2143  * @NL80211_STA_BSS_PARAM_CTS_PROT: whether CTS protection is enabled (flag)
2144  * @NL80211_STA_BSS_PARAM_SHORT_PREAMBLE:  whether short preamble is enabled
2145  *	(flag)
2146  * @NL80211_STA_BSS_PARAM_SHORT_SLOT_TIME:  whether short slot time is enabled
2147  *	(flag)
2148  * @NL80211_STA_BSS_PARAM_DTIM_PERIOD: DTIM period for beaconing (u8)
2149  * @NL80211_STA_BSS_PARAM_BEACON_INTERVAL: Beacon interval (u16)
2150  * @NL80211_STA_BSS_PARAM_MAX: highest sta_bss_param number currently defined
2151  * @__NL80211_STA_BSS_PARAM_AFTER_LAST: internal use
2152  */
2153 enum nl80211_sta_bss_param {
2154 	__NL80211_STA_BSS_PARAM_INVALID,
2155 	NL80211_STA_BSS_PARAM_CTS_PROT,
2156 	NL80211_STA_BSS_PARAM_SHORT_PREAMBLE,
2157 	NL80211_STA_BSS_PARAM_SHORT_SLOT_TIME,
2158 	NL80211_STA_BSS_PARAM_DTIM_PERIOD,
2159 	NL80211_STA_BSS_PARAM_BEACON_INTERVAL,
2160 
2161 	/* keep last */
2162 	__NL80211_STA_BSS_PARAM_AFTER_LAST,
2163 	NL80211_STA_BSS_PARAM_MAX = __NL80211_STA_BSS_PARAM_AFTER_LAST - 1
2164 };
2165 
2166 /**
2167  * enum nl80211_sta_info - station information
2168  *
2169  * These attribute types are used with %NL80211_ATTR_STA_INFO
2170  * when getting information about a station.
2171  *
2172  * @__NL80211_STA_INFO_INVALID: attribute number 0 is reserved
2173  * @NL80211_STA_INFO_INACTIVE_TIME: time since last activity (u32, msecs)
2174  * @NL80211_STA_INFO_RX_BYTES: total received bytes (u32, from this station)
2175  * @NL80211_STA_INFO_TX_BYTES: total transmitted bytes (u32, to this station)
2176  * @NL80211_STA_INFO_RX_BYTES64: total received bytes (u64, from this station)
2177  * @NL80211_STA_INFO_TX_BYTES64: total transmitted bytes (u64, to this station)
2178  * @NL80211_STA_INFO_SIGNAL: signal strength of last received PPDU (u8, dBm)
2179  * @NL80211_STA_INFO_TX_BITRATE: current unicast tx rate, nested attribute
2180  * 	containing info as possible, see &enum nl80211_rate_info
2181  * @NL80211_STA_INFO_RX_PACKETS: total received packet (u32, from this station)
2182  * @NL80211_STA_INFO_TX_PACKETS: total transmitted packets (u32, to this
2183  *	station)
2184  * @NL80211_STA_INFO_TX_RETRIES: total retries (u32, to this station)
2185  * @NL80211_STA_INFO_TX_FAILED: total failed packets (u32, to this station)
2186  * @NL80211_STA_INFO_SIGNAL_AVG: signal strength average (u8, dBm)
2187  * @NL80211_STA_INFO_LLID: the station's mesh LLID
2188  * @NL80211_STA_INFO_PLID: the station's mesh PLID
2189  * @NL80211_STA_INFO_PLINK_STATE: peer link state for the station
2190  *	(see %enum nl80211_plink_state)
2191  * @NL80211_STA_INFO_RX_BITRATE: last unicast data frame rx rate, nested
2192  *	attribute, like NL80211_STA_INFO_TX_BITRATE.
2193  * @NL80211_STA_INFO_BSS_PARAM: current station's view of BSS, nested attribute
2194  *     containing info as possible, see &enum nl80211_sta_bss_param
2195  * @NL80211_STA_INFO_CONNECTED_TIME: time since the station is last connected
2196  * @NL80211_STA_INFO_STA_FLAGS: Contains a struct nl80211_sta_flag_update.
2197  * @NL80211_STA_INFO_BEACON_LOSS: count of times beacon loss was detected (u32)
2198  * @NL80211_STA_INFO_T_OFFSET: timing offset with respect to this STA (s64)
2199  * @NL80211_STA_INFO_LOCAL_PM: local mesh STA link-specific power mode
2200  * @NL80211_STA_INFO_PEER_PM: peer mesh STA link-specific power mode
2201  * @NL80211_STA_INFO_NONPEER_PM: neighbor mesh STA power save mode towards
2202  *	non-peer STA
2203  * @NL80211_STA_INFO_CHAIN_SIGNAL: per-chain signal strength of last PPDU
2204  *	Contains a nested array of signal strength attributes (u8, dBm)
2205  * @NL80211_STA_INFO_CHAIN_SIGNAL_AVG: per-chain signal strength average
2206  *	Same format as NL80211_STA_INFO_CHAIN_SIGNAL.
2207  * @NL80211_STA_EXPECTED_THROUGHPUT: expected throughput considering also the
2208  *	802.11 header (u32, kbps)
2209  * @__NL80211_STA_INFO_AFTER_LAST: internal
2210  * @NL80211_STA_INFO_MAX: highest possible station info attribute
2211  */
2212 enum nl80211_sta_info {
2213 	__NL80211_STA_INFO_INVALID,
2214 	NL80211_STA_INFO_INACTIVE_TIME,
2215 	NL80211_STA_INFO_RX_BYTES,
2216 	NL80211_STA_INFO_TX_BYTES,
2217 	NL80211_STA_INFO_LLID,
2218 	NL80211_STA_INFO_PLID,
2219 	NL80211_STA_INFO_PLINK_STATE,
2220 	NL80211_STA_INFO_SIGNAL,
2221 	NL80211_STA_INFO_TX_BITRATE,
2222 	NL80211_STA_INFO_RX_PACKETS,
2223 	NL80211_STA_INFO_TX_PACKETS,
2224 	NL80211_STA_INFO_TX_RETRIES,
2225 	NL80211_STA_INFO_TX_FAILED,
2226 	NL80211_STA_INFO_SIGNAL_AVG,
2227 	NL80211_STA_INFO_RX_BITRATE,
2228 	NL80211_STA_INFO_BSS_PARAM,
2229 	NL80211_STA_INFO_CONNECTED_TIME,
2230 	NL80211_STA_INFO_STA_FLAGS,
2231 	NL80211_STA_INFO_BEACON_LOSS,
2232 	NL80211_STA_INFO_T_OFFSET,
2233 	NL80211_STA_INFO_LOCAL_PM,
2234 	NL80211_STA_INFO_PEER_PM,
2235 	NL80211_STA_INFO_NONPEER_PM,
2236 	NL80211_STA_INFO_RX_BYTES64,
2237 	NL80211_STA_INFO_TX_BYTES64,
2238 	NL80211_STA_INFO_CHAIN_SIGNAL,
2239 	NL80211_STA_INFO_CHAIN_SIGNAL_AVG,
2240 	NL80211_STA_INFO_EXPECTED_THROUGHPUT,
2241 
2242 	/* keep last */
2243 	__NL80211_STA_INFO_AFTER_LAST,
2244 	NL80211_STA_INFO_MAX = __NL80211_STA_INFO_AFTER_LAST - 1
2245 };
2246 
2247 /**
2248  * enum nl80211_mpath_flags - nl80211 mesh path flags
2249  *
2250  * @NL80211_MPATH_FLAG_ACTIVE: the mesh path is active
2251  * @NL80211_MPATH_FLAG_RESOLVING: the mesh path discovery process is running
2252  * @NL80211_MPATH_FLAG_SN_VALID: the mesh path contains a valid SN
2253  * @NL80211_MPATH_FLAG_FIXED: the mesh path has been manually set
2254  * @NL80211_MPATH_FLAG_RESOLVED: the mesh path discovery process succeeded
2255  */
2256 enum nl80211_mpath_flags {
2257 	NL80211_MPATH_FLAG_ACTIVE =	1<<0,
2258 	NL80211_MPATH_FLAG_RESOLVING =	1<<1,
2259 	NL80211_MPATH_FLAG_SN_VALID =	1<<2,
2260 	NL80211_MPATH_FLAG_FIXED =	1<<3,
2261 	NL80211_MPATH_FLAG_RESOLVED =	1<<4,
2262 };
2263 
2264 /**
2265  * enum nl80211_mpath_info - mesh path information
2266  *
2267  * These attribute types are used with %NL80211_ATTR_MPATH_INFO when getting
2268  * information about a mesh path.
2269  *
2270  * @__NL80211_MPATH_INFO_INVALID: attribute number 0 is reserved
2271  * @NL80211_MPATH_INFO_FRAME_QLEN: number of queued frames for this destination
2272  * @NL80211_MPATH_INFO_SN: destination sequence number
2273  * @NL80211_MPATH_INFO_METRIC: metric (cost) of this mesh path
2274  * @NL80211_MPATH_INFO_EXPTIME: expiration time for the path, in msec from now
2275  * @NL80211_MPATH_INFO_FLAGS: mesh path flags, enumerated in
2276  * 	&enum nl80211_mpath_flags;
2277  * @NL80211_MPATH_INFO_DISCOVERY_TIMEOUT: total path discovery timeout, in msec
2278  * @NL80211_MPATH_INFO_DISCOVERY_RETRIES: mesh path discovery retries
2279  * @NL80211_MPATH_INFO_MAX: highest mesh path information attribute number
2280  *	currently defind
2281  * @__NL80211_MPATH_INFO_AFTER_LAST: internal use
2282  */
2283 enum nl80211_mpath_info {
2284 	__NL80211_MPATH_INFO_INVALID,
2285 	NL80211_MPATH_INFO_FRAME_QLEN,
2286 	NL80211_MPATH_INFO_SN,
2287 	NL80211_MPATH_INFO_METRIC,
2288 	NL80211_MPATH_INFO_EXPTIME,
2289 	NL80211_MPATH_INFO_FLAGS,
2290 	NL80211_MPATH_INFO_DISCOVERY_TIMEOUT,
2291 	NL80211_MPATH_INFO_DISCOVERY_RETRIES,
2292 
2293 	/* keep last */
2294 	__NL80211_MPATH_INFO_AFTER_LAST,
2295 	NL80211_MPATH_INFO_MAX = __NL80211_MPATH_INFO_AFTER_LAST - 1
2296 };
2297 
2298 /**
2299  * enum nl80211_band_attr - band attributes
2300  * @__NL80211_BAND_ATTR_INVALID: attribute number 0 is reserved
2301  * @NL80211_BAND_ATTR_FREQS: supported frequencies in this band,
2302  *	an array of nested frequency attributes
2303  * @NL80211_BAND_ATTR_RATES: supported bitrates in this band,
2304  *	an array of nested bitrate attributes
2305  * @NL80211_BAND_ATTR_HT_MCS_SET: 16-byte attribute containing the MCS set as
2306  *	defined in 802.11n
2307  * @NL80211_BAND_ATTR_HT_CAPA: HT capabilities, as in the HT information IE
2308  * @NL80211_BAND_ATTR_HT_AMPDU_FACTOR: A-MPDU factor, as in 11n
2309  * @NL80211_BAND_ATTR_HT_AMPDU_DENSITY: A-MPDU density, as in 11n
2310  * @NL80211_BAND_ATTR_VHT_MCS_SET: 32-byte attribute containing the MCS set as
2311  *	defined in 802.11ac
2312  * @NL80211_BAND_ATTR_VHT_CAPA: VHT capabilities, as in the HT information IE
2313  * @NL80211_BAND_ATTR_MAX: highest band attribute currently defined
2314  * @__NL80211_BAND_ATTR_AFTER_LAST: internal use
2315  */
2316 enum nl80211_band_attr {
2317 	__NL80211_BAND_ATTR_INVALID,
2318 	NL80211_BAND_ATTR_FREQS,
2319 	NL80211_BAND_ATTR_RATES,
2320 
2321 	NL80211_BAND_ATTR_HT_MCS_SET,
2322 	NL80211_BAND_ATTR_HT_CAPA,
2323 	NL80211_BAND_ATTR_HT_AMPDU_FACTOR,
2324 	NL80211_BAND_ATTR_HT_AMPDU_DENSITY,
2325 
2326 	NL80211_BAND_ATTR_VHT_MCS_SET,
2327 	NL80211_BAND_ATTR_VHT_CAPA,
2328 
2329 	/* keep last */
2330 	__NL80211_BAND_ATTR_AFTER_LAST,
2331 	NL80211_BAND_ATTR_MAX = __NL80211_BAND_ATTR_AFTER_LAST - 1
2332 };
2333 
2334 #define NL80211_BAND_ATTR_HT_CAPA NL80211_BAND_ATTR_HT_CAPA
2335 
2336 /**
2337  * enum nl80211_frequency_attr - frequency attributes
2338  * @__NL80211_FREQUENCY_ATTR_INVALID: attribute number 0 is reserved
2339  * @NL80211_FREQUENCY_ATTR_FREQ: Frequency in MHz
2340  * @NL80211_FREQUENCY_ATTR_DISABLED: Channel is disabled in current
2341  *	regulatory domain.
2342  * @NL80211_FREQUENCY_ATTR_NO_IR: no mechanisms that initiate radiation
2343  * 	are permitted on this channel, this includes sending probe
2344  * 	requests, or modes of operation that require beaconing.
2345  * @NL80211_FREQUENCY_ATTR_RADAR: Radar detection is mandatory
2346  *	on this channel in current regulatory domain.
2347  * @NL80211_FREQUENCY_ATTR_MAX_TX_POWER: Maximum transmission power in mBm
2348  *	(100 * dBm).
2349  * @NL80211_FREQUENCY_ATTR_DFS_STATE: current state for DFS
2350  *	(enum nl80211_dfs_state)
2351  * @NL80211_FREQUENCY_ATTR_DFS_TIME: time in miliseconds for how long
2352  *	this channel is in this DFS state.
2353  * @NL80211_FREQUENCY_ATTR_NO_HT40_MINUS: HT40- isn't possible with this
2354  *	channel as the control channel
2355  * @NL80211_FREQUENCY_ATTR_NO_HT40_PLUS: HT40+ isn't possible with this
2356  *	channel as the control channel
2357  * @NL80211_FREQUENCY_ATTR_NO_80MHZ: any 80 MHz channel using this channel
2358  *	as the primary or any of the secondary channels isn't possible,
2359  *	this includes 80+80 channels
2360  * @NL80211_FREQUENCY_ATTR_NO_160MHZ: any 160 MHz (but not 80+80) channel
2361  *	using this channel as the primary or any of the secondary channels
2362  *	isn't possible
2363  * @NL80211_FREQUENCY_ATTR_DFS_CAC_TIME: DFS CAC time in milliseconds.
2364  * @NL80211_FREQUENCY_ATTR_INDOOR_ONLY: Only indoor use is permitted on this
2365  *	channel. A channel that has the INDOOR_ONLY attribute can only be
2366  *	used when there is a clear assessment that the device is operating in
2367  *	an indoor surroundings, i.e., it is connected to AC power (and not
2368  *	through portable DC inverters) or is under the control of a master
2369  *	that is acting as an AP and is connected to AC power.
2370  * @NL80211_FREQUENCY_ATTR_GO_CONCURRENT: GO operation is allowed on this
2371  *	channel if it's connected concurrently to a BSS on the same channel on
2372  *	the 2 GHz band or to a channel in the same UNII band (on the 5 GHz
2373  *	band), and IEEE80211_CHAN_RADAR is not set. Instantiating a GO on a
2374  *	channel that has the GO_CONCURRENT attribute set can be done when there
2375  *	is a clear assessment that the device is operating under the guidance of
2376  *	an authorized master, i.e., setting up a GO while the device is also
2377  *	connected to an AP with DFS and radar detection on the UNII band (it is
2378  *	up to user-space, i.e., wpa_supplicant to perform the required
2379  *	verifications)
2380  * @NL80211_FREQUENCY_ATTR_NO_20MHZ: 20 MHz operation is not allowed
2381  *	on this channel in current regulatory domain.
2382  * @NL80211_FREQUENCY_ATTR_NO_10MHZ: 10 MHz operation is not allowed
2383  *	on this channel in current regulatory domain.
2384  * @NL80211_FREQUENCY_ATTR_MAX: highest frequency attribute number
2385  *	currently defined
2386  * @__NL80211_FREQUENCY_ATTR_AFTER_LAST: internal use
2387  *
2388  * See https://apps.fcc.gov/eas/comments/GetPublishedDocument.html?id=327&tn=528122
2389  * for more information on the FCC description of the relaxations allowed
2390  * by NL80211_FREQUENCY_ATTR_INDOOR_ONLY and
2391  * NL80211_FREQUENCY_ATTR_GO_CONCURRENT.
2392  */
2393 enum nl80211_frequency_attr {
2394 	__NL80211_FREQUENCY_ATTR_INVALID,
2395 	NL80211_FREQUENCY_ATTR_FREQ,
2396 	NL80211_FREQUENCY_ATTR_DISABLED,
2397 	NL80211_FREQUENCY_ATTR_NO_IR,
2398 	__NL80211_FREQUENCY_ATTR_NO_IBSS,
2399 	NL80211_FREQUENCY_ATTR_RADAR,
2400 	NL80211_FREQUENCY_ATTR_MAX_TX_POWER,
2401 	NL80211_FREQUENCY_ATTR_DFS_STATE,
2402 	NL80211_FREQUENCY_ATTR_DFS_TIME,
2403 	NL80211_FREQUENCY_ATTR_NO_HT40_MINUS,
2404 	NL80211_FREQUENCY_ATTR_NO_HT40_PLUS,
2405 	NL80211_FREQUENCY_ATTR_NO_80MHZ,
2406 	NL80211_FREQUENCY_ATTR_NO_160MHZ,
2407 	NL80211_FREQUENCY_ATTR_DFS_CAC_TIME,
2408 	NL80211_FREQUENCY_ATTR_INDOOR_ONLY,
2409 	NL80211_FREQUENCY_ATTR_GO_CONCURRENT,
2410 	NL80211_FREQUENCY_ATTR_NO_20MHZ,
2411 	NL80211_FREQUENCY_ATTR_NO_10MHZ,
2412 
2413 	/* keep last */
2414 	__NL80211_FREQUENCY_ATTR_AFTER_LAST,
2415 	NL80211_FREQUENCY_ATTR_MAX = __NL80211_FREQUENCY_ATTR_AFTER_LAST - 1
2416 };
2417 
2418 #define NL80211_FREQUENCY_ATTR_MAX_TX_POWER NL80211_FREQUENCY_ATTR_MAX_TX_POWER
2419 #define NL80211_FREQUENCY_ATTR_PASSIVE_SCAN	NL80211_FREQUENCY_ATTR_NO_IR
2420 #define NL80211_FREQUENCY_ATTR_NO_IBSS		NL80211_FREQUENCY_ATTR_NO_IR
2421 #define NL80211_FREQUENCY_ATTR_NO_IR		NL80211_FREQUENCY_ATTR_NO_IR
2422 
2423 /**
2424  * enum nl80211_bitrate_attr - bitrate attributes
2425  * @__NL80211_BITRATE_ATTR_INVALID: attribute number 0 is reserved
2426  * @NL80211_BITRATE_ATTR_RATE: Bitrate in units of 100 kbps
2427  * @NL80211_BITRATE_ATTR_2GHZ_SHORTPREAMBLE: Short preamble supported
2428  *	in 2.4 GHz band.
2429  * @NL80211_BITRATE_ATTR_MAX: highest bitrate attribute number
2430  *	currently defined
2431  * @__NL80211_BITRATE_ATTR_AFTER_LAST: internal use
2432  */
2433 enum nl80211_bitrate_attr {
2434 	__NL80211_BITRATE_ATTR_INVALID,
2435 	NL80211_BITRATE_ATTR_RATE,
2436 	NL80211_BITRATE_ATTR_2GHZ_SHORTPREAMBLE,
2437 
2438 	/* keep last */
2439 	__NL80211_BITRATE_ATTR_AFTER_LAST,
2440 	NL80211_BITRATE_ATTR_MAX = __NL80211_BITRATE_ATTR_AFTER_LAST - 1
2441 };
2442 
2443 /**
2444  * enum nl80211_initiator - Indicates the initiator of a reg domain request
2445  * @NL80211_REGDOM_SET_BY_CORE: Core queried CRDA for a dynamic world
2446  * 	regulatory domain.
2447  * @NL80211_REGDOM_SET_BY_USER: User asked the wireless core to set the
2448  * 	regulatory domain.
2449  * @NL80211_REGDOM_SET_BY_DRIVER: a wireless drivers has hinted to the
2450  * 	wireless core it thinks its knows the regulatory domain we should be in.
2451  * @NL80211_REGDOM_SET_BY_COUNTRY_IE: the wireless core has received an
2452  * 	802.11 country information element with regulatory information it
2453  * 	thinks we should consider. cfg80211 only processes the country
2454  *	code from the IE, and relies on the regulatory domain information
2455  *	structure passed by userspace (CRDA) from our wireless-regdb.
2456  *	If a channel is enabled but the country code indicates it should
2457  *	be disabled we disable the channel and re-enable it upon disassociation.
2458  */
2459 enum nl80211_reg_initiator {
2460 	NL80211_REGDOM_SET_BY_CORE,
2461 	NL80211_REGDOM_SET_BY_USER,
2462 	NL80211_REGDOM_SET_BY_DRIVER,
2463 	NL80211_REGDOM_SET_BY_COUNTRY_IE,
2464 };
2465 
2466 /**
2467  * enum nl80211_reg_type - specifies the type of regulatory domain
2468  * @NL80211_REGDOM_TYPE_COUNTRY: the regulatory domain set is one that pertains
2469  *	to a specific country. When this is set you can count on the
2470  *	ISO / IEC 3166 alpha2 country code being valid.
2471  * @NL80211_REGDOM_TYPE_WORLD: the regulatory set domain is the world regulatory
2472  * 	domain.
2473  * @NL80211_REGDOM_TYPE_CUSTOM_WORLD: the regulatory domain set is a custom
2474  * 	driver specific world regulatory domain. These do not apply system-wide
2475  * 	and are only applicable to the individual devices which have requested
2476  * 	them to be applied.
2477  * @NL80211_REGDOM_TYPE_INTERSECTION: the regulatory domain set is the product
2478  *	of an intersection between two regulatory domains -- the previously
2479  *	set regulatory domain on the system and the last accepted regulatory
2480  *	domain request to be processed.
2481  */
2482 enum nl80211_reg_type {
2483 	NL80211_REGDOM_TYPE_COUNTRY,
2484 	NL80211_REGDOM_TYPE_WORLD,
2485 	NL80211_REGDOM_TYPE_CUSTOM_WORLD,
2486 	NL80211_REGDOM_TYPE_INTERSECTION,
2487 };
2488 
2489 /**
2490  * enum nl80211_reg_rule_attr - regulatory rule attributes
2491  * @__NL80211_REG_RULE_ATTR_INVALID: attribute number 0 is reserved
2492  * @NL80211_ATTR_REG_RULE_FLAGS: a set of flags which specify additional
2493  * 	considerations for a given frequency range. These are the
2494  * 	&enum nl80211_reg_rule_flags.
2495  * @NL80211_ATTR_FREQ_RANGE_START: starting frequencry for the regulatory
2496  * 	rule in KHz. This is not a center of frequency but an actual regulatory
2497  * 	band edge.
2498  * @NL80211_ATTR_FREQ_RANGE_END: ending frequency for the regulatory rule
2499  * 	in KHz. This is not a center a frequency but an actual regulatory
2500  * 	band edge.
2501  * @NL80211_ATTR_FREQ_RANGE_MAX_BW: maximum allowed bandwidth for this
2502  *	frequency range, in KHz.
2503  * @NL80211_ATTR_POWER_RULE_MAX_ANT_GAIN: the maximum allowed antenna gain
2504  * 	for a given frequency range. The value is in mBi (100 * dBi).
2505  * 	If you don't have one then don't send this.
2506  * @NL80211_ATTR_POWER_RULE_MAX_EIRP: the maximum allowed EIRP for
2507  * 	a given frequency range. The value is in mBm (100 * dBm).
2508  * @NL80211_ATTR_DFS_CAC_TIME: DFS CAC time in milliseconds.
2509  *	If not present or 0 default CAC time will be used.
2510  * @NL80211_REG_RULE_ATTR_MAX: highest regulatory rule attribute number
2511  *	currently defined
2512  * @__NL80211_REG_RULE_ATTR_AFTER_LAST: internal use
2513  */
2514 enum nl80211_reg_rule_attr {
2515 	__NL80211_REG_RULE_ATTR_INVALID,
2516 	NL80211_ATTR_REG_RULE_FLAGS,
2517 
2518 	NL80211_ATTR_FREQ_RANGE_START,
2519 	NL80211_ATTR_FREQ_RANGE_END,
2520 	NL80211_ATTR_FREQ_RANGE_MAX_BW,
2521 
2522 	NL80211_ATTR_POWER_RULE_MAX_ANT_GAIN,
2523 	NL80211_ATTR_POWER_RULE_MAX_EIRP,
2524 
2525 	NL80211_ATTR_DFS_CAC_TIME,
2526 
2527 	/* keep last */
2528 	__NL80211_REG_RULE_ATTR_AFTER_LAST,
2529 	NL80211_REG_RULE_ATTR_MAX = __NL80211_REG_RULE_ATTR_AFTER_LAST - 1
2530 };
2531 
2532 /**
2533  * enum nl80211_sched_scan_match_attr - scheduled scan match attributes
2534  * @__NL80211_SCHED_SCAN_MATCH_ATTR_INVALID: attribute number 0 is reserved
2535  * @NL80211_SCHED_SCAN_MATCH_ATTR_SSID: SSID to be used for matching,
2536  *	only report BSS with matching SSID.
2537  * @NL80211_SCHED_SCAN_MATCH_ATTR_RSSI: RSSI threshold (in dBm) for reporting a
2538  *	BSS in scan results. Filtering is turned off if not specified. Note that
2539  *	if this attribute is in a match set of its own, then it is treated as
2540  *	the default value for all matchsets with an SSID, rather than being a
2541  *	matchset of its own without an RSSI filter. This is due to problems with
2542  *	how this API was implemented in the past. Also, due to the same problem,
2543  *	the only way to create a matchset with only an RSSI filter (with this
2544  *	attribute) is if there's only a single matchset with the RSSI attribute.
2545  * @NL80211_SCHED_SCAN_MATCH_ATTR_MAX: highest scheduled scan filter
2546  *	attribute number currently defined
2547  * @__NL80211_SCHED_SCAN_MATCH_ATTR_AFTER_LAST: internal use
2548  */
2549 enum nl80211_sched_scan_match_attr {
2550 	__NL80211_SCHED_SCAN_MATCH_ATTR_INVALID,
2551 
2552 	NL80211_SCHED_SCAN_MATCH_ATTR_SSID,
2553 	NL80211_SCHED_SCAN_MATCH_ATTR_RSSI,
2554 
2555 	/* keep last */
2556 	__NL80211_SCHED_SCAN_MATCH_ATTR_AFTER_LAST,
2557 	NL80211_SCHED_SCAN_MATCH_ATTR_MAX =
2558 		__NL80211_SCHED_SCAN_MATCH_ATTR_AFTER_LAST - 1
2559 };
2560 
2561 /* only for backward compatibility */
2562 #define NL80211_ATTR_SCHED_SCAN_MATCH_SSID NL80211_SCHED_SCAN_MATCH_ATTR_SSID
2563 
2564 /**
2565  * enum nl80211_reg_rule_flags - regulatory rule flags
2566  *
2567  * @NL80211_RRF_NO_OFDM: OFDM modulation not allowed
2568  * @NL80211_RRF_NO_CCK: CCK modulation not allowed
2569  * @NL80211_RRF_NO_INDOOR: indoor operation not allowed
2570  * @NL80211_RRF_NO_OUTDOOR: outdoor operation not allowed
2571  * @NL80211_RRF_DFS: DFS support is required to be used
2572  * @NL80211_RRF_PTP_ONLY: this is only for Point To Point links
2573  * @NL80211_RRF_PTMP_ONLY: this is only for Point To Multi Point links
2574  * @NL80211_RRF_NO_IR: no mechanisms that initiate radiation are allowed,
2575  * 	this includes probe requests or modes of operation that require
2576  * 	beaconing.
2577  * @NL80211_RRF_AUTO_BW: maximum available bandwidth should be calculated
2578  *	base on contiguous rules and wider channels will be allowed to cross
2579  *	multiple contiguous/overlapping frequency ranges.
2580  */
2581 enum nl80211_reg_rule_flags {
2582 	NL80211_RRF_NO_OFDM		= 1<<0,
2583 	NL80211_RRF_NO_CCK		= 1<<1,
2584 	NL80211_RRF_NO_INDOOR		= 1<<2,
2585 	NL80211_RRF_NO_OUTDOOR		= 1<<3,
2586 	NL80211_RRF_DFS			= 1<<4,
2587 	NL80211_RRF_PTP_ONLY		= 1<<5,
2588 	NL80211_RRF_PTMP_ONLY		= 1<<6,
2589 	NL80211_RRF_NO_IR		= 1<<7,
2590 	__NL80211_RRF_NO_IBSS		= 1<<8,
2591 	NL80211_RRF_AUTO_BW		= 1<<11,
2592 };
2593 
2594 #define NL80211_RRF_PASSIVE_SCAN	NL80211_RRF_NO_IR
2595 #define NL80211_RRF_NO_IBSS		NL80211_RRF_NO_IR
2596 #define NL80211_RRF_NO_IR		NL80211_RRF_NO_IR
2597 
2598 /* For backport compatibility with older userspace */
2599 #define NL80211_RRF_NO_IR_ALL		(NL80211_RRF_NO_IR | __NL80211_RRF_NO_IBSS)
2600 
2601 /**
2602  * enum nl80211_dfs_regions - regulatory DFS regions
2603  *
2604  * @NL80211_DFS_UNSET: Country has no DFS master region specified
2605  * @NL80211_DFS_FCC: Country follows DFS master rules from FCC
2606  * @NL80211_DFS_ETSI: Country follows DFS master rules from ETSI
2607  * @NL80211_DFS_JP: Country follows DFS master rules from JP/MKK/Telec
2608  */
2609 enum nl80211_dfs_regions {
2610 	NL80211_DFS_UNSET	= 0,
2611 	NL80211_DFS_FCC		= 1,
2612 	NL80211_DFS_ETSI	= 2,
2613 	NL80211_DFS_JP		= 3,
2614 };
2615 
2616 /**
2617  * enum nl80211_user_reg_hint_type - type of user regulatory hint
2618  *
2619  * @NL80211_USER_REG_HINT_USER: a user sent the hint. This is always
2620  *	assumed if the attribute is not set.
2621  * @NL80211_USER_REG_HINT_CELL_BASE: the hint comes from a cellular
2622  *	base station. Device drivers that have been tested to work
2623  *	properly to support this type of hint can enable these hints
2624  *	by setting the NL80211_FEATURE_CELL_BASE_REG_HINTS feature
2625  *	capability on the struct wiphy. The wireless core will
2626  *	ignore all cell base station hints until at least one device
2627  *	present has been registered with the wireless core that
2628  *	has listed NL80211_FEATURE_CELL_BASE_REG_HINTS as a
2629  *	supported feature.
2630  * @NL80211_USER_REG_HINT_INDOOR: a user sent an hint indicating that the
2631  *	platform is operating in an indoor environment.
2632  */
2633 enum nl80211_user_reg_hint_type {
2634 	NL80211_USER_REG_HINT_USER	= 0,
2635 	NL80211_USER_REG_HINT_CELL_BASE = 1,
2636 	NL80211_USER_REG_HINT_INDOOR    = 2,
2637 };
2638 
2639 /**
2640  * enum nl80211_survey_info - survey information
2641  *
2642  * These attribute types are used with %NL80211_ATTR_SURVEY_INFO
2643  * when getting information about a survey.
2644  *
2645  * @__NL80211_SURVEY_INFO_INVALID: attribute number 0 is reserved
2646  * @NL80211_SURVEY_INFO_FREQUENCY: center frequency of channel
2647  * @NL80211_SURVEY_INFO_NOISE: noise level of channel (u8, dBm)
2648  * @NL80211_SURVEY_INFO_IN_USE: channel is currently being used
2649  * @NL80211_SURVEY_INFO_CHANNEL_TIME: amount of time (in ms) that the radio
2650  *	spent on this channel
2651  * @NL80211_SURVEY_INFO_CHANNEL_TIME_BUSY: amount of the time the primary
2652  *	channel was sensed busy (either due to activity or energy detect)
2653  * @NL80211_SURVEY_INFO_CHANNEL_TIME_EXT_BUSY: amount of time the extension
2654  *	channel was sensed busy
2655  * @NL80211_SURVEY_INFO_CHANNEL_TIME_RX: amount of time the radio spent
2656  *	receiving data
2657  * @NL80211_SURVEY_INFO_CHANNEL_TIME_TX: amount of time the radio spent
2658  *	transmitting data
2659  * @NL80211_SURVEY_INFO_MAX: highest survey info attribute number
2660  *	currently defined
2661  * @__NL80211_SURVEY_INFO_AFTER_LAST: internal use
2662  */
2663 enum nl80211_survey_info {
2664 	__NL80211_SURVEY_INFO_INVALID,
2665 	NL80211_SURVEY_INFO_FREQUENCY,
2666 	NL80211_SURVEY_INFO_NOISE,
2667 	NL80211_SURVEY_INFO_IN_USE,
2668 	NL80211_SURVEY_INFO_CHANNEL_TIME,
2669 	NL80211_SURVEY_INFO_CHANNEL_TIME_BUSY,
2670 	NL80211_SURVEY_INFO_CHANNEL_TIME_EXT_BUSY,
2671 	NL80211_SURVEY_INFO_CHANNEL_TIME_RX,
2672 	NL80211_SURVEY_INFO_CHANNEL_TIME_TX,
2673 
2674 	/* keep last */
2675 	__NL80211_SURVEY_INFO_AFTER_LAST,
2676 	NL80211_SURVEY_INFO_MAX = __NL80211_SURVEY_INFO_AFTER_LAST - 1
2677 };
2678 
2679 /**
2680  * enum nl80211_mntr_flags - monitor configuration flags
2681  *
2682  * Monitor configuration flags.
2683  *
2684  * @__NL80211_MNTR_FLAG_INVALID: reserved
2685  *
2686  * @NL80211_MNTR_FLAG_FCSFAIL: pass frames with bad FCS
2687  * @NL80211_MNTR_FLAG_PLCPFAIL: pass frames with bad PLCP
2688  * @NL80211_MNTR_FLAG_CONTROL: pass control frames
2689  * @NL80211_MNTR_FLAG_OTHER_BSS: disable BSSID filtering
2690  * @NL80211_MNTR_FLAG_COOK_FRAMES: report frames after processing.
2691  *	overrides all other flags.
2692  * @NL80211_MNTR_FLAG_ACTIVE: use the configured MAC address
2693  *	and ACK incoming unicast packets.
2694  *
2695  * @__NL80211_MNTR_FLAG_AFTER_LAST: internal use
2696  * @NL80211_MNTR_FLAG_MAX: highest possible monitor flag
2697  */
2698 enum nl80211_mntr_flags {
2699 	__NL80211_MNTR_FLAG_INVALID,
2700 	NL80211_MNTR_FLAG_FCSFAIL,
2701 	NL80211_MNTR_FLAG_PLCPFAIL,
2702 	NL80211_MNTR_FLAG_CONTROL,
2703 	NL80211_MNTR_FLAG_OTHER_BSS,
2704 	NL80211_MNTR_FLAG_COOK_FRAMES,
2705 	NL80211_MNTR_FLAG_ACTIVE,
2706 
2707 	/* keep last */
2708 	__NL80211_MNTR_FLAG_AFTER_LAST,
2709 	NL80211_MNTR_FLAG_MAX = __NL80211_MNTR_FLAG_AFTER_LAST - 1
2710 };
2711 
2712 /**
2713  * enum nl80211_mesh_power_mode - mesh power save modes
2714  *
2715  * @NL80211_MESH_POWER_UNKNOWN: The mesh power mode of the mesh STA is
2716  *	not known or has not been set yet.
2717  * @NL80211_MESH_POWER_ACTIVE: Active mesh power mode. The mesh STA is
2718  *	in Awake state all the time.
2719  * @NL80211_MESH_POWER_LIGHT_SLEEP: Light sleep mode. The mesh STA will
2720  *	alternate between Active and Doze states, but will wake up for
2721  *	neighbor's beacons.
2722  * @NL80211_MESH_POWER_DEEP_SLEEP: Deep sleep mode. The mesh STA will
2723  *	alternate between Active and Doze states, but may not wake up
2724  *	for neighbor's beacons.
2725  *
2726  * @__NL80211_MESH_POWER_AFTER_LAST - internal use
2727  * @NL80211_MESH_POWER_MAX - highest possible power save level
2728  */
2729 
2730 enum nl80211_mesh_power_mode {
2731 	NL80211_MESH_POWER_UNKNOWN,
2732 	NL80211_MESH_POWER_ACTIVE,
2733 	NL80211_MESH_POWER_LIGHT_SLEEP,
2734 	NL80211_MESH_POWER_DEEP_SLEEP,
2735 
2736 	__NL80211_MESH_POWER_AFTER_LAST,
2737 	NL80211_MESH_POWER_MAX = __NL80211_MESH_POWER_AFTER_LAST - 1
2738 };
2739 
2740 /**
2741  * enum nl80211_meshconf_params - mesh configuration parameters
2742  *
2743  * Mesh configuration parameters. These can be changed while the mesh is
2744  * active.
2745  *
2746  * @__NL80211_MESHCONF_INVALID: internal use
2747  *
2748  * @NL80211_MESHCONF_RETRY_TIMEOUT: specifies the initial retry timeout in
2749  *	millisecond units, used by the Peer Link Open message
2750  *
2751  * @NL80211_MESHCONF_CONFIRM_TIMEOUT: specifies the initial confirm timeout, in
2752  *	millisecond units, used by the peer link management to close a peer link
2753  *
2754  * @NL80211_MESHCONF_HOLDING_TIMEOUT: specifies the holding timeout, in
2755  *	millisecond units
2756  *
2757  * @NL80211_MESHCONF_MAX_PEER_LINKS: maximum number of peer links allowed
2758  *	on this mesh interface
2759  *
2760  * @NL80211_MESHCONF_MAX_RETRIES: specifies the maximum number of peer link
2761  *	open retries that can be sent to establish a new peer link instance in a
2762  *	mesh
2763  *
2764  * @NL80211_MESHCONF_TTL: specifies the value of TTL field set at a source mesh
2765  *	point.
2766  *
2767  * @NL80211_MESHCONF_AUTO_OPEN_PLINKS: whether we should automatically open
2768  *	peer links when we detect compatible mesh peers. Disabled if
2769  *	@NL80211_MESH_SETUP_USERSPACE_MPM or @NL80211_MESH_SETUP_USERSPACE_AMPE are
2770  *	set.
2771  *
2772  * @NL80211_MESHCONF_HWMP_MAX_PREQ_RETRIES: the number of action frames
2773  *	containing a PREQ that an MP can send to a particular destination (path
2774  *	target)
2775  *
2776  * @NL80211_MESHCONF_PATH_REFRESH_TIME: how frequently to refresh mesh paths
2777  *	(in milliseconds)
2778  *
2779  * @NL80211_MESHCONF_MIN_DISCOVERY_TIMEOUT: minimum length of time to wait
2780  *	until giving up on a path discovery (in milliseconds)
2781  *
2782  * @NL80211_MESHCONF_HWMP_ACTIVE_PATH_TIMEOUT: The time (in TUs) for which mesh
2783  *	points receiving a PREQ shall consider the forwarding information from
2784  *	the root to be valid. (TU = time unit)
2785  *
2786  * @NL80211_MESHCONF_HWMP_PREQ_MIN_INTERVAL: The minimum interval of time (in
2787  *	TUs) during which an MP can send only one action frame containing a PREQ
2788  *	reference element
2789  *
2790  * @NL80211_MESHCONF_HWMP_NET_DIAM_TRVS_TIME: The interval of time (in TUs)
2791  *	that it takes for an HWMP information element to propagate across the
2792  *	mesh
2793  *
2794  * @NL80211_MESHCONF_HWMP_ROOTMODE: whether root mode is enabled or not
2795  *
2796  * @NL80211_MESHCONF_ELEMENT_TTL: specifies the value of TTL field set at a
2797  *	source mesh point for path selection elements.
2798  *
2799  * @NL80211_MESHCONF_HWMP_RANN_INTERVAL:  The interval of time (in TUs) between
2800  *	root announcements are transmitted.
2801  *
2802  * @NL80211_MESHCONF_GATE_ANNOUNCEMENTS: Advertise that this mesh station has
2803  *	access to a broader network beyond the MBSS.  This is done via Root
2804  *	Announcement frames.
2805  *
2806  * @NL80211_MESHCONF_HWMP_PERR_MIN_INTERVAL: The minimum interval of time (in
2807  *	TUs) during which a mesh STA can send only one Action frame containing a
2808  *	PERR element.
2809  *
2810  * @NL80211_MESHCONF_FORWARDING: set Mesh STA as forwarding or non-forwarding
2811  *	or forwarding entity (default is TRUE - forwarding entity)
2812  *
2813  * @NL80211_MESHCONF_RSSI_THRESHOLD: RSSI threshold in dBm. This specifies the
2814  *	threshold for average signal strength of candidate station to establish
2815  *	a peer link.
2816  *
2817  * @NL80211_MESHCONF_SYNC_OFFSET_MAX_NEIGHBOR: maximum number of neighbors
2818  *	to synchronize to for 11s default synchronization method
2819  *	(see 11C.12.2.2)
2820  *
2821  * @NL80211_MESHCONF_HT_OPMODE: set mesh HT protection mode.
2822  *
2823  * @NL80211_MESHCONF_ATTR_MAX: highest possible mesh configuration attribute
2824  *
2825  * @NL80211_MESHCONF_HWMP_PATH_TO_ROOT_TIMEOUT: The time (in TUs) for
2826  *	which mesh STAs receiving a proactive PREQ shall consider the forwarding
2827  *	information to the root mesh STA to be valid.
2828  *
2829  * @NL80211_MESHCONF_HWMP_ROOT_INTERVAL: The interval of time (in TUs) between
2830  *	proactive PREQs are transmitted.
2831  *
2832  * @NL80211_MESHCONF_HWMP_CONFIRMATION_INTERVAL: The minimum interval of time
2833  *	(in TUs) during which a mesh STA can send only one Action frame
2834  *	containing a PREQ element for root path confirmation.
2835  *
2836  * @NL80211_MESHCONF_POWER_MODE: Default mesh power mode for new peer links.
2837  *	type &enum nl80211_mesh_power_mode (u32)
2838  *
2839  * @NL80211_MESHCONF_AWAKE_WINDOW: awake window duration (in TUs)
2840  *
2841  * @NL80211_MESHCONF_PLINK_TIMEOUT: If no tx activity is seen from a STA we've
2842  *	established peering with for longer than this time (in seconds), then
2843  *	remove it from the STA's list of peers.  Default is 30 minutes.
2844  *
2845  * @__NL80211_MESHCONF_ATTR_AFTER_LAST: internal use
2846  */
2847 enum nl80211_meshconf_params {
2848 	__NL80211_MESHCONF_INVALID,
2849 	NL80211_MESHCONF_RETRY_TIMEOUT,
2850 	NL80211_MESHCONF_CONFIRM_TIMEOUT,
2851 	NL80211_MESHCONF_HOLDING_TIMEOUT,
2852 	NL80211_MESHCONF_MAX_PEER_LINKS,
2853 	NL80211_MESHCONF_MAX_RETRIES,
2854 	NL80211_MESHCONF_TTL,
2855 	NL80211_MESHCONF_AUTO_OPEN_PLINKS,
2856 	NL80211_MESHCONF_HWMP_MAX_PREQ_RETRIES,
2857 	NL80211_MESHCONF_PATH_REFRESH_TIME,
2858 	NL80211_MESHCONF_MIN_DISCOVERY_TIMEOUT,
2859 	NL80211_MESHCONF_HWMP_ACTIVE_PATH_TIMEOUT,
2860 	NL80211_MESHCONF_HWMP_PREQ_MIN_INTERVAL,
2861 	NL80211_MESHCONF_HWMP_NET_DIAM_TRVS_TIME,
2862 	NL80211_MESHCONF_HWMP_ROOTMODE,
2863 	NL80211_MESHCONF_ELEMENT_TTL,
2864 	NL80211_MESHCONF_HWMP_RANN_INTERVAL,
2865 	NL80211_MESHCONF_GATE_ANNOUNCEMENTS,
2866 	NL80211_MESHCONF_HWMP_PERR_MIN_INTERVAL,
2867 	NL80211_MESHCONF_FORWARDING,
2868 	NL80211_MESHCONF_RSSI_THRESHOLD,
2869 	NL80211_MESHCONF_SYNC_OFFSET_MAX_NEIGHBOR,
2870 	NL80211_MESHCONF_HT_OPMODE,
2871 	NL80211_MESHCONF_HWMP_PATH_TO_ROOT_TIMEOUT,
2872 	NL80211_MESHCONF_HWMP_ROOT_INTERVAL,
2873 	NL80211_MESHCONF_HWMP_CONFIRMATION_INTERVAL,
2874 	NL80211_MESHCONF_POWER_MODE,
2875 	NL80211_MESHCONF_AWAKE_WINDOW,
2876 	NL80211_MESHCONF_PLINK_TIMEOUT,
2877 
2878 	/* keep last */
2879 	__NL80211_MESHCONF_ATTR_AFTER_LAST,
2880 	NL80211_MESHCONF_ATTR_MAX = __NL80211_MESHCONF_ATTR_AFTER_LAST - 1
2881 };
2882 
2883 /**
2884  * enum nl80211_mesh_setup_params - mesh setup parameters
2885  *
2886  * Mesh setup parameters.  These are used to start/join a mesh and cannot be
2887  * changed while the mesh is active.
2888  *
2889  * @__NL80211_MESH_SETUP_INVALID: Internal use
2890  *
2891  * @NL80211_MESH_SETUP_ENABLE_VENDOR_PATH_SEL: Enable this option to use a
2892  *	vendor specific path selection algorithm or disable it to use the
2893  *	default HWMP.
2894  *
2895  * @NL80211_MESH_SETUP_ENABLE_VENDOR_METRIC: Enable this option to use a
2896  *	vendor specific path metric or disable it to use the default Airtime
2897  *	metric.
2898  *
2899  * @NL80211_MESH_SETUP_IE: Information elements for this mesh, for instance, a
2900  *	robust security network ie, or a vendor specific information element
2901  *	that vendors will use to identify the path selection methods and
2902  *	metrics in use.
2903  *
2904  * @NL80211_MESH_SETUP_USERSPACE_AUTH: Enable this option if an authentication
2905  *	daemon will be authenticating mesh candidates.
2906  *
2907  * @NL80211_MESH_SETUP_USERSPACE_AMPE: Enable this option if an authentication
2908  *	daemon will be securing peer link frames.  AMPE is a secured version of
2909  *	Mesh Peering Management (MPM) and is implemented with the assistance of
2910  *	a userspace daemon.  When this flag is set, the kernel will send peer
2911  *	management frames to a userspace daemon that will implement AMPE
2912  *	functionality (security capabilities selection, key confirmation, and
2913  *	key management).  When the flag is unset (default), the kernel can
2914  *	autonomously complete (unsecured) mesh peering without the need of a
2915  *	userspace daemon.
2916  *
2917  * @NL80211_MESH_SETUP_ENABLE_VENDOR_SYNC: Enable this option to use a
2918  *	vendor specific synchronization method or disable it to use the default
2919  *	neighbor offset synchronization
2920  *
2921  * @NL80211_MESH_SETUP_USERSPACE_MPM: Enable this option if userspace will
2922  *	implement an MPM which handles peer allocation and state.
2923  *
2924  * @NL80211_MESH_SETUP_AUTH_PROTOCOL: Inform the kernel of the authentication
2925  *	method (u8, as defined in IEEE 8.4.2.100.6, e.g. 0x1 for SAE).
2926  *	Default is no authentication method required.
2927  *
2928  * @NL80211_MESH_SETUP_ATTR_MAX: highest possible mesh setup attribute number
2929  *
2930  * @__NL80211_MESH_SETUP_ATTR_AFTER_LAST: Internal use
2931  */
2932 enum nl80211_mesh_setup_params {
2933 	__NL80211_MESH_SETUP_INVALID,
2934 	NL80211_MESH_SETUP_ENABLE_VENDOR_PATH_SEL,
2935 	NL80211_MESH_SETUP_ENABLE_VENDOR_METRIC,
2936 	NL80211_MESH_SETUP_IE,
2937 	NL80211_MESH_SETUP_USERSPACE_AUTH,
2938 	NL80211_MESH_SETUP_USERSPACE_AMPE,
2939 	NL80211_MESH_SETUP_ENABLE_VENDOR_SYNC,
2940 	NL80211_MESH_SETUP_USERSPACE_MPM,
2941 	NL80211_MESH_SETUP_AUTH_PROTOCOL,
2942 
2943 	/* keep last */
2944 	__NL80211_MESH_SETUP_ATTR_AFTER_LAST,
2945 	NL80211_MESH_SETUP_ATTR_MAX = __NL80211_MESH_SETUP_ATTR_AFTER_LAST - 1
2946 };
2947 
2948 /**
2949  * enum nl80211_txq_attr - TX queue parameter attributes
2950  * @__NL80211_TXQ_ATTR_INVALID: Attribute number 0 is reserved
2951  * @NL80211_TXQ_ATTR_AC: AC identifier (NL80211_AC_*)
2952  * @NL80211_TXQ_ATTR_TXOP: Maximum burst time in units of 32 usecs, 0 meaning
2953  *	disabled
2954  * @NL80211_TXQ_ATTR_CWMIN: Minimum contention window [a value of the form
2955  *	2^n-1 in the range 1..32767]
2956  * @NL80211_TXQ_ATTR_CWMAX: Maximum contention window [a value of the form
2957  *	2^n-1 in the range 1..32767]
2958  * @NL80211_TXQ_ATTR_AIFS: Arbitration interframe space [0..255]
2959  * @__NL80211_TXQ_ATTR_AFTER_LAST: Internal
2960  * @NL80211_TXQ_ATTR_MAX: Maximum TXQ attribute number
2961  */
2962 enum nl80211_txq_attr {
2963 	__NL80211_TXQ_ATTR_INVALID,
2964 	NL80211_TXQ_ATTR_AC,
2965 	NL80211_TXQ_ATTR_TXOP,
2966 	NL80211_TXQ_ATTR_CWMIN,
2967 	NL80211_TXQ_ATTR_CWMAX,
2968 	NL80211_TXQ_ATTR_AIFS,
2969 
2970 	/* keep last */
2971 	__NL80211_TXQ_ATTR_AFTER_LAST,
2972 	NL80211_TXQ_ATTR_MAX = __NL80211_TXQ_ATTR_AFTER_LAST - 1
2973 };
2974 
2975 enum nl80211_ac {
2976 	NL80211_AC_VO,
2977 	NL80211_AC_VI,
2978 	NL80211_AC_BE,
2979 	NL80211_AC_BK,
2980 	NL80211_NUM_ACS
2981 };
2982 
2983 /* backward compat */
2984 #define NL80211_TXQ_ATTR_QUEUE	NL80211_TXQ_ATTR_AC
2985 #define NL80211_TXQ_Q_VO	NL80211_AC_VO
2986 #define NL80211_TXQ_Q_VI	NL80211_AC_VI
2987 #define NL80211_TXQ_Q_BE	NL80211_AC_BE
2988 #define NL80211_TXQ_Q_BK	NL80211_AC_BK
2989 
2990 /**
2991  * enum nl80211_channel_type - channel type
2992  * @NL80211_CHAN_NO_HT: 20 MHz, non-HT channel
2993  * @NL80211_CHAN_HT20: 20 MHz HT channel
2994  * @NL80211_CHAN_HT40MINUS: HT40 channel, secondary channel
2995  *	below the control channel
2996  * @NL80211_CHAN_HT40PLUS: HT40 channel, secondary channel
2997  *	above the control channel
2998  */
2999 enum nl80211_channel_type {
3000 	NL80211_CHAN_NO_HT,
3001 	NL80211_CHAN_HT20,
3002 	NL80211_CHAN_HT40MINUS,
3003 	NL80211_CHAN_HT40PLUS
3004 };
3005 
3006 /**
3007  * enum nl80211_chan_width - channel width definitions
3008  *
3009  * These values are used with the %NL80211_ATTR_CHANNEL_WIDTH
3010  * attribute.
3011  *
3012  * @NL80211_CHAN_WIDTH_20_NOHT: 20 MHz, non-HT channel
3013  * @NL80211_CHAN_WIDTH_20: 20 MHz HT channel
3014  * @NL80211_CHAN_WIDTH_40: 40 MHz channel, the %NL80211_ATTR_CENTER_FREQ1
3015  *	attribute must be provided as well
3016  * @NL80211_CHAN_WIDTH_80: 80 MHz channel, the %NL80211_ATTR_CENTER_FREQ1
3017  *	attribute must be provided as well
3018  * @NL80211_CHAN_WIDTH_80P80: 80+80 MHz channel, the %NL80211_ATTR_CENTER_FREQ1
3019  *	and %NL80211_ATTR_CENTER_FREQ2 attributes must be provided as well
3020  * @NL80211_CHAN_WIDTH_160: 160 MHz channel, the %NL80211_ATTR_CENTER_FREQ1
3021  *	attribute must be provided as well
3022  * @NL80211_CHAN_WIDTH_5: 5 MHz OFDM channel
3023  * @NL80211_CHAN_WIDTH_10: 10 MHz OFDM channel
3024  */
3025 enum nl80211_chan_width {
3026 	NL80211_CHAN_WIDTH_20_NOHT,
3027 	NL80211_CHAN_WIDTH_20,
3028 	NL80211_CHAN_WIDTH_40,
3029 	NL80211_CHAN_WIDTH_80,
3030 	NL80211_CHAN_WIDTH_80P80,
3031 	NL80211_CHAN_WIDTH_160,
3032 	NL80211_CHAN_WIDTH_5,
3033 	NL80211_CHAN_WIDTH_10,
3034 };
3035 
3036 /**
3037  * enum nl80211_bss_scan_width - control channel width for a BSS
3038  *
3039  * These values are used with the %NL80211_BSS_CHAN_WIDTH attribute.
3040  *
3041  * @NL80211_BSS_CHAN_WIDTH_20: control channel is 20 MHz wide or compatible
3042  * @NL80211_BSS_CHAN_WIDTH_10: control channel is 10 MHz wide
3043  * @NL80211_BSS_CHAN_WIDTH_5: control channel is 5 MHz wide
3044  */
3045 enum nl80211_bss_scan_width {
3046 	NL80211_BSS_CHAN_WIDTH_20,
3047 	NL80211_BSS_CHAN_WIDTH_10,
3048 	NL80211_BSS_CHAN_WIDTH_5,
3049 };
3050 
3051 /**
3052  * enum nl80211_bss - netlink attributes for a BSS
3053  *
3054  * @__NL80211_BSS_INVALID: invalid
3055  * @NL80211_BSS_BSSID: BSSID of the BSS (6 octets)
3056  * @NL80211_BSS_FREQUENCY: frequency in MHz (u32)
3057  * @NL80211_BSS_TSF: TSF of the received probe response/beacon (u64)
3058  * @NL80211_BSS_BEACON_INTERVAL: beacon interval of the (I)BSS (u16)
3059  * @NL80211_BSS_CAPABILITY: capability field (CPU order, u16)
3060  * @NL80211_BSS_INFORMATION_ELEMENTS: binary attribute containing the
3061  *	raw information elements from the probe response/beacon (bin);
3062  *	if the %NL80211_BSS_BEACON_IES attribute is present, the IEs here are
3063  *	from a Probe Response frame; otherwise they are from a Beacon frame.
3064  *	However, if the driver does not indicate the source of the IEs, these
3065  *	IEs may be from either frame subtype.
3066  * @NL80211_BSS_SIGNAL_MBM: signal strength of probe response/beacon
3067  *	in mBm (100 * dBm) (s32)
3068  * @NL80211_BSS_SIGNAL_UNSPEC: signal strength of the probe response/beacon
3069  *	in unspecified units, scaled to 0..100 (u8)
3070  * @NL80211_BSS_STATUS: status, if this BSS is "used"
3071  * @NL80211_BSS_SEEN_MS_AGO: age of this BSS entry in ms
3072  * @NL80211_BSS_BEACON_IES: binary attribute containing the raw information
3073  *	elements from a Beacon frame (bin); not present if no Beacon frame has
3074  *	yet been received
3075  * @NL80211_BSS_CHAN_WIDTH: channel width of the control channel
3076  *	(u32, enum nl80211_bss_scan_width)
3077  * @__NL80211_BSS_AFTER_LAST: internal
3078  * @NL80211_BSS_MAX: highest BSS attribute
3079  */
3080 enum nl80211_bss {
3081 	__NL80211_BSS_INVALID,
3082 	NL80211_BSS_BSSID,
3083 	NL80211_BSS_FREQUENCY,
3084 	NL80211_BSS_TSF,
3085 	NL80211_BSS_BEACON_INTERVAL,
3086 	NL80211_BSS_CAPABILITY,
3087 	NL80211_BSS_INFORMATION_ELEMENTS,
3088 	NL80211_BSS_SIGNAL_MBM,
3089 	NL80211_BSS_SIGNAL_UNSPEC,
3090 	NL80211_BSS_STATUS,
3091 	NL80211_BSS_SEEN_MS_AGO,
3092 	NL80211_BSS_BEACON_IES,
3093 	NL80211_BSS_CHAN_WIDTH,
3094 
3095 	/* keep last */
3096 	__NL80211_BSS_AFTER_LAST,
3097 	NL80211_BSS_MAX = __NL80211_BSS_AFTER_LAST - 1
3098 };
3099 
3100 /**
3101  * enum nl80211_bss_status - BSS "status"
3102  * @NL80211_BSS_STATUS_AUTHENTICATED: Authenticated with this BSS.
3103  * @NL80211_BSS_STATUS_ASSOCIATED: Associated with this BSS.
3104  * @NL80211_BSS_STATUS_IBSS_JOINED: Joined to this IBSS.
3105  *
3106  * The BSS status is a BSS attribute in scan dumps, which
3107  * indicates the status the interface has wrt. this BSS.
3108  */
3109 enum nl80211_bss_status {
3110 	NL80211_BSS_STATUS_AUTHENTICATED,
3111 	NL80211_BSS_STATUS_ASSOCIATED,
3112 	NL80211_BSS_STATUS_IBSS_JOINED,
3113 };
3114 
3115 /**
3116  * enum nl80211_auth_type - AuthenticationType
3117  *
3118  * @NL80211_AUTHTYPE_OPEN_SYSTEM: Open System authentication
3119  * @NL80211_AUTHTYPE_SHARED_KEY: Shared Key authentication (WEP only)
3120  * @NL80211_AUTHTYPE_FT: Fast BSS Transition (IEEE 802.11r)
3121  * @NL80211_AUTHTYPE_NETWORK_EAP: Network EAP (some Cisco APs and mainly LEAP)
3122  * @NL80211_AUTHTYPE_SAE: Simultaneous authentication of equals
3123  * @__NL80211_AUTHTYPE_NUM: internal
3124  * @NL80211_AUTHTYPE_MAX: maximum valid auth algorithm
3125  * @NL80211_AUTHTYPE_AUTOMATIC: determine automatically (if necessary by
3126  *	trying multiple times); this is invalid in netlink -- leave out
3127  *	the attribute for this on CONNECT commands.
3128  */
3129 enum nl80211_auth_type {
3130 	NL80211_AUTHTYPE_OPEN_SYSTEM,
3131 	NL80211_AUTHTYPE_SHARED_KEY,
3132 	NL80211_AUTHTYPE_FT,
3133 	NL80211_AUTHTYPE_NETWORK_EAP,
3134 	NL80211_AUTHTYPE_SAE,
3135 
3136 	/* keep last */
3137 	__NL80211_AUTHTYPE_NUM,
3138 	NL80211_AUTHTYPE_MAX = __NL80211_AUTHTYPE_NUM - 1,
3139 	NL80211_AUTHTYPE_AUTOMATIC
3140 };
3141 
3142 /**
3143  * enum nl80211_key_type - Key Type
3144  * @NL80211_KEYTYPE_GROUP: Group (broadcast/multicast) key
3145  * @NL80211_KEYTYPE_PAIRWISE: Pairwise (unicast/individual) key
3146  * @NL80211_KEYTYPE_PEERKEY: PeerKey (DLS)
3147  * @NUM_NL80211_KEYTYPES: number of defined key types
3148  */
3149 enum nl80211_key_type {
3150 	NL80211_KEYTYPE_GROUP,
3151 	NL80211_KEYTYPE_PAIRWISE,
3152 	NL80211_KEYTYPE_PEERKEY,
3153 
3154 	NUM_NL80211_KEYTYPES
3155 };
3156 
3157 /**
3158  * enum nl80211_mfp - Management frame protection state
3159  * @NL80211_MFP_NO: Management frame protection not used
3160  * @NL80211_MFP_REQUIRED: Management frame protection required
3161  */
3162 enum nl80211_mfp {
3163 	NL80211_MFP_NO,
3164 	NL80211_MFP_REQUIRED,
3165 };
3166 
3167 enum nl80211_wpa_versions {
3168 	NL80211_WPA_VERSION_1 = 1 << 0,
3169 	NL80211_WPA_VERSION_2 = 1 << 1,
3170 };
3171 
3172 /**
3173  * enum nl80211_key_default_types - key default types
3174  * @__NL80211_KEY_DEFAULT_TYPE_INVALID: invalid
3175  * @NL80211_KEY_DEFAULT_TYPE_UNICAST: key should be used as default
3176  *	unicast key
3177  * @NL80211_KEY_DEFAULT_TYPE_MULTICAST: key should be used as default
3178  *	multicast key
3179  * @NUM_NL80211_KEY_DEFAULT_TYPES: number of default types
3180  */
3181 enum nl80211_key_default_types {
3182 	__NL80211_KEY_DEFAULT_TYPE_INVALID,
3183 	NL80211_KEY_DEFAULT_TYPE_UNICAST,
3184 	NL80211_KEY_DEFAULT_TYPE_MULTICAST,
3185 
3186 	NUM_NL80211_KEY_DEFAULT_TYPES
3187 };
3188 
3189 /**
3190  * enum nl80211_key_attributes - key attributes
3191  * @__NL80211_KEY_INVALID: invalid
3192  * @NL80211_KEY_DATA: (temporal) key data; for TKIP this consists of
3193  *	16 bytes encryption key followed by 8 bytes each for TX and RX MIC
3194  *	keys
3195  * @NL80211_KEY_IDX: key ID (u8, 0-3)
3196  * @NL80211_KEY_CIPHER: key cipher suite (u32, as defined by IEEE 802.11
3197  *	section 7.3.2.25.1, e.g. 0x000FAC04)
3198  * @NL80211_KEY_SEQ: transmit key sequence number (IV/PN) for TKIP and
3199  *	CCMP keys, each six bytes in little endian
3200  * @NL80211_KEY_DEFAULT: flag indicating default key
3201  * @NL80211_KEY_DEFAULT_MGMT: flag indicating default management key
3202  * @NL80211_KEY_TYPE: the key type from enum nl80211_key_type, if not
3203  *	specified the default depends on whether a MAC address was
3204  *	given with the command using the key or not (u32)
3205  * @NL80211_KEY_DEFAULT_TYPES: A nested attribute containing flags
3206  *	attributes, specifying what a key should be set as default as.
3207  *	See &enum nl80211_key_default_types.
3208  * @__NL80211_KEY_AFTER_LAST: internal
3209  * @NL80211_KEY_MAX: highest key attribute
3210  */
3211 enum nl80211_key_attributes {
3212 	__NL80211_KEY_INVALID,
3213 	NL80211_KEY_DATA,
3214 	NL80211_KEY_IDX,
3215 	NL80211_KEY_CIPHER,
3216 	NL80211_KEY_SEQ,
3217 	NL80211_KEY_DEFAULT,
3218 	NL80211_KEY_DEFAULT_MGMT,
3219 	NL80211_KEY_TYPE,
3220 	NL80211_KEY_DEFAULT_TYPES,
3221 
3222 	/* keep last */
3223 	__NL80211_KEY_AFTER_LAST,
3224 	NL80211_KEY_MAX = __NL80211_KEY_AFTER_LAST - 1
3225 };
3226 
3227 /**
3228  * enum nl80211_tx_rate_attributes - TX rate set attributes
3229  * @__NL80211_TXRATE_INVALID: invalid
3230  * @NL80211_TXRATE_LEGACY: Legacy (non-MCS) rates allowed for TX rate selection
3231  *	in an array of rates as defined in IEEE 802.11 7.3.2.2 (u8 values with
3232  *	1 = 500 kbps) but without the IE length restriction (at most
3233  *	%NL80211_MAX_SUPP_RATES in a single array).
3234  * @NL80211_TXRATE_HT: HT (MCS) rates allowed for TX rate selection
3235  *	in an array of MCS numbers.
3236  * @NL80211_TXRATE_VHT: VHT rates allowed for TX rate selection,
3237  *	see &struct nl80211_txrate_vht
3238  * @NL80211_TXRATE_GI: configure GI, see &enum nl80211_txrate_gi
3239  * @__NL80211_TXRATE_AFTER_LAST: internal
3240  * @NL80211_TXRATE_MAX: highest TX rate attribute
3241  */
3242 enum nl80211_tx_rate_attributes {
3243 	__NL80211_TXRATE_INVALID,
3244 	NL80211_TXRATE_LEGACY,
3245 	NL80211_TXRATE_HT,
3246 	NL80211_TXRATE_VHT,
3247 	NL80211_TXRATE_GI,
3248 
3249 	/* keep last */
3250 	__NL80211_TXRATE_AFTER_LAST,
3251 	NL80211_TXRATE_MAX = __NL80211_TXRATE_AFTER_LAST - 1
3252 };
3253 
3254 #define NL80211_TXRATE_MCS NL80211_TXRATE_HT
3255 #define NL80211_VHT_NSS_MAX		8
3256 
3257 /**
3258  * struct nl80211_txrate_vht - VHT MCS/NSS txrate bitmap
3259  * @mcs: MCS bitmap table for each NSS (array index 0 for 1 stream, etc.)
3260  */
3261 struct nl80211_txrate_vht {
3262 	__u16 mcs[NL80211_VHT_NSS_MAX];
3263 };
3264 
3265 enum nl80211_txrate_gi {
3266 	NL80211_TXRATE_DEFAULT_GI,
3267 	NL80211_TXRATE_FORCE_SGI,
3268 	NL80211_TXRATE_FORCE_LGI,
3269 };
3270 
3271 /**
3272  * enum nl80211_band - Frequency band
3273  * @NL80211_BAND_2GHZ: 2.4 GHz ISM band
3274  * @NL80211_BAND_5GHZ: around 5 GHz band (4.9 - 5.7 GHz)
3275  * @NL80211_BAND_60GHZ: around 60 GHz band (58.32 - 64.80 GHz)
3276  */
3277 enum nl80211_band {
3278 	NL80211_BAND_2GHZ,
3279 	NL80211_BAND_5GHZ,
3280 	NL80211_BAND_60GHZ,
3281 };
3282 
3283 /**
3284  * enum nl80211_ps_state - powersave state
3285  * @NL80211_PS_DISABLED: powersave is disabled
3286  * @NL80211_PS_ENABLED: powersave is enabled
3287  */
3288 enum nl80211_ps_state {
3289 	NL80211_PS_DISABLED,
3290 	NL80211_PS_ENABLED,
3291 };
3292 
3293 /**
3294  * enum nl80211_attr_cqm - connection quality monitor attributes
3295  * @__NL80211_ATTR_CQM_INVALID: invalid
3296  * @NL80211_ATTR_CQM_RSSI_THOLD: RSSI threshold in dBm. This value specifies
3297  *	the threshold for the RSSI level at which an event will be sent. Zero
3298  *	to disable.
3299  * @NL80211_ATTR_CQM_RSSI_HYST: RSSI hysteresis in dBm. This value specifies
3300  *	the minimum amount the RSSI level must change after an event before a
3301  *	new event may be issued (to reduce effects of RSSI oscillation).
3302  * @NL80211_ATTR_CQM_RSSI_THRESHOLD_EVENT: RSSI threshold event
3303  * @NL80211_ATTR_CQM_PKT_LOSS_EVENT: a u32 value indicating that this many
3304  *	consecutive packets were not acknowledged by the peer
3305  * @NL80211_ATTR_CQM_TXE_RATE: TX error rate in %. Minimum % of TX failures
3306  *	during the given %NL80211_ATTR_CQM_TXE_INTVL before an
3307  *	%NL80211_CMD_NOTIFY_CQM with reported %NL80211_ATTR_CQM_TXE_RATE and
3308  *	%NL80211_ATTR_CQM_TXE_PKTS is generated.
3309  * @NL80211_ATTR_CQM_TXE_PKTS: number of attempted packets in a given
3310  *	%NL80211_ATTR_CQM_TXE_INTVL before %NL80211_ATTR_CQM_TXE_RATE is
3311  *	checked.
3312  * @NL80211_ATTR_CQM_TXE_INTVL: interval in seconds. Specifies the periodic
3313  *	interval in which %NL80211_ATTR_CQM_TXE_PKTS and
3314  *	%NL80211_ATTR_CQM_TXE_RATE must be satisfied before generating an
3315  *	%NL80211_CMD_NOTIFY_CQM. Set to 0 to turn off TX error reporting.
3316  * @__NL80211_ATTR_CQM_AFTER_LAST: internal
3317  * @NL80211_ATTR_CQM_MAX: highest key attribute
3318  */
3319 enum nl80211_attr_cqm {
3320 	__NL80211_ATTR_CQM_INVALID,
3321 	NL80211_ATTR_CQM_RSSI_THOLD,
3322 	NL80211_ATTR_CQM_RSSI_HYST,
3323 	NL80211_ATTR_CQM_RSSI_THRESHOLD_EVENT,
3324 	NL80211_ATTR_CQM_PKT_LOSS_EVENT,
3325 	NL80211_ATTR_CQM_TXE_RATE,
3326 	NL80211_ATTR_CQM_TXE_PKTS,
3327 	NL80211_ATTR_CQM_TXE_INTVL,
3328 
3329 	/* keep last */
3330 	__NL80211_ATTR_CQM_AFTER_LAST,
3331 	NL80211_ATTR_CQM_MAX = __NL80211_ATTR_CQM_AFTER_LAST - 1
3332 };
3333 
3334 /**
3335  * enum nl80211_cqm_rssi_threshold_event - RSSI threshold event
3336  * @NL80211_CQM_RSSI_THRESHOLD_EVENT_LOW: The RSSI level is lower than the
3337  *      configured threshold
3338  * @NL80211_CQM_RSSI_THRESHOLD_EVENT_HIGH: The RSSI is higher than the
3339  *      configured threshold
3340  * @NL80211_CQM_RSSI_BEACON_LOSS_EVENT: The device experienced beacon loss.
3341  *	(Note that deauth/disassoc will still follow if the AP is not
3342  *	available. This event might get used as roaming event, etc.)
3343  */
3344 enum nl80211_cqm_rssi_threshold_event {
3345 	NL80211_CQM_RSSI_THRESHOLD_EVENT_LOW,
3346 	NL80211_CQM_RSSI_THRESHOLD_EVENT_HIGH,
3347 	NL80211_CQM_RSSI_BEACON_LOSS_EVENT,
3348 };
3349 
3350 
3351 /**
3352  * enum nl80211_tx_power_setting - TX power adjustment
3353  * @NL80211_TX_POWER_AUTOMATIC: automatically determine transmit power
3354  * @NL80211_TX_POWER_LIMITED: limit TX power by the mBm parameter
3355  * @NL80211_TX_POWER_FIXED: fix TX power to the mBm parameter
3356  */
3357 enum nl80211_tx_power_setting {
3358 	NL80211_TX_POWER_AUTOMATIC,
3359 	NL80211_TX_POWER_LIMITED,
3360 	NL80211_TX_POWER_FIXED,
3361 };
3362 
3363 /**
3364  * enum nl80211_packet_pattern_attr - packet pattern attribute
3365  * @__NL80211_PKTPAT_INVALID: invalid number for nested attribute
3366  * @NL80211_PKTPAT_PATTERN: the pattern, values where the mask has
3367  *	a zero bit are ignored
3368  * @NL80211_PKTPAT_MASK: pattern mask, must be long enough to have
3369  *	a bit for each byte in the pattern. The lowest-order bit corresponds
3370  *	to the first byte of the pattern, but the bytes of the pattern are
3371  *	in a little-endian-like format, i.e. the 9th byte of the pattern
3372  *	corresponds to the lowest-order bit in the second byte of the mask.
3373  *	For example: The match 00:xx:00:00:xx:00:00:00:00:xx:xx:xx (where
3374  *	xx indicates "don't care") would be represented by a pattern of
3375  *	twelve zero bytes, and a mask of "0xed,0x01".
3376  *	Note that the pattern matching is done as though frames were not
3377  *	802.11 frames but 802.3 frames, i.e. the frame is fully unpacked
3378  *	first (including SNAP header unpacking) and then matched.
3379  * @NL80211_PKTPAT_OFFSET: packet offset, pattern is matched after
3380  *	these fixed number of bytes of received packet
3381  * @NUM_NL80211_PKTPAT: number of attributes
3382  * @MAX_NL80211_PKTPAT: max attribute number
3383  */
3384 enum nl80211_packet_pattern_attr {
3385 	__NL80211_PKTPAT_INVALID,
3386 	NL80211_PKTPAT_MASK,
3387 	NL80211_PKTPAT_PATTERN,
3388 	NL80211_PKTPAT_OFFSET,
3389 
3390 	NUM_NL80211_PKTPAT,
3391 	MAX_NL80211_PKTPAT = NUM_NL80211_PKTPAT - 1,
3392 };
3393 
3394 /**
3395  * struct nl80211_pattern_support - packet pattern support information
3396  * @max_patterns: maximum number of patterns supported
3397  * @min_pattern_len: minimum length of each pattern
3398  * @max_pattern_len: maximum length of each pattern
3399  * @max_pkt_offset: maximum Rx packet offset
3400  *
3401  * This struct is carried in %NL80211_WOWLAN_TRIG_PKT_PATTERN when
3402  * that is part of %NL80211_ATTR_WOWLAN_TRIGGERS_SUPPORTED or in
3403  * %NL80211_ATTR_COALESCE_RULE_PKT_PATTERN when that is part of
3404  * %NL80211_ATTR_COALESCE_RULE in the capability information given
3405  * by the kernel to userspace.
3406  */
3407 struct nl80211_pattern_support {
3408 	__u32 max_patterns;
3409 	__u32 min_pattern_len;
3410 	__u32 max_pattern_len;
3411 	__u32 max_pkt_offset;
3412 } __attribute__((packed));
3413 
3414 /* only for backward compatibility */
3415 #define __NL80211_WOWLAN_PKTPAT_INVALID __NL80211_PKTPAT_INVALID
3416 #define NL80211_WOWLAN_PKTPAT_MASK NL80211_PKTPAT_MASK
3417 #define NL80211_WOWLAN_PKTPAT_PATTERN NL80211_PKTPAT_PATTERN
3418 #define NL80211_WOWLAN_PKTPAT_OFFSET NL80211_PKTPAT_OFFSET
3419 #define NUM_NL80211_WOWLAN_PKTPAT NUM_NL80211_PKTPAT
3420 #define MAX_NL80211_WOWLAN_PKTPAT MAX_NL80211_PKTPAT
3421 #define nl80211_wowlan_pattern_support nl80211_pattern_support
3422 
3423 /**
3424  * enum nl80211_wowlan_triggers - WoWLAN trigger definitions
3425  * @__NL80211_WOWLAN_TRIG_INVALID: invalid number for nested attributes
3426  * @NL80211_WOWLAN_TRIG_ANY: wake up on any activity, do not really put
3427  *	the chip into a special state -- works best with chips that have
3428  *	support for low-power operation already (flag)
3429  * @NL80211_WOWLAN_TRIG_DISCONNECT: wake up on disconnect, the way disconnect
3430  *	is detected is implementation-specific (flag)
3431  * @NL80211_WOWLAN_TRIG_MAGIC_PKT: wake up on magic packet (6x 0xff, followed
3432  *	by 16 repetitions of MAC addr, anywhere in payload) (flag)
3433  * @NL80211_WOWLAN_TRIG_PKT_PATTERN: wake up on the specified packet patterns
3434  *	which are passed in an array of nested attributes, each nested attribute
3435  *	defining a with attributes from &struct nl80211_wowlan_trig_pkt_pattern.
3436  *	Each pattern defines a wakeup packet. Packet offset is associated with
3437  *	each pattern which is used while matching the pattern. The matching is
3438  *	done on the MSDU, i.e. as though the packet was an 802.3 packet, so the
3439  *	pattern matching is done after the packet is converted to the MSDU.
3440  *
3441  *	In %NL80211_ATTR_WOWLAN_TRIGGERS_SUPPORTED, it is a binary attribute
3442  *	carrying a &struct nl80211_pattern_support.
3443  *
3444  *	When reporting wakeup. it is a u32 attribute containing the 0-based
3445  *	index of the pattern that caused the wakeup, in the patterns passed
3446  *	to the kernel when configuring.
3447  * @NL80211_WOWLAN_TRIG_GTK_REKEY_SUPPORTED: Not a real trigger, and cannot be
3448  *	used when setting, used only to indicate that GTK rekeying is supported
3449  *	by the device (flag)
3450  * @NL80211_WOWLAN_TRIG_GTK_REKEY_FAILURE: wake up on GTK rekey failure (if
3451  *	done by the device) (flag)
3452  * @NL80211_WOWLAN_TRIG_EAP_IDENT_REQUEST: wake up on EAP Identity Request
3453  *	packet (flag)
3454  * @NL80211_WOWLAN_TRIG_4WAY_HANDSHAKE: wake up on 4-way handshake (flag)
3455  * @NL80211_WOWLAN_TRIG_RFKILL_RELEASE: wake up when rfkill is released
3456  *	(on devices that have rfkill in the device) (flag)
3457  * @NL80211_WOWLAN_TRIG_WAKEUP_PKT_80211: For wakeup reporting only, contains
3458  *	the 802.11 packet that caused the wakeup, e.g. a deauth frame. The frame
3459  *	may be truncated, the @NL80211_WOWLAN_TRIG_WAKEUP_PKT_80211_LEN
3460  *	attribute contains the original length.
3461  * @NL80211_WOWLAN_TRIG_WAKEUP_PKT_80211_LEN: Original length of the 802.11
3462  *	packet, may be bigger than the @NL80211_WOWLAN_TRIG_WAKEUP_PKT_80211
3463  *	attribute if the packet was truncated somewhere.
3464  * @NL80211_WOWLAN_TRIG_WAKEUP_PKT_8023: For wakeup reporting only, contains the
3465  *	802.11 packet that caused the wakeup, e.g. a magic packet. The frame may
3466  *	be truncated, the @NL80211_WOWLAN_TRIG_WAKEUP_PKT_8023_LEN attribute
3467  *	contains the original length.
3468  * @NL80211_WOWLAN_TRIG_WAKEUP_PKT_8023_LEN: Original length of the 802.3
3469  *	packet, may be bigger than the @NL80211_WOWLAN_TRIG_WAKEUP_PKT_8023
3470  *	attribute if the packet was truncated somewhere.
3471  * @NL80211_WOWLAN_TRIG_TCP_CONNECTION: TCP connection wake, see DOC section
3472  *	"TCP connection wakeup" for more details. This is a nested attribute
3473  *	containing the exact information for establishing and keeping alive
3474  *	the TCP connection.
3475  * @NL80211_WOWLAN_TRIG_TCP_WAKEUP_MATCH: For wakeup reporting only, the
3476  *	wakeup packet was received on the TCP connection
3477  * @NL80211_WOWLAN_TRIG_WAKEUP_TCP_CONNLOST: For wakeup reporting only, the
3478  *	TCP connection was lost or failed to be established
3479  * @NL80211_WOWLAN_TRIG_WAKEUP_TCP_NOMORETOKENS: For wakeup reporting only,
3480  *	the TCP connection ran out of tokens to use for data to send to the
3481  *	service
3482  * @NUM_NL80211_WOWLAN_TRIG: number of wake on wireless triggers
3483  * @MAX_NL80211_WOWLAN_TRIG: highest wowlan trigger attribute number
3484  *
3485  * These nested attributes are used to configure the wakeup triggers and
3486  * to report the wakeup reason(s).
3487  */
3488 enum nl80211_wowlan_triggers {
3489 	__NL80211_WOWLAN_TRIG_INVALID,
3490 	NL80211_WOWLAN_TRIG_ANY,
3491 	NL80211_WOWLAN_TRIG_DISCONNECT,
3492 	NL80211_WOWLAN_TRIG_MAGIC_PKT,
3493 	NL80211_WOWLAN_TRIG_PKT_PATTERN,
3494 	NL80211_WOWLAN_TRIG_GTK_REKEY_SUPPORTED,
3495 	NL80211_WOWLAN_TRIG_GTK_REKEY_FAILURE,
3496 	NL80211_WOWLAN_TRIG_EAP_IDENT_REQUEST,
3497 	NL80211_WOWLAN_TRIG_4WAY_HANDSHAKE,
3498 	NL80211_WOWLAN_TRIG_RFKILL_RELEASE,
3499 	NL80211_WOWLAN_TRIG_WAKEUP_PKT_80211,
3500 	NL80211_WOWLAN_TRIG_WAKEUP_PKT_80211_LEN,
3501 	NL80211_WOWLAN_TRIG_WAKEUP_PKT_8023,
3502 	NL80211_WOWLAN_TRIG_WAKEUP_PKT_8023_LEN,
3503 	NL80211_WOWLAN_TRIG_TCP_CONNECTION,
3504 	NL80211_WOWLAN_TRIG_WAKEUP_TCP_MATCH,
3505 	NL80211_WOWLAN_TRIG_WAKEUP_TCP_CONNLOST,
3506 	NL80211_WOWLAN_TRIG_WAKEUP_TCP_NOMORETOKENS,
3507 
3508 	/* keep last */
3509 	NUM_NL80211_WOWLAN_TRIG,
3510 	MAX_NL80211_WOWLAN_TRIG = NUM_NL80211_WOWLAN_TRIG - 1
3511 };
3512 
3513 /**
3514  * DOC: TCP connection wakeup
3515  *
3516  * Some devices can establish a TCP connection in order to be woken up by a
3517  * packet coming in from outside their network segment, or behind NAT. If
3518  * configured, the device will establish a TCP connection to the given
3519  * service, and periodically send data to that service. The first data
3520  * packet is usually transmitted after SYN/ACK, also ACKing the SYN/ACK.
3521  * The data packets can optionally include a (little endian) sequence
3522  * number (in the TCP payload!) that is generated by the device, and, also
3523  * optionally, a token from a list of tokens. This serves as a keep-alive
3524  * with the service, and for NATed connections, etc.
3525  *
3526  * During this keep-alive period, the server doesn't send any data to the
3527  * client. When receiving data, it is compared against the wakeup pattern
3528  * (and mask) and if it matches, the host is woken up. Similarly, if the
3529  * connection breaks or cannot be established to start with, the host is
3530  * also woken up.
3531  *
3532  * Developer's note: ARP offload is required for this, otherwise TCP
3533  * response packets might not go through correctly.
3534  */
3535 
3536 /**
3537  * struct nl80211_wowlan_tcp_data_seq - WoWLAN TCP data sequence
3538  * @start: starting value
3539  * @offset: offset of sequence number in packet
3540  * @len: length of the sequence value to write, 1 through 4
3541  *
3542  * Note: don't confuse with the TCP sequence number(s), this is for the
3543  * keepalive packet payload. The actual value is written into the packet
3544  * in little endian.
3545  */
3546 struct nl80211_wowlan_tcp_data_seq {
3547 	__u32 start, offset, len;
3548 };
3549 
3550 /**
3551  * struct nl80211_wowlan_tcp_data_token - WoWLAN TCP data token config
3552  * @offset: offset of token in packet
3553  * @len: length of each token
3554  * @token_stream: stream of data to be used for the tokens, the length must
3555  *	be a multiple of @len for this to make sense
3556  */
3557 struct nl80211_wowlan_tcp_data_token {
3558 	__u32 offset, len;
3559 	__u8 token_stream[];
3560 };
3561 
3562 /**
3563  * struct nl80211_wowlan_tcp_data_token_feature - data token features
3564  * @min_len: minimum token length
3565  * @max_len: maximum token length
3566  * @bufsize: total available token buffer size (max size of @token_stream)
3567  */
3568 struct nl80211_wowlan_tcp_data_token_feature {
3569 	__u32 min_len, max_len, bufsize;
3570 };
3571 
3572 /**
3573  * enum nl80211_wowlan_tcp_attrs - WoWLAN TCP connection parameters
3574  * @__NL80211_WOWLAN_TCP_INVALID: invalid number for nested attributes
3575  * @NL80211_WOWLAN_TCP_SRC_IPV4: source IPv4 address (in network byte order)
3576  * @NL80211_WOWLAN_TCP_DST_IPV4: destination IPv4 address
3577  *	(in network byte order)
3578  * @NL80211_WOWLAN_TCP_DST_MAC: destination MAC address, this is given because
3579  *	route lookup when configured might be invalid by the time we suspend,
3580  *	and doing a route lookup when suspending is no longer possible as it
3581  *	might require ARP querying.
3582  * @NL80211_WOWLAN_TCP_SRC_PORT: source port (u16); optional, if not given a
3583  *	socket and port will be allocated
3584  * @NL80211_WOWLAN_TCP_DST_PORT: destination port (u16)
3585  * @NL80211_WOWLAN_TCP_DATA_PAYLOAD: data packet payload, at least one byte.
3586  *	For feature advertising, a u32 attribute holding the maximum length
3587  *	of the data payload.
3588  * @NL80211_WOWLAN_TCP_DATA_PAYLOAD_SEQ: data packet sequence configuration
3589  *	(if desired), a &struct nl80211_wowlan_tcp_data_seq. For feature
3590  *	advertising it is just a flag
3591  * @NL80211_WOWLAN_TCP_DATA_PAYLOAD_TOKEN: data packet token configuration,
3592  *	see &struct nl80211_wowlan_tcp_data_token and for advertising see
3593  *	&struct nl80211_wowlan_tcp_data_token_feature.
3594  * @NL80211_WOWLAN_TCP_DATA_INTERVAL: data interval in seconds, maximum
3595  *	interval in feature advertising (u32)
3596  * @NL80211_WOWLAN_TCP_WAKE_PAYLOAD: wake packet payload, for advertising a
3597  *	u32 attribute holding the maximum length
3598  * @NL80211_WOWLAN_TCP_WAKE_MASK: Wake packet payload mask, not used for
3599  *	feature advertising. The mask works like @NL80211_PKTPAT_MASK
3600  *	but on the TCP payload only.
3601  * @NUM_NL80211_WOWLAN_TCP: number of TCP attributes
3602  * @MAX_NL80211_WOWLAN_TCP: highest attribute number
3603  */
3604 enum nl80211_wowlan_tcp_attrs {
3605 	__NL80211_WOWLAN_TCP_INVALID,
3606 	NL80211_WOWLAN_TCP_SRC_IPV4,
3607 	NL80211_WOWLAN_TCP_DST_IPV4,
3608 	NL80211_WOWLAN_TCP_DST_MAC,
3609 	NL80211_WOWLAN_TCP_SRC_PORT,
3610 	NL80211_WOWLAN_TCP_DST_PORT,
3611 	NL80211_WOWLAN_TCP_DATA_PAYLOAD,
3612 	NL80211_WOWLAN_TCP_DATA_PAYLOAD_SEQ,
3613 	NL80211_WOWLAN_TCP_DATA_PAYLOAD_TOKEN,
3614 	NL80211_WOWLAN_TCP_DATA_INTERVAL,
3615 	NL80211_WOWLAN_TCP_WAKE_PAYLOAD,
3616 	NL80211_WOWLAN_TCP_WAKE_MASK,
3617 
3618 	/* keep last */
3619 	NUM_NL80211_WOWLAN_TCP,
3620 	MAX_NL80211_WOWLAN_TCP = NUM_NL80211_WOWLAN_TCP - 1
3621 };
3622 
3623 /**
3624  * struct nl80211_coalesce_rule_support - coalesce rule support information
3625  * @max_rules: maximum number of rules supported
3626  * @pat: packet pattern support information
3627  * @max_delay: maximum supported coalescing delay in msecs
3628  *
3629  * This struct is carried in %NL80211_ATTR_COALESCE_RULE in the
3630  * capability information given by the kernel to userspace.
3631  */
3632 struct nl80211_coalesce_rule_support {
3633 	__u32 max_rules;
3634 	struct nl80211_pattern_support pat;
3635 	__u32 max_delay;
3636 } __attribute__((packed));
3637 
3638 /**
3639  * enum nl80211_attr_coalesce_rule - coalesce rule attribute
3640  * @__NL80211_COALESCE_RULE_INVALID: invalid number for nested attribute
3641  * @NL80211_ATTR_COALESCE_RULE_DELAY: delay in msecs used for packet coalescing
3642  * @NL80211_ATTR_COALESCE_RULE_CONDITION: condition for packet coalescence,
3643  *	see &enum nl80211_coalesce_condition.
3644  * @NL80211_ATTR_COALESCE_RULE_PKT_PATTERN: packet offset, pattern is matched
3645  *	after these fixed number of bytes of received packet
3646  * @NUM_NL80211_ATTR_COALESCE_RULE: number of attributes
3647  * @NL80211_ATTR_COALESCE_RULE_MAX: max attribute number
3648  */
3649 enum nl80211_attr_coalesce_rule {
3650 	__NL80211_COALESCE_RULE_INVALID,
3651 	NL80211_ATTR_COALESCE_RULE_DELAY,
3652 	NL80211_ATTR_COALESCE_RULE_CONDITION,
3653 	NL80211_ATTR_COALESCE_RULE_PKT_PATTERN,
3654 
3655 	/* keep last */
3656 	NUM_NL80211_ATTR_COALESCE_RULE,
3657 	NL80211_ATTR_COALESCE_RULE_MAX = NUM_NL80211_ATTR_COALESCE_RULE - 1
3658 };
3659 
3660 /**
3661  * enum nl80211_coalesce_condition - coalesce rule conditions
3662  * @NL80211_COALESCE_CONDITION_MATCH: coalaesce Rx packets when patterns
3663  *	in a rule are matched.
3664  * @NL80211_COALESCE_CONDITION_NO_MATCH: coalesce Rx packets when patterns
3665  *	in a rule are not matched.
3666  */
3667 enum nl80211_coalesce_condition {
3668 	NL80211_COALESCE_CONDITION_MATCH,
3669 	NL80211_COALESCE_CONDITION_NO_MATCH
3670 };
3671 
3672 /**
3673  * enum nl80211_iface_limit_attrs - limit attributes
3674  * @NL80211_IFACE_LIMIT_UNSPEC: (reserved)
3675  * @NL80211_IFACE_LIMIT_MAX: maximum number of interfaces that
3676  *	can be chosen from this set of interface types (u32)
3677  * @NL80211_IFACE_LIMIT_TYPES: nested attribute containing a
3678  *	flag attribute for each interface type in this set
3679  * @NUM_NL80211_IFACE_LIMIT: number of attributes
3680  * @MAX_NL80211_IFACE_LIMIT: highest attribute number
3681  */
3682 enum nl80211_iface_limit_attrs {
3683 	NL80211_IFACE_LIMIT_UNSPEC,
3684 	NL80211_IFACE_LIMIT_MAX,
3685 	NL80211_IFACE_LIMIT_TYPES,
3686 
3687 	/* keep last */
3688 	NUM_NL80211_IFACE_LIMIT,
3689 	MAX_NL80211_IFACE_LIMIT = NUM_NL80211_IFACE_LIMIT - 1
3690 };
3691 
3692 /**
3693  * enum nl80211_if_combination_attrs -- interface combination attributes
3694  *
3695  * @NL80211_IFACE_COMB_UNSPEC: (reserved)
3696  * @NL80211_IFACE_COMB_LIMITS: Nested attributes containing the limits
3697  *	for given interface types, see &enum nl80211_iface_limit_attrs.
3698  * @NL80211_IFACE_COMB_MAXNUM: u32 attribute giving the total number of
3699  *	interfaces that can be created in this group. This number doesn't
3700  *	apply to interfaces purely managed in software, which are listed
3701  *	in a separate attribute %NL80211_ATTR_INTERFACES_SOFTWARE.
3702  * @NL80211_IFACE_COMB_STA_AP_BI_MATCH: flag attribute specifying that
3703  *	beacon intervals within this group must be all the same even for
3704  *	infrastructure and AP/GO combinations, i.e. the GO(s) must adopt
3705  *	the infrastructure network's beacon interval.
3706  * @NL80211_IFACE_COMB_NUM_CHANNELS: u32 attribute specifying how many
3707  *	different channels may be used within this group.
3708  * @NL80211_IFACE_COMB_RADAR_DETECT_WIDTHS: u32 attribute containing the bitmap
3709  *	of supported channel widths for radar detection.
3710  * @NL80211_IFACE_COMB_RADAR_DETECT_REGIONS: u32 attribute containing the bitmap
3711  *	of supported regulatory regions for radar detection.
3712  * @NUM_NL80211_IFACE_COMB: number of attributes
3713  * @MAX_NL80211_IFACE_COMB: highest attribute number
3714  *
3715  * Examples:
3716  *	limits = [ #{STA} <= 1, #{AP} <= 1 ], matching BI, channels = 1, max = 2
3717  *	=> allows an AP and a STA that must match BIs
3718  *
3719  *	numbers = [ #{AP, P2P-GO} <= 8 ], channels = 1, max = 8
3720  *	=> allows 8 of AP/GO
3721  *
3722  *	numbers = [ #{STA} <= 2 ], channels = 2, max = 2
3723  *	=> allows two STAs on different channels
3724  *
3725  *	numbers = [ #{STA} <= 1, #{P2P-client,P2P-GO} <= 3 ], max = 4
3726  *	=> allows a STA plus three P2P interfaces
3727  *
3728  * The list of these four possiblities could completely be contained
3729  * within the %NL80211_ATTR_INTERFACE_COMBINATIONS attribute to indicate
3730  * that any of these groups must match.
3731  *
3732  * "Combinations" of just a single interface will not be listed here,
3733  * a single interface of any valid interface type is assumed to always
3734  * be possible by itself. This means that implicitly, for each valid
3735  * interface type, the following group always exists:
3736  *	numbers = [ #{<type>} <= 1 ], channels = 1, max = 1
3737  */
3738 enum nl80211_if_combination_attrs {
3739 	NL80211_IFACE_COMB_UNSPEC,
3740 	NL80211_IFACE_COMB_LIMITS,
3741 	NL80211_IFACE_COMB_MAXNUM,
3742 	NL80211_IFACE_COMB_STA_AP_BI_MATCH,
3743 	NL80211_IFACE_COMB_NUM_CHANNELS,
3744 	NL80211_IFACE_COMB_RADAR_DETECT_WIDTHS,
3745 	NL80211_IFACE_COMB_RADAR_DETECT_REGIONS,
3746 
3747 	/* keep last */
3748 	NUM_NL80211_IFACE_COMB,
3749 	MAX_NL80211_IFACE_COMB = NUM_NL80211_IFACE_COMB - 1
3750 };
3751 
3752 
3753 /**
3754  * enum nl80211_plink_state - state of a mesh peer link finite state machine
3755  *
3756  * @NL80211_PLINK_LISTEN: initial state, considered the implicit
3757  *	state of non existant mesh peer links
3758  * @NL80211_PLINK_OPN_SNT: mesh plink open frame has been sent to
3759  *	this mesh peer
3760  * @NL80211_PLINK_OPN_RCVD: mesh plink open frame has been received
3761  *	from this mesh peer
3762  * @NL80211_PLINK_CNF_RCVD: mesh plink confirm frame has been
3763  *	received from this mesh peer
3764  * @NL80211_PLINK_ESTAB: mesh peer link is established
3765  * @NL80211_PLINK_HOLDING: mesh peer link is being closed or cancelled
3766  * @NL80211_PLINK_BLOCKED: all frames transmitted from this mesh
3767  *	plink are discarded
3768  * @NUM_NL80211_PLINK_STATES: number of peer link states
3769  * @MAX_NL80211_PLINK_STATES: highest numerical value of plink states
3770  */
3771 enum nl80211_plink_state {
3772 	NL80211_PLINK_LISTEN,
3773 	NL80211_PLINK_OPN_SNT,
3774 	NL80211_PLINK_OPN_RCVD,
3775 	NL80211_PLINK_CNF_RCVD,
3776 	NL80211_PLINK_ESTAB,
3777 	NL80211_PLINK_HOLDING,
3778 	NL80211_PLINK_BLOCKED,
3779 
3780 	/* keep last */
3781 	NUM_NL80211_PLINK_STATES,
3782 	MAX_NL80211_PLINK_STATES = NUM_NL80211_PLINK_STATES - 1
3783 };
3784 
3785 /**
3786  * enum nl80211_plink_action - actions to perform in mesh peers
3787  *
3788  * @NL80211_PLINK_ACTION_NO_ACTION: perform no action
3789  * @NL80211_PLINK_ACTION_OPEN: start mesh peer link establishment
3790  * @NL80211_PLINK_ACTION_BLOCK: block traffic from this mesh peer
3791  * @NUM_NL80211_PLINK_ACTIONS: number of possible actions
3792  */
3793 enum plink_actions {
3794 	NL80211_PLINK_ACTION_NO_ACTION,
3795 	NL80211_PLINK_ACTION_OPEN,
3796 	NL80211_PLINK_ACTION_BLOCK,
3797 
3798 	NUM_NL80211_PLINK_ACTIONS,
3799 };
3800 
3801 
3802 #define NL80211_KCK_LEN			16
3803 #define NL80211_KEK_LEN			16
3804 #define NL80211_REPLAY_CTR_LEN		8
3805 
3806 /**
3807  * enum nl80211_rekey_data - attributes for GTK rekey offload
3808  * @__NL80211_REKEY_DATA_INVALID: invalid number for nested attributes
3809  * @NL80211_REKEY_DATA_KEK: key encryption key (binary)
3810  * @NL80211_REKEY_DATA_KCK: key confirmation key (binary)
3811  * @NL80211_REKEY_DATA_REPLAY_CTR: replay counter (binary)
3812  * @NUM_NL80211_REKEY_DATA: number of rekey attributes (internal)
3813  * @MAX_NL80211_REKEY_DATA: highest rekey attribute (internal)
3814  */
3815 enum nl80211_rekey_data {
3816 	__NL80211_REKEY_DATA_INVALID,
3817 	NL80211_REKEY_DATA_KEK,
3818 	NL80211_REKEY_DATA_KCK,
3819 	NL80211_REKEY_DATA_REPLAY_CTR,
3820 
3821 	/* keep last */
3822 	NUM_NL80211_REKEY_DATA,
3823 	MAX_NL80211_REKEY_DATA = NUM_NL80211_REKEY_DATA - 1
3824 };
3825 
3826 /**
3827  * enum nl80211_hidden_ssid - values for %NL80211_ATTR_HIDDEN_SSID
3828  * @NL80211_HIDDEN_SSID_NOT_IN_USE: do not hide SSID (i.e., broadcast it in
3829  *	Beacon frames)
3830  * @NL80211_HIDDEN_SSID_ZERO_LEN: hide SSID by using zero-length SSID element
3831  *	in Beacon frames
3832  * @NL80211_HIDDEN_SSID_ZERO_CONTENTS: hide SSID by using correct length of SSID
3833  *	element in Beacon frames but zero out each byte in the SSID
3834  */
3835 enum nl80211_hidden_ssid {
3836 	NL80211_HIDDEN_SSID_NOT_IN_USE,
3837 	NL80211_HIDDEN_SSID_ZERO_LEN,
3838 	NL80211_HIDDEN_SSID_ZERO_CONTENTS
3839 };
3840 
3841 /**
3842  * enum nl80211_sta_wme_attr - station WME attributes
3843  * @__NL80211_STA_WME_INVALID: invalid number for nested attribute
3844  * @NL80211_STA_WME_UAPSD_QUEUES: bitmap of uapsd queues. the format
3845  *	is the same as the AC bitmap in the QoS info field.
3846  * @NL80211_STA_WME_MAX_SP: max service period. the format is the same
3847  *	as the MAX_SP field in the QoS info field (but already shifted down).
3848  * @__NL80211_STA_WME_AFTER_LAST: internal
3849  * @NL80211_STA_WME_MAX: highest station WME attribute
3850  */
3851 enum nl80211_sta_wme_attr {
3852 	__NL80211_STA_WME_INVALID,
3853 	NL80211_STA_WME_UAPSD_QUEUES,
3854 	NL80211_STA_WME_MAX_SP,
3855 
3856 	/* keep last */
3857 	__NL80211_STA_WME_AFTER_LAST,
3858 	NL80211_STA_WME_MAX = __NL80211_STA_WME_AFTER_LAST - 1
3859 };
3860 
3861 /**
3862  * enum nl80211_pmksa_candidate_attr - attributes for PMKSA caching candidates
3863  * @__NL80211_PMKSA_CANDIDATE_INVALID: invalid number for nested attributes
3864  * @NL80211_PMKSA_CANDIDATE_INDEX: candidate index (u32; the smaller, the higher
3865  *	priority)
3866  * @NL80211_PMKSA_CANDIDATE_BSSID: candidate BSSID (6 octets)
3867  * @NL80211_PMKSA_CANDIDATE_PREAUTH: RSN pre-authentication supported (flag)
3868  * @NUM_NL80211_PMKSA_CANDIDATE: number of PMKSA caching candidate attributes
3869  *	(internal)
3870  * @MAX_NL80211_PMKSA_CANDIDATE: highest PMKSA caching candidate attribute
3871  *	(internal)
3872  */
3873 enum nl80211_pmksa_candidate_attr {
3874 	__NL80211_PMKSA_CANDIDATE_INVALID,
3875 	NL80211_PMKSA_CANDIDATE_INDEX,
3876 	NL80211_PMKSA_CANDIDATE_BSSID,
3877 	NL80211_PMKSA_CANDIDATE_PREAUTH,
3878 
3879 	/* keep last */
3880 	NUM_NL80211_PMKSA_CANDIDATE,
3881 	MAX_NL80211_PMKSA_CANDIDATE = NUM_NL80211_PMKSA_CANDIDATE - 1
3882 };
3883 
3884 /**
3885  * enum nl80211_tdls_operation - values for %NL80211_ATTR_TDLS_OPERATION
3886  * @NL80211_TDLS_DISCOVERY_REQ: Send a TDLS discovery request
3887  * @NL80211_TDLS_SETUP: Setup TDLS link
3888  * @NL80211_TDLS_TEARDOWN: Teardown a TDLS link which is already established
3889  * @NL80211_TDLS_ENABLE_LINK: Enable TDLS link
3890  * @NL80211_TDLS_DISABLE_LINK: Disable TDLS link
3891  */
3892 enum nl80211_tdls_operation {
3893 	NL80211_TDLS_DISCOVERY_REQ,
3894 	NL80211_TDLS_SETUP,
3895 	NL80211_TDLS_TEARDOWN,
3896 	NL80211_TDLS_ENABLE_LINK,
3897 	NL80211_TDLS_DISABLE_LINK,
3898 };
3899 
3900 /*
3901  * enum nl80211_ap_sme_features - device-integrated AP features
3902  * Reserved for future use, no bits are defined in
3903  * NL80211_ATTR_DEVICE_AP_SME yet.
3904 enum nl80211_ap_sme_features {
3905 };
3906  */
3907 
3908 /**
3909  * enum nl80211_feature_flags - device/driver features
3910  * @NL80211_FEATURE_SK_TX_STATUS: This driver supports reflecting back
3911  *	TX status to the socket error queue when requested with the
3912  *	socket option.
3913  * @NL80211_FEATURE_HT_IBSS: This driver supports IBSS with HT datarates.
3914  * @NL80211_FEATURE_INACTIVITY_TIMER: This driver takes care of freeing up
3915  *	the connected inactive stations in AP mode.
3916  * @NL80211_FEATURE_CELL_BASE_REG_HINTS: This driver has been tested
3917  *	to work properly to suppport receiving regulatory hints from
3918  *	cellular base stations.
3919  * @NL80211_FEATURE_P2P_DEVICE_NEEDS_CHANNEL: (no longer available, only
3920  *	here to reserve the value for API/ABI compatibility)
3921  * @NL80211_FEATURE_SAE: This driver supports simultaneous authentication of
3922  *	equals (SAE) with user space SME (NL80211_CMD_AUTHENTICATE) in station
3923  *	mode
3924  * @NL80211_FEATURE_LOW_PRIORITY_SCAN: This driver supports low priority scan
3925  * @NL80211_FEATURE_SCAN_FLUSH: Scan flush is supported
3926  * @NL80211_FEATURE_AP_SCAN: Support scanning using an AP vif
3927  * @NL80211_FEATURE_VIF_TXPOWER: The driver supports per-vif TX power setting
3928  * @NL80211_FEATURE_NEED_OBSS_SCAN: The driver expects userspace to perform
3929  *	OBSS scans and generate 20/40 BSS coex reports. This flag is used only
3930  *	for drivers implementing the CONNECT API, for AUTH/ASSOC it is implied.
3931  * @NL80211_FEATURE_P2P_GO_CTWIN: P2P GO implementation supports CT Window
3932  *	setting
3933  * @NL80211_FEATURE_P2P_GO_OPPPS: P2P GO implementation supports opportunistic
3934  *	powersave
3935  * @NL80211_FEATURE_FULL_AP_CLIENT_STATE: The driver supports full state
3936  *	transitions for AP clients. Without this flag (and if the driver
3937  *	doesn't have the AP SME in the device) the driver supports adding
3938  *	stations only when they're associated and adds them in associated
3939  *	state (to later be transitioned into authorized), with this flag
3940  *	they should be added before even sending the authentication reply
3941  *	and then transitioned into authenticated, associated and authorized
3942  *	states using station flags.
3943  *	Note that even for drivers that support this, the default is to add
3944  *	stations in authenticated/associated state, so to add unauthenticated
3945  *	stations the authenticated/associated bits have to be set in the mask.
3946  * @NL80211_FEATURE_ADVERTISE_CHAN_LIMITS: cfg80211 advertises channel limits
3947  *	(HT40, VHT 80/160 MHz) if this flag is set
3948  * @NL80211_FEATURE_USERSPACE_MPM: This driver supports a userspace Mesh
3949  *	Peering Management entity which may be implemented by registering for
3950  *	beacons or NL80211_CMD_NEW_PEER_CANDIDATE events. The mesh beacon is
3951  *	still generated by the driver.
3952  * @NL80211_FEATURE_ACTIVE_MONITOR: This driver supports an active monitor
3953  *	interface. An active monitor interface behaves like a normal monitor
3954  *	interface, but gets added to the driver. It ensures that incoming
3955  *	unicast packets directed at the configured interface address get ACKed.
3956  * @NL80211_FEATURE_AP_MODE_CHAN_WIDTH_CHANGE: This driver supports dynamic
3957  *	channel bandwidth change (e.g., HT 20 <-> 40 MHz channel) during the
3958  *	lifetime of a BSS.
3959  */
3960 enum nl80211_feature_flags {
3961 	NL80211_FEATURE_SK_TX_STATUS			= 1 << 0,
3962 	NL80211_FEATURE_HT_IBSS				= 1 << 1,
3963 	NL80211_FEATURE_INACTIVITY_TIMER		= 1 << 2,
3964 	NL80211_FEATURE_CELL_BASE_REG_HINTS		= 1 << 3,
3965 	NL80211_FEATURE_P2P_DEVICE_NEEDS_CHANNEL	= 1 << 4,
3966 	NL80211_FEATURE_SAE				= 1 << 5,
3967 	NL80211_FEATURE_LOW_PRIORITY_SCAN		= 1 << 6,
3968 	NL80211_FEATURE_SCAN_FLUSH			= 1 << 7,
3969 	NL80211_FEATURE_AP_SCAN				= 1 << 8,
3970 	NL80211_FEATURE_VIF_TXPOWER			= 1 << 9,
3971 	NL80211_FEATURE_NEED_OBSS_SCAN			= 1 << 10,
3972 	NL80211_FEATURE_P2P_GO_CTWIN			= 1 << 11,
3973 	NL80211_FEATURE_P2P_GO_OPPPS			= 1 << 12,
3974 	/* bit 13 is reserved */
3975 	NL80211_FEATURE_ADVERTISE_CHAN_LIMITS		= 1 << 14,
3976 	NL80211_FEATURE_FULL_AP_CLIENT_STATE		= 1 << 15,
3977 	NL80211_FEATURE_USERSPACE_MPM			= 1 << 16,
3978 	NL80211_FEATURE_ACTIVE_MONITOR			= 1 << 17,
3979 	NL80211_FEATURE_AP_MODE_CHAN_WIDTH_CHANGE	= 1 << 18,
3980 };
3981 
3982 /**
3983  * enum nl80211_probe_resp_offload_support_attr - optional supported
3984  *	protocols for probe-response offloading by the driver/FW.
3985  *	To be used with the %NL80211_ATTR_PROBE_RESP_OFFLOAD attribute.
3986  *	Each enum value represents a bit in the bitmap of supported
3987  *	protocols. Typically a subset of probe-requests belonging to a
3988  *	supported protocol will be excluded from offload and uploaded
3989  *	to the host.
3990  *
3991  * @NL80211_PROBE_RESP_OFFLOAD_SUPPORT_WPS: Support for WPS ver. 1
3992  * @NL80211_PROBE_RESP_OFFLOAD_SUPPORT_WPS2: Support for WPS ver. 2
3993  * @NL80211_PROBE_RESP_OFFLOAD_SUPPORT_P2P: Support for P2P
3994  * @NL80211_PROBE_RESP_OFFLOAD_SUPPORT_80211U: Support for 802.11u
3995  */
3996 enum nl80211_probe_resp_offload_support_attr {
3997 	NL80211_PROBE_RESP_OFFLOAD_SUPPORT_WPS =	1<<0,
3998 	NL80211_PROBE_RESP_OFFLOAD_SUPPORT_WPS2 =	1<<1,
3999 	NL80211_PROBE_RESP_OFFLOAD_SUPPORT_P2P =	1<<2,
4000 	NL80211_PROBE_RESP_OFFLOAD_SUPPORT_80211U =	1<<3,
4001 };
4002 
4003 /**
4004  * enum nl80211_connect_failed_reason - connection request failed reasons
4005  * @NL80211_CONN_FAIL_MAX_CLIENTS: Maximum number of clients that can be
4006  *	handled by the AP is reached.
4007  * @NL80211_CONN_FAIL_BLOCKED_CLIENT: Connection request is rejected due to ACL.
4008  */
4009 enum nl80211_connect_failed_reason {
4010 	NL80211_CONN_FAIL_MAX_CLIENTS,
4011 	NL80211_CONN_FAIL_BLOCKED_CLIENT,
4012 };
4013 
4014 /**
4015  * enum nl80211_scan_flags -  scan request control flags
4016  *
4017  * Scan request control flags are used to control the handling
4018  * of NL80211_CMD_TRIGGER_SCAN and NL80211_CMD_START_SCHED_SCAN
4019  * requests.
4020  *
4021  * @NL80211_SCAN_FLAG_LOW_PRIORITY: scan request has low priority
4022  * @NL80211_SCAN_FLAG_FLUSH: flush cache before scanning
4023  * @NL80211_SCAN_FLAG_AP: force a scan even if the interface is configured
4024  *	as AP and the beaconing has already been configured. This attribute is
4025  *	dangerous because will destroy stations performance as a lot of frames
4026  *	will be lost while scanning off-channel, therefore it must be used only
4027  *	when really needed
4028  */
4029 enum nl80211_scan_flags {
4030 	NL80211_SCAN_FLAG_LOW_PRIORITY			= 1<<0,
4031 	NL80211_SCAN_FLAG_FLUSH				= 1<<1,
4032 	NL80211_SCAN_FLAG_AP				= 1<<2,
4033 };
4034 
4035 /**
4036  * enum nl80211_acl_policy - access control policy
4037  *
4038  * Access control policy is applied on a MAC list set by
4039  * %NL80211_CMD_START_AP and %NL80211_CMD_SET_MAC_ACL, to
4040  * be used with %NL80211_ATTR_ACL_POLICY.
4041  *
4042  * @NL80211_ACL_POLICY_ACCEPT_UNLESS_LISTED: Deny stations which are
4043  *	listed in ACL, i.e. allow all the stations which are not listed
4044  *	in ACL to authenticate.
4045  * @NL80211_ACL_POLICY_DENY_UNLESS_LISTED: Allow the stations which are listed
4046  *	in ACL, i.e. deny all the stations which are not listed in ACL.
4047  */
4048 enum nl80211_acl_policy {
4049 	NL80211_ACL_POLICY_ACCEPT_UNLESS_LISTED,
4050 	NL80211_ACL_POLICY_DENY_UNLESS_LISTED,
4051 };
4052 
4053 /**
4054  * enum nl80211_radar_event - type of radar event for DFS operation
4055  *
4056  * Type of event to be used with NL80211_ATTR_RADAR_EVENT to inform userspace
4057  * about detected radars or success of the channel available check (CAC)
4058  *
4059  * @NL80211_RADAR_DETECTED: A radar pattern has been detected. The channel is
4060  *	now unusable.
4061  * @NL80211_RADAR_CAC_FINISHED: Channel Availability Check has been finished,
4062  *	the channel is now available.
4063  * @NL80211_RADAR_CAC_ABORTED: Channel Availability Check has been aborted, no
4064  *	change to the channel status.
4065  * @NL80211_RADAR_NOP_FINISHED: The Non-Occupancy Period for this channel is
4066  *	over, channel becomes usable.
4067  */
4068 enum nl80211_radar_event {
4069 	NL80211_RADAR_DETECTED,
4070 	NL80211_RADAR_CAC_FINISHED,
4071 	NL80211_RADAR_CAC_ABORTED,
4072 	NL80211_RADAR_NOP_FINISHED,
4073 };
4074 
4075 /**
4076  * enum nl80211_dfs_state - DFS states for channels
4077  *
4078  * Channel states used by the DFS code.
4079  *
4080  * @NL80211_DFS_USABLE: The channel can be used, but channel availability
4081  *	check (CAC) must be performed before using it for AP or IBSS.
4082  * @NL80211_DFS_UNAVAILABLE: A radar has been detected on this channel, it
4083  *	is therefore marked as not available.
4084  * @NL80211_DFS_AVAILABLE: The channel has been CAC checked and is available.
4085  */
4086 enum nl80211_dfs_state {
4087 	NL80211_DFS_USABLE,
4088 	NL80211_DFS_UNAVAILABLE,
4089 	NL80211_DFS_AVAILABLE,
4090 };
4091 
4092 /**
4093  * enum enum nl80211_protocol_features - nl80211 protocol features
4094  * @NL80211_PROTOCOL_FEATURE_SPLIT_WIPHY_DUMP: nl80211 supports splitting
4095  *	wiphy dumps (if requested by the application with the attribute
4096  *	%NL80211_ATTR_SPLIT_WIPHY_DUMP. Also supported is filtering the
4097  *	wiphy dump by %NL80211_ATTR_WIPHY, %NL80211_ATTR_IFINDEX or
4098  *	%NL80211_ATTR_WDEV.
4099  */
4100 enum nl80211_protocol_features {
4101 	NL80211_PROTOCOL_FEATURE_SPLIT_WIPHY_DUMP =	1 << 0,
4102 };
4103 
4104 /**
4105  * enum nl80211_crit_proto_id - nl80211 critical protocol identifiers
4106  *
4107  * @NL80211_CRIT_PROTO_UNSPEC: protocol unspecified.
4108  * @NL80211_CRIT_PROTO_DHCP: BOOTP or DHCPv6 protocol.
4109  * @NL80211_CRIT_PROTO_EAPOL: EAPOL protocol.
4110  * @NL80211_CRIT_PROTO_APIPA: APIPA protocol.
4111  * @NUM_NL80211_CRIT_PROTO: must be kept last.
4112  */
4113 enum nl80211_crit_proto_id {
4114 	NL80211_CRIT_PROTO_UNSPEC,
4115 	NL80211_CRIT_PROTO_DHCP,
4116 	NL80211_CRIT_PROTO_EAPOL,
4117 	NL80211_CRIT_PROTO_APIPA,
4118 	/* add other protocols before this one */
4119 	NUM_NL80211_CRIT_PROTO
4120 };
4121 
4122 /* maximum duration for critical protocol measures */
4123 #define NL80211_CRIT_PROTO_MAX_DURATION		5000 /* msec */
4124 
4125 /**
4126  * enum nl80211_rxmgmt_flags - flags for received management frame.
4127  *
4128  * Used by cfg80211_rx_mgmt()
4129  *
4130  * @NL80211_RXMGMT_FLAG_ANSWERED: frame was answered by device/driver.
4131  */
4132 enum nl80211_rxmgmt_flags {
4133 	NL80211_RXMGMT_FLAG_ANSWERED = 1 << 0,
4134 };
4135 
4136 /*
4137  * If this flag is unset, the lower 24 bits are an OUI, if set
4138  * a Linux nl80211 vendor ID is used (no such IDs are allocated
4139  * yet, so that's not valid so far)
4140  */
4141 #define NL80211_VENDOR_ID_IS_LINUX	0x80000000
4142 
4143 /**
4144  * struct nl80211_vendor_cmd_info - vendor command data
4145  * @vendor_id: If the %NL80211_VENDOR_ID_IS_LINUX flag is clear, then the
4146  *	value is a 24-bit OUI; if it is set then a separately allocated ID
4147  *	may be used, but no such IDs are allocated yet. New IDs should be
4148  *	added to this file when needed.
4149  * @subcmd: sub-command ID for the command
4150  */
4151 struct nl80211_vendor_cmd_info {
4152 	__u32 vendor_id;
4153 	__u32 subcmd;
4154 };
4155 
4156 /**
4157  * enum nl80211_tdls_peer_capability - TDLS peer flags.
4158  *
4159  * Used by tdls_mgmt() to determine which conditional elements need
4160  * to be added to TDLS Setup frames.
4161  *
4162  * @NL80211_TDLS_PEER_HT: TDLS peer is HT capable.
4163  * @NL80211_TDLS_PEER_VHT: TDLS peer is VHT capable.
4164  * @NL80211_TDLS_PEER_WMM: TDLS peer is WMM capable.
4165  */
4166 enum nl80211_tdls_peer_capability {
4167 	NL80211_TDLS_PEER_HT = 1<<0,
4168 	NL80211_TDLS_PEER_VHT = 1<<1,
4169 	NL80211_TDLS_PEER_WMM = 1<<2,
4170 };
4171 
4172 #endif /* __LINUX_NL80211_H */
4173