1 /*
2  * IEEE 802.11 Common routines
3  * Copyright (c) 2002-2012, Jouni Malinen <j@w1.fi>
4  *
5  * This software may be distributed under the terms of the BSD license.
6  * See README for more details.
7  */
8 
9 #ifndef IEEE802_11_COMMON_H
10 #define IEEE802_11_COMMON_H
11 
12 #include "defs.h"
13 
14 #define MAX_NOF_MB_IES_SUPPORTED 5
15 
16 struct mb_ies_info {
17 	struct {
18 		const u8 *ie;
19 		u8 ie_len;
20 	} ies[MAX_NOF_MB_IES_SUPPORTED];
21 	u8 nof_ies;
22 };
23 
24 /* Parsed Information Elements */
25 struct ieee802_11_elems {
26 	const u8 *ssid;
27 	const u8 *supp_rates;
28 	const u8 *ds_params;
29 	const u8 *challenge;
30 	const u8 *erp_info;
31 	const u8 *ext_supp_rates;
32 	const u8 *wpa_ie;
33 	const u8 *rsn_ie;
34 	const u8 *wmm; /* WMM Information or Parameter Element */
35 	const u8 *wmm_tspec;
36 	const u8 *wps_ie;
37 	const u8 *supp_channels;
38 	const u8 *mdie;
39 	const u8 *ftie;
40 	const u8 *timeout_int;
41 	const u8 *ht_capabilities;
42 	const u8 *ht_operation;
43 	const u8 *mesh_config;
44 	const u8 *mesh_id;
45 	const u8 *peer_mgmt;
46 	const u8 *vht_capabilities;
47 	const u8 *vht_operation;
48 	const u8 *vht_opmode_notif;
49 	const u8 *vendor_ht_cap;
50 	const u8 *vendor_vht;
51 	const u8 *p2p;
52 	const u8 *wfd;
53 	const u8 *link_id;
54 	const u8 *interworking;
55 	const u8 *qos_map_set;
56 	const u8 *hs20;
57 	const u8 *ext_capab;
58 	const u8 *bss_max_idle_period;
59 	const u8 *ssid_list;
60 	const u8 *osen;
61 	const u8 *mbo;
62 	const u8 *ampe;
63 	const u8 *mic;
64 	const u8 *pref_freq_list;
65 	const u8 *supp_op_classes;
66 
67 	u8 ssid_len;
68 	u8 supp_rates_len;
69 	u8 challenge_len;
70 	u8 ext_supp_rates_len;
71 	u8 wpa_ie_len;
72 	u8 rsn_ie_len;
73 	u8 wmm_len; /* 7 = WMM Information; 24 = WMM Parameter */
74 	u8 wmm_tspec_len;
75 	u8 wps_ie_len;
76 	u8 supp_channels_len;
77 	u8 mdie_len;
78 	u8 ftie_len;
79 	u8 mesh_config_len;
80 	u8 mesh_id_len;
81 	u8 peer_mgmt_len;
82 	u8 vendor_ht_cap_len;
83 	u8 vendor_vht_len;
84 	u8 p2p_len;
85 	u8 wfd_len;
86 	u8 interworking_len;
87 	u8 qos_map_set_len;
88 	u8 hs20_len;
89 	u8 ext_capab_len;
90 	u8 ssid_list_len;
91 	u8 osen_len;
92 	u8 mbo_len;
93 	u8 ampe_len;
94 	u8 mic_len;
95 	u8 pref_freq_list_len;
96 	u8 supp_op_classes_len;
97 
98 	struct mb_ies_info mb_ies;
99 };
100 
101 typedef enum { ParseOK = 0, ParseUnknown = 1, ParseFailed = -1 } ParseRes;
102 
103 ParseRes ieee802_11_parse_elems(const u8 *start, size_t len,
104 				struct ieee802_11_elems *elems,
105 				int show_errors);
106 int ieee802_11_ie_count(const u8 *ies, size_t ies_len);
107 struct wpabuf * ieee802_11_vendor_ie_concat(const u8 *ies, size_t ies_len,
108 					    u32 oui_type);
109 struct ieee80211_hdr;
110 const u8 * get_hdr_bssid(const struct ieee80211_hdr *hdr, size_t len);
111 
112 struct hostapd_wmm_ac_params {
113 	int cwmin;
114 	int cwmax;
115 	int aifs;
116 	int txop_limit; /* in units of 32us */
117 	int admission_control_mandatory;
118 };
119 
120 int hostapd_config_wmm_ac(struct hostapd_wmm_ac_params wmm_ac_params[],
121 			  const char *name, const char *val);
122 enum hostapd_hw_mode ieee80211_freq_to_chan(int freq, u8 *channel);
123 int ieee80211_chan_to_freq(const char *country, u8 op_class, u8 chan);
124 enum hostapd_hw_mode ieee80211_freq_to_channel_ext(unsigned int freq,
125 						   int sec_channel, int vht,
126 						   u8 *op_class, u8 *channel);
127 int ieee80211_is_dfs(int freq);
128 enum phy_type ieee80211_get_phy_type(int freq, int ht, int vht);
129 
130 int supp_rates_11b_only(struct ieee802_11_elems *elems);
131 int mb_ies_info_by_ies(struct mb_ies_info *info, const u8 *ies_buf,
132 		       size_t ies_len);
133 struct wpabuf * mb_ies_by_info(struct mb_ies_info *info);
134 
135 const char * fc2str(u16 fc);
136 
137 struct oper_class_map {
138 	enum hostapd_hw_mode mode;
139 	u8 op_class;
140 	u8 min_chan;
141 	u8 max_chan;
142 	u8 inc;
143 	enum { BW20, BW40PLUS, BW40MINUS, BW80, BW2160, BW160, BW80P80 } bw;
144 	enum { P2P_SUPP, NO_P2P_SUPP } p2p;
145 };
146 
147 extern const struct oper_class_map global_op_class[];
148 extern size_t global_op_class_size;
149 
150 const u8 * get_ie(const u8 *ies, size_t len, u8 eid);
151 
152 size_t mbo_add_ie(u8 *buf, size_t len, const u8 *attr, size_t attr_len);
153 
154 #endif /* IEEE802_11_COMMON_H */
155