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