cfg80211: move all regulatory hints to workqueue
[linux-3.10.git] / 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_INIT: regulatory domain was set by initialization. We will be
354  *      using a static world regulatory domain by default.
355  * @REGDOM_SET_BY_CORE: Core queried CRDA for a dynamic world regulatory domain.
356  * @REGDOM_SET_BY_USER: User asked the wireless core to set the
357  *      regulatory domain.
358  * @REGDOM_SET_BY_DRIVER: a wireless drivers has hinted to the wireless core
359  *      it thinks its knows the regulatory domain we should be in.
360  * @REGDOM_SET_BY_COUNTRY_IE: the wireless core has received an 802.11 country
361  *      information element with regulatory information it thinks we
362  *      should consider.
363  */
364 enum reg_set_by {
365         REGDOM_SET_BY_INIT,
366         REGDOM_SET_BY_CORE,
367         REGDOM_SET_BY_USER,
368         REGDOM_SET_BY_DRIVER,
369         REGDOM_SET_BY_COUNTRY_IE,
370 };
371
372 /**
373  * enum environment_cap - Environment parsed from country IE
374  * @ENVIRON_ANY: indicates country IE applies to both indoor and
375  *      outdoor operation.
376  * @ENVIRON_INDOOR: indicates country IE applies only to indoor operation
377  * @ENVIRON_OUTDOOR: indicates country IE applies only to outdoor operation
378  */
379 enum environment_cap {
380         ENVIRON_ANY,
381         ENVIRON_INDOOR,
382         ENVIRON_OUTDOOR,
383 };
384
385 /**
386  * struct regulatory_request - used to keep track of regulatory requests
387  *
388  * @wiphy_idx: this is set if this request's initiator is
389  *      %REGDOM_SET_BY_COUNTRY_IE or %REGDOM_SET_BY_DRIVER. This
390  *      can be used by the wireless core to deal with conflicts
391  *      and potentially inform users of which devices specifically
392  *      cased the conflicts.
393  * @initiator: indicates who sent this request, could be any of
394  *      of those set in reg_set_by, %REGDOM_SET_BY_*
395  * @alpha2: the ISO / IEC 3166 alpha2 country code of the requested
396  *      regulatory domain. We have a few special codes:
397  *      00 - World regulatory domain
398  *      99 - built by driver but a specific alpha2 cannot be determined
399  *      98 - result of an intersection between two regulatory domains
400  * @intersect: indicates whether the wireless core should intersect
401  *      the requested regulatory domain with the presently set regulatory
402  *      domain.
403  * @country_ie_checksum: checksum of the last processed and accepted
404  *      country IE
405  * @country_ie_env: lets us know if the AP is telling us we are outdoor,
406  *      indoor, or if it doesn't matter
407  * @list: used to insert into the reg_requests_list linked list
408  */
409 struct regulatory_request {
410         int wiphy_idx;
411         enum reg_set_by initiator;
412         char alpha2[2];
413         bool intersect;
414         u32 country_ie_checksum;
415         enum environment_cap country_ie_env;
416         struct list_head list;
417 };
418
419 struct ieee80211_freq_range {
420         u32 start_freq_khz;
421         u32 end_freq_khz;
422         u32 max_bandwidth_khz;
423 };
424
425 struct ieee80211_power_rule {
426         u32 max_antenna_gain;
427         u32 max_eirp;
428 };
429
430 struct ieee80211_reg_rule {
431         struct ieee80211_freq_range freq_range;
432         struct ieee80211_power_rule power_rule;
433         u32 flags;
434 };
435
436 struct ieee80211_regdomain {
437         u32 n_reg_rules;
438         char alpha2[2];
439         struct ieee80211_reg_rule reg_rules[];
440 };
441
442 #define MHZ_TO_KHZ(freq) ((freq) * 1000)
443 #define KHZ_TO_MHZ(freq) ((freq) / 1000)
444 #define DBI_TO_MBI(gain) ((gain) * 100)
445 #define MBI_TO_DBI(gain) ((gain) / 100)
446 #define DBM_TO_MBM(gain) ((gain) * 100)
447 #define MBM_TO_DBM(gain) ((gain) / 100)
448
449 #define REG_RULE(start, end, bw, gain, eirp, reg_flags) { \
450         .freq_range.start_freq_khz = MHZ_TO_KHZ(start), \
451         .freq_range.end_freq_khz = MHZ_TO_KHZ(end), \
452         .freq_range.max_bandwidth_khz = MHZ_TO_KHZ(bw), \
453         .power_rule.max_antenna_gain = DBI_TO_MBI(gain), \
454         .power_rule.max_eirp = DBM_TO_MBM(eirp), \
455         .flags = reg_flags, \
456         }
457
458 struct mesh_config {
459         /* Timeouts in ms */
460         /* Mesh plink management parameters */
461         u16 dot11MeshRetryTimeout;
462         u16 dot11MeshConfirmTimeout;
463         u16 dot11MeshHoldingTimeout;
464         u16 dot11MeshMaxPeerLinks;
465         u8  dot11MeshMaxRetries;
466         u8  dot11MeshTTL;
467         bool auto_open_plinks;
468         /* HWMP parameters */
469         u8  dot11MeshHWMPmaxPREQretries;
470         u32 path_refresh_time;
471         u16 min_discovery_timeout;
472         u32 dot11MeshHWMPactivePathTimeout;
473         u16 dot11MeshHWMPpreqMinInterval;
474         u16 dot11MeshHWMPnetDiameterTraversalTime;
475 };
476
477 /**
478  * struct ieee80211_txq_params - TX queue parameters
479  * @queue: TX queue identifier (NL80211_TXQ_Q_*)
480  * @txop: Maximum burst time in units of 32 usecs, 0 meaning disabled
481  * @cwmin: Minimum contention window [a value of the form 2^n-1 in the range
482  *      1..32767]
483  * @cwmax: Maximum contention window [a value of the form 2^n-1 in the range
484  *      1..32767]
485  * @aifs: Arbitration interframe space [0..255]
486  */
487 struct ieee80211_txq_params {
488         enum nl80211_txq_q queue;
489         u16 txop;
490         u16 cwmin;
491         u16 cwmax;
492         u8 aifs;
493 };
494
495 /**
496  * struct mgmt_extra_ie_params - Extra management frame IE parameters
497  *
498  * Used to add extra IE(s) into management frames. If the driver cannot add the
499  * requested data into all management frames of the specified subtype that are
500  * generated in kernel or firmware/hardware, it must reject the configuration
501  * call. The IE data buffer is added to the end of the specified management
502  * frame body after all other IEs. This addition is not applied to frames that
503  * are injected through a monitor interface.
504  *
505  * @subtype: Management frame subtype
506  * @ies: IE data buffer or %NULL to remove previous data
507  * @ies_len: Length of @ies in octets
508  */
509 struct mgmt_extra_ie_params {
510         u8 subtype;
511         u8 *ies;
512         int ies_len;
513 };
514
515 /* from net/wireless.h */
516 struct wiphy;
517
518 /* from net/ieee80211.h */
519 struct ieee80211_channel;
520
521 /**
522  * struct cfg80211_ssid - SSID description
523  * @ssid: the SSID
524  * @ssid_len: length of the ssid
525  */
526 struct cfg80211_ssid {
527         u8 ssid[IEEE80211_MAX_SSID_LEN];
528         u8 ssid_len;
529 };
530
531 /**
532  * struct cfg80211_scan_request - scan request description
533  *
534  * @ssids: SSIDs to scan for (active scan only)
535  * @n_ssids: number of SSIDs
536  * @channels: channels to scan on.
537  * @n_channels: number of channels for each band
538  * @ie: optional information element(s) to add into Probe Request or %NULL
539  * @ie_len: length of ie in octets
540  * @wiphy: the wiphy this was for
541  * @ifidx: the interface index
542  */
543 struct cfg80211_scan_request {
544         struct cfg80211_ssid *ssids;
545         int n_ssids;
546         struct ieee80211_channel **channels;
547         u32 n_channels;
548         u8 *ie;
549         size_t ie_len;
550
551         /* internal */
552         struct wiphy *wiphy;
553         int ifidx;
554 };
555
556 /**
557  * enum cfg80211_signal_type - signal type
558  *
559  * @CFG80211_SIGNAL_TYPE_NONE: no signal strength information available
560  * @CFG80211_SIGNAL_TYPE_MBM: signal strength in mBm (100*dBm)
561  * @CFG80211_SIGNAL_TYPE_UNSPEC: signal strength, increasing from 0 through 100
562  */
563 enum cfg80211_signal_type {
564         CFG80211_SIGNAL_TYPE_NONE,
565         CFG80211_SIGNAL_TYPE_MBM,
566         CFG80211_SIGNAL_TYPE_UNSPEC,
567 };
568
569 /**
570  * struct cfg80211_bss - BSS description
571  *
572  * This structure describes a BSS (which may also be a mesh network)
573  * for use in scan results and similar.
574  *
575  * @bssid: BSSID of the BSS
576  * @tsf: timestamp of last received update
577  * @beacon_interval: the beacon interval as from the frame
578  * @capability: the capability field in host byte order
579  * @information_elements: the information elements (Note that there
580  *      is no guarantee that these are well-formed!)
581  * @len_information_elements: total length of the information elements
582  * @signal: signal strength value (type depends on the wiphy's signal_type)
583  * @free_priv: function pointer to free private data
584  * @priv: private area for driver use, has at least wiphy->bss_priv_size bytes
585  */
586 struct cfg80211_bss {
587         struct ieee80211_channel *channel;
588
589         u8 bssid[ETH_ALEN];
590         u64 tsf;
591         u16 beacon_interval;
592         u16 capability;
593         u8 *information_elements;
594         size_t len_information_elements;
595
596         s32 signal;
597
598         void (*free_priv)(struct cfg80211_bss *bss);
599         u8 priv[0] __attribute__((__aligned__(sizeof(void *))));
600 };
601
602 /**
603  * struct cfg80211_ops - backend description for wireless configuration
604  *
605  * This struct is registered by fullmac card drivers and/or wireless stacks
606  * in order to handle configuration requests on their interfaces.
607  *
608  * All callbacks except where otherwise noted should return 0
609  * on success or a negative error code.
610  *
611  * All operations are currently invoked under rtnl for consistency with the
612  * wireless extensions but this is subject to reevaluation as soon as this
613  * code is used more widely and we have a first user without wext.
614  *
615  * @suspend: wiphy device needs to be suspended
616  * @resume: wiphy device needs to be resumed
617  *
618  * @add_virtual_intf: create a new virtual interface with the given name,
619  *      must set the struct wireless_dev's iftype.
620  *
621  * @del_virtual_intf: remove the virtual interface determined by ifindex.
622  *
623  * @change_virtual_intf: change type/configuration of virtual interface,
624  *      keep the struct wireless_dev's iftype updated.
625  *
626  * @add_key: add a key with the given parameters. @mac_addr will be %NULL
627  *      when adding a group key.
628  *
629  * @get_key: get information about the key with the given parameters.
630  *      @mac_addr will be %NULL when requesting information for a group
631  *      key. All pointers given to the @callback function need not be valid
632  *      after it returns.
633  *
634  * @del_key: remove a key given the @mac_addr (%NULL for a group key)
635  *      and @key_index
636  *
637  * @set_default_key: set the default key on an interface
638  *
639  * @set_default_mgmt_key: set the default management frame key on an interface
640  *
641  * @add_beacon: Add a beacon with given parameters, @head, @interval
642  *      and @dtim_period will be valid, @tail is optional.
643  * @set_beacon: Change the beacon parameters for an access point mode
644  *      interface. This should reject the call when no beacon has been
645  *      configured.
646  * @del_beacon: Remove beacon configuration and stop sending the beacon.
647  *
648  * @add_station: Add a new station.
649  *
650  * @del_station: Remove a station; @mac may be NULL to remove all stations.
651  *
652  * @change_station: Modify a given station.
653  *
654  * @get_mesh_params: Put the current mesh parameters into *params
655  *
656  * @set_mesh_params: Set mesh parameters.
657  *      The mask is a bitfield which tells us which parameters to
658  *      set, and which to leave alone.
659  *
660  * @set_mesh_cfg: set mesh parameters (by now, just mesh id)
661  *
662  * @change_bss: Modify parameters for a given BSS.
663  *
664  * @set_txq_params: Set TX queue parameters
665  *
666  * @set_channel: Set channel
667  *
668  * @set_mgmt_extra_ie: Set extra IE data for management frames
669  *
670  * @scan: Request to do a scan. If returning zero, the scan request is given
671  *      the driver, and will be valid until passed to cfg80211_scan_done().
672  *      For scan results, call cfg80211_inform_bss(); you can call this outside
673  *      the scan/scan_done bracket too.
674  */
675 struct cfg80211_ops {
676         int     (*suspend)(struct wiphy *wiphy);
677         int     (*resume)(struct wiphy *wiphy);
678
679         int     (*add_virtual_intf)(struct wiphy *wiphy, char *name,
680                                     enum nl80211_iftype type, u32 *flags,
681                                     struct vif_params *params);
682         int     (*del_virtual_intf)(struct wiphy *wiphy, int ifindex);
683         int     (*change_virtual_intf)(struct wiphy *wiphy, int ifindex,
684                                        enum nl80211_iftype type, u32 *flags,
685                                        struct vif_params *params);
686
687         int     (*add_key)(struct wiphy *wiphy, struct net_device *netdev,
688                            u8 key_index, u8 *mac_addr,
689                            struct key_params *params);
690         int     (*get_key)(struct wiphy *wiphy, struct net_device *netdev,
691                            u8 key_index, u8 *mac_addr, void *cookie,
692                            void (*callback)(void *cookie, struct key_params*));
693         int     (*del_key)(struct wiphy *wiphy, struct net_device *netdev,
694                            u8 key_index, u8 *mac_addr);
695         int     (*set_default_key)(struct wiphy *wiphy,
696                                    struct net_device *netdev,
697                                    u8 key_index);
698         int     (*set_default_mgmt_key)(struct wiphy *wiphy,
699                                         struct net_device *netdev,
700                                         u8 key_index);
701
702         int     (*add_beacon)(struct wiphy *wiphy, struct net_device *dev,
703                               struct beacon_parameters *info);
704         int     (*set_beacon)(struct wiphy *wiphy, struct net_device *dev,
705                               struct beacon_parameters *info);
706         int     (*del_beacon)(struct wiphy *wiphy, struct net_device *dev);
707
708
709         int     (*add_station)(struct wiphy *wiphy, struct net_device *dev,
710                                u8 *mac, struct station_parameters *params);
711         int     (*del_station)(struct wiphy *wiphy, struct net_device *dev,
712                                u8 *mac);
713         int     (*change_station)(struct wiphy *wiphy, struct net_device *dev,
714                                   u8 *mac, struct station_parameters *params);
715         int     (*get_station)(struct wiphy *wiphy, struct net_device *dev,
716                                u8 *mac, struct station_info *sinfo);
717         int     (*dump_station)(struct wiphy *wiphy, struct net_device *dev,
718                                int idx, u8 *mac, struct station_info *sinfo);
719
720         int     (*add_mpath)(struct wiphy *wiphy, struct net_device *dev,
721                                u8 *dst, u8 *next_hop);
722         int     (*del_mpath)(struct wiphy *wiphy, struct net_device *dev,
723                                u8 *dst);
724         int     (*change_mpath)(struct wiphy *wiphy, struct net_device *dev,
725                                   u8 *dst, u8 *next_hop);
726         int     (*get_mpath)(struct wiphy *wiphy, struct net_device *dev,
727                                u8 *dst, u8 *next_hop,
728                                struct mpath_info *pinfo);
729         int     (*dump_mpath)(struct wiphy *wiphy, struct net_device *dev,
730                                int idx, u8 *dst, u8 *next_hop,
731                                struct mpath_info *pinfo);
732         int     (*get_mesh_params)(struct wiphy *wiphy,
733                                 struct net_device *dev,
734                                 struct mesh_config *conf);
735         int     (*set_mesh_params)(struct wiphy *wiphy,
736                                 struct net_device *dev,
737                                 const struct mesh_config *nconf, u32 mask);
738         int     (*change_bss)(struct wiphy *wiphy, struct net_device *dev,
739                               struct bss_parameters *params);
740
741         int     (*set_txq_params)(struct wiphy *wiphy,
742                                   struct ieee80211_txq_params *params);
743
744         int     (*set_channel)(struct wiphy *wiphy,
745                                struct ieee80211_channel *chan,
746                                enum nl80211_channel_type channel_type);
747
748         int     (*set_mgmt_extra_ie)(struct wiphy *wiphy,
749                                      struct net_device *dev,
750                                      struct mgmt_extra_ie_params *params);
751
752         int     (*scan)(struct wiphy *wiphy, struct net_device *dev,
753                         struct cfg80211_scan_request *request);
754 };
755
756 /* temporary wext handlers */
757 int cfg80211_wext_giwname(struct net_device *dev,
758                           struct iw_request_info *info,
759                           char *name, char *extra);
760 int cfg80211_wext_siwmode(struct net_device *dev, struct iw_request_info *info,
761                           u32 *mode, char *extra);
762 int cfg80211_wext_giwmode(struct net_device *dev, struct iw_request_info *info,
763                           u32 *mode, char *extra);
764 int cfg80211_wext_siwscan(struct net_device *dev,
765                           struct iw_request_info *info,
766                           union iwreq_data *wrqu, char *extra);
767 int cfg80211_wext_giwscan(struct net_device *dev,
768                           struct iw_request_info *info,
769                           struct iw_point *data, char *extra);
770 int cfg80211_wext_giwrange(struct net_device *dev,
771                            struct iw_request_info *info,
772                            struct iw_point *data, char *extra);
773
774 /**
775  * cfg80211_scan_done - notify that scan finished
776  *
777  * @request: the corresponding scan request
778  * @aborted: set to true if the scan was aborted for any reason,
779  *      userspace will be notified of that
780  */
781 void cfg80211_scan_done(struct cfg80211_scan_request *request, bool aborted);
782
783 /**
784  * cfg80211_inform_bss - inform cfg80211 of a new BSS
785  *
786  * @wiphy: the wiphy reporting the BSS
787  * @bss: the found BSS
788  * @signal: the signal strength, type depends on the wiphy's signal_type
789  * @gfp: context flags
790  *
791  * This informs cfg80211 that BSS information was found and
792  * the BSS should be updated/added.
793  */
794 struct cfg80211_bss*
795 cfg80211_inform_bss_frame(struct wiphy *wiphy,
796                           struct ieee80211_channel *channel,
797                           struct ieee80211_mgmt *mgmt, size_t len,
798                           s32 signal, gfp_t gfp);
799
800 struct cfg80211_bss *cfg80211_get_bss(struct wiphy *wiphy,
801                                       struct ieee80211_channel *channel,
802                                       const u8 *bssid,
803                                       const u8 *ssid, size_t ssid_len,
804                                       u16 capa_mask, u16 capa_val);
805 static inline struct cfg80211_bss *
806 cfg80211_get_ibss(struct wiphy *wiphy,
807                   struct ieee80211_channel *channel,
808                   const u8 *ssid, size_t ssid_len)
809 {
810         return cfg80211_get_bss(wiphy, channel, NULL, ssid, ssid_len,
811                                 WLAN_CAPABILITY_IBSS, WLAN_CAPABILITY_IBSS);
812 }
813
814 struct cfg80211_bss *cfg80211_get_mesh(struct wiphy *wiphy,
815                                        struct ieee80211_channel *channel,
816                                        const u8 *meshid, size_t meshidlen,
817                                        const u8 *meshcfg);
818 void cfg80211_put_bss(struct cfg80211_bss *bss);
819 /**
820  * cfg80211_unlink_bss - unlink BSS from internal data structures
821  * @wiphy: the wiphy
822  * @bss: the bss to remove
823  *
824  * This function removes the given BSS from the internal data structures
825  * thereby making it no longer show up in scan results etc. Use this
826  * function when you detect a BSS is gone. Normally BSSes will also time
827  * out, so it is not necessary to use this function at all.
828  */
829 void cfg80211_unlink_bss(struct wiphy *wiphy, struct cfg80211_bss *bss);
830
831 #endif /* __NET_CFG80211_H */