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