Linux Kernel  3.7.1
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
ieee80211.h
Go to the documentation of this file.
1 /*
2  * Merged with mainline ieee80211.h in Aug 2004. Original ieee802_11
3  * remains copyright by the original authors
4  *
5  * Portions of the merged code are based on Host AP (software wireless
6  * LAN access point) driver for Intersil Prism2/2.5/3.
7  *
8  * Copyright (c) 2001-2002, SSH Communications Security Corp and Jouni Malinen
10  * Copyright (c) 2002-2003, Jouni Malinen <[email protected]>
11  *
12  * Adaption to a generic IEEE 802.11 stack by James Ketrenos
14  * Copyright (c) 2004, Intel Corporation
15  *
16  * Modified for Realtek's wi-fi cards by Andrea Merello
18  *
19  * This program is free software; you can redistribute it and/or modify
20  * it under the terms of the GNU General Public License version 2 as
21  * published by the Free Software Foundation. See README and COPYING for
22  * more details.
23  */
24 #ifndef IEEE80211_H
25 #define IEEE80211_H
26 #include <linux/if_ether.h> /* ETH_ALEN */
27 #include <linux/kernel.h> /* ARRAY_SIZE */
28 #include <linux/jiffies.h>
29 #include <linux/timer.h>
30 #include <linux/sched.h>
31 #include <linux/semaphore.h>
32 #include <linux/wireless.h>
33 #include <linux/ieee80211.h>
34 #include <linux/interrupt.h>
35 
36 #define KEY_TYPE_NA 0x0
37 #define KEY_TYPE_WEP40 0x1
38 #define KEY_TYPE_TKIP 0x2
39 #define KEY_TYPE_CCMP 0x4
40 #define KEY_TYPE_WEP104 0x5
41 
42 #define aSifsTime 10
43 
44 #define MGMT_QUEUE_NUM 5
45 
46 
47 #define IEEE_CMD_SET_WPA_PARAM 1
48 #define IEEE_CMD_SET_WPA_IE 2
49 #define IEEE_CMD_SET_ENCRYPTION 3
50 #define IEEE_CMD_MLME 4
51 
52 #define IEEE_PARAM_WPA_ENABLED 1
53 #define IEEE_PARAM_TKIP_COUNTERMEASURES 2
54 #define IEEE_PARAM_DROP_UNENCRYPTED 3
55 #define IEEE_PARAM_PRIVACY_INVOKED 4
56 #define IEEE_PARAM_AUTH_ALGS 5
57 #define IEEE_PARAM_IEEE_802_1X 6
58 //It should consistent with the driver_XXX.c
59 // David, 2006.9.26
60 #define IEEE_PARAM_WPAX_SELECT 7
61 //Added for notify the encryption type selection
62 // David, 2006.9.26
63 #define IEEE_PROTO_WPA 1
64 #define IEEE_PROTO_RSN 2
65 //Added for notify the encryption type selection
66 // David, 2006.9.26
67 #define IEEE_WPAX_USEGROUP 0
68 #define IEEE_WPAX_WEP40 1
69 #define IEEE_WPAX_TKIP 2
70 #define IEEE_WPAX_WRAP 3
71 #define IEEE_WPAX_CCMP 4
72 #define IEEE_WPAX_WEP104 5
73 
74 #define IEEE_KEY_MGMT_IEEE8021X 1
75 #define IEEE_KEY_MGMT_PSK 2
76 
77 
78 
79 #define IEEE_MLME_STA_DEAUTH 1
80 #define IEEE_MLME_STA_DISASSOC 2
81 
82 
83 #define IEEE_CRYPT_ERR_UNKNOWN_ALG 2
84 #define IEEE_CRYPT_ERR_UNKNOWN_ADDR 3
85 #define IEEE_CRYPT_ERR_CRYPT_INIT_FAILED 4
86 #define IEEE_CRYPT_ERR_KEY_SET_FAILED 5
87 #define IEEE_CRYPT_ERR_TX_KEY_SET_FAILED 6
88 #define IEEE_CRYPT_ERR_CARD_CONF_FAILED 7
89 
90 
91 #define IEEE_CRYPT_ALG_NAME_LEN 16
92 
93 //by amy for ps
94 typedef struct ieee_param {
97  union {
98  struct {
101  } wpa_param;
102  struct {
105  u8 data[0];
106  } wpa_ie;
107  struct{
108  int command;
110  } mlme;
111  struct {
116  u8 seq[8]; /* sequence counter (set: RX, get: TX) */
118  u8 key[0];
119  } crypt;
120 
121  } u;
122 }ieee_param;
123 
124 
125 #define MSECS(t) msecs_to_jiffies(t)
126 #define msleep_interruptible_rtl msleep_interruptible
127 
128 #define IEEE80211_DATA_LEN 2304
129 /* Maximum size for the MA-UNITDATA primitive, 802.11 standard section
130  6.2.1.1.2.
131 
132  The figure in section 7.1.2 suggests a body size of up to 2312
133  bytes is allowed, which is a bit confusing, I suspect this
134  represents the 2304 bytes of real data, plus a possible 8 bytes of
135  WEP IV and ICV. (this interpretation suggested by Ramiro Barreiro) */
136 
137 #define IEEE80211_3ADDR_LEN 24
138 #define IEEE80211_4ADDR_LEN 30
139 #define IEEE80211_FCS_LEN 4
140 #define IEEE80211_HLEN IEEE80211_4ADDR_LEN
141 #define IEEE80211_FRAME_LEN (IEEE80211_DATA_LEN + IEEE80211_HLEN)
142 #define IEEE80211_MGMT_HDR_LEN 24
143 #define IEEE80211_DATA_HDR3_LEN 24
144 #define IEEE80211_DATA_HDR4_LEN 30
145 
146 #define MIN_FRAG_THRESHOLD 256U
147 #define MAX_FRAG_THRESHOLD 2346U
148 
149 /* Frame control field constants */
150 #define IEEE80211_FCTL_DSTODS 0x0300 //added by david
151 #define IEEE80211_FCTL_WEP 0x4000
152 
153 /* debug macros */
154 
155 #ifdef CONFIG_IEEE80211_DEBUG
157 #define IEEE80211_DEBUG(level, fmt, args...) \
158 do { if (ieee80211_debug_level & (level)) \
159  printk(KERN_DEBUG "ieee80211: %c %s " fmt, \
160  in_interrupt() ? 'I' : 'U', __func__ , ## args); } while (0)
161 #else
162 #define IEEE80211_DEBUG(level, fmt, args...) do {} while (0)
163 #endif /* CONFIG_IEEE80211_DEBUG */
164 
165 /*
166  * To use the debug system;
167  *
168  * If you are defining a new debug classification, simply add it to the #define
169  * list here in the form of:
170  *
171  * #define IEEE80211_DL_xxxx VALUE
172  *
173  * shifting value to the left one bit from the previous entry. xxxx should be
174  * the name of the classification (for example, WEP)
175  *
176  * You then need to either add a IEEE80211_xxxx_DEBUG() macro definition for your
177  * classification, or use IEEE80211_DEBUG(IEEE80211_DL_xxxx, ...) whenever you want
178  * to send output to that classification.
179  *
180  * To add your debug level to the list of levels seen when you perform
181  *
182  * % cat /proc/net/ipw/debug_level
183  *
184  * you simply need to add your entry to the ipw_debug_levels array.
185  *
186  * If you do not see debug_level in /proc/net/ipw then you do not have
187  * CONFIG_IEEE80211_DEBUG defined in your kernel configuration
188  *
189  */
190 
191 #define IEEE80211_DL_INFO (1<<0)
192 #define IEEE80211_DL_WX (1<<1)
193 #define IEEE80211_DL_SCAN (1<<2)
194 #define IEEE80211_DL_STATE (1<<3)
195 #define IEEE80211_DL_MGMT (1<<4)
196 #define IEEE80211_DL_FRAG (1<<5)
197 #define IEEE80211_DL_EAP (1<<6)
198 #define IEEE80211_DL_DROP (1<<7)
199 
200 #define IEEE80211_DL_TX (1<<8)
201 #define IEEE80211_DL_RX (1<<9)
202 
203 #define IEEE80211_ERROR(f, a...) printk(KERN_ERR "ieee80211: " f, ## a)
204 #define IEEE80211_WARNING(f, a...) printk(KERN_WARNING "ieee80211: " f, ## a)
205 #define IEEE80211_DEBUG_INFO(f, a...) IEEE80211_DEBUG(IEEE80211_DL_INFO, f, ## a)
206 
207 #define IEEE80211_DEBUG_WX(f, a...) IEEE80211_DEBUG(IEEE80211_DL_WX, f, ## a)
208 #define IEEE80211_DEBUG_SCAN(f, a...) IEEE80211_DEBUG(IEEE80211_DL_SCAN, f, ## a)
209 //#define IEEE_DEBUG_SCAN IEEE80211_WARNING
210 #define IEEE80211_DEBUG_STATE(f, a...) IEEE80211_DEBUG(IEEE80211_DL_STATE, f, ## a)
211 #define IEEE80211_DEBUG_MGMT(f, a...) IEEE80211_DEBUG(IEEE80211_DL_MGMT, f, ## a)
212 #define IEEE80211_DEBUG_FRAG(f, a...) IEEE80211_DEBUG(IEEE80211_DL_FRAG, f, ## a)
213 #define IEEE80211_DEBUG_EAP(f, a...) IEEE80211_DEBUG(IEEE80211_DL_EAP, f, ## a)
214 #define IEEE80211_DEBUG_DROP(f, a...) IEEE80211_DEBUG(IEEE80211_DL_DROP, f, ## a)
215 #define IEEE80211_DEBUG_TX(f, a...) IEEE80211_DEBUG(IEEE80211_DL_TX, f, ## a)
216 #define IEEE80211_DEBUG_RX(f, a...) IEEE80211_DEBUG(IEEE80211_DL_RX, f, ## a)
217 #include <linux/netdevice.h>
218 #include <linux/if_arp.h> /* ARPHRD_ETHER */
219 
220 #ifndef WIRELESS_SPY
221 #define WIRELESS_SPY // enable iwspy support
222 #endif
223 #include <net/iw_handler.h> // new driver API
224 
225 #ifndef ETH_P_PAE
226 #define ETH_P_PAE 0x888E /* Port Access Entity (IEEE 802.1X) */
227 #endif /* ETH_P_PAE */
228 
229 #define ETH_P_PREAUTH 0x88C7 /* IEEE 802.11i pre-authentication */
230 
231 #ifndef ETH_P_80211_RAW
232 #define ETH_P_80211_RAW (ETH_P_ECONET + 1)
233 #endif
234 
235 /* IEEE 802.11 defines */
236 
237 #define P80211_OUI_LEN 3
238 
240 
241  u8 dsap; /* always 0xAA */
242  u8 ssap; /* always 0xAA */
243  u8 ctrl; /* always 0x03 */
244  u8 oui[P80211_OUI_LEN]; /* organizational universal id */
245 
246 } __attribute__ ((packed));
247 
248 #define SNAP_SIZE sizeof(struct ieee80211_snap_hdr)
250 #define WLAN_FC_GET_TYPE(fc) ((fc) & IEEE80211_FCTL_FTYPE)
251 #define WLAN_FC_GET_STYPE(fc) ((fc) & IEEE80211_FCTL_STYPE)
252 
253 #define WLAN_GET_SEQ_FRAG(seq) ((seq) & IEEE80211_SCTL_FRAG)
254 #define WLAN_GET_SEQ_SEQ(seq) ((seq) & IEEE80211_SCTL_SEQ)
255 
256 #define WLAN_CAPABILITY_BSS (1<<0)
257 #define WLAN_CAPABILITY_SHORT_SLOT (1<<10)
258 
259 #define IEEE80211_STATMASK_SIGNAL (1<<0)
260 #define IEEE80211_STATMASK_RSSI (1<<1)
261 #define IEEE80211_STATMASK_NOISE (1<<2)
262 #define IEEE80211_STATMASK_RATE (1<<3)
263 #define IEEE80211_STATMASK_WEMASK 0x7
264 
265 
266 #define IEEE80211_CCK_MODULATION (1<<0)
267 #define IEEE80211_OFDM_MODULATION (1<<1)
268 
269 #define IEEE80211_24GHZ_BAND (1<<0)
270 #define IEEE80211_52GHZ_BAND (1<<1)
271 
272 #define IEEE80211_CCK_RATE_LEN 4
273 #define IEEE80211_CCK_RATE_1MB 0x02
274 #define IEEE80211_CCK_RATE_2MB 0x04
275 #define IEEE80211_CCK_RATE_5MB 0x0B
276 #define IEEE80211_CCK_RATE_11MB 0x16
277 #define IEEE80211_OFDM_RATE_LEN 8
278 #define IEEE80211_OFDM_RATE_6MB 0x0C
279 #define IEEE80211_OFDM_RATE_9MB 0x12
280 #define IEEE80211_OFDM_RATE_12MB 0x18
281 #define IEEE80211_OFDM_RATE_18MB 0x24
282 #define IEEE80211_OFDM_RATE_24MB 0x30
283 #define IEEE80211_OFDM_RATE_36MB 0x48
284 #define IEEE80211_OFDM_RATE_48MB 0x60
285 #define IEEE80211_OFDM_RATE_54MB 0x6C
286 #define IEEE80211_BASIC_RATE_MASK 0x80
287 
288 #define IEEE80211_CCK_RATE_1MB_MASK (1<<0)
289 #define IEEE80211_CCK_RATE_2MB_MASK (1<<1)
290 #define IEEE80211_CCK_RATE_5MB_MASK (1<<2)
291 #define IEEE80211_CCK_RATE_11MB_MASK (1<<3)
292 #define IEEE80211_OFDM_RATE_6MB_MASK (1<<4)
293 #define IEEE80211_OFDM_RATE_9MB_MASK (1<<5)
294 #define IEEE80211_OFDM_RATE_12MB_MASK (1<<6)
295 #define IEEE80211_OFDM_RATE_18MB_MASK (1<<7)
296 #define IEEE80211_OFDM_RATE_24MB_MASK (1<<8)
297 #define IEEE80211_OFDM_RATE_36MB_MASK (1<<9)
298 #define IEEE80211_OFDM_RATE_48MB_MASK (1<<10)
299 #define IEEE80211_OFDM_RATE_54MB_MASK (1<<11)
300 
301 #define IEEE80211_CCK_RATES_MASK 0x0000000F
302 #define IEEE80211_CCK_BASIC_RATES_MASK (IEEE80211_CCK_RATE_1MB_MASK | \
303  IEEE80211_CCK_RATE_2MB_MASK)
304 #define IEEE80211_CCK_DEFAULT_RATES_MASK (IEEE80211_CCK_BASIC_RATES_MASK | \
305  IEEE80211_CCK_RATE_5MB_MASK | \
306  IEEE80211_CCK_RATE_11MB_MASK)
307 
308 #define IEEE80211_OFDM_RATES_MASK 0x00000FF0
309 #define IEEE80211_OFDM_BASIC_RATES_MASK (IEEE80211_OFDM_RATE_6MB_MASK | \
310  IEEE80211_OFDM_RATE_12MB_MASK | \
311  IEEE80211_OFDM_RATE_24MB_MASK)
312 #define IEEE80211_OFDM_DEFAULT_RATES_MASK (IEEE80211_OFDM_BASIC_RATES_MASK | \
313  IEEE80211_OFDM_RATE_9MB_MASK | \
314  IEEE80211_OFDM_RATE_18MB_MASK | \
315  IEEE80211_OFDM_RATE_36MB_MASK | \
316  IEEE80211_OFDM_RATE_48MB_MASK | \
317  IEEE80211_OFDM_RATE_54MB_MASK)
318 #define IEEE80211_DEFAULT_RATES_MASK (IEEE80211_OFDM_DEFAULT_RATES_MASK | \
319  IEEE80211_CCK_DEFAULT_RATES_MASK)
320 
321 #define IEEE80211_NUM_OFDM_RATES 8
322 #define IEEE80211_NUM_CCK_RATES 4
323 #define IEEE80211_OFDM_SHIFT_MASK_A 4
324 
325 /* this is stolen and modified from the madwifi driver*/
326 #define IEEE80211_FC0_TYPE_MASK 0x0c
327 #define IEEE80211_FC0_TYPE_DATA 0x08
328 #define IEEE80211_FC0_SUBTYPE_MASK 0xB0
329 #define IEEE80211_FC0_SUBTYPE_QOS 0x80
330 
331 #define IEEE80211_QOS_HAS_SEQ(fc) \
332  (((fc) & (IEEE80211_FC0_TYPE_MASK | IEEE80211_FC0_SUBTYPE_MASK)) == \
333  (IEEE80211_FC0_TYPE_DATA | IEEE80211_FC0_SUBTYPE_QOS))
334 
335 /* this is stolen from ipw2200 driver */
336 #define IEEE_IBSS_MAC_HASH_SIZE 31
341  unsigned long packet_time[17];
342  struct list_head list;
343 };
344 
345 /* NOTE: This data is for statistical purposes; not all hardware provides this
346  * information for frames received. Not setting these will not cause
347  * any adverse affects. */
354  u16 rate; /* in 100 kbps */
361 };
362 
363 /* IEEE 802.11 requires that STA supports concurrent reception of at least
364  * three fragmented frames. This define can be increased to support more
365  * concurrent frames, but it should be noted that each entry can consume about
366  * 2 kB of RAM and increasing cache size will slow down frame reassembly. */
367 #define IEEE80211_FRAG_CACHE_LEN 4
368 
370  unsigned long first_frag_time;
371  unsigned int seq;
372  unsigned int last_frag;
373  struct sk_buff *skb;
376 };
377 
379  unsigned int tx_unicast_frames;
380  unsigned int tx_multicast_frames;
381  unsigned int tx_fragments;
382  unsigned int tx_unicast_octets;
383  unsigned int tx_multicast_octets;
388  unsigned int tx_discards;
389  unsigned int rx_unicast_frames;
390  unsigned int rx_multicast_frames;
391  unsigned int rx_fragments;
392  unsigned int rx_unicast_octets;
393  unsigned int rx_multicast_octets;
394  unsigned int rx_fcs_errors;
395  unsigned int rx_discards_no_buffer;
396  unsigned int tx_discards_wrong_sa;
400 };
401 
402 struct ieee80211_device;
403 
404 #include "ieee80211_crypt.h"
405 
406 #define SEC_KEY_1 (1<<0)
407 #define SEC_KEY_2 (1<<1)
408 #define SEC_KEY_3 (1<<2)
409 #define SEC_KEY_4 (1<<3)
410 #define SEC_ACTIVE_KEY (1<<4)
411 #define SEC_AUTH_MODE (1<<5)
412 #define SEC_UNICAST_GROUP (1<<6)
413 #define SEC_LEVEL (1<<7)
414 #define SEC_ENABLED (1<<8)
415 
416 #define SEC_LEVEL_0 0 /* None */
417 #define SEC_LEVEL_1 1 /* WEP 40 and 104 bit */
418 #define SEC_LEVEL_2 2 /* Level 1 + TKIP */
419 #define SEC_LEVEL_2_CKIP 3 /* Level 1 + CKIP */
420 #define SEC_LEVEL_3 4 /* Level 2 + CCMP */
421 
422 #define WEP_KEYS 4
423 #define WEP_KEY_LEN 13
424 
425 #define WEP_KEY_LEN_MODIF 32
426 
429  enabled:1,
430  auth_mode:2,
431  auth_algo:4,
437 } __attribute__ ((packed));
439 
440 /*
441 
442  802.11 data frame from AP
444  ,-------------------------------------------------------------------.
445 Bytes | 2 | 2 | 6 | 6 | 6 | 2 | 0..2312 | 4 |
446  |------|------|---------|---------|---------|------|---------|------|
447 Desc. | ctrl | dura | DA/RA | TA | SA | Sequ | frame | fcs |
448  | | tion | (BSSID) | | | ence | data | |
449  `-------------------------------------------------------------------'
450 
451 Total: 28-2340 bytes
452 
453 */
454 
455 /* Management Frame Information Element Types */
456 enum {
470 };
471 
475  u8 addr1[6];
476  u8 addr2[6];
477  u8 addr3[6];
479 };
480 
489 } __attribute__ ((packed));
499 } __attribute__ ((packed));
500 
510 } __attribute__ ((packed));
511 
515 } __attribute__ ((packed));
518  u8 id;
519  u8 len;
520  u8 data[0];
521 } __attribute__ ((packed));
522 
528  //struct ieee80211_info_element_hdr info_element;
529 } __attribute__ ((packed));
534 } __attribute__ ((packed));
535 
538  /* struct ieee80211_info_element info_element; */
539 } __attribute__ ((packed));
540 
547 } __attribute__ ((packed));
548 
553  //u8 current_ap[ETH_ALEN];
555 } __attribute__ ((packed));
556 
562  struct ieee80211_info_element info_element; /* supported rates */
563 } __attribute__ ((packed));
564 
571  struct sk_buff *fragments[0];
572 };
573 
574 /* SWEEP TABLE ENTRIES NUMBER */
575 #define MAX_SWEEP_TAB_ENTRIES 42
576 #define MAX_SWEEP_TAB_ENTRIES_PER_PACKET 7
577 
578 /* MAX_RATES_LENGTH needs to be 12. The spec says 8, and many APs
579  * only use 8, and then use extended rates for the remaining supported
580  * rates. Other APs, however, stick all of their supported rates on the
581  * main rates information element... */
582 #define MAX_RATES_LENGTH ((u8)12)
583 #define MAX_RATES_EX_LENGTH ((u8)16)
584 
585 #define MAX_NETWORK_COUNT 128
586 
587 #define MAX_CHANNEL_NUMBER 165
588 
589 #define IEEE80211_SOFTMAC_SCAN_TIME 100 /* (HZ / 2) */
590 #define IEEE80211_SOFTMAC_ASSOC_RETRY_TIME (HZ * 2)
591 
592 #define CRC_LENGTH 4U
593 
594 #define MAX_WPA_IE_LEN 64
595 
596 #define NETWORK_EMPTY_ESSID (1 << 0)
597 #define NETWORK_HAS_OFDM (1 << 1)
598 #define NETWORK_HAS_CCK (1 << 2)
599 
604 };
605 
610 } __attribute__ ((packed));
629 }__attribute__((packed));
631 enum eap_type {
637 };
639 static const char *eap_types[] = {
640  [EAP_PACKET] = "EAP-Packet",
641  [EAPOL_START] = "EAPOL-Start",
642  [EAPOL_LOGOFF] = "EAPOL-Logoff",
643  [EAPOL_KEY] = "EAPOL-Key",
644  [EAPOL_ENCAP_ASF_ALERT] = "EAPOL-Encap-ASF-Alert"
645 };
646 
647 static inline const char *eap_get_type(int type)
648 {
649  return (type >= ARRAY_SIZE(eap_types)) ? "Unknown" : eap_types[type];
650 }
651 
652 struct eapol {
653  u8 snap[6];
658 } __attribute__ ((packed));
661  unsigned int rx_ass_ok;
662  unsigned int rx_ass_err;
663  unsigned int rx_probe_rq;
664  unsigned int tx_probe_rs;
665  unsigned int tx_beacons;
666  unsigned int rx_auth_rq;
667  unsigned int rx_auth_rs_ok;
668  unsigned int rx_auth_rs_err;
669  unsigned int tx_auth_rq;
670  unsigned int no_auth_rs;
671  unsigned int no_ass_rs;
672  unsigned int tx_ass_rq;
673  unsigned int rx_ass_rq;
674  unsigned int tx_probe_rq;
675  unsigned int reassoc;
676  unsigned int swtxstop;
677  unsigned int swtxawake;
678 };
679 
680 #define BEACON_PROBE_SSID_ID_POSITION 12
681 
682 /*
683  * These are the data types that can make up management packets
684  *
685  u16 auth_algorithm;
686  u16 auth_sequence;
687  u16 beacon_interval;
688  u16 capability;
689  u8 current_ap[ETH_ALEN];
690  u16 listen_interval;
691  struct {
692  u16 association_id:14, reserved:2;
693  } __attribute__ ((packed));
694  u32 time_stamp[2];
695  u16 reason;
696  u16 status;
697 */
698 
699 #define IEEE80211_DEFAULT_TX_ESSID "Penguin"
700 #define IEEE80211_DEFAULT_BASIC_RATE 10
701 
703 #define MAX_SP_Len (WMM_all_frame << 4)
704 #define IEEE80211_QOS_TID 0x0f
705 #define QOS_CTL_NOTCONTAIN_ACK (0x01 << 5)
706 
707 #define MAX_IE_LEN 0xFF //+YJ,080625
708 
709 typedef struct _CHANNEL_LIST{
713 
714 //by amy for ps
715 #define IEEE80211_WATCH_DOG_TIME 2000
716 //by amy for ps
717 //by amy for antenna
718 #define ANTENNA_DIVERSITY_TIMER_PERIOD 1000 // 1000 m
719 //by amy for antenna
720 
721 #define IEEE80211_DTIM_MBCAST 4
722 #define IEEE80211_DTIM_UCAST 2
723 #define IEEE80211_DTIM_VALID 1
724 #define IEEE80211_DTIM_INVALID 0
725 
726 #define IEEE80211_PS_DISABLED 0
727 #define IEEE80211_PS_UNICAST IEEE80211_DTIM_UCAST
728 #define IEEE80211_PS_MBCAST IEEE80211_DTIM_MBCAST
729 #define IEEE80211_PS_ENABLE IEEE80211_DTIM_VALID
730 //added by David for QoS 2006/6/30
731 //#define WMM_Hang_8187
732 #ifdef WMM_Hang_8187
733 #undef WMM_Hang_8187
734 #endif
735 
736 #define WME_AC_BE 0x00
737 #define WME_AC_BK 0x01
738 #define WME_AC_VI 0x02
739 #define WME_AC_VO 0x03
740 #define WME_ACI_MASK 0x03
741 #define WME_AIFSN_MASK 0x03
742 #define WME_AC_PRAM_LEN 16
743 
744 //UP Mapping to AC, using in MgntQuery_SequenceNumber() and maybe for DSCP
745 //#define UP2AC(up) ((up<3) ? ((up==0)?1:0) : (up>>1))
746 #define UP2AC(up) ( \
747  ((up) < 1) ? WME_AC_BE : \
748  ((up) < 3) ? WME_AC_BK : \
749  ((up) < 4) ? WME_AC_BE : \
750  ((up) < 6) ? WME_AC_VI : \
751  WME_AC_VO)
752 //AC Mapping to UP, using in Tx part for selecting the corresponding TX queue
753 #define AC2UP(_ac) ( \
754  ((_ac) == WME_AC_VO) ? 6 : \
755  ((_ac) == WME_AC_VI) ? 5 : \
756  ((_ac) == WME_AC_BK) ? 1 : \
757  0)
758 
759 #define ETHER_ADDR_LEN 6 /* length of an Ethernet address */
760 struct ether_header {
764 } __attribute__((packed));
766 #ifndef ETHERTYPE_PAE
767 #define ETHERTYPE_PAE 0x888e /* EAPOL PAE/802.1x */
768 #endif
769 #ifndef ETHERTYPE_IP
770 #define ETHERTYPE_IP 0x0800 /* IP protocol */
771 #endif
772 
774  /* These entries are used to identify a unique network */
777  /* Ensure null-terminated for any debug msgs */
780 
781  /* These are network statistics */
788  unsigned long last_scanned;
797  size_t wpa_ie_len;
799  size_t rsn_ie_len;
803  struct list_head list;
804  //appeded for QoS
809 //by amy 080312
811 //by amy 080312
812  u8 Turbo_Enable;//enable turbo mode, added by thomas
815 };
816 
818 
819  /* the card is not linked at all */
821 
822  /* IEEE80211_ASSOCIATING* are for BSS client mode
823  * the driver shall not perform RX filtering unless
824  * the state is LINKED.
825  * The driver shall just check for the state LINKED and
826  * defaults to NOLINK for ALL the other states (including
827  * LINKED_SCANNING)
828  */
829 
830  /* the association procedure will start (wq scheduling)*/
833 
834  /* the association procedure is sending AUTH request*/
836 
837  /* the association procedure has successfully authenticated
838  * and is sending association request
839  */
841 
842  /* the link is ok. the card associated to a BSS or linked
843  * to a ibss cell or acting as an AP and creating the bss
844  */
846 
847  /* same as LINKED, but the driver shall apply RX filter
848  * rules as we are in NO_LINK mode. As the card is still
849  * logically linked, but it is doing a syncro site survey
850  * then it will be back to LINKED state.
851  */
853 
854 };
855 
856 #define DEFAULT_MAX_SCAN_AGE (15 * HZ)
857 #define DEFAULT_FTS 2346
858 
859 #define CFG_IEEE80211_RESERVE_FCS (1<<0)
860 #define CFG_IEEE80211_COMPUTE_FCS (1<<1)
861 
862 typedef struct tx_pending_t{
863  int frag;
865 }tx_pending_t;
866 
867 enum {
879 };
880 
882  struct net_device *dev;
883 
884  /* Bookkeeping structures */
888 
889  /* Probe / Beacon management */
893  int scans;
894  int scan_age;
895 
896  int iw_mode; /* operating mode (IW_MODE_*) */
897 
900 
901  int tx_headroom; /* Set to size of any additional room needed at front
902  * of allocated Tx SKBs */
904 
905  /* WEP and other encryption related settings at the device level */
906  int open_wep; /* Set to 1 to allow unencrypted frames */
907 
908  int reset_on_keychange; /* Set to 1 if the HW needs to be reset on
909  * WEP key changes */
910 
911  /* If the host performs {en,de}cryption, then set to 1 */
914  int ieee802_1x; /* is IEEE 802.1X used */
915 
916  /* WPA data */
921  size_t wpa_ie_len;
923 
927 
930  int tx_keyidx; /* default TX key index (crypt[tx_keyidx]) */
932 
933  int bcrx_sta_key; /* use individual keys to override default keys even
934  * with RX of broad/multicast frames */
935 
936  /* Fragmentation structures */
937  /* each stream contains an entry */
939  unsigned int frag_next_idx[17];
940  u16 fts; /* Fragmentation Threshold */
941 
942  /* This stores infos for the current network.
943  * Either the network we are associated in INFRASTRUCTURE
944  * or the network that we are creating in MASTER mode.
945  * ad-hoc is a mixture ;-).
946  * Note that in infrastructure mode, even when not associated,
947  * fields bssid and essid may be valid (if wpa_set and essid_set
948  * are true) as thy carry the value set by the user via iwconfig
949  */
951 
952 
954 
956  int mode; /* A, B, G */
957  int modulation; /* CCK, OFDM */
958  int freq_band; /* 2.4Ghz, 5.2Ghz, Mixed */
959  int abg_true; /* ABG flag */
960 
961  /* used for forcing the ibss workqueue to terminate
962  * without wait for the syncro scan to terminate
963  */
965 
966  void * pDot11dInfo;
968 
969  // For Liteon Ch12~13 passive scan
972 
973  int rate; /* current rate */
975  //FIXME: please callback, see if redundant with softmac_features
976  short active_scan;
977 
978  /* this contains flags for selectively enable softmac support */
980 
981  /* if the sequence control field is not filled by HW */
983 
984  /* association procedure transaction sequence number */
986 
987  /* AID for RTXed association responses */
989 
990  /* power save mode related*/
991  short ps;
992  short sta_sleep;
997 
998  short raw_tx;
999  /* used if IEEE_SOFTMAC_TX_QUEUE is set */
1000  short queue_stop;
1001  short scanning;
1003 
1006 
1009 
1011 
1012  short wap_set;
1013  short ssid_set;
1014 
1015  u8 wpax_type_set; //{added by David, 2006.9.28}
1016  u32 wpax_type_notify; //{added by David, 2006.9.26}
1017 
1018  /* QoS related flag */
1020 
1021  /* for discarding duplicated packets in IBSS */
1023 
1024  /* for discarding duplicated packets in BSS */
1025  u16 last_rxseq_num[17]; /* rx seq previous per-tid */
1026  u16 last_rxfrag_num[17];/* tx frag previous per-tid */
1027  unsigned long last_packet_time[17];
1028 
1029  /* for PS mode */
1030  unsigned long last_rx_ps_time;
1031 
1032  /* used if IEEE_SOFTMAC_SINGLE_QUEUE is set */
1036 
1037 
1038  /* used if IEEE_SOFTMAC_TX_QUEUE is set */
1040 
1041  /* used if IEEE_SOFTMAC_ASSOCIATE is set */
1043 
1044  /* used if IEEE_SOFTMAC_BEACONS is set */
1046 
1048 // struct work_struct associate_retry_wq;
1050 // struct work_struct softmac_scan_wq;
1054 // struct work_struct hw_wakeup_wq;
1055 // struct work_struct hw_sleep_wq;
1056 // struct work_struct watch_dog_wq;
1061  unsigned long NumRxDataInPeriod; //YJ,add,080828
1062  unsigned long NumRxBcnInPeriod; //YJ,add,080828
1063  unsigned long NumRxOkTotal;
1064  unsigned long NumRxUnicast;//YJ,add,080828,for keep alive
1069  struct delayed_work hw_sleep_wq;//+by amy 080324
1073 //by amy for rate adaptive 080312
1075 //by amy for rate adaptive
1078 
1079 //Added for RF power on power off by lizhaoming 080512
1081 
1083 
1084  /* Callback functions */
1086  struct ieee80211_security *sec);
1087 
1088  /* Used to TX data frame by using txb structs.
1089  * this is not used if in the softmac_features
1090  * is set the flag IEEE_SOFTMAC_TX_QUEUE
1091  */
1093  struct net_device *dev);
1094 
1096 
1097  /* Softmac-generated frames (management) are TXed via this
1098  * callback if the flag IEEE_SOFTMAC_SINGLE_QUEUE is
1099  * not set. As some cards may have different HW queues that
1100  * one might want to use for data and management frames
1101  * the option to have two callbacks might be useful.
1102  * This function can't sleep.
1103  */
1105  struct net_device *dev);
1106 
1107  /* used instead of hard_start_xmit (not softmac_hard_start_xmit)
1108  * if the IEEE_SOFTMAC_TX_QUEUE feature is used to TX data
1109  * frames. If the option IEEE_SOFTMAC_SINGLE_QUEUE is also set
1110  * then also management frames are sent via this callback.
1111  * This function can't sleep.
1112  */
1114  struct net_device *dev,int rate);
1115 
1116  /* stops the HW queue for DATA frames. Useful to avoid
1117  * waste time to TX data frame when we are reassociating
1118  * This function can sleep.
1119  */
1121 
1122  /* OK this is complementar to data_poll_hard_stop */
1124 
1125  /* ask to the driver to retune the radio .
1126  * This function can sleep. the driver should ensure
1127  * the radio has been switched before return.
1128  */
1129  void (*set_chan)(struct net_device *dev,short ch);
1130 
1131  /* These are not used if the ieee stack takes care of
1132  * scanning (IEEE_SOFTMAC_SCAN feature set).
1133  * In this case only the set_chan is used.
1134  *
1135  * The syncro version is similar to the start_scan but
1136  * does not return until all channels has been scanned.
1137  * this is called in user context and should sleep,
1138  * it is called in a work_queue when switching to ad-hoc mode
1139  * or in behalf of iwlist scan when the card is associated
1140  * and root user ask for a scan.
1141  * the function stop_scan should stop both the syncro and
1142  * background scanning and can sleep.
1143  * The function start_scan should initiate the background
1144  * scanning and can't sleep.
1145  */
1149 
1150  /* indicate the driver that the link state is changed
1151  * for example it may indicate the card is associated now.
1152  * Driver might be interested in this to apply RX filter
1153  * rules or simply light the LINK led
1154  */
1156 
1157  /* these two function indicates to the HW when to start
1158  * and stop to send beacons. This is used when the
1159  * IEEE_SOFTMAC_BEACONS is not set. For now the
1160  * stop_send_bacons is NOT guaranteed to be called only
1161  * after start_send_beacons.
1162  */
1165 
1166  /* power save mode related */
1171 
1172  /* QoS related */
1173  //void (*wmm_param_update) (struct net_device *dev, u8 *ac_param);
1174  //void (*wmm_param_update) (struct ieee80211_device *ieee);
1175 
1176  /* This must be the last item so that it points to the data
1177  * allocated beyond this structure by alloc_ieee80211 */
1178  u8 priv[0];
1179 };
1180 
1181 #define IEEE_A (1<<0)
1182 #define IEEE_B (1<<1)
1183 #define IEEE_G (1<<2)
1184 #define IEEE_MODE_MASK (IEEE_A|IEEE_B|IEEE_G)
1185 
1186 /* Generate a 802.11 header */
1187 
1188 /* Uses the channel change callback directly
1189  * instead of [start/stop] scan callbacks
1190  */
1191 #define IEEE_SOFTMAC_SCAN (1<<2)
1192 
1193 /* Perform authentication and association handshake */
1194 #define IEEE_SOFTMAC_ASSOCIATE (1<<3)
1195 
1196 /* Generate probe requests */
1197 #define IEEE_SOFTMAC_PROBERQ (1<<4)
1198 
1199 /* Generate response to probe requests */
1200 #define IEEE_SOFTMAC_PROBERS (1<<5)
1201 
1202 /* The ieee802.11 stack will manages the netif queue
1203  * wake/stop for the driver, taking care of 802.11
1204  * fragmentation. See softmac.c for details. */
1205 #define IEEE_SOFTMAC_TX_QUEUE (1<<7)
1206 
1207 /* Uses only the softmac_data_hard_start_xmit
1208  * even for TX management frames.
1209  */
1210 #define IEEE_SOFTMAC_SINGLE_QUEUE (1<<8)
1211 
1212 /* Generate beacons. The stack will enqueue beacons
1213  * to the card
1214  */
1215 #define IEEE_SOFTMAC_BEACONS (1<<6)
1216 
1217 
1218 
1219 static inline void *ieee80211_priv(struct net_device *dev)
1220 {
1221  return ((struct ieee80211_device *)netdev_priv(dev))->priv;
1222 }
1223 
1224 extern inline int ieee80211_is_empty_essid(const char *essid, int essid_len)
1225 {
1226  /* Single white space is for Linksys APs */
1227  if (essid_len == 1 && essid[0] == ' ')
1228  return 1;
1229 
1230  /* Otherwise, if the entire essid is 0, we assume it is hidden */
1231  while (essid_len) {
1232  essid_len--;
1233  if (essid[essid_len] != '\0')
1234  return 0;
1235  }
1236 
1237  return 1;
1238 }
1239 
1240 extern inline int ieee80211_is_valid_mode(struct ieee80211_device *ieee, int mode)
1241 {
1242  /*
1243  * It is possible for both access points and our device to support
1244  * combinations of modes, so as long as there is one valid combination
1245  * of ap/device supported modes, then return success
1246  *
1247  */
1248  if ((mode & IEEE_A) &&
1250  (ieee->freq_band & IEEE80211_52GHZ_BAND))
1251  return 1;
1252 
1253  if ((mode & IEEE_G) &&
1255  (ieee->freq_band & IEEE80211_24GHZ_BAND))
1256  return 1;
1257 
1258  if ((mode & IEEE_B) &&
1260  (ieee->freq_band & IEEE80211_24GHZ_BAND))
1261  return 1;
1262 
1263  return 0;
1264 }
1265 
1266 extern inline int ieee80211_get_hdrlen(u16 fc)
1267 {
1268  int hdrlen = 24;
1269 
1270  switch (WLAN_FC_GET_TYPE(fc)) {
1271  case IEEE80211_FTYPE_DATA:
1272  if ((fc & IEEE80211_FCTL_FROMDS) && (fc & IEEE80211_FCTL_TODS))
1273  hdrlen = 30; /* Addr4 */
1274  if(IEEE80211_QOS_HAS_SEQ(fc))
1275  hdrlen += 2; /* QOS ctrl*/
1276  break;
1277  case IEEE80211_FTYPE_CTL:
1278  switch (WLAN_FC_GET_STYPE(fc)) {
1279  case IEEE80211_STYPE_CTS:
1280  case IEEE80211_STYPE_ACK:
1281  hdrlen = 10;
1282  break;
1283  default:
1284  hdrlen = 16;
1285  break;
1286  }
1287  break;
1288  }
1289 
1290  return hdrlen;
1291 }
1292 
1293 
1294 
1295 /* ieee80211.c */
1296 extern void free_ieee80211(struct net_device *dev);
1297 extern struct net_device *alloc_ieee80211(int sizeof_priv);
1298 
1299 extern int ieee80211_set_encryption(struct ieee80211_device *ieee);
1300 
1301 /* ieee80211_tx.c */
1302 
1303 extern int ieee80211_encrypt_fragment(
1304  struct ieee80211_device *ieee,
1305  struct sk_buff *frag,
1306  int hdr_len);
1307 
1308 extern int ieee80211_rtl_xmit(struct sk_buff *skb,
1309  struct net_device *dev);
1310 extern void ieee80211_txb_free(struct ieee80211_txb *);
1311 
1312 
1313 /* ieee80211_rx.c */
1314 extern int ieee80211_rtl_rx(struct ieee80211_device *ieee, struct sk_buff *skb,
1315  struct ieee80211_rx_stats *rx_stats);
1316 extern void ieee80211_rx_mgt(struct ieee80211_device *ieee,
1317  struct ieee80211_hdr_4addr *header,
1318  struct ieee80211_rx_stats *stats);
1319 
1320 /* ieee80211_wx.c */
1321 extern int ieee80211_wx_get_scan(struct ieee80211_device *ieee,
1322  struct iw_request_info *info,
1323  union iwreq_data *wrqu, char *key);
1324 extern int ieee80211_wx_set_encode(struct ieee80211_device *ieee,
1325  struct iw_request_info *info,
1326  union iwreq_data *wrqu, char *key);
1327 extern int ieee80211_wx_get_encode(struct ieee80211_device *ieee,
1328  struct iw_request_info *info,
1329  union iwreq_data *wrqu, char *key);
1330 extern int ieee80211_wx_set_encode_ext(struct ieee80211_device *ieee,
1331  struct iw_request_info *info,
1332  union iwreq_data* wrqu, char *extra);
1333 int ieee80211_wx_set_auth(struct ieee80211_device *ieee,
1334  struct iw_request_info *info,
1335  struct iw_param *data, char *extra);
1336 int ieee80211_wx_set_mlme(struct ieee80211_device *ieee,
1337  struct iw_request_info *info,
1338  union iwreq_data *wrqu, char *extra);
1339 
1340 int ieee80211_wx_set_gen_ie(struct ieee80211_device *ieee, u8 *ie, size_t len);
1341 /* ieee80211_softmac.c */
1342 extern short ieee80211_is_54g(const struct ieee80211_network *net);
1343 extern short ieee80211_is_shortslot(const struct ieee80211_network *net);
1344 extern int ieee80211_rx_frame_softmac(struct ieee80211_device *ieee, struct sk_buff *skb,
1346  u16 stype);
1347 extern void ieee80211_softmac_new_net(struct ieee80211_device *ieee, struct ieee80211_network *net);
1348 
1349 extern void ieee80211_softmac_xmit(struct ieee80211_txb *txb, struct ieee80211_device *ieee);
1350 extern void ieee80211_softmac_check_all_nets(struct ieee80211_device *ieee);
1351 extern void ieee80211_start_bss(struct ieee80211_device *ieee);
1352 extern void ieee80211_start_master_bss(struct ieee80211_device *ieee);
1353 extern void ieee80211_start_ibss(struct ieee80211_device *ieee);
1354 extern void ieee80211_softmac_init(struct ieee80211_device *ieee);
1355 extern void ieee80211_softmac_free(struct ieee80211_device *ieee);
1356 extern void ieee80211_associate_abort(struct ieee80211_device *ieee);
1357 extern void ieee80211_disassociate(struct ieee80211_device *ieee);
1358 extern void ieee80211_stop_scan(struct ieee80211_device *ieee);
1359 extern void ieee80211_start_scan_syncro(struct ieee80211_device *ieee);
1360 extern void ieee80211_check_all_nets(struct ieee80211_device *ieee);
1361 extern void ieee80211_start_protocol(struct ieee80211_device *ieee);
1362 extern void ieee80211_stop_protocol(struct ieee80211_device *ieee);
1363 extern void ieee80211_softmac_start_protocol(struct ieee80211_device *ieee);
1364 extern void ieee80211_softmac_stop_protocol(struct ieee80211_device *ieee);
1365 extern void ieee80211_reset_queue(struct ieee80211_device *ieee);
1366 extern void ieee80211_rtl_wake_queue(struct ieee80211_device *ieee);
1367 extern void ieee80211_rtl_stop_queue(struct ieee80211_device *ieee);
1368 extern struct sk_buff *ieee80211_get_beacon(struct ieee80211_device *ieee);
1369 extern void ieee80211_start_send_beacons(struct ieee80211_device *ieee);
1370 extern void ieee80211_stop_send_beacons(struct ieee80211_device *ieee);
1371 extern int ieee80211_wpa_supplicant_ioctl(struct ieee80211_device *ieee, struct iw_point *p);
1372 extern void notify_wx_assoc_event(struct ieee80211_device *ieee);
1373 extern void ieee80211_ps_tx_ack(struct ieee80211_device *ieee, short success);
1374 extern void SendDisassociation(struct ieee80211_device *ieee,u8* asSta,u8 asRsn);
1375 extern void ieee80211_rtl_start_scan(struct ieee80211_device *ieee);
1376 
1377 //Add for RF power on power off by lizhaoming 080512
1378 extern void SendDisassociation(struct ieee80211_device *ieee,
1379  u8* asSta,
1380  u8 asRsn);
1381 
1382 /* ieee80211_crypt_ccmp&tkip&wep.c */
1383 extern void ieee80211_tkip_null(void);
1384 extern void ieee80211_wep_null(void);
1385 extern void ieee80211_ccmp_null(void);
1386 /* ieee80211_softmac_wx.c */
1387 
1388 extern int ieee80211_wx_get_wap(struct ieee80211_device *ieee,
1389  struct iw_request_info *info,
1390  union iwreq_data *wrqu, char *ext);
1391 
1392 extern int ieee80211_wx_set_wap(struct ieee80211_device *ieee,
1393  struct iw_request_info *info,
1394  union iwreq_data *awrq,
1395  char *extra);
1396 
1397 extern int ieee80211_wx_get_essid(struct ieee80211_device *ieee, struct iw_request_info *a,union iwreq_data *wrqu,char *b);
1398 
1399 extern int ieee80211_wx_set_rate(struct ieee80211_device *ieee,
1400  struct iw_request_info *info,
1401  union iwreq_data *wrqu, char *extra);
1402 
1403 extern int ieee80211_wx_get_rate(struct ieee80211_device *ieee,
1404  struct iw_request_info *info,
1405  union iwreq_data *wrqu, char *extra);
1406 
1407 extern int ieee80211_wx_set_mode(struct ieee80211_device *ieee, struct iw_request_info *a,
1408  union iwreq_data *wrqu, char *b);
1409 
1410 extern int ieee80211_wx_set_scan(struct ieee80211_device *ieee, struct iw_request_info *a,
1411  union iwreq_data *wrqu, char *b);
1412 
1413 extern int ieee80211_wx_set_essid(struct ieee80211_device *ieee,
1414  struct iw_request_info *a,
1415  union iwreq_data *wrqu, char *extra);
1416 
1417 extern int ieee80211_wx_get_mode(struct ieee80211_device *ieee, struct iw_request_info *a,
1418  union iwreq_data *wrqu, char *b);
1419 
1420 extern int ieee80211_wx_set_freq(struct ieee80211_device *ieee, struct iw_request_info *a,
1421  union iwreq_data *wrqu, char *b);
1422 
1423 extern int ieee80211_wx_get_freq(struct ieee80211_device *ieee, struct iw_request_info *a,
1424  union iwreq_data *wrqu, char *b);
1425 
1426 extern void ieee80211_wx_sync_scan_wq(struct work_struct *work);
1427 
1428 extern int ieee80211_wx_set_rawtx(struct ieee80211_device *ieee,
1429  struct iw_request_info *info,
1430  union iwreq_data *wrqu, char *extra);
1431 
1432 extern int ieee80211_wx_get_name(struct ieee80211_device *ieee,
1433  struct iw_request_info *info,
1434  union iwreq_data *wrqu, char *extra);
1435 
1436 extern int ieee80211_wx_set_power(struct ieee80211_device *ieee,
1437  struct iw_request_info *info,
1438  union iwreq_data *wrqu, char *extra);
1439 
1440 extern int ieee80211_wx_get_power(struct ieee80211_device *ieee,
1441  struct iw_request_info *info,
1442  union iwreq_data *wrqu, char *extra);
1443 
1444 extern void ieee80211_softmac_ips_scan_syncro(struct ieee80211_device *ieee);
1445 
1446 extern void ieee80211_sta_ps_send_null_frame(struct ieee80211_device *ieee, short pwr);
1447 
1448 extern const long ieee80211_wlan_frequencies[];
1449 
1450 extern inline void ieee80211_increment_scans(struct ieee80211_device *ieee)
1451 {
1452  ieee->scans++;
1453 }
1454 
1455 extern inline int ieee80211_get_scans(struct ieee80211_device *ieee)
1456 {
1457  return ieee->scans;
1458 }
1459 
1460 static inline const char *escape_essid(const char *essid, u8 essid_len) {
1461  static char escaped[IW_ESSID_MAX_SIZE * 2 + 1];
1462  const char *s = essid;
1463  char *d = escaped;
1464 
1465  if (ieee80211_is_empty_essid(essid, essid_len)) {
1466  memcpy(escaped, "<hidden>", sizeof("<hidden>"));
1467  return escaped;
1468  }
1469 
1470  essid_len = min(essid_len, (u8)IW_ESSID_MAX_SIZE);
1471  while (essid_len--) {
1472  if (*s == '\0') {
1473  *d++ = '\\';
1474  *d++ = '0';
1475  s++;
1476  } else {
1477  *d++ = *s++;
1478  }
1479  }
1480  *d = '\0';
1481  return escaped;
1482 }
1483 #endif /* IEEE80211_H */