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