1 /* SPDX-License-Identifier: GPL-2.0-only */
2 /*
3 * Merged with mainline ieee80211.h in Aug 2004. Original ieee802_11
4 * remains copyright by the original authors
5 *
6 * Portions of the merged code are based on Host AP (software wireless
7 * LAN access point) driver for Intersil Prism2/2.5/3.
8 *
9 * Copyright (c) 2001-2002, SSH Communications Security Corp and Jouni Malinen
10 * <j@w1.fi>
11 * Copyright (c) 2002-2003, Jouni Malinen <j@w1.fi>
12 *
13 * Adaption to a generic IEEE 802.11 stack by James Ketrenos
14 * <jketreno@linux.intel.com>
15 * Copyright (c) 2004-2005, Intel Corporation
16 *
17 * API Version History
18 * 1.0.x -- Initial version
19 * 1.1.x -- Added radiotap, QoS, TIM, libipw_geo APIs,
20 * various structure changes, and crypto API init method
21 */
22 #ifndef LIBIPW_H
23 #define LIBIPW_H
24 #include <linux/if_ether.h> /* ETH_ALEN */
25 #include <linux/kernel.h> /* ARRAY_SIZE */
26 #include <linux/wireless.h>
27 #include <linux/ieee80211.h>
28 #include <net/cfg80211.h>
29
30 #define LIBIPW_VERSION "git-1.1.13"
31
32 #define LIBIPW_DATA_LEN 2304
33 /* Maximum size for the MA-UNITDATA primitive, 802.11 standard section
34 6.2.1.1.2.
35
36 The figure in section 7.1.2 suggests a body size of up to 2312
37 bytes is allowed, which is a bit confusing, I suspect this
38 represents the 2304 bytes of real data, plus a possible 8 bytes of
39 WEP IV and ICV. (this interpretation suggested by Ramiro Barreiro) */
40
41 #define LIBIPW_1ADDR_LEN 10
42 #define LIBIPW_2ADDR_LEN 16
43 #define LIBIPW_3ADDR_LEN 24
44 #define LIBIPW_4ADDR_LEN 30
45 #define LIBIPW_FCS_LEN 4
46 #define LIBIPW_HLEN (LIBIPW_4ADDR_LEN)
47 #define LIBIPW_FRAME_LEN (LIBIPW_DATA_LEN + LIBIPW_HLEN)
48
49 #define MIN_FRAG_THRESHOLD 256U
50 #define MAX_FRAG_THRESHOLD 2346U
51
52 /* QOS control */
53 #define LIBIPW_QCTL_TID 0x000F
54
55 /* debug macros */
56
57 #ifdef CONFIG_LIBIPW_DEBUG
58 extern u32 libipw_debug_level;
59 #define LIBIPW_DEBUG(level, fmt, args...) \
60 do { if (libipw_debug_level & (level)) \
61 printk(KERN_DEBUG "libipw: %s " fmt, __func__ , ## args); } while (0)
62 #else
63 #define LIBIPW_DEBUG(level, fmt, args...) do {} while (0)
64 #endif /* CONFIG_LIBIPW_DEBUG */
65
66 /*
67 * To use the debug system:
68 *
69 * If you are defining a new debug classification, simply add it to the #define
70 * list here in the form of:
71 *
72 * #define LIBIPW_DL_xxxx VALUE
73 *
74 * shifting value to the left one bit from the previous entry. xxxx should be
75 * the name of the classification (for example, WEP)
76 *
77 * You then need to either add a LIBIPW_xxxx_DEBUG() macro definition for your
78 * classification, or use LIBIPW_DEBUG(LIBIPW_DL_xxxx, ...) whenever you want
79 * to send output to that classification.
80 *
81 * To add your debug level to the list of levels seen when you perform
82 *
83 * % cat /proc/net/ieee80211/debug_level
84 *
85 * you simply need to add your entry to the libipw_debug_level array.
86 *
87 * If you do not see debug_level in /proc/net/ieee80211 then you do not have
88 * CONFIG_LIBIPW_DEBUG defined in your kernel configuration
89 *
90 */
91
92 #define LIBIPW_DL_INFO (1<<0)
93 #define LIBIPW_DL_WX (1<<1)
94 #define LIBIPW_DL_SCAN (1<<2)
95 #define LIBIPW_DL_STATE (1<<3)
96 #define LIBIPW_DL_MGMT (1<<4)
97 #define LIBIPW_DL_FRAG (1<<5)
98 #define LIBIPW_DL_DROP (1<<7)
99
100 #define LIBIPW_DL_TX (1<<8)
101 #define LIBIPW_DL_RX (1<<9)
102 #define LIBIPW_DL_QOS (1<<31)
103
104 #define LIBIPW_ERROR(f, a...) printk(KERN_ERR "libipw: " f, ## a)
105 #define LIBIPW_WARNING(f, a...) printk(KERN_WARNING "libipw: " f, ## a)
106 #define LIBIPW_DEBUG_INFO(f, a...) LIBIPW_DEBUG(LIBIPW_DL_INFO, f, ## a)
107
108 #define LIBIPW_DEBUG_WX(f, a...) LIBIPW_DEBUG(LIBIPW_DL_WX, f, ## a)
109 #define LIBIPW_DEBUG_SCAN(f, a...) LIBIPW_DEBUG(LIBIPW_DL_SCAN, f, ## a)
110 #define LIBIPW_DEBUG_STATE(f, a...) LIBIPW_DEBUG(LIBIPW_DL_STATE, f, ## a)
111 #define LIBIPW_DEBUG_MGMT(f, a...) LIBIPW_DEBUG(LIBIPW_DL_MGMT, f, ## a)
112 #define LIBIPW_DEBUG_FRAG(f, a...) LIBIPW_DEBUG(LIBIPW_DL_FRAG, f, ## a)
113 #define LIBIPW_DEBUG_DROP(f, a...) LIBIPW_DEBUG(LIBIPW_DL_DROP, f, ## a)
114 #define LIBIPW_DEBUG_TX(f, a...) LIBIPW_DEBUG(LIBIPW_DL_TX, f, ## a)
115 #define LIBIPW_DEBUG_RX(f, a...) LIBIPW_DEBUG(LIBIPW_DL_RX, f, ## a)
116 #define LIBIPW_DEBUG_QOS(f, a...) LIBIPW_DEBUG(LIBIPW_DL_QOS, f, ## a)
117 #include <linux/netdevice.h>
118 #include <linux/if_arp.h> /* ARPHRD_ETHER */
119
120 #ifndef WIRELESS_SPY
121 #define WIRELESS_SPY /* enable iwspy support */
122 #endif
123 #include <net/iw_handler.h> /* new driver API */
124
125 #define ETH_P_PREAUTH 0x88C7 /* IEEE 802.11i pre-authentication */
126
127 #ifndef ETH_P_80211_RAW
128 #define ETH_P_80211_RAW (ETH_P_ECONET + 1)
129 #endif
130
131 /* IEEE 802.11 defines */
132
133 #define P80211_OUI_LEN 3
134
135 struct libipw_snap_hdr {
136
137 u8 dsap; /* always 0xAA */
138 u8 ssap; /* always 0xAA */
139 u8 ctrl; /* always 0x03 */
140 u8 oui[P80211_OUI_LEN]; /* organizational universal id */
141
142 } __packed;
143
144 #define SNAP_SIZE sizeof(struct libipw_snap_hdr)
145
146 #define WLAN_FC_GET_VERS(fc) ((fc) & IEEE80211_FCTL_VERS)
147 #define WLAN_FC_GET_TYPE(fc) ((fc) & IEEE80211_FCTL_FTYPE)
148 #define WLAN_FC_GET_STYPE(fc) ((fc) & IEEE80211_FCTL_STYPE)
149
150 #define WLAN_GET_SEQ_FRAG(seq) ((seq) & IEEE80211_SCTL_FRAG)
151 #define WLAN_GET_SEQ_SEQ(seq) (((seq) & IEEE80211_SCTL_SEQ) >> 4)
152
153 #define LIBIPW_STATMASK_SIGNAL (1<<0)
154 #define LIBIPW_STATMASK_RSSI (1<<1)
155 #define LIBIPW_STATMASK_NOISE (1<<2)
156 #define LIBIPW_STATMASK_RATE (1<<3)
157 #define LIBIPW_STATMASK_WEMASK 0x7
158
159 #define LIBIPW_CCK_MODULATION (1<<0)
160 #define LIBIPW_OFDM_MODULATION (1<<1)
161
162 #define LIBIPW_24GHZ_BAND (1<<0)
163 #define LIBIPW_52GHZ_BAND (1<<1)
164
165 #define LIBIPW_CCK_RATE_1MB 0x02
166 #define LIBIPW_CCK_RATE_2MB 0x04
167 #define LIBIPW_CCK_RATE_5MB 0x0B
168 #define LIBIPW_CCK_RATE_11MB 0x16
169 #define LIBIPW_OFDM_RATE_6MB 0x0C
170 #define LIBIPW_OFDM_RATE_9MB 0x12
171 #define LIBIPW_OFDM_RATE_12MB 0x18
172 #define LIBIPW_OFDM_RATE_18MB 0x24
173 #define LIBIPW_OFDM_RATE_24MB 0x30
174 #define LIBIPW_OFDM_RATE_36MB 0x48
175 #define LIBIPW_OFDM_RATE_48MB 0x60
176 #define LIBIPW_OFDM_RATE_54MB 0x6C
177 #define LIBIPW_BASIC_RATE_MASK 0x80
178
179 #define LIBIPW_CCK_RATE_1MB_MASK (1<<0)
180 #define LIBIPW_CCK_RATE_2MB_MASK (1<<1)
181 #define LIBIPW_CCK_RATE_5MB_MASK (1<<2)
182 #define LIBIPW_CCK_RATE_11MB_MASK (1<<3)
183 #define LIBIPW_OFDM_RATE_6MB_MASK (1<<4)
184 #define LIBIPW_OFDM_RATE_9MB_MASK (1<<5)
185 #define LIBIPW_OFDM_RATE_12MB_MASK (1<<6)
186 #define LIBIPW_OFDM_RATE_18MB_MASK (1<<7)
187 #define LIBIPW_OFDM_RATE_24MB_MASK (1<<8)
188 #define LIBIPW_OFDM_RATE_36MB_MASK (1<<9)
189 #define LIBIPW_OFDM_RATE_48MB_MASK (1<<10)
190 #define LIBIPW_OFDM_RATE_54MB_MASK (1<<11)
191
192 #define LIBIPW_CCK_RATES_MASK 0x0000000F
193 #define LIBIPW_CCK_BASIC_RATES_MASK (LIBIPW_CCK_RATE_1MB_MASK | \
194 LIBIPW_CCK_RATE_2MB_MASK)
195 #define LIBIPW_CCK_DEFAULT_RATES_MASK (LIBIPW_CCK_BASIC_RATES_MASK | \
196 LIBIPW_CCK_RATE_5MB_MASK | \
197 LIBIPW_CCK_RATE_11MB_MASK)
198
199 #define LIBIPW_OFDM_RATES_MASK 0x00000FF0
200 #define LIBIPW_OFDM_BASIC_RATES_MASK (LIBIPW_OFDM_RATE_6MB_MASK | \
201 LIBIPW_OFDM_RATE_12MB_MASK | \
202 LIBIPW_OFDM_RATE_24MB_MASK)
203 #define LIBIPW_OFDM_DEFAULT_RATES_MASK (LIBIPW_OFDM_BASIC_RATES_MASK | \
204 LIBIPW_OFDM_RATE_9MB_MASK | \
205 LIBIPW_OFDM_RATE_18MB_MASK | \
206 LIBIPW_OFDM_RATE_36MB_MASK | \
207 LIBIPW_OFDM_RATE_48MB_MASK | \
208 LIBIPW_OFDM_RATE_54MB_MASK)
209 #define LIBIPW_DEFAULT_RATES_MASK (LIBIPW_OFDM_DEFAULT_RATES_MASK | \
210 LIBIPW_CCK_DEFAULT_RATES_MASK)
211
212 #define LIBIPW_NUM_OFDM_RATES 8
213 #define LIBIPW_NUM_CCK_RATES 4
214 #define LIBIPW_OFDM_SHIFT_MASK_A 4
215
216 /* NOTE: This data is for statistical purposes; not all hardware provides this
217 * information for frames received.
218 * For libipw_rx_mgt, you need to set at least the 'len' parameter.
219 */
220 struct libipw_rx_stats {
221 u32 mac_time;
222 s8 rssi;
223 u8 signal;
224 u8 noise;
225 u16 rate; /* in 100 kbps */
226 u8 received_channel;
227 u8 control;
228 u8 mask;
229 u8 freq;
230 u16 len;
231 u64 tsf;
232 u32 beacon_time;
233 };
234
235 /* IEEE 802.11 requires that STA supports concurrent reception of at least
236 * three fragmented frames. This define can be increased to support more
237 * concurrent frames, but it should be noted that each entry can consume about
238 * 2 kB of RAM and increasing cache size will slow down frame reassembly. */
239 #define LIBIPW_FRAG_CACHE_LEN 4
240
241 struct libipw_frag_entry {
242 unsigned long first_frag_time;
243 unsigned int seq;
244 unsigned int last_frag;
245 struct sk_buff *skb;
246 u8 src_addr[ETH_ALEN];
247 u8 dst_addr[ETH_ALEN];
248 };
249
250 struct libipw_stats {
251 unsigned int tx_unicast_frames;
252 unsigned int tx_multicast_frames;
253 unsigned int tx_fragments;
254 unsigned int tx_unicast_octets;
255 unsigned int tx_multicast_octets;
256 unsigned int tx_deferred_transmissions;
257 unsigned int tx_single_retry_frames;
258 unsigned int tx_multiple_retry_frames;
259 unsigned int tx_retry_limit_exceeded;
260 unsigned int tx_discards;
261 unsigned int rx_unicast_frames;
262 unsigned int rx_multicast_frames;
263 unsigned int rx_fragments;
264 unsigned int rx_unicast_octets;
265 unsigned int rx_multicast_octets;
266 unsigned int rx_fcs_errors;
267 unsigned int rx_discards_no_buffer;
268 unsigned int tx_discards_wrong_sa;
269 unsigned int rx_discards_undecryptable;
270 unsigned int rx_message_in_msg_fragments;
271 unsigned int rx_message_in_bad_msg_fragments;
272 };
273
274 struct libipw_device;
275
276 #define SEC_KEY_1 (1<<0)
277 #define SEC_KEY_2 (1<<1)
278 #define SEC_KEY_3 (1<<2)
279 #define SEC_KEY_4 (1<<3)
280 #define SEC_ACTIVE_KEY (1<<4)
281 #define SEC_AUTH_MODE (1<<5)
282 #define SEC_UNICAST_GROUP (1<<6)
283 #define SEC_LEVEL (1<<7)
284 #define SEC_ENABLED (1<<8)
285 #define SEC_ENCRYPT (1<<9)
286
287 #define SEC_LEVEL_0 0 /* None */
288 #define SEC_LEVEL_1 1 /* WEP 40 and 104 bit */
289 #define SEC_LEVEL_2 2 /* Level 1 + TKIP */
290 #define SEC_LEVEL_2_CKIP 3 /* Level 1 + CKIP */
291 #define SEC_LEVEL_3 4 /* Level 2 + CCMP */
292
293 #define SEC_ALG_NONE 0
294 #define SEC_ALG_WEP 1
295 #define SEC_ALG_TKIP 2
296 #define SEC_ALG_CCMP 3
297
298 #define WEP_KEYS 4
299 #define WEP_KEY_LEN 13
300 #define SCM_KEY_LEN 32
301 #define SCM_TEMPORAL_KEY_LENGTH 16
302
303 struct libipw_security {
304 u16 active_key:2, enabled:1, unicast_uses_group:1, encrypt:1;
305 u8 auth_mode;
306 u8 encode_alg[WEP_KEYS];
307 u8 key_sizes[WEP_KEYS];
308 u8 keys[WEP_KEYS][SCM_KEY_LEN];
309 u8 level;
310 u16 flags;
311 } __packed;
312
313 /*
314
315 802.11 data frame from AP
316
317 ,-------------------------------------------------------------------.
318 Bytes | 2 | 2 | 6 | 6 | 6 | 2 | 0..2312 | 4 |
319 |------|------|---------|---------|---------|------|---------|------|
320 Desc. | ctrl | dura | DA/RA | TA | SA | Sequ | frame | fcs |
321 | | tion | (BSSID) | | | ence | data | |
322 `-------------------------------------------------------------------'
323
324 Total: 28-2340 bytes
325
326 */
327
328 #define BEACON_PROBE_SSID_ID_POSITION 12
329
330 struct libipw_hdr_1addr {
331 __le16 frame_ctl;
332 __le16 duration_id;
333 u8 addr1[ETH_ALEN];
334 u8 payload[];
335 } __packed;
336
337 struct libipw_hdr_2addr {
338 __le16 frame_ctl;
339 __le16 duration_id;
340 u8 addr1[ETH_ALEN];
341 u8 addr2[ETH_ALEN];
342 u8 payload[];
343 } __packed;
344
345 struct libipw_hdr_3addr {
346 /* New members MUST be added within the __struct_group() macro below. */
347 __struct_group(libipw_hdr_3addr_hdr, hdr, __packed,
348 __le16 frame_ctl;
349 __le16 duration_id;
350 u8 addr1[ETH_ALEN];
351 u8 addr2[ETH_ALEN];
352 u8 addr3[ETH_ALEN];
353 __le16 seq_ctl;
354 );
355 u8 payload[];
356 } __packed;
357 static_assert(offsetof(struct libipw_hdr_3addr, payload) == sizeof(struct libipw_hdr_3addr_hdr),
358 "struct member likely outside of __struct_group()");
359
360 struct libipw_hdr_4addr {
361 __le16 frame_ctl;
362 __le16 duration_id;
363 u8 addr1[ETH_ALEN];
364 u8 addr2[ETH_ALEN];
365 u8 addr3[ETH_ALEN];
366 __le16 seq_ctl;
367 u8 addr4[ETH_ALEN];
368 u8 payload[];
369 } __packed;
370
371 struct libipw_hdr_3addrqos {
372 __le16 frame_ctl;
373 __le16 duration_id;
374 u8 addr1[ETH_ALEN];
375 u8 addr2[ETH_ALEN];
376 u8 addr3[ETH_ALEN];
377 __le16 seq_ctl;
378 u8 payload[0];
379 __le16 qos_ctl;
380 } __packed;
381
382 struct libipw_info_element {
383 u8 id;
384 u8 len;
385 u8 data[];
386 } __packed;
387
388 /*
389 * These are the data types that can make up management packets
390 *
391 u16 auth_algorithm;
392 u16 auth_sequence;
393 u16 beacon_interval;
394 u16 capability;
395 u8 current_ap[ETH_ALEN];
396 u16 listen_interval;
397 struct {
398 u16 association_id:14, reserved:2;
399 } __packed;
400 u32 time_stamp[2];
401 u16 reason;
402 u16 status;
403 */
404
405 struct libipw_auth {
406 struct libipw_hdr_3addr_hdr header;
407 __le16 algorithm;
408 __le16 transaction;
409 __le16 status;
410 /* challenge */
411 u8 variable[];
412 } __packed;
413
414 struct libipw_channel_switch {
415 u8 id;
416 u8 len;
417 u8 mode;
418 u8 channel;
419 u8 count;
420 } __packed;
421
422 struct libipw_action {
423 struct libipw_hdr_3addr_hdr header;
424 u8 category;
425 u8 action;
426 union {
427 struct libipw_action_exchange {
428 u8 token;
429 } exchange;
430 struct libipw_channel_switch channel_switch;
431
432 } format;
433 } __packed;
434
435 struct libipw_disassoc {
436 struct libipw_hdr_3addr_hdr header;
437 __le16 reason;
438 } __packed;
439
440 /* Alias deauth for disassoc */
441 #define libipw_deauth libipw_disassoc
442
443 struct libipw_probe_request {
444 struct libipw_hdr_3addr_hdr header;
445 /* SSID, supported rates */
446 u8 variable[];
447 } __packed;
448
449 struct libipw_probe_response {
450 struct libipw_hdr_3addr_hdr header;
451 __le32 time_stamp[2];
452 __le16 beacon_interval;
453 __le16 capability;
454 /* SSID, supported rates, FH params, DS params,
455 * CF params, IBSS params, TIM (if beacon), RSN */
456 u8 variable[];
457 } __packed;
458
459 /* Alias beacon for probe_response */
460 #define libipw_beacon libipw_probe_response
461
462 struct libipw_reassoc_request {
463 struct libipw_hdr_3addr_hdr header;
464 __le16 capability;
465 __le16 listen_interval;
466 u8 current_ap[ETH_ALEN];
467 u8 variable[];
468 } __packed;
469
470 struct libipw_assoc_response {
471 struct libipw_hdr_3addr_hdr header;
472 __le16 capability;
473 __le16 status;
474 __le16 aid;
475 /* supported rates */
476 u8 variable[];
477 } __packed;
478
479 struct libipw_txb {
480 u8 nr_frags;
481 u8 encrypted;
482 u8 rts_included;
483 u8 reserved;
484 u16 frag_size;
485 u16 payload_size;
486 struct sk_buff *fragments[] __counted_by(nr_frags);
487 };
488
489 /* SWEEP TABLE ENTRIES NUMBER */
490 #define MAX_SWEEP_TAB_ENTRIES 42
491 #define MAX_SWEEP_TAB_ENTRIES_PER_PACKET 7
492 /* MAX_RATES_LENGTH needs to be 12. The spec says 8, and many APs
493 * only use 8, and then use extended rates for the remaining supported
494 * rates. Other APs, however, stick all of their supported rates on the
495 * main rates information element... */
496 #define MAX_RATES_LENGTH ((u8)12)
497 #define MAX_RATES_EX_LENGTH ((u8)16)
498 #define MAX_NETWORK_COUNT 128
499
500 #define CRC_LENGTH 4U
501
502 #define MAX_WPA_IE_LEN 64
503
504 #define NETWORK_HAS_OFDM (1<<1)
505 #define NETWORK_HAS_CCK (1<<2)
506
507 /* QoS structure */
508 #define NETWORK_HAS_QOS_PARAMETERS (1<<3)
509 #define NETWORK_HAS_QOS_INFORMATION (1<<4)
510 #define NETWORK_HAS_QOS_MASK (NETWORK_HAS_QOS_PARAMETERS | \
511 NETWORK_HAS_QOS_INFORMATION)
512
513 /* 802.11h */
514 #define NETWORK_HAS_POWER_CONSTRAINT (1<<5)
515 #define NETWORK_HAS_CSA (1<<6)
516 #define NETWORK_HAS_QUIET (1<<7)
517 #define NETWORK_HAS_IBSS_DFS (1<<8)
518 #define NETWORK_HAS_TPC_REPORT (1<<9)
519
520 #define NETWORK_HAS_ERP_VALUE (1<<10)
521
522 #define QOS_QUEUE_NUM 4
523 #define QOS_OUI_LEN 3
524 #define QOS_OUI_TYPE 2
525 #define QOS_ELEMENT_ID 221
526 #define QOS_OUI_INFO_SUB_TYPE 0
527 #define QOS_OUI_PARAM_SUB_TYPE 1
528 #define QOS_VERSION_1 1
529 #define QOS_AIFSN_MIN_VALUE 2
530
531 struct libipw_qos_information_element {
532 u8 elementID;
533 u8 length;
534 u8 qui[QOS_OUI_LEN];
535 u8 qui_type;
536 u8 qui_subtype;
537 u8 version;
538 u8 ac_info;
539 } __packed;
540
541 struct libipw_qos_ac_parameter {
542 u8 aci_aifsn;
543 u8 ecw_min_max;
544 __le16 tx_op_limit;
545 } __packed;
546
547 struct libipw_qos_parameter_info {
548 struct libipw_qos_information_element info_element;
549 u8 reserved;
550 struct libipw_qos_ac_parameter ac_params_record[QOS_QUEUE_NUM];
551 } __packed;
552
553 struct libipw_qos_parameters {
554 __le16 cw_min[QOS_QUEUE_NUM];
555 __le16 cw_max[QOS_QUEUE_NUM];
556 u8 aifs[QOS_QUEUE_NUM];
557 u8 flag[QOS_QUEUE_NUM];
558 __le16 tx_op_limit[QOS_QUEUE_NUM];
559 } __packed;
560
561 struct libipw_qos_data {
562 struct libipw_qos_parameters parameters;
563 int active;
564 int supported;
565 u8 param_count;
566 u8 old_param_count;
567 };
568
569 struct libipw_tim_parameters {
570 u8 tim_count;
571 u8 tim_period;
572 } __packed;
573
574 /*******************************************************/
575
576 struct libipw_tpc_report {
577 u8 transmit_power;
578 u8 link_margin;
579 } __packed;
580
581 struct libipw_channel_map {
582 u8 channel;
583 u8 map;
584 } __packed;
585
586 struct libipw_csa {
587 u8 mode;
588 u8 channel;
589 u8 count;
590 } __packed;
591
592 struct libipw_quiet {
593 u8 count;
594 u8 period;
595 u8 duration;
596 u8 offset;
597 } __packed;
598
599 struct libipw_network {
600 /* These entries are used to identify a unique network */
601 u8 bssid[ETH_ALEN];
602 u8 channel;
603 /* Ensure null-terminated for any debug msgs */
604 u8 ssid[IW_ESSID_MAX_SIZE + 1];
605 u8 ssid_len;
606
607 struct libipw_qos_data qos_data;
608
609 /* These are network statistics */
610 struct libipw_rx_stats stats;
611 u16 capability;
612 u8 rates[MAX_RATES_LENGTH];
613 u8 rates_len;
614 u8 rates_ex[MAX_RATES_EX_LENGTH];
615 u8 rates_ex_len;
616 unsigned long last_scanned;
617 u8 mode;
618 u32 flags;
619 u32 last_associate;
620 u32 time_stamp[2];
621 u16 beacon_interval;
622 u16 listen_interval;
623 u16 atim_window;
624 u8 erp_value;
625 u8 wpa_ie[MAX_WPA_IE_LEN];
626 size_t wpa_ie_len;
627 u8 rsn_ie[MAX_WPA_IE_LEN];
628 size_t rsn_ie_len;
629 struct libipw_tim_parameters tim;
630
631 /* 802.11h info */
632
633 /* Power Constraint - mandatory if spctrm mgmt required */
634 u8 power_constraint;
635
636 /* TPC Report - mandatory if spctrm mgmt required */
637 struct libipw_tpc_report tpc_report;
638
639 /* Channel Switch Announcement - optional if spctrm mgmt required */
640 struct libipw_csa csa;
641
642 /* Quiet - optional if spctrm mgmt required */
643 struct libipw_quiet quiet;
644
645 struct list_head list;
646 };
647
648 enum libipw_state {
649 LIBIPW_UNINITIALIZED = 0,
650 LIBIPW_INITIALIZED,
651 LIBIPW_ASSOCIATING,
652 LIBIPW_ASSOCIATED,
653 LIBIPW_AUTHENTICATING,
654 LIBIPW_AUTHENTICATED,
655 LIBIPW_SHUTDOWN
656 };
657
658 #define DEFAULT_MAX_SCAN_AGE (15 * HZ)
659 #define DEFAULT_FTS 2346
660
661 #define CFG_LIBIPW_RESERVE_FCS (1<<0)
662 #define CFG_LIBIPW_COMPUTE_FCS (1<<1)
663 #define CFG_LIBIPW_RTS (1<<2)
664
665 #define LIBIPW_24GHZ_MIN_CHANNEL 1
666 #define LIBIPW_24GHZ_MAX_CHANNEL 14
667 #define LIBIPW_24GHZ_CHANNELS (LIBIPW_24GHZ_MAX_CHANNEL - \
668 LIBIPW_24GHZ_MIN_CHANNEL + 1)
669
670 #define LIBIPW_52GHZ_MIN_CHANNEL 34
671 #define LIBIPW_52GHZ_MAX_CHANNEL 165
672 #define LIBIPW_52GHZ_CHANNELS (LIBIPW_52GHZ_MAX_CHANNEL - \
673 LIBIPW_52GHZ_MIN_CHANNEL + 1)
674
675 enum {
676 LIBIPW_CH_PASSIVE_ONLY = (1 << 0),
677 LIBIPW_CH_80211H_RULES = (1 << 1),
678 LIBIPW_CH_B_ONLY = (1 << 2),
679 LIBIPW_CH_NO_IBSS = (1 << 3),
680 LIBIPW_CH_UNIFORM_SPREADING = (1 << 4),
681 LIBIPW_CH_RADAR_DETECT = (1 << 5),
682 LIBIPW_CH_INVALID = (1 << 6),
683 };
684
685 struct libipw_channel {
686 u32 freq; /* in MHz */
687 u8 channel;
688 u8 flags;
689 u8 max_power; /* in dBm */
690 };
691
692 struct libipw_geo {
693 u8 name[4];
694 u8 bg_channels;
695 u8 a_channels;
696 struct libipw_channel bg[LIBIPW_24GHZ_CHANNELS];
697 struct libipw_channel a[LIBIPW_52GHZ_CHANNELS];
698 };
699
700 #define NUM_WEP_KEYS 4
701
702 enum {
703 IEEE80211_CRYPTO_TKIP_COUNTERMEASURES = (1 << 0),
704 };
705
706 struct module;
707
708 struct libipw_crypto_ops {
709 const char *name;
710 struct list_head list;
711
712 /* init new crypto context (e.g., allocate private data space,
713 * select IV, etc.); returns NULL on failure or pointer to allocated
714 * private data on success */
715 void *(*init) (int keyidx);
716
717 /* deinitialize crypto context and free allocated private data */
718 void (*deinit) (void *priv);
719
720 /* encrypt/decrypt return < 0 on error or >= 0 on success. The return
721 * value from decrypt_mpdu is passed as the keyidx value for
722 * decrypt_msdu. skb must have enough head and tail room for the
723 * encryption; if not, error will be returned; these functions are
724 * called for all MPDUs (i.e., fragments).
725 */
726 int (*encrypt_mpdu) (struct sk_buff * skb, int hdr_len, void *priv);
727 int (*decrypt_mpdu) (struct sk_buff * skb, int hdr_len, void *priv);
728
729 /* These functions are called for full MSDUs, i.e. full frames.
730 * These can be NULL if full MSDU operations are not needed. */
731 int (*encrypt_msdu) (struct sk_buff * skb, int hdr_len, void *priv);
732 int (*decrypt_msdu) (struct sk_buff * skb, int keyidx, int hdr_len,
733 void *priv);
734
735 int (*set_key) (void *key, int len, u8 * seq, void *priv);
736 int (*get_key) (void *key, int len, u8 * seq, void *priv);
737
738 /* procfs handler for printing out key information and possible
739 * statistics */
740 void (*print_stats) (struct seq_file *m, void *priv);
741
742 /* Crypto specific flag get/set for configuration settings */
743 unsigned long (*get_flags) (void *priv);
744 unsigned long (*set_flags) (unsigned long flags, void *priv);
745
746 /* maximum number of bytes added by encryption; encrypt buf is
747 * allocated with extra_prefix_len bytes, copy of in_buf, and
748 * extra_postfix_len; encrypt need not use all this space, but
749 * the result must start at the beginning of the buffer and correct
750 * length must be returned */
751 int extra_mpdu_prefix_len, extra_mpdu_postfix_len;
752 int extra_msdu_prefix_len, extra_msdu_postfix_len;
753
754 struct module *owner;
755 };
756
757 struct libipw_crypt_info {
758 char *name;
759 /* Most clients will already have a lock,
760 so just point to that. */
761 spinlock_t *lock;
762
763 struct libipw_crypt_data *crypt[NUM_WEP_KEYS];
764 int tx_keyidx; /* default TX key index (crypt[tx_keyidx]) */
765 struct list_head crypt_deinit_list;
766 struct timer_list crypt_deinit_timer;
767 int crypt_quiesced;
768 };
769
770 struct libipw_device {
771 struct net_device *dev;
772 struct wireless_dev wdev;
773 struct libipw_security sec;
774
775 /* Bookkeeping structures */
776 struct libipw_stats ieee_stats;
777
778 struct libipw_geo geo;
779 struct ieee80211_supported_band bg_band;
780 struct ieee80211_supported_band a_band;
781
782 /* Probe / Beacon management */
783 struct list_head network_free_list;
784 struct list_head network_list;
785 struct libipw_network *networks[MAX_NETWORK_COUNT];
786 int scans;
787 int scan_age;
788
789 int iw_mode; /* operating mode (IW_MODE_*) */
790 struct iw_spy_data spy_data; /* iwspy support */
791 bool spy_enabled;
792
793 spinlock_t lock;
794
795 int tx_headroom; /* Set to size of any additional room needed at front
796 * of allocated Tx SKBs */
797 u32 config;
798
799 /* WEP and other encryption related settings at the device level */
800 int open_wep; /* Set to 1 to allow unencrypted frames */
801
802 /* If the host performs {en,de}cryption, then set to 1 */
803 int host_encrypt;
804 int host_encrypt_msdu;
805 int host_decrypt;
806 /* host performs multicast decryption */
807 int host_mc_decrypt;
808
809 /* host should strip IV and ICV from protected frames */
810 /* meaningful only when hardware decryption is being used */
811 int host_strip_iv_icv;
812
813 int host_open_frag;
814 int ieee802_1x; /* is IEEE 802.1X used */
815
816 /* WPA data */
817 int wpa_enabled;
818 int drop_unencrypted;
819 int privacy_invoked;
820 size_t wpa_ie_len;
821 u8 *wpa_ie;
822
823 struct libipw_crypt_info crypt_info;
824
825 int bcrx_sta_key; /* use individual keys to override default keys even
826 * with RX of broad/multicast frames */
827
828 /* Fragmentation structures */
829 struct libipw_frag_entry frag_cache[LIBIPW_FRAG_CACHE_LEN];
830 unsigned int frag_next_idx;
831 u16 fts; /* Fragmentation Threshold */
832 u16 rts; /* RTS threshold */
833
834 /* Association info */
835 u8 bssid[ETH_ALEN];
836
837 enum libipw_state state;
838
839 int mode; /* A, B, G */
840 int modulation; /* CCK, OFDM */
841 int freq_band; /* 2.4Ghz, 5.2Ghz, Mixed */
842 int abg_true; /* ABG flag */
843
844 int perfect_rssi;
845 int worst_rssi;
846
847 u16 prev_seq_ctl; /* used to drop duplicate frames */
848
849 /* Callback functions */
850 void (*set_security) (struct net_device * dev,
851 struct libipw_security * sec);
852 netdev_tx_t (*hard_start_xmit) (struct libipw_txb * txb,
853 struct net_device * dev, int pri);
854 int (*is_queue_full) (struct net_device * dev, int pri);
855
856 int (*handle_management) (struct net_device * dev,
857 struct libipw_network * network, u16 type);
858 int (*is_qos_active) (struct net_device *dev, struct sk_buff *skb);
859
860 /* Typical STA methods */
861 int (*handle_auth) (struct net_device * dev,
862 struct libipw_auth * auth);
863 int (*handle_deauth) (struct net_device * dev,
864 struct libipw_deauth * auth);
865 int (*handle_action) (struct net_device * dev,
866 struct libipw_action * action,
867 struct libipw_rx_stats * stats);
868 int (*handle_disassoc) (struct net_device * dev,
869 struct libipw_disassoc * assoc);
870 int (*handle_beacon) (struct net_device * dev,
871 struct libipw_beacon * beacon,
872 struct libipw_network * network);
873 int (*handle_probe_response) (struct net_device * dev,
874 struct libipw_probe_response * resp,
875 struct libipw_network * network);
876 int (*handle_probe_request) (struct net_device * dev,
877 struct libipw_probe_request * req,
878 struct libipw_rx_stats * stats);
879 int (*handle_assoc_response) (struct net_device * dev,
880 struct libipw_assoc_response * resp,
881 struct libipw_network * network);
882
883 /* Typical AP methods */
884 int (*handle_assoc_request) (struct net_device * dev);
885 int (*handle_reassoc_request) (struct net_device * dev,
886 struct libipw_reassoc_request * req);
887
888 /* This must be the last item so that it points to the data
889 * allocated beyond this structure by alloc_libipw */
890 u8 priv[];
891 };
892
893 #define IEEE_A (1<<0)
894 #define IEEE_B (1<<1)
895 #define IEEE_G (1<<2)
896 #define IEEE_MODE_MASK (IEEE_A|IEEE_B|IEEE_G)
897
libipw_priv(struct net_device * dev)898 static inline void *libipw_priv(struct net_device *dev)
899 {
900 return ((struct libipw_device *)netdev_priv(dev))->priv;
901 }
902
libipw_is_valid_mode(struct libipw_device * ieee,int mode)903 static inline int libipw_is_valid_mode(struct libipw_device *ieee,
904 int mode)
905 {
906 /*
907 * It is possible for both access points and our device to support
908 * combinations of modes, so as long as there is one valid combination
909 * of ap/device supported modes, then return success
910 *
911 */
912 if ((mode & IEEE_A) &&
913 (ieee->modulation & LIBIPW_OFDM_MODULATION) &&
914 (ieee->freq_band & LIBIPW_52GHZ_BAND))
915 return 1;
916
917 if ((mode & IEEE_G) &&
918 (ieee->modulation & LIBIPW_OFDM_MODULATION) &&
919 (ieee->freq_band & LIBIPW_24GHZ_BAND))
920 return 1;
921
922 if ((mode & IEEE_B) &&
923 (ieee->modulation & LIBIPW_CCK_MODULATION) &&
924 (ieee->freq_band & LIBIPW_24GHZ_BAND))
925 return 1;
926
927 return 0;
928 }
929
libipw_get_hdrlen(u16 fc)930 static inline int libipw_get_hdrlen(u16 fc)
931 {
932 int hdrlen = LIBIPW_3ADDR_LEN;
933 u16 stype = WLAN_FC_GET_STYPE(fc);
934
935 switch (WLAN_FC_GET_TYPE(fc)) {
936 case IEEE80211_FTYPE_DATA:
937 if ((fc & IEEE80211_FCTL_FROMDS) && (fc & IEEE80211_FCTL_TODS))
938 hdrlen = LIBIPW_4ADDR_LEN;
939 if (stype & IEEE80211_STYPE_QOS_DATA)
940 hdrlen += 2;
941 break;
942 case IEEE80211_FTYPE_CTL:
943 switch (WLAN_FC_GET_STYPE(fc)) {
944 case IEEE80211_STYPE_CTS:
945 case IEEE80211_STYPE_ACK:
946 hdrlen = LIBIPW_1ADDR_LEN;
947 break;
948 default:
949 hdrlen = LIBIPW_2ADDR_LEN;
950 break;
951 }
952 break;
953 }
954
955 return hdrlen;
956 }
957
libipw_get_payload(struct ieee80211_hdr * hdr)958 static inline u8 *libipw_get_payload(struct ieee80211_hdr *hdr)
959 {
960 switch (libipw_get_hdrlen(le16_to_cpu(hdr->frame_control))) {
961 case LIBIPW_1ADDR_LEN:
962 return ((struct libipw_hdr_1addr *)hdr)->payload;
963 case LIBIPW_2ADDR_LEN:
964 return ((struct libipw_hdr_2addr *)hdr)->payload;
965 case LIBIPW_3ADDR_LEN:
966 return ((struct libipw_hdr_3addr *)hdr)->payload;
967 case LIBIPW_4ADDR_LEN:
968 return ((struct libipw_hdr_4addr *)hdr)->payload;
969 }
970 return NULL;
971 }
972
libipw_is_ofdm_rate(u8 rate)973 static inline int libipw_is_ofdm_rate(u8 rate)
974 {
975 switch (rate & ~LIBIPW_BASIC_RATE_MASK) {
976 case LIBIPW_OFDM_RATE_6MB:
977 case LIBIPW_OFDM_RATE_9MB:
978 case LIBIPW_OFDM_RATE_12MB:
979 case LIBIPW_OFDM_RATE_18MB:
980 case LIBIPW_OFDM_RATE_24MB:
981 case LIBIPW_OFDM_RATE_36MB:
982 case LIBIPW_OFDM_RATE_48MB:
983 case LIBIPW_OFDM_RATE_54MB:
984 return 1;
985 }
986 return 0;
987 }
988
libipw_is_cck_rate(u8 rate)989 static inline int libipw_is_cck_rate(u8 rate)
990 {
991 switch (rate & ~LIBIPW_BASIC_RATE_MASK) {
992 case LIBIPW_CCK_RATE_1MB:
993 case LIBIPW_CCK_RATE_2MB:
994 case LIBIPW_CCK_RATE_5MB:
995 case LIBIPW_CCK_RATE_11MB:
996 return 1;
997 }
998 return 0;
999 }
1000
1001 /* libipw.c */
1002 void free_libipw(struct net_device *dev, int monitor);
1003 struct net_device *alloc_libipw(int sizeof_priv, int monitor);
1004
1005 void libipw_networks_age(struct libipw_device *ieee, unsigned long age_secs);
1006
1007 int libipw_set_encryption(struct libipw_device *ieee);
1008
1009 /* libipw_tx.c */
1010 netdev_tx_t libipw_xmit(struct sk_buff *skb, struct net_device *dev);
1011 void libipw_txb_free(struct libipw_txb *);
1012
1013 /* libipw_rx.c */
1014 void libipw_rx_any(struct libipw_device *ieee, struct sk_buff *skb,
1015 struct libipw_rx_stats *stats);
1016 int libipw_rx(struct libipw_device *ieee, struct sk_buff *skb,
1017 struct libipw_rx_stats *rx_stats);
1018 /* make sure to set stats->len */
1019 void libipw_rx_mgt(struct libipw_device *ieee, struct libipw_hdr_4addr *header,
1020 struct libipw_rx_stats *stats);
1021
1022 /* libipw_geo.c */
1023 const struct libipw_geo *libipw_get_geo(struct libipw_device *ieee);
1024 void libipw_set_geo(struct libipw_device *ieee, const struct libipw_geo *geo);
1025
1026 int libipw_is_valid_channel(struct libipw_device *ieee, u8 channel);
1027 int libipw_channel_to_index(struct libipw_device *ieee, u8 channel);
1028 u8 libipw_freq_to_channel(struct libipw_device *ieee, u32 freq);
1029 u8 libipw_get_channel_flags(struct libipw_device *ieee, u8 channel);
1030 const struct libipw_channel *libipw_get_channel(struct libipw_device *ieee,
1031 u8 channel);
1032 u32 libipw_channel_to_freq(struct libipw_device *ieee, u8 channel);
1033
1034 /* libipw_wx.c */
1035 int libipw_wx_get_scan(struct libipw_device *ieee, struct iw_request_info *info,
1036 union iwreq_data *wrqu, char *key);
1037 int libipw_wx_set_encode(struct libipw_device *ieee,
1038 struct iw_request_info *info, union iwreq_data *wrqu,
1039 char *key);
1040 int libipw_wx_get_encode(struct libipw_device *ieee,
1041 struct iw_request_info *info, union iwreq_data *wrqu,
1042 char *key);
1043 int libipw_wx_set_encodeext(struct libipw_device *ieee,
1044 struct iw_request_info *info,
1045 union iwreq_data *wrqu, char *extra);
1046 int libipw_wx_get_encodeext(struct libipw_device *ieee,
1047 struct iw_request_info *info,
1048 union iwreq_data *wrqu, char *extra);
1049
libipw_increment_scans(struct libipw_device * ieee)1050 static inline void libipw_increment_scans(struct libipw_device *ieee)
1051 {
1052 ieee->scans++;
1053 }
1054
libipw_get_scans(struct libipw_device * ieee)1055 static inline int libipw_get_scans(struct libipw_device *ieee)
1056 {
1057 return ieee->scans;
1058 }
1059
1060 struct libipw_crypt_data {
1061 struct list_head list; /* delayed deletion list */
1062 const struct libipw_crypto_ops *ops;
1063 void *priv;
1064 atomic_t refcnt;
1065 };
1066
1067 int libipw_crypt_info_init(struct libipw_crypt_info *info, char *name,
1068 spinlock_t *lock);
1069 void libipw_crypt_info_free(struct libipw_crypt_info *info);
1070 int libipw_register_crypto_ops(const struct libipw_crypto_ops *ops);
1071 int libipw_unregister_crypto_ops(const struct libipw_crypto_ops *ops);
1072 const struct libipw_crypto_ops *libipw_get_crypto_ops(const char *name);
1073 void libipw_crypt_delayed_deinit(struct libipw_crypt_info *info,
1074 struct libipw_crypt_data **crypt);
1075
1076 /* must be called in the listed order */
1077 int libipw_crypto_init(void);
1078 int libipw_crypto_ccmp_init(void);
1079 int libipw_crypto_tkip_init(void);
1080 int libipw_crypto_wep_init(void);
1081
1082 void libipw_crypto_wep_exit(void);
1083 void libipw_crypto_tkip_exit(void);
1084 void libipw_crypto_ccmp_exit(void);
1085 void libipw_crypto_exit(void);
1086
1087
1088 int ipw_wx_set_spy(struct net_device *dev, struct iw_request_info *info,
1089 union iwreq_data *wrqu, char *extra);
1090 int ipw_wx_get_spy(struct net_device *dev, struct iw_request_info *info,
1091 union iwreq_data *wrqu, char *extra);
1092 int ipw_wx_set_thrspy(struct net_device *dev, struct iw_request_info *info,
1093 union iwreq_data *wrqu, char *extra);
1094 int ipw_wx_get_thrspy(struct net_device *dev, struct iw_request_info *info,
1095 union iwreq_data *wrqu, char *extra);
1096 void libipw_spy_update(struct net_device *dev, unsigned char *address,
1097 struct iw_quality *wstats);
1098
1099 #endif /* LIBIPW_H */
1100