Home | History | Annotate | Download | only in wpa_supplicant_lib
      1 #ifndef __LINUX_NL80211_H
      2 #define __LINUX_NL80211_H
      3 /*
      4  * 802.11 netlink interface public header
      5  *
      6  * Copyright 2006-2010 Johannes Berg <johannes (at) sipsolutions.net>
      7  * Copyright 2008 Michael Wu <flamingice (at) sourmilk.net>
      8  * Copyright 2008 Luis Carlos Cobo <luisca (at) cozybit.com>
      9  * Copyright 2008 Michael Buesch <mb (at) bu3sch.de>
     10  * Copyright 2008, 2009 Luis R. Rodriguez <lrodriguez (at) atheros.com>
     11  * Copyright 2008 Jouni Malinen <jouni.malinen (at) atheros.com>
     12  * Copyright 2008 Colin McCabe <colin (at) cozybit.com>
     13  *
     14  * Permission to use, copy, modify, and/or distribute this software for any
     15  * purpose with or without fee is hereby granted, provided that the above
     16  * copyright notice and this permission notice appear in all copies.
     17  *
     18  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
     19  * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
     20  * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
     21  * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
     22  * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
     23  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
     24  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
     25  *
     26  */
     27 
     28 #include <linux/types.h>
     29 
     30 /**
     31  * DOC: Station handling
     32  *
     33  * Stations are added per interface, but a special case exists with VLAN
     34  * interfaces. When a station is bound to an AP interface, it may be moved
     35  * into a VLAN identified by a VLAN interface index (%NL80211_ATTR_STA_VLAN).
     36  * The station is still assumed to belong to the AP interface it was added
     37  * to.
     38  *
     39  * TODO: need more info?
     40  */
     41 
     42 /**
     43  * DOC: Frame transmission/registration support
     44  *
     45  * Frame transmission and registration support exists to allow userspace
     46  * management entities such as wpa_supplicant react to management frames
     47  * that are not being handled by the kernel. This includes, for example,
     48  * certain classes of action frames that cannot be handled in the kernel
     49  * for various reasons.
     50  *
     51  * Frame registration is done on a per-interface basis and registrations
     52  * cannot be removed other than by closing the socket. It is possible to
     53  * specify a registration filter to register, for example, only for a
     54  * certain type of action frame. In particular with action frames, those
     55  * that userspace registers for will not be returned as unhandled by the
     56  * driver, so that the registered application has to take responsibility
     57  * for doing that.
     58  *
     59  * The type of frame that can be registered for is also dependent on the
     60  * driver and interface type. The frame types are advertised in wiphy
     61  * attributes so applications know what to expect.
     62  *
     63  * NOTE: When an interface changes type while registrations are active,
     64  *       these registrations are ignored until the interface type is
     65  *       changed again. This means that changing the interface type can
     66  *       lead to a situation that couldn't otherwise be produced, but
     67  *       any such registrations will be dormant in the sense that they
     68  *       will not be serviced, i.e. they will not receive any frames.
     69  *
     70  * Frame transmission allows userspace to send for example the required
     71  * responses to action frames. It is subject to some sanity checking,
     72  * but many frames can be transmitted. When a frame was transmitted, its
     73  * status is indicated to the sending socket.
     74  *
     75  * For more technical details, see the corresponding command descriptions
     76  * below.
     77  */
     78 
     79 /**
     80  * enum nl80211_commands - supported nl80211 commands
     81  *
     82  * @NL80211_CMD_UNSPEC: unspecified command to catch errors
     83  *
     84  * @NL80211_CMD_GET_WIPHY: request information about a wiphy or dump request
     85  *    to get a list of all present wiphys.
     86  * @NL80211_CMD_SET_WIPHY: set wiphy parameters, needs %NL80211_ATTR_WIPHY or
     87  *    %NL80211_ATTR_IFINDEX; can be used to set %NL80211_ATTR_WIPHY_NAME,
     88  *    %NL80211_ATTR_WIPHY_TXQ_PARAMS, %NL80211_ATTR_WIPHY_FREQ,
     89  *    %NL80211_ATTR_WIPHY_CHANNEL_TYPE, %NL80211_ATTR_WIPHY_RETRY_SHORT,
     90  *    %NL80211_ATTR_WIPHY_RETRY_LONG, %NL80211_ATTR_WIPHY_FRAG_THRESHOLD,
     91  *    and/or %NL80211_ATTR_WIPHY_RTS_THRESHOLD.
     92  *    However, for setting the channel, see %NL80211_CMD_SET_CHANNEL
     93  *    instead, the support here is for backward compatibility only.
     94  * @NL80211_CMD_NEW_WIPHY: Newly created wiphy, response to get request
     95  *    or rename notification. Has attributes %NL80211_ATTR_WIPHY and
     96  *    %NL80211_ATTR_WIPHY_NAME.
     97  * @NL80211_CMD_DEL_WIPHY: Wiphy deleted. Has attributes
     98  *    %NL80211_ATTR_WIPHY and %NL80211_ATTR_WIPHY_NAME.
     99  *
    100  * @NL80211_CMD_GET_INTERFACE: Request an interface's configuration;
    101  *    either a dump request on a %NL80211_ATTR_WIPHY or a specific get
    102  *    on an %NL80211_ATTR_IFINDEX is supported.
    103  * @NL80211_CMD_SET_INTERFACE: Set type of a virtual interface, requires
    104  *    %NL80211_ATTR_IFINDEX and %NL80211_ATTR_IFTYPE.
    105  * @NL80211_CMD_NEW_INTERFACE: Newly created virtual interface or response
    106  *    to %NL80211_CMD_GET_INTERFACE. Has %NL80211_ATTR_IFINDEX,
    107  *    %NL80211_ATTR_WIPHY and %NL80211_ATTR_IFTYPE attributes. Can also
    108  *    be sent from userspace to request creation of a new virtual interface,
    109  *    then requires attributes %NL80211_ATTR_WIPHY, %NL80211_ATTR_IFTYPE and
    110  *    %NL80211_ATTR_IFNAME.
    111  * @NL80211_CMD_DEL_INTERFACE: Virtual interface was deleted, has attributes
    112  *    %NL80211_ATTR_IFINDEX and %NL80211_ATTR_WIPHY. Can also be sent from
    113  *    userspace to request deletion of a virtual interface, then requires
    114  *    attribute %NL80211_ATTR_IFINDEX.
    115  *
    116  * @NL80211_CMD_GET_KEY: Get sequence counter information for a key specified
    117  *    by %NL80211_ATTR_KEY_IDX and/or %NL80211_ATTR_MAC.
    118  * @NL80211_CMD_SET_KEY: Set key attributes %NL80211_ATTR_KEY_DEFAULT,
    119  *    %NL80211_ATTR_KEY_DEFAULT_MGMT, or %NL80211_ATTR_KEY_THRESHOLD.
    120  * @NL80211_CMD_NEW_KEY: add a key with given %NL80211_ATTR_KEY_DATA,
    121  *    %NL80211_ATTR_KEY_IDX, %NL80211_ATTR_MAC, %NL80211_ATTR_KEY_CIPHER,
    122  *    and %NL80211_ATTR_KEY_SEQ attributes.
    123  * @NL80211_CMD_DEL_KEY: delete a key identified by %NL80211_ATTR_KEY_IDX
    124  *    or %NL80211_ATTR_MAC.
    125  *
    126  * @NL80211_CMD_GET_BEACON: retrieve beacon information (returned in a
    127  *    %NL80222_CMD_NEW_BEACON message)
    128  * @NL80211_CMD_SET_BEACON: set the beacon on an access point interface
    129  *    using the %NL80211_ATTR_BEACON_INTERVAL, %NL80211_ATTR_DTIM_PERIOD,
    130  *    %NL80211_ATTR_BEACON_HEAD and %NL80211_ATTR_BEACON_TAIL attributes.
    131  * @NL80211_CMD_NEW_BEACON: add a new beacon to an access point interface,
    132  *    parameters are like for %NL80211_CMD_SET_BEACON.
    133  * @NL80211_CMD_DEL_BEACON: remove the beacon, stop sending it
    134  *
    135  * @NL80211_CMD_GET_STATION: Get station attributes for station identified by
    136  *    %NL80211_ATTR_MAC on the interface identified by %NL80211_ATTR_IFINDEX.
    137  * @NL80211_CMD_SET_STATION: Set station attributes for station identified by
    138  *    %NL80211_ATTR_MAC on the interface identified by %NL80211_ATTR_IFINDEX.
    139  * @NL80211_CMD_NEW_STATION: Add a station with given attributes to the
    140  *    the interface identified by %NL80211_ATTR_IFINDEX.
    141  * @NL80211_CMD_DEL_STATION: Remove a station identified by %NL80211_ATTR_MAC
    142  *    or, if no MAC address given, all stations, on the interface identified
    143  *    by %NL80211_ATTR_IFINDEX.
    144  *
    145  * @NL80211_CMD_GET_MPATH: Get mesh path attributes for mesh path to
    146  *     destination %NL80211_ATTR_MAC on the interface identified by
    147  *     %NL80211_ATTR_IFINDEX.
    148  * @NL80211_CMD_SET_MPATH:  Set mesh path attributes for mesh path to
    149  *     destination %NL80211_ATTR_MAC on the interface identified by
    150  *     %NL80211_ATTR_IFINDEX.
    151  * @NL80211_CMD_NEW_PATH: Add a mesh path with given attributes to the
    152  *    the interface identified by %NL80211_ATTR_IFINDEX.
    153  * @NL80211_CMD_DEL_PATH: Remove a mesh path identified by %NL80211_ATTR_MAC
    154  *    or, if no MAC address given, all mesh paths, on the interface identified
    155  *    by %NL80211_ATTR_IFINDEX.
    156  * @NL80211_CMD_SET_BSS: Set BSS attributes for BSS identified by
    157  *    %NL80211_ATTR_IFINDEX.
    158  *
    159  * @NL80211_CMD_GET_REG: ask the wireless core to send us its currently set
    160  *     regulatory domain.
    161  * @NL80211_CMD_SET_REG: Set current regulatory domain. CRDA sends this command
    162  *    after being queried by the kernel. CRDA replies by sending a regulatory
    163  *    domain structure which consists of %NL80211_ATTR_REG_ALPHA set to our
    164  *    current alpha2 if it found a match. It also provides
    165  *     NL80211_ATTR_REG_RULE_FLAGS, and a set of regulatory rules. Each
    166  *     regulatory rule is a nested set of attributes  given by
    167  *     %NL80211_ATTR_REG_RULE_FREQ_[START|END] and
    168  *     %NL80211_ATTR_FREQ_RANGE_MAX_BW with an attached power rule given by
    169  *     %NL80211_ATTR_REG_RULE_POWER_MAX_ANT_GAIN and
    170  *     %NL80211_ATTR_REG_RULE_POWER_MAX_EIRP.
    171  * @NL80211_CMD_REQ_SET_REG: ask the wireless core to set the regulatory domain
    172  *     to the specified ISO/IEC 3166-1 alpha2 country code. The core will
    173  *     store this as a valid request and then query userspace for it.
    174  *
    175  * @NL80211_CMD_GET_MESH_PARAMS: Get mesh networking properties for the
    176  *    interface identified by %NL80211_ATTR_IFINDEX
    177  *
    178  * @NL80211_CMD_SET_MESH_PARAMS: Set mesh networking properties for the
    179  *      interface identified by %NL80211_ATTR_IFINDEX
    180  *
    181  * @NL80211_CMD_SET_MGMT_EXTRA_IE: Set extra IEs for management frames. The
    182  *    interface is identified with %NL80211_ATTR_IFINDEX and the management
    183  *    frame subtype with %NL80211_ATTR_MGMT_SUBTYPE. The extra IE data to be
    184  *    added to the end of the specified management frame is specified with
    185  *    %NL80211_ATTR_IE. If the command succeeds, the requested data will be
    186  *    added to all specified management frames generated by
    187  *    kernel/firmware/driver.
    188  *    Note: This command has been removed and it is only reserved at this
    189  *    point to avoid re-using existing command number. The functionality this
    190  *    command was planned for has been provided with cleaner design with the
    191  *    option to specify additional IEs in NL80211_CMD_TRIGGER_SCAN,
    192  *    NL80211_CMD_AUTHENTICATE, NL80211_CMD_ASSOCIATE,
    193  *    NL80211_CMD_DEAUTHENTICATE, and NL80211_CMD_DISASSOCIATE.
    194  *
    195  * @NL80211_CMD_GET_SCAN: get scan results
    196  * @NL80211_CMD_TRIGGER_SCAN: trigger a new scan with the given parameters
    197  * @NL80211_CMD_NEW_SCAN_RESULTS: scan notification (as a reply to
    198  *    NL80211_CMD_GET_SCAN and on the "scan" multicast group)
    199  * @NL80211_CMD_SCAN_ABORTED: scan was aborted, for unspecified reasons,
    200  *    partial scan results may be available
    201  *
    202  * @NL80211_CMD_GET_SURVEY: get survey resuls, e.g. channel occupation
    203  *      or noise level
    204  * @NL80211_CMD_NEW_SURVEY_RESULTS: survey data notification (as a reply to
    205  *    NL80211_CMD_GET_SURVEY and on the "scan" multicast group)
    206  *
    207  * @NL80211_CMD_REG_CHANGE: indicates to userspace the regulatory domain
    208  *     has been changed and provides details of the request information
    209  *     that caused the change such as who initiated the regulatory request
    210  *     (%NL80211_ATTR_REG_INITIATOR), the wiphy_idx
    211  *     (%NL80211_ATTR_REG_ALPHA2) on which the request was made from if
    212  *     the initiator was %NL80211_REGDOM_SET_BY_COUNTRY_IE or
    213  *     %NL80211_REGDOM_SET_BY_DRIVER, the type of regulatory domain
    214  *     set (%NL80211_ATTR_REG_TYPE), if the type of regulatory domain is
    215  *     %NL80211_REG_TYPE_COUNTRY the alpha2 to which we have moved on
    216  *     to (%NL80211_ATTR_REG_ALPHA2).
    217  * @NL80211_CMD_REG_BEACON_HINT: indicates to userspace that an AP beacon
    218  *     has been found while world roaming thus enabling active scan or
    219  *     any mode of operation that initiates TX (beacons) on a channel
    220  *     where we would not have been able to do either before. As an example
    221  *     if you are world roaming (regulatory domain set to world or if your
    222  *     driver is using a custom world roaming regulatory domain) and while
    223  *     doing a passive scan on the 5 GHz band you find an AP there (if not
    224  *     on a DFS channel) you will now be able to actively scan for that AP
    225  *     or use AP mode on your card on that same channel. Note that this will
    226  *     never be used for channels 1-11 on the 2 GHz band as they are always
    227  *     enabled world wide. This beacon hint is only sent if your device had
    228  *     either disabled active scanning or beaconing on a channel. We send to
    229  *     userspace the wiphy on which we removed a restriction from
    230  *     (%NL80211_ATTR_WIPHY) and the channel on which this occurred
    231  *     before (%NL80211_ATTR_FREQ_BEFORE) and after (%NL80211_ATTR_FREQ_AFTER)
    232  *     the beacon hint was processed.
    233  *
    234  * @NL80211_CMD_AUTHENTICATE: authentication request and notification.
    235  *    This command is used both as a command (request to authenticate) and
    236  *    as an event on the "mlme" multicast group indicating completion of the
    237  *    authentication process.
    238  *    When used as a command, %NL80211_ATTR_IFINDEX is used to identify the
    239  *    interface. %NL80211_ATTR_MAC is used to specify PeerSTAAddress (and
    240  *    BSSID in case of station mode). %NL80211_ATTR_SSID is used to specify
    241  *    the SSID (mainly for association, but is included in authentication
    242  *    request, too, to help BSS selection. %NL80211_ATTR_WIPHY_FREQ is used
    243  *    to specify the frequence of the channel in MHz. %NL80211_ATTR_AUTH_TYPE
    244  *    is used to specify the authentication type. %NL80211_ATTR_IE is used to
    245  *    define IEs (VendorSpecificInfo, but also including RSN IE and FT IEs)
    246  *    to be added to the frame.
    247  *    When used as an event, this reports reception of an Authentication
    248  *    frame in station and IBSS modes when the local MLME processed the
    249  *    frame, i.e., it was for the local STA and was received in correct
    250  *    state. This is similar to MLME-AUTHENTICATE.confirm primitive in the
    251  *    MLME SAP interface (kernel providing MLME, userspace SME). The
    252  *    included %NL80211_ATTR_FRAME attribute contains the management frame
    253  *    (including both the header and frame body, but not FCS). This event is
    254  *    also used to indicate if the authentication attempt timed out. In that
    255  *    case the %NL80211_ATTR_FRAME attribute is replaced with a
    256  *    %NL80211_ATTR_TIMED_OUT flag (and %NL80211_ATTR_MAC to indicate which
    257  *    pending authentication timed out).
    258  * @NL80211_CMD_ASSOCIATE: association request and notification; like
    259  *    NL80211_CMD_AUTHENTICATE but for Association and Reassociation
    260  *    (similar to MLME-ASSOCIATE.request, MLME-REASSOCIATE.request,
    261  *    MLME-ASSOCIATE.confirm or MLME-REASSOCIATE.confirm primitives).
    262  * @NL80211_CMD_DEAUTHENTICATE: deauthentication request and notification; like
    263  *    NL80211_CMD_AUTHENTICATE but for Deauthentication frames (similar to
    264  *    MLME-DEAUTHENTICATION.request and MLME-DEAUTHENTICATE.indication
    265  *    primitives).
    266  * @NL80211_CMD_DISASSOCIATE: disassociation request and notification; like
    267  *    NL80211_CMD_AUTHENTICATE but for Disassociation frames (similar to
    268  *    MLME-DISASSOCIATE.request and MLME-DISASSOCIATE.indication primitives).
    269  *
    270  * @NL80211_CMD_MICHAEL_MIC_FAILURE: notification of a locally detected Michael
    271  *    MIC (part of TKIP) failure; sent on the "mlme" multicast group; the
    272  *    event includes %NL80211_ATTR_MAC to describe the source MAC address of
    273  *    the frame with invalid MIC, %NL80211_ATTR_KEY_TYPE to show the key
    274  *    type, %NL80211_ATTR_KEY_IDX to indicate the key identifier, and
    275  *    %NL80211_ATTR_KEY_SEQ to indicate the TSC value of the frame; this
    276  *    event matches with MLME-MICHAELMICFAILURE.indication() primitive
    277  *
    278  * @NL80211_CMD_JOIN_IBSS: Join a new IBSS -- given at least an SSID and a
    279  *    FREQ attribute (for the initial frequency if no peer can be found)
    280  *    and optionally a MAC (as BSSID) and FREQ_FIXED attribute if those
    281  *    should be fixed rather than automatically determined. Can only be
    282  *    executed on a network interface that is UP, and fixed BSSID/FREQ
    283  *    may be rejected. Another optional parameter is the beacon interval,
    284  *    given in the %NL80211_ATTR_BEACON_INTERVAL attribute, which if not
    285  *    given defaults to 100 TU (102.4ms).
    286  * @NL80211_CMD_LEAVE_IBSS: Leave the IBSS -- no special arguments, the IBSS is
    287  *    determined by the network interface.
    288  *
    289  * @NL80211_CMD_TESTMODE: testmode command, takes a wiphy (or ifindex) attribute
    290  *    to identify the device, and the TESTDATA blob attribute to pass through
    291  *    to the driver.
    292  *
    293  * @NL80211_CMD_CONNECT: connection request and notification; this command
    294  *    requests to connect to a specified network but without separating
    295  *    auth and assoc steps. For this, you need to specify the SSID in a
    296  *    %NL80211_ATTR_SSID attribute, and can optionally specify the association
    297  *    IEs in %NL80211_ATTR_IE, %NL80211_ATTR_AUTH_TYPE, %NL80211_ATTR_MAC,
    298  *    %NL80211_ATTR_WIPHY_FREQ, %NL80211_ATTR_CONTROL_PORT,
    299  *    %NL80211_ATTR_CONTROL_PORT_ETHERTYPE and
    300  *    %NL80211_ATTR_CONTROL_PORT_NO_ENCRYPT.
    301  *    It is also sent as an event, with the BSSID and response IEs when the
    302  *    connection is established or failed to be established. This can be
    303  *    determined by the STATUS_CODE attribute.
    304  * @NL80211_CMD_ROAM: request that the card roam (currently not implemented),
    305  *    sent as an event when the card/driver roamed by itself.
    306  * @NL80211_CMD_DISCONNECT: drop a given connection; also used to notify
    307  *    userspace that a connection was dropped by the AP or due to other
    308  *    reasons, for this the %NL80211_ATTR_DISCONNECTED_BY_AP and
    309  *    %NL80211_ATTR_REASON_CODE attributes are used.
    310  *
    311  * @NL80211_CMD_SET_WIPHY_NETNS: Set a wiphy's netns. Note that all devices
    312  *    associated with this wiphy must be down and will follow.
    313  *
    314  * @NL80211_CMD_REMAIN_ON_CHANNEL: Request to remain awake on the specified
    315  *    channel for the specified amount of time. This can be used to do
    316  *    off-channel operations like transmit a Public Action frame and wait for
    317  *    a response while being associated to an AP on another channel.
    318  *    %NL80211_ATTR_IFINDEX is used to specify which interface (and thus
    319  *    radio) is used. %NL80211_ATTR_WIPHY_FREQ is used to specify the
    320  *    frequency for the operation and %NL80211_ATTR_WIPHY_CHANNEL_TYPE may be
    321  *    optionally used to specify additional channel parameters.
    322  *    %NL80211_ATTR_DURATION is used to specify the duration in milliseconds
    323  *    to remain on the channel. This command is also used as an event to
    324  *    notify when the requested duration starts (it may take a while for the
    325  *    driver to schedule this time due to other concurrent needs for the
    326  *    radio).
    327  *    When called, this operation returns a cookie (%NL80211_ATTR_COOKIE)
    328  *    that will be included with any events pertaining to this request;
    329  *    the cookie is also used to cancel the request.
    330  * @NL80211_CMD_CANCEL_REMAIN_ON_CHANNEL: This command can be used to cancel a
    331  *    pending remain-on-channel duration if the desired operation has been
    332  *    completed prior to expiration of the originally requested duration.
    333  *    %NL80211_ATTR_WIPHY or %NL80211_ATTR_IFINDEX is used to specify the
    334  *    radio. The %NL80211_ATTR_COOKIE attribute must be given as well to
    335  *    uniquely identify the request.
    336  *    This command is also used as an event to notify when a requested
    337  *    remain-on-channel duration has expired.
    338  *
    339  * @NL80211_CMD_SET_TX_BITRATE_MASK: Set the mask of rates to be used in TX
    340  *    rate selection. %NL80211_ATTR_IFINDEX is used to specify the interface
    341  *    and @NL80211_ATTR_TX_RATES the set of allowed rates.
    342  *
    343  * @NL80211_CMD_REGISTER_FRAME: Register for receiving certain mgmt frames
    344  *    (via @NL80211_CMD_FRAME) for processing in userspace. This command
    345  *    requires an interface index, a frame type attribute (optional for
    346  *    backward compatibility reasons, if not given assumes action frames)
    347  *    and a match attribute containing the first few bytes of the frame
    348  *    that should match, e.g. a single byte for only a category match or
    349  *    four bytes for vendor frames including the OUI. The registration
    350  *    cannot be dropped, but is removed automatically when the netlink
    351  *    socket is closed. Multiple registrations can be made.
    352  * @NL80211_CMD_REGISTER_ACTION: Alias for @NL80211_CMD_REGISTER_FRAME for
    353  *    backward compatibility
    354  * @NL80211_CMD_FRAME: Management frame TX request and RX notification. This
    355  *    command is used both as a request to transmit a management frame and
    356  *    as an event indicating reception of a frame that was not processed in
    357  *    kernel code, but is for us (i.e., which may need to be processed in a
    358  *    user space application). %NL80211_ATTR_FRAME is used to specify the
    359  *    frame contents (including header). %NL80211_ATTR_WIPHY_FREQ (and
    360  *    optionally %NL80211_ATTR_WIPHY_CHANNEL_TYPE) is used to indicate on
    361  *    which channel the frame is to be transmitted or was received. This
    362  *    channel has to be the current channel (remain-on-channel or the
    363  *    operational channel). When called, this operation returns a cookie
    364  *    (%NL80211_ATTR_COOKIE) that will be included with the TX status event
    365  *    pertaining to the TX request.
    366  * @NL80211_CMD_ACTION: Alias for @NL80211_CMD_FRAME for backward compatibility.
    367  * @NL80211_CMD_FRAME_TX_STATUS: Report TX status of a management frame
    368  *    transmitted with %NL80211_CMD_FRAME. %NL80211_ATTR_COOKIE identifies
    369  *    the TX command and %NL80211_ATTR_FRAME includes the contents of the
    370  *    frame. %NL80211_ATTR_ACK flag is included if the recipient acknowledged
    371  *    the frame.
    372  * @NL80211_CMD_ACTION_TX_STATUS: Alias for @NL80211_CMD_FRAME_TX_STATUS for
    373  *    backward compatibility.
    374  * @NL80211_CMD_SET_CQM: Connection quality monitor configuration. This command
    375  *    is used to configure connection quality monitoring notification trigger
    376  *    levels.
    377  * @NL80211_CMD_NOTIFY_CQM: Connection quality monitor notification. This
    378  *    command is used as an event to indicate the that a trigger level was
    379  *    reached.
    380  * @NL80211_CMD_SET_CHANNEL: Set the channel (using %NL80211_ATTR_WIPHY_FREQ
    381  *    and %NL80211_ATTR_WIPHY_CHANNEL_TYPE) the given interface (identifed
    382  *    by %NL80211_ATTR_IFINDEX) shall operate on.
    383  *    In case multiple channels are supported by the device, the mechanism
    384  *    with which it switches channels is implementation-defined.
    385  *    When a monitor interface is given, it can only switch channel while
    386  *    no other interfaces are operating to avoid disturbing the operation
    387  *    of any other interfaces, and other interfaces will again take
    388  *    precedence when they are used.
    389  *
    390  * @NL80211_CMD_SET_WDS_PEER: Set the MAC address of the peer on a WDS interface.
    391  *
    392  * @NL80211_CMD_MAX: highest used command number
    393  * @__NL80211_CMD_AFTER_LAST: internal use
    394  */
    395 enum nl80211_commands {
    396 /* don't change the order or add anything inbetween, this is ABI! */
    397     NL80211_CMD_UNSPEC,
    398 
    399     NL80211_CMD_GET_WIPHY,        /* can dump */
    400     NL80211_CMD_SET_WIPHY,
    401     NL80211_CMD_NEW_WIPHY,
    402     NL80211_CMD_DEL_WIPHY,
    403 
    404     NL80211_CMD_GET_INTERFACE,    /* can dump */
    405     NL80211_CMD_SET_INTERFACE,
    406     NL80211_CMD_NEW_INTERFACE,
    407     NL80211_CMD_DEL_INTERFACE,
    408 
    409     NL80211_CMD_GET_KEY,
    410     NL80211_CMD_SET_KEY,
    411     NL80211_CMD_NEW_KEY,
    412     NL80211_CMD_DEL_KEY,
    413 
    414     NL80211_CMD_GET_BEACON,
    415     NL80211_CMD_SET_BEACON,
    416     NL80211_CMD_NEW_BEACON,
    417     NL80211_CMD_DEL_BEACON,
    418 
    419     NL80211_CMD_GET_STATION,
    420     NL80211_CMD_SET_STATION,
    421     NL80211_CMD_NEW_STATION,
    422     NL80211_CMD_DEL_STATION,
    423 
    424     NL80211_CMD_GET_MPATH,
    425     NL80211_CMD_SET_MPATH,
    426     NL80211_CMD_NEW_MPATH,
    427     NL80211_CMD_DEL_MPATH,
    428 
    429     NL80211_CMD_SET_BSS,
    430 
    431     NL80211_CMD_SET_REG,
    432     NL80211_CMD_REQ_SET_REG,
    433 
    434     NL80211_CMD_GET_MESH_PARAMS,
    435     NL80211_CMD_SET_MESH_PARAMS,
    436 
    437     NL80211_CMD_SET_MGMT_EXTRA_IE /* reserved; not used */,
    438 
    439     NL80211_CMD_GET_REG,
    440 
    441     NL80211_CMD_GET_SCAN,
    442     NL80211_CMD_TRIGGER_SCAN,
    443     NL80211_CMD_NEW_SCAN_RESULTS,
    444     NL80211_CMD_SCAN_ABORTED,
    445 
    446     NL80211_CMD_REG_CHANGE,
    447 
    448     NL80211_CMD_AUTHENTICATE,
    449     NL80211_CMD_ASSOCIATE,
    450     NL80211_CMD_DEAUTHENTICATE,
    451     NL80211_CMD_DISASSOCIATE,
    452 
    453     NL80211_CMD_MICHAEL_MIC_FAILURE,
    454 
    455     NL80211_CMD_REG_BEACON_HINT,
    456 
    457     NL80211_CMD_JOIN_IBSS,
    458     NL80211_CMD_LEAVE_IBSS,
    459 
    460     NL80211_CMD_TESTMODE,
    461 
    462     NL80211_CMD_CONNECT,
    463     NL80211_CMD_ROAM,
    464     NL80211_CMD_DISCONNECT,
    465 
    466     NL80211_CMD_SET_WIPHY_NETNS,
    467 
    468     NL80211_CMD_GET_SURVEY,
    469     NL80211_CMD_NEW_SURVEY_RESULTS,
    470 
    471     NL80211_CMD_SET_PMKSA,
    472     NL80211_CMD_DEL_PMKSA,
    473     NL80211_CMD_FLUSH_PMKSA,
    474 
    475     NL80211_CMD_REMAIN_ON_CHANNEL,
    476     NL80211_CMD_CANCEL_REMAIN_ON_CHANNEL,
    477 
    478     NL80211_CMD_SET_TX_BITRATE_MASK,
    479 
    480     NL80211_CMD_REGISTER_FRAME,
    481     NL80211_CMD_REGISTER_ACTION = NL80211_CMD_REGISTER_FRAME,
    482     NL80211_CMD_FRAME,
    483     NL80211_CMD_ACTION = NL80211_CMD_FRAME,
    484     NL80211_CMD_FRAME_TX_STATUS,
    485     NL80211_CMD_ACTION_TX_STATUS = NL80211_CMD_FRAME_TX_STATUS,
    486 
    487     NL80211_CMD_SET_POWER_SAVE,
    488     NL80211_CMD_GET_POWER_SAVE,
    489 
    490     NL80211_CMD_SET_CQM,
    491     NL80211_CMD_NOTIFY_CQM,
    492 
    493     NL80211_CMD_SET_CHANNEL,
    494     NL80211_CMD_SET_WDS_PEER,
    495 
    496     /* add new commands above here */
    497 
    498     /* used to define NL80211_CMD_MAX below */
    499     __NL80211_CMD_AFTER_LAST,
    500     NL80211_CMD_MAX = __NL80211_CMD_AFTER_LAST - 1
    501 };
    502 
    503 /*
    504  * Allow user space programs to use #ifdef on new commands by defining them
    505  * here
    506  */
    507 #define NL80211_CMD_SET_BSS NL80211_CMD_SET_BSS
    508 #define NL80211_CMD_SET_MGMT_EXTRA_IE NL80211_CMD_SET_MGMT_EXTRA_IE
    509 #define NL80211_CMD_REG_CHANGE NL80211_CMD_REG_CHANGE
    510 #define NL80211_CMD_AUTHENTICATE NL80211_CMD_AUTHENTICATE
    511 #define NL80211_CMD_ASSOCIATE NL80211_CMD_ASSOCIATE
    512 #define NL80211_CMD_DEAUTHENTICATE NL80211_CMD_DEAUTHENTICATE
    513 #define NL80211_CMD_DISASSOCIATE NL80211_CMD_DISASSOCIATE
    514 #define NL80211_CMD_REG_BEACON_HINT NL80211_CMD_REG_BEACON_HINT
    515 
    516 /**
    517  * enum nl80211_attrs - nl80211 netlink attributes
    518  *
    519  * @NL80211_ATTR_UNSPEC: unspecified attribute to catch errors
    520  *
    521  * @NL80211_ATTR_WIPHY: index of wiphy to operate on, cf.
    522  *    /sys/class/ieee80211/<phyname>/index
    523  * @NL80211_ATTR_WIPHY_NAME: wiphy name (used for renaming)
    524  * @NL80211_ATTR_WIPHY_TXQ_PARAMS: a nested array of TX queue parameters
    525  * @NL80211_ATTR_WIPHY_FREQ: frequency of the selected channel in MHz
    526  * @NL80211_ATTR_WIPHY_CHANNEL_TYPE: included with NL80211_ATTR_WIPHY_FREQ
    527  *    if HT20 or HT40 are allowed (i.e., 802.11n disabled if not included):
    528  *    NL80211_CHAN_NO_HT = HT not allowed (i.e., same as not including
    529  *        this attribute)
    530  *    NL80211_CHAN_HT20 = HT20 only
    531  *    NL80211_CHAN_HT40MINUS = secondary channel is below the primary channel
    532  *    NL80211_CHAN_HT40PLUS = secondary channel is above the primary channel
    533  * @NL80211_ATTR_WIPHY_RETRY_SHORT: TX retry limit for frames whose length is
    534  *    less than or equal to the RTS threshold; allowed range: 1..255;
    535  *    dot11ShortRetryLimit; u8
    536  * @NL80211_ATTR_WIPHY_RETRY_LONG: TX retry limit for frames whose length is
    537  *    greater than the RTS threshold; allowed range: 1..255;
    538  *    dot11ShortLongLimit; u8
    539  * @NL80211_ATTR_WIPHY_FRAG_THRESHOLD: fragmentation threshold, i.e., maximum
    540  *    length in octets for frames; allowed range: 256..8000, disable
    541  *    fragmentation with (u32)-1; dot11FragmentationThreshold; u32
    542  * @NL80211_ATTR_WIPHY_RTS_THRESHOLD: RTS threshold (TX frames with length
    543  *    larger than or equal to this use RTS/CTS handshake); allowed range:
    544  *    0..65536, disable with (u32)-1; dot11RTSThreshold; u32
    545  * @NL80211_ATTR_WIPHY_COVERAGE_CLASS: Coverage Class as defined by IEEE 802.11
    546  *    section 7.3.2.9; dot11CoverageClass; u8
    547  *
    548  * @NL80211_ATTR_IFINDEX: network interface index of the device to operate on
    549  * @NL80211_ATTR_IFNAME: network interface name
    550  * @NL80211_ATTR_IFTYPE: type of virtual interface, see &enum nl80211_iftype
    551  *
    552  * @NL80211_ATTR_MAC: MAC address (various uses)
    553  *
    554  * @NL80211_ATTR_KEY_DATA: (temporal) key data; for TKIP this consists of
    555  *    16 bytes encryption key followed by 8 bytes each for TX and RX MIC
    556  *    keys
    557  * @NL80211_ATTR_KEY_IDX: key ID (u8, 0-3)
    558  * @NL80211_ATTR_KEY_CIPHER: key cipher suite (u32, as defined by IEEE 802.11
    559  *    section 7.3.2.25.1, e.g. 0x000FAC04)
    560  * @NL80211_ATTR_KEY_SEQ: transmit key sequence number (IV/PN) for TKIP and
    561  *    CCMP keys, each six bytes in little endian
    562  *
    563  * @NL80211_ATTR_BEACON_INTERVAL: beacon interval in TU
    564  * @NL80211_ATTR_DTIM_PERIOD: DTIM period for beaconing
    565  * @NL80211_ATTR_BEACON_HEAD: portion of the beacon before the TIM IE
    566  * @NL80211_ATTR_BEACON_TAIL: portion of the beacon after the TIM IE
    567  *
    568  * @NL80211_ATTR_STA_AID: Association ID for the station (u16)
    569  * @NL80211_ATTR_STA_FLAGS: flags, nested element with NLA_FLAG attributes of
    570  *    &enum nl80211_sta_flags (deprecated, use %NL80211_ATTR_STA_FLAGS2)
    571  * @NL80211_ATTR_STA_LISTEN_INTERVAL: listen interval as defined by
    572  *    IEEE 802.11 7.3.1.6 (u16).
    573  * @NL80211_ATTR_STA_SUPPORTED_RATES: supported rates, array of supported
    574  *    rates as defined by IEEE 802.11 7.3.2.2 but without the length
    575  *    restriction (at most %NL80211_MAX_SUPP_RATES).
    576  * @NL80211_ATTR_STA_VLAN: interface index of VLAN interface to move station
    577  *    to, or the AP interface the station was originally added to to.
    578  * @NL80211_ATTR_STA_INFO: information about a station, part of station info
    579  *    given for %NL80211_CMD_GET_STATION, nested attribute containing
    580  *    info as possible, see &enum nl80211_sta_info.
    581  *
    582  * @NL80211_ATTR_WIPHY_BANDS: Information about an operating bands,
    583  *    consisting of a nested array.
    584  *
    585  * @NL80211_ATTR_MESH_ID: mesh id (1-32 bytes).
    586  * @NL80211_ATTR_PLINK_ACTION: action to perform on the mesh peer link.
    587  * @NL80211_ATTR_MPATH_NEXT_HOP: MAC address of the next hop for a mesh path.
    588  * @NL80211_ATTR_MPATH_INFO: information about a mesh_path, part of mesh path
    589  *     info given for %NL80211_CMD_GET_MPATH, nested attribute described at
    590  *    &enum nl80211_mpath_info.
    591  *
    592  * @NL80211_ATTR_MNTR_FLAGS: flags, nested element with NLA_FLAG attributes of
    593  *      &enum nl80211_mntr_flags.
    594  *
    595  * @NL80211_ATTR_REG_ALPHA2: an ISO-3166-alpha2 country code for which the
    596  *     current regulatory domain should be set to or is already set to.
    597  *     For example, 'CR', for Costa Rica. This attribute is used by the kernel
    598  *     to query the CRDA to retrieve one regulatory domain. This attribute can
    599  *     also be used by userspace to query the kernel for the currently set
    600  *     regulatory domain. We chose an alpha2 as that is also used by the
    601  *     IEEE-802.11d country information element to identify a country.
    602  *     Users can also simply ask the wireless core to set regulatory domain
    603  *     to a specific alpha2.
    604  * @NL80211_ATTR_REG_RULES: a nested array of regulatory domain regulatory
    605  *    rules.
    606  *
    607  * @NL80211_ATTR_BSS_CTS_PROT: whether CTS protection is enabled (u8, 0 or 1)
    608  * @NL80211_ATTR_BSS_SHORT_PREAMBLE: whether short preamble is enabled
    609  *    (u8, 0 or 1)
    610  * @NL80211_ATTR_BSS_SHORT_SLOT_TIME: whether short slot time enabled
    611  *    (u8, 0 or 1)
    612  * @NL80211_ATTR_BSS_BASIC_RATES: basic rates, array of basic
    613  *    rates in format defined by IEEE 802.11 7.3.2.2 but without the length
    614  *    restriction (at most %NL80211_MAX_SUPP_RATES).
    615  *
    616  * @NL80211_ATTR_HT_CAPABILITY: HT Capability information element (from
    617  *    association request when used with NL80211_CMD_NEW_STATION)
    618  *
    619  * @NL80211_ATTR_SUPPORTED_IFTYPES: nested attribute containing all
    620  *    supported interface types, each a flag attribute with the number
    621  *    of the interface mode.
    622  *
    623  * @NL80211_ATTR_MGMT_SUBTYPE: Management frame subtype for
    624  *    %NL80211_CMD_SET_MGMT_EXTRA_IE.
    625  *
    626  * @NL80211_ATTR_IE: Information element(s) data (used, e.g., with
    627  *    %NL80211_CMD_SET_MGMT_EXTRA_IE).
    628  *
    629  * @NL80211_ATTR_MAX_NUM_SCAN_SSIDS: number of SSIDs you can scan with
    630  *    a single scan request, a wiphy attribute.
    631  * @NL80211_ATTR_MAX_SCAN_IE_LEN: maximum length of information elements
    632  *    that can be added to a scan request
    633  *
    634  * @NL80211_ATTR_SCAN_FREQUENCIES: nested attribute with frequencies (in MHz)
    635  * @NL80211_ATTR_SCAN_SSIDS: nested attribute with SSIDs, leave out for passive
    636  *    scanning and include a zero-length SSID (wildcard) for wildcard scan
    637  * @NL80211_ATTR_BSS: scan result BSS
    638  *
    639  * @NL80211_ATTR_REG_INITIATOR: indicates who requested the regulatory domain
    640  *     currently in effect. This could be any of the %NL80211_REGDOM_SET_BY_*
    641  * @NL80211_ATTR_REG_TYPE: indicates the type of the regulatory domain currently
    642  *     set. This can be one of the nl80211_reg_type (%NL80211_REGDOM_TYPE_*)
    643  *
    644  * @NL80211_ATTR_SUPPORTED_COMMANDS: wiphy attribute that specifies
    645  *    an array of command numbers (i.e. a mapping index to command number)
    646  *    that the driver for the given wiphy supports.
    647  *
    648  * @NL80211_ATTR_FRAME: frame data (binary attribute), including frame header
    649  *    and body, but not FCS; used, e.g., with NL80211_CMD_AUTHENTICATE and
    650  *    NL80211_CMD_ASSOCIATE events
    651  * @NL80211_ATTR_SSID: SSID (binary attribute, 0..32 octets)
    652  * @NL80211_ATTR_AUTH_TYPE: AuthenticationType, see &enum nl80211_auth_type,
    653  *    represented as a u32
    654  * @NL80211_ATTR_REASON_CODE: ReasonCode for %NL80211_CMD_DEAUTHENTICATE and
    655  *    %NL80211_CMD_DISASSOCIATE, u16
    656  *
    657  * @NL80211_ATTR_KEY_TYPE: Key Type, see &enum nl80211_key_type, represented as
    658  *    a u32
    659  *
    660  * @NL80211_ATTR_FREQ_BEFORE: A channel which has suffered a regulatory change
    661  *     due to considerations from a beacon hint. This attribute reflects
    662  *     the state of the channel _before_ the beacon hint processing. This
    663  *     attributes consists of a nested attribute containing
    664  *     NL80211_FREQUENCY_ATTR_*
    665  * @NL80211_ATTR_FREQ_AFTER: A channel which has suffered a regulatory change
    666  *     due to considerations from a beacon hint. This attribute reflects
    667  *     the state of the channel _after_ the beacon hint processing. This
    668  *     attributes consists of a nested attribute containing
    669  *     NL80211_FREQUENCY_ATTR_*
    670  *
    671  * @NL80211_ATTR_CIPHER_SUITES: a set of u32 values indicating the supported
    672  *    cipher suites
    673  *
    674  * @NL80211_ATTR_FREQ_FIXED: a flag indicating the IBSS should not try to look
    675  *    for other networks on different channels
    676  *
    677  * @NL80211_ATTR_TIMED_OUT: a flag indicating than an operation timed out; this
    678  *    is used, e.g., with %NL80211_CMD_AUTHENTICATE event
    679  *
    680  * @NL80211_ATTR_USE_MFP: Whether management frame protection (IEEE 802.11w) is
    681  *    used for the association (&enum nl80211_mfp, represented as a u32);
    682  *    this attribute can be used
    683  *    with %NL80211_CMD_ASSOCIATE request
    684  *
    685  * @NL80211_ATTR_STA_FLAGS2: Attribute containing a
    686  *    &struct nl80211_sta_flag_update.
    687  *
    688  * @NL80211_ATTR_CONTROL_PORT: A flag indicating whether user space controls
    689  *    IEEE 802.1X port, i.e., sets/clears %NL80211_STA_FLAG_AUTHORIZED, in
    690  *    station mode. If the flag is included in %NL80211_CMD_ASSOCIATE
    691  *    request, the driver will assume that the port is unauthorized until
    692  *    authorized by user space. Otherwise, port is marked authorized by
    693  *    default in station mode.
    694  * @NL80211_ATTR_CONTROL_PORT_ETHERTYPE: A 16-bit value indicating the
    695  *    ethertype that will be used for key negotiation. It can be
    696  *    specified with the associate and connect commands. If it is not
    697  *    specified, the value defaults to 0x888E (PAE, 802.1X). This
    698  *    attribute is also used as a flag in the wiphy information to
    699  *    indicate that protocols other than PAE are supported.
    700  * @NL80211_ATTR_CONTROL_PORT_NO_ENCRYPT: When included along with
    701  *    %NL80211_ATTR_CONTROL_PORT_ETHERTYPE, indicates that the custom
    702  *    ethertype frames used for key negotiation must not be encrypted.
    703  *
    704  * @NL80211_ATTR_TESTDATA: Testmode data blob, passed through to the driver.
    705  *    We recommend using nested, driver-specific attributes within this.
    706  *
    707  * @NL80211_ATTR_DISCONNECTED_BY_AP: A flag indicating that the DISCONNECT
    708  *    event was due to the AP disconnecting the station, and not due to
    709  *    a local disconnect request.
    710  * @NL80211_ATTR_STATUS_CODE: StatusCode for the %NL80211_CMD_CONNECT
    711  *    event (u16)
    712  * @NL80211_ATTR_PRIVACY: Flag attribute, used with connect(), indicating
    713  *    that protected APs should be used.
    714  *
    715  * @NL80211_ATTR_CIPHERS_PAIRWISE: Used with CONNECT and ASSOCIATE to
    716  *    indicate which unicast key ciphers will be used with the connection
    717  *    (an array of u32).
    718  * @NL80211_ATTR_CIPHER_GROUP: Used with CONNECT and ASSOCIATE to indicate
    719  *    which group key cipher will be used with the connection (a u32).
    720  * @NL80211_ATTR_WPA_VERSIONS: Used with CONNECT and ASSOCIATE to indicate
    721  *    which WPA version(s) the AP we want to associate with is using
    722  *    (a u32 with flags from &enum nl80211_wpa_versions).
    723  * @NL80211_ATTR_AKM_SUITES: Used with CONNECT and ASSOCIATE to indicate
    724  *    which key management algorithm(s) to use (an array of u32).
    725  *
    726  * @NL80211_ATTR_REQ_IE: (Re)association request information elements as
    727  *    sent out by the card, for ROAM and successful CONNECT events.
    728  * @NL80211_ATTR_RESP_IE: (Re)association response information elements as
    729  *    sent by peer, for ROAM and successful CONNECT events.
    730  *
    731  * @NL80211_ATTR_PREV_BSSID: previous BSSID, to be used by in ASSOCIATE
    732  *    commands to specify using a reassociate frame
    733  *
    734  * @NL80211_ATTR_KEY: key information in a nested attribute with
    735  *    %NL80211_KEY_* sub-attributes
    736  * @NL80211_ATTR_KEYS: array of keys for static WEP keys for connect()
    737  *    and join_ibss(), key information is in a nested attribute each
    738  *    with %NL80211_KEY_* sub-attributes
    739  *
    740  * @NL80211_ATTR_PID: Process ID of a network namespace.
    741  *
    742  * @NL80211_ATTR_GENERATION: Used to indicate consistent snapshots for
    743  *    dumps. This number increases whenever the object list being
    744  *    dumped changes, and as such userspace can verify that it has
    745  *    obtained a complete and consistent snapshot by verifying that
    746  *    all dump messages contain the same generation number. If it
    747  *    changed then the list changed and the dump should be repeated
    748  *    completely from scratch.
    749  *
    750  * @NL80211_ATTR_4ADDR: Use 4-address frames on a virtual interface
    751  *
    752  * @NL80211_ATTR_SURVEY_INFO: survey information about a channel, part of
    753  *      the survey response for %NL80211_CMD_GET_SURVEY, nested attribute
    754  *      containing info as possible, see &enum survey_info.
    755  *
    756  * @NL80211_ATTR_PMKID: PMK material for PMKSA caching.
    757  * @NL80211_ATTR_MAX_NUM_PMKIDS: maximum number of PMKIDs a firmware can
    758  *    cache, a wiphy attribute.
    759  *
    760  * @NL80211_ATTR_DURATION: Duration of an operation in milliseconds, u32.
    761  *
    762  * @NL80211_ATTR_COOKIE: Generic 64-bit cookie to identify objects.
    763  *
    764  * @NL80211_ATTR_TX_RATES: Nested set of attributes
    765  *    (enum nl80211_tx_rate_attributes) describing TX rates per band. The
    766  *    enum nl80211_band value is used as the index (nla_type() of the nested
    767  *    data. If a band is not included, it will be configured to allow all
    768  *    rates based on negotiated supported rates information. This attribute
    769  *    is used with %NL80211_CMD_SET_TX_BITRATE_MASK.
    770  *
    771  * @NL80211_ATTR_FRAME_MATCH: A binary attribute which typically must contain
    772  *    at least one byte, currently used with @NL80211_CMD_REGISTER_FRAME.
    773  * @NL80211_ATTR_FRAME_TYPE: A u16 indicating the frame type/subtype for the
    774  *    @NL80211_CMD_REGISTER_FRAME command.
    775  * @NL80211_ATTR_TX_FRAME_TYPES: wiphy capability attribute, which is a
    776  *    nested attribute of %NL80211_ATTR_FRAME_TYPE attributes, containing
    777  *    information about which frame types can be transmitted with
    778  *    %NL80211_CMD_FRAME.
    779  * @NL80211_ATTR_RX_FRAME_TYPES: wiphy capability attribute, which is a
    780  *    nested attribute of %NL80211_ATTR_FRAME_TYPE attributes, containing
    781  *    information about which frame types can be registered for RX.
    782  *
    783  * @NL80211_ATTR_ACK: Flag attribute indicating that the frame was
    784  *    acknowledged by the recipient.
    785  *
    786  * @NL80211_ATTR_CQM: connection quality monitor configuration in a
    787  *    nested attribute with %NL80211_ATTR_CQM_* sub-attributes.
    788  *
    789  * @NL80211_ATTR_LOCAL_STATE_CHANGE: Flag attribute to indicate that a command
    790  *    is requesting a local authentication/association state change without
    791  *    invoking actual management frame exchange. This can be used with
    792  *    NL80211_CMD_AUTHENTICATE, NL80211_CMD_DEAUTHENTICATE,
    793  *    NL80211_CMD_DISASSOCIATE.
    794  *
    795  * @NL80211_ATTR_AP_ISOLATE: (AP mode) Do not forward traffic between stations
    796  *    connected to this BSS.
    797  *
    798  * @NL80211_ATTR_WIPHY_TX_POWER_SETTING: Transmit power setting type. See
    799  *      &enum nl80211_tx_power_setting for possible values.
    800  * @NL80211_ATTR_WIPHY_TX_POWER_LEVEL: Transmit power level in signed mBm units.
    801  *      This is used in association with @NL80211_ATTR_WIPHY_TX_POWER_SETTING
    802  *      for non-automatic settings.
    803  *
    804  * @NL80211_ATTR_SUPPORT_IBSS_RSN: The device supports IBSS RSN, which mostly
    805  *    means support for per-station GTKs.
    806  *
    807  * @NL80211_ATTR_MAX: highest attribute number currently defined
    808  * @__NL80211_ATTR_AFTER_LAST: internal use
    809  */
    810 enum nl80211_attrs {
    811 /* don't change the order or add anything inbetween, this is ABI! */
    812     NL80211_ATTR_UNSPEC,
    813 
    814     NL80211_ATTR_WIPHY,
    815     NL80211_ATTR_WIPHY_NAME,
    816 
    817     NL80211_ATTR_IFINDEX,
    818     NL80211_ATTR_IFNAME,
    819     NL80211_ATTR_IFTYPE,
    820 
    821     NL80211_ATTR_MAC,
    822 
    823     NL80211_ATTR_KEY_DATA,
    824     NL80211_ATTR_KEY_IDX,
    825     NL80211_ATTR_KEY_CIPHER,
    826     NL80211_ATTR_KEY_SEQ,
    827     NL80211_ATTR_KEY_DEFAULT,
    828 
    829     NL80211_ATTR_BEACON_INTERVAL,
    830     NL80211_ATTR_DTIM_PERIOD,
    831     NL80211_ATTR_BEACON_HEAD,
    832     NL80211_ATTR_BEACON_TAIL,
    833 
    834     NL80211_ATTR_STA_AID,
    835     NL80211_ATTR_STA_FLAGS,
    836     NL80211_ATTR_STA_LISTEN_INTERVAL,
    837     NL80211_ATTR_STA_SUPPORTED_RATES,
    838     NL80211_ATTR_STA_VLAN,
    839     NL80211_ATTR_STA_INFO,
    840 
    841     NL80211_ATTR_WIPHY_BANDS,
    842 
    843     NL80211_ATTR_MNTR_FLAGS,
    844 
    845     NL80211_ATTR_MESH_ID,
    846     NL80211_ATTR_STA_PLINK_ACTION,
    847     NL80211_ATTR_MPATH_NEXT_HOP,
    848     NL80211_ATTR_MPATH_INFO,
    849 
    850     NL80211_ATTR_BSS_CTS_PROT,
    851     NL80211_ATTR_BSS_SHORT_PREAMBLE,
    852     NL80211_ATTR_BSS_SHORT_SLOT_TIME,
    853 
    854     NL80211_ATTR_HT_CAPABILITY,
    855 
    856     NL80211_ATTR_SUPPORTED_IFTYPES,
    857 
    858     NL80211_ATTR_REG_ALPHA2,
    859     NL80211_ATTR_REG_RULES,
    860 
    861     NL80211_ATTR_MESH_PARAMS,
    862 
    863     NL80211_ATTR_BSS_BASIC_RATES,
    864 
    865     NL80211_ATTR_WIPHY_TXQ_PARAMS,
    866     NL80211_ATTR_WIPHY_FREQ,
    867     NL80211_ATTR_WIPHY_CHANNEL_TYPE,
    868 
    869     NL80211_ATTR_KEY_DEFAULT_MGMT,
    870 
    871     NL80211_ATTR_MGMT_SUBTYPE,
    872     NL80211_ATTR_IE,
    873 
    874     NL80211_ATTR_MAX_NUM_SCAN_SSIDS,
    875 
    876     NL80211_ATTR_SCAN_FREQUENCIES,
    877     NL80211_ATTR_SCAN_SSIDS,
    878     NL80211_ATTR_GENERATION, /* replaces old SCAN_GENERATION */
    879     NL80211_ATTR_BSS,
    880 
    881     NL80211_ATTR_REG_INITIATOR,
    882     NL80211_ATTR_REG_TYPE,
    883 
    884     NL80211_ATTR_SUPPORTED_COMMANDS,
    885 
    886     NL80211_ATTR_FRAME,
    887     NL80211_ATTR_SSID,
    888     NL80211_ATTR_AUTH_TYPE,
    889     NL80211_ATTR_REASON_CODE,
    890 
    891     NL80211_ATTR_KEY_TYPE,
    892 
    893     NL80211_ATTR_MAX_SCAN_IE_LEN,
    894     NL80211_ATTR_CIPHER_SUITES,
    895 
    896     NL80211_ATTR_FREQ_BEFORE,
    897     NL80211_ATTR_FREQ_AFTER,
    898 
    899     NL80211_ATTR_FREQ_FIXED,
    900 
    901 
    902     NL80211_ATTR_WIPHY_RETRY_SHORT,
    903     NL80211_ATTR_WIPHY_RETRY_LONG,
    904     NL80211_ATTR_WIPHY_FRAG_THRESHOLD,
    905     NL80211_ATTR_WIPHY_RTS_THRESHOLD,
    906 
    907     NL80211_ATTR_TIMED_OUT,
    908 
    909     NL80211_ATTR_USE_MFP,
    910 
    911     NL80211_ATTR_STA_FLAGS2,
    912 
    913     NL80211_ATTR_CONTROL_PORT,
    914 
    915     NL80211_ATTR_TESTDATA,
    916 
    917     NL80211_ATTR_PRIVACY,
    918 
    919     NL80211_ATTR_DISCONNECTED_BY_AP,
    920     NL80211_ATTR_STATUS_CODE,
    921 
    922     NL80211_ATTR_CIPHER_SUITES_PAIRWISE,
    923     NL80211_ATTR_CIPHER_SUITE_GROUP,
    924     NL80211_ATTR_WPA_VERSIONS,
    925     NL80211_ATTR_AKM_SUITES,
    926 
    927     NL80211_ATTR_REQ_IE,
    928     NL80211_ATTR_RESP_IE,
    929 
    930     NL80211_ATTR_PREV_BSSID,
    931 
    932     NL80211_ATTR_KEY,
    933     NL80211_ATTR_KEYS,
    934 
    935     NL80211_ATTR_PID,
    936 
    937     NL80211_ATTR_4ADDR,
    938 
    939     NL80211_ATTR_SURVEY_INFO,
    940 
    941     NL80211_ATTR_PMKID,
    942     NL80211_ATTR_MAX_NUM_PMKIDS,
    943 
    944     NL80211_ATTR_DURATION,
    945 
    946     NL80211_ATTR_COOKIE,
    947 
    948     NL80211_ATTR_WIPHY_COVERAGE_CLASS,
    949 
    950     NL80211_ATTR_TX_RATES,
    951 
    952     NL80211_ATTR_FRAME_MATCH,
    953 
    954     NL80211_ATTR_ACK,
    955 
    956     NL80211_ATTR_PS_STATE,
    957 
    958     NL80211_ATTR_CQM,
    959 
    960     NL80211_ATTR_LOCAL_STATE_CHANGE,
    961 
    962     NL80211_ATTR_AP_ISOLATE,
    963 
    964     NL80211_ATTR_WIPHY_TX_POWER_SETTING,
    965     NL80211_ATTR_WIPHY_TX_POWER_LEVEL,
    966 
    967     NL80211_ATTR_TX_FRAME_TYPES,
    968     NL80211_ATTR_RX_FRAME_TYPES,
    969     NL80211_ATTR_FRAME_TYPE,
    970 
    971     NL80211_ATTR_CONTROL_PORT_ETHERTYPE,
    972     NL80211_ATTR_CONTROL_PORT_NO_ENCRYPT,
    973 
    974     NL80211_ATTR_SUPPORT_IBSS_RSN,
    975 
    976     /* add attributes here, update the policy in nl80211.c */
    977 
    978     __NL80211_ATTR_AFTER_LAST,
    979     NL80211_ATTR_MAX = __NL80211_ATTR_AFTER_LAST - 1
    980 };
    981 
    982 /* source-level API compatibility */
    983 #define NL80211_ATTR_SCAN_GENERATION NL80211_ATTR_GENERATION
    984 
    985 /*
    986  * Allow user space programs to use #ifdef on new attributes by defining them
    987  * here
    988  */
    989 #define NL80211_CMD_CONNECT NL80211_CMD_CONNECT
    990 #define NL80211_ATTR_HT_CAPABILITY NL80211_ATTR_HT_CAPABILITY
    991 #define NL80211_ATTR_BSS_BASIC_RATES NL80211_ATTR_BSS_BASIC_RATES
    992 #define NL80211_ATTR_WIPHY_TXQ_PARAMS NL80211_ATTR_WIPHY_TXQ_PARAMS
    993 #define NL80211_ATTR_WIPHY_FREQ NL80211_ATTR_WIPHY_FREQ
    994 #define NL80211_ATTR_WIPHY_CHANNEL_TYPE NL80211_ATTR_WIPHY_CHANNEL_TYPE
    995 #define NL80211_ATTR_MGMT_SUBTYPE NL80211_ATTR_MGMT_SUBTYPE
    996 #define NL80211_ATTR_IE NL80211_ATTR_IE
    997 #define NL80211_ATTR_REG_INITIATOR NL80211_ATTR_REG_INITIATOR
    998 #define NL80211_ATTR_REG_TYPE NL80211_ATTR_REG_TYPE
    999 #define NL80211_ATTR_FRAME NL80211_ATTR_FRAME
   1000 #define NL80211_ATTR_SSID NL80211_ATTR_SSID
   1001 #define NL80211_ATTR_AUTH_TYPE NL80211_ATTR_AUTH_TYPE
   1002 #define NL80211_ATTR_REASON_CODE NL80211_ATTR_REASON_CODE
   1003 #define NL80211_ATTR_CIPHER_SUITES_PAIRWISE NL80211_ATTR_CIPHER_SUITES_PAIRWISE
   1004 #define NL80211_ATTR_CIPHER_SUITE_GROUP NL80211_ATTR_CIPHER_SUITE_GROUP
   1005 #define NL80211_ATTR_WPA_VERSIONS NL80211_ATTR_WPA_VERSIONS
   1006 #define NL80211_ATTR_AKM_SUITES NL80211_ATTR_AKM_SUITES
   1007 #define NL80211_ATTR_KEY NL80211_ATTR_KEY
   1008 #define NL80211_ATTR_KEYS NL80211_ATTR_KEYS
   1009 
   1010 #define NL80211_MAX_SUPP_RATES            32
   1011 #define NL80211_MAX_SUPP_REG_RULES        32
   1012 #define NL80211_TKIP_DATA_OFFSET_ENCR_KEY    0
   1013 #define NL80211_TKIP_DATA_OFFSET_TX_MIC_KEY    16
   1014 #define NL80211_TKIP_DATA_OFFSET_RX_MIC_KEY    24
   1015 #define NL80211_HT_CAPABILITY_LEN        26
   1016 
   1017 #define NL80211_MAX_NR_CIPHER_SUITES        5
   1018 #define NL80211_MAX_NR_AKM_SUITES        2
   1019 
   1020 /**
   1021  * enum nl80211_iftype - (virtual) interface types
   1022  *
   1023  * @NL80211_IFTYPE_UNSPECIFIED: unspecified type, driver decides
   1024  * @NL80211_IFTYPE_ADHOC: independent BSS member
   1025  * @NL80211_IFTYPE_STATION: managed BSS member
   1026  * @NL80211_IFTYPE_AP: access point
   1027  * @NL80211_IFTYPE_AP_VLAN: VLAN interface for access points
   1028  * @NL80211_IFTYPE_WDS: wireless distribution interface
   1029  * @NL80211_IFTYPE_MONITOR: monitor interface receiving all frames
   1030  * @NL80211_IFTYPE_MESH_POINT: mesh point
   1031  * @NL80211_IFTYPE_P2P_CLIENT: P2P client
   1032  * @NL80211_IFTYPE_P2P_GO: P2P group owner
   1033  * @NL80211_IFTYPE_MAX: highest interface type number currently defined
   1034  * @NUM_NL80211_IFTYPES: number of defined interface types
   1035  *
   1036  * These values are used with the %NL80211_ATTR_IFTYPE
   1037  * to set the type of an interface.
   1038  *
   1039  */
   1040 enum nl80211_iftype {
   1041     NL80211_IFTYPE_UNSPECIFIED,
   1042     NL80211_IFTYPE_ADHOC,
   1043     NL80211_IFTYPE_STATION,
   1044     NL80211_IFTYPE_AP,
   1045     NL80211_IFTYPE_AP_VLAN,
   1046     NL80211_IFTYPE_WDS,
   1047     NL80211_IFTYPE_MONITOR,
   1048     NL80211_IFTYPE_MESH_POINT,
   1049     NL80211_IFTYPE_P2P_CLIENT,
   1050     NL80211_IFTYPE_P2P_GO,
   1051 
   1052     /* keep last */
   1053     NUM_NL80211_IFTYPES,
   1054     NL80211_IFTYPE_MAX = NUM_NL80211_IFTYPES - 1
   1055 };
   1056 
   1057 /**
   1058  * enum nl80211_sta_flags - station flags
   1059  *
   1060  * Station flags. When a station is added to an AP interface, it is
   1061  * assumed to be already associated (and hence authenticated.)
   1062  *
   1063  * @__NL80211_STA_FLAG_INVALID: attribute number 0 is reserved
   1064  * @NL80211_STA_FLAG_AUTHORIZED: station is authorized (802.1X)
   1065  * @NL80211_STA_FLAG_SHORT_PREAMBLE: station is capable of receiving frames
   1066  *    with short barker preamble
   1067  * @NL80211_STA_FLAG_WME: station is WME/QoS capable
   1068  * @NL80211_STA_FLAG_MFP: station uses management frame protection
   1069  * @NL80211_STA_FLAG_MAX: highest station flag number currently defined
   1070  * @__NL80211_STA_FLAG_AFTER_LAST: internal use
   1071  */
   1072 enum nl80211_sta_flags {
   1073     __NL80211_STA_FLAG_INVALID,
   1074     NL80211_STA_FLAG_AUTHORIZED,
   1075     NL80211_STA_FLAG_SHORT_PREAMBLE,
   1076     NL80211_STA_FLAG_WME,
   1077     NL80211_STA_FLAG_MFP,
   1078 
   1079     /* keep last */
   1080     __NL80211_STA_FLAG_AFTER_LAST,
   1081     NL80211_STA_FLAG_MAX = __NL80211_STA_FLAG_AFTER_LAST - 1
   1082 };
   1083 
   1084 /**
   1085  * struct nl80211_sta_flag_update - station flags mask/set
   1086  * @mask: mask of station flags to set
   1087  * @set: which values to set them to
   1088  *
   1089  * Both mask and set contain bits as per &enum nl80211_sta_flags.
   1090  */
   1091 struct nl80211_sta_flag_update {
   1092     __u32 mask;
   1093     __u32 set;
   1094 } __attribute__((packed));
   1095 
   1096 /**
   1097  * enum nl80211_rate_info - bitrate information
   1098  *
   1099  * These attribute types are used with %NL80211_STA_INFO_TXRATE
   1100  * when getting information about the bitrate of a station.
   1101  *
   1102  * @__NL80211_RATE_INFO_INVALID: attribute number 0 is reserved
   1103  * @NL80211_RATE_INFO_BITRATE: total bitrate (u16, 100kbit/s)
   1104  * @NL80211_RATE_INFO_MCS: mcs index for 802.11n (u8)
   1105  * @NL80211_RATE_INFO_40_MHZ_WIDTH: 40 Mhz dualchannel bitrate
   1106  * @NL80211_RATE_INFO_SHORT_GI: 400ns guard interval
   1107  * @NL80211_RATE_INFO_MAX: highest rate_info number currently defined
   1108  * @__NL80211_RATE_INFO_AFTER_LAST: internal use
   1109  */
   1110 enum nl80211_rate_info {
   1111     __NL80211_RATE_INFO_INVALID,
   1112     NL80211_RATE_INFO_BITRATE,
   1113     NL80211_RATE_INFO_MCS,
   1114     NL80211_RATE_INFO_40_MHZ_WIDTH,
   1115     NL80211_RATE_INFO_SHORT_GI,
   1116 
   1117     /* keep last */
   1118     __NL80211_RATE_INFO_AFTER_LAST,
   1119     NL80211_RATE_INFO_MAX = __NL80211_RATE_INFO_AFTER_LAST - 1
   1120 };
   1121 
   1122 /**
   1123  * enum nl80211_sta_info - station information
   1124  *
   1125  * These attribute types are used with %NL80211_ATTR_STA_INFO
   1126  * when getting information about a station.
   1127  *
   1128  * @__NL80211_STA_INFO_INVALID: attribute number 0 is reserved
   1129  * @NL80211_STA_INFO_INACTIVE_TIME: time since last activity (u32, msecs)
   1130  * @NL80211_STA_INFO_RX_BYTES: total received bytes (u32, from this station)
   1131  * @NL80211_STA_INFO_TX_BYTES: total transmitted bytes (u32, to this station)
   1132  * @__NL80211_STA_INFO_AFTER_LAST: internal
   1133  * @NL80211_STA_INFO_MAX: highest possible station info attribute
   1134  * @NL80211_STA_INFO_SIGNAL: signal strength of last received PPDU (u8, dBm)
   1135  * @NL80211_STA_INFO_TX_BITRATE: current unicast tx rate, nested attribute
   1136  *     containing info as possible, see &enum nl80211_sta_info_txrate.
   1137  * @NL80211_STA_INFO_RX_PACKETS: total received packet (u32, from this station)
   1138  * @NL80211_STA_INFO_TX_PACKETS: total transmitted packets (u32, to this
   1139  *    station)
   1140  * @NL80211_STA_INFO_TX_RETRIES: total retries (u32, to this station)
   1141  * @NL80211_STA_INFO_TX_FAILED: total failed packets (u32, to this station)
   1142  */
   1143 enum nl80211_sta_info {
   1144     __NL80211_STA_INFO_INVALID,
   1145     NL80211_STA_INFO_INACTIVE_TIME,
   1146     NL80211_STA_INFO_RX_BYTES,
   1147     NL80211_STA_INFO_TX_BYTES,
   1148     NL80211_STA_INFO_LLID,
   1149     NL80211_STA_INFO_PLID,
   1150     NL80211_STA_INFO_PLINK_STATE,
   1151     NL80211_STA_INFO_SIGNAL,
   1152     NL80211_STA_INFO_TX_BITRATE,
   1153     NL80211_STA_INFO_RX_PACKETS,
   1154     NL80211_STA_INFO_TX_PACKETS,
   1155     NL80211_STA_INFO_TX_RETRIES,
   1156     NL80211_STA_INFO_TX_FAILED,
   1157 
   1158     /* keep last */
   1159     __NL80211_STA_INFO_AFTER_LAST,
   1160     NL80211_STA_INFO_MAX = __NL80211_STA_INFO_AFTER_LAST - 1
   1161 };
   1162 
   1163 /**
   1164  * enum nl80211_mpath_flags - nl80211 mesh path flags
   1165  *
   1166  * @NL80211_MPATH_FLAG_ACTIVE: the mesh path is active
   1167  * @NL80211_MPATH_FLAG_RESOLVING: the mesh path discovery process is running
   1168  * @NL80211_MPATH_FLAG_SN_VALID: the mesh path contains a valid SN
   1169  * @NL80211_MPATH_FLAG_FIXED: the mesh path has been manually set
   1170  * @NL80211_MPATH_FLAG_RESOLVED: the mesh path discovery process succeeded
   1171  */
   1172 enum nl80211_mpath_flags {
   1173     NL80211_MPATH_FLAG_ACTIVE =    1<<0,
   1174     NL80211_MPATH_FLAG_RESOLVING =    1<<1,
   1175     NL80211_MPATH_FLAG_SN_VALID =    1<<2,
   1176     NL80211_MPATH_FLAG_FIXED =    1<<3,
   1177     NL80211_MPATH_FLAG_RESOLVED =    1<<4,
   1178 };
   1179 
   1180 /**
   1181  * enum nl80211_mpath_info - mesh path information
   1182  *
   1183  * These attribute types are used with %NL80211_ATTR_MPATH_INFO when getting
   1184  * information about a mesh path.
   1185  *
   1186  * @__NL80211_MPATH_INFO_INVALID: attribute number 0 is reserved
   1187  * @NL80211_MPATH_INFO_FRAME_QLEN: number of queued frames for this destination
   1188  * @NL80211_MPATH_INFO_SN: destination sequence number
   1189  * @NL80211_MPATH_INFO_METRIC: metric (cost) of this mesh path
   1190  * @NL80211_MPATH_INFO_EXPTIME: expiration time for the path, in msec from now
   1191  * @NL80211_MPATH_INFO_FLAGS: mesh path flags, enumerated in
   1192  *     &enum nl80211_mpath_flags;
   1193  * @NL80211_MPATH_INFO_DISCOVERY_TIMEOUT: total path discovery timeout, in msec
   1194  * @NL80211_MPATH_INFO_DISCOVERY_RETRIES: mesh path discovery retries
   1195  * @NL80211_MPATH_INFO_MAX: highest mesh path information attribute number
   1196  *    currently defind
   1197  * @__NL80211_MPATH_INFO_AFTER_LAST: internal use
   1198  */
   1199 enum nl80211_mpath_info {
   1200     __NL80211_MPATH_INFO_INVALID,
   1201     NL80211_MPATH_INFO_FRAME_QLEN,
   1202     NL80211_MPATH_INFO_SN,
   1203     NL80211_MPATH_INFO_METRIC,
   1204     NL80211_MPATH_INFO_EXPTIME,
   1205     NL80211_MPATH_INFO_FLAGS,
   1206     NL80211_MPATH_INFO_DISCOVERY_TIMEOUT,
   1207     NL80211_MPATH_INFO_DISCOVERY_RETRIES,
   1208 
   1209     /* keep last */
   1210     __NL80211_MPATH_INFO_AFTER_LAST,
   1211     NL80211_MPATH_INFO_MAX = __NL80211_MPATH_INFO_AFTER_LAST - 1
   1212 };
   1213 
   1214 /**
   1215  * enum nl80211_band_attr - band attributes
   1216  * @__NL80211_BAND_ATTR_INVALID: attribute number 0 is reserved
   1217  * @NL80211_BAND_ATTR_FREQS: supported frequencies in this band,
   1218  *    an array of nested frequency attributes
   1219  * @NL80211_BAND_ATTR_RATES: supported bitrates in this band,
   1220  *    an array of nested bitrate attributes
   1221  * @NL80211_BAND_ATTR_HT_MCS_SET: 16-byte attribute containing the MCS set as
   1222  *    defined in 802.11n
   1223  * @NL80211_BAND_ATTR_HT_CAPA: HT capabilities, as in the HT information IE
   1224  * @NL80211_BAND_ATTR_HT_AMPDU_FACTOR: A-MPDU factor, as in 11n
   1225  * @NL80211_BAND_ATTR_HT_AMPDU_DENSITY: A-MPDU density, as in 11n
   1226  * @NL80211_BAND_ATTR_MAX: highest band attribute currently defined
   1227  * @__NL80211_BAND_ATTR_AFTER_LAST: internal use
   1228  */
   1229 enum nl80211_band_attr {
   1230     __NL80211_BAND_ATTR_INVALID,
   1231     NL80211_BAND_ATTR_FREQS,
   1232     NL80211_BAND_ATTR_RATES,
   1233 
   1234     NL80211_BAND_ATTR_HT_MCS_SET,
   1235     NL80211_BAND_ATTR_HT_CAPA,
   1236     NL80211_BAND_ATTR_HT_AMPDU_FACTOR,
   1237     NL80211_BAND_ATTR_HT_AMPDU_DENSITY,
   1238 
   1239     /* keep last */
   1240     __NL80211_BAND_ATTR_AFTER_LAST,
   1241     NL80211_BAND_ATTR_MAX = __NL80211_BAND_ATTR_AFTER_LAST - 1
   1242 };
   1243 
   1244 #define NL80211_BAND_ATTR_HT_CAPA NL80211_BAND_ATTR_HT_CAPA
   1245 
   1246 /**
   1247  * enum nl80211_frequency_attr - frequency attributes
   1248  * @__NL80211_FREQUENCY_ATTR_INVALID: attribute number 0 is reserved
   1249  * @NL80211_FREQUENCY_ATTR_FREQ: Frequency in MHz
   1250  * @NL80211_FREQUENCY_ATTR_DISABLED: Channel is disabled in current
   1251  *    regulatory domain.
   1252  * @NL80211_FREQUENCY_ATTR_PASSIVE_SCAN: Only passive scanning is
   1253  *    permitted on this channel in current regulatory domain.
   1254  * @NL80211_FREQUENCY_ATTR_NO_IBSS: IBSS networks are not permitted
   1255  *    on this channel in current regulatory domain.
   1256  * @NL80211_FREQUENCY_ATTR_RADAR: Radar detection is mandatory
   1257  *    on this channel in current regulatory domain.
   1258  * @NL80211_FREQUENCY_ATTR_MAX_TX_POWER: Maximum transmission power in mBm
   1259  *    (100 * dBm).
   1260  * @NL80211_FREQUENCY_ATTR_MAX: highest frequency attribute number
   1261  *    currently defined
   1262  * @__NL80211_FREQUENCY_ATTR_AFTER_LAST: internal use
   1263  */
   1264 enum nl80211_frequency_attr {
   1265     __NL80211_FREQUENCY_ATTR_INVALID,
   1266     NL80211_FREQUENCY_ATTR_FREQ,
   1267     NL80211_FREQUENCY_ATTR_DISABLED,
   1268     NL80211_FREQUENCY_ATTR_PASSIVE_SCAN,
   1269     NL80211_FREQUENCY_ATTR_NO_IBSS,
   1270     NL80211_FREQUENCY_ATTR_RADAR,
   1271     NL80211_FREQUENCY_ATTR_MAX_TX_POWER,
   1272 
   1273     /* keep last */
   1274     __NL80211_FREQUENCY_ATTR_AFTER_LAST,
   1275     NL80211_FREQUENCY_ATTR_MAX = __NL80211_FREQUENCY_ATTR_AFTER_LAST - 1
   1276 };
   1277 
   1278 #define NL80211_FREQUENCY_ATTR_MAX_TX_POWER NL80211_FREQUENCY_ATTR_MAX_TX_POWER
   1279 
   1280 /**
   1281  * enum nl80211_bitrate_attr - bitrate attributes
   1282  * @__NL80211_BITRATE_ATTR_INVALID: attribute number 0 is reserved
   1283  * @NL80211_BITRATE_ATTR_RATE: Bitrate in units of 100 kbps
   1284  * @NL80211_BITRATE_ATTR_2GHZ_SHORTPREAMBLE: Short preamble supported
   1285  *    in 2.4 GHz band.
   1286  * @NL80211_BITRATE_ATTR_MAX: highest bitrate attribute number
   1287  *    currently defined
   1288  * @__NL80211_BITRATE_ATTR_AFTER_LAST: internal use
   1289  */
   1290 enum nl80211_bitrate_attr {
   1291     __NL80211_BITRATE_ATTR_INVALID,
   1292     NL80211_BITRATE_ATTR_RATE,
   1293     NL80211_BITRATE_ATTR_2GHZ_SHORTPREAMBLE,
   1294 
   1295     /* keep last */
   1296     __NL80211_BITRATE_ATTR_AFTER_LAST,
   1297     NL80211_BITRATE_ATTR_MAX = __NL80211_BITRATE_ATTR_AFTER_LAST - 1
   1298 };
   1299 
   1300 /**
   1301  * enum nl80211_initiator - Indicates the initiator of a reg domain request
   1302  * @NL80211_REGDOM_SET_BY_CORE: Core queried CRDA for a dynamic world
   1303  *     regulatory domain.
   1304  * @NL80211_REGDOM_SET_BY_USER: User asked the wireless core to set the
   1305  *     regulatory domain.
   1306  * @NL80211_REGDOM_SET_BY_DRIVER: a wireless drivers has hinted to the
   1307  *     wireless core it thinks its knows the regulatory domain we should be in.
   1308  * @NL80211_REGDOM_SET_BY_COUNTRY_IE: the wireless core has received an
   1309  *     802.11 country information element with regulatory information it
   1310  *     thinks we should consider.
   1311  */
   1312 enum nl80211_reg_initiator {
   1313     NL80211_REGDOM_SET_BY_CORE,
   1314     NL80211_REGDOM_SET_BY_USER,
   1315     NL80211_REGDOM_SET_BY_DRIVER,
   1316     NL80211_REGDOM_SET_BY_COUNTRY_IE,
   1317 };
   1318 
   1319 /**
   1320  * enum nl80211_reg_type - specifies the type of regulatory domain
   1321  * @NL80211_REGDOM_TYPE_COUNTRY: the regulatory domain set is one that pertains
   1322  *    to a specific country. When this is set you can count on the
   1323  *    ISO / IEC 3166 alpha2 country code being valid.
   1324  * @NL80211_REGDOM_TYPE_WORLD: the regulatory set domain is the world regulatory
   1325  *     domain.
   1326  * @NL80211_REGDOM_TYPE_CUSTOM_WORLD: the regulatory domain set is a custom
   1327  *     driver specific world regulatory domain. These do not apply system-wide
   1328  *     and are only applicable to the individual devices which have requested
   1329  *     them to be applied.
   1330  * @NL80211_REGDOM_TYPE_INTERSECTION: the regulatory domain set is the product
   1331  *    of an intersection between two regulatory domains -- the previously
   1332  *    set regulatory domain on the system and the last accepted regulatory
   1333  *    domain request to be processed.
   1334  */
   1335 enum nl80211_reg_type {
   1336     NL80211_REGDOM_TYPE_COUNTRY,
   1337     NL80211_REGDOM_TYPE_WORLD,
   1338     NL80211_REGDOM_TYPE_CUSTOM_WORLD,
   1339     NL80211_REGDOM_TYPE_INTERSECTION,
   1340 };
   1341 
   1342 /**
   1343  * enum nl80211_reg_rule_attr - regulatory rule attributes
   1344  * @__NL80211_REG_RULE_ATTR_INVALID: attribute number 0 is reserved
   1345  * @NL80211_ATTR_REG_RULE_FLAGS: a set of flags which specify additional
   1346  *     considerations for a given frequency range. These are the
   1347  *     &enum nl80211_reg_rule_flags.
   1348  * @NL80211_ATTR_FREQ_RANGE_START: starting frequencry for the regulatory
   1349  *     rule in KHz. This is not a center of frequency but an actual regulatory
   1350  *     band edge.
   1351  * @NL80211_ATTR_FREQ_RANGE_END: ending frequency for the regulatory rule
   1352  *     in KHz. This is not a center a frequency but an actual regulatory
   1353  *     band edge.
   1354  * @NL80211_ATTR_FREQ_RANGE_MAX_BW: maximum allowed bandwidth for this
   1355  *     frequency range, in KHz.
   1356  * @NL80211_ATTR_POWER_RULE_MAX_ANT_GAIN: the maximum allowed antenna gain
   1357  *     for a given frequency range. The value is in mBi (100 * dBi).
   1358  *     If you don't have one then don't send this.
   1359  * @NL80211_ATTR_POWER_RULE_MAX_EIRP: the maximum allowed EIRP for
   1360  *     a given frequency range. The value is in mBm (100 * dBm).
   1361  * @NL80211_REG_RULE_ATTR_MAX: highest regulatory rule attribute number
   1362  *    currently defined
   1363  * @__NL80211_REG_RULE_ATTR_AFTER_LAST: internal use
   1364  */
   1365 enum nl80211_reg_rule_attr {
   1366     __NL80211_REG_RULE_ATTR_INVALID,
   1367     NL80211_ATTR_REG_RULE_FLAGS,
   1368 
   1369     NL80211_ATTR_FREQ_RANGE_START,
   1370     NL80211_ATTR_FREQ_RANGE_END,
   1371     NL80211_ATTR_FREQ_RANGE_MAX_BW,
   1372 
   1373     NL80211_ATTR_POWER_RULE_MAX_ANT_GAIN,
   1374     NL80211_ATTR_POWER_RULE_MAX_EIRP,
   1375 
   1376     /* keep last */
   1377     __NL80211_REG_RULE_ATTR_AFTER_LAST,
   1378     NL80211_REG_RULE_ATTR_MAX = __NL80211_REG_RULE_ATTR_AFTER_LAST - 1
   1379 };
   1380 
   1381 /**
   1382  * enum nl80211_reg_rule_flags - regulatory rule flags
   1383  *
   1384  * @NL80211_RRF_NO_OFDM: OFDM modulation not allowed
   1385  * @NL80211_RRF_NO_CCK: CCK modulation not allowed
   1386  * @NL80211_RRF_NO_INDOOR: indoor operation not allowed
   1387  * @NL80211_RRF_NO_OUTDOOR: outdoor operation not allowed
   1388  * @NL80211_RRF_DFS: DFS support is required to be used
   1389  * @NL80211_RRF_PTP_ONLY: this is only for Point To Point links
   1390  * @NL80211_RRF_PTMP_ONLY: this is only for Point To Multi Point links
   1391  * @NL80211_RRF_PASSIVE_SCAN: passive scan is required
   1392  * @NL80211_RRF_NO_IBSS: no IBSS is allowed
   1393  */
   1394 enum nl80211_reg_rule_flags {
   1395     NL80211_RRF_NO_OFDM        = 1<<0,
   1396     NL80211_RRF_NO_CCK        = 1<<1,
   1397     NL80211_RRF_NO_INDOOR        = 1<<2,
   1398     NL80211_RRF_NO_OUTDOOR        = 1<<3,
   1399     NL80211_RRF_DFS            = 1<<4,
   1400     NL80211_RRF_PTP_ONLY        = 1<<5,
   1401     NL80211_RRF_PTMP_ONLY        = 1<<6,
   1402     NL80211_RRF_PASSIVE_SCAN    = 1<<7,
   1403     NL80211_RRF_NO_IBSS        = 1<<8,
   1404 };
   1405 
   1406 /**
   1407  * enum nl80211_survey_info - survey information
   1408  *
   1409  * These attribute types are used with %NL80211_ATTR_SURVEY_INFO
   1410  * when getting information about a survey.
   1411  *
   1412  * @__NL80211_SURVEY_INFO_INVALID: attribute number 0 is reserved
   1413  * @NL80211_SURVEY_INFO_FREQUENCY: center frequency of channel
   1414  * @NL80211_SURVEY_INFO_NOISE: noise level of channel (u8, dBm)
   1415  * @NL80211_SURVEY_INFO_IN_USE: channel is currently being used
   1416  * @NL80211_SURVEY_INFO_MAX: highest survey info attribute number
   1417  *    currently defined
   1418  * @__NL80211_SURVEY_INFO_AFTER_LAST: internal use
   1419  */
   1420 enum nl80211_survey_info {
   1421     __NL80211_SURVEY_INFO_INVALID,
   1422     NL80211_SURVEY_INFO_FREQUENCY,
   1423     NL80211_SURVEY_INFO_NOISE,
   1424     NL80211_SURVEY_INFO_IN_USE,
   1425 
   1426     /* keep last */
   1427     __NL80211_SURVEY_INFO_AFTER_LAST,
   1428     NL80211_SURVEY_INFO_MAX = __NL80211_SURVEY_INFO_AFTER_LAST - 1
   1429 };
   1430 
   1431 /**
   1432  * enum nl80211_mntr_flags - monitor configuration flags
   1433  *
   1434  * Monitor configuration flags.
   1435  *
   1436  * @__NL80211_MNTR_FLAG_INVALID: reserved
   1437  *
   1438  * @NL80211_MNTR_FLAG_FCSFAIL: pass frames with bad FCS
   1439  * @NL80211_MNTR_FLAG_PLCPFAIL: pass frames with bad PLCP
   1440  * @NL80211_MNTR_FLAG_CONTROL: pass control frames
   1441  * @NL80211_MNTR_FLAG_OTHER_BSS: disable BSSID filtering
   1442  * @NL80211_MNTR_FLAG_COOK_FRAMES: report frames after processing.
   1443  *    overrides all other flags.
   1444  *
   1445  * @__NL80211_MNTR_FLAG_AFTER_LAST: internal use
   1446  * @NL80211_MNTR_FLAG_MAX: highest possible monitor flag
   1447  */
   1448 enum nl80211_mntr_flags {
   1449     __NL80211_MNTR_FLAG_INVALID,
   1450     NL80211_MNTR_FLAG_FCSFAIL,
   1451     NL80211_MNTR_FLAG_PLCPFAIL,
   1452     NL80211_MNTR_FLAG_CONTROL,
   1453     NL80211_MNTR_FLAG_OTHER_BSS,
   1454     NL80211_MNTR_FLAG_COOK_FRAMES,
   1455 
   1456     /* keep last */
   1457     __NL80211_MNTR_FLAG_AFTER_LAST,
   1458     NL80211_MNTR_FLAG_MAX = __NL80211_MNTR_FLAG_AFTER_LAST - 1
   1459 };
   1460 
   1461 /**
   1462  * enum nl80211_meshconf_params - mesh configuration parameters
   1463  *
   1464  * Mesh configuration parameters
   1465  *
   1466  * @__NL80211_MESHCONF_INVALID: internal use
   1467  *
   1468  * @NL80211_MESHCONF_RETRY_TIMEOUT: specifies the initial retry timeout in
   1469  * millisecond units, used by the Peer Link Open message
   1470  *
   1471  * @NL80211_MESHCONF_CONFIRM_TIMEOUT: specifies the inital confirm timeout, in
   1472  * millisecond units, used by the peer link management to close a peer link
   1473  *
   1474  * @NL80211_MESHCONF_HOLDING_TIMEOUT: specifies the holding timeout, in
   1475  * millisecond units
   1476  *
   1477  * @NL80211_MESHCONF_MAX_PEER_LINKS: maximum number of peer links allowed
   1478  * on this mesh interface
   1479  *
   1480  * @NL80211_MESHCONF_MAX_RETRIES: specifies the maximum number of peer link
   1481  * open retries that can be sent to establish a new peer link instance in a
   1482  * mesh
   1483  *
   1484  * @NL80211_MESHCONF_TTL: specifies the value of TTL field set at a source mesh
   1485  * point.
   1486  *
   1487  * @NL80211_MESHCONF_AUTO_OPEN_PLINKS: whether we should automatically
   1488  * open peer links when we detect compatible mesh peers.
   1489  *
   1490  * @NL80211_MESHCONF_HWMP_MAX_PREQ_RETRIES: the number of action frames
   1491  * containing a PREQ that an MP can send to a particular destination (path
   1492  * target)
   1493  *
   1494  * @NL80211_MESHCONF_PATH_REFRESH_TIME: how frequently to refresh mesh paths
   1495  * (in milliseconds)
   1496  *
   1497  * @NL80211_MESHCONF_MIN_DISCOVERY_TIMEOUT: minimum length of time to wait
   1498  * until giving up on a path discovery (in milliseconds)
   1499  *
   1500  * @NL80211_MESHCONF_HWMP_ACTIVE_PATH_TIMEOUT: The time (in TUs) for which mesh
   1501  * points receiving a PREQ shall consider the forwarding information from the
   1502  * root to be valid. (TU = time unit)
   1503  *
   1504  * @NL80211_MESHCONF_HWMP_PREQ_MIN_INTERVAL: The minimum interval of time (in
   1505  * TUs) during which an MP can send only one action frame containing a PREQ
   1506  * reference element
   1507  *
   1508  * @NL80211_MESHCONF_HWMP_NET_DIAM_TRVS_TIME: The interval of time (in TUs)
   1509  * that it takes for an HWMP information element to propagate across the mesh
   1510  *
   1511  * @NL80211_MESHCONF_ROOTMODE: whether root mode is enabled or not
   1512  *
   1513  * @NL80211_MESHCONF_ATTR_MAX: highest possible mesh configuration attribute
   1514  *
   1515  * @__NL80211_MESHCONF_ATTR_AFTER_LAST: internal use
   1516  */
   1517 enum nl80211_meshconf_params {
   1518     __NL80211_MESHCONF_INVALID,
   1519     NL80211_MESHCONF_RETRY_TIMEOUT,
   1520     NL80211_MESHCONF_CONFIRM_TIMEOUT,
   1521     NL80211_MESHCONF_HOLDING_TIMEOUT,
   1522     NL80211_MESHCONF_MAX_PEER_LINKS,
   1523     NL80211_MESHCONF_MAX_RETRIES,
   1524     NL80211_MESHCONF_TTL,
   1525     NL80211_MESHCONF_AUTO_OPEN_PLINKS,
   1526     NL80211_MESHCONF_HWMP_MAX_PREQ_RETRIES,
   1527     NL80211_MESHCONF_PATH_REFRESH_TIME,
   1528     NL80211_MESHCONF_MIN_DISCOVERY_TIMEOUT,
   1529     NL80211_MESHCONF_HWMP_ACTIVE_PATH_TIMEOUT,
   1530     NL80211_MESHCONF_HWMP_PREQ_MIN_INTERVAL,
   1531     NL80211_MESHCONF_HWMP_NET_DIAM_TRVS_TIME,
   1532     NL80211_MESHCONF_HWMP_ROOTMODE,
   1533 
   1534     /* keep last */
   1535     __NL80211_MESHCONF_ATTR_AFTER_LAST,
   1536     NL80211_MESHCONF_ATTR_MAX = __NL80211_MESHCONF_ATTR_AFTER_LAST - 1
   1537 };
   1538 
   1539 /**
   1540  * enum nl80211_txq_attr - TX queue parameter attributes
   1541  * @__NL80211_TXQ_ATTR_INVALID: Attribute number 0 is reserved
   1542  * @NL80211_TXQ_ATTR_QUEUE: TX queue identifier (NL80211_TXQ_Q_*)
   1543  * @NL80211_TXQ_ATTR_TXOP: Maximum burst time in units of 32 usecs, 0 meaning
   1544  *    disabled
   1545  * @NL80211_TXQ_ATTR_CWMIN: Minimum contention window [a value of the form
   1546  *    2^n-1 in the range 1..32767]
   1547  * @NL80211_TXQ_ATTR_CWMAX: Maximum contention window [a value of the form
   1548  *    2^n-1 in the range 1..32767]
   1549  * @NL80211_TXQ_ATTR_AIFS: Arbitration interframe space [0..255]
   1550  * @__NL80211_TXQ_ATTR_AFTER_LAST: Internal
   1551  * @NL80211_TXQ_ATTR_MAX: Maximum TXQ attribute number
   1552  */
   1553 enum nl80211_txq_attr {
   1554     __NL80211_TXQ_ATTR_INVALID,
   1555     NL80211_TXQ_ATTR_QUEUE,
   1556     NL80211_TXQ_ATTR_TXOP,
   1557     NL80211_TXQ_ATTR_CWMIN,
   1558     NL80211_TXQ_ATTR_CWMAX,
   1559     NL80211_TXQ_ATTR_AIFS,
   1560 
   1561     /* keep last */
   1562     __NL80211_TXQ_ATTR_AFTER_LAST,
   1563     NL80211_TXQ_ATTR_MAX = __NL80211_TXQ_ATTR_AFTER_LAST - 1
   1564 };
   1565 
   1566 enum nl80211_txq_q {
   1567     NL80211_TXQ_Q_VO,
   1568     NL80211_TXQ_Q_VI,
   1569     NL80211_TXQ_Q_BE,
   1570     NL80211_TXQ_Q_BK
   1571 };
   1572 
   1573 enum nl80211_channel_type {
   1574     NL80211_CHAN_NO_HT,
   1575     NL80211_CHAN_HT20,
   1576     NL80211_CHAN_HT40MINUS,
   1577     NL80211_CHAN_HT40PLUS
   1578 };
   1579 
   1580 /**
   1581  * enum nl80211_bss - netlink attributes for a BSS
   1582  *
   1583  * @__NL80211_BSS_INVALID: invalid
   1584  * @NL80211_BSS_BSSID: BSSID of the BSS (6 octets)
   1585  * @NL80211_BSS_FREQUENCY: frequency in MHz (u32)
   1586  * @NL80211_BSS_TSF: TSF of the received probe response/beacon (u64)
   1587  * @NL80211_BSS_BEACON_INTERVAL: beacon interval of the (I)BSS (u16)
   1588  * @NL80211_BSS_CAPABILITY: capability field (CPU order, u16)
   1589  * @NL80211_BSS_INFORMATION_ELEMENTS: binary attribute containing the
   1590  *    raw information elements from the probe response/beacon (bin);
   1591  *    if the %NL80211_BSS_BEACON_IES attribute is present, the IEs here are
   1592  *    from a Probe Response frame; otherwise they are from a Beacon frame.
   1593  *    However, if the driver does not indicate the source of the IEs, these
   1594  *    IEs may be from either frame subtype.
   1595  * @NL80211_BSS_SIGNAL_MBM: signal strength of probe response/beacon
   1596  *    in mBm (100 * dBm) (s32)
   1597  * @NL80211_BSS_SIGNAL_UNSPEC: signal strength of the probe response/beacon
   1598  *    in unspecified units, scaled to 0..100 (u8)
   1599  * @NL80211_BSS_STATUS: status, if this BSS is "used"
   1600  * @NL80211_BSS_SEEN_MS_AGO: age of this BSS entry in ms
   1601  * @NL80211_BSS_BEACON_IES: binary attribute containing the raw information
   1602  *    elements from a Beacon frame (bin); not present if no Beacon frame has
   1603  *    yet been received
   1604  * @__NL80211_BSS_AFTER_LAST: internal
   1605  * @NL80211_BSS_MAX: highest BSS attribute
   1606  */
   1607 enum nl80211_bss {
   1608     __NL80211_BSS_INVALID,
   1609     NL80211_BSS_BSSID,
   1610     NL80211_BSS_FREQUENCY,
   1611     NL80211_BSS_TSF,
   1612     NL80211_BSS_BEACON_INTERVAL,
   1613     NL80211_BSS_CAPABILITY,
   1614     NL80211_BSS_INFORMATION_ELEMENTS,
   1615     NL80211_BSS_SIGNAL_MBM,
   1616     NL80211_BSS_SIGNAL_UNSPEC,
   1617     NL80211_BSS_STATUS,
   1618     NL80211_BSS_SEEN_MS_AGO,
   1619     NL80211_BSS_BEACON_IES,
   1620 
   1621     /* keep last */
   1622     __NL80211_BSS_AFTER_LAST,
   1623     NL80211_BSS_MAX = __NL80211_BSS_AFTER_LAST - 1
   1624 };
   1625 
   1626 /**
   1627  * enum nl80211_bss_status - BSS "status"
   1628  * @NL80211_BSS_STATUS_AUTHENTICATED: Authenticated with this BSS.
   1629  * @NL80211_BSS_STATUS_ASSOCIATED: Associated with this BSS.
   1630  * @NL80211_BSS_STATUS_IBSS_JOINED: Joined to this IBSS.
   1631  *
   1632  * The BSS status is a BSS attribute in scan dumps, which
   1633  * indicates the status the interface has wrt. this BSS.
   1634  */
   1635 enum nl80211_bss_status {
   1636     NL80211_BSS_STATUS_AUTHENTICATED,
   1637     NL80211_BSS_STATUS_ASSOCIATED,
   1638     NL80211_BSS_STATUS_IBSS_JOINED,
   1639 };
   1640 
   1641 /**
   1642  * enum nl80211_auth_type - AuthenticationType
   1643  *
   1644  * @NL80211_AUTHTYPE_OPEN_SYSTEM: Open System authentication
   1645  * @NL80211_AUTHTYPE_SHARED_KEY: Shared Key authentication (WEP only)
   1646  * @NL80211_AUTHTYPE_FT: Fast BSS Transition (IEEE 802.11r)
   1647  * @NL80211_AUTHTYPE_NETWORK_EAP: Network EAP (some Cisco APs and mainly LEAP)
   1648  * @__NL80211_AUTHTYPE_NUM: internal
   1649  * @NL80211_AUTHTYPE_MAX: maximum valid auth algorithm
   1650  * @NL80211_AUTHTYPE_AUTOMATIC: determine automatically (if necessary by
   1651  *    trying multiple times); this is invalid in netlink -- leave out
   1652  *    the attribute for this on CONNECT commands.
   1653  */
   1654 enum nl80211_auth_type {
   1655     NL80211_AUTHTYPE_OPEN_SYSTEM,
   1656     NL80211_AUTHTYPE_SHARED_KEY,
   1657     NL80211_AUTHTYPE_FT,
   1658     NL80211_AUTHTYPE_NETWORK_EAP,
   1659 
   1660     /* keep last */
   1661     __NL80211_AUTHTYPE_NUM,
   1662     NL80211_AUTHTYPE_MAX = __NL80211_AUTHTYPE_NUM - 1,
   1663     NL80211_AUTHTYPE_AUTOMATIC
   1664 };
   1665 
   1666 /**
   1667  * enum nl80211_key_type - Key Type
   1668  * @NL80211_KEYTYPE_GROUP: Group (broadcast/multicast) key
   1669  * @NL80211_KEYTYPE_PAIRWISE: Pairwise (unicast/individual) key
   1670  * @NL80211_KEYTYPE_PEERKEY: PeerKey (DLS)
   1671  * @NUM_NL80211_KEYTYPES: number of defined key types
   1672  */
   1673 enum nl80211_key_type {
   1674     NL80211_KEYTYPE_GROUP,
   1675     NL80211_KEYTYPE_PAIRWISE,
   1676     NL80211_KEYTYPE_PEERKEY,
   1677 
   1678     NUM_NL80211_KEYTYPES
   1679 };
   1680 
   1681 /**
   1682  * enum nl80211_mfp - Management frame protection state
   1683  * @NL80211_MFP_NO: Management frame protection not used
   1684  * @NL80211_MFP_REQUIRED: Management frame protection required
   1685  */
   1686 enum nl80211_mfp {
   1687     NL80211_MFP_NO,
   1688     NL80211_MFP_REQUIRED,
   1689 };
   1690 
   1691 enum nl80211_wpa_versions {
   1692     NL80211_WPA_VERSION_1 = 1 << 0,
   1693     NL80211_WPA_VERSION_2 = 1 << 1,
   1694 };
   1695 
   1696 /**
   1697  * enum nl80211_key_attributes - key attributes
   1698  * @__NL80211_KEY_INVALID: invalid
   1699  * @NL80211_KEY_DATA: (temporal) key data; for TKIP this consists of
   1700  *    16 bytes encryption key followed by 8 bytes each for TX and RX MIC
   1701  *    keys
   1702  * @NL80211_KEY_IDX: key ID (u8, 0-3)
   1703  * @NL80211_KEY_CIPHER: key cipher suite (u32, as defined by IEEE 802.11
   1704  *    section 7.3.2.25.1, e.g. 0x000FAC04)
   1705  * @NL80211_KEY_SEQ: transmit key sequence number (IV/PN) for TKIP and
   1706  *    CCMP keys, each six bytes in little endian
   1707  * @NL80211_KEY_DEFAULT: flag indicating default key
   1708  * @NL80211_KEY_DEFAULT_MGMT: flag indicating default management key
   1709  * @NL80211_KEY_TYPE: the key type from enum nl80211_key_type, if not
   1710  *    specified the default depends on whether a MAC address was
   1711  *    given with the command using the key or not (u32)
   1712  * @__NL80211_KEY_AFTER_LAST: internal
   1713  * @NL80211_KEY_MAX: highest key attribute
   1714  */
   1715 enum nl80211_key_attributes {
   1716     __NL80211_KEY_INVALID,
   1717     NL80211_KEY_DATA,
   1718     NL80211_KEY_IDX,
   1719     NL80211_KEY_CIPHER,
   1720     NL80211_KEY_SEQ,
   1721     NL80211_KEY_DEFAULT,
   1722     NL80211_KEY_DEFAULT_MGMT,
   1723     NL80211_KEY_TYPE,
   1724 
   1725     /* keep last */
   1726     __NL80211_KEY_AFTER_LAST,
   1727     NL80211_KEY_MAX = __NL80211_KEY_AFTER_LAST - 1
   1728 };
   1729 
   1730 /**
   1731  * enum nl80211_tx_rate_attributes - TX rate set attributes
   1732  * @__NL80211_TXRATE_INVALID: invalid
   1733  * @NL80211_TXRATE_LEGACY: Legacy (non-MCS) rates allowed for TX rate selection
   1734  *    in an array of rates as defined in IEEE 802.11 7.3.2.2 (u8 values with
   1735  *    1 = 500 kbps) but without the IE length restriction (at most
   1736  *    %NL80211_MAX_SUPP_RATES in a single array).
   1737  * @__NL80211_TXRATE_AFTER_LAST: internal
   1738  * @NL80211_TXRATE_MAX: highest TX rate attribute
   1739  */
   1740 enum nl80211_tx_rate_attributes {
   1741     __NL80211_TXRATE_INVALID,
   1742     NL80211_TXRATE_LEGACY,
   1743 
   1744     /* keep last */
   1745     __NL80211_TXRATE_AFTER_LAST,
   1746     NL80211_TXRATE_MAX = __NL80211_TXRATE_AFTER_LAST - 1
   1747 };
   1748 
   1749 /**
   1750  * enum nl80211_band - Frequency band
   1751  * @NL80211_BAND_2GHZ: 2.4 GHz ISM band
   1752  * @NL80211_BAND_5GHZ: around 5 GHz band (4.9 - 5.7 GHz)
   1753  */
   1754 enum nl80211_band {
   1755     NL80211_BAND_2GHZ,
   1756     NL80211_BAND_5GHZ,
   1757 };
   1758 
   1759 enum nl80211_ps_state {
   1760     NL80211_PS_DISABLED,
   1761     NL80211_PS_ENABLED,
   1762 };
   1763 
   1764 /**
   1765  * enum nl80211_attr_cqm - connection quality monitor attributes
   1766  * @__NL80211_ATTR_CQM_INVALID: invalid
   1767  * @NL80211_ATTR_CQM_RSSI_THOLD: RSSI threshold in dBm. This value specifies
   1768  *    the threshold for the RSSI level at which an event will be sent. Zero
   1769  *    to disable.
   1770  * @NL80211_ATTR_CQM_RSSI_HYST: RSSI hysteresis in dBm. This value specifies
   1771  *    the minimum amount the RSSI level must change after an event before a
   1772  *    new event may be issued (to reduce effects of RSSI oscillation).
   1773  * @NL80211_ATTR_CQM_RSSI_THRESHOLD_EVENT: RSSI threshold event
   1774  * @__NL80211_ATTR_CQM_AFTER_LAST: internal
   1775  * @NL80211_ATTR_CQM_MAX: highest key attribute
   1776  */
   1777 enum nl80211_attr_cqm {
   1778     __NL80211_ATTR_CQM_INVALID,
   1779     NL80211_ATTR_CQM_RSSI_THOLD,
   1780     NL80211_ATTR_CQM_RSSI_HYST,
   1781     NL80211_ATTR_CQM_RSSI_THRESHOLD_EVENT,
   1782 
   1783     /* keep last */
   1784     __NL80211_ATTR_CQM_AFTER_LAST,
   1785     NL80211_ATTR_CQM_MAX = __NL80211_ATTR_CQM_AFTER_LAST - 1
   1786 };
   1787 
   1788 /**
   1789  * enum nl80211_cqm_rssi_threshold_event - RSSI threshold event
   1790  * @NL80211_CQM_RSSI_THRESHOLD_EVENT_LOW: The RSSI level is lower than the
   1791  *      configured threshold
   1792  * @NL80211_CQM_RSSI_THRESHOLD_EVENT_HIGH: The RSSI is higher than the
   1793  *      configured threshold
   1794  */
   1795 enum nl80211_cqm_rssi_threshold_event {
   1796     NL80211_CQM_RSSI_THRESHOLD_EVENT_LOW,
   1797     NL80211_CQM_RSSI_THRESHOLD_EVENT_HIGH,
   1798 };
   1799 
   1800 
   1801 /**
   1802  * enum nl80211_tx_power_setting - TX power adjustment
   1803  * @NL80211_TX_POWER_AUTOMATIC: automatically determine transmit power
   1804  * @NL80211_TX_POWER_LIMITED: limit TX power by the mBm parameter
   1805  * @NL80211_TX_POWER_FIXED: fix TX power to the mBm parameter
   1806  */
   1807 enum nl80211_tx_power_setting {
   1808     NL80211_TX_POWER_AUTOMATIC,
   1809     NL80211_TX_POWER_LIMITED,
   1810     NL80211_TX_POWER_FIXED,
   1811 };
   1812 
   1813 #endif /* __LINUX_NL80211_H */
   1814