SAFE public projects git trees. - safe/jmp/linux-2.6/blob - include/net/cfg80211.h

   1 #ifndef __NET_CFG80211_H
   2 #define __NET_CFG80211_H
   3
   4 #include <linux/netlink.h>
   5 #include <linux/skbuff.h>
   6 #include <linux/nl80211.h>
   7 #include <linux/if_ether.h>
   8 #include <linux/ieee80211.h>
   9 #include <linux/wireless.h>
  10 #include <net/iw_handler.h>
  11 #include <net/genetlink.h>
  12 /* remove once we remove the wext stuff */
  13 #include <net/iw_handler.h>
  14
  15 /*
  16  * 802.11 configuration in-kernel interface
  17  *
  18  * Copyright 2006, 2007 Johannes Berg <johannes@sipsolutions.net>
  19  */
  20
  21 /**
  22  * struct vif_params - describes virtual interface parameters
  23  * @mesh_id: mesh ID to use
  24  * @mesh_id_len: length of the mesh ID
  25  */
  26 struct vif_params {
  27        u8 *mesh_id;
  28        int mesh_id_len;
  29 };
  30
  31 /* Radiotap header iteration
  32  *   implemented in net/wireless/radiotap.c
  33  *   docs in Documentation/networking/radiotap-headers.txt
  34  */
  35 /**
  36  * struct ieee80211_radiotap_iterator - tracks walk thru present radiotap args
  37  * @rtheader: pointer to the radiotap header we are walking through
  38  * @max_length: length of radiotap header in cpu byte ordering
  39  * @this_arg_index: IEEE80211_RADIOTAP_... index of current arg
  40  * @this_arg: pointer to current radiotap arg
  41  * @arg_index: internal next argument index
  42  * @arg: internal next argument pointer
  43  * @next_bitmap: internal pointer to next present u32
  44  * @bitmap_shifter: internal shifter for curr u32 bitmap, b0 set == arg present
  45  */
  46
  47 struct ieee80211_radiotap_iterator {
  48         struct ieee80211_radiotap_header *rtheader;
  49         int max_length;
  50         int this_arg_index;
  51         u8 *this_arg;
  52
  53         int arg_index;
  54         u8 *arg;
  55         __le32 *next_bitmap;
  56         u32 bitmap_shifter;
  57 };
  58
  59 extern int ieee80211_radiotap_iterator_init(
  60    struct ieee80211_radiotap_iterator *iterator,
  61    struct ieee80211_radiotap_header *radiotap_header,
  62    int max_length);
  63
  64 extern int ieee80211_radiotap_iterator_next(
  65    struct ieee80211_radiotap_iterator *iterator);
  66
  67
  68  /**
  69  * struct key_params - key information
  70  *
  71  * Information about a key
  72  *
  73  * @key: key material
  74  * @key_len: length of key material
  75  * @cipher: cipher suite selector
  76  * @seq: sequence counter (IV/PN) for TKIP and CCMP keys, only used
  77  *      with the get_key() callback, must be in little endian,
  78  *      length given by @seq_len.
  79  */
  80 struct key_params {
  81         u8 *key;
  82         u8 *seq;
  83         int key_len;
  84         int seq_len;
  85         u32 cipher;
  86 };
  87
  88 /**
  89  * struct beacon_parameters - beacon parameters
  90  *
  91  * Used to configure the beacon for an interface.
  92  *
  93  * @head: head portion of beacon (before TIM IE)
  94  *     or %NULL if not changed
  95  * @tail: tail portion of beacon (after TIM IE)
  96  *     or %NULL if not changed
  97  * @interval: beacon interval or zero if not changed
  98  * @dtim_period: DTIM period or zero if not changed
  99  * @head_len: length of @head
 100  * @tail_len: length of @tail
 101  */
 102 struct beacon_parameters {
 103         u8 *head, *tail;
 104         int interval, dtim_period;
 105         int head_len, tail_len;
 106 };
 107
 108 /**
 109  * enum station_flags - station flags
 110  *
 111  * Station capability flags. Note that these must be the bits
 112  * according to the nl80211 flags.
 113  *
 114  * @STATION_FLAG_CHANGED: station flags were changed
 115  * @STATION_FLAG_AUTHORIZED: station is authorized to send frames (802.1X)
 116  * @STATION_FLAG_SHORT_PREAMBLE: station is capable of receiving frames
 117  *      with short preambles
 118  * @STATION_FLAG_WME: station is WME/QoS capable
 119  * @STATION_FLAG_MFP: station uses management frame protection
 120  */
 121 enum station_flags {
 122         STATION_FLAG_CHANGED            = 1<<0,
 123         STATION_FLAG_AUTHORIZED         = 1<<NL80211_STA_FLAG_AUTHORIZED,
 124         STATION_FLAG_SHORT_PREAMBLE     = 1<<NL80211_STA_FLAG_SHORT_PREAMBLE,
 125         STATION_FLAG_WME                = 1<<NL80211_STA_FLAG_WME,
 126         STATION_FLAG_MFP                = 1<<NL80211_STA_FLAG_MFP,
 127 };
 128
 129 /**
 130  * enum plink_action - actions to perform in mesh peers
 131  *
 132  * @PLINK_ACTION_INVALID: action 0 is reserved
 133  * @PLINK_ACTION_OPEN: start mesh peer link establishment
 134  * @PLINK_ACTION_BLOCL: block traffic from this mesh peer
 135  */
 136 enum plink_actions {
 137         PLINK_ACTION_INVALID,
 138         PLINK_ACTION_OPEN,
 139         PLINK_ACTION_BLOCK,
 140 };
 141
 142 /**
 143  * struct station_parameters - station parameters
 144  *
 145  * Used to change and create a new station.
 146  *
 147  * @vlan: vlan interface station should belong to
 148  * @supported_rates: supported rates in IEEE 802.11 format
 149  *      (or NULL for no change)
 150  * @supported_rates_len: number of supported rates
 151  * @station_flags: station flags (see &enum station_flags)
 152  * @listen_interval: listen interval or -1 for no change
 153  * @aid: AID or zero for no change
 154  */
 155 struct station_parameters {
 156         u8 *supported_rates;
 157         struct net_device *vlan;
 158         u32 station_flags;
 159         int listen_interval;
 160         u16 aid;
 161         u8 supported_rates_len;
 162         u8 plink_action;
 163         struct ieee80211_ht_cap *ht_capa;
 164 };
 165
 166 /**
 167  * enum station_info_flags - station information flags
 168  *
 169  * Used by the driver to indicate which info in &struct station_info
 170  * it has filled in during get_station() or dump_station().
 171  *
 172  * @STATION_INFO_INACTIVE_TIME: @inactive_time filled
 173  * @STATION_INFO_RX_BYTES: @rx_bytes filled
 174  * @STATION_INFO_TX_BYTES: @tx_bytes filled
 175  * @STATION_INFO_LLID: @llid filled
 176  * @STATION_INFO_PLID: @plid filled
 177  * @STATION_INFO_PLINK_STATE: @plink_state filled
 178  * @STATION_INFO_SIGNAL: @signal filled
 179  * @STATION_INFO_TX_BITRATE: @tx_bitrate fields are filled
 180  *  (tx_bitrate, tx_bitrate_flags and tx_bitrate_mcs)
 181  * @STATION_INFO_RX_PACKETS: @rx_packets filled
 182  * @STATION_INFO_TX_PACKETS: @tx_packets filled
 183  */
 184 enum station_info_flags {
 185         STATION_INFO_INACTIVE_TIME      = 1<<0,
 186         STATION_INFO_RX_BYTES           = 1<<1,
 187         STATION_INFO_TX_BYTES           = 1<<2,
 188         STATION_INFO_LLID               = 1<<3,
 189         STATION_INFO_PLID               = 1<<4,
 190         STATION_INFO_PLINK_STATE        = 1<<5,
 191         STATION_INFO_SIGNAL             = 1<<6,
 192         STATION_INFO_TX_BITRATE         = 1<<7,
 193         STATION_INFO_RX_PACKETS         = 1<<8,
 194         STATION_INFO_TX_PACKETS         = 1<<9,
 195 };
 196
 197 /**
 198  * enum station_info_rate_flags - bitrate info flags
 199  *
 200  * Used by the driver to indicate the specific rate transmission
 201  * type for 802.11n transmissions.
 202  *
 203  * @RATE_INFO_FLAGS_MCS: @tx_bitrate_mcs filled
 204  * @RATE_INFO_FLAGS_40_MHZ_WIDTH: 40 Mhz width transmission
 205  * @RATE_INFO_FLAGS_SHORT_GI: 400ns guard interval
 206  */
 207 enum rate_info_flags {
 208         RATE_INFO_FLAGS_MCS             = 1<<0,
 209         RATE_INFO_FLAGS_40_MHZ_WIDTH    = 1<<1,
 210         RATE_INFO_FLAGS_SHORT_GI        = 1<<2,
 211 };
 212
 213 /**
 214  * struct rate_info - bitrate information
 215  *
 216  * Information about a receiving or transmitting bitrate
 217  *
 218  * @flags: bitflag of flags from &enum rate_info_flags
 219  * @mcs: mcs index if struct describes a 802.11n bitrate
 220  * @legacy: bitrate in 100kbit/s for 802.11abg
 221  */
 222 struct rate_info {
 223         u8 flags;
 224         u8 mcs;
 225         u16 legacy;
 226 };
 227
 228 /**
 229  * struct station_info - station information
 230  *
 231  * Station information filled by driver for get_station() and dump_station.
 232  *
 233  * @filled: bitflag of flags from &enum station_info_flags
 234  * @inactive_time: time since last station activity (tx/rx) in milliseconds
 235  * @rx_bytes: bytes received from this station
 236  * @tx_bytes: bytes transmitted to this station
 237  * @llid: mesh local link id
 238  * @plid: mesh peer link id
 239  * @plink_state: mesh peer link state
 240  * @signal: signal strength of last received packet in dBm
 241  * @txrate: current unicast bitrate to this station
 242  * @rx_packets: packets received from this station
 243  * @tx_packets: packets transmitted to this station
 244  */
 245 struct station_info {
 246         u32 filled;
 247         u32 inactive_time;
 248         u32 rx_bytes;
 249         u32 tx_bytes;
 250         u16 llid;
 251         u16 plid;
 252         u8 plink_state;
 253         s8 signal;
 254         struct rate_info txrate;
 255         u32 rx_packets;
 256         u32 tx_packets;
 257 };
 258
 259 /**
 260  * enum monitor_flags - monitor flags
 261  *
 262  * Monitor interface configuration flags. Note that these must be the bits
 263  * according to the nl80211 flags.
 264  *
 265  * @MONITOR_FLAG_FCSFAIL: pass frames with bad FCS
 266  * @MONITOR_FLAG_PLCPFAIL: pass frames with bad PLCP
 267  * @MONITOR_FLAG_CONTROL: pass control frames
 268  * @MONITOR_FLAG_OTHER_BSS: disable BSSID filtering
 269  * @MONITOR_FLAG_COOK_FRAMES: report frames after processing
 270  */
 271 enum monitor_flags {
 272         MONITOR_FLAG_FCSFAIL            = 1<<NL80211_MNTR_FLAG_FCSFAIL,
 273         MONITOR_FLAG_PLCPFAIL           = 1<<NL80211_MNTR_FLAG_PLCPFAIL,
 274         MONITOR_FLAG_CONTROL            = 1<<NL80211_MNTR_FLAG_CONTROL,
 275         MONITOR_FLAG_OTHER_BSS          = 1<<NL80211_MNTR_FLAG_OTHER_BSS,
 276         MONITOR_FLAG_COOK_FRAMES        = 1<<NL80211_MNTR_FLAG_COOK_FRAMES,
 277 };
 278
 279 /**
 280  * enum mpath_info_flags -  mesh path information flags
 281  *
 282  * Used by the driver to indicate which info in &struct mpath_info it has filled
 283  * in during get_station() or dump_station().
 284  *
 285  * MPATH_INFO_FRAME_QLEN: @frame_qlen filled
 286  * MPATH_INFO_DSN: @dsn filled
 287  * MPATH_INFO_METRIC: @metric filled
 288  * MPATH_INFO_EXPTIME: @exptime filled
 289  * MPATH_INFO_DISCOVERY_TIMEOUT: @discovery_timeout filled
 290  * MPATH_INFO_DISCOVERY_RETRIES: @discovery_retries filled
 291  * MPATH_INFO_FLAGS: @flags filled
 292  */
 293 enum mpath_info_flags {
 294         MPATH_INFO_FRAME_QLEN           = BIT(0),
 295         MPATH_INFO_DSN                  = BIT(1),
 296         MPATH_INFO_METRIC               = BIT(2),
 297         MPATH_INFO_EXPTIME              = BIT(3),
 298         MPATH_INFO_DISCOVERY_TIMEOUT    = BIT(4),
 299         MPATH_INFO_DISCOVERY_RETRIES    = BIT(5),
 300         MPATH_INFO_FLAGS                = BIT(6),
 301 };
 302
 303 /**
 304  * struct mpath_info - mesh path information
 305  *
 306  * Mesh path information filled by driver for get_mpath() and dump_mpath().
 307  *
 308  * @filled: bitfield of flags from &enum mpath_info_flags
 309  * @frame_qlen: number of queued frames for this destination
 310  * @dsn: destination sequence number
 311  * @metric: metric (cost) of this mesh path
 312  * @exptime: expiration time for the mesh path from now, in msecs
 313  * @flags: mesh path flags
 314  * @discovery_timeout: total mesh path discovery timeout, in msecs
 315  * @discovery_retries: mesh path discovery retries
 316  */
 317 struct mpath_info {
 318         u32 filled;
 319         u32 frame_qlen;
 320         u32 dsn;
 321         u32 metric;
 322         u32 exptime;
 323         u32 discovery_timeout;
 324         u8 discovery_retries;
 325         u8 flags;
 326 };
 327
 328 /**
 329  * struct bss_parameters - BSS parameters
 330  *
 331  * Used to change BSS parameters (mainly for AP mode).
 332  *
 333  * @use_cts_prot: Whether to use CTS protection
 334  *      (0 = no, 1 = yes, -1 = do not change)
 335  * @use_short_preamble: Whether the use of short preambles is allowed
 336  *      (0 = no, 1 = yes, -1 = do not change)
 337  * @use_short_slot_time: Whether the use of short slot time is allowed
 338  *      (0 = no, 1 = yes, -1 = do not change)
 339  * @basic_rates: basic rates in IEEE 802.11 format
 340  *      (or NULL for no change)
 341  * @basic_rates_len: number of basic rates
 342  */
 343 struct bss_parameters {
 344         int use_cts_prot;
 345         int use_short_preamble;
 346         int use_short_slot_time;
 347         u8 *basic_rates;
 348         u8 basic_rates_len;
 349 };
 350
 351 /**
 352  * enum reg_set_by - Indicates who is trying to set the regulatory domain
 353  * @REGDOM_SET_BY_CORE: Core queried CRDA for a dynamic world regulatory domain.
 354  * @REGDOM_SET_BY_USER: User asked the wireless core to set the
 355  *      regulatory domain.
 356  * @REGDOM_SET_BY_DRIVER: a wireless drivers has hinted to the wireless core
 357  *      it thinks its knows the regulatory domain we should be in.
 358  * @REGDOM_SET_BY_COUNTRY_IE: the wireless core has received an 802.11 country
 359  *      information element with regulatory information it thinks we
 360  *      should consider.
 361  */
 362 enum reg_set_by {
 363         REGDOM_SET_BY_CORE,
 364         REGDOM_SET_BY_USER,
 365         REGDOM_SET_BY_DRIVER,
 366         REGDOM_SET_BY_COUNTRY_IE,
 367 };
 368
 369 /**
 370  * enum environment_cap - Environment parsed from country IE
 371  * @ENVIRON_ANY: indicates country IE applies to both indoor and
 372  *      outdoor operation.
 373  * @ENVIRON_INDOOR: indicates country IE applies only to indoor operation
 374  * @ENVIRON_OUTDOOR: indicates country IE applies only to outdoor operation
 375  */
 376 enum environment_cap {
 377         ENVIRON_ANY,
 378         ENVIRON_INDOOR,
 379         ENVIRON_OUTDOOR,
 380 };
 381
 382 /**
 383  * struct regulatory_request - used to keep track of regulatory requests
 384  *
 385  * @wiphy_idx: this is set if this request's initiator is
 386  *      %REGDOM_SET_BY_COUNTRY_IE or %REGDOM_SET_BY_DRIVER. This
 387  *      can be used by the wireless core to deal with conflicts
 388  *      and potentially inform users of which devices specifically
 389  *      cased the conflicts.
 390  * @initiator: indicates who sent this request, could be any of
 391  *      of those set in reg_set_by, %REGDOM_SET_BY_*
 392  * @alpha2: the ISO / IEC 3166 alpha2 country code of the requested
 393  *      regulatory domain. We have a few special codes:
 394  *      00 - World regulatory domain
 395  *      99 - built by driver but a specific alpha2 cannot be determined
 396  *      98 - result of an intersection between two regulatory domains
 397  * @intersect: indicates whether the wireless core should intersect
 398  *      the requested regulatory domain with the presently set regulatory
 399  *      domain.
 400  * @country_ie_checksum: checksum of the last processed and accepted
 401  *      country IE
 402  * @country_ie_env: lets us know if the AP is telling us we are outdoor,
 403  *      indoor, or if it doesn't matter
 404  * @list: used to insert into the reg_requests_list linked list
 405  */
 406 struct regulatory_request {
 407         int wiphy_idx;
 408         enum reg_set_by initiator;
 409         char alpha2[2];
 410         bool intersect;
 411         u32 country_ie_checksum;
 412         enum environment_cap country_ie_env;
 413         struct list_head list;
 414 };
 415
 416 struct ieee80211_freq_range {
 417         u32 start_freq_khz;
 418         u32 end_freq_khz;
 419         u32 max_bandwidth_khz;
 420 };
 421
 422 struct ieee80211_power_rule {
 423         u32 max_antenna_gain;
 424         u32 max_eirp;
 425 };
 426
 427 struct ieee80211_reg_rule {
 428         struct ieee80211_freq_range freq_range;
 429         struct ieee80211_power_rule power_rule;
 430         u32 flags;
 431 };
 432
 433 struct ieee80211_regdomain {
 434         u32 n_reg_rules;
 435         char alpha2[2];
 436         struct ieee80211_reg_rule reg_rules[];
 437 };
 438
 439 #define MHZ_TO_KHZ(freq) ((freq) * 1000)
 440 #define KHZ_TO_MHZ(freq) ((freq) / 1000)
 441 #define DBI_TO_MBI(gain) ((gain) * 100)
 442 #define MBI_TO_DBI(gain) ((gain) / 100)
 443 #define DBM_TO_MBM(gain) ((gain) * 100)
 444 #define MBM_TO_DBM(gain) ((gain) / 100)
 445
 446 #define REG_RULE(start, end, bw, gain, eirp, reg_flags) { \
 447         .freq_range.start_freq_khz = MHZ_TO_KHZ(start), \
 448         .freq_range.end_freq_khz = MHZ_TO_KHZ(end), \
 449         .freq_range.max_bandwidth_khz = MHZ_TO_KHZ(bw), \
 450         .power_rule.max_antenna_gain = DBI_TO_MBI(gain), \
 451         .power_rule.max_eirp = DBM_TO_MBM(eirp), \
 452         .flags = reg_flags, \
 453         }
 454
 455 struct mesh_config {
 456         /* Timeouts in ms */
 457         /* Mesh plink management parameters */
 458         u16 dot11MeshRetryTimeout;
 459         u16 dot11MeshConfirmTimeout;
 460         u16 dot11MeshHoldingTimeout;
 461         u16 dot11MeshMaxPeerLinks;
 462         u8  dot11MeshMaxRetries;
 463         u8  dot11MeshTTL;
 464         bool auto_open_plinks;
 465         /* HWMP parameters */
 466         u8  dot11MeshHWMPmaxPREQretries;
 467         u32 path_refresh_time;
 468         u16 min_discovery_timeout;
 469         u32 dot11MeshHWMPactivePathTimeout;
 470         u16 dot11MeshHWMPpreqMinInterval;
 471         u16 dot11MeshHWMPnetDiameterTraversalTime;
 472 };
 473
 474 /**
 475  * struct ieee80211_txq_params - TX queue parameters
 476  * @queue: TX queue identifier (NL80211_TXQ_Q_*)
 477  * @txop: Maximum burst time in units of 32 usecs, 0 meaning disabled
 478  * @cwmin: Minimum contention window [a value of the form 2^n-1 in the range
 479  *      1..32767]
 480  * @cwmax: Maximum contention window [a value of the form 2^n-1 in the range
 481  *      1..32767]
 482  * @aifs: Arbitration interframe space [0..255]
 483  */
 484 struct ieee80211_txq_params {
 485         enum nl80211_txq_q queue;
 486         u16 txop;
 487         u16 cwmin;
 488         u16 cwmax;
 489         u8 aifs;
 490 };
 491
 492 /**
 493  * struct mgmt_extra_ie_params - Extra management frame IE parameters
 494  *
 495  * Used to add extra IE(s) into management frames. If the driver cannot add the
 496  * requested data into all management frames of the specified subtype that are
 497  * generated in kernel or firmware/hardware, it must reject the configuration
 498  * call. The IE data buffer is added to the end of the specified management
 499  * frame body after all other IEs. This addition is not applied to frames that
 500  * are injected through a monitor interface.
 501  *
 502  * @subtype: Management frame subtype
 503  * @ies: IE data buffer or %NULL to remove previous data
 504  * @ies_len: Length of @ies in octets
 505  */
 506 struct mgmt_extra_ie_params {
 507         u8 subtype;
 508         u8 *ies;
 509         int ies_len;
 510 };
 511
 512 /* from net/wireless.h */
 513 struct wiphy;
 514
 515 /* from net/ieee80211.h */
 516 struct ieee80211_channel;
 517
 518 /**
 519  * struct cfg80211_ssid - SSID description
 520  * @ssid: the SSID
 521  * @ssid_len: length of the ssid
 522  */
 523 struct cfg80211_ssid {
 524         u8 ssid[IEEE80211_MAX_SSID_LEN];
 525         u8 ssid_len;
 526 };
 527
 528 /**
 529  * struct cfg80211_scan_request - scan request description
 530  *
 531  * @ssids: SSIDs to scan for (active scan only)
 532  * @n_ssids: number of SSIDs
 533  * @channels: channels to scan on.
 534  * @n_channels: number of channels for each band
 535  * @ie: optional information element(s) to add into Probe Request or %NULL
 536  * @ie_len: length of ie in octets
 537  * @wiphy: the wiphy this was for
 538  * @ifidx: the interface index
 539  */
 540 struct cfg80211_scan_request {
 541         struct cfg80211_ssid *ssids;
 542         int n_ssids;
 543         struct ieee80211_channel **channels;
 544         u32 n_channels;
 545         u8 *ie;
 546         size_t ie_len;
 547
 548         /* internal */
 549         struct wiphy *wiphy;
 550         int ifidx;
 551 };
 552
 553 /**
 554  * enum cfg80211_signal_type - signal type
 555  *
 556  * @CFG80211_SIGNAL_TYPE_NONE: no signal strength information available
 557  * @CFG80211_SIGNAL_TYPE_MBM: signal strength in mBm (100*dBm)
 558  * @CFG80211_SIGNAL_TYPE_UNSPEC: signal strength, increasing from 0 through 100
 559  */
 560 enum cfg80211_signal_type {
 561         CFG80211_SIGNAL_TYPE_NONE,
 562         CFG80211_SIGNAL_TYPE_MBM,
 563         CFG80211_SIGNAL_TYPE_UNSPEC,
 564 };
 565
 566 /**
 567  * struct cfg80211_bss - BSS description
 568  *
 569  * This structure describes a BSS (which may also be a mesh network)
 570  * for use in scan results and similar.
 571  *
 572  * @bssid: BSSID of the BSS
 573  * @tsf: timestamp of last received update
 574  * @beacon_interval: the beacon interval as from the frame
 575  * @capability: the capability field in host byte order
 576  * @information_elements: the information elements (Note that there
 577  *      is no guarantee that these are well-formed!)
 578  * @len_information_elements: total length of the information elements
 579  * @signal: signal strength value (type depends on the wiphy's signal_type)
 580  * @free_priv: function pointer to free private data
 581  * @priv: private area for driver use, has at least wiphy->bss_priv_size bytes
 582  */
 583 struct cfg80211_bss {
 584         struct ieee80211_channel *channel;
 585
 586         u8 bssid[ETH_ALEN];
 587         u64 tsf;
 588         u16 beacon_interval;
 589         u16 capability;
 590         u8 *information_elements;
 591         size_t len_information_elements;
 592
 593         s32 signal;
 594
 595         void (*free_priv)(struct cfg80211_bss *bss);
 596         u8 priv[0] __attribute__((__aligned__(sizeof(void *))));
 597 };
 598
 599 /**
 600  * struct cfg80211_ops - backend description for wireless configuration
 601  *
 602  * This struct is registered by fullmac card drivers and/or wireless stacks
 603  * in order to handle configuration requests on their interfaces.
 604  *
 605  * All callbacks except where otherwise noted should return 0
 606  * on success or a negative error code.
 607  *
 608  * All operations are currently invoked under rtnl for consistency with the
 609  * wireless extensions but this is subject to reevaluation as soon as this
 610  * code is used more widely and we have a first user without wext.
 611  *
 612  * @suspend: wiphy device needs to be suspended
 613  * @resume: wiphy device needs to be resumed
 614  *
 615  * @add_virtual_intf: create a new virtual interface with the given name,
 616  *      must set the struct wireless_dev's iftype.
 617  *
 618  * @del_virtual_intf: remove the virtual interface determined by ifindex.
 619  *
 620  * @change_virtual_intf: change type/configuration of virtual interface,
 621  *      keep the struct wireless_dev's iftype updated.
 622  *
 623  * @add_key: add a key with the given parameters. @mac_addr will be %NULL
 624  *      when adding a group key.
 625  *
 626  * @get_key: get information about the key with the given parameters.
 627  *      @mac_addr will be %NULL when requesting information for a group
 628  *      key. All pointers given to the @callback function need not be valid
 629  *      after it returns.
 630  *
 631  * @del_key: remove a key given the @mac_addr (%NULL for a group key)
 632  *      and @key_index
 633  *
 634  * @set_default_key: set the default key on an interface
 635  *
 636  * @set_default_mgmt_key: set the default management frame key on an interface
 637  *
 638  * @add_beacon: Add a beacon with given parameters, @head, @interval
 639  *      and @dtim_period will be valid, @tail is optional.
 640  * @set_beacon: Change the beacon parameters for an access point mode
 641  *      interface. This should reject the call when no beacon has been
 642  *      configured.
 643  * @del_beacon: Remove beacon configuration and stop sending the beacon.
 644  *
 645  * @add_station: Add a new station.
 646  *
 647  * @del_station: Remove a station; @mac may be NULL to remove all stations.
 648  *
 649  * @change_station: Modify a given station.
 650  *
 651  * @get_mesh_params: Put the current mesh parameters into *params
 652  *
 653  * @set_mesh_params: Set mesh parameters.
 654  *      The mask is a bitfield which tells us which parameters to
 655  *      set, and which to leave alone.
 656  *
 657  * @set_mesh_cfg: set mesh parameters (by now, just mesh id)
 658  *
 659  * @change_bss: Modify parameters for a given BSS.
 660  *
 661  * @set_txq_params: Set TX queue parameters
 662  *
 663  * @set_channel: Set channel
 664  *
 665  * @set_mgmt_extra_ie: Set extra IE data for management frames
 666  *
 667  * @scan: Request to do a scan. If returning zero, the scan request is given
 668  *      the driver, and will be valid until passed to cfg80211_scan_done().
 669  *      For scan results, call cfg80211_inform_bss(); you can call this outside
 670  *      the scan/scan_done bracket too.
 671  */
 672 struct cfg80211_ops {
 673         int     (*suspend)(struct wiphy *wiphy);
 674         int     (*resume)(struct wiphy *wiphy);
 675
 676         int     (*add_virtual_intf)(struct wiphy *wiphy, char *name,
 677                                     enum nl80211_iftype type, u32 *flags,
 678                                     struct vif_params *params);
 679         int     (*del_virtual_intf)(struct wiphy *wiphy, int ifindex);
 680         int     (*change_virtual_intf)(struct wiphy *wiphy, int ifindex,
 681                                        enum nl80211_iftype type, u32 *flags,
 682                                        struct vif_params *params);
 683
 684         int     (*add_key)(struct wiphy *wiphy, struct net_device *netdev,
 685                            u8 key_index, u8 *mac_addr,
 686                            struct key_params *params);
 687         int     (*get_key)(struct wiphy *wiphy, struct net_device *netdev,
 688                            u8 key_index, u8 *mac_addr, void *cookie,
 689                            void (*callback)(void *cookie, struct key_params*));
 690         int     (*del_key)(struct wiphy *wiphy, struct net_device *netdev,
 691                            u8 key_index, u8 *mac_addr);
 692         int     (*set_default_key)(struct wiphy *wiphy,
 693                                    struct net_device *netdev,
 694                                    u8 key_index);
 695         int     (*set_default_mgmt_key)(struct wiphy *wiphy,
 696                                         struct net_device *netdev,
 697                                         u8 key_index);
 698
 699         int     (*add_beacon)(struct wiphy *wiphy, struct net_device *dev,
 700                               struct beacon_parameters *info);
 701         int     (*set_beacon)(struct wiphy *wiphy, struct net_device *dev,
 702                               struct beacon_parameters *info);
 703         int     (*del_beacon)(struct wiphy *wiphy, struct net_device *dev);
 704
 705
 706         int     (*add_station)(struct wiphy *wiphy, struct net_device *dev,
 707                                u8 *mac, struct station_parameters *params);
 708         int     (*del_station)(struct wiphy *wiphy, struct net_device *dev,
 709                                u8 *mac);
 710         int     (*change_station)(struct wiphy *wiphy, struct net_device *dev,
 711                                   u8 *mac, struct station_parameters *params);
 712         int     (*get_station)(struct wiphy *wiphy, struct net_device *dev,
 713                                u8 *mac, struct station_info *sinfo);
 714         int     (*dump_station)(struct wiphy *wiphy, struct net_device *dev,
 715                                int idx, u8 *mac, struct station_info *sinfo);
 716
 717         int     (*add_mpath)(struct wiphy *wiphy, struct net_device *dev,
 718                                u8 *dst, u8 *next_hop);
 719         int     (*del_mpath)(struct wiphy *wiphy, struct net_device *dev,
 720                                u8 *dst);
 721         int     (*change_mpath)(struct wiphy *wiphy, struct net_device *dev,
 722                                   u8 *dst, u8 *next_hop);
 723         int     (*get_mpath)(struct wiphy *wiphy, struct net_device *dev,
 724                                u8 *dst, u8 *next_hop,
 725                                struct mpath_info *pinfo);
 726         int     (*dump_mpath)(struct wiphy *wiphy, struct net_device *dev,
 727                                int idx, u8 *dst, u8 *next_hop,
 728                                struct mpath_info *pinfo);
 729         int     (*get_mesh_params)(struct wiphy *wiphy,
 730                                 struct net_device *dev,
 731                                 struct mesh_config *conf);
 732         int     (*set_mesh_params)(struct wiphy *wiphy,
 733                                 struct net_device *dev,
 734                                 const struct mesh_config *nconf, u32 mask);
 735         int     (*change_bss)(struct wiphy *wiphy, struct net_device *dev,
 736                               struct bss_parameters *params);
 737
 738         int     (*set_txq_params)(struct wiphy *wiphy,
 739                                   struct ieee80211_txq_params *params);
 740
 741         int     (*set_channel)(struct wiphy *wiphy,
 742                                struct ieee80211_channel *chan,
 743                                enum nl80211_channel_type channel_type);
 744
 745         int     (*set_mgmt_extra_ie)(struct wiphy *wiphy,
 746                                      struct net_device *dev,
 747                                      struct mgmt_extra_ie_params *params);
 748
 749         int     (*scan)(struct wiphy *wiphy, struct net_device *dev,
 750                         struct cfg80211_scan_request *request);
 751 };
 752
 753 /* temporary wext handlers */
 754 int cfg80211_wext_giwname(struct net_device *dev,
 755                           struct iw_request_info *info,
 756                           char *name, char *extra);
 757 int cfg80211_wext_siwmode(struct net_device *dev, struct iw_request_info *info,
 758                           u32 *mode, char *extra);
 759 int cfg80211_wext_giwmode(struct net_device *dev, struct iw_request_info *info,
 760                           u32 *mode, char *extra);
 761 int cfg80211_wext_siwscan(struct net_device *dev,
 762                           struct iw_request_info *info,
 763                           union iwreq_data *wrqu, char *extra);
 764 int cfg80211_wext_giwscan(struct net_device *dev,
 765                           struct iw_request_info *info,
 766                           struct iw_point *data, char *extra);
 767 int cfg80211_wext_giwrange(struct net_device *dev,
 768                            struct iw_request_info *info,
 769                            struct iw_point *data, char *extra);
 770
 771 /**
 772  * cfg80211_scan_done - notify that scan finished
 773  *
 774  * @request: the corresponding scan request
 775  * @aborted: set to true if the scan was aborted for any reason,
 776  *      userspace will be notified of that
 777  */
 778 void cfg80211_scan_done(struct cfg80211_scan_request *request, bool aborted);
 779
 780 /**
 781  * cfg80211_inform_bss - inform cfg80211 of a new BSS
 782  *
 783  * @wiphy: the wiphy reporting the BSS
 784  * @bss: the found BSS
 785  * @signal: the signal strength, type depends on the wiphy's signal_type
 786  * @gfp: context flags
 787  *
 788  * This informs cfg80211 that BSS information was found and
 789  * the BSS should be updated/added.
 790  */
 791 struct cfg80211_bss*
 792 cfg80211_inform_bss_frame(struct wiphy *wiphy,
 793                           struct ieee80211_channel *channel,
 794                           struct ieee80211_mgmt *mgmt, size_t len,
 795                           s32 signal, gfp_t gfp);
 796
 797 struct cfg80211_bss *cfg80211_get_bss(struct wiphy *wiphy,
 798                                       struct ieee80211_channel *channel,
 799                                       const u8 *bssid,
 800                                       const u8 *ssid, size_t ssid_len,
 801                                       u16 capa_mask, u16 capa_val);
 802 static inline struct cfg80211_bss *
 803 cfg80211_get_ibss(struct wiphy *wiphy,
 804                   struct ieee80211_channel *channel,
 805                   const u8 *ssid, size_t ssid_len)
 806 {
 807         return cfg80211_get_bss(wiphy, channel, NULL, ssid, ssid_len,
 808                                 WLAN_CAPABILITY_IBSS, WLAN_CAPABILITY_IBSS);
 809 }
 810
 811 struct cfg80211_bss *cfg80211_get_mesh(struct wiphy *wiphy,
 812                                        struct ieee80211_channel *channel,
 813                                        const u8 *meshid, size_t meshidlen,
 814                                        const u8 *meshcfg);
 815 void cfg80211_put_bss(struct cfg80211_bss *bss);
 816 /**
 817  * cfg80211_unlink_bss - unlink BSS from internal data structures
 818  * @wiphy: the wiphy
 819  * @bss: the bss to remove
 820  *
 821  * This function removes the given BSS from the internal data structures
 822  * thereby making it no longer show up in scan results etc. Use this
 823  * function when you detect a BSS is gone. Normally BSSes will also time
 824  * out, so it is not necessary to use this function at all.
 825  */
 826 void cfg80211_unlink_bss(struct wiphy *wiphy, struct cfg80211_bss *bss);
 827
 828 #endif /* __NET_CFG80211_H */